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
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
1. From the left menu (Figure 3), select Start with a Sample or Template.
2. In the list of templates that displays, select the Onboard LED Blink template, then click Use This Template
(Figure 4).
3. In the Name Your Project field, type a name for your project (Figure 5).
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.
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
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).
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:
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
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.