Solucionar problemas do Azure Sphere

De um terminal:

1. Execute sudo lsusb. Verifique se Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC aparece na saída.

Usando uma janela do PowerShell:

1. Executar Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId -match '^USB' }. Verifique se MSFT MT3620 Std Interface aparece na saída.

Se não conseguir desligar e voltar a ligar o dispositivo, a melhor opção seguinte é reiniciar o DCS. De um terminal:

1. Execute o sudo azspheredctl restart. Verifique se o comando foi concluído com êxito.
   1. Se o comando falhar, execute sudo systemctl restart azsphered.

Se não for possível desconectar e reconectar o dispositivo, a próxima melhor opção é emitir um comando de nova verificação para o DCS. Ao receber este comando, o DCS irá alternar e redefinir o chip de interface FTDI usado para se comunicar com o MT3620. Usando uma janela do PowerShell:

1. Execute o dispositivo azsphere rescan-attached

Agora execute novamente o comando que você tentou inicialmente. Se o problema ainda não estiver resolvido, a próxima melhor opção é tentar reiniciar o DCS. Em uma janela Powershell de nível de administrador:

1. Execute o Restart-Service -Name AzureSphereDeviceCommunicationService. Verifique se o comando foi concluído com êxito.

Como alternativa, reinicie o DCS usando uma interface gráfica do usuário.

1. Pressione Iniciar e digite Serviços. Clique com o botão direito do mouse no Serviço de Comunicação de Dispositivo do Azure Sphere e selecione Reiniciar.

Falha ao criar quatro conversores seriais USB

Depois de configurar uma placa de desenvolvimento MT3620, você deve ver quatro conversores seriais USB no Gerenciador de dispositivos. Se você vir menos de quatro, você pode ter um problema com o driver FTDI.

Se o driver FTDI não estiver instalado corretamente, os conversores podem aparecer no local errado, como Outros dispositivos, ou podem não aparecer de todo.

Para resolver esse problema:

1. Para abrir o Gestor de dispositivos, clique em Iniciar e introduza Gestor de dispositivos.

2. Em Controladores Universal Serial Bus, selecione USB Serial Converter A. Clique com o botão direito do mouse no nome, selecione Desinstalar dispositivo e exclua o driver se tiver a opção:

   

   Repita este passo para USB Serial Converter B através de USB Serial Converter D.

3. Desconecte a placa de desenvolvimento do PC e conecte-a novamente. "MSFT MT3620 Std Interface" deve aparecer com um ícone de aviso de triângulo, que indica que nenhum driver está disponível.

4. Clique com o botão direito do mouse em um dos dispositivos MSFT MT3620 Std Interface e selecione Atualizar driver. Escolha Pesquisar automaticamente software de driver atualizado. Atualizar um deve corrigi-los todos. Agora você deve ver quatro conversores seriais USB na seção Controladores Universal Serial Bus. Se todos os quatro conversores não aparecerem, repita esta etapa para cada conversor.

Falha na instalação de drivers FTDI

Os drivers FTDI devem ser baixados e instalados automaticamente pelo Windows quando o dispositivo Azure Sphere for conectado pela primeira vez ao seu PC. Se os drivers estiverem instalados corretamente, você verá quatro conversores seriais USB listados em Controladores de barramento serial universal no Gerenciador de dispositivos, conforme descrito em Configurar seu kit de desenvolvimento.

O Windows 10, versão 2004, não procura os drivers. Nesse caso, os drivers não são baixados e instalados automaticamente e você verá os seguintes itens listados no Gerenciador de dispositivos:

Para instalar os drivers, baixe manualmente os drivers da Future Technology Devices International (FTDI). Escolha o driver que corresponde à sua instalação do Windows (32 ou 64 bits).

Para obter datas de disponibilidade e números de compilação das versões do Windows 10, consulte Informações de lançamento do Windows 10. Estas informações podem ajudá-lo a determinar se a sua versão do Windows 10 é anterior ou posterior à versão 2004.

Problemas de conexão causados pela configuração do adaptador TAP-Windows

As ferramentas do Azure Sphere comunicam com placas de desenvolvimento anexadas utilizando uma rede IP através de USB. Isso requer o adaptador TAP-Windows da OpenVPN Technologies. O procedimento de instalação do SDK do Azure Sphere instala esse adaptador em seu PC se ele ainda não estiver presente.

