Conectar o Azure Sphere ao Wi-Fi

Você pode configurar um dispositivo do Azure Sphere para se conectar à Internet por meio de Wi-Fi usando a CLI ou as Bibliotecas de Aplicativos do SDK do Azure Sphere (Applibs).

Métodos de autenticação

Há suporte para os seguintes métodos de autenticação:

• WPA2
• EAP-TLS
• abrir (sem senha)

Configurar o Azure Sphere para Wi-Fi

Você pode configurar seu dispositivo do Azure Sphere para se conectar a uma rede Wi-Fi da CLI (linha de comando) ou do seu aplicativo usando as Bibliotecas de Aplicativos do SDK do Azure Sphere (Applibs).

Wi-Fi configuração usando a CLI

Para gerenciar Wi-Fi configuração da linha de comando, use os comandos da CLI wi-fi do dispositivo az sphere. Por exemplo, o comando de adição wi-fi do dispositivo adiciona os detalhes de uma rede sem fio ao dispositivo.

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

Para usar a rede Wi-Fi configurada, a interface de rede (wlan0) deve estar ativa. Use o comando list-interfaces de rede do dispositivo para determinar se a interface está ativa.

az sphere device network list-interfaces

Use o comando habilitar a rede do dispositivo para ativá-la, se necessário.

az sphere device network enable --interface wlan0

Para habilitar a rede Wi-Fi configurada, use o comando habilitar wi-fi do dispositivo .

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

O tópico Início Rápido Configurar Wi-Fi em seu dispositivo do Azure Sphere descreve como configurar Wi-Fi em seu dispositivo do Azure Sphere a partir da linha de comando.

Como alternativa, se você estiver usando a autenticação EAP-TLS, consulte Configurar a rede EAP-TLS da CLI.

Wi-Fi configuração usando Applibs

Para configurar o Wi-Fi, seu aplicativo deve usar a API de wificonfig applibs.

Inclua este arquivo de cabeçalho em seu aplicativo:

#include <applibs/wificonfig.h>

O manifesto do aplicativo deve incluir o recurso WifiConfig .

 "Capabilities": {
  "WifiConfig" : true
}

Para determinar se a interface de rede está ativa, use a função Networking_GetInterfaceConnectionStatus .

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

Para ativar a interface de rede, use a função Networking_SetInterfaceState .

Networking_SetInterfaceState("wlan0", true);

Para habilitar uma rede de Wi-Fi configurada do seu aplicativo, use a função WifiConfig_SetNetworkEnabled .

WifiConfig_SetNetworkEnabled(<network id>, true);

Consulte Configurar Wi-Fi no campo para obter sugestões para usar a API wificonfig do Applibs para permitir que seus clientes configurem Wi-Fi para seus produtos que incorporam o Azure Sphere.

O tópico Configurar a rede EAP-TLS em um aplicativo descreve como configurar uma rede EAP-TLS em um aplicativo do Azure Sphere de alto nível.

Amostras

Esta seção contém links para aplicativos de exemplo que demonstram o uso de Wi-Fi funcionalidade na plataforma do Azure Sphere.

O exemplo WiFi_HighLevelApp demonstra a configuração de redes Wi-Fi em um aplicativo de alto nível.

O aplicativo de alto nível do cliente DHCP demonstra como renovar ou liberar o endereço IP atual que o servidor DHCP da rede atribuiu ao dispositivo MT3620.

O exemplo WifiConfigurationViaAppResource demonstra como configurar configurações de Wi-Fi de dispositivo usando um arquivo de recurso JSON inserido.

O exemplo WifiConfigurationViaNfc demonstra como configurar configurações de Wi-Fi de dispositivo usando NFC.

O exemplo WifiConfigurationViaUart demonstra como configurar configurações de Wi-Fi de dispositivo usando o UART.