Resolver problemas do Azure Sphere

Eis alguns passos de resolução de problemas que podem ocorrer durante a instalação e configuração.

Problemas de comunicação do dispositivo

Uma falha na ligação ao dispositivo a partir de um computador anfitrião pode ocorrer por vários motivos e pode acionar qualquer uma das várias mensagens de erro, consoante as ferramentas ou aplicações que o encontrarem. As seguintes mensagens de erro podem indicar uma ligação falhada:

• An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
• Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
• An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
• Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
• Failed to establish communication with device after recovery.

Existem três componentes que podem causar problemas de comunicação do dispositivo: (1) a própria interface de linha de comandos; (2) o serviço de comunicação de dispositivos (DCS) que facilita a comunicação com um dispositivo; e (3) o dispositivo.

Para isolar a causa, execute os seguintes passos de diagnóstico:

1. Verifique se consegue comunicar diretamente com o dispositivo. Navegue para https://192.168.35.2/status num browser. Ignore e dispense quaisquer avisos SSL apresentados. Deverá ver um resultado semelhante a: {"uptime":56} na janela do browser.

Nota

Também pode efetuar este passo a partir da linha de comandos com curl https://192.168.35.2/status --insecure.

Nota

Também pode efetuar este passo a partir do PowerShell (v6 ou superior). Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck

2. Confirme que o serviço de comunicação do dispositivo detetou um dispositivo. Navegue para http://localhost:48938/api/service/devices num browser e confirme que pelo menos um dispositivo é apresentado na saída JSON.

Aviso

O DCS do Linux só está incluído na versão 23.05 e superior do SDK. Siga os passos de resolução de problemas legados para as versões 22.11 e anteriores do SDK.

Nota

Também pode efetuar este passo a partir do PowerShell através de Invoke-WebRequest http://localhost:48938/api/service/devices.

Não foi possível comunicar diretamente com o dispositivo e o dispositivo não foi detetado pelo DCS

Se não for possível estabelecer uma ligação com o dispositivo (Passo 1) e o dispositivo não puder ser detetado pelo DCS (Passo 2), é provável que haja um problema com a configuração do dispositivo físico.

Em primeiro lugar, verifique se o dispositivo foi detetado pelo computador.

A partir de um terminal:

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

Utilizar uma janela do PowerShell:

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

Se o comando anterior não devolver a saída esperada, ligue o dispositivo a uma porta USB diferente. Se isto ainda não resolver o problema, verifique se o dispositivo tem os respetivos jumpers configurados corretamente. Por exemplo, os Kits de Desenvolvimento MT3620 São enviados da fábrica com um cabeçalho jumper entre os pinos 2 e 3 de J3, que alimenta o relógio da fonte de alimentação principal. Verifique se o cabeçalho não foi desalojado ou removido.

Não foi possível comunicar diretamente com o dispositivo, mas o dispositivo é detetado pelo DCS

Se não for possível estabelecer uma ligação com o dispositivo (Passo 1), mas o dispositivo tiver sido detetado pelo DCS (Passo 2), é provável que o serviço de comunicação do dispositivo ou do dispositivo esteja num estado incorreto.

Se acabou de ligar um dispositivo à Internet e o sistema operativo do dispositivo estiver desatualizado, o dispositivo poderá estar a aplicar uma atualização do SO. Existe também uma pequena probabilidade de o dispositivo estar a efetuar uma atualização do SO se a hora coincidir com uma janela de lançamento. Durante uma atualização do sistema operativo, não poderá comunicar com um dispositivo.

Se suspeitar que o dispositivo está atualizado e/ou não está ligado à Internet, a melhor opção seguinte é desligar e voltar a ligar o dispositivo ao PC. Isto deve fazer com que o DCS renove a ligação ao dispositivo e ao dispositivo para repor para um estado inicial.

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

