Memecahkan masalah Azure Sphere

Penting

Ini adalah dokumentasi Azure Sphere (Warisan). Azure Sphere (Warisan) dihentikan pada 27 September 2027, dan pengguna harus bermigrasi ke Azure Sphere (Terintegrasi) saat ini. Gunakan pemilih Versi yang terletak di atas TOC untuk melihat dokumentasi Azure Sphere (Terintegrasi).

Berikut adalah beberapa langkah pemecahan masalah untuk masalah yang mungkin terjadi selama penginstalan dan penyiapan.

Masalah komunikasi perangkat

Kegagalan untuk terhubung ke perangkat dari komputer host dapat terjadi karena berbagai alasan dan dapat memicu salah satu dari beberapa pesan kesalahan, tergantung pada alat atau aplikasi mana yang menemukannya. Pesan kesalahan berikut mungkin menunjukkan koneksi yang gagal:

• An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
• Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
• An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
• Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
• Failed to establish communication with device after recovery.

Ada tiga komponen yang dapat menyebabkan masalah komunikasi perangkat: (1) antarmuka baris perintah itu sendiri; (2) layanan komunikasi perangkat (DCS) yang memfasilitasi komunikasi dengan perangkat; dan (3) perangkat.

Untuk mengisolasi penyebabnya, lakukan langkah-langkah diagnostik berikut:

1. Verifikasi bahwa Anda dapat berkomunikasi langsung dengan perangkat. Navigasikan ke https://192.168.35.2/status di browser web. Mengabaikan dan mengabaikan peringatan SSL yang disajikan. Anda akan melihat output yang mirip dengan: {"uptime":56} di jendela browser web.

Catatan

Anda juga dapat melakukan langkah ini dari baris perintah menggunakan curl https://192.168.35.2/status --insecure.

Catatan

Anda juga dapat melakukan langkah ini dari PowerShell (v6 atau lebih besar) Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck.

2. Konfirmasikan bahwa layanan komunikasi perangkat telah mendeteksi perangkat. Navigasikan ke http://localhost:48938/api/service/devices di browser web dan konfirmasikan setidaknya satu perangkat ditampilkan dalam output JSON.

Peringatan

Linux DCS hanya disertakan dalam rilis SDK 23.05 ke atas. Ikuti langkah-langkah pemecahan masalah warisan untuk SDK versi 22.11 dan yang lebih lama.

Catatan

Anda juga dapat melakukan langkah ini dari PowerShell melalui Invoke-WebRequest http://localhost:48938/api/service/devices.

Tidak dapat berkomunikasi langsung dengan perangkat dan perangkat tidak terdeteksi oleh DCS

Jika koneksi tidak dapat dibuat dengan perangkat (Langkah 1) dan perangkat tidak dapat dideteksi oleh DCS (Langkah 2), kemungkinan ada masalah dengan konfigurasi perangkat fisik.

Pertama, periksa perangkat telah terdeteksi oleh komputer.

Dari terminal:

1. Jalankan sudo lsusb. Verifikasi bahwa Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC muncul dalam output.

Menggunakan jendela PowerShell:

1. Jalankan Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId -match '^USB' }. Verifikasi bahwa Antarmuka STD MSFT MT3620 muncul dalam output.

Jika perintah sebelumnya tidak mengembalikan output yang diharapkan, sambungkan perangkat ke port USB yang berbeda. Jika ini masih tidak mengatasi masalah Anda, periksa apakah perangkat telah mengonfigurasi jumpernya dengan benar. Misalnya, Kit Pengembangan MT3620 yang Dilihat dikirim dari pabrik dengan header jumper di seluruh pin 2 dan 3 J3, yang mendukung jam dari catu daya utama. Periksa apakah header belum dilepas atau dihapus.

Tidak dapat berkomunikasi dengan perangkat secara langsung tetapi perangkat terdeteksi oleh DCS

Jika koneksi tidak dapat dibuat dengan perangkat (Langkah 1), tetapi perangkat telah terdeteksi oleh DCS (Langkah 2), kemungkinan layanan komunikasi perangkat atau perangkat dalam keadaan buruk.

Jika Anda baru saja menyambungkan perangkat ke Internet, dan sistem operasi perangkat kedaluarsa, perangkat mungkin menerapkan pembaruan OS. Ada juga kemungkinan kecil perangkat mengambil pembaruan OS jika waktu bertepatan dengan jendela rilis. Selama pembaruan sistem operasi, Anda tidak akan dapat berkomunikasi dengan perangkat.

