Native GPIO-Gophers for your Pi!
There's a tiny bit of additional information over at my blog.
- 1.0.0 - Supports original rpi A/B/B+
- 2.0.0 - Adds support for rpi 2, by @akramer
- 3.0.0 - Add support for /dev/gpiomem, by @dotdoom
Open memory range for GPIO access in /dev/mem
err := rpio.Open()
Initialize a pin, run basic operations. Pin refers to the bcm2835 pin, not the physical pin on the raspberry pi header. Pin 10 here is exposed on the pin header as physical pin 19.
pin := rpio.Pin(10) pin.Output() // Output mode pin.High() // Set pin High pin.Low() // Set pin Low pin.Toggle() // Toggle pin (Low -> High -> Low) pin.Input() // Input mode res := pin.Read() // Read state from pin (High / Low) pin.Mode(rpio.Output) // Alternative syntax pin.Write(rpio.High) // Alternative syntax
Pull up/down/off can be set using:
pin.PullUp() pin.PullDown() pin.PullOff() pin.Pull(rpio.PullUp)
Unmap memory when done
Also see example examples/blinker/blinker.go
Currently, it supports basic functionality such as:
- Pin Direction (Input / Output)
- Write (High / Low)
- Read (High / Low)
- Pull (Up / Down / Off)
Would be nice to add in the future:
It works by memory-mapping the bcm2835 gpio range, and therefore require root/administrative-rights to run.
Using without root
This library can utilize the new /dev/gpiomem memory range if available.
You will probably need to upgrade to the latest kernel (or wait for the next raspbian release) if you're missing /dev/gpiomem. You will also need to add a
gpio group, add your user to the group, and then set up udev rules. I would recommend using create_gpio_user_permissions.py if you're unsure how to do this.