Partilhar via

Solucionar problemas de rede

  • Artigo

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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).

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

Verificar o estado da interface de rede

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

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

    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 seguintes configurações 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.
    • Analise redes para verificar se o SSID nas configurações do dispositivo corresponde ao SSID na rede. Para obter mais informações, consulte o comando wifi scan .
    • Se o SSID da sua rede Wi-Fi estiver oculto e a sua aplicação depender de uma análise direcionada, verifique se a análise direcionada está ativada.

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

    • Aguarde até que uma conexão seja feita
    • Verifique a sua rede para ver se o ponto de acesso e outros dispositivos na rede estão totalmente ligados. 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 a sua rede está ligada à Internet.

Verificar o estado do Wi-Fi

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

Deverá ver um resultado semelhante ao 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 ligação estiver definido como desligado, ative o Wi-Fi no dispositivo.

Verificar o estado da rede

Execute azsphere device network show-status para visualizar o status da rede do dispositivo conectado.

Deverá ver um resultado semelhante ao seguinte:

azsphere device network show-status
 --------------------------- --------------- --------
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 ====================================================
 True                        complete        disabled
 --------------------------- --------------- --------
  • Se Is device authentication ready retorna False,
    • Reinicie o dispositivo e tente o comando novamente
    • Certifique-se de que a sua rede está configurada para permitir tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.
  • Se o status de sincronização de tempo de rede retornar Incompleto,
    • Aguarde até que uma conexão seja feita
    • Certifique-se de que a sua rede está configurada para permitir tráfego de entrada e saída. Para obter mais informações, consulte Portas e protocolos.

Verifique as configurações do firewall

Se o seu 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 o AllowedConnections recurso.
  • 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 o AllowedTcpServerPorts, e AllowedUdpServerPorts os recursos.

Se continuar a ter dificuldades:

Obtenha diagnósticos de rede

Quando ocorre uma falha de rede, você pode obter informações de diagnóstico sobre a falha de duas maneiras: através de uma chamada para a API WifiConfig e da linha de comando.

Um aplicativo de alto nível pode chamar WifiConfig_GetNetworkDiagnostics para coletar informações sobre o problema. Esta função retorna uma WifiConfig_NetworkDiagnostics estrutura 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 e recuperar de falhas comuns de rede.

O exemplo de 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 errados, verifique se a configuração de rede está correta. Se você alterou 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 garantir que a configuração de rede persista nas reinicializações, um aplicativo pode chamar WifiConfig_PersistConfig.

Problemas ao atualizar um certificado de autoridade de certificação raiz

Se o dispositivo não puder se conectar a uma rede EAP-TLS depois de atualizar o certificado de autoridade de certificação raiz, comece 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 pode ser a causa:

  • O antigo Root CA1 expirou ou foi alterado no servidor RADIUS durante o processo de atualização? Em caso afirmativo, o novo CA2 raiz pode estar incorreto.
  • Ocorreu alguma outra falha no lado do servidor? Consulte o administrador da rede. O administrador pode ter usado uma autoridade de certificação diferente ou incorreta e talvez precise corrigir isso centralmente.

Se o status indicar um erro de certificado de cliente:

  • A configuração do novo Network2 estava fora de sincronia com as propriedades Network1? Se as propriedades foram alteradas na Rede 1, mas você tentou se conectar usando propriedades desatualizadas na Rede 2, a Rede 2 pode falhar ao se conectar. Certifique-se de que 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 à Network1 e Network2 e certifique-se de que são os mesmos. Um aplicativo pode usar funções na API CertStore para inspecionar detalhes do certificado.

Se a autoridade de certificação 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 a verificar os dados retornados por WifiConfig_GetNetworkDiagnostics após cada tentativa falhada para saber mais sobre o problema.

Problemas ao atualizar um certificado de cliente

Se o dispositivo não conseguir se conectar a uma rede EAP-TLS depois de atualizar o certificado do cliente, comece com o status retornado pela função WifiConfig_SetNetworkEnabled .

Se o status indicar um erro de certificado de cliente:

  • Reverta para o certificado anterior e tente se reconectar. Êxito indica um problema com o novo certificado de cliente; Falha indica que o novo certificado é inválido ou que o certificado antigo expirou nesse ínterim.

Se o status indicar algum outro tipo de erro:

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

Continue a verificar os dados retornados por WifiConfig_GetNetworkDiagnostics após cada tentativa falhada para saber mais sobre o problema.

Problemas de ligação a uma rede de 5GHz que não difunde um SSID

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