快速入门:配置网络并更新设备 OS
声明 Azure Sphere 设备后,为其配置网络,以便它可以从 Azure Sphere 安全服务接收云更新,以及与 Azure IoT 中心等服务通信。 配置和启用网络后,设备可以从云接收 OS 更新。
重要
本主题介绍如何将 Azure Sphere 设备连接到 Wi-Fi 网络。 如果设备支持其他网络机制且不支持 Wi-Fi,请使用该机制将其连接到 Internet,然后继续执行接收设备更新步骤。
先决条件
- 安装适用于 Visual Studio 的 Azure Sphere 扩展。
- 安装适用于 Windows 或 Linux 的 SDK
- 快速入门:选择租户并声明设备
在 Azure Sphere 设备上设置 Wi-Fi
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi:
将 Azure Sphere 设备连接到计算机。
使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开命令行界面。
如果网络环境有此要求,请注册设备的 MAC 地址。 使用以下命令获取 MAC 地址,然后根据适用于环境的过程进行注册:
azsphere device wifi show-status
使用 azsphere device wifi add 命令将 Wi-Fi 网络添加到设备,如下所示:
azsphere device wifi add --ssid <SSID> --psk <EXAMPLEPSK>
将 SSID> 替换为<网络的名称。 网络 SSID 区分大小写。 如果 SSID 已隐藏,请添加
--targeted-scan
以尝试仍然连接到它。 可以使用 azsphere device wifi scan 来获取可用 Wi-Fi 网络的列表。将 EXAMPLEPSK> 替换为 <WPA/WPA2 密钥。 Azure Sphere 设备不支持 WEP。 若要添加打开的网络,请省略
--psk
。如果网络 SSID 或密钥具有嵌入空格或安和号,请将 SSID 或密钥括在单引号中。 如果 SSID 或密钥包含引号,请使用反斜杠对引号进行转义。 如果反斜杠是值的一部分,则不必进行转义。 有关详细信息,请参阅 引号和转义字符。 例如:
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
开发板上的网络通常需要几秒钟才能准备就绪,但可能需要更长时间,具体取决于网络环境。
使用 azsphere device wifi show-status 命令检查连接的状态:
azsphere device wifi show-status
在更新期间,azsphere 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> ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
azsphere device wifi 命令支持多个其他选项。 键入 azsphere device wifi 以获取完整列表,或键入 azsphere device wifi option --help 以获取有关各个选项的帮助。
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi:
将 Azure Sphere 设备连接到计算机。
展开你感兴趣的设备的“设备”节点。
展开 Wi-Fi 节点。 会看到下面这样的内容:
展开标记为“已断开连接”的节点,应会看到设备的 MAC 地址。 如果网络环境有此要求,请注册设备的 MAC 地址。 记下右侧的刷新按钮;连接到网络后,需要查看连接信息。
如果可能,请 展开“可用网络 ”节点。 将鼠标悬停在要连接到的网络上,然后选择“连接”(这显示为节点右侧的+)。 如果网络需要预共享密钥(psk),请在出现的文本框中键入网络密码,然后按 Enter。
返回到之前标记为“已断开连接”的节点,该节点现在应读取“已连接到:<网络>”。 如果片刻后仍然看到 “已断开连接 ”,请单击此节点上的刷新按钮以查看设备的更新连接状态。
应会看到以下信息:
- SSID
- 配置状态
- 连接状态
- 安全状态
- 频率
- 模型
- 密钥管理类型
- WPA 状态
- IP 地址
- MAC 地址
这与 CLI 命令 azsphere device wifi show-status 报告的信息相同。
还应看到已连接的网络显示在 “已保存的网络 ”节点上。
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi:
将 Azure Sphere 设备连接到计算机。
展开你感兴趣的设备的“设备”节点。
展开 Wi-Fi 节点。 会看到下面这样的内容:
展开标记为“已断开连接”的节点,应会看到设备的 MAC 地址。 如果网络环境有此要求,请注册设备的 MAC 地址。 记下右侧的刷新按钮;连接到网络后,需要查看连接信息。
如果可能,请展开可用网络节点。 右键单击要连接到的网络,然后选择“ 连接”。 如果网络需要预共享密钥(PSK),请在 PSK 文本框中键入网络密码,然后按 Enter。
返回到之前标记为“已断开连接”的节点,该节点现在应读取“已连接到:<网络>”。 如果片刻后仍然看到 “已断开连接 ”,请单击此节点上的刷新按钮以查看设备的更新连接状态。
应会看到以下信息:
- IP 地址
- 安全状态
- MAC 地址
- WPA 状态
- 模型
- 频率
- 密钥管理类型
- 是否使用了目标扫描
这与 CLI 命令 azsphere device wifi show-status 报告的信息相同。
还应看到已连接的网络显示在 “已保存的网络 ”节点上。
启用或禁用 Wi-Fi 网络
可以使用 azsphere device wifi enable 命令启用配置的 Wi-Fi 网络:
azsphere device wifi enable --id <ID>
将 ID> 替换为<可以通过调用 azsphere device wifi list 获取的网络 ID。
可以使用 azsphere device wifi disable 命令禁用配置的 Wi-Fi 网络,如下所示:
azsphere device wifi disable --id <ID>
将 ID> 替换为<可以通过调用 azsphere device wifi list 获取的网络 ID。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络,请执行以下操作:
展开“已保存的网络”节点。
查找已禁用的网络;这些名称右侧将具有 Wi-Fi 符号。
选择 Wi-Fi 符号,或右键单击网络名称,然后选择“ 启用”。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中禁用配置的 Wi-Fi 网络,请执行以下操作:
展开“已保存的网络”节点。
查找已启用的网络;这些符号的 Wi-Fi 符号在其名称右侧带有反斜杠。
选择禁用的 Wi-Fi 符号,或右键单击网络名称,然后选择“ 禁用”。
若要在 Visual Studio 的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络,请执行以下操作:
展开“已保存的网络”节点。
查找已禁用的网络;这些名称的右侧将具有连接符号。
选择连接符号,或右键单击网络名称,然后选择“ 启用”。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中禁用配置的 Wi-Fi 网络,请执行以下操作:
展开“已保存的网络”节点。
查找已启用的网络;这些项的名称右侧将有一个断开连接符号。
选择断开连接符号,或右键单击网络名称,然后选择“ 禁用”。
忘记 Wi-Fi 网络
可以使用 azsphere device wifi forget 命令忘记配置的 Wi-Fi 网络:
azsphere device wifi forget --id <ID>
将 ID> 替换为<可以通过调用 azsphere device wifi list 获取的网络 ID。
在 Visual Studio Code 的 Azure Sphere 资源管理器中忘记配置的 Wi-Fi 网络:
- 展开“已保存的网络”节点。
- 右键单击要忘记的网络,然后选择“ 忘记”。
在 Visual Studio 的 Azure Sphere 资源管理器中忘记配置的 Wi-Fi 网络:
- 展开“已保存的网络”节点。
- 右键单击要忘记的网络,然后选择“ 忘记”。
接收设备更新
Azure Sphere 设备在每次启动时都会检查 Azure Sphere OS 和应用程序更新情况,首次连接到 Internet 时检查一次,之后每隔 24 小时检查一次。 如果有可用的更新,下载和安装所需的时间可能长达 15-20 分钟,并且可能导致设备重启。
若要查看更新状态,请键入以下命令:
azsphere device show-deployment-status
如果你有较旧的 Seeed MT3620 开发工具包,则可能必须手动更新,如在早期开发工具包上更新 OS 中所述。
如果遇到 Wi-Fi 问题,请首先确保 Wi-Fi 网络使用 802.11b/g/n;Azure Sphere 设备不支持 802.11a。
注意
Azure Sphere OS 更新是一个分阶段的过程,可能不到 15 分钟,也可能会更长,具体取决于互联网连接情况。 在各阶段之间,开发板将在下一组更新下载时显示为可操作。但在更新期间,开发板有时几分钟都可能没有响应。