Felsöka nätverksproblem
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).
Nätverksproblem kan vara notoriskt svåra att diagnostisera och lösa. Du kanske till exempel upptäcker att ditt Wi-Fi-nätverk fungerar bra lokalt, men att det är frånkopplat från Internet. I så fall kanske du upptäcker att Azure Sphere-enheten inte uppdateras korrekt. Det här avsnittet innehåller några förslag som kan hjälpa dig att diagnostisera nätverksproblem.
Kontrollera nätverksgränssnittets status
Öppna ett kommandoradsgränssnitt med hjälp av PowerShell, Windows-kommandotolken eller Linux-kommandogränssnittet.
Kör azsphere device network list-interfaces för att visa information om nätverksgränssnitten för den anslutna enheten.
Utdata visar alla gränssnitt som har konfigurerats för enheten. För varje gränssnitt på enheten visas följande utdata:
azsphere device network list-interfaces ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ ----------------- InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress ======================================================================================================================== azspheresvc True False False <value> False None None ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ ----------------- eth0 True True True <value> True dynamic <value> ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ ----------------- lo True False False <value> False None None ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ ----------------- wlan0 True True True <value> True dynamic <value> ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
Kontrollera att följande inställningar för gränssnittet är Sanna.
Nätverksgränssnittet är igång. Om den här inställningen är False:
- Kontrollera att de lokala enheter som använder åtkomstpunkten är anslutna. Mer information finns i Networking_IsNetworkingReady Funktion.
- Kontrollera att nätverksgränssnittet är aktiverat. Du kan aktivera det gränssnitt som krävs med hjälp av kommandot azsphere device network enable eller med hjälp av api:et Networking_SetInterfaceState function .
Ansluten till nätverket. Om den här inställningen är False:
- Kör azsphere device wifi show-status för att kontrollera att Wi-Fi SSID-värdet matchar enhetens Wi-Fi-inställningar.
- Sök efter nätverk för att kontrollera att SSID i enhetsinställningarna matchar SSID:t i nätverket. Mer information finns i wifi-genomsökningskommandot .
- Om SSID för ditt Wi-Fi-nätverk är dolt och programmet förlitar sig på en riktad genomsökning kontrollerar du att målgenomsökningen är aktiverad.
Anskaffad IP-adress. Om den här inställningen är False:
- Vänta tills en anslutning har upprättats
- Kontrollera nätverket för att se om åtkomstpunkten och andra enheter i nätverket är helt anslutna. Mer information finns i Networking_IsNetworkingReady Funktion.
- Kontrollera intervallet för tillåtna IP-adresser eller gränsen för tillåtna anslutningar på din åtkomstpunkt och ditt nätverk.
Ansluten till Internet. Om den här inställningen är False:
- Kontrollera att nätverket är anslutet till Internet.
Verifiera Wi-Fi-status
- Öppna ett kommandoradsgränssnitt med hjälp av PowerShell, Windows-kommandotolken eller Linux-kommandogränssnittet.
- Kör azsphere device wifi show-status för att visa information om den aktuella Wi-Fi-anslutningen på enheten.
Du bör se utdata som liknar följande:
azsphere device wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
Om anslutningstillståndet är inställt på frånkopplat aktiverar du Wi-Fi på enheten.
Verifiera nätverksstatus
Kör azsphere device network show-status för att visa nätverksstatusen för den anslutna enheten.
Du bör se utdata som liknar följande:
azsphere device network show-status
--------------------------- --------------- --------
DeviceAuthenticationIsReady NetworkTimeSync Proxy
====================================================
True complete disabled
--------------------------- --------------- --------
- Om Är enhetens autentisering klar returnerar False,
- Starta om enheten och försök med kommandot igen
- Kontrollera att nätverket är konfigurerat för att tillåta inkommande och utgående trafik. Mer information finns i Portar och protokoll.
- Om statusen för nätverkstidssynkronisering returnerar Ofullständig,
- Vänta tills en anslutning har upprättats
- Kontrollera att nätverket är konfigurerat för att tillåta inkommande och utgående trafik. Mer information finns i Portar och protokoll.
Verifiera brandväggsinställningarna
Om programmet inte kan ansluta till en fjärrvärd:
- Kontrollera programmets brandväggsinställningar.
Programmanifestet måste ange de värdnamn eller IP-adresser som programmet tillåts ansluta till genom att ange
AllowedConnections
funktionen. - Om programmet har konfigurerats för att utföra tjänstidentifiering, förutom posterna i programmanifestet, bör de identifierade slutpunkterna också visas i brandväggskonfigurationen.
Om fjärrvärdar inte kan ansluta till serverprogrammet:
- Kontrollera programmets brandväggsinställningar.
Programmanifestet måste ange de UDP- och TCP-portar som programmet är öppet för inkommande anslutningar till genom att ange
AllowedTcpServerPorts
funktionerna ochAllowedUdpServerPorts
.
Om du fortfarande har problem:
- Kör azsphere device network list-firewall-rules och kontrollera att IP-adressen i brandväggsreglerna och programmanifestfilen matchar.
- Kontrollera att systemets standardanslutningar finns som standard.
Hämta nätverksdiagnostik
När ett nätverksfel inträffar kan du få diagnostikinformation om felet på två sätt: via ett anrop till WifiConfig-API:et och från kommandoraden.
Ett högnivåprogram kan anropa WifiConfig_GetNetworkDiagnostics för att samla in information om problemet. Den här funktionen returnerar en WifiConfig_NetworkDiagnostics
struktur som innehåller information om det senaste felet i det angivna nätverket. Kombinera informationen från diagnostikstrukturen med de tips som följer för att diagnostisera och återställa från vanliga nätverksfel.
Exemplet WiFi_HighLevelApp visar hur du använder diagnostiken.
Du kan också använda kommandot azsphere device network show-diagnostics för att visa diagnostikinformation om det senaste felet.
Felaktig nätverksanslutning
Om enheten är ansluten till det felaktiga nätverket eller är ansluten men har fel attribut kontrollerar du att nätverkskonfigurationen är korrekt. Om du har ändrat konfigurationen måste du läsa in den igen. I ett program anropar du WifiConfig_ReloadConfig eller på kommandoraden och använder kommandot azsphere device wifi reload-config för att läsa in den aktuella konfigurationen igen. För att säkerställa att nätverkskonfigurationen bevaras mellan omstarter kan en app anropa WifiConfig_PersistConfig.
Problem med att uppdatera ett rotcertifikatutfärdarcertifikat
Om enheten inte kan ansluta till ett EAP-TLS-nätverk efter uppdatering av rotcertifikatutfärdarcertifikatet börjar du med statusen som returneras av funktionen WifiConfig_SetNetworkEnabled .
Om statusen anger ett rotcertifikatutfärdarcertifikat kan något av följande vara orsaken:
- Upphörde den gamla Rot-CA1 att gälla eller ändrades den på RADIUS-servern under uppdateringsprocessen? I så fall kan den nya rot-CA2 vara felaktig.
- Inträffade något annat fel på serversidan? Kontakta nätverksadministratören. Administratören kan ha använt en annan eller felaktig certifikatutfärdare och kan behöva åtgärda detta centralt.
Om statusen anger ett klientcertifikatfel:
- Var konfigurationen av nya Network2 osynkroniserad med Network1-egenskaper? Om egenskaperna ändrades i Nätverk 1 men du försökte ansluta med inaktuella egenskaper i Network2 kan Det hända att Network2 inte ansluter. Kontrollera att nyckelegenskaperna är identiska för de två nätverken.
- Ändrades klientcertifikatet under processen för nätverksuppdatering? Kontrollera de certifikat som är associerade med Network1 och Network2 och se till att de är desamma. En app kan använda funktioner i CertStore-API:et för att granska certifikatinformation.
Om både rotcertifikatutfärdare och klientcertifikat är korrekta kan felet vara relaterat till din Wi-Fi-åtkomstpunkt eller något annat problem.
Fortsätt att kontrollera de data som returneras av WifiConfig_GetNetworkDiagnostics efter varje misslyckat försök att lära dig mer om problemet.
Problem med att uppdatera ett klientcertifikat
Om enheten inte kan ansluta till ett EAP-TLS-nätverk efter uppdatering av klientcertifikatet börjar du med statusen som returneras av funktionen WifiConfig_SetNetworkEnabled .
Om statusen anger ett klientcertifikatfel:
- Återgå till föregående certifikat och försök att återansluta. Lyckad indikerar ett problem med det nya klientcertifikatet. felet anger att antingen det nya certifikatet är ogiltigt eller att det gamla certifikatet upphörde att gälla under tiden.
Om statusen anger någon annan typ av fel:
- Har nätverket andra problem? Fortsätt att försöka ansluta med något av klientcertifikaten.
Fortsätt att kontrollera de data som returneras av WifiConfig_GetNetworkDiagnostics efter varje misslyckat försök att lära dig mer om problemet.
Problem med att ansluta till ett 5GHz-nätverk som inte sänder ett SSID
Det finns ett känt problem på MT3620 där enheter kanske inte kan ansluta till 5GHz-nätverk som inte sänder något SSID, trots att de använder riktad genomsökning. Vi rekommenderar att du inte inaktiverar SSID-sändning eller gör det i ett 2,4 GHz-nätverk.