Share via

Resolver problemas do dispositivo Azure Percept DK

  • Artigo

Importante

Descontinuação do Azure Percept DK:

Atualização 22 de fevereiro de 2023: está agora disponível uma atualização de firmware para os componentes do acessório Percept DK Visão e Áudio (também conhecido como SOM de Visão e Áudio) e permitirá que os componentes do acessório continuem a funcionar para além da data de descontinuação.

A pré-visualização pública do Azure Percept irá evoluir para suportar novas plataformas de dispositivos edge e experiências de programador. Como parte desta evolução, o Azure Percept DK and Audio Accessory e os serviços de suporte associados do Azure para o Percept DK serão descontinuados a 30 de março de 2023.

A partir de 30 de março de 2023, o Azure Percept DK e o Acessório de Áudio deixarão de ser suportados por quaisquer serviços do Azure, incluindo Azure Percept Studio, atualizações do SO, atualizações de contentores, visualização de fluxo Web e integração de Visão Personalizada. A Microsoft deixará de fornecer suporte de sucesso ao cliente e quaisquer serviços de suporte associados. Para obter mais informações, visite a Mensagem de Blogue Aviso de Extinção.

O objetivo deste artigo de resolução de problemas é ajudar os utilizadores do Azure Percept DK a resolver rapidamente problemas comuns com os respetivos kits de desenvolvimento. Também fornece orientações sobre a recolha de registos para quando é necessário suporte adicional.

Recolha de registos

Nesta secção, irá obter orientações sobre os registos a recolher e como os recolher.

Como recolher registos

  1. Ligue-se ao seu kit de programador através de SSH.

  2. Execute os comandos necessários na janela do terminal SSH. Veja a secção seguinte para obter a lista de comandos de recolha de registos.

  3. Redirecione qualquer saída para um ficheiro .txt para uma análise mais aprofundada, utilize a seguinte sintaxe:

    sudo [command] > [file name].txt

  4. Altere as permissões do ficheiro .txt para que possa ser copiado:

    sudo chmod 666 [file name].txt

  5. Copie o ficheiro para o PC anfitrião através de SCP:

    scp [remote username]@[IP address]:[remote file path]/[file name].txt [local host file path]

    [local host file path] refere-se à localização no PC anfitrião para a qual pretende copiar o ficheiro de .txt. [remote username] é o nome de utilizador SSH escolhido durante a experiência de configuração.

Tipos e comandos de registo

Finalidade do registo Quando o recolher Comando
Pacote de suporte – fornece um conjunto de registos necessários para a maioria dos pedidos de suporte ao cliente. Recolha sempre que pedir suporte. sudo iotedge support-bundle --since 1h

"--since 1h" pode ser alterado para qualquer intervalo de tempo, por exemplo, "6h" (6 horas), "6d" (6 dias) ou "6m" (6 minutos)
Registos OOBE – regista detalhes sobre a experiência de configuração. Recolha quando encontrar problemas durante a experiência de configuração. sudo journalctl -u oobe -b
registos edgeAgent - regista os números de versão de todos os módulos em execução no seu dispositivo. Recolha quando um ou mais módulos não estiverem a funcionar. sudo iotedge logs edgeAgent
Registos de contentores de módulos – regista detalhes sobre contentores de módulos de IoT Edge específicos Recolher quando encontrar problemas com um módulo sudo iotedge logs [container name]
Registos de rede – um conjunto de registos que abrange Wi-Fi serviços e a pilha de rede. Recolha quando encontrar Wi-Fi ou problemas de rede. sudo journalctl -u hostapd.service -u wpa_supplicant.service -u ztpd.service -u systemd-networkd > network_log.txt

cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version && rpm -q ztpd > system_ver.txt

Execute ambos os comandos. Cada comando recolhe vários registos e coloca-os numa única saída.

Aviso

O resultado do support-bundle comando pode conter nomes de anfitrião, dispositivo e módulo, informações registadas pelos módulos, etc. Tenha em atenção se partilhar a saída num fórum público.

Comandos de resolução de problemas

