Подключение к Wi-Fi в Azure Sphere

Статья
09/27/2024

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

Устройство Azure Sphere можно настроить для подключения к Интернету через Wi-Fi с помощью интерфейса командной строки или библиотек приложений пакета SDK Azure Sphere (Applibs).

методы проверки подлинности;

Поддерживаются следующие методы проверки подлинности:

WPA2
EAP-TLS
open (без пароля)

Настройка Azure Sphere для Wi-Fi

Устройство Azure Sphere можно настроить для подключения к сети Wi-Fi из командной строки (CLI) или из приложения с помощью библиотек приложений пакета SDK Azure Sphere (Applibs).

Конфигурация Wi-Fi с помощью интерфейса командной строки

Чтобы управлять конфигурацией Wi-Fi из командной строки, используйте команды azsphere device wifi CLI. Например, команда добавления wi-fi устройства добавляет сведения о беспроводной сети на устройство.


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

Чтобы использовать настроенную сеть Wi-Fi, сетевой интерфейс (wlan0) должен быть активным. Используйте команду сетевых интерфейсов устройств, чтобы определить, активен ли интерфейс.


azsphere device network list-interfaces

При необходимости используйте команду включения сети устройств, чтобы активировать ее.


azsphere device network enable --interface wlan0

Чтобы включить настроенную сеть Wi-Fi, используйте команду включения wi-fi устройства.


azsphere device wifi enable --id <network id>

В разделе краткого руководства по настройке Wi-Fi на устройстве Azure Sphere описывается настройка Wi-Fi на устройстве Azure Sphere из командной строки.

Кроме того, если вы используете проверку подлинности EAP-TLS, см . раздел "Настройка сети EAP-TLS из CLI".

Конфигурация Wi-Fi с помощью applibs

Чтобы настроить Wi-Fi, приложение должно использовать API wificonfig applibs.

Включите этот файл заголовка в приложение:

#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);

Сведения о настройке Wi-Fi см. в разделе "Настройка Wi-Fi" в поле предложений по использованию API wificonfig Applibs, чтобы пользователи могли настроить Wi-Fi для продуктов, включающих Azure Sphere.

В разделе "Настройка сети EAP-TLS" в приложении описывается настройка сети EAP-TLS в высокоуровневом приложении Azure Sphere.

Примеры

В этом разделе содержатся ссылки на примеры приложений, демонстрирующих использование функций Wi-Fi на платформе Azure Sphere.

В примере WiFi_HighLevelApp показана настройка сетей Wi-Fi в высокоуровневом приложении.

Высокоуровневый приложение DHCP-клиента демонстрирует, как обновить или освободить текущий IP-адрес, назначенный DHCP-серверу сети устройству MT3620.

Примечание.

Ниже приведены примеры из коллекции Azure Sphere, которая представляет собой коллекцию неуправляемых образцов программного обеспечения и оборудования от Корпорации Майкрософт. Дополнительные сведения см. в коллекции Azure Sphere.

В примере WifiConfigurationViaAppResource показано, как настроить параметры Wi-Fi устройства с помощью внедренного файла ресурсов JSON.

В примере WifiConfigurationViaNfc показано, как настроить параметры Wi-Fi устройства с помощью NFC.

В примере WifiConfigurationViaUart показано, как настроить параметры Wi-Fi устройства с помощью UART .

Поделиться через