Udostępnij za pośrednictwem


definicja sprzętu

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

Zarządza definicjami sprzętu dla urządzeń usługi Azure Sphere.

Działanie opis
generate-header Generuje plik nagłówka języka C odpowiadający definicji sprzętu i umieszcza go w folderze inc/hw względem wejściowego kodu JSON.
nagłówek testowy Sprawdza, czy plik nagłówka języka C w folderze inc/hw jest aktualny w odniesieniu do wejściowego kodu JSON.

generate-header

Generuje plik nagłówka języka C odpowiadający definicji sprzętu i umieszcza go w folderze inc/hw względem wejściowego kodu JSON.

Parametry wymagane

Parametr Type Opis
--hardware-definition-file Ścieżka Określa nazwę i ścieżkę do pliku JSON definicji sprzętu. Możesz podać ścieżkę względną lub bezwzględną.
Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr Opis
--debugować Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Uwaga

Jeśli używasz klasycznego interfejsu wiersza polecenia usługi Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.

Przykład

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

nagłówek testowy

Sprawdza, czy plik nagłówka języka C w folderze inc/hw jest aktualny w odniesieniu do wejściowego kodu JSON.

Parametry wymagane

Parametr Type Opis
--hardware-definition-file Ścieżka Określa nazwę i ścieżkę do pliku JSON definicji sprzętu. Ścieżka pliku może być ścieżką bezwzględną lub względną.
Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr Opis
--debugować Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Uwaga

Jeśli używasz klasycznego interfejsu wiersza polecenia usługi Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.

Przykład

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