Usare le proprietà in una soluzione Azure IoT Central
Questa guida pratica illustra come usare le proprietà del dispositivo definite in un modello di dispositivo nell'applicazione Azure IoT Central.
Le proprietà rappresentano valori temporizzati. Ad esempio, un dispositivo potrebbe usare una proprietà per segnalare la temperatura di destinazione che sta tentando di raggiungere. Per impostazione predefinita, le proprietà del dispositivo sono di sola lettura in IoT Central. Le proprietà scrivibili consentono di sincronizzare lo stato tra il dispositivo e l'applicazione Azure IoT Central.
È anche possibile definire le proprietà cloud in un'applicazione Azure IoT Central. I valori delle proprietà cloud non vengono mai scambiati con un dispositivo e non rientrano nell'ambito di questo articolo.
Per informazioni sulle convenzioni delle proprietà IoT Pug e Play, vedere convenzioni di Plug and Play IoT.
Per altre informazioni sui dati delle proprietà che un dispositivo scambia con IoT Central, vedere Payload di telemetria, proprietà e comandi.
Per informazioni su come gestire le proprietà usando l'API REST di IoT Central, vedere Come usare l'API REST di IoT Central per controllare i dispositivi.
Definire le proprietà
Le proprietà sono campi dati che rappresentano lo stato del dispositivo. Usare le proprietà per rappresentare lo stato durevole del dispositivo, ad esempio lo stato on/off di un dispositivo. Le proprietà possono anche rappresentare proprietà di base del dispositivo, ad esempio la versione software del dispositivo. Le proprietà vengono dichiarate in sola lettura o scrivibili.
Lo screenshot seguente mostra una definizione di proprietà in un'applicazione Azure IoT Central.
La tabella seguente illustra le impostazioni di configurazione per una funzionalità di proprietà.
| Campo | Descrzione |
|---|---|
| Display name | Nome visualizzato per il valore della proprietà usato nei riquadri del dashboard e nei moduli del dispositivo. |
| Nome | Nome della proprietà. Azure IoT Central genera un valore per questo campo dal nome visualizzato, ma è possibile scegliere il proprio valore, se necessario. Questo campo deve essere alfanumerico. Il codice del dispositivo usa questo valore Name . |
| Tipo di funzionalità | Proprietà. |
| Tipo semantico | Tipo semantico della proprietà, ad esempio temperatura, stato o evento. La scelta del tipo semantico determina quali tra i campi seguenti sono disponibili. |
| Schema | Tipo di dati della proprietà, ad esempio double, stringa o vettore. Il tipo semantico determina le scelte disponibili. Lo schema non è disponibile per i tipi semantici stato ed evento. |
| Scrivibile | Se la proprietà non è scrivibile, il dispositivo può segnalare i valori delle proprietà ad Azure IoT Central. Se la proprietà è scrivibile, il dispositivo può segnalare i valori delle proprietà ad Azure IoT Central. Azure IoT Central può quindi inviare aggiornamenti delle proprietà al dispositivo. |
| Gravità | Disponibile solo per il tipo semantico evento. I livelli di gravità sono Errore, Informazioni o Avviso. |
| Valori di stato | Disponibile solo per il tipo semantico stato. Definisce i valori di stato possibili, ognuno dei quali ha un nome visualizzato, un nome, un tipo di enumerazione e un valore. |
| Unità | Un'unità per il valore della proprietà, come mph, % o °C. |
| Unità di visualizzazione | Unità di visualizzazione da usare nei riquadri dei dashboard e nei moduli dei dispositivi. |
| Comment | Eventuali commenti sulla funzionalità della proprietà. |
| Descrizione | Descrizione della funzionalità della proprietà. |
Per informazioni sul linguaggio DTDL (Digital Twin Definition Language) usato da Azure IoT Central per definire le proprietà in un modello di dispositivo, vedere Plug and Play IoT convenzioni > di sola lettura.
Campi facoltativi, ad esempio nome visualizzato e descrizione, consentono di aggiungere altri dettagli all'interfaccia e alle funzionalità.
Quando si crea una proprietà, è possibile specificare tipi di schema complessi, ad esempio Object ed Enum.
Quando si seleziona lo schema complesso, ad esempio Object, è necessario definire lo schema dell'oggetto.
Implementare le proprietà di sola lettura
Per impostazione predefinita, le proprietà sono di sola lettura. Le proprietà di sola lettura consentono a un dispositivo di segnalare gli aggiornamenti del valore della proprietà all'applicazione Azure IoT Central. L'applicazione Azure IoT Central non può impostare il valore di una proprietà di sola lettura.
Azure IoT Central usa dispositivi gemelli per sincronizzare i valori delle proprietà tra il dispositivo e l'applicazione Azure IoT Central. I valori delle proprietà del dispositivo usano le proprietà segnalate del dispositivo gemello. Per altre informazioni, vedere Dispositivi gemelli.
Un dispositivo invia gli aggiornamenti delle proprietà come payload JSON. Per altre informazioni, vedere Telemetria, proprietà e payload dei comandi.
È possibile usare Azure IoT SDK per dispositivi per inviare un aggiornamento delle proprietà all'applicazione Azure IoT Central.
Ad esempio, le implementazioni in più linguaggi, vedere Creare e connettere un'applicazione client all'applicazione Azure IoT Central.
La visualizzazione seguente nell'applicazione Azure IoT Central mostra le proprietà di sola lettura del dispositivo:
Implementare proprietà scrivibili
Un operatore IoT Central imposta le proprietà scrivibili in una maschera. Azure IoT Central invia la proprietà al dispositivo. Azure IoT Central prevede un riconoscimento dal dispositivo.
Ad esempio, le implementazioni in più linguaggi, vedere Creare e connettere un'applicazione client all'applicazione Azure IoT Central.
Il messaggio di risposta deve includere i ac campi e av . Il campo ad è facoltativo. Per altre informazioni, vedere convenzioni di Plug and Play IoT > proprietà scrivibili.
Quando l'operatore imposta una proprietà scrivibile nell'interfaccia utente di Azure IoT Central, l'applicazione usa una proprietà desiderata del dispositivo gemello per inviare il valore al dispositivo. Il dispositivo risponde quindi usando una proprietà segnalata del dispositivo gemello. Quando Azure IoT Central riceve il valore della proprietà segnalata, aggiorna la visualizzazione delle proprietà con lo stato Accettato.
Quando si immette il valore e si seleziona Salva, lo stato iniziale è In sospeso. Quando il dispositivo accetta la modifica, lo stato diventa Accettato.
Usare le proprietà nei dispositivi non assegnati
È possibile visualizzare e aggiornare le proprietà scrivibili in un dispositivo che non è assegnato a un modello di dispositivo.
Per visualizzare le proprietà esistenti in un dispositivo non assegnato, passare al dispositivo nella sezione Dispositivi , selezionare Gestisci dispositivo e quindi Proprietà dispositivo:
È possibile aggiornare le proprietà scrivibili in questa visualizzazione:
Passaggi successivi
Dopo aver appreso come usare le proprietà nell'applicazione Azure IoT Central, vedere: