Solucionar problemas do Azure Sphere

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

Aqui estão algumas etapas de solução de problemas que podem ocorrer durante a instalação e configuração.

Problemas de comunicação do dispositivo

Uma falha ao se conectar ao dispositivo a partir de uma máquina host pode ocorrer por vários motivos e pode disparar qualquer uma das várias mensagens de erro, dependendo de quais ferramentas ou aplicativos a encontram. As mensagens de erro a seguir podem indicar uma conexão com falha:

• 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 comando; (2) o serviço de comunicação do dispositivo (DCS) que facilita a comunicação com um dispositivo; e (3) o dispositivo.

Para isolar a causa, execute as seguintes etapas de diagnóstico:

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

Observação

Você também pode executar esta etapa na linha de comando usando curl https://192.168.35.2/status --insecure.

Observação

Você também pode executar esta etapa no PowerShell (v6 ou superior) Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck.

2. Confirme se o serviço de comunicação do dispositivo detectou um dispositivo. Navegue até http://localhost:48938/api/service/devices em um navegador da Web e confirme se pelo menos um dispositivo é mostrado na saída JSON.

Aviso

O DCS do Linux só está incluído no SDK versão 23.05 e superior. Siga as etapas de solução de problemas herdadas para as versões 22.11 e anteriores do SDK.

Observação

Você também pode executar esta etapa no PowerShell por meio de Invoke-WebRequest http://localhost:48938/api/service/devices.

Não foi possível se comunicar diretamente com o dispositivo e o dispositivo não é detectado pelo DCS

Se uma conexão não puder ser estabelecida com o dispositivo (Etapa 1) e o dispositivo não puder ser detectado pelo DCS (Etapa 2), provavelmente haverá um problema com a configuração física do dispositivo.

Em primeiro lugar, verifique se o dispositivo foi detectado pela máquina.

De um terminal:

1. Execute sudo lsusb. Verifique se a 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 | Onde-Objeto { $_. InstanceId -match '^USB' }. Verifique se a interface padrão MSFT MT3620 aparece na saída.

Se o comando anterior não retornar a saída esperada, conecte o dispositivo a uma porta USB diferente. Se isso ainda não resolver o problema, verifique se o dispositivo tem seus jumpers configurados corretamente. Por exemplo, Kit de desenvolvimento Seeed MT3620 são fornecidos com um jumper entre os pinos 2 e 3 de J3, que alimenta o relógio pela fonte de alimentação principal. Verifique se o cabeçalho não foi deslocado ou removido.

Não foi possível se comunicar diretamente com o dispositivo, mas o dispositivo foi detectado pelo DCS

Se uma conexão não puder ser estabelecida com o dispositivo (Etapa 1), mas o dispositivo tiver sido detectado pelo DCS (Etapa 2), é provável que o dispositivo ou o serviço de comunicação do dispositivo esteja em um estado incorreto.

Se você acabou de conectar um dispositivo à Internet e o sistema operacional do dispositivo está desatualizado, o dispositivo pode estar aplicando uma atualização do sistema operacional. Há também uma pequena chance de o dispositivo estar fazendo uma atualização do sistema operacional se o tempo coincidir com uma janela de lançamento. Durante uma atualização do sistema operacional, você não poderá se comunicar com um dispositivo.

Se você suspeitar que o dispositivo está atualizado e/ou não está conectado à Internet, a próxima melhor opção é desconectar e reconectar o dispositivo ao seu PC. Isso deve fazer com que o DCS renove sua conexão com o dispositivo e o dispositivo seja redefinido para um estado inicial.

Se você não conseguir desconectar e reconectar o dispositivo, a próxima melhor opção é reiniciar o DCS. 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 você não conseguir desconectar e reconectar o dispositivo, a próxima melhor opção é emitir um comando de nova verificação para o DCS. Ao receber esse comando, o DCS alternará e redefinirá o chip de interface FTDI usado para se comunicar com o MT3620. Usando uma janela do PowerShell:

1. Executar azsphere device rescan-attached

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

1. Execute 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 entre em Serviços. Clique com o botão direito do mouse no Serviço de Comunicação de Dispositivo do Azure Sphere e selecione Reiniciar.

Agora execute novamente o comando que você tentou inicialmente.

Se o comando continuar a falhar ou azsphere device list-attached tiver uma saída semelhante a:

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

Executar azsphere device recover

Pode se comunicar diretamente com o dispositivo e o dispositivo é detectado pelo DCS

Isso provavelmente indica um problema com a CLI. Certifique-se de ter a versão mais recente do SDK.

Se você tiver a versão mais recente do SDK e o problema ainda não tiver sido resolvido, poste uma pergunta no fórum de perguntas e respostas.

