Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Need to improve LED documentation #102

Merged
merged 10 commits into from
Nov 6, 2023
Original file line number Diff line number Diff line change
@@ -1,8 +1,48 @@

==== LED
:icons: //Icons attribute is needed for the Omega symbol
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use :omega: Ω here

[.text-right]
https://github.com/oss-slu/Pi4Micronaut/edit/develop/micronautpi4j-utils/src/docs/asciidoc/components/outputComponents/led.adoc[Improve this doc]

===== Overview
This document provides details of the LED, including its components and assembly instructions.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

replace the word document with section


===== Components
- 1 x RaspberryPi
- 1 x Breadboard
- 1 x T-Extension Board
- 1 x LED
- 2 x Jumper wires
- 1 x Resistor (220:omega:)
- Power source (appropriate voltage, typically 3.3V)

===== Assembly
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Break down the following paragraph into points using bullets

- To assemble, place a single LED onto the Breadboard. The LED will have two pins, a cathode and an anode. Place a 220:omega: resistor on the positive side of the Breadboard to the anode (the long pin of the LED),
then the resistor to 3.3V, and connect the cathode (the short pin) of the LED to GPIO 17 of the RaspberryPi. In addition, there need to be two jumper cables connected to
separate positions on the Breadboard and T-Extension Board. The first will go from the GPIO17 pin to the cathode. Then place the second wire from the 3.3V pin to the positve side
of the Breadboard.


===== Circuit Diagram

image::https://github.com/oss-slu/Pi4Micronaut/tree/main/micronautpi4j-utils/src/docs/asciidoc/image49.png
Copy link
Collaborator

@ruthvikm ruthvikm Nov 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Upload the image file after renaming it as "LED_Circuit". Make sure you provide the correct path here to display the image here.



===== Troubleshooting
- LED not lighting: Check the connections, and ensure the LED is placed correctly. Double check the power source.
- LED is too dim: Resistor value may be too high. Verify you're using 220:omega: or adjust according to the power source your using
as well as the LED specifications.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have two LED YML configurations led and led2. please add it here

===== YAML
[source, yaml]
----
led: # <1>
name: LED Output # <2>
address: 17 # <3>
shutdown: HIGH # <4>
initial: HIGH # <5>
provider: pigpio-digital-output # <6>
----

===== Constructors

[source, java]
Expand All @@ -19,6 +59,4 @@ include::../../../../../../micronautpi4j-utils/src/main/java/com/opensourcewiths

===== An Example Controller

====== This controller turns the LED on and off

TODO: Create an example LED Controller
[source, java]