快速入门：配置网络并更新设备 OS

  • 项目

认领 Azure Sphere 设备后，将其配置为网络，以便它可以从 Azure Sphere 安全服务接收云更新，并与Azure IoT 中心等服务进行通信。 配置并启用网络后，设备可以从云接收 OS 更新。

重要

本主题介绍如何将 Azure Sphere 设备连接到 Wi-Fi 网络。 如果设备支持其他网络机制且不支持 Wi-Fi，请使用该机制将其连接到 Internet，然后继续 接收设备更新。

先决条件

在 Azure Sphere 设备上设置 Wi-Fi

按照以下步骤在 Azure Sphere 设备上配置 Wi-Fi：

  1. 将 Azure Sphere 设备连接到计算机。

  2. 使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开命令行界面。

  3. 如果网络环境需要，请注册设备的 MAC 地址。 使用以下命令获取 MAC 地址，然后根据环境的过程注册该地址：

    az sphere device wifi show-status

  4. 使用 az sphere device wifi add 命令将 Wi-Fi 网络添加到设备，如下所示：

    az sphere device wifi add --ssid <SSID> --psk <EXAMPLEPSK>

    将 SSID> 替换为<网络的名称。 网络 SSD 区分大小写。 如果 SSID 处于隐藏状态，请添加 --targeted-scan 以尝试连接到它。 可以使用 az sphere device wifi scan 获取可用 Wi-Fi 网络的列表。

    将 EXAMPLEPSK> 替换为 <WPA/WPA2 密钥。 Azure Sphere 设备不支持 WEP。 若要添加开放网络，请省略 --psk。

    如果网络 SSID 或密钥具有嵌入空格或和号，请将 SSID 或键括在单引号中。 如果 SSID 或键包含引号，请使用反斜杠来转义引号。 如果反斜杠是值的一部分，则不必进行转义。 例如：

    az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

    网络通常需要几秒钟的时间才能在板上准备就绪，但可能需要更长的时间，具体取决于网络环境。

  5. 使用 az sphere device wifi show-status 命令检查连接状态：

    az sphere device wifi show-status

    在更新期间， az sphere device wifi show-status 命令可能会暂时显示未知的配置状态。 以下示例显示了安全 WPA2 连接的成功结果：

    ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
===============================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------

az sphere device wifi 命令支持多个附加选项。 键入 az sphere device wifi--help 获取完整列表，或 键入 az sphere device wifioption--help 获取单个选项的帮助。

按照以下步骤在 Azure Sphere 设备上配置 Wi-Fi：

  1. 将 Azure Sphere 设备连接到计算机。

  2. 打开 Azure Sphere 资源管理器。

  3. 展开感兴趣的设备的“设备”节点。

  4. 展开 Wi-Fi 节点。 应会看到如下所示的内容：

  5. 展开标记为 “已断开连接 ”的节点，应会看到设备的 MAC 地址。 如果网络环境需要，请注册设备的 MAC 地址。 请注意右侧的“刷新”按钮;连接到网络后，你将需要此来查看连接信息。

  6. 如果可能，请展开 “可用网络 ”节点。 将鼠标悬停在要连接到的网络上，然后选择“ 连接 ”， (这会在节点) 右侧显示为 +。 如果网络需要预共享密钥 (PSK) ，请在显示的文本框中键入网络密码，然后按 Enter。

  7. 返回到之前标记为 “已断开连接”的节点，现在应读取 “已连接到： <网络>”。 如果片刻后仍显示 “断开连接 ”，请单击此节点上的“刷新”按钮，查看设备的更新连接状态。

  8. 应会看到以下信息：

    • Ssid
    • 配置状态
    • 连接状态
    • 安全状态
    • 频率
    • 模式
    • 密钥管理类型
    • WPA 状态
    • IP 地址
    • MAC 地址

    此信息与 CLI 命令 az sphere device wifi show-status 报告的信息相同。

    还应看到已连接的网络显示在 “已保存的网络 ”节点上。

