hybridgroup.gobot/platforms/raspi
deadprogram ac74498342 raspi: increase test coverage
Signed-off-by: deadprogram <ron@hybridgroup.com>
2017-05-01 10:41:24 +02:00
..
LICENSE license: update license year to include 2017 2017-01-02 22:25:17 +01:00
README.md docs: improve explanations for scp/ssh workflow on SoC boards to README 2017-04-12 15:42:06 +02:00
doc.go docs: correct Raspberry Pi README link 2016-12-21 10:55:29 +01:00
pwm_pin.go raspi: add implementation for PWMPinner interface that wraps pi blaster 2017-05-01 08:37:14 +02:00
pwm_pin_test.go raspi: increase test coverage 2017-05-01 10:41:24 +02:00
raspi_adaptor.go raspi: implement DigitalPinnerProvider and PWMPinnerProvider interfaces 2017-05-01 09:24:34 +02:00
raspi_adaptor_test.go raspi: increase test coverage 2017-05-01 10:41:24 +02:00
raspi_pin_map.go Add crude travis check for gofmt; format all sources 2017-03-27 14:10:37 -04:00

README.md

Raspberry Pi

The Raspberry Pi is an inexpensive and popular ARM based single board computer with digital & PWM GPIO, and i2c interfaces built in.

The Gobot adaptor for the Raspberry Pi should support all of the various Raspberry Pi boards such as the Raspberry Pi 3 Model B, Raspberry Pi 2 Model B, Raspberry Pi 1 Model A+, Raspberry Pi Zero, and Raspberry Pi Zero W.

For more info about the Raspberry Pi platform, click here.

How to Install

We recommend updating to the latest Raspian Jessie OS when using the Raspberry Pi, however Gobot should also support older versions of the OS, should your application require this.

You would normally install Go and Gobot on your workstation. Once installed, cross compile your program on your workstation, transfer the final executable to your Raspberry Pi, and run the program on the Raspberry Pi as documented here.

go get -d -u gobot.io/x/gobot/...

How to Use

The pin numbering used by your Gobot program should match the way your board is labeled right on the board itself.

package main

import (
        "time"

        "gobot.io/x/gobot"
        "gobot.io/x/gobot/drivers/gpio"
        "gobot.io/x/gobot/platforms/raspi"
)

func main() {
        r := raspi.NewAdaptor()
        led := gpio.NewLedDriver(r, "7")

        work := func() {
                gobot.Every(1*time.Second, func() {
                        led.Toggle()
                })
        }

        robot := gobot.NewRobot("blinkBot",
                []gobot.Connection{r},
                []gobot.Device{led},
                work,
        )

        robot.Start()
}

How to Connect

Compiling

Compile your Gobot program on your workstation like this:

$ GOARM=6 GOARCH=arm GOOS=linux go build examples/raspi_blink.go

Use the following GOARM values to compile depending on which model Raspberry Pi you are using:

GOARM=6 (Raspberry Pi A, A+, B, B+, Zero) GOARM=7 (Raspberry Pi 2, 3)

Once you have compiled your code, you can you can upload your program and execute it on the Raspberry Pi from your workstation using the scp and ssh commands like this:

$ scp raspi_blink pi@192.168.1.xxx:/home/pi/
$ ssh -t pi@192.168.1.xxx "./raspi_blink"

Enabling PWM output on GPIO pins.

For extended PWM support on the Raspberry Pi, you will need to use a program called pi-blaster. You can follow the instructions for pi-blaster install in the pi-blaster repo here:

https://github.com/sarfata/pi-blaster