Intel DK100 Series Getting Started Manual
Intel DK100 Series Getting Started Manual

Intel DK100 Series Getting Started Manual

Iot gateway development kit
Table of Contents

Advertisement

Quick Links

®
Intel
IoT Gateway Development Kit
DK100 Series
Getting Started Guide
April 2015
Order No.: 330307-007

Advertisement

Table of Contents
loading

Summary of Contents for Intel DK100 Series

  • Page 1 ® Intel IoT Gateway Development Kit DK100 Series Getting Started Guide April 2015 Order No.: 330307-007...
  • Page 2 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.
  • Page 3: Quick Power-On

    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.
  • Page 4: Revision History

    Intel IoT Gateway Development Kit DK100 Series —Revision History Revision History Date Revision Description April 2015 Changed information related to recommended development hosts Updated errata ® February 2015 First Intel IoT Gateway 2.1 release Document restructured Added appendix to build an Intelligent Device Platform...
  • Page 5: Table Of Contents

    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...............
  • Page 6 Intel IoT Gateway Development Kit DK100 Series —Figures Figures Software Stack......................10 ® Intel IoT Gateway DK100 Series - Back..............11 RS-232 Cable for Serial Communication Transmission...........12 Power Cord......................13 Sample "You Are Here".....................14 Register a Product....................27 Create Support User Account..................28 Wind River License Key Request Confirmation.............
  • Page 7 Figures—Intel IoT Gateway Development Kit DK100 Series Change to Serial with Speed of 115200..............74 Change Flow Control....................75 Change to SCO Function Keys................... 76 Save Settings......................77 Update Session with Correct tty Port................78 ® Intel IoT Gateway Development Kit DK100 Series...
  • Page 8 Intel IoT Gateway Development Kit DK100 Series —Tables Tables Reference Documents....................15 Items to Obtain.......................16 Recommended Development Hosts................17 Login IDs and Passwords..................18 Target Device Errata....................79 ® Intel IoT Gateway Development Kit DK100 Series Getting Started Guide April 2015...
  • Page 9: Introduction

    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.
  • Page 10: Software Stack

    Intel IoT Gateway Development Kit DK100 Series —Introduction The following diagram illustrates the software components that are included in the ® Intel IoT Gateway Development Kit DK100 Series Software Stack. Figure 1. Software Stack Security Ecosystem / Manageability Connectivity Open SSL Library...
  • Page 11: Intel ® Iot Gateway Dk100 Series - Back

    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.
  • Page 12: Rs-232 Cable For Serial Communication Transmission

    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.
  • Page 13: Power Cord

    Introduction—Intel IoT Gateway Development Kit DK100 Series Figure 4. Power Cord 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.
  • Page 14: Sample "You Are Here

    The Host System is not included in this kit. ® ™ The examples in this publication use a Host System that has an Intel Core 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.
  • Page 15: Reference Documents

    Introduction—Intel IoT Gateway Development Kit DK100 Series Blank line. Do not remove. Reference Documents The following documents will help you complete your installation. Table 1. Reference Documents Title Link Description ® Intel IoT Gateway https://downloadcenter.intel.com/ Text file of the commands used Development Kit DK100 Detail_Desc.aspx?
  • Page 16: Items To Obtain

    Intel IoT Gateway Development Kit DK100 Series —Introduction Title Link Description ® Wind River Intelligent http://www.intel.com/ • Device Management Device Platform XT EMS content/www/us/en/embedded/design- Overview Profile - User's Guide tools/evaluation-platforms/gateway- • Mashery API Reference and solutions/wind-river-intelligent-device- Examples platform-xt-ems-profile-user-guide.html ® Wind River EMS Device http://www.intel.com/...
  • Page 17: Recommended Development Hosts

    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. Table 3.
  • Page 18: Login Ids And Passwords

    Console (WebIF) Password: admin 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...
  • Page 19: Connect The Hardware

    Connect the Hardware—Intel IoT Gateway Development Kit DK100 Series Connect the Hardware Connect Before you Prepare Host Register Target Install Linux Build Runtime Put Runtime Install Runtime Update SPI Hardware / Begin System for Device and Wind River on Host...
  • Page 20: Connect The Target Device To A Host System

    Intel IoT Gateway Development Kit DK100 Series —Connect the Target Device to a Host System Connect the Target Device to a Host System Connect Before you Prepare Host Register Target Install Linux Build Runtime Put Runtime Install Runtime Update SPI...
  • Page 21: Connecting With A Wireless Network Connection

    Connect the Target Device to a Host System—Intel IoT Gateway Development Kit DK100 Series Connecting with a Wireless Network Connection The Target Device advertises a wireless network with a service set identifier (SSID) of , where is the last four digits of the wireless network card MAC...
  • Page 22: Connecting With A Wired Ethernet Connection

    Intel IoT Gateway Development Kit DK100 Series —Connect the Target Device to a Host System 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.
  • Page 23 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...
  • Page 24: Prepare To Build Your Runtime Image

    Intel IoT Gateway Development Kit DK100 Series —Prepare to Build Your Runtime Image 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.
  • Page 25: Prepare Host System For Wind River Software Installation

    Prepare to Build Your Runtime Image—Intel IoT Gateway Development Kit DK100 Series Done Task Section Estimated Completion Time Register your Development Kit to obtain a Register Your 10 minutes to register. Wind River SW license. A license is Development Kit...
  • Page 26 Intel IoT Gateway Development Kit DK100 Series —Prepare to Build Your Runtime Image Create Directories and Confirm Disk Space Create the following directories on your Host System: • - This directory is used to install the Wind River Host Tools.
  • Page 27: Register A Product

    You will use the login ID and password that you create or use in these steps to access the Intel Registration Center. On the Intel Registration Center you can see a list of licensed products and download the installers for those software products.
  • Page 28: Create Support User Account

    Intel IoT Gateway Development Kit DK100 Series —Register Your Development Kit 2. In the box for your email address, select the appropriate option for your email address: ® • IMPORTANT: If you have an Intel Premier Support account, use the email ®...
  • Page 29: Logged Into Intel Registration Center

    Register Your Development Kit—Intel IoT Gateway Development Kit DK100 Series 7. Type your user name and password to sign into the Intel Registration Center. 8. Once you have signed in, your list of subscribed products is displayed. See the example below.
  • Page 30: Message: Thank You For Registering Intel

    Intel IoT Gateway Development Kit DK100 Series —Register Your Development Kit 10. Click the Download: [file] link to download the Installer for the Wind River Host Tools. You will use this file to install the Wind River Host Tools in the next chapter.
  • Page 31 Register Your Development Kit—Intel IoT Gateway Development Kit DK100 Series Under the text indicates that you will receive a license SOFTWARE LICENSE KEY key from Wind River. You will need this license key when you install the Wind River Components on the Host System in...
  • Page 32: Install Linux Packages And Wind River Linux Host Tools On The Host System

    Intel IoT Gateway Development Kit DK100 Series —Install Linux Packages and Wind River Linux Host Tools on the Host System Install Linux Packages and Wind River Linux Host Tools on the Host System Install Linux Build Runtime Put Runtime Install Runtime...
  • Page 33: Wind River Installer Package Updates

    Install Linux Packages and Wind River Linux Host Tools on the Host System—Intel IoT Gateway Development Kit DK100 Series Note: You may have used different directory names when you created directories in Create Directories and Confirm Disk Space on page 26. If you used different names, replace the directory names in the following steps with the names of the directories that you created.
  • Page 34: Online Update Settings, Part 1

    Intel IoT Gateway Development Kit DK100 Series —Install Linux Packages and Wind River Linux Host Tools on the Host System Figure 14. Online Update Settings, Part 1 6. On the next Online Updates Settings page, leave the defaults selected, as shown: Figure 15.
  • Page 35: Activation Type

    Install Linux Packages and Wind River Linux Host Tools on the Host System—Intel IoT Gateway Development Kit DK100 Series The Wind River Installer checks for updates. This takes about 2 minutes. 7. On the page Install or Download, choose between installing right away from the internet, or to copy the product files to the Host System and perform the installation later.
  • Page 36: License Authorization Code Location

    Intel IoT Gateway Development Kit DK100 Series —Install Linux Packages and Wind River Linux Host Tools on the Host System Figure 17. License Authorization Code Location 11. Click Next. A progress bar displays while the installer contacts Wind River to verify your Wind River License Authorization Code and register your Host System.
  • Page 37: Choose Installation Filters

    Install Linux Packages and Wind River Linux Host Tools on the Host System—Intel IoT Gateway Development Kit DK100 Series Figure 18. Choose Installation Filters 13. On the Select Products page, keep the default selections. Your screen will look similar to the following.
  • Page 38: Confirm And Install

    Intel IoT Gateway Development Kit DK100 Series —Install Linux Packages and Wind River Linux Host Tools on the Host System 14. Click Next. The License Agreement displays. Review it, and then click I ACCEPT if you agree to the terms of the agreement.
  • Page 39 Install Linux Packages and Wind River Linux Host Tools on the Host System—Intel IoT Gateway Development Kit DK100 Series Verify All Required Linux Packages Are Installed These steps verify that all Linux operating system packages required for using the Wind River Host Tools are present. If any are not present, this section guides you through installing them.
  • Page 40: Build Intelligent Device Platform Xt Runtime Software

    Intel IoT Gateway Development Kit DK100 Series —Build Intelligent Device Platform XT Runtime Software Build Intelligent Device Platform XT Runtime Software Build Runtime Put Runtime Install Runtime Update SPI Before you Connect Connect Target Register Target Install Linux and on Host...
  • Page 41 Build Intelligent Device Platform XT Runtime Software—Intel IoT Gateway Development Kit DK100 Series Note: By default the runtime operating system is built with the latest version of the Wind River Host Tools that you installed on your Host System. To use an earlier version, specify the desired "RCPL"...
  • Page 42: Putty Virtual Terminal Screen, Request To Boot From Mmc

    Intel IoT Gateway Development Kit DK100 Series —Update SPI Firmware Update SPI Firmware Update SPI Before you Connect Connect Target Register Target Install Linux and Build Runtime Put Runtime Install Runtime Firmware on Begin Hardware / Device to Host Device...
  • Page 43 Update SPI Firmware—Intel IoT Gateway Development Kit DK100 Series 5. After the firmware has updated, power down the Target Device by issuing the following command: poweroff ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 44: Usb Flash Drive File System Name

    Intel IoT Gateway Development Kit DK100 Series —Put Intelligent Device Platform XT Runtime Image onto USB Flash Drive Put Intelligent Device Platform XT Runtime Image onto USB Flash Drive Put Runtime Connect Target Register Target Install Runtime Update SPI Before you...
  • Page 45: Folder Error For Wr_Usb_Boot

    Put Intelligent Device Platform XT Runtime Image onto USB Flash Drive—Intel IoT Gateway Development Kit DK100 Series accidentally include the partition in the command, you will receive an error message: ERROR: Device mode should be set to -d option. e.g.: /dev/sdb Warning: The following command will overwrite all contents on your USB flash drive.
  • Page 46 Intel IoT Gateway Development Kit DK100 Series —Put Intelligent Device Platform XT Runtime Image onto USB Flash Drive 4. When the process completes, remove the USB flash drive and re-insert it into the Host System. The USB flash drive mounts as /media/<username>/...
  • Page 47: Install Intelligent Device Platform Xt Runtime On Target Device

    Host System. $HOME Note: The runtime software can be booted from the USB flash drive, but Intel recommends installing the runtime components on the Target Device's hard drive. What you need to do 1. To install the Intelligent Device Platform XT from the USB flash drive to the Target...
  • Page 48 ® community knowledge forum is available for the Intel IoT Gateway Development Kit. The forum is located at https://ask.intel.windriver.com. On this forum, you can ask ® how-to questions and search for answers related to Wind River Linux and the Wind River development tools.
  • Page 49: Knowledge Forum Opening Screen

    ® Intel IoT Gateway Knowledge Forum—Intel IoT Gateway Development Kit DK100 Series Using the Forum After you are registered and logged in, you can use the forum to ask questions and search for topics of interest. Submitted questions are posted on the forum and are accessible to all forum users.
  • Page 50: Ask Question

    Hardware, such as board, processor SKU, memory, I/O etc. 4. Categorize your question. Add IOT-Gateway as a tag in addition to specific ® product tags. This will allow the support team to track issues related to Intel Gateway See the following figure. Figure 27.
  • Page 51: Tagged Question

    ® Intel IoT Gateway Knowledge Forum—Intel IoT Gateway Development Kit DK100 Series Your selected tags display in a list. You can add or remove tags as necessary. See the following figure. Figure 28. Tagged Question 5. Click Ask Your Question to submit the question. See the red box in the following figure.
  • Page 52: Subscribe To Forum Tags

    ® Intel IoT Gateway Development Kit DK100 Series —Intel IoT Gateway Knowledge Forum Subscribing to Tags You can choose to subscribe to specific tags to receive email alerts for issues and updates to questions related to that tag/category. Use the following steps.
  • Page 53: Untrusted Certificate

    Use Wind River WebIF to Configure the Target Device (Optional)—Intel IoT Gateway Development Kit DK100 Series Appendix B Use Wind River WebIF to Configure the Target Device (Optional) This appendix guides you through using the Wind River WebIF application. WebIF is a web-based interface used to manage wired, wireless, and 3G connectivity on Intelligent Device Platform XT Target Devices.
  • Page 54: Webif Application

    Intel IoT Gateway Development Kit DK100 Series —Use Wind River WebIF to Configure the Target Device (Optional) ® 4. Login with user name: and password: . The Wind River Intelligent admin admin Device Platform XT 2.0 Web Interface (WebIF) console opens. See the figure below.
  • Page 55: Workspace Location Selection

    2. Upon launching, Workbench asks for a workspace folder. Type the path or browse to your workspace folder. Suggestion: Use your home folder. See the following figure: Figure 33. Workspace Location Selection ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 56: Create A New Workbench Project

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench The application launches. 3. From the main menu, click File > New > Wind River Workbench Project, as shown: Figure 34. Create a New Workbench Project 4.
  • Page 57: Select Build Type

    Specify Project Name Important: You must enable as an addon before selecting the RootFS wr-idp type. Make sure you correctly complete steps 7 - 8. ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 58: Enable Addons

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench 7. Click Add and select as shown below. -enable-addons=[yes|no|addon[…] Figure 38. Enable Addons ® Intel IoT Gateway Development Kit DK100 Series Getting Started Guide April 2015 Order No.: 330307-007...
  • Page 59: Reload Configurations

    Reload button. See the following figure. Note: If you do not click Reload, you cannot use as the RoofFS type. glibc-idp Figure 39. Reload Configurations ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 60: Glib_Idp Option Available

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench 9. For RootFS, select glibc_idp as shown: Figure 40. glib_idp Option Available 10. For Board, select the board type appropriate for your Target Device. if your ®...
  • Page 61: Add Layers

    Building an Intelligent Device Platform Project Using Wind River Workbench—Intel IoT Gateway Development Kit DK100 Series 12. You are ready to add layers. Click Add… as shown below. Figure 41. Add Layers ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 62: Add Wr-Intel-Support

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench 13. Select wr-intel-support as shown below, and then click Reload. Figure 42. Add wr-intel-support ® Intel IoT Gateway Development Kit DK100 Series...
  • Page 63: Add Wr-Mcafee Layer

    15. Add additional layers as needed. 16. Click the Add button in the Option group as shown in figure below: Figure 44. Adding Options ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 64: Enable Jobs=50

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench 17. Add an option to , as shown below. Then click OK. -enable-jobs=50 Figure 45. enable jobs=50 ® Intel IoT Gateway Development Kit DK100 Series...
  • Page 65: Enable-Parallel-Pkgbuilds=

    -enable-parallel-pkgbuilds=<number of CPUs> is the number of CPUs in your system. See the following <number of CPUs> figure. Then click OK. Figure 46. -enable-parallel-pkgbuilds=<number of CPUs> ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 66: Finalize Configuration

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench 20. Click Finish to finalize your configuration. Figure 47. Finalize Configuration ® Intel IoT Gateway Development Kit DK100 Series Getting Started Guide April 2015 Order No.: 330307-007...
  • Page 67: Configuration Script Progress

    The configuration script will show a progress screen similar to the following while it executes. Execution will take a few minutes. Figure 48. Configuration Script Progress ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 68: Build Configuration Completed

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench Upon completion you will see a summary screen similar to the following: Figure 49. Build Configuration Completed You are ready to build your project. Follow the steps in the next section.
  • Page 69: Build Project

    2 to 4 hours to build your project. The build ® ™ took approximately 4 hours on a test system that was running an Intel Core ® i7-4900 processor at 2.8 GHz with Intel Hyper-Threading technology, and 8 GB RAM.
  • Page 70: Build Project Progress Window

    Intel IoT Gateway Development Kit DK100 Series —Building an Intelligent Device Platform ® Project Using Wind River Workbench The project build begins and the progress displays as follows: Figure 51. Build Project Progress Window 2. Optional: Open a terminal window to examine the config file generated by Workbench.
  • Page 71: Build Console Displaying Project Completion

    Gateway Development Kit DK100 Series Upon completion, the Build Console displays as follows: Figure 53. Build Console Displaying Project Completion 3. Deploy your project to your Target Device. ® Intel IoT Gateway Development Kit DK100 Series April 2015 Getting Started Guide Order No.: 330307-007...
  • Page 72: Appendix D Triage Tool

    The output is a compressed tar file that can be provided to Intel's support team for quick issue resolution. Attach your Triage Tool ®...
  • Page 73: Putty Configuration Screen

    Installing and Configuring PuTTY—Intel IoT Gateway Development Kit DK100 Series Appendix E Installing and Configuring PuTTY This section guides you through installing and configuring a Secured Shell (SSH) / Telnet network protocol utility, named PuTTY. PuTTY is an open source virtual terminal that is available in the Ubuntu 14.04 release.
  • Page 74: Change To Serial With Speed Of 115200

    Intel IoT Gateway Development Kit DK100 Series —Installing and Configuring PuTTY 2. Make the following changes on this screen: • Change Connection type to Serial. See number 1 in the following figure. • Change Speed to 115200. This option will be available after you change the Connection type to Serial.
  • Page 75: Change Flow Control

    Installing and Configuring PuTTY—Intel IoT Gateway Development Kit DK100 Series 3. Under the Category menu on the left side of your screen, select Serial and change the Flow control to None. See number 1 and 2 in the following figure: Figure 56.
  • Page 76: Change To Sco Function Keys

    Intel IoT Gateway Development Kit DK100 Series —Installing and Configuring PuTTY 4. Under the Category menu on the left side of your screen, select Keyboard and change the Function keys and keypad to SCO. See number 1 and 2 in the following figure: Figure 57.
  • Page 77: Save Settings

    1. Under the Category menu on the left side of your screen, select Session. Name your session as Intel IoT Gateway, and then click Save. Your session name will be displayed in the Saved Sessions list. See the numbered items in the following figure.
  • Page 78: Update Session With Correct Tty Port

    1. Click Intel IoT Gateway under Saved Sessions. See number 1 in the following figure. 2. Click Load to display the Intel IoT Gateway settings. See number 2 in the figure. 3. Change the Serial line to /dev/ttyUSB0 and then click Save. See numbers 3 and 4 in the figure.
  • Page 79: Target Device Errata

    Troubleshooting—Intel IoT Gateway Development Kit DK100 Series Appendix F Troubleshooting The errata for this version of the platform are shown in the following table. Table 5. Target Device Errata Errata Description Workaround ® The Wi-Fi Access Point or Ethernet WAN interface...

Table of Contents