1. Execute 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 conseguir desligar e voltar a ligar o dispositivo, a melhor opção seguinte é emitir um comando de reanálise para o DCS. Após receber este comando, o DCS irá circular e repor o chip de interface FTDI utilizado para comunicar com o MT3620. Utilizar uma janela do PowerShell:

1. Executar o comando az sphere device rescan-attached

Agora, execute novamente o comando que tentou inicialmente. Se o problema ainda não estiver resolvido, a melhor opção seguinte é tentar reiniciar o DCS. A partir de uma janela do Powershell ao nível do administrador:

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

Em alternativa, reinicie o DCS com uma interface de utilizador gráfica.

1. Prima Iniciar e introduza Serviços. Clique com o botão direito do rato no Serviço de Comunicação de Dispositivos do Azure Sphere e selecione Reiniciar.

Agora, execute novamente o comando que tentou inicialmente.

Se o comando continuar a falhar ou az sphere device list-attached tiver um resultado semelhante a:

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

Executar az sphere device recover

Pode comunicar diretamente com o dispositivo e o dispositivo é detetado pelo DCS

Isto provavelmente indica um problema com a CLI. Certifique-se de que tem a versão mais recente do SDK.

Se tiver a versão mais recente do SDK e o problema ainda não estiver resolvido, publique uma pergunta no fórum Q&A.

Ligações perdidas ou dispositivos em falta

Se o computador conseguir ligar-se ao dispositivo do Azure Sphere, mas muitas vezes deixar cair a ligação, poderá ter um conflito na sub-rede IP.

O Azure Sphere utiliza a sub-rede 192.168.35.*. Se tiver outro software que utilize a mesma sub-rede, desative esse software ou limite o intervalo de endereços IP que utiliza. Atualmente, não pode alterar o intervalo de endereços IP que o Azure Sphere utiliza.

Não é possível aplicar as capacidades do dispositivo

Se receber erros ao tentar aplicar uma capacidade de dispositivo a um dispositivo do Azure Sphere, o problema poderá ser que o SO no seu dispositivo esteja desatualizado. Este problema pode ocorrer se o dispositivo estiver offline durante um período prolongado, durante o qual a Microsoft atualizou as chaves internas. Os seguintes erros são sintomas deste problema:

Os comandos az sphere device enable-development ou az sphere device enable-cloud-test devolvem um erro semelhante ao seguinte:

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'az sphere device show-deployment-status'.

O comando az sphere device capability update devolve um erro semelhante ao seguinte:

error: Could not apply device capability configuration to device.

Tal deve-se ao facto de o keystore fidedigno no dispositivo estar desatualizado. Para resolver este problema, siga as instruções aqui.

Falha ao criar quatro conversores de série USB

Depois de configurar uma placa de desenvolvimento MT3620, deverá ver quatro conversores de série USB no Gestor de Dispositivos. Se vir menos de quatro, poderá ter um problema com o controlador FTDI.

Nota

Se este quadro tiver sido utilizado anteriormente para desenvolvimento rtApp, poderá ver três conversores em vez de quatro. Isto é normal e não representa um erro.

Se o controlador FTDI não estiver corretamente instalado, os conversores poderão aparecer na localização errada, como Outros dispositivos, ou podem não aparecer de todo.

Para resolver este problema:

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

2. Em Controladores do Universal Serial Bus, selecione Conversor de Série USB A. Clique com o botão direito do rato no nome, selecione Desinstalar Dispositivo e elimine o controlador se lhe for dada a opção:

   

   Repita este passo para o Conversor de Série USB B através do Conversor de Série USB D.

3. Desligue a placa de desenvolvimento do PC e volte a ligá-la. "MsFT MT3620 Std Interface" deve aparecer com um ícone de aviso de triângulo, que indica que não existe nenhum controlador disponível.

