Share via

Menyelesaikan masalah perangkat Azure Percept DK

  • Artikel

Penting

Penghentian Azure Percept DK:

Pembaruan 22 Februari 2023: Pembaruan firmware untuk komponen aksesori Percept DK Vision dan Audio (juga dikenal sebagai Vision dan Audio SOM) sekarang tersedia di sini, dan akan memungkinkan komponen aksesori untuk terus berfungsi di luar tanggal penghentian.

Pratinjau publik Azure Percept akan berkembang untuk mendukung platform perangkat edge baru dan pengalaman pengembang. Sebagai bagian dari evolusi ini, Azure Percept DK dan Aksesori Audio serta layanan Azure pendukung terkait untuk Percept DK akan dihentikan pada 30 Maret 2023.

Efektif 30 Maret 2023, Azure Percept DK dan Aksesori Audio tidak akan lagi didukung oleh layanan Azure apa pun termasuk Azure Percept Studio, pembaruan OS, pembaruan kontainer, melihat aliran web, dan integrasi Custom Vision. Microsoft tidak akan lagi memberikan dukungan keberhasilan pelanggan dan layanan pendukung terkait. Untuk informasi lebih lanjut, silakan kunjungi Posting Blog Pemberitahuan Penghentian.

Tujuan dari artikel pemecahan masalah ini adalah untuk membantu pengguna Azure Percept DK untuk dengan cepat menyelesaikan masalah umum dengan kit dev mereka. Ini juga memberikan panduan tentang mengumpulkan log ketika dukungan tambahan diperlukan.

Pengumpulan log

Pada bagian ini, Anda akan mendapatkan panduan tentang log mana yang harus dikumpulkan dan cara mengumpulkannya.

Cara mengumpulkan log

  1. Hubungkan ke dev kit Anda melalui SSH.

  2. Jalankan perintah yang diperlukan di jendela terminal SSH. Lihat bagian berikutnya untuk daftar perintah pengumpulan log.

  3. Mengalihkan output apa pun ke file .txt untuk analisis lebih lanjut, gunakan sintaks berikut:

    sudo [command] > [file name].txt

  4. Ubah izin file .txt agar dapat disalin:

    sudo chmod 666 [file name].txt

  5. Salin file ke PC host Anda melalui SCP:

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

    [local host file path] mengacu pada lokasi di PC host tempat Anda ingin menyalin file .txt. [remote username] adalah nama pengguna SSH yang dipilih selama pengalaman penyiapan.

Tipe dan perintah log

Tujuan log Kapan mengumpulkannya Perintah
Paket dukungan - menyediakan satu set log yang diperlukan untuk sebagian besar permintaan dukungan pelanggan. Kumpulkan setiap kali meminta dukungan. sudo iotedge support-bundle --since 1h

"--since 1h" dapat diubah ke rentang waktu, misalnya, "6h" (6 jam), "6d" (6 hari) atau "6m" (6 menit)
Log OOBE - mencatat detail tentang pengalaman penyiapan. Kumpulkan saat Anda menemukan masalah selama pengalaman penyiapan. sudo journalctl -u oobe -b
Log edgeAgent - mencatat nomor versi semua modul yang berjalan di perangkat Anda. Kumpulkan ketika satu atau beberapa modul tidak berfungsi. sudo iotedge logs edgeAgent
Log kontainer modul - mencatat detail tentang kontainer modul IoT Edge tertentu Kumpulkan saat Anda menemukan masalah dengan modul sudo iotedge logs [container name]
Log jaringan - satu set log yang mencakup layanan Wi-Fi dan tumpukan jaringan. Kumpulkan saat Anda menemukan masalah Wi-Fi atau jaringan. 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

Jalankan kedua perintah tersebut. Setiap perintah mengumpulkan beberapa log dan menempatkannya ke dalam satu output.

Peringatan

Output dari perintah support-bundle dapat berisi nama host, perangkat dan modul, informasi yang dicatat oleh modul Anda, dll. Perhatikan hal ini jika membagikan output di forum publik.

Perintah pemecahan masalah

Berikut adalah satu set perintah yang dapat digunakan untuk memecahkan masalah yang mungkin Anda temukan dengan kit dev. Untuk menjalankan perintah ini, Anda harus terlebih dahulu terhubung ke kit dev Anda melalui SSH.

