通过

将 Azure Sphere 连接到 Wi-Fi

  • 项目

可以使用 CLI 或 Azure Sphere SDK 应用程序库 (Applibs) 将 Azure Sphere 设备配置为通过 Wi-Fi 连接到 Internet。

身份验证方法

支持以下身份验证方法：

为 Wi-Fi 配置 Azure Sphere

可以将 Azure Sphere 设备配置为从命令行 (CLI) ，或使用 Azure Sphere SDK 应用程序库 (Applibs) 从应用程序连接到 Wi-Fi 网络。

使用 CLI Wi-Fi 配置

若要从命令行管理 Wi-Fi 配置，请使用 az sphere device wifi CLI 命令。 例如， device wifi add 命令会将无线网络的详细信息添加到设备。


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

若要使用配置的 Wi-Fi 网络，网络接口 (wlan0) 必须处于活动状态。 使用 设备网络列表接口 命令确定接口是否处于活动状态。


az sphere device network list-interfaces

如有必要，请使用 设备网络启用 命令来激活它。


az sphere device network enable --interface wlan0

若要启用配置的 Wi-Fi 网络，请使用 设备 wifi enable 命令。


az sphere device wifi enable --id <network id>

快速入门主题在 Azure Sphere 设备上设置 Wi-Fi 介绍了如何从命令行在 Azure Sphere 设备上配置 Wi-Fi。

或者，如果使用 EAP-TLS 身份验证，请参阅 从 CLI 设置 EAP-TLS 网络。

使用 Applibs Wi-Fi 配置

若要配置 Wi-Fi，应用程序必须使用 applibs wificonfig API。

在应用程序中包括此头文件：

#include <applibs/wificonfig.h>

应用程序清单必须包含 WifiConfig 功能。

 "Capabilities": {
  "WifiConfig" : true
}

若要确定网络接口是否处于活动状态，请使用 Networking_GetInterfaceConnectionStatus 函数。

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

若要激活网络接口，请使用 Networking_SetInterfaceState 函数。

Networking_SetInterfaceState("wlan0", true);

注意

如果 (wlan0 和 eth0) 两个网络接口都处于活动状态且已连接，则设备用于通信的特定接口是不确定的。 如果要控制在任何给定时间使用哪个网络接口，应用程序必须使用 Networking_SetInterfaceState () 函数来显式打开所需接口，并关闭另一个接口。 DHCP 客户端高级应用示例演示了如何在接口之间切换，方法是将表示两个接口之一的值分配给全局变量。

若要从应用程序启用配置的 Wi-Fi 网络，请使用 WifiConfig_SetNetworkEnabled 函数。

WifiConfig_SetNetworkEnabled(<network id>, true);

有关使用 Applibs wificonfig API 使客户能够针对包含 Azure Sphere 的产品配置 Wi-Fi 的建议，请参阅 在字段中配置 Wi-Fi 。

主题 在应用中设置 EAP-TLS 网络 介绍了如何在高级 Azure Sphere 应用程序中配置 EAP-TLS 网络。

样品

本部分包含示例应用程序的链接，这些应用程序演示如何在 Azure Sphere 平台上使用 Wi-Fi 功能。

WiFi_HighLevelApp示例演示如何在高级应用程序中配置 Wi-Fi 网络。

DHCP 客户端高级应用演示如何续订或释放网络 DHCP 服务器已分配给 MT3620 设备的当前 IP 地址。

注意

以下示例来自 Azure Sphere 库，该库是 Microsoft 提供的未经维护的软件和硬件示例的集合。 有关详细信息，请参阅 Azure Sphere 库。

WifiConfigurationViaAppResource 示例演示如何使用嵌入式 JSON 资源文件配置设备 Wi-Fi 设置。

WifiConfigurationViaNfc 示例演示如何使用 NFC 配置设备 Wi-Fi 设置。

WifiConfigurationViaUart 示例演示如何使用 UART 配置设备 Wi-Fi 设置。