Condividi tramite

Risolvere i problemi di rete

  • Articolo

I problemi di rete possono essere notoriamente difficili da diagnosticare e risolvere. Ad esempio, potresti scoprire che la rete Wi-Fi funziona correttamente localmente, ma è disconnessa da Internet. In questo caso, è possibile che il dispositivo Azure Sphere non venga aggiornato correttamente. In questo argomento vengono forniti alcuni suggerimenti che possono aiutare a diagnosticare i problemi di rete.

Controllare lo stato dell'interfaccia di rete

  1. Aprire un'interfaccia della riga di comando usando PowerShell, il prompt dei comandi di Windows o la shell dei comandi linux.

  2. Eseguire az sphere device network list-interfaces per elencare i dettagli delle interfacce di rete per il dispositivo collegato.

    L'output visualizza tutte le interfacce configurate per il dispositivo. Per ogni interfaccia nel dispositivo, l'output mostra quanto segue:

    [
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "azspheresvc",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "192.168.35.2"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "b2:30:bb:f0:d1:44",
    "interfaceName": "eth0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": null,
    "interfaceName": "lo",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": [
      "127.0.0.1"
    ],
    "ipAssignment": null
  },
  {
    "connectedToInternet": false,
    "connectedToNetwork": false,
    "hardwareAddress": "00:02:b5:03:69:ea",
    "interfaceName": "wlan0",
    "interfaceUp": true,
    "ipAcquired": false,
    "ipAddresses": null,
    "ipAssignment": "dynamic"
  }
]

  3. Verificare che le impostazioni seguenti per l'interfaccia siano True.

  • Interfaccia di rete. Se questa impostazione è False:

  • Connesso alla rete. Se questa impostazione è False:

    • Eseguire az sphere device wifi show-status per verificare che il valore SSID Wi-Fi corrisponda alle impostazioni wi-fi del dispositivo.
    • Cercare le reti per verificare che il SSID nelle impostazioni del dispositivo corrisponda al SSID nella rete. Per altre informazioni, vedere il comando wifi scan .
    • Se il SSID per la rete Wi-Fi è nascosto e l'applicazione si basa su un'analisi mirata, verificare che l'analisi mirata sia abilitata.

  • Indirizzo IP acquisito. Se questa impostazione è False:

    • Attendere che venga stabilita una connessione.
    • Controllare la rete per verificare se il punto di accesso e altri dispositivi nella rete sono completamente connessi. Per altre informazioni, vedere Networking_IsNetworkingReady Funzione.
    • Controllare l'intervallo di indirizzi IP consentiti o il limite di connessioni consentite nel punto di accesso e nella rete.

  • Connesso a Internet. Se questa impostazione è False:

    • Verificare che la rete sia connessa a Internet.

Verificare lo stato wi-fi

  1. Aprire un'interfaccia della riga di comando usando PowerShell, il prompt dei comandi di Windows o la shell dei comandi linux.
  2. Eseguire az sphere device wifi show-status per visualizzare informazioni sulla connessione Wi-Fi corrente nel dispositivo.

L'output dovrebbe essere simile al seguente:

 az sphere device wifi show-status
{
  "SSID": "MSFTGUEST",
  "configurationState": "enabled",
  "connectionState": "connected",
  "frequency": 5660,
  "ipAddress": "10.106.106.40",
  "keyManagement": "NONE",
  "macAddress": "00:02:b5:03:69:ea",
  "mode": "station",
  "securityState": "open",
  "wpaState": "COMPLETED"
}

Se lo stato Connessione è impostato su disconnesso, abilitare Wi-Fi nel dispositivo.

Verificare lo stato della rete

Eseguire az sphere device network show-status per visualizzare lo stato della rete per il dispositivo collegato.

L'output dovrebbe essere simile al seguente:

az sphere device network show-status
{
  "deviceAuthenticationIsReady": false,
  "networkTimeSync": "incomplete",
  "proxy": "disabled"
}
  • Se l'autenticazione del dispositivo è pronta restituisce False,
  • Se lo stato di sincronizzazione dell'ora di rete restituisce Incomplete,
    • Attendere che venga stabilita una connessione.
    • Assicurarsi che la rete sia configurata per consentire il traffico in ingresso e in uscita. Per altre informazioni, vedere Porte e protocolli.

Verificare le impostazioni del firewall

Se l'applicazione non riesce a connettersi a un host remoto:

  • Controllare le impostazioni del firewall dell'applicazione. Il manifesto dell'applicazione deve specificare i nomi host o gli indirizzi IP a cui l'applicazione può connettersi, impostando la AllowedConnections funzionalità.
  • Se l'applicazione è stata configurata per eseguire l'individuazione dei servizi, oltre alle voci nel manifesto dell'applicazione, gli endpoint individuati devono essere elencati anche nella configurazione del firewall.

