Intel Edison

_images/edison-overview.png

Setup your Intel Edison

After you open the box, Intel Edison with Arduino Expansion Board, follow these one-time steps to setup, connect and flash the latest image.

Assemble your Intel Edison board

To setup your edison, snap in your Edison to the breakout board. Next, Move the J9 jumper to the “top” position. Finally, connect your Edison to your computer using both of the micro-USB cables provided.

Click here for further instructions on how to assemble the board.

Flash your Intel Edison.

Next, you need to flash your edison board. First, download the latest Yocto image and the Flash Tool Lite from Intel’s downloads page:

Note

On a Windows PC, it may be better to run the Intel Windows 64-bit installer to ensure that all the drivers neccessary for connecting to the Edison are installed. When you install and open the Flash Tool Lite, it may be named “Phone” Flash Tool Lite. That is normal!

Ensure that your Intel Edison is connected to your computer with both micro USB cables. Open Flash Tool Lite and you should see your board listed in the application. Follow these steps:

  1. Browse and select the Yocto image that you downloaded above.

    _images/intel-software-1.png
  2. Click “Start to Flash”. At this point, it may ask you to disconnect and reconnect your Edison. If so, unplug the USB cables and plug them back in.

    _images/intel-software-2.png
  3. Wait until the board has completed flashing. This will require a reboot of the board.

    _images/intel-software-3.png

Congratulations! You have successfully flashed your edison.

Connect to your Intel Edison.

In order to connect to the device, you will need to make a serial connection. On Mac or Linux operating systems, you can do this with the screen utility. On a Windows machine, you can do this using PuTTy.

Note

Once you have made the serial connection, if you are seeing a blank screen - press enter twice.

On a Mac:

  • Open a new Terminal window and type “screen /dev/tty.usbs”. Press “tab” to auto-complete the line. Finally, add a ‘115200 -L’ at the end of the line and press enter twice.

On a PC:

  • Once you have downloaded PuTTy, select “serial” and set the baud rate to 115200. In Device Manager, you can find the COM port that your Edison is using. Connect, and when you see a blank window press enter twice.

On Linux:

  • Before you can connect to your Edison using the screen command, you need to install screen. Type these commands followed by pressing enter twice.:

    $ sudo apt-get install screen
    $ sudo screen /dev/ttyUSB0 115200
    

Setup and configure your Intel Edison.

Once you have connected to your device, configure edison by typing “configure_edison –setup”.

Assemble the Connected Maraca

Connected Maraca Introduction: What will it do?

The Connected Maraca will publish data to Amazon IoT when you shake the 3-axis accelerometer that is connected to your device. Once connected to the device using the screen command, you can see the output after running the application.

Ensure you have all of the right components

Now lets assemble the connected maraca. You will need following parts:

_images/pieces.png

Note

For more detailed descriptions of all of the components in the Grove Kit, check out the - Grove Wiki

Connect all of the components

Once you have all of the components, attach the Grove base sheild to the Edison Arduino board. You will be connecting the various Grove Kit components to the base shield. When that is complete, follow these steps:

  1. Set the 3.3-to-5V switch on the Shield to 3.3V
  2. Grove LED connected to base shield socket D3
  3. Grove 3-Axis Accelerometer to any bottom I2C port
  4. Grove Buzzer connect to base shield socket D6
  5. Grove Button connect to base shield socket D7

Build and run your Connected Maraca: Node.JS

Download the Tools

You will need the following tools (or equivalent tools) to start out with Node.JS.

Download, update and copy the code to your Edison.

Note

To connect to your Edison you will need to have two windows open, a screen session with your Edison (see earlier parts of this documentation for how-to) and a FileZilla client with an SFTP/SSH connection with your Edison. To connect with FileZilla, you will need to put in the IP address of your Edison board. If you are unsure what the IP address of your Edison is, simply run configure_edison –wifi and reconnect to wifi. The IP address will be displayed after a successful connection.

_images/ip-address.png
  1. Download the below zip file and unzip it locally.

  2. Open maraca.js in Sublime Text Editor.

  3. Change the configuration details in the code to match your AWS IoT outputs.:

    var awsRootCACert = "root-ca.pem.crt"; //Should be the name of your root Certificate
        var topicName = "connected-maraca"; //Topic Filter Name in your AWS IoT Rule
        var awsClientCert = "<YOUR AWS IOT CERT>"; //Your CERT filename in awscerts folder
        var awsClientPrivateKey = "<YOUR AWS IOT PRIVATE KEY FILE>"; //Your PRIVATE KEY filename in awscerts folder
        var awsClientId = <YOUR AWS IOT THING NAME>;  //Your THING Name
        var awsIoTHostAddr = "<YOUR AWS IOT ENDPOINT>; //Your AWS IOT ENDPOINT
    
        var REGION = "us-west-2"; // The region you ran your CloudFormation script in.
        var DEVICE_ID = "<YOUR DEVICE ID/TEAM NAME>"; // CHANGE | Your device id / team name.
    
  4. Save the file. Open FileZilla and insert the following values:

    Host: Your Edison IP address
    Username: root
    Password: <blank> (unless you set a password)
    Port: 22
    
  5. When you unzip, the zip file it should already contain a folder awscerts. If not, you will create a new directory in the root folder of your edison device to store your certificates from AWS IoT:

    mkdir /home/root/awscerts
    
  6. Using the GUI, copy over all the directories to your Edison device i.e. awscerts, ConnectedMaraca, BlinkTest. Also, copy over your certificate and private key that you downloaded from AWS IoT into the /home/root/awscerts folder. The root certificate is included in the zip download above. Also copy this file into the /home/root/awscerts folder.

    _images/filezilla.png _images/filezilla-files.png

Test your Edison with BlinkTest application

  1. Install the application and required node libraries:

    root@edison:~# cd BlinkTest
        root@edison:/BlinkTest# npm install
    
  2. Run the BlinkTest application:

    root@edison:/BlinkTest# node blink.js
    

You should see a steady blinking light on your Edison device. Congratulations your Edison is configured correctly and ready to run Connected Maraca. Exit Blink test by Ctrl+C or Command+C.

Install the Connected Maraca application and configure AWS SDK

  1. Install the application and required node libraries:

    root@edison:~# cd ConnectedMaraca
    root@edison:/ConnectedMaraca# npm install
    

Run your application

Now, we can run the application by simply running the following command:

root@edison:/ConnectedMaraca# node maraca.js

Congratulations, you are now streaming data to AWS!

Appendix A: Coding Resources

Check out these code repositories for more example code and information on how to extend the Connected Maraca application.