Intel DK100 Series Getting Started Manual
Intel® IoT Gateway Development Kit
DK100 Series
Getting Started Guide
April 2015
Order No.: 330307-007
By using this document, in addition to any agreements you have with Intel, you accept the terms set forth below.
You may not use or facilitate the use of this document in connection with any infringement or other legal analysis concerning Intel products described
herein. You agree to grant Intel a non-exclusive, royalty-free license to any patent claim thereafter drafted which includes subject matter disclosed
herein.
No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document.
All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest product specifications and
roadmaps.
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.
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
Intel processor numbers are not a proxy for performance. Processor numbers differentiate features within a processor family, not across different
processor families. Learn more at: http://www.intel.com/products/processor_number/
Intel, the Intel logo, Intel Atom, Intel Core and Intel Quark, are trademarks of Intel Corporation in the U.S. and/or other countries.
Wind River is a trademark of Wind River Systems, Inc.
*Other names and brands may be claimed as the property of others.
Copyright © 2014–2015, Intel Corporation. All rights reserved.
®
IoT Gateway Development Kit DK100 Series
Intel
Getting Started Guide April 2015
2 Order No.: 330307-007
Quick Power-On—Intel IoT Gateway Development Kit DK100 Series
Quick Power-On
The following terms are used in these steps:
• Target Device refers to the Intel® IoT Gateway - DK100 Series.
• Host System refers to a Linux system that you provide.
1. Connect the Serial Interface to a Host System running PuTTY.
2. Connect the Power Supply.
3.
At the login prompt, use root for both the login ID and password.
The Target Device is now booted with the sample runtime image. This sample runtime
image is for evaluation purposes only. After you have explored its features, use the
rest of this document to build a production-ready runtime image.
April 2015 Getting Started Guide
Order No.: 330307-007 3
Intel® IoT Gateway Development Kit DK100 Series
Revision History
Date Revision Description
April 2015 007 Changed information related to recommended development
February 2015 006 First Intel® IoT Gateway 2.1 release
September 2014 005 Corrected document references / added links
September 2014 004 Minor updates
August 2014 003 Corrected licensing instructions
July 2014 002 Minor updates and corrections
July 2014 001 Initial public release
Intel IoT Gateway Development Kit DK100 Series —Revision History
hosts
Updated errata
Document restructured
Added appendix to build an Intelligent Device Platform
Project with Wind River Workbench
Added appendix for Triage Tool
Command and other modifications throughout for Release
2.1
Corrected firmware update command to add modprobe
efi_capsule_update
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
4 Order No.: 330307-007
Contents—Intel IoT Gateway Development Kit DK100 Series
Contents
Quick Power-On.................................................................................................................. 3
Revision History..................................................................................................................4
1.0 Introduction................................................................................................................. 9
1.1 About the Intel® IoT Gateway Development Kit DK100 Series.......................................9
1.2 Intel® IoT Gateway Development Kit DK100 Series Kit Contents................................. 10
1.3 About this Guide...................................................................................................13
1.4 Reference Documents............................................................................................15
1.5 Before you Begin.................................................................................................. 16
2.0 Connect the Hardware................................................................................................ 19
3.0 Connect the Target Device to a Host System............................................................... 20
3.1 Connecting with a Wireless Network Connection........................................................21
3.2 Connecting with a Wired Ethernet Connection........................................................... 22
3.3 Remotely Logging in to the Target Device with ssh.................................................... 22
4.0 Prepare to Build Your Runtime Image.........................................................................24
4.1 Task Checklist and Completion Times...................................................................... 24
4.2 Prepare Host System for Wind River Software Installation.......................................... 25
5.0 Register Your Development Kit................................................................................... 27
6.0 Install Linux Packages and Wind River Linux Host Tools on the Host System............. 32
7.0 Build Intelligent Device Platform XT Runtime Software.............................................. 40
8.0 Update SPI Firmware.................................................................................................. 42
9.0 Put Intelligent Device Platform XT Runtime Image onto USB Flash Drive................... 44
10.0 Install Intelligent Device Platform XT Runtime on Target Device..............................47
Appendix A Intel® IoT Gateway Knowledge Forum........................................................... 48
Appendix B Use Wind River WebIF to Configure the Target Device (Optional).................. 53
Appendix C Building an Intelligent Device Platform Project Using Wind River
®
Workbench.............................................................................................................. 55
Appendix D Triage Tool..................................................................................................... 72
Appendix E Installing and Configuring PuTTY................................................................... 73
Appendix F Troubleshooting............................................................................................. 79
April 2015 Getting Started Guide
Order No.: 330307-007 5
Intel® IoT Gateway Development Kit DK100 Series
Intel IoT Gateway Development Kit DK100 Series —Figures
Figures
1 Software Stack........................................................................................................10
2 Intel® IoT Gateway DK100 Series - Back.................................................................... 11
3 RS-232 Cable for Serial Communication Transmission...................................................12
4 Power Cord.............................................................................................................13
5 Sample "You Are Here".............................................................................................14
6 Register a Product................................................................................................... 27
7 Create Support User Account.................................................................................... 28
8 Wind River License Key Request Confirmation............................................................. 28
9 Logged Into Intel Registration Center......................................................................... 29
10 Intel Registration Center Product Page....................................................................... 29
11 Email Message: Intel® Premier Support Registration Successfully Completed...................30
12 Message: Thank you for registering Intel® IoT Gateway Development Kit DK100 Series.... 30
13 Wind River Installer Package Updates.........................................................................33
14 Online Update Settings, Part 1.................................................................................. 34
15 Online Update Settings, Part 2.................................................................................. 34
16 Activation Type....................................................................................................... 35
17 License Authorization Code Location...........................................................................36
18 Choose Installation Filters.........................................................................................37
19 Select Products....................................................................................................... 37
20 Confirm and Install.................................................................................................. 38
21 PuTTY Virtual Terminal Screen, Request to Boot from MMC............................................42
22 USB Flash Drive File System Name............................................................................ 44
23 Folder Error for wr_usb_boot.....................................................................................45
24 Knowledge Forum Opening Screen.............................................................................49
25 Ask Question.......................................................................................................... 50
26 Title Question......................................................................................................... 50
27 Categorize Question.................................................................................................50
28 Tagged Question..................................................................................................... 51
29 Submit Question......................................................................................................51
30 Subscribe to Forum Tags.......................................................................................... 52
31 Untrusted Certificate................................................................................................53
32 WebIF Application....................................................................................................54
33 Workspace Location Selection................................................................................... 55
34 Create a New Workbench Project...............................................................................56
35 Selecting Target Operating System............................................................................ 56
36 Select Build Type.....................................................................................................57
37 Specify Project Name...............................................................................................57
38 Enable Addons........................................................................................................ 58
39 Reload Configurations.............................................................................................. 59
40 glib_idp Option Available.......................................................................................... 60
41 Add Layers............................................................................................................. 61
42 Add wr-intel-support................................................................................................62
43 Add wr-mcafee Layer...............................................................................................63
44 Adding Options........................................................................................................63
45 enable jobs=50.......................................................................................................64
46 -enable-parallel-pkgbuilds=<number of CPUs>........................................................... 65
47 Finalize Configuration...............................................................................................66
48 Configuration Script Progress.................................................................................... 67
49 Build Configuration Completed.................................................................................. 68
50 Build Project........................................................................................................... 69
51 Build Project Progress Window...................................................................................70
52 Config File.............................................................................................................. 70
53 Build Console Displaying Project Completion................................................................71
54 PuTTY Configuration Screen...................................................................................... 73
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
6 Order No.: 330307-007
Figures—Intel IoT Gateway Development Kit DK100 Series
55 Change to Serial with Speed of 115200...................................................................... 74
56 Change Flow Control................................................................................................75
57 Change to SCO Function Keys................................................................................... 76
58 Save Settings..........................................................................................................77
59 Update Session with Correct tty Port.......................................................................... 78
April 2015 Getting Started Guide
Order No.: 330307-007 7
Intel® IoT Gateway Development Kit DK100 Series
Intel IoT Gateway Development Kit DK100 Series —Tables
Tables
1 Reference Documents.............................................................................................. 15
2 Items to Obtain.......................................................................................................16
3 Recommended Development Hosts............................................................................ 17
4 Login IDs and Passwords.......................................................................................... 18
5 Target Device Errata................................................................................................ 79
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
8 Order No.: 330307-007
Introduction—Intel IoT Gateway Development Kit DK100 Series
1.0 Introduction
1.1
About the Intel® IoT Gateway Development Kit DK100 Series
The Intel® IoT Gateways provide pre-integrated hardware and software building
blocks. The gateways connect legacy and new systems, and enable seamless and
secure data flows between edge devices and the cloud. Using a single, integrated
solution allows you to focus your resources on innovating for new services, bug data
solutions, and other IoT-focused applications.
Intel® IoT Gateway Development Kit DK100 Series includes the following:
• Processor: Intel® Quark™ SoC X1020D
• Software: Wind River® Linux (Host), Wind River® Intelligent Device Platform XT,
Wind River Workbench, McAfee* Embedded Control
• Security: Open SSL* Library, McAfee* Embedded Control, SRM Signing Tool,
Certificate Management, Secure Boot, Application Integrity Monitor, Application
Resource Control, Secure Package Management, Encrypted Storage
• Manageability and provisioning: OMA DM, TR-069, Web-based configuration
interfaces
• Communications and connectivity: Serial, USB, VPN, WI-Fi* Access Point,
Bluetooth*, MQTT, ZigBee* (ZigBee is enabled by third-party hardware)
• Runtime environments: Java*, OSGi*, Lua*
• I/O: 2x Ethernet* 10/100, USB 2.0 host & device, RS-232, RS-485, 2x internal
mini PCIe (for Wi-Fi* / Bluetooth* / 3G modules), SPI (internal), 12-bit 8 channel
ADC
• Memory and storage: 512 KB SRAM, 1 GB ECC DDR3, onboard microSD card
The Intel® IoT Gateway - Development Kit DK100 Series provides a key ingredient for
enabling the connectivity of legacy industrial, energy, and transportation devices to
the IoT. It integrates technologies and protocols for networking, embedded control,
enterprise-grade security, and easy manageability on which application-specific
software can run. This product offers:
• Speed: By integrating hardware and software building blocks.
• Protection of legacy investments by connecting new and legacy systems with
intelligent compute platforms for communication to the cloud.
• Secure data with standards-based interfaces.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
April 2015 Getting Started Guide
Order No.: 330307-007 9
Intel® IoT Gateway Development Kit DK100 Series
The following diagram illustrates the software components that are included in the
Ecosystem /
Application
Development
and end-user enabled
cloud connector,
applications, and
services
Manageability
OMA DM
TR-069
Web-Base d
Configuration Interfaces
Security
Open SSL Library
SRM Signing Tool
Certification
Management
Secure Boot
Application Integrity
Monitor
Application Resource
Control
Secure Package
Management
Encrypte d Storage
Connectivity
Bluetooth*
Serial
USB
VPN
Wi-Fi* Access P oint
MQTT
ZigBee* (enabled by
third-party hardware)
McAfee Embedded
Control
Wind River Development Environment
Wind River Linux 5.0.1
Intel Processor-Based Solution
(Intel® Quark™ SoC X1020D Processor)
Runtime Environment
Lua*
Java*
OSG
SQlite3
Intel® IoT Gateway Development Kit DK100 Series Software Stack.
Figure 1. Software Stack
Intel IoT Gateway Development Kit DK100 Series —Introduction
1.2
Intel® IoT Gateway Development Kit DK100 Series Kit Contents
Your kit contains the following items:
• One Intel® IoT Gateway DK100 Series with pre-loaded Wind River® Intelligent
Device Platform XT image
• Documentation
• One power supply
• Serial-to-USB cable set
• Two Wi-Fi antennas
• RS485 and ADC terminal connectors
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
10 Order No.: 330307-007
Introduction—Intel IoT Gateway Development Kit DK100 Series
Blank line. Do not delete.
Blank line. Do not delete.
The following photos provide details and descriptions for the hardware interfaces/
components of the Intel® IoT Gateway DK100 Series.
Figure 2. Intel® IoT Gateway DK100 Series - Back
1. Analog to Digital Converter inputs. 0-5V dynamic range. Use 10-pin connector
insert supplied.
Pinout is as follows: Pin 1: Channel 1, Pin 2: Channel 0, Pin 3: Channel 3, Pin 4:
Channel 2, Pin 5: +5V (25mA max), Pin 6: GND, Pin 7: Channel 5, Pin 8: Channel
4, Pin 9: Channel 7, Pin 10: Channel 6.
2. RS-232 serial console and debug port. 3.5mm stereo audio jack. Use the 3.5mm > DB-9 adapter supplied. The Audio Stereo Jack adapter plugs into this connector.
3. RS-485 half duplex, non-isolated serial port. Use 3-pin connector insert supplied.
The pin-out is as follows: Pin 1: Data+(B), Pin 2: GND, Pin 3: Data-(A).
4. USB Host Port - type A.
5. USB Device port - type B.
6. RJ-45 10/100 Ethernet Port 0.
7. RJ-45 10/100 Ethernet Port 1.
8. Reset button. Use a paper clip to access the button if a reset is needed.
9. 5V DC - 4A main power input. Use the power adapter supplied.
10. Wi-Fi antenna bulkhead connectors.
April 2015 Getting Started Guide
Order No.: 330307-007 11
Intel® IoT Gateway Development Kit DK100 Series
Intel IoT Gateway Development Kit DK100 Series —Introduction
Figure 3. RS-232 Cable for Serial Communication Transmission
You will use this between your Host System and the Target Device.
The USB connection, noted by number 1 in the figure, attaches to the USB port on
your Host System.
The audio stereo jack adapter, noted by number 2, attaches to the back of the Target
Device. See Figure 2 on page 11, number 2.
Note: Do not attach the RS-232 USB connection to the Host System until instructed to do
so.
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
12 Order No.: 330307-007
Introduction—Intel IoT Gateway Development Kit DK100 Series
Figure 4. Power Cord
1.3
Number 1 in the figure slides into the power holder and then can be plugged into a
power outlet.
The DC barrel connector, number 2 in the figure, connects to the back of the Target
Device. See Figure 2 on page 11, number 9.
If you need to detach the power plug from the power cradle, pinch the latch together
at the bottom of the power cradle and push the power plug up.
About this Guide
This guide is organized as follows:
• Chapters 1 - 4: How to set up your Target Device, including connecting it to your
Host System.
• Chapters 5 - 7: How to build your own runtime software and install it on your
Target Device.
• The appendices provide information about:
— Using the Intel® IoT Gateway Knowledge Forum.
— Building an Intelligent Device Platform Project using Wind River Workbench.
— Using the Wind River Workbench to perform a Project Export / Import.
— Using the Triage Tool to aid in debugging.
— Installing and configuring PuTTY.
April 2015 Getting Started Guide
Order No.: 330307-007 13
Intel® IoT Gateway Development Kit DK100 Series
Put Runtime
Software on
Flash Drive
Install Linux
and Wind River
Packages on
Host System
Build Runtime
on Host
System
Update SPI
Firmware on
Target Device
Install Runtime
on Target
Device
Before you
Begin
Connect
Hardware /
Connect Target
Device to Host
System
Connect Target
Device to Host
System
Register
Target Device
Intel IoT Gateway Development Kit DK100 Series —Introduction
For help with typing commands to your Linux terminal, use Intel® IoT Gateway
Development Kit DK100 Series - Getting Started Guide Commands at https://
downloadcenter.intel.com/Detail_Desc.aspx?
agr=Y&DwnldID=24331&lang=eng&wapkw=dk100. This text file includes all of the
commands in this Getting Started Guide. The purpose is to provide you with an easy
way to copy and paste commands to your Linux terminal.
Document Conventions
This document uses the following conventions:
• "Development Kit" refers to the Intel® IoT Gateway Development Kit DK100
Series. This term includes the gateway hardware, the board firmware, and the
software from Wind River Systems, Inc.
• "Target Device" refers to the gateway device onto which you will install Wind
River® Intelligent Device Platform XT runtime software.
• "Host System" refers to a Linux system that you will use to configure your Target
Device. You will install development tools from Wind River Systems, Inc. on this
system. The Host System is not included in this kit.
The examples in this publication use a Host System that has an Intel® Core™ i5
second generation processor and Ubuntu* Desktop 14.04 distribution software. If
you are using a different operating system, substitute the instructions in this
publication with instructions that are appropriate for your system.
•
This font is used for commands, API names, parameters,
filenames, directory paths, and executables.
• Bold text is used for graphical user interface entries, buttons, and keyboard keys.
This font in a gray box is used for commands or scripts that you must type.
This font in a green box displays responses to your commands.
• To help you keep track of your progress, illustrations are used at the beginning of
each key task. The following is an example of these illustrations.
— A white background indicates steps you have completed.
— A blue background indicates the step you are about to work on.
— A gray background indicates future steps.
Figure 5. Sample "You Are Here"
Blank line. Do not remove.
Blank line. Do not remove.
Blank line. Do not remove.
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
14 Order No.: 330307-007
Introduction—Intel IoT Gateway Development Kit DK100 Series
Blank line. Do not remove.
1.4
Reference Documents
The following documents will help you complete your installation.
Table 1. Reference Documents
Title Link Description
Intel® IoT Gateway
Development Kit DK100
Series - Getting Started
Guide Commands
Wind River® Linux 5.0 / 5.1
Recommended Development
Host Distributions
Wind River® Linux 5.0.1 Users Guide
Wind River® Intelligent
Device Platform XT 2.0 Product Brief
Wind River® Intelligent
Device Platform XT 2.0 Programmer's Guide
Wind River® Intelligent
Device Platform XT 2.0 Release Notes
Wind River® Intelligent
Device Platform XT 2.0
Security Guide
https://downloadcenter.intel.com/
Detail_Desc.aspx?
agr=Y&DwnldID=24331&lang=eng&wapk
w=dk100
Wind River Online Support:
https://knowledge.windriver.com/@api/
deki/files/153500/041441.pdf
https://www-ssl.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-linux-user-guide.html
https://www-ssl.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-idp-xt2-productbrief.html?wapkw=wind+river
https://www-ssl.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-idp-xt2programmers-guide.html?wapkw=wind
+river
http://www.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-idp-releasenotes.html
https://www-ssl.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-idp-securityguide.html?wapkw=wind+river
Text file of the commands used
in this document
• Recommended Development
Host Distributions
• Required Host Packages by
Host Distribution
• Wind River Linux Overview
• Development & Build
Environment
• Configuration and Build
• Layers & Recipes
• Userspace & Kernel
Development
• Debugging
• Product Overview
• Wind River Intelligent Device
Platform Architecture
• Technical Specifications
• Wind River Intelligent Device
Platform Overview
• Architecture
• Security, Connectivity &
Management
• Validation
• System Owner, Device &
Application Development
Vendor Tasks
• Changes in this release
• Requirements
• Issues & Customer Service
• Platform Security Overview
• Security Planning
• Risks, Threats & Intelligent
Device Platform Security
Mechanisms
• BKMs, Keys & Certificates
• Secure Repository
• Encrypted Data Storage
continued...
April 2015 Getting Started Guide
Order No.: 330307-007 15
Intel® IoT Gateway Development Kit DK100 Series
Title Link Description
Before you
Begin
Connect
Hardware /
Connect Target
Device to Host
System
Put Runtime
Software on
Flash Drive
Prepare Host
System for
Wind River
Software
Register Target
Device
Install Linux
and Wind River
Packages on
Host System
Build Runtime
on Host
System
Update SPI
Firmware on
Target Device
Install Runtime
on Target
Device
Wind River® Intelligent
Device Platform XT EMS
Profile - User's Guide
Wind River® EMS Device
Management - User's Guide
Wind River® Intelligent
Device Platform XT EMS
Profile - Release Notes
Intel IoT Gateway Development Kit DK100 Series —Introduction
http://www.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-intelligent-deviceplatform-xt-ems-profile-user-guide.html
http://www.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-ems-devicemanagement-user-guide.html
• Device Management
Overview
• Mashery API Reference and
Examples
• Wind River Intelligent Device
Platform Edge Management
System Overview
• Device side and Cloud side
components Device
Onboarding, Application
Development and Target
component updates
• Alarm workflow and error
recovery
http://www.intel.com/
content/www/us/en/embedded/designtools/evaluation-platforms/gatewaysolutions/wind-river-intelligent-deviceplatform-xt-ems-profile-releasenotes.html
• Product Overview
• Host and Target
Requirements
• Usage Caveats and Known
Issues
1.5
Before you Begin
Review the following information to make sure you have everything you need.
Required Experience Level
You need basic experience using the Linux command line interface.
Items and Software You Need to Provide
You will need to provide the following items to complete your installation:
Table 2. Items to Obtain
What you need First Needed in Notes
Host System hardware
(recommended):
• 3rdGeneration Intel® Core™ i5
processor or better
• CPU with four or more cores
and with Intel® HyperThreading Technology
• 150 GB or more of free disk
space
• 4 GB or more RAM
Connect the Target Device to a
Host System on page 20
The minimum hardware
requirements are:
• Intel® Pentium® 2 processor
• 80 GB free disk space
• 768 MB RAM
With these minimum
requirements, your performance
may not be adequate.
continued...
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
16 Order No.: 330307-007
Introduction—Intel IoT Gateway Development Kit DK100 Series
What you need First Needed in Notes
• One USB 2.0 port
Host Operating System Connect the Target Device to a
Communications:
• PuTTY utility or equivalent
• Serial to USB cable
USB flash drive with at least 4 GB
capacity
Host System on page
Connect the Target Device to a
Host System on page 20
Use Wind River WebIF to
Configure the Target Device
(Optional) on page 53
Recommended Development Hosts
The following recommended development host distributions have been tested by Wind
River to run Wind River Linux 5.0 / 5.0.1. Intel recommends the Ubuntu Desktop
14.04 (base version) 64-bit OS for your Host System.
20
The Wind River Systems, Inc.
development tools may be
installed on many different Linux*
based host systems. See
Recommended Development Hosts
on page 17
These instructions have been
validated on an Ubuntu 14 64-bit
host system.
The contents of this flash drive will
be overwritten.
Table 3. Recommended Development Hosts
Distribution Architecture
Ubuntu* Desktop 14.04 (base version) or 12.04 x86 32-bit, x86 64-bit
Red Hat Enterprise Linux Workstation 6.5 x86 32-bit, x86 64-bit
Red Hat Enterprise Linux Workstation 7 x86 64-bit
OpenSUSE* 12.2 x86 32-bit, x86 64-bit
Novell* SUSE Linux Enterprise Desktop 11 SP2 x86 32-bit, x86 64-bit
Fedora* 18 x86 32-bit, x86 64-bit
These instructions in this guide were validated on an Ubuntu 14.04 (base version) 64bit host system, which is available at http://old-releases.ubuntu.com/releases/trusty/
as ubuntu-14.04-desktop-amd64.iso
Caution: To maintain Wind River® Intelligent Device Platform XT compatability, do not perform
sudo apt-get upgrade
For detailed information on supported Linux development hosts, and for additional
Linux host requirements, see the Wind River® Intelligent Device Platform XT 2.0 Release Notes at http://www.intel.com/content/www/us/en/embedded/design-tools/
evaluation-platforms/gateway-solutions/wind-river-idp-release-notes.html
Login IDs and Passwords
You will be prompted for several login IDs and passwords throughout these installation
procedures. The following is a quick reference to them.
April 2015 Getting Started Guide
Intel® IoT Gateway
Order No.: 330307-007 17
Development Kit DK100 Series
Table 4. Login IDs and Passwords
Logging into... ID and Password
Target Device
Target Device local wireless network
Wind River Intelligent Device Platform Administration
Console (WebIF)
Technical Support
For users with a registered product, Intel provides technical support for this
Development Kit through Intel® Premier Support. If you do not already have an Intel
Premier Support account, you may apply for one when you register this Development
Kit in Register Your Development Kit on page 27.
To submit a support request using Intel Premier Support, go to https://
businessportal.intel.com. Click the Product Support Tab -> Intel Premier Support
Home. Submit your issue using one of these product names:
• Intel® IoT Gateway Development Kit DK100 Series
• Intel® Development Toolkit for Data Gateways
Intel IoT Gateway Development Kit DK100 Series —Introduction
ID: root
Password: root
Password: windriveridp
ID: admin
Password: admin
In addition to Intel® Premier Support, registered users can use the Intel® IoT
Gateway - Knowledge Forum to ask "how-to" questions. Follow the instructions in Intel
IoT Gateway Knowledge Forum on page 48 to register, login, and submit questions
in this online support forum.
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
18 Order No.: 330307-007
Connect
Hardware /
Connect
Target Device
to Host
System
Put Runtime
Software on
Flash Drive
Prepare Host
System for
Wind River
Software
Register Target
Device
Install Linux
and Wind River
Packages on
Host System
Build Runtime
on Host
System
Update SPI
Firmware on
Target Device
Install Runtime
on Target
Device
Before you
Begin
Connect the Hardware—Intel IoT Gateway Development Kit DK100 Series
2.0 Connect the Hardware
You will begin your installation by connecting the Target Device hardware. This
chapter guides you through making the connections and plugging in your Target
Device. Refer to Figure 2 on page 11 through Figure 4 on page 13 in making your
connections.
Remember: Target Device refers to the gateway device that is included in the Development Kit.
Host System refers to the Ubuntu 14.04 system that you will use to build the runtime
software.
1. Connect the RS-232 audio stereo jack to the back of the Target Device. Do not
connect the USB cable to the Host System yet.
2. Plug in the power adapter connector to the DC In connector on the Target Device.
3. Plug the power cord into a 120V or 240V power outlet to ensure it powers on.
4. Unplug the device. You will plug it in again during the next steps.
April 2015 Getting Started Guide
Order No.: 330307-007 19
Intel® IoT Gateway Development Kit DK100 Series
Connect
Hardware /
Connect
Target Device
to Host
System
Put Runtime
Software on
Flash Drive
Prepare Host
System for
Wind River
Software
Register Target
Device
Install Linux
and Wind River
Packages on
Host System
Build Runtime
on Host
System
Update SPI
Firmware on
Target Device
Install Runtime
on Target
Device
Before you
Begin
Intel IoT Gateway Development Kit DK100 Series —Connect the Target Device to a Host System
3.0 Connect the Target Device to a Host System
This section shows you how to make a connection between your Host System and
Target Device using the PuTTY utility for a serial console connection. The instructions
in this section are specific to PuTTY, but you can use a different utility to make your
connection if you prefer. See your instructions for your utility if you use another
utility. If you need help configuring PuTTY on your Host System, see Installing and
Configuring PuTTY on page 73.
What you need to do
1. Save a session in your PuTTY configuration named Intel IoT Gateway. Under
Serial line type /dev/ttyUSB0
2.
From your Host System $HOME command prompt, display the available TTY ports.
Use the following command:
ls /dev/tty*
Write down the resulting TTY port information. You will use this in the next step.
3. The RS-232 cable is already connected to your Target Device. Connect the other
end to your Host System USB port.
4. Plug in your Target Device.
5.
While still at the $HOME prompt, change the ownership and permissions for using
PuTTY. This example uses ttyUSB0 for the port. Your port may be different; see
the port you wrote down in the previous step. Use the following command,
replacing ttyUSB0 with the port that you wrote down.
sudo chmod 666 /dev/ttyUSB0
6. Start the PuTTY utility.
7. Load the IoT Gateway session that you saved in step 1.
8. Click Open to launch a PuTTY Virtual Terminal session. You are now connected to
the Target Device. The Virtual Terminal opens to a blank screen.
9. Leave the screen at this point. You will return to it later.
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
20 Order No.: 330307-007
Connect the Target Device to a Host System—Intel IoT Gateway Development Kit DK100 Series
3.1
Connecting with a Wireless Network Connection
The Target Device advertises a wireless network with a service set identifier (SSID) of
IDPDK-xxxx, where xxxx is the last four digits of the wireless network card MAC
address. This section guides you through using this information to connect a Host
System to the Target Device's wireless network to access the features on the Target
Device.
1. From the PuTTY Virtual Terminal, issue the following command to determine the
wireless SSID of the Target Device:
grep ssid /etc/config/wireless
The output displays the SSID:
option ssid IDPDK-xxxx
2. Write down your SSID.
3. Issue the following command from the Target Device command line to determine
the IP address used for the wireless Access Point:
ifconfig br-lan
The output includes the IP address, denoted by inet addr
inet
addr:<TARGET_DEVICE_IP_ADDRESS>
The Target Device ID address is likely set to the default 192.168.1.1
4. Write down your Target Device IP address.
5. On the Host System (not in the PuTTY Virtual Terminal), select the System
Settings icon.
6. Click the Network icon.
7. Click Wireless.
8. Click the dropdown arrow next to Network Name and then click the SSID that
you wrote down.
9.
When prompted, enter the password: windriveridp.
The Target Device and Host System are now connected through a wireless network.
You can use ssh to log in to the Target Device from the Host System. See Remotely
Logging in to the Target Device with ssh on page 22.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
Blank line. Do not delete.
April 2015 Getting Started Guide
Order No.: 330307-007 21
Intel® IoT Gateway Development Kit DK100 Series
Intel IoT Gateway Development Kit DK100 Series —Connect the Target Device to a Host System
3.2
Connecting with a Wired Ethernet Connection
Refer to Connect the Hardware on page 19 to make the following connections.
1. Use an Ethernet cable to connect the Target Device LAN1 port to an I/O port on a
router that has an integrated DHCP server. It is important to use the port, labeled
Ethernet LAN 1 on your Target Device. This port connects as eth1.
2. Confirm on the PuTTY video display for the Target Device that the Target Device is
connected at eth1. Your screen should display:
eth1 NIC Link is Up
3. Issue the following command from the PuTTY Virtual Terminal command line to
determine the IP address used for the network Access Point:
ifconfig br-lan
The output includes the IP address, denoted by inet addr as shown:
inet addr:<TARGET_DEVICE_IP_ADDRESS>
The Target Device IP address is probably set to the default of 192.168.1.1
4. Write down your Target Device IP address.
The Target Device and Host System are now connected to a wired network. You can
use ssh to log in to the Target Device from the Host System. See Remotely Logging in
to the Target Device with ssh on page 22.
3.3
Remotely Logging in to the Target Device with ssh
Once the Target Device and Host System are connected through a wired or wireless
network, you can use ssh to remotely log in to the Target Device from the Host
System.
1. Validate that both the Target Device and the Host System have a valid IP address
and are on same subnet. Use the following command on both the Target Device
and the Host System to see the IP address on each.
ifconfig
2. Be sure both Host System and the Target Device return an IP address and the
subnet addresses match. For example, the following addresses are valid and they
are on the same subnet:
Target Device IP address
192.168.1.1
Host System IP address
192.168.1.9
3. On the Target Device execute the following command to start the sshd deamon:
service sshd start
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
22 Order No.: 330307-007
Connect the Target Device to a Host System—Intel IoT Gateway Development Kit DK100 Series
You should see the following output:
Starting OpenBSD Secure Shell server: sshd
done.
4. (Optional): To automatically start sshd for all future reboots, execute the following
command on the Target Device:
update-rc.d sshd defaults
5. To remotely login to the Target Device from the Host System, at the Host System
execute the following command, substituting <TARGET_DEVICE_IP_ADDRESS>
with the Target Device IP address that you wrote down earlier.
ssh root@<TARGET_DEVICE_IP_ADDRESS>
Your screen displays:
root@<TARGET_DEVICE_IP_ADDRESS>'s password:
6. Type the Target Device password:
root
When you successfully log in to the Target Device, the command prompt is displayed:
root@WR-IntelligentDevice:~#
April 2015 Getting Started Guide
Order No.: 330307-007 23
Intel® IoT Gateway Development Kit DK100 Series
Intel IoT Gateway Development Kit DK100 Series —Prepare to Build Your Runtime Image
4.0 Prepare to Build Your Runtime Image
The first part of this publication got you up and running with a sample runtime image
that you used to explore some of the Target Device features. This part of the
document guides you through creating your own runtime image. Although you will not
be using your Target Device again for a while, the steps in the remainder of this
publication assume that you have completed the setup steps.
4.1
Task Checklist and Completion Times
Below are the key tasks you will complete in the remainder of the chapters. You must
complete each of these tasks in order. Upon completing one chapter, continue to the
next until you reach the optional information in the appendices.
The full installation process, including the steps to build your own runtime image takes
several hours. The time required will vary, depending on your skills and experience,
the processor speed of the system that you use to perform the configuration steps,
and the speed of your internet connection.
The estimated completion times in the table below are based on Ubuntu* Desktop
14.04 running on an Intel® Core™ i5 second generation processor and with an internet
connection running at approximately 3 MB per second.
You will prepare the Host System before working more with the Target Device.
Note: Host System refers to a computer system onto which the development tools from
Wind River Systems, Inc. will be installed. Target Device refers to the hardware that is
included in your Development Kit.
Done Task Section Estimated Completion
Preliminary Steps 30 - 90 minutes
✔ Gather necessary components Items and Software You
✔ Connect the Target Device and a Host
System
Update Host System Linux Install Ubuntu Linux
Create Host System directories, and
confirm Host System free space.
Need to Provide on page
16
Connect the Target
Device to a Host System
on page 20
Updates on page 25
Create Directories and
Confirm Disk Space on
page 26
10 minutes
10 minutes
10 minutes to 1 hour,
depending on the
number of updates to
install
10 minutes
Time
continued...
Intel® IoT Gateway Development Kit DK100 Series
Getting Started Guide April 2015
24 Order No.: 330307-007
Loading...