4. Clique com o botão direito do rato num dos dispositivos MSFT MT3620 Std Interface e selecione Atualizar controlador. Escolha Pesquisa automaticamente para software de controlador atualizado. Atualizar um deve corrigi-los a todos. Deverá ver agora quatro conversores de série USB na secção Controladores do Universal Serial Bus. Se os quatro conversores não aparecerem, repita este passo para cada conversor.

Falha ao instalar controladores FTDI

Os controladores FTDI devem ser transferidos e instalados automaticamente pelo Windows quando o dispositivo do Azure Sphere estiver ligado pela primeira vez ao PC. Se os controladores estiverem corretamente instalados, verá quatro Conversores de Série USB listados em Controladores do Universal Serial Bus no Gestor de Dispositivos, conforme descrito em Configurar o seu kit de desenvolvimento.

Windows 10, versão 2004, não procura os controladores. Neste caso, os controladores não são transferidos e instalados automaticamente e verá os seguintes itens listados no Gestor de Dispositivos:

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

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

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

As ferramentas do Azure Sphere comunicam com placas de desenvolvimento anexadas através de uma rede IP por USB. Isto requer o adaptador TAP-Windows da OpenVPN Technologies. O procedimento de instalação do SDK do Azure Sphere instala este adaptador no PC, se ainda não estiver presente.

Foram reportados dois tipos distintos de problemas com o adaptador TAP-Windows:

• Se uma versão diferente do adaptador de TAP-Windows já estiver instalada ou se o dispositivo do Azure Sphere não estiver ligado à primeira instância do adaptador TAP-Windows, as ferramentas do Azure Sphere poderão não conseguir ligar-se ao seu dispositivo.

• Se estiver a utilizar a rede privada virtual (VPN) Cisco AnyConnect, o adaptador de TAP-Windows poderá aparecer desconectado e a comunicação do dispositivo poderá não funcionar. Isto acontece porque a VPN pode redirecionar o tráfego para fora do endereço IP do adaptador TAP.

Confirme que o dispositivo do Azure Sphere está ligado ao adaptador de TAP-Windows adequado

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

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

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

2. Em Definições de rede avançadas, selecione Alterar opções do adaptador. Deverá ver apenas um adaptador TAP, conforme mostrado na seguinte captura de ecrã:

   

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

Para desinstalar os adaptadores TAP:

1. Clique em Iniciar e introduza Gestor de Dispositivos.

2. No Gestor de Dispositivos, abra Placas de Rede e selecione Adaptador TAP-Windows:

   

3. Clique com o botão direito do rato no adaptador TAP-Windows e selecione Desinstalar Dispositivo. Na caixa de diálogo, selecione Eliminar o software do controlador deste dispositivo e, em seguida, clique em Desinstalar.

4. Abra uma linha de comandos 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 Dispositivos do Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Reinstale o SDK do Azure Sphere.

Corrigir o estado desconectado ao utilizar o cliente VPN Cisco AnyConnect

Quando estiver a utilizar o cliente VPN Cisco AnyConnect, o adaptador de TAP-Windows poderá aparecer desconectado e a comunicação do dispositivo poderá não estar a funcionar. Pode corrigir o problema da seguinte forma:

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

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

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

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

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

   

6. Selecione OK para guardar a definição e sair das propriedades.

7. Verifique se a comunicação com o seu dispositivo do Azure Sphere está agora a funcionar ao abrir uma linha de comandos e ao introduzir o az sphere 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 Dispositivos do Azure Sphere não conseguiu 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 que executou os passos de resolução de problemas de comunicação do dispositivo.

Se o problema ainda não estiver resolvido e o seu computador tiver efetuado recentemente uma atualização do Windows, o serviço de comunicação do dispositivo poderá não conseguir iniciar após a atualização do Windows e nos casos em que um dos ficheiros de definições de JSON internos ou ficheiro de configuração ficou danificado.

Falha após Windows Update

Estes erros podem ocorrer depois de atualizar o Windows no pc. Por vezes, Windows Update desinstala os controladores FTDI necessários para o serviço de comunicação.

