英特尔 XDK 物联网专版使用指南

英特尔® XDK 物联网专版提供了代码模板以协助您您快速开始创建能够与传感器、执行器等进行交互的物联网应用，并允许您在英特尔物联网平台上进行测试，令物联网开发迅速高效。本指南将向您介绍如何安装英特尔 XDK 物联网版，以及如何在英特尔 Galileo 或 Edison 开发板上创建并运行简单的物联网应用，这些步骤可用于所有支持的操作系统。

英特尔 XDK 物联网版概述

英特尔 物联网开发套件是一套用来创建和测试英特尔物联网平台应用的完整解决方案，其提供了用于创建项目所需使用的开发板和 Grove* Starter Kit 传感器套件。英特尔物联网开发套件包含用于进行 JavaScript* 编程的软件，其主要由三个部分组成：英特尔 XDK 物联网版、Yocto Linux* 系统以及一系列库。这些库使开发人员能够更加便捷地控制基于英特尔物联网平台集成的硬件组件，并以高级权限别访问多个传感器和传动装置。

• Yocto* Linux 是专用于嵌入式项目的板载操作系统，提供了用于准备设置、选择软件包和创建系统安装镜像的工具。当您拿到一张新的英特尔 Edison 或 Galileo 开发板时，其已预装了 Yocto Linux。英特尔物联网开发套件还提供另一套包含了更多函数库和资源的 Yocto Linux，令开发者能使用最喜爱的编程语言创建自己的物联网应用程序。此版本包括 GCC*、Python*、Node.js*、OpenCV* 等等，而这些还只是冰山一角，如果您想要了解关于 Yocto 的更多信息，请访问 http://www.yoctoproject.org。
• 安装在英特尔 Galileo 或英特尔 Edison 主板上的 Yocto 系统提供了英特尔物联网开发套件和英特尔 XDK 物联网版专用的 MRAA 和 UPM 库var onboardLED = new mraa.Gpio(3);
• UPM（或 libupm）是采用 C++ 和利用 MRAA 编写的传感器仓库。UPM 和 MRAA 库都通过 C++ 与 JavaScript 绑定。有了英特尔 XDK 物联网版，您可以使用 Node.js 与所有的 GPIO 插针、库、软件包进行通信。例如，您可以像下面这样轻松地创建一行代码来调用扩展板上的第3个插口：
• MRAA （或 libmraa） 是一个低级别的库，可以将一般用途德I/O (GPIO) 接口转换到英特尔 Galileo 或 Edison 板卡上的针脚。因此开发人员轻松可以通过选择 pin 代码直接使用它，而不必从 Linux 内核上的 GPIO 模块中阅读原始级别的信息，MRAA 已能够照顾到底层细节。
• 若要更新这些库，请参阅《更新 libmraa 和 libupm 库》。
  
  

系统和设备要求

首先确保您已经将 IoT 板卡连接到了 Windows*、Mac* OS X* 或 Linux* 系统。接下来：

• 对于英特尔 Edison，请参照 64-bit Windows、32-bit Windows、Mac OS X 和 Linux 下的步骤。
• 对于英特尔 Galileo，请参照 Windows、Mac OS X 或 Linux 下的步骤。如果你使用的是英特尔 Galileo，请插入装有 Yocto* 启动镜像的 SD 卡，英特尔 XDK 物联网版会使用其中的库来执行一些必要的环节。
  
  

安装英特尔 XDK 物联网专版

这一部分的内容将向您介绍如何安装最新的英特尔 XDK 物联网版。

• 要下载最新的英特尔 XDK 物联网版, 请访问英特尔 物联网软件下载页，在下拉列表中选好您的操作系统，然后点击下载按钮。
• 通过以下方法之一运行安装程序：
  
  
  • Windows： 用鼠标右键单击下载好的安装程序，然后选择“以管理员身份运行”，在弹出的消息框中单击“是”继续。
  • OS X： 双击下载好的 .dmg 文件，挂载成功后双击 .pkg 文件开始安装。
  • Linux：
    
    
    • 打开终端，进入安装程序所在的文件夹。例如，如果安装程序存储在桌面文件夹中，键入 cd ~/Desktop
    • 解压安装程序文件，输入 tar zxvf installername
    • 进入刚刚解压的文件夹
    • 运行安装程序，输入 ./install.sh
      
      
    
    
