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