OrgGo/hybridgroup.gobot
1
0
Fork 0
mirror of https://github.com/hybridgroup/gobot.git synced 2025-05-09 19:29:27 +08:00
Code Issues Projects Releases Wiki Activity

update the Edison documentation for 1.5

Browse Source
This commit is contained in:
Matt Aimonetti 2015-07-10 13:48:02 -06:00
parent d18d6cd73a
commit 568d53cac4
1 changed files with 58 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

86
platforms/intel-iot/edison/README.md
View File

@ -4,48 +4,51 @@ The Intel Edison is a wifi and Bluetooth® enabled devolopment platform for the
For more info about the Edison platform click [here](http://www.intel.com/content/www/us/en/do-it-yourself/edison.html).
## How to Install
## How to Install (using Go 1.5+)
First you must install the appropriate Go packages
Install Go from source or use an [official distribution](https://golang.org/dl/).
```
go get -d -u github.com/hybridgroup/gobot/... && go install github.com/hybridgroup/gobot/platforms/intel-iot/edison
```
Then you must install the appropriate Go packages
#### Setting up your Intel Edison
## Setting up your Intel Edison
Everything you need to get started with the Edison is in the Intel Getting Started Guide
located [here](https://communities.intel.com/docs/DOC-23147). Don't forget to
configure your Edison's wifi connection and [flash](https://communities.intel.com/docs/DOC-23192)
located [here](https://github.com/hybridgroup/gobot/tree/master/platforms). Don't forget to
configure your Edison's wifi connection and [flash](https://github.com/hybridgroup/gobot/tree/master/platforms)
your Edison with the latest firmware image!
#### Cross compiling for the Intel Edison
You must first configure your Go environment for 386 linux cross compiling
If you followed the Edison setup steps you should be all set to access
your device using its wifi IP. Just in case you were too eager to get
started, here are the critical parts you can't skip!
```bash
$ cd $GOROOT/src
$ GOOS=linux GOARCH=386 ./make.bash --no-clean
[Connect to your device via USB](https://software.intel.com/en-us/setting-up-serial-terminal-intel-edison-board
) so you can setup the network.
The recommended way to connect to your device is via wifi, for that follow the [Intel directions](https://software.intel.com/en-us/connecting-your-intel-edison-board-using-wifi) so you can get your device to connect to your local wifi network and get its IP. 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 should get the ip of your edison as a message looking like that:
```
Please connect your laptop or PC to the same network as this device and go to http://10.35.15.185 or http://edison.local in your browser.
```
Then compile your Gobot program with
Don't forget to setup the a password for the device otherwise you won't be able to
connect. From within the screen session:
```bash
$ GOARCH=386 GOOS=linux go build examples/edison_blink.go
```
configure_edison --password
```
Then you can simply upload your program over the network from your host computer to the Edison
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.
```bash
$ scp edison_blink root@192.168.1.xxx:/home/root/
```
and execute it on your Edison with
## Example program
```bash
$ ./edison_blink
```
## How to Use
Save the following code into a file called `main.go`.
```go
package main
@ -81,6 +84,33 @@ func main() {
gbot.Start()
}
```
## How to Connect
The [Intel Edison Getting Started Guide](https://communities.intel.com/docs/DOC-23147) details connection instructions for Windows, Mac and Linux.
You can read the [full API documentation online](http://godoc.org/github.com/hybridgroup/gobot).
#### Cross compiling for the Intel Edison
Compile your Gobot program run the following command using the command
line from the directory where you have your `main.go` file:
```bash
$ GOARCH=386 GOOS=linux go build .
```
Then you can simply upload your program over the network from your host computer to the Edison
```bash
$ scp main root@<IP of your device>:/home/root/blink
```
and execute it on your Edison (use screen to connect, see the Intel
setup steps if you don't recall how to connect)
```bash
$ ./blink
```
At this point you should see the onboard led 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).