Jika Anda menduga perangkat sudah diperbarui dan/atau tidak terhubung ke Internet, maka opsi terbaik berikutnya adalah mencabut dan menyambungkan kembali perangkat ke PC Anda. Hal ini akan menyebabkan DCS memperbarui koneksinya ke perangkat dan perangkat diatur ulang ke status awal.

Jika Anda tidak dapat mencabut dan menyambungkan kembali perangkat, opsi terbaik berikutnya adalah memulai ulang DCS. Dari terminal:

1. Jalankan sudo azspheredctl restart. Verifikasi bahwa perintah berhasil diselesaikan.
   1. Jika perintah gagal, jalankan sudo systemctl restart azsphered.

Jika Anda tidak dapat mencabut dan menyambungkan kembali perangkat, opsi terbaik berikutnya adalah mengeluarkan perintah rescan untuk DCS. Setelah menerima perintah ini, DCS akan melakukan siklus dan mengatur ulang chip antarmuka FTDI yang digunakan untuk berkomunikasi dengan MT3620. Menggunakan jendela PowerShell:

1. Jalankan azsphere device rescan-attached

Sekarang jalankan kembali perintah yang awalnya Anda coba. Jika masalah masih belum teratasi, opsi terbaik berikutnya adalah mencoba memulai ulang DCS. Dari jendela Powershell tingkat administrator:

1. Jalankan Restart-Service -Name AzureSphereDeviceCommunicationService. Verifikasi bahwa perintah berhasil diselesaikan.

Secara bergantian, mulai ulang DCS menggunakan antarmuka pengguna grafis.

1. Tekan Mulai dan masukkan Layanan. Klik kanan Azure Sphere Device Communication Service dan pilih Mulai Ulang.

Sekarang jalankan kembali perintah yang awalnya Anda coba.

Jika perintah terus gagal, atau perangkat azsphere yang terpasang daftar memiliki output yang mirip dengan:

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

Jalankan pemulihan perangkat azsphere

Dapat berkomunikasi dengan perangkat secara langsung dan perangkat terdeteksi oleh DCS

Ini kemungkinan menunjukkan masalah dengan CLI. Pastikan Anda memiliki versi terbaru SDK.

Jika Anda memiliki versi terbaru SDK dan masalah Anda masih belum teratasi, kirimkan pertanyaan ke forum Tanya Jawab Umum.

Koneksi yang terputus atau perangkat yang hilang

Jika komputer Anda dapat tersambung ke perangkat Azure Sphere, tetapi sering menghilangkan koneksi, Anda mungkin mengalami konflik di subnet IP.

Azure Sphere menggunakan subnet 192.168.35.*. Jika Anda memiliki perangkat lunak lain yang menggunakan subnet yang sama, nonaktifkan perangkat lunak tersebut atau batasi rentang alamat IP yang digunakannya. Saat ini, Anda tidak dapat mengubah rentang alamat IP yang digunakan Azure Sphere.

Tidak dapat menerapkan kemampuan perangkat

Jika Anda menerima kesalahan saat mencoba menerapkan kemampuan perangkat ke perangkat Azure Sphere, masalahnya mungkin OS di perangkat Anda sudah kedaluarsa. Masalah ini dapat terjadi jika perangkat telah offline untuk jangka waktu yang lama, di mana Microsoft memperbarui kunci internalnya. Kesalahan berikut adalah gejala masalah ini:

Perintah azsphere device enable-development atau azsphere device enable-cloud-test mengembalikan kesalahan yang mirip dengan yang berikut ini:

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'azsphere device show-deployment-status'.

Perintah pembaruan kemampuan perangkat azsphere mengembalikan kesalahan yang mirip dengan yang berikut ini:

error: Could not apply device capability configuration to device.

Hal ini disebabkan oleh keystore tepercaya pada perangkat yang kedaluarsa. Untuk mengatasi masalah ini, ikuti instruksi di sini.

Kegagalan untuk membuat empat pengonversi serial USB

Setelah menyiapkan papan pengembangan MT3620, Anda akan melihat empat pengonversi serial USB di Device Manager. Jika Anda melihat kurang dari empat, Anda mungkin memiliki masalah dengan driver FTDI.

