Problemen met Azure Percept DK apparaat oplossen
Het doel van dit artikel voor probleemoplossing is om gebruikers Azure Percept DK algemene problemen met hun dev kits snel 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 u moet verzamelen en hoe u deze kunt verzamelen.
Logboeken verzamelen
Verbinding maken aan uw dev-kit via SSH.
Voer de benodigde opdrachten uit in het SSH-terminalvenster. Zie de volgende sectie voor de lijst met opdrachten voor logboekverzameling.
Gebruik de volgende syntaxis om .txt uitvoer om te leiden naar een .txt voor verdere analyse:
sudo [command] > [file name].txtWijzig de machtigingen van het .txt zodat het kan worden gekopieerd:
sudo chmod 666 [file name].txtKopieer 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 waar u het .txt wilt kopiëren.[remote username]is de SSH-gebruikersnaam die is gekozen tijdens de installatie.
Logboektypen en -opdrachten
| Doel van logboek | 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 tijdspanne, bijvoorbeeld '6 uur' (6 uur), '6d' (6 dagen) of '6 m' (6 minuten) |
| OOBE-logboeken: registreert gegevens over de installatie-ervaring. | Verzamel wanneer u problemen vindt tijdens de installatie. | sudo journalctl -u oobe -b |
| edgeAgent-logboeken: registreert de versienummers van alle modules die op uw apparaat worden uitgevoerd. | Verzamel wanneer een of meer modules niet werken. | 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 voor Wi-Fi services en de netwerkstack. | Verzamel wanneer u problemen Wi-Fi netwerk vindt. | sudo journalctl -u hostapd.service -u wpa_supplicant.service -u ztpd.service -u systemd-networkd > network_log.txtcat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version && rpm -q ztpd > system_ver.txtVoer beide opdrachten uit. Elke opdracht verzamelt meerdere logboeken en plaatst deze in één uitvoer. |
Waarschuwing
De uitvoer van support-bundle de opdracht kan host-, apparaat- en modulenamen bevatten, informatie die is vastgelegd door uw modules, enzovoort. Houd hier rekening mee als u de uitvoer deelt in een openbaar forum.
Opdrachten voor probleemoplossing
Hier ziet u 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 voor meer informatie over de Azure IoT Edge-opdrachten de documentatie Azure IoT Edge problemen met apparaten oplossen.
| Functie | Wanneer gebruikt u dit? | Opdracht |
|---|---|---|
| Controleert de softwareversie op de dev kit. | Gebruik op elk gewenst moment dat u wilt bevestigen welke softwareversie op uw dev kit staat. | cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version |
| Controleert de temperatuur van de dev kit | Gebruik dit in gevallen waarin u denkt dat de dev-kit verknerend kan zijn. | 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 de dev kits moet kennen. | sudo azure-device-health-id |
| Controleert de status van IoT Edge | Gebruik dit wanneer er problemen zijn met IoT Edge modules die verbinding maken met de cloud. | sudo iotedge check |
| Start de beveiligingsdeemon Azure IoT Edge opnieuw op | Gebruik wanneer IoT Edge niet reageert of niet goed werkt. | sudo systemctl restart iotedge |
| Toont de geïmplementeerde Azure IoT Edge modules | Uwe wanneer u alle modules wilt zien die zijn geïmplementeerd op de Dev Kit | sudo iotedge list |
| Geeft de beschikbare/totale ruimte in de opgegeven bestandssysteem(en) weer | Gebruik deze als u de beschikbare opslag op de dev kit wilt weten. | df [option] [file] |
| Geeft de IP- en interface-informatie van de dev kit weer | Gebruik deze als u het IP-adres van de dev kit wilt weten. | ip route get 1.1.1.1 |
| Alleen het IP-adres van de dev kit weergeven | Gebruik dit als u alleen het IP-adres van de dev kit wilt en niet de andere interfacegegevens. | ip route get 1.1.1.1 | awk '{print $7}' ifconfig [interface] |
USB-updatefouten
| Fout: | Oplossing: |
|---|---|
| LIBUSB_ERROR_XXX USB-flash via UUU | Deze fout is het resultaat van een usb-verbindingsfout tijdens het bijwerken van de UUU. Als de USB-kabel niet goed is verbonden met de USB-poorten op de pc of het bord van de Percept DK-provider, treedt er een fout op in dit formulier. Probeer beide uiteinden van de USB-kabel los te koppelen en opnieuw aan te sluiten en de kabel te verbinden om een beveiligde verbinding te garanderen. |
Schijfruimte op de harde schijf wissen Azure Percept DK
Er zijn twee onderdelen die de harde schijfruimte op de Azure Percept DK, de docker-containerlogboeken en de Docker-containers zelf. Om ervoor te zorgen dat de containerlogboeken niet alle harde ruimte in beslag nemen, heeft de Azure Percept DK een ingebouwde rotatie van logboeken die oude logboeken roteert wanneer er nieuwe logboeken worden gegenereerd.
In situaties waarin het aantal Docker-containers problemen met de harde schijfruimte veroorzaakt, kunt u ongebruikte containers verwijderen door de volgende stappen uit te voeren:
- SSH in de dev-kit
- Voer deze opdracht uit:
docker system prune
Hiermee verwijdert u alle ongebruikte containers, netwerken, afbeeldingen en eventueel volumes. Ga naar deze pagina voor meer informatie.
Azure Percept DK led-staten van carrier board
Er staan drie kleine LED's boven op de behuizing van het transportbedrijf. Er wordt een cloudpictogram afgedrukt naast LED 1, een Wi-Fi-pictogram wordt afgedrukt naast LED 2 en er wordt een uitroeptekenpictogram weergegeven naast LED 3. 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 kan worden geconfigureerd door Wi-Fi Easy Verbinding maken en kondigt de aanwezigheid aan van een configurator. |
| LED 2 (Wi-Fi) | Snelle knipperen | De verificatie is geslaagd, de apparaat association is in uitvoering. |
| LED 2 (Wi-Fi) | Aan (solide) | Verificatie en associatie zijn geslaagd; het apparaat is verbonden met een Wi-Fi netwerk. |
| LED 3 | NA | LED niet in gebruik. |