Share via

Risolvere i problemi del dispositivo Azure Percept DK

  • Articolo

Importante

Ritiro di Azure Percept DK:

Aggiornamento 22 febbraio 2023: un aggiornamento del firmware per i componenti accessori Percept DK Vision e Audio (noto anche come Visione e SOM audio) è ora disponibile qui e consentirà ai componenti accessori di continuare a funzionare oltre la data di ritiro.

L'anteprima pubblica di Azure Percept sarà in continua evoluzione per supportare nuove piattaforme per dispositivi perimetrali e esperienze per sviluppatori. Nell'ambito di questa evoluzione, Azure Percept DK e Audio Accessorio e i servizi di supporto associati per Percept DK verranno ritirati il 30 marzo 2023.

A partire dal 30 marzo 2023, Azure Percept DK e Audio Accessorio non sarà più supportato da alcun servizio di Azure, tra cui Azure Percept Studio, aggiornamenti del sistema operativo, aggiornamenti dei contenitori, visualizzare il flusso Web e Visione personalizzata integrazione. Microsoft non fornirà più supporto per il successo dei clienti e eventuali servizi di supporto associati. Per altre informazioni, visitare il post di blog sull'avviso di ritiro.

Lo scopo di questo articolo sulla risoluzione dei problemi è aiutare gli utenti di Azure Percept DK a risolvere rapidamente i problemi comuni con i kit di sviluppo. Fornisce inoltre indicazioni sulla raccolta dei log per quando è necessario un supporto aggiuntivo.

Raccolta registri

In questa sezione verranno fornite indicazioni sui log da raccogliere e su come raccoglierli.

Come raccogliere i log

  1. Connettersi al kit di sviluppo tramite SSH.

  2. Eseguire i comandi necessari nella finestra del terminale SSH. Per l'elenco dei comandi di raccolta log, vedere la sezione successiva.

  3. Per un'ulteriore analisi, reindirizzare qualsiasi output a un file di .txt, usare la sintassi seguente:

    sudo [command] > [file name].txt

  4. Modificare le autorizzazioni del file .txt in modo che possa essere copiato:

    sudo chmod 666 [file name].txt

  5. Copiare il file nel PC host tramite SCP:

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

    [local host file path] fa riferimento al percorso nel PC host in cui si desidera copiare il file di .txt. [remote username] è il nome utente SSH scelto durante l'esperienza di configurazione.

Tipi di log e comandi

Scopo del log Quando raccoglierlo Comando
Bundle di supporto : fornisce un set di log necessari per la maggior parte delle richieste di supporto clienti. Raccogliere ogni volta che viene richiesto il supporto. sudo iotedge support-bundle --since 1h

"--since 1h" può essere modificato in qualsiasi intervallo di tempo, ad esempio "6h" (6 ore), "6d" (6 giorni) o "6m" (6 minuti)
Log della configurazione guidata : registra i dettagli sull'esperienza di configurazione. Raccogliere quando si verificano problemi durante l'esperienza di configurazione. sudo journalctl -u oobe -b
log edgeAgent : registra i numeri di versione di tutti i moduli in esecuzione nel dispositivo. Raccogliere quando uno o più moduli non funzionano. sudo iotedge logs edgeAgent
Log dei contenitori di moduli: registra i dettagli relativi a contenitori di moduli di IoT Edge specifici Raccogliere quando si riscontrano problemi con un modulo sudo iotedge logs [container name]
Log di rete : un set di log che coprono i servizi Wi-Fi e lo stack di rete. Raccogliere quando vengono rilevati problemi di rete o Wi-Fi. 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

Eseguire entrambi i comandi. Ogni comando raccoglie più log e li inserisce in un singolo output.

Avviso

L'output del support-bundle comando può contenere nomi host, dispositivi e moduli, informazioni registrate dai moduli e così via. Tenere presente questo problema se si condivide l'output in un forum pubblico.

Risoluzione dei problemi dei comandi

Ecco un set di comandi che possono essere usati per la risoluzione dei problemi che possono verificarsi con il kit di sviluppo. Per eseguire questi comandi, è prima necessario connettersi al kit di sviluppo tramite SSH.

