Connecter Azure Sphere au WiFi
Important
Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).
Vous pouvez configurer un appareil Azure Sphere pour vous connecter à Internet via le Wi-Fi à l’aide de l’interface CLI ou des bibliothèques d’applications du SDK Azure Sphere (applibs).
Méthodes d’authentification
Les méthodes d’authentification suivantes sont prises en charge :
- WPA2
- EAP-TLS
- open (aucun mot de passe)
Configurer Azure Sphere pour le Wi-Fi
Vous pouvez configurer votre appareil Azure Sphere pour vous connecter à un réseau Wi-Fi à partir de la ligne de commande (CLI) ou de votre application à l’aide des bibliothèques d’applications du SDK Azure Sphere (Applibs).
Configuration Wi-Fi à l’aide de l’interface CLI
Pour gérer la configuration Wi-Fi à partir de la ligne de commande, utilisez les commandes cli wifi de l’appareil azsphere. Par exemple, la commande d’ajout wifi de l’appareil ajoute les détails d’un réseau sans fil à l’appareil.
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
Pour utiliser le réseau Wi-Fi configuré, l’interface réseau (wlan0) doit être active. Utilisez la commande list-interfaces réseau de l’appareil pour déterminer si l’interface est active.
azsphere device network list-interfaces
Utilisez la commande d’activation du réseau d’appareils pour l’activer si nécessaire.
azsphere device network enable --interface wlan0
Pour activer le réseau Wi-Fi configuré, utilisez la commande d’activation wi-fi de l’appareil.
azsphere device wifi enable --id <network id>
La rubrique De démarrage rapide Configurer le Wi-Fi sur votre appareil Azure Sphere décrit comment configurer le Wi-Fi sur votre appareil Azure Sphere à partir de la ligne de commande.
Sinon, si vous utilisez l’authentification EAP-TLS, consultez Configurer le réseau EAP-TLS à partir de l’interface CLI.
Configuration Wi-Fi à l’aide des bibliothèques d’applications
Pour configurer le Wi-Fi, votre application doit utiliser l’API wificonfig des applibs.
Incluez ce fichier d’en-tête dans votre application :
#include <applibs/wificonfig.h>
Le manifeste de l’application doit inclure la fonctionnalité WifiConfig .
"Capabilities": {
"WifiConfig" : true
}
Pour déterminer si l’interface réseau est active, utilisez la fonction Networking_GetInterfaceConnectionStatus .
Networking_GetInterfaceConnectionStatus("wlan0", ¤tInterfaceStatus);
Pour activer l’interface réseau, utilisez la fonction Networking_SetInterfaceState .
Networking_SetInterfaceState("wlan0", true);
Remarque
Si les deux interfaces réseau (wlan0 et eth0) sont actives et connectées, l’interface spécifique utilisée par l’appareil pour la communication n’est pas déterministe. Si vous souhaitez contrôler l’interface réseau utilisée à un moment donné, votre application doit utiliser la fonction Networking_SetInterfaceState() pour activer explicitement l’interface souhaitée et l’autre interface. L’exemple d’application de haut niveau du client DHCP montre entre autres comment basculer entre les interfaces en affectant une valeur représentant l’une des deux interfaces à une variable globale.
Pour activer un réseau Wi-Fi configuré à partir de votre application, utilisez la fonction WifiConfig_SetNetworkEnabled .
WifiConfig_SetNetworkEnabled(<network id>, true);
Consultez Configurer le Wi-Fi dans le champ pour obtenir des suggestions d’utilisation de l’API Wificonfig Applibs pour permettre à vos clients de configurer le Wi-Fi pour vos produits qui incorporent Azure Sphere.
La rubrique Configurer le réseau EAP-TLS dans une application décrit comment configurer un réseau EAP-TLS dans une application Azure Sphere de haut niveau.
Exemples
Cette section contient des liens vers des exemples d’applications qui illustrent l’utilisation de fonctionnalités Wi-Fi sur la plateforme Azure Sphere.
L’exemple WiFi_HighLevelApp illustre la configuration des réseaux Wi-Fi dans une application de haut niveau.
L’application de haut niveau du client DHCP montre comment renouveler ou libérer l’adresse IP actuelle affectée par le serveur DHCP du réseau à l’appareil MT3620.
Remarque
Les exemples suivants proviennent de la galerie Azure Sphere, qui est une collection d’exemples logiciels et matériels non maintenus de Microsoft. Pour plus d’informations, consultez la galerie Azure Sphere.
L’exemple WifiConfigurationViaAppResource montre comment configurer les paramètres Wi-Fi de l’appareil à l’aide d’un fichier de ressources JSON incorporé.
L’exemple WifiConfigurationViaNfc montre comment configurer les paramètres Wi-Fi de l’appareil à l’aide de NFC.
L’exemple WifiConfigurationViaUart montre comment configurer les paramètres Wi-Fi de l’appareil à l’aide d’UART.