Se gli host remoti non sono in grado di connettersi all'applicazione server:

Se si verificano ancora difficoltà:

Ottenere la diagnostica di rete

Quando si verifica un errore di rete, è possibile ottenere informazioni di diagnostica sull'errore in due modi: tramite una chiamata all'API WifiConfig e dalla riga di comando.

Un'applicazione di alto livello può chiamare WifiConfig_GetNetworkDiagnostics per raccogliere informazioni sul problema. Questa funzione restituisce una struttura di diagnostica WifiConfig_NetworkDiagnostics contenente i dettagli sull'errore più recente nella rete specificata. Combinare le informazioni dalla struttura di diagnostica con i suggerimenti seguenti per la diagnosi e il ripristino degli errori di rete comuni.

L'esempio WiFi_HighLevelApp illustra come usare la diagnostica.

È anche possibile usare il comando az sphere device network show-diagnostics per visualizzare informazioni di diagnostica sull'ultimo errore.

Connessione di rete non corretta

Se il dispositivo è connesso alla rete non corretta o è connesso con gli attributi errati, assicurarsi che la configurazione di rete sia corretta. Se è stata modificata la configurazione, è necessario ricaricarla. In un'applicazione chiamare WifiConfig_ReloadConfig o nella riga di comando, usare il comando az sphere device wifi reload-config per ricaricare la configurazione corrente. Per assicurarsi che la configurazione di rete venga mantenuta nonostante i riavvii, un'app può chiamare WifiConfig_PersistConfig.

Problemi di aggiornamento di un certificato CA radice

Se il dispositivo non riesce a connettersi a una rete EAP-TLS dopo l'aggiornamento del certificato CA radice, iniziare con lo stato restituito dalla funzione WifiConfig_SetNetworkEnabled.

Se lo stato indica un errore del certificatoCA radice, esaminare le possibili cause tra quelle indicate di seguito:

  • Il certificato CA1 radice precedente è scaduto o è stato modificato nel server RADIUS durante il processo di aggiornamento? In tal caso, il nuovo certificato CA2 radice potrebbe non essere corretto.
  • Si sono verificati altri errori sul lato server? Rivolgersi all'amministratore di rete. L'amministratore potrebbe avere usato un'autorità di certificazione diversa o non corretta e potrebbe essere necessario risolvere il problema a livello centralizzato.

Se lo stato indica un errore del certificato client:

  • La configurazione della nuova rete Network2 non è sincronizzata con le proprietà della rete Network1? Se le proprietà della rete Network1 sono state modificate ma si è tentato di connettersi usando proprietà non aggiornate nella rete Network2, la connessione di quest'ultima potrebbe non riuscire. Verificare che le proprietà chiave siano identiche per le due reti.
  • Il certificato client è stato modificato durante il processo di aggiornamento della rete? Controllare i certificati associati alle reti Network1 e Network2 e verificare che corrispondano. Un'app può usare funzioni nell'API CertStore per esaminare i dettagli del certificato.

Se sia la CA radice che il certificato client sono corretti, l'errore potrebbe essere correlato al punto di accesso Wi-Fi o ad altri problemi.

Continuare a controllare i dati restituiti da WifiConfig_GetNetworkDiagnostics dopo ogni tentativo non riuscito per ottenere ulteriori informazioni sul problema.

Problemi di aggiornamento di un certificato client

Se il dispositivo non riesce a connettersi a una rete EAP-TLS dopo l'aggiornamento del certificato client, iniziare con lo stato restituito dalla funzione WifiConfig_SetNetworkEnabled.

Se lo stato indica un errore del certificato client:

  • Ripristinare il certificato precedente e provare a riconnettersi. Un esito positivo indica un problema con il nuovo certificato client. Un errore indica che il nuovo certificato non è valido o che il certificato precedente è scaduto nel frattempo.

Se lo stato indica un altro tipo di errore:

  • Sono stati riscontrati altri problemi nella rete? Continuare a tentare di connettersi con uno dei due certificati client.

Continuare a controllare i dati restituiti da WifiConfig_GetNetworkDiagnostics dopo ogni tentativo non riuscito per ottenere ulteriori informazioni sul problema.

Problemi di connessione a una rete a 5GHz che non trasmette un SSID

C'è un problema noto in MT3620 in cui i dispositivi potrebbero non essere in grado di connettersi a reti a 5GHz che non trasmettono un SSID, nonostante l'uso di Analisi mirata. È consigliabile non disabilitare la trasmissione SSID o farlo in una rete di sola 2,4 GHz.