Problemen met het Azure Percept DK-apparaat oplossen

Belangrijk

Buitengebruikstelling van Azure Percept DK:

Update 22 februari 2023: Er is nu een firmware-update voor de Onderdelen van Percept DK Vision en Audio-accessoire (ook wel Vision en Audio SOM genoemd) beschikbaar en de onderdelen van het accessoire kunnen blijven functioneren buiten de buitengebruikstellingsdatum.

De openbare preview van Azure Percept ontwikkelt zich om nieuwe edge-apparaatplatforms en ontwikkelervaringen te ondersteunen. Als onderdeel van deze evolutie worden de Azure Percept DK en Audio Accessory en bijbehorende ondersteunende Azure-services voor de Percept DK op 30 maart 2023 buiten gebruik gesteld.

Vanaf 30 maart 2023 worden de Azure Percept DK en Audio Accessory niet meer ondersteund door Azure-services, waaronder Azure Percept Studio, besturingssysteemupdates, containers, webstream- en Custom Vision-integratie. Microsoft biedt geen klantondersteuning meer en eventuele bijbehorende ondersteunende services. Ga voor meer informatie naar het pensioen kennisgevingsblogbericht.

Het doel van dit artikel over probleemoplossing is om Azure Percept DK-gebruikers te helpen om snel veelvoorkomende problemen met hun dev kits op te lossen. Het biedt ook richtlijnen voor het verzamelen van logboeken voor wanneer extra ondersteuning nodig is.

Logboekverzameling

In deze sectie krijgt u richtlijnen over welke logboeken moeten worden verzameld en hoe u deze kunt verzamelen.

Instructies voor het verzamelen van logboeken

1. Maak verbinding met uw dev kit via SSH.

2. Voer de benodigde opdrachten uit in het SSH-terminalvenster. Zie de volgende sectie voor de lijst met opdrachten voor logboekverzamelingen.

3. Gebruik de volgende syntaxis om uitvoer om te leiden naar een .txt-bestand voor verdere analyse:

   sudo [command] > [file name].txt
   

4. Wijzig de machtigingen van het .txt bestand zodat het kan worden gekopieerd:

   sudo chmod 666 [file name].txt
   

5. Kopieer het bestand naar uw host-pc via SCP:

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

   [local host file path] verwijst naar de locatie op uw host-pc waarnaar u het .txt-bestand wilt kopiëren. [remote username] is de SSH-gebruikersnaam die tijdens de installatie-ervaring is gekozen.

Logboektypen en opdrachten

Logboekdoel	Wanneer moet u deze verzamelen	Opdracht
Ondersteuningsbundel : biedt een set logboeken die nodig zijn voor de meeste klantondersteuningsaanvragen.	Verzamel wanneer u ondersteuning aanvraagt.	sudo iotedge support-bundle --since 1h "--since 1h" kan worden gewijzigd in elke tijdsduur, bijvoorbeeld "6h" (6 uur), "6d" (6 dagen) of "6m" (6 minuten)
OOBE-logboeken - registreert details over de installatie-ervaring.	Verzamel problemen zodra u deze tegenkomt tijdens de installatie.	sudo journalctl -u oobe -b
edgeAgent-logboeken : registreert de versienummers van alle modules die op uw apparaat worden uitgevoerd.	Verzamel gegevens wanneer één of meer modules niet functioneren.	sudo iotedge logs edgeAgent
Modulecontainerlogboeken - registreert details over specifieke IoT Edge-modulecontainers	Verzamelen wanneer u problemen met een module vindt	sudo iotedge logs [container name]
Netwerklogboeken : een set logboeken die betrekking hebben op Wi-Fi services en de netwerkstack.	Verzamel wanneer u Wi-Fi of netwerkproblemen vindt.	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 Voer beide opdrachten uit. Elke opdracht verzamelt meerdere logboeken en plaatst deze in één uitvoer.

Waarschuwing

Uitvoer van de support-bundle opdracht kan host-, apparaat- en modulenamen, informatie bevatten die door uw modules is geregistreerd, enzovoort. Houd er rekening mee als u de uitvoer deelt op een openbaar forum.

Probleemoplossingsopdrachten

Hier volgt een reeks opdrachten die kunnen worden gebruikt voor het oplossen van problemen die u kunt vinden met de dev kit. Als u deze opdrachten wilt uitvoeren, moet u eerst verbinding maken met uw dev kit via SSH.