Catatan

Jika papan ini sebelumnya telah digunakan untuk pengembangan RTApp, Anda mungkin melihat tiga konverter alih-alih empat. Ini normal dan tidak mewakili kesalahan.

Jika driver FTDI tidak diinstal dengan benar, pengonversi mungkin muncul di lokasi yang salah, seperti Perangkat lain, atau mungkin tidak muncul sama sekali.

Untuk mengatasi masalah ini:

1. Untuk membuka Manajer Perangkat, klik Mulai dan masukkan Manajer Perangkat.

2. Di bawah Pengontrol Universal Serial Bus, pilih USB Serial Converter A. Klik kanan nama, pilih Hapus Instalan Perangkat, dan hapus driver jika diberikan opsi:

   

   Ulangi langkah ini untuk USB Serial Converter B melalui USB Serial Converter D.

3. Cabut papan pengembangan dari PC Dan colokkan kembali. "MSFT MT3620 Std Interface" akan muncul dengan ikon peringatan segitiga, yang menunjukkan tidak ada driver yang tersedia.

4. Klik kanan salah satu perangkat Antarmuka Std MSFT MT3620 dan pilih Perbarui driver. Pilih Cari perangkat lunak pengandar yang diperbarui secara otomatis. Memperbarui seseorang harus memperbaiki semuanya. Anda sekarang akan melihat empat pengonversi serial USB di bagian pengontrol Universal Serial Bus. Jika keempat konverter tidak muncul, ulangi langkah ini untuk setiap pengonversi.

Gagal menginstal driver FTDI

Driver FTDI harus diunduh dan diinstal secara otomatis oleh Windows ketika perangkat Azure Sphere Anda pertama kali dicolokkan ke PC Anda. Jika driver diinstal dengan benar, Anda akan melihat empat Usb Serial Converters tercantum di bawah pengontrol Universal Serial Bus di Device Manager, seperti yang dijelaskan dalam Menyiapkan dev kit Anda.

Windows 10, versi 2004, tidak mencari driver. Dalam hal ini, driver tidak diunduh dan diinstal secara otomatis dan Anda akan melihat item berikut yang tercantum di Manajer Perangkat:

Untuk menginstal driver, unduh driver secara manual dari Future Technology Devices International (FTDI). Pilih driver yang cocok dengan penginstalan Windows Anda (32- atau 64-bit).

Untuk tanggal ketersediaan dan nomor build versi Windows 10, lihat informasi rilis Windows 10. Informasi ini dapat membantu Anda menentukan apakah versi Windows 10 Anda lebih lama atau lebih baru dari versi 2004.

Masalah koneksi yang disebabkan oleh konfigurasi adaptor TAP-Windows

Alat Azure Sphere berkomunikasi dengan papan pengembangan terlampir dengan menggunakan jaringan IP melalui USB. Ini memerlukan adaptor TAP-Windows dari OpenVPN Technologies. Prosedur penginstalan Azure Sphere SDK menginstal adaptor ini di PC Anda jika belum ada.

Dua jenis masalah berbeda telah dilaporkan dengan adaptor TAP-Windows:

• Jika versi adaptor TAP-Windows yang berbeda sudah diinstal, atau jika perangkat Azure Sphere tidak tersambung ke instans pertama adaptor TAP-Windows, alat Azure Sphere mungkin gagal tersambung ke perangkat Anda.

• Jika Anda menggunakan jaringan privat virtual (VPN) Cisco AnyConnect, adaptor TAP-Windows Anda mungkin tampak tidak terpasang dan komunikasi perangkat mungkin tidak berfungsi. Ini karena VPN dapat mengalihkan lalu lintas dari alamat IP adaptor TAP.

Pastikan perangkat Azure Sphere tersambung ke adaptor TAP-Windows yang sesuai

Untuk menentukan apakah masalah terkait dengan adaptor TAP, pertama-tama cari tahu berapa banyak adaptor TAP yang diinstal di PC Anda, lalu ubah penginstalan jika perlu.

Untuk menentukan berapa banyak adaptor TAP yang diinstal pada PC Anda:

1. Buka Pengaturan Windows dan pilih grup Jaringan & Internet .

