edison

README

Edison

The Intel Edison is a WiFi and Bluetooth enabled development platform for the Internet of Things. It packs a robust set of features into its small size and supports a broad spectrum of I/O and software support.

For more info about the Edison platform click here.

How to Install

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 Intel Edison, and run the program on the Intel Edison itself as documented here.

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

Setting up your Intel Edison

Everything you need to get started with the Edison is in the Intel Getting Started Guide:

https://software.intel.com/en-us/iot/library/edison-getting-started

Don't forget to configure your Edison's wifi connection and flash your Edison with the latest firmware image!

The recommended way to connect to your device is via wifi, for that follow the directions here:

https://software.intel.com/en-us/connecting-your-intel-edison-board-using-wifi

If you don't have a wifi network available, the Intel documentation explains how to use another connection type, but note that this guide assumes you are using wifi connection.

You can obtain the IP address of your Edison, by running the floowing command:

ip addr show | grep inet

Don't forget to setup the a password for the device otherwise you won't be able to connect using SSH. From within the screen session, run the following command:

configure_edison --password

Note that you MUST setup a password otherwise SSH won't be enabled. If later on you aren't able to scp to the device, try to reset the password. This password will obviously be needed next time you connect to your device.

How To Use

package main

import (
	"time"

	"gobot.io/x/gobot"
	"gobot.io/x/gobot/drivers/gpio"
	"gobot.io/x/gobot/platforms/intel-iot/edison"
)

func main() {
	e := edison.NewAdaptor()
	led := gpio.NewLedDriver(e, "13")

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

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

	robot.Start()
}

You can read the full API documentation online.

How to Connect

Compiling

Compile your Gobot program on your workstation like this:

$ GOARCH=386 GOOS=linux go build examples/edison_blink.go

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

$ scp edison_blink root@<IP of your device>:/home/root/
$ ssh -t root@<IP of your device> "./edison_blink"

At this point you should see one of the onboard LEDs blinking. Press control + c to exit.

To update the program after you made a change, you will need to scp it over once again and start it from the command line (via screen).

Documentation

Overview

Package edison contains the Gobot adaptor for the Intel Edison.

For further information refer to intel-iot README: https://github.com/hybridgroup/gobot/blob/master/platforms/intel-iot/edison/README.md

Index

• type Adaptor
  • func NewAdaptor() *Adaptor
  • func (e *Adaptor) AnalogRead(pin string) (val int, err error)
  • func (e *Adaptor) Board() string
  • func (e *Adaptor) Connect() (err error)
  • func (e *Adaptor) DigitalPin(pin string, dir string) (sysfsPin sysfs.DigitalPinner, err error)
  • func (e *Adaptor) DigitalRead(pin string) (i int, err error)
  • func (e *Adaptor) DigitalWrite(pin string, val byte) (err error)
  • func (e *Adaptor) Finalize() (err error)
  • func (e *Adaptor) GetConnection(address int, bus int) (connection i2c.Connection, err error)
  • func (e *Adaptor) GetDefaultBus() int
  • func (e *Adaptor) Name() string
  • func (e *Adaptor) PWMPin(pin string) (sysfsPin sysfs.PWMPinner, err error)
  • func (e *Adaptor) PwmWrite(pin string, val byte) (err error)
  • func (e *Adaptor) SetBoard(n string)
  • func (e *Adaptor) SetName(n string)

Types

type Adaptor

type Adaptor struct {
	// contains filtered or unexported fields
}

Adaptor represents a Gobot Adaptor for an Intel Edison

func NewAdaptor

func NewAdaptor() *Adaptor

NewAdaptor returns a new Edison Adaptor

func (*Adaptor) AnalogRead

func (e *Adaptor) AnalogRead(pin string) (val int, err error)

AnalogRead returns value from analog reading of specified pin

func (*Adaptor) Board

func (e *Adaptor) Board() string

Board returns the Adaptors board name

func (*Adaptor) Connect

func (e *Adaptor) Connect() (err error)

Connect initializes the Edison for use with the Arduino beakout board

func (*Adaptor) DigitalPin

func (e *Adaptor) DigitalPin(pin string, dir string) (sysfsPin sysfs.DigitalPinner, err error)

DigitalPin returns matched sysfs.DigitalPin for specified values

func (*Adaptor) DigitalRead

func (e *Adaptor) DigitalRead(pin string) (i int, err error)

DigitalRead reads digital value from pin

func (*Adaptor) DigitalWrite

func (e *Adaptor) DigitalWrite(pin string, val byte) (err error)

DigitalWrite writes a value to the pin. Acceptable values are 1 or 0.

func (*Adaptor) Finalize

func (e *Adaptor) Finalize() (err error)

Finalize releases all i2c devices and exported analog, digital, pwm pins.

func (*Adaptor) GetConnection

func (e *Adaptor) GetConnection(address int, bus int) (connection i2c.Connection, err error)

GetConnection returns an i2c connection to a device on a specified bus. Valid bus numbers are 1 and 6 (arduino).

func (*Adaptor) GetDefaultBus

func (e *Adaptor) GetDefaultBus() int

GetDefaultBus returns the default i2c bus for this platform

func (*Adaptor) Name

func (e *Adaptor) Name() string

Name returns the Adaptors name

func (*Adaptor) PWMPin

func (e *Adaptor) PWMPin(pin string) (sysfsPin sysfs.PWMPinner, err error)

PWMPin returns a sysfs.PWMPin

func (*Adaptor) PwmWrite

func (e *Adaptor) PwmWrite(pin string, val byte) (err error)

PwmWrite writes the 0-254 value to the specified pin

func (*Adaptor) SetBoard

func (e *Adaptor) SetBoard(n string)

SetBoard sets the Adaptors name

func (*Adaptor) SetName

func (e *Adaptor) SetName(n string)

SetName sets the Adaptors name