Conexões perdidas ou dispositivos ausentes

Se o computador pode se conectar ao dispositivo Azure Sphere, mas geralmente a conexão cai, pode haver um conflito na sub-rede IP.

O Azure Sphere usa a sub-rede 192.168.35.*. Se você tiver outro software que usa a mesma sub-rede, desabilite-o ou limite o intervalo de endereços IP que ele usa. No momento, você não pode alterar o intervalo de endereços IP que o Azure Sphere usa.

Não é possível aplicar recursos do dispositivo

Se você receber erros ao tentar aplicar uma funcionalidade de dispositivo a um dispositivo do Azure Sphere, o problema pode ser que o sistema operacional em seu dispositivo esteja desatualizado. Esse problema pode ocorrer se o dispositivo estiver offline por um longo período, durante o qual a Microsoft atualizou suas chaves internas. Os seguintes erros são sintomas desse problema:

Os comandos azsphere device enable-development ou azsphere device enable-cloud-test retornam 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 'azsphere device show-deployment-status'.

O comando azsphere device capability update retorna um erro semelhante ao seguinte:

error: Could not apply device capability configuration to device.

Isso ocorre porque o armazenamento de chaves confiável no dispositivo está desatualizado. Para resolver esse problema, siga as instruções aqui.

Falha ao criar quatro conversores seriais USB

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

Observação

Se esta placa tiver sido usada anteriormente para desenvolvimento RTApp, você poderá ver três conversores em vez de quatro. Isso é normal e não representa um erro.

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

Para resolver esse problema:

1. Para abrir o Gerenciador de Dispositivos, clique em Iniciar e entre no Gerenciador 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 esta etapa para o Conversor Serial USB B até o Conversor Serial USB D.

3. Desconecte seu board de desenvolvimento do computador e conecte-o novamente. "MSFT MT3620 Std Interface" deve aparecer com um ícone de aviso triangular, indicando que não há um driver disponível.

4. Clique com o botão direito do mouse em um dos dispositivos de interface padrão MSFT MT3620 e selecione Atualizar driver. Escolha Pesquisar automaticamente software de driver atualizado. Atualizar um deve corrigir todos eles. 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 ao instalar drivers FTDI

Os drivers FTDI devem ser baixados e instalados automaticamente pelo Windows quando o dispositivo do Azure Sphere for conectado pela primeira vez ao computador. Se os drivers estiverem instalados corretamente, você verá quatro conversores seriais USB listados em controladores Universal Serial Bus no Gerenciador de Dispositivos, conforme descrito em Configurar seu kit de desenvolvimento.

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-os manualmente 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 build de versões do Windows 10, consulte Informações de versão do Windows 10. Essas informações podem ajudá-lo a determinar se 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-se com as placas de desenvolvimento conectadas usando uma rede IP por meio de USB. Isso exige um adaptador TAP-Windows da OpenVPN Technologies. O procedimento de instalação do SDK do Azure Sphere instalará esse adaptador em seu computador 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 do Azure Sphere não estiver conectado à primeira instância do adaptador TAP-Windows, as ferramentas do Azure Sphere poderão falhar ao se conectar ao seu dispositivo.

• Se você estiver usando a rede privada virtual (VPN) do Cisco AnyConnect, o adaptador TAP-Windows poderá aparecer desconectado e a comunicação do dispositivo poderá 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 do Azure Sphere está conectado ao adaptador TAP-Windows apropriado

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

Para determinar quantos adaptadores TAP estão instalados em seu computador:

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

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

   

   Caso você veja mais de um adaptador TAP ou apenas um adaptador TAP, porém seu nome não seja Azure Sphere, siga estas etapas para desinstalar todos os adaptadores TAP e reinstalar o SDK. Se você não vir adaptadores TAP, reinstale o SDK.

Para desinstalar os adaptadores TAP:

1. Clique em Iniciar e entre no 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 de instalador do PowerShell:

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

5. Se a instalação for realizada, 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 VPN do Cisco AnyConnect

Quando você estiver usando o Cisco AnyConnect VPN Client, 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. Verifique se você tem privilégios de administrador em seu computador.

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

3. Em Configurações de rede avançadas, 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 do Driver de Filtro do Cisco AnyConnect Network Access Manager e desmarque o item.

   

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

7. Verifique se a comunicação com o dispositivo do 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 pode indicar que a inicialização do Serviço de Comunicação do Dispositivo do Azure Sphere falhou:

• 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 for resolvido e sua máquina tiver feito uma atualização do Windows recentemente, 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 arquivos de configurações JSON internos ou o arquivo de configuração foi corrompido.

Falha após a Atualização do Windows