Eis um conjunto de comandos que podem ser utilizados para resolver problemas que pode encontrar com o kit de desenvolvimento. Para executar estes comandos, primeiro tem de se ligar ao seu dev kit através de SSH.

Para obter mais informações sobre os comandos do Azure IoT Edge, veja a documentação de resolução de problemas de dispositivos do Azure IoT Edge.

Função Quando utilizar Comando
Verifica a versão do software no dev kit. Utilize sempre que precisar de confirmar que versão de software está no seu kit de programador. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Verifica a temperatura do kit de desenvolvimento Utilize nos casos em que pensa que o kit de desenvolvimento pode estar a sobreaquecer. cat /sys/class/thermal/thermal_zone0/temp
Verifica o ID de telemetria do dev kit Utilize nos casos em que precisa de conhecer o identificador de telemetria exclusivo dos kits de desenvolvimento. sudo azure-device-health-id
Verifica o estado do IoT Edge Utilize sempre que houver problemas com IoT Edge módulos de ligação à cloud. sudo iotedge check
Reinicia o daemon de segurança do Azure IoT Edge Utilize quando IoT Edge não responde ou não está a funcionar corretamente. sudo systemctl restart iotedge
Lista os módulos do Azure IoT Edge implementados Quando precisar de ver todos os módulos implementados no dev kit sudo iotedge list
Apresenta o espaço disponível/total no(s) sistema(s) de ficheiros especificado(s) Utilize se precisar de saber o armazenamento disponível no kit de programador. df [option] [file]
Apresenta as informações de IP e interface do dev kit Utilize quando precisar de saber o endereço IP do dev kit. ip route get 1.1.1.1
Apresentar apenas o endereço IP do kit de desenvolvimento Utilize quando quiser apenas o endereço IP do dev kit e não as outras informações da interface. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

Erros de atualização USB

Erro: Solução:
LIBUSB_ERROR_XXX durante o flash USB através da UUU Este erro é o resultado de uma falha de ligação USB durante a atualização da UUU. Se o cabo USB não estiver corretamente ligado às portas USB no PC ou na placa operadora do Percept DK, ocorrerá um erro deste formulário. Experimente desligar e voltar a ligar ambas as extremidades do cabo USB e abane o cabo para garantir uma ligação segura.

Limpar o espaço do disco rígido no DK do Azure Percept

Existem dois componentes que ocupam o espaço do disco rígido no Azure Percept DK, os registos de contentor do docker e os próprios contentores do docker. Para garantir que os registos de contentor não ocupam todo o espaço rígido, o DK do Azure Percept tem a rotação de registos incorporada, o que faz com que os registos antigos sejam gerados à medida que são gerados novos registos.

Para situações em que o número de contentores do Docker causa problemas de espaço no disco rígido, pode eliminar contentores não utilizados ao seguir estes passos:

  1. SSH no kit de desenvolvimento
  2. Execute este comando: docker system prune

Esta ação irá remover todos os contentores, redes, imagens e volumes não utilizados e, opcionalmente, os volumes. Aceda a esta página para obter mais detalhes.

Estados LED do conselho de administração da transportadora do Azure Percept DK

Há três pequenos LEDs no topo da habitação do conselho de transporte. Um ícone de nuvem é impresso junto ao LED 1, é impresso um ícone de Wi-Fi junto ao LED 2 e é impresso um ícone de ponto de exclamação junto ao LED 3. Consulte a tabela abaixo para obter informações sobre cada estado LED.

LED Estado Descrição
LED 1 (Hub IoT) Ativado (sólido) O dispositivo está ligado a uma Hub IoT.
LED 2 (Wi-Fi) Piscar lentamente O dispositivo está pronto para ser configurado pelo Wi-Fi Easy Connect e anuncia a sua presença num configurador.
LED 2 (Wi-Fi) Piscar rapidamente A autenticação foi bem-sucedida e a associação de dispositivos está em curso.
LED 2 (Wi-Fi) Ativado (sólido) A autenticação e a associação foram bem-sucedidas; o dispositivo está ligado a uma rede Wi-Fi.
LED 3 ND O LED não está a ser utilizado.