Dois tipos distintos de problemas foram relatados com o adaptador TAP-Windows:

• Se uma versão diferente do adaptador TAP-Windows já estiver instalada ou se o dispositivo Azure Sphere não estiver conectado à primeira instância do adaptador TAP-Windows, as ferramentas do Azure Sphere podem falhar ao se conectar ao seu dispositivo.

• Se você estiver usando a rede virtual privada (VPN) Cisco AnyConnect, seu adaptador TAP-Windows pode aparecer desconectado e a comunicação do dispositivo pode não funcionar. Isso ocorre porque a VPN pode redirecionar o tráfego para longe do endereço IP do adaptador TAP.

Verifique se o dispositivo Azure Sphere está conectado ao adaptador TAP-Windows apropriado

Para determinar se o problema está relacionado com o adaptador TAP, primeiro descubra quantos adaptadores TAP estão instalados no seu PC e, em seguida, modifique a instalação, se necessário.

Para determinar quantos adaptadores TAP estão instalados no seu PC:

1. Abra Configurações do Windows e selecione o grupo Rede & Internet .

2. Em Configurações avançadas de rede, selecione Alterar opções do adaptador. Você deve ver apenas um adaptador TAP, conforme mostrado na captura de tela a seguir:

   

   Se vir mais do que um adaptador TAP ou se vir apenas um adaptador TAP, mas o seu nome não for Azure Sphere, siga estes passos para desinstalar todos os adaptadores TAP e reinstalar o SDK. Se não vir adaptadores TAP, reinstale o SDK.

Para desinstalar os adaptadores TAP:

1. Clique em Iniciar e digite Gerenciador de dispositivos.

2. No Gerenciador de dispositivos, abra Adaptadores de rede e selecione Adaptador TAP-Windows:

   

3. Clique com o botão direito do mouse no adaptador TAP-Windows e selecione Desinstalar dispositivo. Na caixa de diálogo, selecione Excluir o software do driver para este dispositivo e clique em Desinstalar.

4. Abra um prompt de comando como Administrador e execute o seguinte script do instalador do Powershell:

    powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
   

5. Se a instalação for bem-sucedida, reinicie o Serviço de Comunicação de Dispositivo do Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Reinstale o SDK do Azure Sphere.

Corrija o estado desconectado ao usar o cliente Cisco AnyConnect VPN

Quando você estiver usando o cliente Cisco AnyConnect VPN, o adaptador TAP-Windows pode aparecer desconectado e a comunicação do dispositivo pode não estar funcionando. Você pode corrigir o problema da seguinte maneira:

1. Certifique-se de que tem privilégios de administrador no seu computador.

2. Abra Configurações do Windows e selecione o grupo Rede & Internet .

3. Em Configurações avançadas de rede, selecione Alterar opções do adaptador.

4. Clique com o botão direito do mouse em Azure Sphere TAP-Windows Adapter V9 e selecione Propriedades.

5. Na guia Rede, localize a entrada Cisco AnyConnect Network Access Manager Filter Driver e limpe o item.

   

6. Selecione OK para salvar a configuração e sair das propriedades.

7. Verifique se a comunicação com seu dispositivo Azure Sphere agora está funcionando abrindo um prompt de comando e inserindo o azsphere device show-attached comando.

O dispositivo não responde

Um ou mais dos seguintes erros de um comando azsphere podem indicar que o Serviço de Comunicação de Dispositivo do Azure Sphere falhou ao iniciar:

• warn: Device is not responding. Could not perform version check.​
• Device is not responding. Cannot get device ID.​
• error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
• error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

Certifique-se de ter executado as etapas de solução de problemas de comunicação do dispositivo.

Se o problema ainda não tiver sido resolvido e a sua máquina tiver recebido recentemente uma atualização do Windows, o serviço de comunicação do dispositivo poderá falhar ao iniciar após a atualização do Windows e nos casos em que um dos ficheiros de definições JSON internos ou ficheiro de configuração tenha sido danificado.

Falha após o Windows Update

Estes erros podem ocorrer depois de atualizar o Windows no seu PC. Às vezes, o Windows Update desinstala os drivers FTDI necessários para o serviço de comunicação.