Para resolver o problema:

1. Desligue o dispositivo do Azure Sphere a partir de USB e ligue-o novamente. Após a reativação do dispositivo, os controladores corretos devem ser reinstalados.
2. Se desligar e voltar a ligar o dispositivo não conseguir corrigir o problema, desinstale e reinstale o SDK do Azure Sphere.

Ficheiro JSON

Se não tiver atualizado recentemente o Windows, a causa do erro poderá ser o restore.json ficheiro utilizado para o serviço.

Para resolver este problema:

1. Guarde uma cópia do seguinte ficheiro:

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

2. Elimine o ficheiro da localização original.

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

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Ficheiro de configuração danificado

Se for comunicado um erro ao tentar executar um comando, o ficheiro de configuração danificado poderá estar a impedir que o dispositivo seja executado corretamente.

Para resolver este problema, elimine o ficheiro de configuração danificado localizado em .azsphere\config no Windows ou ~/.azsphere/config no Linux.

O Windows falha ao ligar ou desligar um dispositivo

O conselho de programador mt3620 tem um chip de FT4232HQ Future Technology Devices International (FTDI), que facilita a comunicação entre o dispositivo e o PC. O controlador FTDI oficial, Modelo de Controlador Combinado (CMD), contém dois controladores: um fornece acesso através da API D2XX e o outro fornece uma Porta de Com Virtual (VCP) para o mesmo dispositivo. Ambos os controladores são instalados por predefinição se o chip FTDI tiver o modo VCP ativado. Isto pode fazer com que o Windows falhe quando o chip é ligado.

Para resolver este problema, pode desativar o modo VCP para o chip FTDI. Terá de utilizar a ferramenta FT_PROG para reprogramar o EEPROM do chip FTDI.

1. Veja FTDI FT_PROG ferramenta de programação para saber como transferir e instalar esta ferramenta.

2. Execute FT_PROG e localize o dispositivo anexado, conforme descrito em FT_PROG aplicação GUI.

3. Na vista Árvore de Dispositivos, expanda a secção Hardware Específico . Deverá ver quatro portas.

   

4. Selecione Porta A e escolha D2XX Direto em vez de Porta com Virtual.

   

5. Repita o passo anterior para a Porta C e a Porta D. A Porta B já deve estar no modo D2XX Direto.

6. Selecione o ícone Dispositivos de Programa (assemelha-se a um relâmpago) para entrar no modo de programação.

   

7. Selecione Programa para programar o EEPROM e, em seguida, aguarde até que seja concluído.

   

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

Ligação perdida a dispositivos FTDI não Azure Sphere após ativar a depuração do RTApp

Alguns utilizadores do Azure Sphere comunicaram que já não conseguem comunicar com outros dispositivos FTDI anexados e não do Azure Sphere depois de utilizarem o comando az sphere device enable-development --enable-rt-core-debugging para desenvolver e depurar RTApps a partir do pc anfitrião.

Por exemplo, se tiver um dispositivo do Azure Sphere e um dispositivo FTDI diferente ligado ao PC, poderá ver dois Controladores de Série Universais denominados dispositivos USB Serial Converter B no Windows Gestor de Dispositivos antes de executar o comando.

Depois de executar o comando, ambos os dispositivos usb Serial Converter B desaparecem da secção do controlador Universal Serial Bus e dois novos dispositivos aparecem nos dispositivos Universal Serial Bus apresentados no Gestor de Dispositivos.

Causa

Este problema ocorre porque o comando az sphere device enable-development --enable-rt-core-debugging instala um novo controlador para a Porta B do chip FTDI no MT3620; em seguida, a porta torna-se MSFT MT3620 Std Interface. No entanto, a instalação deste controlador altera inadvertidamente o controlador 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 o controlador de Porta B substituído.

Solução

