Konfigurera Wi-Fi i fältet

Viktigt!

Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).

Azure Sphere-enheter förlitar sig på nätverksanslutning för att ta emot operativsystemet och programuppdateringarna över luften. Under utvecklingen är det enkelt att konfigurera Wi-Fi för en enhet som är ansluten till datorn. När du införlivar Azure Sphere i en tillverkad produkt måste dina kunder dock kunna konfigurera Wi-Fi på sin plats.

Du kan göra detta genom att tillhandahålla en fysisk kontrollpanel genom vilken kunden kan konfigurera sin egen Wi-Fi-anslutning, eller så kan du tillhandahålla en mobilapp för att ansluta till Azure Sphere-enheten och konfigurera Wi-Fi-anslutning via ytterligare ett Bluetooth Low Energy-chip (BLE). I båda fallen måste din Azure Sphere-app använda Azure Sphere Wi-Fi-konfigurations-API :et (wificonfig.h) för att hitta tillgängliga nätverk och sedan godkänna användarens val av nätverk och Wi-Fi-autentiseringsuppgifter.

BLE-baserad Wi-Fi-installation – referenslösning

Den BLE-baserade referenslösningen för Wi-Fi-installation och enhetskontroll visar hur du ansluter Azure Sphere via UART till ett nordiskt nRF52 BLE Development Kit. Den innehåller också en Windows-exempelapp som använder BLE för att visa och ändra Wi-Fi-inställningarna för Azure Sphere-enheten och kontrollera anslutna enhetsbeteenden.

Aktivera riktad genomsökning

Azure Sphere stöder riktad genomsökning, vilket gör att enheter kan ansluta till Wi-Fi-nätverk som inte sänder sitt SSID eller som finns i en fullsatt trådlös nätverksmiljö.

Viktigt!

Riktad genomsökning gör att enheten skickar avsökningsbegäranden som kan avslöja nätverkets SSID till andra enheter. Detta bör endast användas i kontrollerade miljöer eller i nätverk där detta är en acceptabel risk.

Du kan aktivera riktad genomsökning via CLI eller ett Applibs-API. Om du vill aktivera riktad genomsökning via CLI kör du kommandot azsphere device wifi add med parametern --targeted-scan . Ett program kan aktivera riktad genomsökning genom att anropa funktionen WifiConfig_SetTargetedScanEnabled med den aktiverade parametern inställd på true.

Inaktivera Wi-Fi

Programprogrammet kan aktivera eller inaktivera Wi-Fi-nätverksgränssnittet med hjälp av funktionen Networking_SetInterfaceState .

Om maskinvaran inte kräver Wi-Fi kan du undanta RF-klientdelskomponenter från maskinvarudesignen. Mer information finns i Inaktivera Wi-Fi RF-klientdelen på MT3620