2. Di bawah Pengaturan jaringan tingkat lanjut, pilih Ubah opsi adaptor. Anda hanya akan melihat satu adaptor TAP, seperti yang ditunjukkan pada cuplikan layar berikut:

   

   Jika Anda melihat lebih dari satu adaptor TAP, atau jika Anda hanya melihat satu adaptor TAP tetapi namanya bukan Azure Sphere, ikuti langkah-langkah ini untuk menghapus instalan semua adaptor TAP dan menginstal ulang SDK. Jika Anda tidak melihat adaptor TAP, instal ulang SDK.

Untuk menghapus instalan adaptor TAP:

1. Klik Mulai dan masukkan Manajer Perangkat.

2. Di Manajer Perangkat, buka Adaptor Jaringan dan pilih adaptor TAP-Windows:

   

3. Klik kanan adaptor TAP-Windows dan pilih Hapus Instalan Perangkat. Dalam kotak dialog, pilih Hapus perangkat lunak pengandar untuk perangkat ini, lalu klik Hapus instalan.

4. Buka perintah sebagai Administrator dan jalankan skrip penginstal Powershell berikut ini:

    powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
   

5. Jika penginstalan berhasil, mulai ulang Azure Sphere Device Communication Service:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Instal ulang Azure Sphere SDK.

Memperbaiki status yang dicabut saat menggunakan klien VPN Cisco AnyConnect

Saat Anda menggunakan klien Cisco AnyConnect VPN, adaptor TAP-Windows mungkin tampak tidak terpasang dan komunikasi perangkat mungkin tidak berfungsi. Anda dapat memperbaiki masalah sebagai berikut:

1. Pastikan Anda memiliki hak administrator pada komputer Anda.

2. Buka Pengaturan Windows dan pilih grup Jaringan & Internet .

3. Di bawah Pengaturan jaringan tingkat lanjut, pilih Ubah opsi adaptor.

4. Klik kanan Azure Sphere TAP-Windows Adapter V9 dan pilih Properti.

5. Pada tab Jaringan , temukan entri Driver Filter Pengelola Akses Jaringan Cisco AnyConnect dan hapus item.

   

6. Pilih OK untuk menyimpan pengaturan dan keluar dari properti.

7. Periksa apakah komunikasi dengan perangkat Azure Sphere Anda sekarang berfungsi dengan membuka prompt perintah dan memasukkan azsphere device show-attached perintah.

Perangkat tidak merespons

Satu atau beberapa kesalahan berikut dari perintah azsphere mungkin menunjukkan bahwa Azure Sphere Device Communication Service gagal dimulai:

• warn: Device is not responding. Could not perform version check.​
• Device is not responding. Cannot get device ID.​
• error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
• error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

Pastikan Anda telah melakukan langkah-langkah pemecahan masalah komunikasi perangkat.

Jika masalah Anda masih belum teratasi dan komputer Anda baru-baru ini melakukan pembaruan Windows, layanan komunikasi perangkat mungkin gagal dimulai setelah pembaruan Windows dan jika salah satu file pengaturan JSON internal atau file konfigurasi telah rusak.

Kegagalan setelah Windows Update

Kesalahan ini dapat terjadi setelah Anda memperbarui Windows pada PC Anda. Terkadang Windows Update menghapus instalan driver FTDI yang diperlukan untuk layanan komunikasi.

Untuk mengatasi masalah:

1. Cabut perangkat Azure Sphere dari USB dan colokkan lagi. Setelah meniru perangkat, driver yang benar harus menginstal ulang.
2. Jika mencabut dan mereplugging perangkat gagal memperbaiki masalah, hapus instalan dan instal ulang Azure Sphere SDK.

File JSON

Jika Anda belum memperbarui Windows baru-baru ini, penyebab kesalahannya mungkin adalah restore.json file yang digunakan untuk layanan.

Untuk mengatasi masalah ini:

1. Simpan salinan file berikut:

   c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

2. Hapus file dari lokasi aslinya.

3. Hentikan lalu mulai ulang Azure Sphere Device Communication Service:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

File konfigurasi rusak

Jika kesalahan dilaporkan ketika Anda mencoba menjalankan perintah, file konfigurasi yang rusak mungkin mencegah perangkat Anda berjalan dengan benar.

Untuk mengatasi masalah ini, hapus file konfigurasi yang rusak yang terletak di .azsphere\config pada Windows atau ~/.azsphere/config di Linux.

Windows mengalami crash saat mencolokkan atau mencolokkan perangkat

