Solucionar problemas de rede

  • Artigo

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Problemas de rede podem ser notoriamente difíceis de diagnosticar e resolver. Por exemplo, você pode descobrir que sua rede Wi-Fi está funcionando bem localmente, mas está desconectada da Internet. Nesse caso, você pode descobrir que seu dispositivo do Azure Sphere não está atualizando corretamente. Este tópico fornece algumas sugestões que podem ajudar a diagnosticar problemas de rede.

Verificar o status do adaptador de rede

  1. Abra uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.

  2. Execute azsphere device network list-interfaces para listar os detalhes das interfaces de rede para o dispositivo anexado.

    A saída exibe todas as interfaces configuradas para o seu dispositivo. Para cada interface no dispositivo, a saída mostra o seguinte:

    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>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

  3. Verifique se as configurações a seguir para a interface são True.

  • Interface de rede para cima. Se essa configuração for False:

  • Conectado à rede. Se essa configuração for False:

    • Execute azsphere device wifi show-status para verificar se o valor do SSID do Wi-Fi corresponde às configurações de Wi-Fi do dispositivo.
    • Procure redes para verificar se o SSID nas configurações do dispositivo corresponde ao SSID em sua rede. Para obter mais informações, consulte o comando wifi scan .
    • Se o SSID da sua rede Wi-Fi estiver oculto e seu aplicativo depender de uma verificação direcionada, verifique se a verificação direcionada está ativada.

  • Endereço IP adquirido. Se essa configuração for False:

    • Aguarde até que uma conexão seja feita
    • Verifique sua rede para ver se o ponto de acesso e outros dispositivos na rede estão totalmente conectados. Para obter mais informações, consulte Networking_IsNetworkingReady Função.
    • Verifique o intervalo de endereços IP permitidos ou o limite de conexões permitidas em seu ponto de acesso e rede.

  • Conectado à internet. Se essa configuração for False:

    • Verifique se sua rede está conectada à Internet.

Verificar o status do Wi-Fi

  1. Abra uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux.
  2. Execute azsphere device wifi show-status para exibir informações sobre a conexão Wi-Fi atual no dispositivo.

Será exibida uma saída semelhante à seguinte:

 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>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------

Se o estado da conexão estiver definido como desconectado, ative o Wi-Fi no seu dispositivo.

Verificar status de rede

Execute azsphere device network show-status para exibir o status da rede do dispositivo anexado.

Será exibida uma saída semelhante à seguinte:

azsphere device network show-status
 --------------------------- --------------- --------
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 ====================================================
 True                        complete        disabled
 --------------------------- --------------- --------
  • Se a autenticação do dispositivo estiver pronta retornar False,
  • Se o status da sincronização de horário de rede retornar Incompleto,
    • Aguarde até que uma conexão seja feita
    • Certifique-se de que sua rede esteja configurada para permitir o tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.

Verifique as configurações do firewall

Se o aplicativo não conseguir se conectar a um host remoto:

  • Verifique as configurações de firewall do aplicativo. O manifesto do aplicativo deve especificar os nomes de host ou endereços IP aos quais o aplicativo tem permissão para se conectar, definindo a AllowedConnections funcionalidade.
  • Se o aplicativo tiver sido configurado para executar a descoberta de serviço, além das entradas no manifesto do aplicativo, os pontos de extremidade descobertos também deverão ser listados na configuração do firewall.

Se os hosts remotos não conseguirem se conectar ao seu aplicativo de servidor:

  • Verifique as configurações de firewall do aplicativo. O manifesto do aplicativo deve especificar as portas UDP e TCP para as quais o aplicativo está aberto para conexões de entrada, definindo os recursos e AllowedUdpServerPorts .AllowedTcpServerPorts

Se você ainda estiver tendo dificuldades:

Obter diagnóstico de rede

Quando ocorre uma falha de rede, você pode obter informações de diagnóstico sobre a falha de duas maneiras: por meio de uma chamada à API WifiConfig e na linha de comando.

