Felsöka Azure Percept DK-enheten

  • Artikel

Viktigt

Tillbakadragning av Azure Percept DK:

Uppdatering 22 februari 2023: En uppdatering av den inbyggda programvaran för tillbehörskomponenterna Percept DK Vision och Audio (även kallat Vision och Audio SOM) finns nu tillgänglig här och gör det möjligt för tillbehörskomponenterna att fortsätta att fungera efter tillbakadragningsdatumet.

Den offentliga förhandsversionen av Azure Percept kommer att utvecklas för att stödja nya plattformar för gränsenheter och utvecklarupplevelser. Som en del av den här utvecklingen kommer Azure Percept DK och Ljudaccessoar och tillhörande stöd för Azure-tjänster för Percept DK att dras tillbaka den 30 mars 2023.

Från och med den 30 mars 2023 stöds inte längre Azure Percept DK och Ljudtillbehör av Azure-tjänster, inklusive Azure Percept Studio, OS-uppdateringar, containeruppdateringar, visning av webbström och Custom Vision integrering. Microsoft kommer inte längre att tillhandahålla kundframgångssupport och associerade stödtjänster. Mer information finns i blogginlägget om pensionsavisering.

Syftet med den här felsökningsartikeln är att hjälpa Azure Percept DK-användare att snabbt lösa vanliga problem med sina dev kit. Den ger också vägledning om hur du samlar in loggar för när extra support behövs.

Logginsamling

I det här avsnittet får du vägledning om vilka loggar som ska samlas in och hur du samlar in dem.

Samla in loggar

  1. Anslut till ditt dev kit via SSH.

  2. Kör de kommandon som behövs i SSH-terminalfönstret. Se nästa avsnitt för listan över logginsamlingskommandon.

  3. Omdirigering av utdata till en .txt fil för ytterligare analys använder du följande syntax:

    sudo [command] > [file name].txt

  4. Ändra behörigheterna för den .txt filen så att den kan kopieras:

    sudo chmod 666 [file name].txt

  5. Kopiera filen till värddatorn via SCP:

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

    [local host file path] refererar till den plats på värddatorn som du vill kopiera den .txt filen till. [remote username] är det SSH-användarnamn som valts under installationen.

Loggtyper och kommandon

Loggsyfte När du ska samla in den Kommando
Supportpaket – innehåller en uppsättning loggar som behövs för de flesta kundsupportförfrågningar. Samla in när du begär support. sudo iotedge support-bundle --since 1h

"--since 1h" kan ändras till valfritt tidsintervall, till exempel "6h" (6 timmar), "6d" (6 dagar) eller "6m" (6 minuter)
OOBE-loggar – innehåller information om konfigurationsupplevelsen. Samla in när du hittar problem under installationen. sudo journalctl -u oobe -b
edgeAgent-loggar – registrerar versionsnumren för alla moduler som körs på enheten. Samla in när en eller flera moduler inte fungerar. sudo iotedge logs edgeAgent
Modulcontainerloggar – registrerar information om specifika IoT Edge modulcontainrar Samla in när du hittar problem med en modul sudo iotedge logs [container name]
Nätverksloggar – en uppsättning loggar som täcker Wi-Fi tjänster och nätverksstacken. Samla in när du hittar Wi-Fi eller nätverksproblem. 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

Kör båda kommandona. Varje kommando samlar in flera loggar och placerar dem i ett enda utdata.

Varning

Utdata från support-bundle kommandot kan innehålla värd-, enhets- och modulnamn, information som loggas av dina moduler osv. Tänk på detta om du delar utdata i ett offentligt forum.

Felsökningskommandon

Här är en uppsättning kommandon som kan användas för felsökning av problem som du kan hitta med dev kit. Om du vill köra dessa kommandon måste du först ansluta till din dev kit via SSH.

Mer information om Azure IoT Edge-kommandon finns i felsökningsdokumentationen för Azure IoT Edge-enheter.

Funktion När du ska använda detta Kommando
Kontrollerar programvaruversionen i dev kit. Använd varje gång du behöver bekräfta vilken programvaruversion som finns på ditt dev kit. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Kontrollerar temperaturen för dev kit Använd i de fall där du tror att dev kit kan överhettas. cat /sys/class/thermal/thermal_zone0/temp
Kontrollerar dev-paketets telemetri-ID Använd i fall där du behöver känna till dev kits unika telemetriidentifierare. sudo azure-device-health-id
Kontrollerar status för IoT Edge Använd när det finns problem med IoT Edge moduler som ansluter till molnet. sudo iotedge check
Startar om Säkerhetsdaemon för Azure IoT Edge Använd när IoT Edge inte svarar eller inte fungerar som den ska. sudo systemctl restart iotedge
Visar en lista över de distribuerade Azure IoT Edge-modulerna Uwe när du behöver se alla moduler som distribueras i dev kit sudo iotedge list
Visar tillgängligt/totalt utrymme i de angivna filsystemen Använd om du behöver känna till det tillgängliga lagringsutrymmet i dev-paketet. df [option] [file]
Visar DEV-paketets IP- och gränssnittsinformation Använd när du behöver känna till DEV-paketets IP-adress. ip route get 1.1.1.1
Visa endast IP-adressen för Dev Kit Använd när du bara vill ha DEV-paketets IP-adress och inte den andra gränssnittsinformationen. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

USB-uppdateringsfel

Fel: Lösning:
LIBUSB_ERROR_XXX under USB-flash via UUU Det här felet beror på ett USB-anslutningsfel under UUU-uppdateringen. Om USB-kabeln inte är korrekt ansluten till USB-portarna på datorn eller Percept DK-operatörskortet uppstår ett fel i det här formuläret. Prova att koppla från och återansluta usb-kabelns båda ändar och jiggling av kabeln för att säkerställa en säker anslutning.

Rensa hårddiskutrymme på Azure Percept DK

Det finns två komponenter som tar upp hårddiskutrymmet i Azure Percept DK, docker-containerloggarna och själva Docker-containrarna. För att säkerställa att containerloggarna inte tar upp allt under det hårda utrymmet har Azure Percept DK en inbyggd loggrotation som roterar ut alla gamla loggar när nya loggar genereras.

I situationer där antalet Docker-containrar orsakar problem med hårddiskutrymme kan du ta bort oanvända containrar genom att följa dessa steg:

  1. SSH till dev kit
  2. Kör det här kommandot: docker system prune

Då tas alla oanvända containrar, nätverk, avbildningar och volymer bort. Gå till den här sidan om du vill ha mer information.

Led-tillstånd för Azure Percept DK-operatörskort

Det finns tre små lysdioder ovanpå transportföretagets styrelsehus. En molnikon skrivs ut bredvid LED 1, en Wi-Fi-ikon skrivs ut bredvid LED 2 och ett utropstecken skrivs ut bredvid LED 3. Se tabellen nedan för information om varje LED-tillstånd.

LEDDE Stat Beskrivning
LED 1 (IoT Hub) På (heldragen) Enheten är ansluten till en IoT Hub.
LED 2 (Wi-Fi) Långsam blinkning Enheten är redo att konfigureras av Wi-Fi Easy Connect och meddelar att den finns i en konfigurerare.
LED 2 (Wi-Fi) Snabb blinkning Autentiseringen lyckades, enhetsassociation pågår.
LED 2 (Wi-Fi) På (heldragen) Autentiseringen och associationen lyckades. enheten är ansluten till ett Wi-Fi nätverk.
LED 3 NA Lysdiod används inte.