Papan pengembang MT3620 memiliki chip FT4232HQ Future Technology Devices International (FTDI), yang memfasilitasi komunikasi antara perangkat dan PC. Driver FTDI resmi, Combined Driver Model (CMD), berisi dua driver: satu menyediakan akses melalui D2XX API, dan yang lainnya menyediakan Virtual Com Port (VCP) untuk perangkat yang sama. Kedua driver diinstal secara default jika chip FTDI mengaktifkan mode VCP. Ini dapat menyebabkan Windows crash ketika chip di-siklus daya.

Untuk mengatasi masalah ini, Anda dapat menonaktifkan mode VCP untuk chip FTDI. Anda harus menggunakan alat FT_PROG untuk memprogram ulang EEPROM chip FTDI.

1. Lihat alat pemrograman FT_PROG FTDI untuk mengetahui cara mengunduh dan menginstal alat ini.

2. Jalankan FT_PROG dan temukan perangkat terpasang Anda, seperti yang dijelaskan dalam aplikasi GUI FT_PROG.

3. Dalam tampilan Pohon Perangkat, perluas bagian Spesifik Perangkat Keras. Anda akan melihat empat port.

   

4. Pilih Port A dan pilih D2XX Direct alih-alih Port Com Virtual.

   

5. Ulangi langkah sebelumnya untuk Port C dan Port D. Port B harus sudah berada dalam mode D2XX Direct.

6. Pilih ikon Perangkat Program (mirip petir) untuk memasuki mode pemrograman.

   

7. Pilih Program untuk memprogram EEPROM, lalu tunggu hingga selesai.

   

8. Cabut perangkat Anda dari port USB, lalu sambungkan kembali ke siklus daya perangkat dan menyebabkan perubahan diterapkan. Di Windows Device Manager, bagian Port (COM & LPT) sekarang harus menampilkan tiga port COM yang lebih sedikit. Jumlah perangkat Universal Serial Bus harus tetap sama.

Koneksi hilang ke perangkat FTDI non-Azure Sphere setelah mengaktifkan debug RTApp

Beberapa pengguna Azure Sphere telah melaporkan bahwa mereka tidak dapat lagi berkomunikasi dengan perangkat FTDI non-Azure Sphere terlampir lainnya setelah mereka menggunakan perintah azsphere device enable-development --enable-rt-core-debugging untuk mengembangkan dan men-debug RTApps dari PC host mereka.

Misalnya, jika Anda memiliki perangkat Azure Sphere dan perangkat FTDI yang berbeda yang terpasang pada PC, Anda mungkin melihat dua Pengontrol Serial Universal bernama perangkat USB Serial Converter B di Windows Device Manager sebelum menjalankan perintah.

Setelah menjalankan perintah, kedua perangkat USB Serial Converter B menghilang dari bagian pengontrol Universal Serial Bus dan dua perangkat baru muncul di tampilan perangkat Universal Serial Bus di Device Manager.

Penyebab

Masalah ini terjadi karena perintah azsphere device enable-development --enable-rt-core-debugging menginstal driver baru untuk Port B chip FTDI pada MT3620; port kemudian menjadi MSFT MT3620 Std Interface. Namun, penginstalan driver ini secara tidak sengaja mengubah driver untuk Port B dari perangkat non-Azure Sphere lainnya. Karena keterbatasan di pustaka yang mendasar, semua perangkat FTDI dengan VID (0x0403) dan PID (0x6011) yang sama akan menggantikan driver Port B mereka.

Solusi

Ikuti langkah-langkah ini untuk mengembalikan driver secara manual untuk perangkat non-Azure Sphere ke versi sebelumnya:

1. Di Device Manager, pilih perangkat non-Azure Sphere (FTDI Quad GZ lain dalam contoh), lalu klik kanan dan pilih Perbarui driver.

2. Di Perbarui Driver, pilih Telusuri komputer saya untuk mencari perangkat lunak driver.

   

3. Pilih Izinkan saya memilih dari daftar driver yang tersedia di komputer saya.

   

4. Pilih driver USB Serial Converter B dari daftar, lalu klik Berikutnya.

   

5. Klik Tutup di jendela konfirmasi.

6. Manajer Perangkat harus menunjukkan Port B untuk perangkat FTDI lainnya sebagai USB Serial Converter B, yang menunjukkan bahwa ia menggunakan driver FTDI resmi. Driver untuk MT3620 tetap MSFT MT3620 Std Interface.

   