Para resolver o problema:

1. Desconecte o dispositivo Azure Sphere do USB e conecte-o novamente. Ao reconectar o dispositivo, os drivers corretos devem ser reinstalados.
2. Se desconectar e reconectar o dispositivo não conseguir corrigir o problema, desinstale e reinstale o SDK do Azure Sphere.

Ficheiro JSON

Se você não atualizou recentemente o Windows, a causa do erro pode ser o restore.json arquivo usado para o serviço.

Para resolver esse problema:

1. Salve uma cópia do seguinte arquivo:

   c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

2. Exclua o arquivo de seu local original.

3. Pare e reinicie o Serviço de Comunicação de Dispositivo do Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Arquivo de configuração corrompido

Se um erro for relatado quando você tentar executar um comando, o arquivo de configuração corrompido pode estar impedindo que seu dispositivo seja executado corretamente.

Para resolver esse problema, exclua o arquivo de configuração corrompido localizado em .azsphere\config no Windows ou ~/.azsphere/config no Linux.

O Windows falha ao conectar ou desconectar um dispositivo

A placa de desenvolvimento MT3620 tem um chip de FT4232HQ Future Technology Devices International (FTDI), que facilita a comunicação entre o dispositivo e o PC. O driver FTDI oficial, Combined Driver Model (CMD), contém dois drivers: um fornece acesso através da API D2XX e o outro fornece uma porta Virtual Com (VCP) para o mesmo dispositivo. Ambos os drivers são instalados por padrão se o chip FTDI tiver o modo VCP ativado. Isso pode fazer com que o Windows falhe quando o chip é desligado.

Para resolver esse problema, você pode desativar o modo VCP para o chip FTDI. Você precisará usar a ferramenta FT_PROG para reprogramar o EEPROM do chip FTDI.

1. Consulte FTDI FT_PROG ferramenta de programação para descobrir como baixar e instalar esta ferramenta.

2. Execute FT_PROG e localize seu dispositivo conectado, conforme descrito em FT_PROG aplicativo GUI.

3. Na visualização Árvore de dispositivos, expanda a seção Específico de hardware. Você deve ver quatro portas.

   

4. Selecione Porta A e escolha D2XX Direct em vez de Porta Com Virtual.

   

5. Repita a etapa anterior para a Porta C e a Porta D. A Porta B já deve estar no modo D2XX Direct.

6. Selecione o ícone Dispositivos de programa (semelhante a um raio) para entrar no modo de programação.

   

7. Selecione Programa para programar a EEPROM e aguarde até que ela termine.

   

8. Desligue o dispositivo da porta USB e, em seguida, volte a ligá-lo para ligar e desligar o dispositivo e fazer com que a alteração entre em vigor. No Gerenciador de dispositivos do Windows, a seção Portas (COM ou LPT) agora deve mostrar três portas COM a menos. O número de dispositivos Universal Serial Bus deve permanecer o mesmo.

Conexão perdida com dispositivos FTDI que não são do Azure Sphere após habilitar a depuração RTApp

Alguns usuários do Azure Sphere relataram que não podem mais se comunicar com outros dispositivos FTDI do Azure Sphere anexados depois de usarem o comando azsphere device enable-development --enable-rt-core-debugging para desenvolver e depurar RTApps de seu PC host.

Por exemplo, se você tiver um dispositivo Azure Sphere e um dispositivo FTDI diferente conectado ao seu PC, poderá ver dois controladores seriais universais chamados dispositivos USB Serial Converter B no Gerenciador de Dispositivos do Windows antes de executar o comando.

Depois de executar o comando, ambos os dispositivos USB Serial Converter B desaparecem da seção Universal Serial Bus controller e dois novos dispositivos aparecem na exibição de dispositivos Universal Serial Bus no Gerenciador de dispositivos.

Motivo

Esse problema ocorre porque o comando azsphere device enable-development --enable-rt-core-debugging instala um novo driver para a porta B do chip FTDI no MT3620, a porta então se torna MSFT MT3620 Std Interface. No entanto, a instalação desse driver inadvertidamente altera o driver para a Porta B do outro dispositivo não Azure Sphere. Devido a uma limitação na biblioteca subjacente, todos os dispositivos FTDI com o mesmo VID (0x0403) e PID (0x6011) terão seu driver de porta B substituído.

