Conectar o Azure Sphere à rede Wi-Fi

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

Métodos de autenticação

Os seguintes métodos de autenticação são suportados:

• WPA2
• EAP-TLS
• aberto (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 Applibs (Bibliotecas de Aplicativos do SDK do Azure Sphere).

Configuração de Wi-Fi usando a CLI

Para gerenciar a configuração de Wi-Fi na linha de comando, use os comandos azsphere device wifi CLI . Por exemplo, o comando device wifi add adiciona os detalhes de uma rede sem fio ao dispositivo.

azsphere 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 device network list-interfaces para determinar se a interface está ativa.

azsphere device network list-interfaces

Use o comando device network enable para ativá-lo, se necessário.

azsphere device network enable --interface wlan0

Para habilitar a rede Wi-Fi configurada, use o comando device wifi enable .

azsphere device wifi enable --id <network id>

O tópico de início rápido Configurar o Wi-Fi em seu dispositivo do Azure Sphere descreve como configurar o Wi-Fi em seu dispositivo do Azure Sphere na linha de comando.

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

Configuração de Wi-Fi usando Applibs

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

Inclua este arquivo de cabeçalho em seu aplicativo:

#include <applibs/wificonfig.h>

O manifesto do aplicativo deve incluir a funcionalidade 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 Wi-Fi configurada a partir do seu aplicativo, use a função WifiConfig_SetNetworkEnabled .

WifiConfig_SetNetworkEnabled(<network id>, true);

Consulte Configurar Wi-Fi no campo para obter sugestões sobre como usar a API wificonfig do Applibs para permitir que seus clientes configurem o 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 da funcionalidade Wi-Fi 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 definir as configurações de Wi-Fi do dispositivo usando um arquivo de recurso JSON inserido.

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

O exemplo WifiConfigurationViaUart demonstra como definir as configurações de Wi-Fi do dispositivo usando UART.