Informasi Tambahan

• Jika Anda mencolokkan perangkat FTDI non-Azure Sphere baru lain setelah menjalankan perintah azsphere device enable-development --enable-rt-core-debugging , perangkat tersebut akan diberi driver Azure Sphere MT3620 dengan cara yang sama. Ulangi langkah-langkah di atas untuk mengembalikan perangkat ke driver FTDI resmi.

• Jika Anda mencabut dan menyambungkan kembali perangkat FTDI non-Azure Sphere setelah Anda mengembalikannya ke driver FTDI resmi, perangkat akan menyimpan driver FTDI resmi.

• Jika Anda menjalankan perintah azsphere device enable-development --enable-rt-core-debugging lagi setelah Anda mengembalikan driver, perangkat FTDI non-Azure Sphere akan sekali lagi mengganti drivernya, dan Anda harus mengikuti langkah-langkah dalam Solusi untuk kembali ke driver FTDI resmi. Ini terjadi terlepas dari apakah perangkat FTDI non-Azure Sphere dilampirkan ke PC ketika perintah azsphere device enable-development --enable-rt-core-debugging dijalankan.

Perintah tidak dikenali

Jika Anda melihat kesalahan berikut saat memasukkan perintah azsphere, pastikan Anda menggunakan PowerShell atau prompt perintah standar di Windows.

'azsphere' is not recognized as an internal or external command, operable program or batch file.

Alat penginstal menggantung pada 60 persen

Alat penginstal macet pada 60%, dan Anda diberitahu bahwa Device Communication Service gagal dimulai. Ini biasanya terjadi ketika penginstalan driver TAP gagal dengan cara yang aneh, meninggalkan sistem dalam keadaan yang tidak ditentukan.

Konfirmasikan bahwa masalahnya adalah driver TAP

1. Buka Pemantau Peristiwa Windows untuk memeriksa log.

2. Lihat di log Aplikasi dan log Azure Sphere Device Communication Service untuk pesan kesalahan berikut:

   "SerialSlipToTun.TunInterfaceSetupException: Pengaturan registri tun akses kesalahan ---> System.Collections.Generic.KeyNotFoundException: Perangkat ketuk tun tidak ditemukan ---> System.Security.SecurityException: Akses registri yang diminta tidak diizinkan."

   

3. Saat memeriksa log Aplikasi, filter log untuk menghindari melihat banyak pesan yang tidak terkait. Pada tab Tindakan , pilih Filter Log Saat Ini.

4. Pilih Kesalahan, lalu pilih AzureSphereDeviceCommunicationService untuk mencantumkan hanya pesan kesalahan dari Azure Sphere Device Communication Service.

   

5. Jika Anda tidak dapat menemukan kesalahan di log Aplikasi atau log Azure Sphere Device Communication Service, ini mungkin bukan masalah driver TAP.

Untuk mengatasi masalah driver TAP, ikuti langkah-langkah berikut:

1. Buka Pusat Jaringan dan Berbagi dan pilih Ubah pengaturan adaptor.

   

2. Di Koneksi Jaringan di bawah Azure Sphere, pilih TAP-WIndows Adapter V9 dan buka propertinya.

   

3. Di Properti Azure Sphere, pilih Protokol Internet Versi 4 (TCP/IPv4), lalu pilih Properti untuk melihat pengaturan protokol.

   

4. Pastikan bahwa alamat IP diatur ke 192.168.35.1 dan subnet mask diatur ke 255.255.255.0.

5. Coba penginstal lagi. Jika masih macet, coba reset koneksi jaringan Anda. Untuk melakukan reset, buka Pengaturan>Jaringan & Status Internet>dan pilih Reset jaringan di dekat bagian bawah halaman.

   Penting

   Mereset jaringan Anda akan mereset semua pengaturan jaringan.

Menghentikan Azure Sphere Device Communication Service

Jika penginstal macet, Anda dapat menghentikan Azure Sphere Device Communication Service menggunakan perintah taskkill .

Ikuti langkah-langkah ini:

1. Salin PID untuk AzureSphereDeviceCommunicationService.

   • Buka tab Layanan Pengelola>Tugas dan catat PID untuk layanan AzureSphereDeviceCommunicationService, atau
   • Di baris perintah, ketik tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" dan salin PID dari output.