Um aplicativo de alto nível pode chamar WifiConfig_GetNetworkDiagnostics para coletar informações sobre o problema. Essa função retorna uma estrutura WifiConfig_NetworkDiagnostics que contém detalhes sobre a falha mais recente na rede especificada. Combine as informações da estrutura de diagnóstico com as dicas a seguir para diagnosticar falhas de rede comuns e recuperar-se delas.

O exemplo WiFi_HighLevelApp mostra como usar o diagnóstico.

Você também pode usar o comando azsphere device network show-diagnostics para exibir informações de diagnóstico sobre o último erro.

Conexão de rede incorreta

Se o dispositivo estiver conectado à rede incorreta ou estiver conectado, mas com os atributos incorretos, verifique se a configuração de rede está correta. Se você tiver alterado a configuração, deverá recarregá-la. Em um aplicativo, chame WifiConfig_ReloadConfig ou, na linha de comando, use o comando azsphere device wifi reload-config para recarregar a configuração atual. Para verificar se a configuração de rede persiste entre reinicializações, um aplicativo pode chamar WifiConfig_PersistConfig.

Problemas ao atualizar um Certificado de Autoridade de Certificação raiz

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS após atualizar o Certificado de Autoridade de Certificação raiz, inicie com o status retornado pela função WifiConfig_SetNetworkEnabled.

Se o status indicar um erro de Certificado de Autoridade de Certificação raiz, uma das seguintes opções poderá ser a causa:

  • A CA1 raiz antiga expirou ou alterou o servidor RADIUS durante o processo de atualização? Em caso afirmativo, a nova CA2 raiz pode estar incorreta.
  • Alguma outra falha ocorreu no lado do servidor? Verifique com seu administrador da rede. O administrador pode ter usado uma autoridade de certificação diferente ou incorreta e pode precisar corrigir isso de maneira centralizada.

Se o status indicar um erro de certificado do cliente:

  • A configuração da nova Network2 estava fora de sincronia com as propriedades da Network1? Se as propriedades foram alteradas na Network 1, mas você tentou se conectar usando propriedades desatualizadas na Network2, talvez a Network2 falhe ao se conectar. Verifique se as propriedades de chave são idênticas para as duas redes.
  • O certificado do cliente foi alterado durante o processo de atualização da rede? Verifique os certificados associados à Rede1 e à Rede2 e verifique se eles são os mesmos. Um aplicativo pode usar funções na API CertStore para inspecionar detalhes do certificado.

Se a CA raiz e o certificado do cliente estiverem corretos, a falha pode estar relacionada ao seu ponto de acesso Wi-Fi ou a algum outro problema.

Continue verificando os dados retornados por WifiConfig_GetNetworkDiagnostics depois de cada tentativa com falha para saber mais sobre o problema.

Problemas ao atualizar um certificado do cliente

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS após atualizar o certificado do cliente, inicie com o status retornado pela função WifiConfig_SetNetworkEnabled.

Se o status indicar um erro de certificado do cliente:

  • Reverta para o certificado anterior e tente reconectar. Êxito indica um problema com o novo certificado do cliente; falha indica que o novo certificado é inválido ou que o certificado antigo expirou nesse meio tempo.

Se o status indicar algum outro tipo de erro:

  • A rede está apresentando outros problemas? Continue tentando se conectar com qualquer certificado do cliente.

Continue verificando os dados retornados por WifiConfig_GetNetworkDiagnostics depois de cada tentativa com falha para saber mais sobre o problema.

Problemas de conexão a uma rede de 5 GHz que não transmite um SSID

Há um problema conhecido no MT3620 em que os dispositivos podem não conseguir se conectar a redes de 5 GHz que não transmitem um SSID, apesar de usar a Verificação Direcionada. Recomendamos não desabilitar a transmissão SSID ou fazê-lo em uma rede somente de 2,4 GHz.