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/xdkiot. 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-quarkboard.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.