2. Ketik yang berikut ini di baris perintah untuk mengakhiri layanan. Perintah taskkill mengakhiri proses yang sesuai dengan nomor ID proses. Opsi /f ini digunakan untuk mengakhiri proses dengan paksa.

   taskkill /PID <DCS_PID> /f

3. Coba penginstal lagi.

Tidak dapat menghentikan Azure Sphere Device Communication Service

Saat memutakhirkan Azure Sphere SDK yang ada, Anda mungkin melihat pesan yang mengatakan "Layanan 'Azure Sphere Device Communication Service' (AzureSphereDeviceCommunicationService) tidak dapat dihentikan. Verifikasi bahwa Anda memiliki hak istimewa yang memadai untuk menghentikan layanan sistem." Jika Anda menerima pesan ini, boot ulang dan jalankan alat penginstal lagi.

Komunikasi perangkat rusak saat penerowongan terpisah digunakan

Ketika komputer pengembangan terhubung ke VPN perusahaan dan penerowongan terpisah dinonaktifkan oleh konfigurasi VPN, komputer pengembangan mungkin tidak dapat berkomunikasi dengan perangkat Azure Sphere.

Untuk mengatasi masalah ini, lakukan salah satu metode berikut:

• Putuskan sambungan dari VPN perusahaan dan coba koneksi ke perangkat Azure Sphere lagi.
• Ubah konfigurasi VPN untuk memungkinkan penerowongan terpisah.

Masalah komunikasi juga dapat disebabkan oleh konfigurasi adaptor TAP-Windows. Lihat bagian Pemecahan masalah Masalah koneksi yang disebabkan oleh pemecahan masalah konfigurasi adaptor TAP-Windows.

Tidak dapat menginstal atau menghapus instalan Azure Sphere SDK di Windows 11

Setelah memutakhirkan ke Windows 11, pengguna tidak dapat menginstal atau menghapus instalan Azure Sphere SDK. Untuk mengatasi masalah ini, instal versi terbaru Azure Sphere SDK untuk Windows. Setelah menginstal 21.07 Pembaruan 2 atau yang lebih baru, Anda akan dapat menghapus instalan SDK.

Tidak dapat mengkompilasi atau men-debug RTApps

Jika CMake melaporkan kesalahan saat menemukan toolchain atau openocd saat Anda mencoba membangun atau men-debug RTApp, pastikan bahwa:

• Anda telah menginstal Toolchain GNU Arm Embedded untuk lingkungan pengembangan Anda.
• Anda telah menentukan jalur yang benar ke openocd seperti yang dijelaskan dalam Tutorial: Membangun aplikasi berkemampukan real time.

Pemecahan masalah komunikasi perangkat pra-23.05

Peringatan

Langkah-langkah ini untuk pengguna dengan SDK versi 22.11 atau yang lebih lama. Verifikasi versi SDK yang diinstal adalah 22.11 atau yang lebih lama dengan menjalankan azsphere show-version.

Pada sistem Linux yang menjalankan SDK versi 22.11 atau yang lebih lama, skrip azsphere_connect.sh perlu dijalankan setiap kali Anda mencolokkan perangkat atau mencabut atau mencabutnya. Skrip merefresh koneksi perangkat dan menelurkan driver kernel yang memetakan lalu lintas jaringan ke perangkat.

Jika Anda mengalami masalah komunikasi, mulailah dengan langkah-langkah dasar berikut:

1. Pastikan perangkat terhubung oleh USB.

2. Jalankan skrip azsphere_connect.sh , jika Anda belum melakukannya.

3. Verifikasi bahwa Anda dapat berkomunikasi langsung dengan perangkat. Navigasikan ke https://192.168.35.2/status di browser web. Mengabaikan dan mengabaikan peringatan SSL yang disajikan. Anda akan melihat output yang mirip dengan: {"uptime":56} di jendela browser web.

Catatan

Anda juga dapat melakukan langkah ini dari baris perintah menggunakan curl https://192.168.35.2/status --insecure.

1. Jika kesalahan berlanjut, cabut perangkat dari port USB, colokkan lagi, dan tunggu hingga perangkat dimulai ulang. Kemudian jalankan skrip azsphere_connect.sh .

2. Jika kesalahan berlanjut, pastikan tidak ada konflik subnet dengan alat jaringan lainnya.