Zie de documentatie voor het oplossen van problemen met Azure IoT Edge-apparaten voor meer informatie over de Azure IoT Edge-opdrachten.

Functie	Wanneer te gebruiken	Opdracht
Controleert de softwareversie op de dev kit.	Gebruik telkens wanneer u wilt controleren welke softwareversie zich in uw dev kit bevindt.	cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Controleert de temperatuur van de dev kit	Gebruik in gevallen waarin u denkt dat de dev kit oververhit raakt.	cat /sys/class/thermal/thermal_zone0/temp
Controleert de telemetrie-id van de Dev Kit	Gebruik in gevallen waarin u de unieke telemetrie-id van dev kits moet kennen.	sudo azure-device-health-id
Controleert de status van IoT Edge	Gebruik wanneer er problemen zijn met IoT Edge-modules die verbinding maken met de cloud.	sudo iotedge check
De Azure IoT Edge-beveiligingsdaemon opnieuw starten	Gebruik deze functie wanneer IoT Edge niet reageert of niet goed werkt.	sudo systemctl restart iotedge
Een overzicht van de geïmplementeerde Azure IoT Edge-modules	Uwe wanneer u alle modules wilt zien die zijn geïmplementeerd in de dev kit	sudo iotedge list
Geeft de beschikbare/totale ruimte weer in het opgegeven bestandssysteem(en)	Gebruik deze optie als u de beschikbare opslag in de dev kit moet kennen.	df [option] [file]
Geeft de IP- en interface-informatie van de ontwikkelkit weer	Gebruik dit wanneer u het IP-adres van de Dev Kit moet kennen.	ip route get 1.1.1.1
Alleen het IP-adres van de Dev Kit weergeven	Gebruik deze functie als u alleen het IP-adres van de dev kit wilt gebruiken en niet de andere interfacegegevens.	ip route get 1.1.1.1 | awk '{print $7}' ifconfig [interface]

USB-updatefouten

Fout:	Oplossing:
LIBUSB_ERROR_XXX tijdens USB-flash via UUU	Deze fout is het gevolg van een USB-verbindingsfout tijdens het bijwerken van UUU. Als de USB-kabel niet goed is aangesloten op de USB-poorten op de pc of de Percept DK-carrier board, treedt er een fout van dit formulier op. Probeer beide uiteinden van de USB-kabel los te koppelen en de kabel opnieuw aan te sluiten om een veilige verbinding te garanderen.

Harde schijfruimte vrijmaken op de Azure Percept DK

Er zijn twee onderdelen die de ruimte op de harde schijf in beslag nemen in de Azure Percept DK, de docker-containerlogboeken en de docker-containers zelf. Om ervoor te zorgen dat de containerlogboeken niet alle harde schijfruimte in beslag nemen, heeft de Azure Percept DK logboekrotatie ingebouwd waarin oude logboeken worden verwijderd wanneer nieuwe logboeken worden gegenereerd.

Voor situaties waarin het aantal Docker-containers ruimteproblemen met de harde schijf veroorzaakt, kunt u ongebruikte containers verwijderen door de volgende stappen uit te voeren:

1. SSH naar de ontwikkelaarskit
2. Voer deze opdracht uit: docker system prune

Hiermee worden alle ongebruikte containers, netwerken, afbeeldingen en optioneel volumes verwijderd. Ga naar deze pagina voor meer informatie.

LED-status van het Azure Percept DK-carrierboard

Er zijn drie kleine LED's bovenop de carrier board behuizing. Naast LED 1 wordt een cloudpictogram afgedrukt, naast LED 2 wordt een Wi-Fi-pictogram afgedrukt en wordt er naast LED 3 een uitroeptekenpictogram afgedrukt. Zie de onderstaande tabel voor informatie over elke LED-status.

LED	Staat	Beschrijving
LED 1 (IoT Hub)	Aan (solide)	Het apparaat is verbonden met een IoT Hub.
LED 2 (Wi-Fi)	Langzaam knipperen	Het apparaat is klaar om te worden geconfigureerd door Wi-Fi Easy Connect en kondigt de aanwezigheid aan van een configurator.
LED 2 (Wi-Fi)	Snel knipperen	Verificatie is geslaagd, apparaatkoppeling wordt uitgevoerd.
LED 2 (Wi-Fi)	Aan (ononderbroken)	Verificatie en koppeling zijn geslaagd; apparaat is verbonden met een Wi-Fi netwerk.
LED 3	NA	LED niet in gebruik.