Hello GPIO

This example demonstrates how to use General-Purpose Input/Output (GPIO) pins as digital inputs and outputs using the circuits_gpio library.

The example uses two separate circuits:

The first circuit contains an LED (Light-Emitting Diode) that is turned on and off by Elixir controlling a GPIO pin.
In the second circuit, Elixir monitors a GPIO pin and logs the changing state of a manual switch.

Hardware

For the output pin, you will need a single LED connected to GND and a GPIO pin with a 270 Ω resistor.

The resistor prevents the LED from drawing too much current and burning up your LED.
As an experiment, you can increase the value of the resistor, and you will notice that the LED will be dimmer than before, as the current will be reduced.
If you do not see the light turning on and off, it is likely that you have plugged the LED in backwards. The LED only allows current to flow in one direction.

For the input pin, connect a 4-pin push-button with a 10 kΩ pull-up resistor to a GPIO pin.

The pull up resistor prevents you from entering a floating state (not knowing if the button has been pressed or not)
When the button is not pressed, the GPIO will register a high value (close to 5V).
When the button is pressed, the current will flow from 5V to ground, and the GPIO will register a low value (close to 0V).

The default configuration uses GPIO BCM pin 26 for output and GPIO BCM pin 20 for input. Note that you are using the labeled BCM pins as found on a Raspberry Pi as shown in the diagram at pinout.xyz.

How to Use the Code in this Repository

Connect the hardware according to the schematic above
Configure which pins to use to use by editing config/config.exs
Specify your target with the MIX_TARGET environment variable
Get dependencies with mix deps.get
Create firmware with mix firmware
Burn firmware to an SD card with mix firmware.burn
Connect a monitor to the HDMI port on the board
Insert the SD card into your target board and power it on
After about 5 seconds, the LED should start blinking
Enter RingLogger.attach at the IEx prompt in the console
On the monitor you will see log entries showing the status of the LED. Pressing the switch button will display entries showing the changing state of the switch

export MIX_TARGET=rpi0
mix deps.get
mix firmware
mix firmware.burn

Learn More

Official docs: https://hexdocs.pm/nerves/getting-started.html
Official website: https://nerves-project.org/
Discussion Slack elixir-lang #nerves (Invite)
Source: https://github.com/nerves-project/nerves

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!