按照以下步骤在 Azure Sphere 设备上配置 Wi-Fi：

  1. 将 Azure Sphere 设备连接到计算机。

  2. 打开 Azure Sphere 资源管理器。

  3. 展开感兴趣的设备的“设备”节点。

  4. 展开 Wi-Fi 节点。 应会看到如下所示的内容：

  5. 展开标记为 “已断开连接 ”的节点，应会看到设备的 MAC 地址。 如果网络环境需要，请注册设备的 MAC 地址。 请注意右侧的“刷新”按钮;连接到网络后，你将需要此来查看连接信息。

  6. 如果可能，请展开可用网络节点。 右键单击要连接到的网络，然后选择“ 连接”。 如果网络需要预共享密钥 (PSK) ，请在 “PSK ”文本框中键入网络密码，然后按 Enter。

  7. 返回到之前标记为 “已断开连接”的节点，现在应读取 “已连接到： <网络>”。 如果片刻后仍显示 “断开连接 ”，请单击此节点上的“刷新”按钮，查看设备的更新连接状态。

  8. 应会看到以下信息：

    • IP 地址
    • 安全状态
    • MAC 地址
    • WPA 状态
    • 模式
    • 频率
    • 密钥管理类型
    • 是否使用了目标扫描

    此信息与 CLI 命令 az sphere device wifi show-status 报告的信息相同。

    还应看到已连接的网络显示在 “已保存的网络 ”节点上。

启用或禁用 Wi-Fi 网络

可以使用 az sphere device wifi enable 命令启用配置的 Wi-Fi 网络：

az sphere device wifi enable --id <ID>

将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。

可以使用 az sphere device wifi disable 命令禁用配置的 Wi-Fi 网络，如下所示：

az sphere device wifi disable --id <ID>

将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。

若要在Visual Studio Code的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。

  2. 查找已禁用的网络;它们的名称右侧有一个 Wi-Fi 符号。

  3. 选择 Wi-Fi 符号，或右键单击网络名称，然后选择 “启用”。

若要禁用Visual Studio Code的 Azure Sphere Explorer 中配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。

  2. 查找已启用的网络;它们将具有一个 Wi-Fi 符号，其名称右侧有反斜杠。

  3. 选择禁用的 Wi-Fi 符号，或右键单击网络名称，然后选择 “禁用”。

若要在 Visual Studio 的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。

  2. 查找已禁用的网络;它们的名称右侧有一个连接符号。

  3. 选择连接符号，或右键单击网络名称，然后选择 “启用”。

若要禁用Visual Studio Code的 Azure Sphere Explorer 中配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。

  2. 查找已启用的网络;它们的名称右侧有一个断开连接符号。

  3. 选择断开连接符号，或右键单击网络名称，然后选择“ 禁用”。

忘记 Wi-Fi 网络

可以使用 az sphere device wifi forget 命令忘记配置的 Wi-Fi 网络：

az sphere device wifi forget --id <ID>

将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。

若要忘记Visual Studio Code的 Azure Sphere Explorer 中配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。
  2. 右键单击要忘记的网络，然后选择“忘记”。

若要忘记 Visual Studio 的 Azure Sphere 资源管理器中配置的 Wi-Fi 网络，请执行以下操作：

  1. 展开 “保存的网络” 节点。
  2. 右键单击要忘记的网络，然后选择“忘记”。

接收设备更新

Azure Sphere 设备在每次启动时、最初连接到 Internet 时以及之后的 24 小时间隔检查 Azure Sphere OS 和应用程序更新。 如果更新可用，下载和安装可能需要 15-20 分钟，并可能导致设备重启。

若要检查更新状态，请键入以下命令：

az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

如果你有较旧的 Seeed MT3620 开发工具包，可能需要手动更新它：

  1. 通过 USB 将开发板连接到电脑。

  2. 使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开命令行界面。

  3. 使用恢复过程更新开发板：

    az sphere device recover

如果遇到 Wi-Fi 问题，请先确保 Wi-Fi 网络使用 802.11b/g/n;Azure Sphere 设备不支持 802.11a。

注意

Azure Sphere OS 更新是一个分阶段的过程，其时间可能不到 15 分钟，但可能会更长，具体取决于 Internet 连接。 在各个阶段之间，在下载下一组更新时，开发板将正常运行，但在更新期间，你应该预期开发板一次有几分钟无响应。

后续步骤

订阅 Azure Sphere 通知