Intel IoT Platforms: Getting started - Intel XDK IoT Edition

Getting Started Home Edison Getting Started Home - Galileo

Overview

This guide contains steps for installing the Intel XDK IoT Edition, as well as creating and running a simple application on the Intel Galileo or the Intel Edison board. These are steps for all supported operating systems.

Intel XDK IoT Edition lets you create and test applications on Intel IoT platforms. It provides code templates for creating new applications that interact with sensors, actuators, and so on, enabling you to get a quick start on developing software for your Intel board.

Requirements

A system with Windows* OS, Mac* OS, or Linux* OS

You have obtained the IP address for your platform. To obtain your IP address, refer to the corresponding document for your platform:

Intel Edison: Getting Started Wifi

Intel Galileo: Getting Started Ethernet

For Galileo only: o Program an SD with the Yocto Linux Image by going to the Programming a Blank SD Card

Document, or watching the Programming a Blank SD Card Video. Due to the limited storage space onboard the Galileo, you need to run Yocto off of the SD card to use the libraries needed to work with the Intel XDK IoT Edition

Install the Intel XDK IoT Edition

This section describes how to install the latest version of the Intel XDK IoT Edition.

1. To download the latest installer for the Intel XDK IoT Edition, visit https://software.intel.com/en-us/html5/xdk-iot. Ensure that your OS platform is selected in the green download box, then click Go.

2. Run the installer by doing one of the following:

For Windows OS: Right-click the installer you just downloaded, then select Run as Administrator. If a confirmation message is displayed, click Yes to continue.

For Mac OS: Double-click the .dmg file you just downloaded to extract the installer. Double-click

the .pkg file to start installation.

For Linux OS: a) Open Terminal. b) Navigate to the folder where the installer is stored. For example, if the installer is stored in the

Desktop folder, type cd ~/Desktop/.

c) To extract the install files, type tar zxvf installername.

d) Navigate to the folder containing the extracted files. e) To run the installer, type ./install.sh.

3. Follow the instructions in the installation wizard to install the Intel XDK IoT Edition (Figure 1).

Figure 1- Initial screen of the Intel XDK IoT Edition installation wizard

Install Bonjour* Print Services (Windows OS only)

This section contains steps to install Bonjour* Print Services, which is required for Windows OS systems. Bonjour enables the Intel XDK IoT Edition to automatically detect IoT devices installed on your network.

1. To download Bonjour, go to the Bonjour Print Services for Windows page at http://support.apple.com/kb/DL999.

2. Click Download.

3. Right-click BonjourPSSetup.exe, then select Run as Administrator. If a confirmation message is

displayed, click Yes to continue.

4. Follow the instructions in the installation wizard to install Bonjour (Figure 2).

Figure 2- Initial screen of the Bonjour installation wizard

Launch the Intel XDK IoT Edition

This section contains steps to launch and log in to the Intel XDK IoT Edition.

1. Run the Intel XDK IoT Edition.

2. Follow the on-screen instructions to log in to your Intel XDK account or sign up for a new Intel XDK account.

3. If you are offline, click Cancel in the upper right corner.

Create a sample application

This section contains steps to create a simple Intel XDK application using a pre-existing code sample. By the end of this section, you should have a new project that contains the Onboard LED Blink sample code.

1. From the left menu (Figure 3), select Start with a Sample or Template.

Figure 3 - The left menu of the Intel XDK IoT Edition

2. In the list of templates that displays, select the Onboard LED Blink template, then click Use This Template (Figure 4).

Figure 4- Choose a template and click Use This Template.

3. In the Name Your Project field, type a name for your project (Figure 5).

Figure 5 - Type a name into the Name Your Project field.

4. Click Create. Your project is created.

Note: If you are a Windows user and Bonjour is not installed on your machine, a "Bonjour is missing" message

is displayed (Figure 6). Complete the steps in the Install Bonjour section above to install Bonjour.

Figure 6 - The "Bonjour is missing" message

Connect to your Intel IoT Platform

This section contains steps to connect the Intel XDK IoT Edition to your Intel Galileo board or Intel Edison board. At the end of the section, you will see a confirmation message containing the connection status for your board.

1. From the IoT Device drop-down list, select your board.

Note: If your board is not included in the drop-down list, you must connect to your board manually. For steps,

see the Connect to your development board manually section below.

2. A dialog box appears (Figure 7), displaying the connection status and IP address of your board. Click Dismiss.

Figure 7 - The connection status and IP address is displayed.

