Intel® Joule™

Intel® Joule™

Intel® Joule™, Intel’s highest-performing system-on-module, packs powerful compute capabilities in a thumb-sized, low-power package. The Intel® Joule™ 550x/570x developer kit enables developers to rapidly prototype all manner of autonomous robots and IoT applications requiring computer vision or edge processing.

Intel® Joule™ 是英特尔性能最卓越的模块化系统，其在一个拇指大小的低功耗封装中实现了强大的包计算能力。对于那些需要机器视觉或边缘计算能力的机器人和物联网应用，Intel® Joule™ 550x/570x 开发套件可以快速的将创意转变成原型乃至产品。

""

Flashing the image

烧录镜像

Before you begin flashing, you will need the following items in addition to your Joule board:
开发者烧录镜像前，需要准备以下的工具:

  • Micro-USB cable

    Micro-USB 线

  • USB-C cable

    USB-C 线

  • 12V 3A power adapter

    12V 3A 电源适配器

  • Micro-HDMI cable

    Micro-HDMI 线

  • MicroSD card reader

    MicroSD 读卡器

  • USB keyboard (optional)

    USB 键盘(可选)

To flash Android Things onto your board, download the preview image in the Android Things Console (see the release notes) and follow these steps:

先在 Android Things 控制台 中下载 Android Things 镜像(请参阅发行说明) ，再按照以下步骤完成镜像烧录。

Step 1: Install Fastboot

第一步：安装 Fastboot

If this is your first time installing Android Things on the Joule, you need to upgrade the BIOS and bootloader to be Fastboot capable. Follow the Intel Getting Started Guide to perform the required one-time setup steps on your board.
如果您是第一次在 Joule 上安装 Android Things ，需要更新 BIOS (基本输入输出系统)和 bootloader (引导程序)模块，来实现 Fastboot 功能。您可以参考 Intel 入门手册 ，在模组上执行一次性设置步骤。

Step 2: Connect the Hardware

第二步: 连接硬件

Connect the board to your host computer as shown below:
按照下面的方法将Joule连接到您的计算机：

""

  1. Connect a 12V adapter to the power input connector.

    使用 12V 电源适配器和电源连接。

  2. Connect a USB-C cable from your host computer for USB OTG.

    使用 USB-C 线和计算机连接，起到 USB OTG 的作用。

  3. Connect a Micro-HDMI cable to an external display.

    使用 Micro-HDMI 线和显示器连接。

  4. Optionally, connect a USB keyboard for BIOS setup.

    [可选] 使用 USB 键盘设置 Joule BIOS 。

Step 3: Flash Android Things

第三步: 烧录 Android Things

Once you have loaded the proper bootloader on your device, use the following steps to flash the Android image:
一旦您在设备上加载了正确的 bootloader ，请使用以下步骤来烧录 Android Things 镜像：

  1. Download and install Android Studio or the sdkmanager command-line tool. Update the Android SDK Platform Tools to version 25.0.3 or later from the SDK Manager.
    下载和安装 Android Studio 或 sdkmanager 命令行工具。在 SDK 管理器 中将 Android SDK 平台工具更新到 25.0.3 或以后的版本。

    • Navigate to the Android SDK location on your computer; the path can be found in the system settings for Android Studio. Verify that the fastboot binary is installed in the platform-tools/ directory.

      使用计算机导航到 Android SDK 所在路径，验证 fastboot 二进制文件是否已经安装在 platform-tools/ 目录下。Android SDK 路径可以在 Android Studio 的系统设置中找到。

    • After you have the fastboot tool, add it to your PATH environment variable. This command should be similar to the following:

      将 fastboot 工具增添到计算机的 PATH 环境变量里面。 可参考如下命令行： 

  1.       `export PATH=$PATH:"path/to/fastboot"`

  1. Open a command line terminal and navigate to the unzipped image directory.

    在计算机中打开一个命令行窗口，并导航到镜像所在的解压缩目录。

  2. Verify that the device has booted into Fastboot mode by executing the following command:

    通过执行以下命令，验证设备已经进入 Fastboot 模式。 

    1.   $ fastboot devices1b2f21d4e1fe0129        fastboot

    Note: Your device will not boot into Fastboot mode if it was previously flashed with Android Things. You need to first execute the following command using the adb tool to reboot the device into Fastboot mode.

注意: 如果设备曾经烧录过 android Things ，设备开机将不会进入 Fastboot 模式。您需要使用 adb 工具 执行以下命令，重启设备并进入 Fastboot 模式。

  1.     $ adb reboot bootloader</span></aside>

  1. Execute the flash-all.sh script. This script installs the necessary bootloader, baseband firmware(s), and operating system. (On Windows systems, use flash-all.bat instead).

    执行 flash-all.sh 脚本，安装 bootloader ，基带固件和操作系统。( Windows 系统可以使用 flash-all.bat 脚本)。

Note: The device automatically reboots into Android Things when the process is complete.

注意: 安装完成后，设备将自动重启并进入 android thing。

  1. To verify that Android is running on the device, discover it using the adb tool:

    使用 adb tool 去验证 Android Things 是否已经在设备在运行。

    1.  $ adb wait-for-device...$ adb devicesList of devices attached1b2f21d4e1fe0129        device

Connecting Wi-Fi

连接 Wi-Fi

After flashing your board, it is strongly recommended to connect it to the internet. This allows your device to deliver crash reports and receive updates.

设备烧录镜像后，强烈建议您把它连接到互联网。这将有助于设备提交崩溃报告到云端，并接收云端的更新。