Per altre informazioni sui comandi di Azure IoT Edge, vedere la documentazione sulla risoluzione dei problemi dei dispositivi di Azure IoT Edge.

Funzione Utilizzo Comando
Controlla la versione del software nel kit di sviluppo. Usare ogni volta che è necessario verificare quale versione del software si trova nel kit di sviluppo. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Controlla la temperatura del kit di sviluppo Usare nei casi in cui si ritiene che il kit di sviluppo potrebbe essere surriscaldamento. cat /sys/class/thermal/thermal_zone0/temp
Controlla l'ID di telemetria del kit di sviluppo Usare nei casi in cui è necessario conoscere l'identificatore di telemetria univoco dei kit di sviluppo. sudo azure-device-health-id
Controlla lo stato di IoT Edge Usare ogni volta che si verificano problemi con IoT Edge moduli che si connettono al cloud. sudo iotedge check
Riavvia il daemon di sicurezza di Azure IoT Edge Usare quando IoT Edge non risponde o non funziona correttamente. sudo systemctl restart iotedge
Elenca i moduli IoT Edge di Azure distribuiti Uwe quando è necessario visualizzare tutti i moduli distribuiti nel kit di sviluppo sudo iotedge list
Visualizza lo spazio disponibile/totale nei file system specificati Usare se è necessario conoscere lo spazio di archiviazione disponibile nel kit di sviluppo. df [option] [file]
Visualizza l'IP e le informazioni sull'interfaccia del kit di sviluppo Usare quando è necessario conoscere l'indirizzo IP del kit di sviluppo. ip route get 1.1.1.1
Visualizzare solo l'indirizzo IP del kit di sviluppo Usare quando si desidera solo l'indirizzo IP del kit di sviluppo e non le altre informazioni sull'interfaccia. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

Errori di aggiornamento USB

Errore: Soluzione:
LIBUSB_ERROR_XXX durante il flash USB tramite UUU Questo errore è il risultato di un errore di connessione USB durante l'aggiornamento dell'UUU. Se il cavo USB non è connesso correttamente alle porte USB nel PC o nella scheda del gestore telefonico Percept DK, si verificherà un errore di questo modulo. Prova a scollegare e riconnettere entrambe le estremità del cavo USB e a jiggling il cavo per garantire una connessione sicura.

Cancellazione dello spazio su disco rigido in Azure Percept DK

Sono disponibili due componenti che occupano lo spazio su disco rigido in Azure Percept DK, i log dei contenitori Docker e i contenitori Docker stessi. Per assicurarsi che i log dei contenitori non occupano tutto lo spazio rigido, Azure Percept DK ha la rotazione dei log incorporata che ruota tutti i log precedenti man mano che vengono generati nuovi log.

Per situazioni in cui il numero di contenitori Docker causa problemi di spazio su disco rigido, è possibile eliminare i contenitori inutilizzati seguendo questa procedura:

  1. SSH nel kit di sviluppo
  2. Eseguire questo comando: docker system prune

Verranno rimossi tutti i contenitori, le reti, le immagini e, facoltativamente, i volumi. Per altri dettagli, passare a questa pagina.

Stati LED della scheda carrier DK di Azure Percept

Ci sono tre piccoli LED sopra l'alloggio della scheda trasportatore. Accanto a LED 1 viene stampata un'icona a forma di nuvola, accanto al LED 2 viene stampata un'icona a forma di Wi-Fi e accanto al LED 3 viene stampata un'icona punto esclamativo. Per informazioni su ogni stato DEL LED, vedere la tabella seguente.

LED State Descrizione
LED 1 (hub IoT) On (solid) Il dispositivo è connesso a un hub IoT.
LED 2 (Wi-Fi) Lampeggiare lento Il dispositivo è pronto per essere configurato da Wi-Fi Easy Connect e annuncia la sua presenza a un configuratore.
LED 2 (Wi-Fi) Lampeggiare veloce L'autenticazione è riuscita e l'associazione del dispositivo è in corso.
LED 2 (Wi-Fi) On (solid) L'autenticazione e l'associazione hanno avuto esito positivo; il dispositivo è connesso a una rete Wi-Fi.
LED 3 N/D LED non in uso.