Siga estes passos para reverter manualmente o controlador de quaisquer dispositivos que não estejam no Azure Sphere para a versão anterior:

1. No Gestor de Dispositivos, selecione o dispositivo não Azure Sphere (Outro FTDI Quad GZ no exemplo) e, em seguida, clique com o botão direito do rato e selecione Atualizar controlador.

2. Em Atualizar Controladores, selecione Procurar software do controlador no meu computador.

   

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

   

4. Selecione controlador USB Serial Converter B na lista e, em seguida, clique em Seguinte.

   

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

6. Gestor de Dispositivos deve mostrar a Porta B para o outro dispositivo FTDI como Conversor de Série USB B, o que indica que utiliza o controlador FTDI oficial. O controlador do MT3620 continua a ser a Interface Std MSFT MT3620.

   

Informações adicionais

• Se ligar outro novo dispositivo FTDI não Azure Sphere após executar o comando azsphere device enable-development --enable-rt-core-debugging , esse dispositivo será atribuído ao controlador do MT3620 do Azure Sphere da mesma forma. Repita os passos acima para reverter o dispositivo para o controlador FTDI oficial.

• Se desligar e voltar a ligar um dispositivo FTDI não Azure Sphere depois de o devolver ao controlador FTDI oficial, o dispositivo manterá o controlador FTDI oficial.

• Se executar o comando az sphere device enable-development --enable-rt-core-debugging novamente depois de reverter o controlador, o dispositivo FTDI não Azure Sphere terá novamente o controlador substituído e terá de seguir os passos em Solução para reverter para o controlador FTDI oficial. Isto ocorre independentemente de o dispositivo FTDI não Azure Sphere estar ligado ao PC quando o comando az sphere device enable-development --enable-rt-core-debugging é executado.

Comandos não reconhecidos

Se vir o seguinte erro ao introduzir um comando do azsphere, certifique-se de que está a utilizar o PowerShell ou uma linha de comandos padrão no Windows.

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

Instalador bloqueia a 60 por cento

O instalador bloqueia a 60%, e é-lhe dito que o Serviço de Comunicação de Dispositivos falhou ao iniciar. Normalmente, isto ocorre quando a instalação do controlador TAP falha de uma forma estranha, deixando o sistema num estado indeterminado.

Confirme que o problema é o controlador TAP

1. Abra a Visualizador de Eventos do Windows para verificar os registos.

2. Procure no Registo de aplicações e no registo do Serviço de Comunicação de Dispositivos do Azure Sphere a seguinte mensagem de erro:

   "SerialSlipToTun.TunInterfaceSetupException: Erro ao aceder às definições do registo do tun ---> System.Collections.Generic.KeyNotFoundException: o dispositivo de toque no Tun não foi encontrado ---> System.Security.SecurityException: Não é permitido o acesso pedido ao registo."

   

3. Ao verificar o Registo de aplicações, filtre o registo para evitar ver as muitas mensagens não relacionadas. No separador Ação , selecione Filtrar Registo Atual.

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

   

5. Se não conseguir encontrar o erro no Registo de aplicações ou no registo do Serviço de Comunicação de Dispositivos do Azure Sphere, poderá não ser um problema do controlador TAP.

Para resolver o problema do controlador TAP, siga estes passos:

1. Aceda ao Centro de Rede e Partilha e selecione Alterar definições do adaptador.

   

2. Em Rede Connections no Azure Sphere, selecione TAP-WIndows Adapter V9 e abra as respetivas propriedades.

   

3. Em Propriedades do Azure Sphere, selecione Internet Protocol Versão 4 (TCP/IPv4) e, em seguida, selecione Propriedades para ver as definições do protocolo.

   

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

5. Tente o instalador novamente. Se continuar a bloquear, tente repor as ligações de rede. Para efetuar uma reposição, aceda a Definições>Rede &Estado da Internet e selecione Reposição de rede> junto à parte inferior da página.

   Importante

   A reposição da rede irá repor todas as definições de rede.

