Azure Sphere를 Wi-Fi 연결
CLI 또는 Azure Sphere SDK 애플리케이션 라이브러리(Applibs)를 사용하여 Wi-Fi 통해 인터넷에 연결하도록 Azure Sphere 디바이스를 구성할 수 있습니다.
인증 방법
지원되는 인증 방법은 다음과 같습니다.
- WPA2
- EAP-TLS
- 열기(암호 없음)
Wi-Fi Azure Sphere 구성
명령줄(CLI)에서 또는 Azure Sphere SDK 애플리케이션 라이브러리(Applibs)를 사용하여 애플리케이션에서 Wi-Fi 네트워크에 연결하도록 Azure Sphere 디바이스를 구성할 수 있습니다.
CLI를 사용하여 구성 Wi-Fi
명령줄에서 Wi-Fi 구성을 관리하려면 az sphere device wifi CLI 명령을 사용합니다. 예를 들어 디바이스 wifi add 명령은 무선 네트워크의 세부 정보를 디바이스에 추가합니다.
az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
구성된 Wi-Fi 네트워크를 사용하려면 네트워크 인터페이스(wlan0)가 활성화되어 있어야 합니다. 디바이스 네트워크 목록 인터페이스 명령을 사용하여 인터페이스가 활성 상태인지 확인합니다.
az sphere device network list-interfaces
필요한 경우 디바이스 네트워크 사용 명령을 사용하여 활성화합니다.
az sphere device network enable --interface wlan0
구성된 Wi-Fi 네트워크를 사용하도록 설정하려면 디바이스 wifi enable 명령을 사용합니다.
az sphere device wifi enable --id <network id>
Azure Sphere 디바이스에서 Wi-Fi 설정 빠른 시작 항목에서는 명령줄에서 Azure Sphere 디바이스에서 Wi-Fi 구성하는 방법을 설명합니다.
또는 EAP-TLS 인증을 사용하는 경우 CLI에서 EAP-TLS 네트워크 설정을 참조하세요.
Applibs를 사용한 Wi-Fi 구성
Wi-Fi를 구성하려면 애플리케이션에서 applibs wificonfig API를 사용해야 합니다.
애플리케이션에 다음 헤더 파일을 포함합니다.
#include <applibs/wificonfig.h>
애플리케이션 매니페스트에는 WifiConfig 기능이 포함되어야 합니다.
"Capabilities": {
"WifiConfig" : true
}
네트워크 인터페이스가 활성 상태인지 확인하려면 Networking_GetInterfaceConnectionStatus 함수를 사용합니다.
Networking_GetInterfaceConnectionStatus("wlan0", ¤tInterfaceStatus);
네트워크 인터페이스를 활성화하려면 Networking_SetInterfaceState 함수를 사용합니다.
Networking_SetInterfaceState("wlan0", true);
참고
두 네트워크 인터페이스(wlan0 및 eth0)가 모두 활성 상태이고 연결된 경우 디바이스가 통신에 사용할 특정 인터페이스는 비결정적입니다. 지정된 시간에 사용되는 네트워크 인터페이스를 제어하려면 애플리케이션이 Networking_SetInterfaceState() 함수를 사용하여 원하는 인터페이스를 명시적으로 설정하고 다른 인터페이스를 해제해야 합니다. DHCP 클라이언트 상위 수준 앱 샘플에서는 두 인터페이스 중 하나를 나타내는 값을 전역 변수에 할당하여 인터페이스 간에 전환하는 방법을 보여 줍니다.
애플리케이션에서 구성된 Wi-Fi 네트워크를 사용하도록 설정하려면 WifiConfig_SetNetworkEnabled 함수를 사용합니다.
WifiConfig_SetNetworkEnabled(<network id>, true);
고객이 Azure Sphere를 통합하는 제품에 대한 Wi-Fi 구성할 수 있도록 Applibs wificonfig API를 사용하는 방법에 대한 제안은 필드에서 Wi-Fi 구성 을 참조하세요.
앱에서 EAP-TLS 네트워크 설정 항목에서는 상위 수준 Azure Sphere 애플리케이션에서 EAP-TLS 네트워크를 구성하는 방법을 설명합니다.
샘플
이 섹션에는 Azure Sphere 플랫폼에서 Wi-Fi 기능을 사용하는 방법을 보여 주는 샘플 애플리케이션에 대한 링크가 포함되어 있습니다.
WiFi_HighLevelApp 샘플은 상위 수준 애플리케이션에서 Wi-Fi 네트워크를 구성하는 방법을 보여 줍니다.
DHCP 클라이언트 상위 수준 앱은 네트워크의 DHCP 서버가 MT3620 디바이스에 할당한 현재 IP 주소를 갱신하거나 해제하는 방법을 보여 줍니다.
참고
다음 샘플은 Microsoft의 매핑되지 않은 소프트웨어 및 하드웨어 샘플 컬렉션인 Azure Sphere 갤러리에서 가져옵니다. 자세한 내용은 Azure Sphere 갤러리를 참조하세요.
WifiConfigurationViaAppResource 샘플은 포함된 JSON 리소스 파일을 사용하여 디바이스 Wi-Fi 설정을 구성하는 방법을 보여 줍니다.
WifiConfigurationViaNfc 샘플은 NFC를 사용하여 디바이스 Wi-Fi 설정을 구성하는 방법을 보여 줍니다.
WifiConfigurationViaUart 샘플은 UART를 사용하여 디바이스 Wi-Fi 설정을 구성하는 방법을 보여 줍니다.