Esses erros poderão ocorrer depois que você tiver atualizado o Windows em seu PC. Às vezes, o Windows Update desinstala os drivers FTD 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 deverão ser instalados novamente.
2. Se ocorrer uma falha na desconexão e na reconexão do dispositivo ao corrigir o problema, desinstale e reinstale o SDK do Azure Sphere.

Arquivo JSON

Se você não tiver atualizado o Windows recentemente, a causa do erro poderá ser o arquivo restore.json 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. Interrompa 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 trava ao conectar ou desconectar um dispositivo

A placa de desenvolvedor MT3620 tem um chip FT4232HQ FTDI (Future Technology Devices International), que facilita a comunicação entre o dispositivo e o computador. O driver FTDI oficial, CMD (Modelo de Driver Combinado), contém dois drivers: um fornece acesso por meio da API D2XX e o outro fornece uma VCP (Porta Com Virtual) 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 e ligado.

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

1. Consulte Ferramenta de programação FTDI FT_PROG para saber como baixar e instalar essa ferramenta.

2. Execute FT_PROG e encontre o dispositivo conectado, conforme descrito em FT_PROG aplicativo GUI.

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

   

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

   

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 a conclusão.

   

8. Desconecte o dispositivo da porta USB e reconecte-o para desligar e ligar o dispositivo e fazer com que a alteração entre em vigor. No Gerenciador de dispositivos do Windows, a seção Portas (COM e 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 anexados e não do Azure Sphere depois de usar o comando azsphere device enable-development --enable-rt-core-debugging para desenvolver e depurar RTApps de seu computador host.

Por exemplo, se você tiver um dispositivo do Azure Sphere e um dispositivo FTDI diferente anexado ao seu computador, 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 do controlador Universal Serial Bus e dois novos dispositivos aparecem na tela de dispositivos Universal Serial Bus no Gerenciador de dispositivos.

Causa

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 a interface padrão MSFT MT3620. No entanto, a instalação desse driver altera inadvertidamente o driver para a porta B do outro dispositivo que não é do 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 é 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 Deixe-me escolher em uma lista de drivers disponíveis no meu computador.

   

4. Selecione o driver USB Serial Converter B na lista e 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 continua sendo a interface padrão MSFT MT3620.

   

Informações adicionais

• Se você conectar outro novo dispositivo FTDI não 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 que não é do Azure Sphere terá seu driver substituído novamente 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 anexado ao computador quando o comando azsphere device enable-development --enable-rt-core-debugging é executado.

Os comando não são reconhecidos

Se você vir o erro a seguir 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 por cento

O instalador trava em 60% e você é informado de que o Serviço de Comunicação do Dispositivo falhou ao iniciar. Isso normalmente ocorre quando a instalação do driver TAP falha de maneira 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 Serviço de Comunicação do Dispositivo do Azure Sphere a seguinte mensagem de erro:

   "SerialSlipToTun.TunInterfaceSetupException: Erro de acesso às configurações do registro ---> System.Collections.Generic.KeyNotFoundException: Tun tap dispositivo não encontrado ---> System.Security.SecurityException: O acesso solicitado ao registro 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 do Dispositivo do Azure Sphere, isso pode não ser um problema de driver TAP.

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

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

   

2. Em Conexões de Rede no Azure Sphere, selecione Adaptador TAP-Windows V9 e abra suas propriedades.

   

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

   

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

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

   Importante

   A redefinição da rede redefinirá todas as configurações de rede.

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

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

Siga estas etapas:

1. Copie o PID para o AzureSphereDeviceCommunicationService.

   • Vá para a guia Serviços do Gerenciador>de Tarefas e anote o PID do 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 encerra 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 interromper 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 tunelamento dividido é usado

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

Para resolver esse problema, execute uma das seguintes ações:

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

Problemas de comunicação também podem ser causados pela configuração do adaptador TAP-Windows. Consulte a seção 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 a Atualização 21.07 2 ou posterior, você poderá desinstalar o SDK.

Não é possível compilar nem depurar RTApps

Se o CMake relatar erros ao localizar as cadeias de ferramentas ou openocd quando você tentar compilar ou depurar um RTApp, verifique se:

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

Solução de problemas de comunicação do dispositivo anterior à versão 23.05

Aviso

Essas etapas são para usuários com o SDK versão 22.11 ou anterior. Verifique se a versão do SDK instalada é 22.11 ou anterior executando azsphere show-version.

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 de 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. O dispositivo deve estar conectado por USB.

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

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

Observação

Você também pode executar esta etapa na linha de comando usando curl https://192.168.35.2/status --insecure.

1. Se o erro persistir, desconecte o dispositivo da porta USB, conecte-o novamente e aguarde a reinicialização. 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.