Note: If you are experiencing issues connecting to your board, connect to your board in a serial communication session, then enter the following commands:

systemctl enable xdk-daemon

systemctl restart xdk-daemon

Connect to your Intel board manually

This section contains steps to connect the Intel XDK IoT Edition to your development board manually. At the end of the section, you will see a confirmation message containing the connection status for your board.

1. From the IoT Device drop-down list, select Add Manual Connection.

2. In the dialog box that opens, provide the connection information for your development board, as follows:

a) Type the IP address in the Address field.

b) Type the port number in the Port field. The default is 58888.

3. Click Connect. A confirmation message is displayed.

Figure 8 - Type the IP address and port number.

Note: If you do not know the IP address of your development board, connect to your board in a serial

communication session by typing ip a. The IP address is displayed after inet, (Figure 9).

Figure 9 - Locate the IP address of your board.

Run the application

This section describes how to run your sample application. By the end of the section, you should see the LED on your development board blink on and off.

Figure 10 - Intel XDK IoT Edition

1. From the bottom toolbar, click the Manage your daemon/IoT device icon. Select Sync PC time w/ clock on target board to avoid computer and device timing issues.

2. Click the Install/Build icon. In the dialog box that opens, click Build.

3. To upload your project to the development board, click the Upload icon.

4. To run your project on the device, click the Run icon. Any runtime errors in the program are displayed in the console log bar. To display additional information about these errors, click the Toggle console window icon.

6. Check your board for a blinking LED. The location of the light varies depending on which board you have, as

follows:

Intel Galileo Gen 1 board

The green LED at the bottom left corner of the board blinks.

Intel Galileo Gen 2 board

The green LED located next to the USB port blinks.

Intel Edison board

The green LED in the center of the board blinks.

Note: If a "cannot find mraa" message is displayed when you run the program, you must update your mraa library files, as follows:

1. Connect to your board using a serial communication session.

2. Enter the following commands:

echo "src maa-upm http://iotdk.intel.com/repos/1.1/intelgalactic" >

/etc/opkg/intel-iotdk.conf

opkg update

opkg upgrade

3. Click the Run icon again.

Next Steps

Now that you have run your first Intel XDK application, explore the links below for next steps to create applications with the Intel IoT Developer Kit.

Intel XDK IoT Edition node.js Templates

Intel XDK IoT Edition RGB Lighting Demo

Troubleshooting

Intel IoT Forum

Manual Connection Method

Getting Started Home Edison

Getting Started Home - Galileo

Resources

Intel XDK IoT Edition Product Brief

Intel XDK IoT Edition Release Notes

Intel Galileo: https://www-ssl.intel.com/content/www/us/en/do-it-yourself/galileo-maker-quark-board.html

Intel Edison: https://www-ssl.intel.com/content/www/us/en/do-it-yourself/edison.html Intel Developer Zone for Internet of Things: http://software.intel.com/iot

Intel IoT Developer Kit: https://software.intel.com/en-us/iotdevkit

Notices

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE,

EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY

THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS,

INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY,

RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO

FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT

OR OTHER INTELLECTUAL PROPERTY RIGHT.

UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED

FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE

PERSONAL INJURY OR DEATH MAY OCCUR.

Intel may make changes to specifications and product descriptions at any time, without notice. Designers must

not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined."

Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or

incompatibilities arising from future changes to them. The information here is subject to change without

notice. Do not finalize a design with this information.

The products described in this document may contain design defects or errors known as errata which may

cause the product to deviate from published specifications. Current characterized errata are available on

request.

Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing

your product order.

Copies of documents which have an order number and are referenced in this document, or other Intel

literature, may be obtained by calling 1-800-548-4725, or go to: http://www.intel.com/design/literature.htm

Software and workloads used in performance tests may have been optimized for performance only on Intel

microprocessors. Performance tests, such as SYSmark* and MobileMark*, are measured using specific

computer systems, components, software, operations, and functions. Any change to any of those factors may

cause the results to vary. You should consult other information and performance tests to assist you in fully

evaluating your contemplated purchases, including the performance of that product when combined with

other products.

Any software source code reprinted in this document is furnished under a software license and may only be

used or copied in accordance with the terms of that license.

Intel, the Intel logo, and Intel Atom are trademarks of Intel Corporation in the U.S. and/or other countries.

Copyright 2014 Intel Corporation. All rights reserved.

*Other names and brands may be claimed as the property of others.