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

Статья
08/09/2023

Вы можете настроить устройство 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 из командной строки, используйте команды az sphere device wifi CLI. Например, команда добавления wi-fi устройства добавляет сведения о беспроводной сети на устройство.


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

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


az sphere device network list-interfaces

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


az sphere device network enable --interface wlan0

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


az sphere 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 wi-ficonfig 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);

Рекомендации по использованию API Applibs wificonfig см. в разделе Настройка Wi-Fi в поле Рекомендации по использованию API Applibs Wificonfig, чтобы клиенты могли настроить 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.

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