Solução

Siga estas etapas para reverter manualmente o driver de qualquer dispositivo que não seja do Azure Sphere para sua versão anterior:

1. No Gerenciador de Dispositivos, selecione o dispositivo que não seja do Azure Sphere (Outro FTDI Quad GZ no exemplo), clique com o botão direito do mouse e selecione Atualizar driver.

2. Em Atualizar drivers, selecione Procurar software de driver no meu computador.

   

3. Selecione Deixar-me escolher a partir de uma lista de controladores disponíveis no meu computador.

   

4. Selecione USB Serial Converter B driver na lista e, em seguida, clique em Avançar.

   

5. Clique em Fechar na janela de confirmação.

6. O Gerenciador de dispositivos deve mostrar a porta B para o outro dispositivo FTDI como USB Serial Converter B, o que indica que ele usa o driver FTDI oficial. O driver para o MT3620 permanece MSFT MT3620 Std Interface.

   

Informações adicionais

• Se você conectar outro novo dispositivo FTDI do Azure Sphere depois de executar o comando azsphere device enable-development --enable-rt-core-debugging , esse dispositivo receberá o driver do Azure Sphere MT3620 da mesma maneira. Repita as etapas acima para reverter o dispositivo para o driver FTDI oficial.

• Se você desconectar e reconectar um dispositivo FTDI que não seja do Azure Sphere depois de devolvê-lo ao driver FTDI oficial, o dispositivo manterá o driver FTDI oficial.

• Se você executar o comando azsphere device enable-development --enable-rt-core-debugging novamente depois de reverter o driver, o dispositivo FTDI do Sphere não Azure terá novamente seu driver substituído e você precisará seguir as etapas em Solução para reverter para o driver FTDI oficial. Isso ocorre independentemente de o dispositivo FTDI não Azure Sphere estar conectado ao PC quando o comando azsphere device enable-development --enable-rt-core-debugging é executado.

Comandos não reconhecidos

Se você vir o seguinte erro ao inserir um comando azsphere, verifique se está usando o PowerShell ou um prompt de comando padrão no Windows.

'azsphere' is not recognized as an internal or external command, operable program or batch file.

O instalador trava em 60%

O instalador trava em 60% e você é informado de que o Serviço de Comunicação de Dispositivo falhou ao iniciar. Isso normalmente ocorre quando a instalação do driver TAP falha de forma estranha, deixando o sistema em um estado indeterminado.

Confirme se o problema é o driver TAP

1. Abra o Visualizador de Eventos do Windows para verificar os logs.

2. Procure no log do aplicativo e no log do Azure Sphere Device Communication Service a seguinte mensagem de erro:

   "SerialSlipToTun.TunInterfaceSetupException: Error access tun registry settings ---> System.Collections.Generic.KeyNotFoundException: Tun tap device not found ---> System.Security.SecurityException: O acesso ao registro solicitado não é permitido."

   

3. Ao verificar o log do aplicativo, filtre o log para evitar ver as muitas mensagens não relacionadas. Na guia Ação, selecione Filtrar Log Atual.

4. Selecione Erro e, em seguida, selecione AzureSphereDeviceCommunicationService para listar apenas mensagens de erro do Serviço de Comunicação de Dispositivo do Azure Sphere.

   

5. Se você não conseguir encontrar o erro no log do Aplicativo ou no log do Serviço de Comunicação de Dispositivo do Azure Sphere, isso pode não ser um problema de driver TAP.

Para resolver o problema do driver TAP, execute estas etapas:

1. Vá para a Central de Rede e Compartilhamento e selecione Alterar configurações do adaptador.

   

2. Em Conexões de Rede em Azure Sphere, selecione TAP-WIndows Adapter V9 e abra suas propriedades.

   

3. Em Propriedades do Azure Sphere, selecione Protocolo IP Versão 4 (TCP/IPv4) e, em seguida, selecione Propriedades para exibir as configurações de protocolo.

   

4. Certifique-se de que o endereço IP está definido como 192.168.35.1 e a máscara de sub-rede está definida como 255.255.255.0.