• 按照安装向导中的提示来安装物联网版的英特尔 XDK。
  
  

安装 Bonjour* Print 服务（仅 Windows）

这一部分是关于安装 Bonjour* Print 服务的步骤，仅适用于 Windows 操作系统。Bonjour 使英特尔 XDK 可自以动检测网络上安装的物联网设备。

• 要为 Windows 下载安装 Bonjour，请转到 Bonjour Print 服务主页 thttp://support.apple.com/kb/DL999。
• 单击下载。
• 右键单击 BonjourPSSetup.exe，然后选择“以管理员身份运行”。如果弹出确认消息，单击“是”继续。
• 按照向导提示安装 Bonjour。
  
  

启动英特尔 XDK 物联网专版

• 运行英特尔 XDK 物联网版。
• 根据屏幕提示登录或注册您的英特尔 XDK 账户。
  
  

从模板和样例创建应用

这一部分向您介绍如何使用现有的代码样例创建一个简单的英特尔 XDK 应用。在该部分结束时，您将拥有一个能使板载 LED 闪亮的新项目。

• 在项目选项卡下，单击“创建新项目”。
• 在左侧菜单中选择“应用样例”。
  
  
• 在展示的样例中，选择 Onboard LED Blink 然后点击继续。
  
  
• 填写项目名称。
• 单击创建，将创建一个新的项目。
  
  
  

注意：如果您是 Windows 用户并且没有安装 Bonjour，您的系统将提示“Bonjour is missing”。请按照之前的步骤完成 Bonjour 的安装。

连通英特尔 物联网平台

该部分向您介绍如何将 Galileo 或 Edison 主板连接到英特尔 XDK。执行该操作后，您将收到一条板卡连接状态的确认消息。

• 在物联网设备下拉列表中，选择您的开发板。
• 注： 如果您的开发板不包含在列表中，则需要手动进行连接。请参阅下一小节《手动连接开发板》。
• 如果设备连接对话框打开，请输入您的用户名和密码并点击“连接”，这时将弹出一个显示连接状态和开发板 IP 地址的对话框。
• 单击“知道了”，然后继续《运行物联网应用》部分的操作。
  
  

注意：如果您遇到连接问题，请将您的开发板连接到串行通信会话中并键入以下命令：

systemctl enable xdk-daemon

systemctl restart xdk-daemon

手动连接开发板

这一部分向您介绍开发板没有被软件自动检测到的情况下，如何将其手动连接到英特尔 XDK。在此次操作结束后，您将收到一个包含开发板连接状态的确认邮件。

• 从物联网设备下拉列表中，选择添加手动连接。
• 在打开的对话框中，输入如下图所示的连接信息：
  
  
  • 在地址栏中输入开发板的 IP 地址。
  • 键入端口号，默认为 58888。
    
    
• 输入您的用户名和密码。
• 点击“连接”将显示一条确认消息。然后继续执行下一小节的步骤。
  
  

注意: 如果您不知道开发板的 IP 地址，请使用终端模拟器如 PuTTY 等通过串行通信会话进行连接。输入命令：ifconfig 将显示 IP 地址，如下所示：

运行物联网应用

这一小节向您介绍如何运行示例应用程序。该部分结束时，您将学会如何为您的开发主板编写一个使 LED 不断闪烁的应用。

注意：

英特尔 Galileo 第一代 位于右图所示方位的左下角。
英特尔 Galileo 第二代 位于 USB 端口 旁边。
英特尔 Edison 位于板卡靠中心位置。

• 如果出现了"ERRCONNREFUSED"错误，请在英特尔 Edison 开发板论坛上查找解决方法。
• 如果运行程序时显示"无法找到 mraa”消息，请按以下所示方法更新 mraa 库文件：
  
  
  • 使用串行通信端口连接您的主板
  • 输入以下命令：
    echo "src mraa-upm http://iotdk.intel.com/repos/1.1/intelgalactic" > /etc/opkg/intel-iotdk.conf
    opkg update
    opkg upgrade
  • 点击运行图标。
    
    

其他事项

• Wi-Fi*
• 蓝牙*