Parar o Serviço de Comunicação de Dispositivos do Azure Sphere

Se o instalador bloquear, pode parar o Serviço de Comunicação de Dispositivos do Azure Sphere com o comando taskkill .

Siga estes passos:

1. Copie o PID do AzureSphereDeviceCommunicationService.

   • Aceda ao separador Serviços do Gestor> deTarefas e anote o PID do serviço AzureSphereDeviceCommunicationService ou
   • Na linha de comandos, escreva tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" e copie o PID a partir da saída.

2. Escreva o seguinte na linha de comandos para terminar o serviço. O comando taskkill termina o processo que corresponde ao número do ID do processo. A /f opção é utilizada para terminar o processo com força.

   taskkill /PID <DCS_PID> /f

3. Tente o instalador novamente.

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

Ao atualizar um SDK do Azure Sphere existente, poderá ver uma mensagem a indicar "Serviço "Serviço de Comunicação de Dispositivos do Azure Sphere" (AzureSphereDeviceCommunicationService) não pôde ser parado. Verifique se tem privilégios suficientes para parar os serviços do sistema." Se receber esta mensagem, reinicie e execute novamente o instalador.

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

Quando um computador de desenvolvimento está ligado à VPN empresarial e o túnel dividido é desativado pela configuração da VPN, o computador de desenvolvimento poderá não conseguir comunicar com o dispositivo do Azure Sphere.

Para resolver este problema, efetue um dos seguintes procedimentos:

• Desligue-se da VPN empresarial e tente ligar novamente ao dispositivo do Azure Sphere.
• Altere a configuração da VPN para permitir a divisão do túnel.

Os problemas de comunicação também podem ser causados pela configuração do adaptador TAP-Windows. Veja a secção Problemas de ligação causados por TAP-Windows resolução de problemas de configuração do adaptador .

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

Depois de atualizar para Windows 11, os utilizadores não conseguem instalar ou desinstalar o SDK do Azure Sphere. Para resolver este problema, instale a versão mais recente do SDK do Azure Sphere para Windows. Depois de instalar a Atualização 21.07 ou posterior, poderá desinstalar o SDK.

Não é possível compilar ou depurar RTApps

Se o CMake apresentar erros ao localizar as toolchains ou openocd ao tentar criar ou depurar uma RTApp, certifique-se de que:

• Instalou a Cadeia de Ferramentas GNU Arm Embedded para o seu ambiente de desenvolvimento.
• Especificou o caminho correto para openocd , conforme descrito em Tutorial: Criar uma aplicação com capacidade em tempo real.

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

Aviso

Estes passos destinam-se a utilizadores com a versão 22.11 ou anterior do SDK. Verifique se a versão do SDK instalada é a 22.11 ou anterior ao executar a versão show-version do azsphere.

Nos sistemas Linux com a versão 22.11 ou anterior do SDK, o script de azsphere_connect.sh tem de ser executado sempre que ligar o dispositivo ou desligar ou voltar a ligá-lo. O script atualiza as ligações do dispositivo e gera um controlador de kernel que mapeia o tráfego de rede para o dispositivo.

Se estiver a deparar-se com problemas de comunicação, comece com estes passos básicos:

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 consegue comunicar diretamente com o dispositivo. Navegue para https://192.168.35.2/status num browser. Ignore e dispense quaisquer avisos SSL apresentados. Deverá ver um resultado semelhante a: {"uptime":56} na janela do browser.

Nota

Também pode efetuar este passo a partir da linha de comandos com curl https://192.168.35.2/status --insecure.

1. Se o erro persistir, desligue o dispositivo da porta USB, ligue-o novamente e aguarde que reinicie. Em seguida, execute o script azsphere_connect.sh .

2. Se o erro continuar, certifique-se de que não existem conflitos de sub-rede com outras ferramentas de rede.