5. Tente o instalador novamente. Se ele ainda travar, tente redefinir suas conexões de rede. Para fazer uma redefinição, vá para Configurações>de rede & Status da Internet>e selecione Redefinição de rede na parte inferior da página.

   Importante

   Redefinir a rede redefinirá todas as configurações de rede.

Pare o Serviço de Comunicação de Dispositivo do Azure Sphere

Se o instalador travar, você poderá parar o Serviço de Comunicação de Dispositivo do Azure Sphere usando o comando taskkill .

Siga estes passos:

1. Copie o PID para o AzureSphereDeviceCommunicationService.

   • Vá para a guia Serviços do Gerenciador>de Tarefas e anote o PID para o serviço AzureSphereDeviceCommunicationService ou
   • Na linha de comando, digite tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" e copie o PID da saída.

2. Digite o seguinte na linha de comando para encerrar o serviço. O comando taskkill termina o processo que corresponde ao número de ID do processo. A /f opção é usada para encerrar o processo à força.

   taskkill /PID <DCS_PID> /f

3. Tente o instalador novamente.

Não é possível parar o Serviço de Comunicação de Dispositivo do Azure Sphere

Ao atualizar um SDK do Azure Sphere existente, você pode ver uma mensagem dizendo "O serviço 'Azure Sphere Device Communication Service' (AzureSphereDeviceCommunicationService) não pôde ser interrompido. Verifique se você tem privilégios suficientes para interromper os serviços do sistema." Se você receber essa mensagem, reinicie e execute o instalador novamente.

A comunicação do dispositivo é interrompida quando o túnel dividido é usado

Quando um computador de desenvolvimento está conectado à VPN corporativa e o túnel dividido é desabilitado pela configuração VPN, o computador de desenvolvimento pode não ser capaz de se comunicar com o dispositivo Azure Sphere.

Para resolver este problema, realize um dos seguintes procedimentos:

• Desconecte-se da VPN corporativa e tente a conexão com o dispositivo Azure Sphere novamente.
• Altere a configuração da VPN para permitir o túnel dividido.

Problemas de comunicação também podem ser causados pela configuração do adaptador TAP-Windows. Consulte a seção Problemas de conexão causados pela solução de problemas de configuração do adaptador TAP-Windows.

Não é possível instalar ou desinstalar o SDK do Azure Sphere no Windows 11

Após a atualização para o Windows 11, os usuários não conseguem instalar ou desinstalar o SDK do Azure Sphere. Para resolver esse problema, instale a versão mais recente do SDK do Azure Sphere para Windows. Depois de instalar o 21.07 Update 2 ou posterior, você poderá desinstalar o SDK.

Não é possível compilar ou depurar RTApps

Se o CMake relatar erros ao localizar as cadeias de ferramentas ou openocd quando você tentar criar ou depurar um RTApp, certifique-se de que:

• Você instalou o GNU Arm Embedded Toolchain para o seu ambiente de desenvolvimento.
• Você especificou o caminho correto para openocd conforme descrito em Tutorial: Criar um aplicativo capaz de tempo real.

Solução de problemas de comunicação de dispositivos anteriores à 23.05

Em sistemas Linux que executam o SDK versão 22.11 ou anterior, o script azsphere_connect.sh precisa ser executado sempre que você conectar o dispositivo ou desconectá-lo ou reconectá-lo. O script atualiza as conexões do dispositivo e gera um driver do kernel que mapeia o tráfego de rede para o dispositivo.

Se você estiver encontrando problemas de comunicação, comece com estas etapas básicas:

1. Certifique-se de que o dispositivo está ligado por USB.

2. Execute o script azsphere_connect.sh , se ainda não o tiver feito.

3. Verifique se você pode se comunicar diretamente com o dispositivo. Navegue até em https://192.168.35.2/status um navegador da Web. Ignore e dispense todos os avisos SSL apresentados. Você deve ver uma saída semelhante a: {"uptime":56} na janela do navegador da Web.

1. Se o erro persistir, desconecte o dispositivo da porta USB, conecte-o novamente e aguarde até que ele reinicie. Em seguida, execute o script azsphere_connect.sh .

2. Se o erro persistir, verifique se não há conflitos de sub-rede com outras ferramentas de rede.