Aracılığıyla paylaş

donanım tanımı

Önemli

Bu, Azure Sphere (Eski) belgeleridir. Azure Sphere (Eski) 27 Eylül 2027'de kullanımdan kaldırılıyor ve kullanıcıların bu zamana kadar Azure Sphere'e (Tümleşik) geçmeleri gerekiyor. Azure Sphere (Tümleşik) belgelerini görüntülemek için İçindekiler tablosu üzerinde bulunan Sürüm seçiciyi kullanın.

Azure Sphere cihazları için donanım tanımlarını yönetir.

Operasyon Açıklama
generate-header Bir donanım tanımına karşılık gelen bir C üst bilgi dosyası oluşturur ve bunu giriş JSON'sine göre inc/hw klasörüne yerleştirir.
test üst bilgisi inc/hw klasöründeki C üst bilgi dosyasının giriş JSON ile ilgili olarak güncel olduğunu test edin.

generate-header

Bir donanım tanımına karşılık gelen bir C üst bilgi dosyası oluşturur ve bunu giriş JSON'sine göre inc/hw klasörüne yerleştirir.

Gerekli parametreler

Parametre Tür Açıklama
--hardware-definition-file Yol Bir donanım tanımı JSON dosyasının adını ve yolunu belirtir. Göreli veya mutlak bir yol sağlayabilirsiniz.
Genel parametreler

Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:

Parametre Açıklama
--hata ayıklama Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın.
-h, --help Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler.
--only-show-errors Yalnızca hataları gösterir ve uyarıları gizler.
-o, --output Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi.
--sorgu Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama.
--Ayrıntılı Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın.

Örnek

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 üst bilgisi

inc/hw klasöründeki C üst bilgi dosyasının giriş JSON ile ilgili olarak güncel olduğunu test edin.

Gerekli parametreler

Parametre Tür Açıklama
--hardware-definition-file Yol Bir donanım tanımı JSON dosyasının adını ve yolunu belirtir. Dosya yolu mutlak veya göreli bir yol olabilir.
Genel parametreler

Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:

Parametre Açıklama
--hata ayıklama Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın.
-h, --help Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler.
--only-show-errors Yalnızca hataları gösterir ve uyarıları gizler.
-o, --output Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi.
--sorgu Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama.
--Ayrıntılı Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın.

Örnek

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