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", ¤tInterfaceStatus);
Para ativar a interface de rede, use a função Networking_SetInterfaceState .
Networking_SetInterfaceState("wlan0", true);
Nota
Se as interfaces de rede (wlan0 e eth0) estiverem ativas e conectadas, a interface específica que o dispositivo usará para comunicação não será determinística. Se você quiser controlar qual interface de rede é usada a qualquer momento, seu aplicativo deve usar a função Networking_SetInterfaceState() para ativar explicitamente a interface desejada e a outra interface desativada. O exemplo de aplicativo de alto nível do cliente DHCP demonstra, entre outras coisas, como alternar entre interfaces atribuindo um valor que representa uma das duas interfaces a uma variável global.
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.
Nota
Os exemplos a seguir são da Galeria do Azure Sphere, que é uma coleção de exemplos de software e hardware não retidos da Microsoft. Para obter mais informações, confira Galeria do Azure Sphere.
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.