Note: The device doesn’t need to be on the same network as your computer.

注意: 设备和计算机不需要在同一个网络中

Before connecting your board to a Wi-Fi network, ensure the provided antennas are attached to the u.FL Wi-Fi connectors on your board as shown:

在您的设备连接到 Wi-Fi 网络前，请先确保天线已经连接到您设备的 u.FL Wi-Fi 连接器上，如下所示：

""

Note: he Joule can’t resolve Wi-Fi signals if you proceed without connecting an antenna.

注意: 如果您没有连接天线， Joule 就无法接收 Wi-Fi 信号。

To connect your board to Wi-Fi, first access a shell prompt on the device. You can use either of the following methods:

您可以使用以下任何一种方法，在设备上访问 shell 提示符，将设备连接到 Wi-Fi 。

  • Open a shell over adb with the adb shell command.

    用 adb shell 命令在 adb 上打开一个 shell 。

Once you can access a shell prompt, follow these steps:

一旦您可以访问 shell 提示符，请执行以下步骤:

  1. Send an intent to the Wi-Fi service that includes the SSID of your local network. Your board must support the network protocol and frequency band of the wireless network in order to establish a connection.

设备向 Wi-Fi 服务发送一个包含本地网络 SSID 的连接请求包。因要和Wi-Fi 建立连接，设备必须支持相关的无线网络协议和频带。

  1.     $ am startservice \    -n com.google.wifisetup/.WifiSetupService \    -a WifiSetupService.Connect

The following arguments are supported with this command:
该命令支持如下参数:

Argument Description
-e ssid <var>network_ssid</var> Connect to the wireless network SSID specified by networkssid. _This argument is required.
设置参数network_ssid，连接到指定 SSID 的无线网络，参数是必选的。
-e passphrase <var>network_pass</var> Optional argument to use the passcode specified by network_pass to connect to the network SSID. This argument is not necessary if your network doesn’t require a passcode.
参数network_pass是可选的，用来设置无线网络的密码，如果您的网络不需要密码，参数可以不用填写。
-e passphrase64 <var>encoded_pass</var> Optional argument used in place of passphrase for passcodes with special characters (space, !, ", $, &, ', (, ), ;, <, >, ‘, or |). Use base64 encoding to specify the value for encoded_pass.
如果密码中包含 (空格, !, ", $, &, ', (, ), ;, <, >, ‘, or |) 特殊字符，请使用 passphrase64 代替 passphrase ，对参数encoded_pass进行 base64 编码。
--ez hidden true Optional argument to indicate that the SSID specified in this command is hidden. If omitted, this value defaults to false.
如果 SSID 无线网络是隐藏的，请将参数 hidden 设置为 true ，参数缺省值是 false 。

  1. Verify that the connection was successful through logcat:

    使用logcat 命令，验证 Wi-Fi 连接是否成功。

    1. $ logcat -d | grep Wifi...V WifiWatcher: Network state changed to CONNECTEDV WifiWatcher: SSID changed: ...I WifiConfigurator: Successfully connected to ...

  2. Test that you can access a remote IP address:

    使用ping 命令，测试设备是否可以访问远程网络。

    1. $ ping 8.8.8.8PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.64 bytes from 8.8.8.8: icmp_seq=1 ttl=57 time=6.67 ms64 bytes from 8.8.8.8: icmp_seq=2 ttl=57 time=55.5 ms64 bytes from 8.8.8.8: icmp_seq=3 ttl=57 time=23.0 ms64 bytes from 8.8.8.8: icmp_seq=4 ttl=57 time=245 ms

  3. Check that the date and time are set correctly on the device:

    使用date 命令，检查设备的日期和时间是否准确。

    1. $ date

Note: An incorrect date or time may cause SSL errors. Restart the device to automatically set the correct date and time from a time server.

注意: 错误的日期或时间可能会导致 SSL 连接错误。可以通过重新启动设备的方式，自动从时间服务器获取正确的日期和时间。

If you want to clear all of the saved networks on the board:

如果您想清除设备上的网络设置，可以使用以下命令。

  1. $ am startservice \    -n com.google.wifisetup/.WifiSetupService \    -a WifiSetupService.Reset

Serial debug console

串口调试控制台

The serial console is a helpful tool for debugging your board and reviewing system log information. The console is the default output location for kernel log messages (i.e. dmesg), and it also provides access to a full shell prompt that you can use to access commands such as logcat. This is helpful if you are unable to access ADB on your board through other means and have not yet enabled a network connection.

串口控制台是一款非常有用的工具，用来调试设备和检查系统日志。控制台是内核日志消息（如dmesg ）的默认输出位置，同时它也提供了一套完整的 shell 访问命令，您可以用它来访问 logcat 等命令。如果您无法在您的设备上通过其他方式获取 ADB 且没有网络连接，这将为您提供帮助。

To access the serial console, connect a micro USB cable to the board as shown below.

如果您要访问串口控制台，请按照下图所示，连接 micro USB 线到设备上。

""

Open a connection to the USB serial device on your development computer using a terminal program, such as PuTTY (Windows), Serial (Mac OS), or Minicom (Linux). The serial port parameters for the console are as follows:

使用计算机终端程序 PuTTY (Windows)， Serial (Mac OS)， 或者 Minicom (Linux) 和 USB 串口设备建立连接。 控制台的串口参数如下所示：

  • Baud Rate: 115200

    波特率：115200

  • Data Bits: 8

    数据位：8

  • Parity: None

    奇偶校验：无

  • Stop Bits: 1

    停止位：1