Untuk informasi selengkapnya tentang perintah Azure IoT Edge, lihat dokumentasi pemecahan masalah perangkat Azure IoT Edge.

Fungsi Kapan digunakan Perintah
Periksa versi perangkat lunak kit dev. Gunakan kapan saja Anda perlu mengkonfirmasi versi perangkat lunak mana yang ada di kit dev Anda. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Memeriksa suhu kit dev Gunakan dalam kasus di mana Anda berpikir kit dev mungkin terlalu panas. cat /sys/class/thermal/thermal_zone0/temp
Memeriksa ID telemetri kit dev Gunakan dalam kasus di mana Anda perlu mengetahui pengidentifikasi telemetri unik kit dev. sudo azure-device-health-id
Periksa status IoT Edge Gunakan setiap kali ada masalah dengan modul IoT Edge yang terhubung ke cloud. sudo iotedge check
Mulai ulang daemon keamanan Azure IoT Edge Gunakan saat IoT Edge tidak responsif atau tidak berfungsi dengan benar. sudo systemctl restart iotedge
Daftar modul Azure IoT Edge yang disebarkan Gunakan ketika Anda perlu melihat semua modul yang digunakan pada kit dev sudo iotedge list
Menampilkan ruang yang tersedia/total dalam sistem file yang ditentukan Gunakan jika Anda perlu mengetahui penyimpanan yang tersedia pada kit dev. df [option] [file]
Menampilkan informasi IP dan antarmuka dev kit Gunakan saat Anda perlu mengetahui alamat IP kit dev. ip route get 1.1.1.1
Tampilkan alamat IP kit dev saja Gunakan saat Anda hanya menginginkan alamat IP kit dev dan bukan informasi antarmuka lainnya. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

Kesalahan pembaruan USB

Kesalahan: Solusi:
LIBUSB_ERROR_XXX selama USB flash melalui UUU Kesalahan ini merupakan akibat dari kegagalan koneksi USB selama pemutakhiran UUU. Jika kabel USB tidak terhubung dengan benar ke port USB pada PC atau papan pembawa Percept DK, kesalahan formulir ini akan terjadi. Coba cabut dan sambungkan kembali kedua ujung kabel USB dan goyangkan kabel untuk memastikan koneksi yang aman.

Membersihkan ruang hard drive pada Azure Percept DK

Ada dua komponen yang mengambil ruang hard drive pada Azure Percept DK, log kontainer docker dan wadah docker itu sendiri. Untuk memastikan log kontainer tidak mengambil semua ruang keras, Azure Percept DK memiliki rotasi log yang dibangun di mana memutar log lama saat log baru dihasilkan.

Untuk situasi ketika jumlah kontainer docker menyebabkan masalah ruang hard drive, Anda dapat menghapus kontainer yang tidak digunakan dengan mengikuti langkah-langkah berikut:

  1. SSH ke dalam kit dev
  2. Jalankan perintah ini: docker system prune

Ini akan menghapus semua kontainer, jaringan, gambar, dan volume yang tidak terpakai. Masuk ke halaman ini untuk detail selengkapnya.

Azure Percept DK papan operator LED menyatakan

Ada tiga LED kecil di atas rumah papan pembawa. Ikon cloud dicetak di samping LED 1, ikon Wi-Fi dicetak di samping LED 2, dan ikon tanda seru dicetak di samping LED 3. Lihat tabel di bawah ini untuk informasi tentang setiap status LED.

LED Provinsi Deskripsi
LED 1 (IoT Hub) Hidup (solid) Perangkat terhubung ke IoT Hub.
LED 2 (Wi-Fi) Kedipan lambat Perangkat siap dikonfigurasi oleh Wi-Fi Easy Connect dan mengumumkan kehadirannya ke konfigurator.
LED 2 (Wi-Fi) Kedipan cepat Autentikasi berhasil, asosiasi perangkat sedang berlangsung.
LED 2 (Wi-Fi) Hidup (solid) Autentikasi dan asosiasi berhasil; tersambung ke jaringan Wi-Fi.
LED 3 NA LED tidak digunakan.