Conectar Azure Sphere a Wi-Fi

Puede configurar un dispositivo Azure Sphere para conectarse a Internet a través de Wi-Fi mediante la CLI o las bibliotecas de aplicaciones de Azure Sphere SDK (Applibs).

Métodos de autenticación

Se admiten los siguientes métodos de autenticación:

• WPA2
• EAP-TLS
• abierto (sin contraseña)

Configurar Azure Sphere para Wi-Fi

Puede configurar su dispositivo Azure Sphere para conectarse a una red Wi-Fi desde la línea de comandos (CLI) o desde su aplicación mediante las bibliotecas de aplicaciones del SDK de Azure Sphere (Applibs).

Wi-Fi con la CLI

Para administrar Wi-Fi configuración desde la línea de comandos, utilice los comandos cli az sphere device wifi. Por ejemplo, el comando device wifi add agrega los detalles de una red inalámbrica al dispositivo.

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

Para utilizar la red Wi-Fi configurada, la interfaz de red (wlan0) debe estar activa. Utilice el comando list-interfaces de la red del dispositivo para determinar si la interfaz es activa.

az sphere device network list-interfaces

Usa el comando enable de la red del dispositivo para activarlo si es necesario.

az sphere device network enable --interface wlan0

Para habilitar la red Wi-Fi configurada, utilice el comando device wifi enable .

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

El tema de Inicio rápido Configurar Wi-Fi en su dispositivo Azure Sphere describe cómo configurar Wi-Fi en su dispositivo Azure Sphere desde la línea de comandos.

Como alternativa, si está utilizando la autenticación EAP-TLS consulte Configurar la red EAP-TLS del CLI.

Wi-Fi configuración con Applibs

Para configurar Wi-Fi, tu aplicación debe usar la API applibs wificonfig.

Incluya este archivo de encabezado en la aplicación:

#include <applibs/wificonfig.h>

El manifiesto de la aplicación debe incluir la funcionalidad WifiConfig .

 "Capabilities": {
  "WifiConfig" : true
}

Para determinar si la interfaz de red está activa, use la función Networking_GetInterfaceConnectionStatus .

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

Para activar la interfaz de red, use la función Networking_SetInterfaceState .

Networking_SetInterfaceState("wlan0", true);

Nota

Si ambas interfaces de red (wlan0 y eth0) son activas y conectadas, la interfaz específica que usará el dispositivo para la comunicación no es determinista. Si desea controlar qué interfaz de red se utiliza en un momento dado, la aplicación debe utilizar la función Networking_SetInterfaceState() para activar explícitamente la interfaz deseada y desactivar la otra interfaz. La muestra de aplicación de alto nivel del cliente DHCP demuestra entre otras cosas, cómo cambiar entre interfaces asignando un valor que representa una de las dos interfaces a una variable global.

Para habilitar una red Wi-Fi configurada desde la aplicación, use la función WifiConfig_SetNetworkEnabled .

WifiConfig_SetNetworkEnabled(<network id>, true);

Consulta Configurar Wi-Fi en el campo para obtener sugerencias sobre el uso de la API wificonfig de Applibs para permitir a los clientes configurar Wi-Fi para los productos que incorporan Azure Sphere.

El tema Configurar la red EAP-TLS en una aplicación describe cómo configurar una red EAP-TLS en una aplicación de Azure Sphere de alto nivel.

Muestras

Esta sección contiene vínculos a aplicaciones de ejemplo que demuestran el uso de Wi-Fi funcionalidad en la plataforma Azure Sphere.

El ejemplo de WiFi_HighLevelApp muestra la configuración de redes de Wi-Fi en una aplicación de alto nivel.

La aplicación de alto nivel del cliente DHCP demuestra cómo renovar o liberar la dirección IP actual que el servidor DHCP de la red ha asignado al dispositivo MT3620.

Nota

Las siguientes muestras son de la Galería de esferas de Azure, que es una colección de muestras de software y hardware de Microsoft que no se han obtenido. Para obtener más información, consulte Galería de esferas de Azure.

En el ejemplo wifiConfigurationViaAppResource se muestra cómo configurar la configuración del dispositivo Wi-Fi mediante un archivo de recursos JSON incrustado.

La muestra WifiConfigurationViaNfc muestra cómo configurar los ajustes del Wi-Fi del dispositivo mediante NFC.

En el ejemplo de WifiConfigurationViaUart se muestra cómo configurar las opciones de Wi-Fi del dispositivo con UART.