Overview

Skill Level: Beginner

Beginner This recipe does not need any programming experience.

Hardware RequirementsIntel Galileo Development Board.Micro SD card (SDHC format, minimum 4 GB/maximum 32 GB, FAT/FAT 32 formatted).Intel Galileo Getting StartedDB-9 to 3.5mm audio cableSerial to USB cable PrepareComplete steps 1 4 in the Intel Galileo Getting Started Guide. These steps include connecting your board to a Windows, Mac, or Linux computer using a USB cable.Select […]

Ingredients

Intel Galileo Development Board. See a full list in 'Hardware Requirements' step.

Step-by-step

  1. Hardware Requirements

    • Intel Galileo Development Board.
    • Micro SD card (SDHC format, minimum 4 GB/maximum 32 GB, FAT/FAT 32 formatted).
    • Intel Galileo Getting Started
    • DB-9 to 3.5mm audio cable
    • Serial to USB cable

     

  2. Prepare

    1. Complete steps 1 4 in the Intel Galileo Getting Started Guide. These steps include connecting your board to a Windows, Mac, or Linux computer using a USB cable.
    2. Select Intel XDK IoT Edition as the development platform
    3. Download the SD-Card Linux Image, and extract its contents to the micro SD card.
    4. Connect your board to an internet-connected network using an Ethernet cable.
    5. Insert the SD card into your Galileo board. The first time you boot the board, it may take several minutes while the SSH component creates the cryptographic keys.
  3. Connect (Quickstart)

    1. Carry out this step to retrieve the IP Address of the Intel Galileo board. In case you know the IP Address, continue from Step 2:
      1. Download ibm-iot-quickstart.zip to your computer, and extract the contents (source code is available).
      2. If it isnt already running, launch the Arduino IDE (step 2 in the Intel Galileo Getting Started Guide).
      3. In the IDE, select File >Open, navigate to the extracted ibm-iot-quickstart directory and select sketch/print_ipaddr/print_ipaddr.ino. Then select File > Upload to load and run the program on your board. This file contains sketch code to determine the IP Address of the system.
      4. Select Tools > Serial Monitor to open the Serial Monitor window. The window displays the network connection information for your board. Make a note of the IP address (under inet addr:).
      5. Close the Serial Monitor window and the Arduino IDE.
    2. Copy the ibm-iot-quickstart.zip file to your Galileo board, from your development system (Windows / Linux), using the IP address that you previously noted:
      1.  scp ./ibm-iot-quickstart.zip root@ip_address:/ibm-iot-quickstart.zip

         

    3. Note that on Windows, you will need to install a version of scp and ssh.

    4. Open command shellon your development system and connect to your Galileo board using the IP address that you had previously noted:

       

       ssh root@ip_address

       

    5. Now you can load the Quickstart software onto your board:

      1. Go to the root directory:

      2.  cd /

         

      3. Extract the contents of the compressed file with the following command:

         unzip ibm-iot-quickstart.zip

         

      4. Enter the command:

         cd ibm-iot-quickstart
      5. Provide execute permission to the setup.sh script by running the following command:

      6.  chmod +x setup.sh
      7. Run the command:
         ./setup.sh
      8. Run the sample by entering:
         node ibm-iot-quickstart.js

         

    6. Note the MAC address (Device ID) that is displayed in the console window.

       

       

  4. Real-time visualization of device data

    To view the data, simply visit Quickstart.

    Enter your device ID, that you obtained in the previous step, in the quickstart, to visualize the data points.
    The below chart shows the datapoint:

  5. What did we achieve?

    The above steps shows us how we can get an Intel Galileo (just unpacked from a box) onboarded to IBM Watson IoT Platform Connect. We are able to view the data in the dashboard.

  6. Registering your Device to IBM Watson IoT Platform

    In order to access the full capabilities of the IBM Watson IoT Platform Connect, you need access to an organization within theIBM Watson IoT Platform Connect.

    Registered flow gives you lot more capabilities, including publishing device commands, as well as, password-protected transaction.

    You can sign up and register devices to an IBM Watson IoT Platform Connect (IBM IoT ) organization by using IBM Bluemix. To register your devices using IBM Bluemix, you must first create a Bluemix account. Here are the steps:

    1. Open Bluemix in your browser. If you are an existing Bluemix user, log in as usual. If you are new to Bluemix you can sign up for a free 30 day trial.
    2. From your Bluemix application, click CATALOG tab.
    3. Select the Internet of Things Platform service. (Note: Use the search box if you cant find the service).
    4. Type a name for your service and click Create button.
    5. Under the Connect your devices section, click on Launch dashboard. This will take you to your IBM Watson IoT Platform Connect organization space. This Watson IoT organization is a space used for connecting and managing devices (like your Galileo) to the IBM Watson IoT Platform so that your applications can access their live and historical data.

    To explore and make use of full capabilities of Watson IoT Platform, we need to setup and register your device(s) in it. Refer to Register Devices to IoT Platform recipe.

     

  7. Viewing the device events in IBM Watson IoT Platform Connect Dashboard

    1. Launch IBM Watson IoT Platform Connect dashboard.
    2. Click on DEVICES tab.
    3. Click on your Device.
    4. Go to Recent Events section.
    5. Click on a particular row to view the content.

     

     

     With the new boards and cards capability in the Watson Internet of Things platform, you can build your own Custom dashboard without writing any code. You can use the boards as the landing page of interest and then make use of the cards within them to:

    • Create visualization charts for the real time data from your devices
    • Create Gauges for visualizing physical quantities like Vehicle Speed, Temperature, pressure
    • Create Donuts charts, bar charts to display the current value of the data points
    • See the Data and storage consumption of your devices
    • List of registered devices and etc..

    Refer to Configuring Boards & Cards in the new Watson IoT Dashboard recipe to view the device events in Watson IoT Platform using the boards and cards.

  8. Conclusion and other related device recipes

    The above steps shows us how we can get an Intel Galileo to communicate using registered flow. We also have related recipes on connecting different devices to IBM Watson IoT Platform. Here given are the some of the links to refer:

     

Join The Discussion