Conexión de Azure Sphere a una red Wi-Fi

Importante

Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).

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

Métodos de autenticación

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

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

Configuración de Azure Sphere para Wi-Fi

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

Configuración de Wi-Fi mediante la CLI

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

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

Para usar la red Wi-Fi configurada, la interfaz de red (wlan0) debe estar activa. Use el comando list-interfaces de red del dispositivo para determinar si la interfaz está activa.

azsphere device network list-interfaces

Use el comando device network enable para activarlo si es necesario.

azsphere device network enable --interface wlan0

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

azsphere device wifi enable --id <network id>

En el tema Inicio rápido Configuración de Wi-Fi en el dispositivo de Azure Sphere se describe cómo configurar Wi-Fi en el dispositivo de Azure Sphere desde la línea de comandos.

Como alternativa, si usa la autenticación EAP-TLS, consulte Configuración de la red EAP-TLS desde la CLI.

Configuración de Wi-Fi mediante bibliotecas de aplicaciones

Para configurar Wi-Fi, la aplicación debe usar la API wificonfig de bibliotecas de aplicaciones.

Incluya este archivo de encabezado en la aplicación:

#include <applibs/wificonfig.h>

El manifiesto de 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) están 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 usa en un momento dado, la aplicación debe usar la función Networking_SetInterfaceState() para activar explícitamente la interfaz deseada y la otra interfaz desactivada. El ejemplo de aplicación de alto nivel de cliente DHCP muestra entre otras cosas cómo cambiar entre interfaces mediante la asignación de 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);

Consulte Configuración de Wi-Fi en el campo para obtener sugerencias sobre el uso de la API wificonfig de applibs para permitir que los clientes configuren Wi-Fi para los productos que incorporan Azure Sphere.

En el tema Configuración de la red EAP-TLS en una aplicación se describe cómo configurar una red EAP-TLS en una aplicación de Azure Sphere de alto nivel.

Ejemplos

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

En el ejemplo WiFi_HighLevelApp se muestra cómo configurar redes Wi-Fi en una aplicación de alto nivel.

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

Nota:

Los ejemplos siguientes proceden de la Galería de Azure Sphere, que es una colección de ejemplos de hardware y software no retenidos de Microsoft. Para más información, consulte Galería de Azure Sphere.

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

El ejemplo WifiConfigurationViaNfc muestra cómo configurar la configuración wi-fi del dispositivo mediante NFC.

El ejemplo WifiConfigurationViaUart muestra cómo configurar la configuración de Wi-Fi del dispositivo mediante UART.