definisi perangkat keras
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).
Mengelola definisi perangkat keras untuk perangkat Azure Sphere.
| Operasi | Deskripsi |
|---|---|
| generate-header | Menghasilkan file header C yang sesuai dengan definisi perangkat keras dan menempatkannya di folder inc/hw relatif terhadap input JSON. |
| test-header | Menguji bahwa file header C di folder inc/hw sudah diperbarui sehubungan dengan input JSON. |
generate-header
Menghasilkan file header C yang sesuai dengan definisi perangkat keras dan menempatkannya di folder inc/hw relatif terhadap input JSON.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| --hardware-definition-file | Jalur | Menentukan nama dan jalur ke file JSON definisi perangkat keras. Anda dapat menyediakan jalur relatif atau absolut. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere hardware-definition generate-header --hardware-definition-file C:\AppSamples\HardwareDefinitions\seeed_mt3620_mdb\sample_appliance.json
Generated header file at C:/AppSamples/HardwareDefinitions/seeed_mt3620_mdb/inc/hw/sample_appliance.h based on hardware definition at C:\AppSamples\HardwareDefinitions\seeed_mt3620_mdb\sample_appliance.json
test-header
Menguji bahwa file header C di folder inc/hw sudah diperbarui sehubungan dengan input JSON.
Parameter yang diperlukan
| Parameter | Jenis | Deskripsi |
|---|---|---|
| --hardware-definition-file | Jalur | Menentukan nama dan jalur ke file JSON definisi perangkat keras. Jalur file bisa menjadi jalur absolut atau relatif. |
Parameter global
Parameter global berikut tersedia untuk Azure Sphere CLI:
| Parameter | Deskripsi |
|---|---|
| --debug | Meningkatkan verbositas pengelogan untuk menampilkan semua log debug. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera --debug saat menyerahkan laporan bug. |
| -h, --help | Mencetak informasi referensi CLI tentang perintah dan argumennya serta mencantumkan subgrup dan perintah yang tersedia. |
| --only-show-errors | Hanya menampilkan kesalahan, menyembunyikan peringatan. |
| -o, --output | Mengubah format output. Format output yang tersedia adalah json, jsonc (JSON berwarna), tsv (Nilai Yang Dipisahkan Tab), tabel (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan table. Untuk mempelajari selengkapnya tentang format output yang tersedia, lihat Format output untuk perintah Azure Sphere CLI. |
| --query | Menggunakan bahasa kueri JMESPath untuk memfilter output yang dikembalikan dari Azure Sphere Security Services. Lihat tutorial JMESPath dan Output perintah Query Azure CLI untuk informasi dan contoh selengkapnya. |
| --verbose | Mencetak informasi tentang sumber daya yang dibuat di Azure Sphere selama operasi dan informasi berguna lainnya. Gunakan --debug untuk log debug yang lengkap. |
Catatan
Jika Anda menggunakan CLI klasik Azure Sphere, lihat Parameter global untuk informasi selengkapnya tentang opsi yang tersedia.
Contoh
azsphere hardware-definition test-header --hardware-definition-file "C:\Program Files (x86)\Microsoft Azure Sphere SDK\HardwareDefinitions\mt3620.json"
Hardware definition at C:\Program Files (x86)\Microsoft Azure Sphere SDK\HardwareDefinitions\mt3620.json is consistent with header at C:/Program Files (x86)/Microsoft Azure Sphere SDK/HardwareDefinitions/inc/hw/mt3620.h