hardware-definition
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Gestisce le definizioni dell'hardware per i dispositivi Azure Sphere.
| Operazione | Descrizione |
|---|---|
| generate-header | Genera un file di intestazione C corrispondente a una definizione hardware e lo inserisce nella cartella inc/hw rispetto al codice JSON di input. |
| test-header | Verifica che il file di intestazione C nella cartella inc/hw sia aggiornato rispetto al codice JSON di input. |
generate-header
Genera un file di intestazione C corrispondente a una definizione hardware e lo inserisce nella cartella inc/hw rispetto al codice JSON di input.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --hardware-definition-file | Percorso | Specifica il nome e il percorso di un file JSON di definizione hardware. È possibile specificare un percorso relativo o assoluto. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
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
Verifica che il file di intestazione C nella cartella inc/hw sia aggiornato rispetto al codice JSON di input.
Parametri obbligatori
| Parametro | Tipo | Descrizione |
|---|---|---|
| --hardware-definition-file | Percorso | Specifica il nome e il percorso di un file JSON di definizione hardware. Il percorso del file può essere un percorso assoluto o relativo. |
Parametri globali
Per l'interfaccia della riga di comando di Azure Sphere sono disponibili i parametri globali seguenti:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione. |
| -h, --help | Stampa informazioni di riferimento sull'interfaccia della riga di comando sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Visualizza solo gli errori, eliminando gli avvisi. |
| -o, --output | Modifica il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori delimitati da tabulazioni), tabella (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato table. Per altre informazioni sui formati di output disponibili, vedere Formato di output per i comandi dell'interfaccia della riga di comando di Azure Sphere. |
| --query | Usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di sicurezza di Azure Sphere. Per altre informazioni ed esempi, vedere Esercitazione su JMESPath e Eseguire query sull'output dei comandi dell'interfaccia della riga di comando di Azure. |
| --verbose | Stampa informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Usare --debug per i log di debug completi. |
Nota
Se si usa l'interfaccia della riga di comando classica di Azure Sphere, vedere Parametri globali per altre informazioni sulle opzioni disponibili.
Esempio
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