Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 puntuali. Ad esempio, un dispositivo può 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 altre informazioni sulle convenzioni delle proprietà di IoT Plug and Play, vedere Convenzioni di IoT Plug and Play.
Per altre informazioni sui dati delle proprietà che un dispositivo scambia con IoT Central, vedere Payload di dati di telemetria, delle proprietà e dei 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.
Per informazioni su come implementare le proprietà in un dispositivo senza usare gli SDK per dispositivi, vedere Comunicare con un hub IoT usando il protocollo MQTT.
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. È possibile dichiarare le proprietà di sola lettura o sola scrittura.
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 | Description |
|---|---|
| Nome visualizzato | Nome visualizzato per il valore della proprietà usato nei dashboard e nei moduli. |
| 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 dei campi seguenti sono disponibili. |
| Schema | Tipo di dati della proprietà, ad esempio double, string o vector. Il tipo semantico determina le scelte disponibili. Lo schema non è disponibile per i tipi semantici di eventi e stato. |
| 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. |
| Severity | Disponibile solo per il tipo semantico dell'evento. I livelli di gravità sono Errore, Informazioni o Avviso. |
| Valori di stato | Disponibile solo per il tipo semantico di stato. Definire i valori di stato possibili, ognuno dei quali ha nome visualizzato, nome, tipo di enumerazione e valore. |
| Unità | Unità per il valore della proprietà, ad esempio 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à. |
| Description | Descrizione della funzionalità della proprietà. |
Per informazioni sul linguaggio Digital Twin Definition Language (DTDL) usato da Azure IoT Central per definire le proprietà in un modello di dispositivo, vedere Convenzioni IoT Plug and Play 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.
Attivare 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 Esercitazione: Configurare i dispositivi da un servizio back-end.
Un dispositivo invia gli aggiornamenti delle proprietà come payload JSON. Per ulteriori informazioni, vedere Payload dei dati di telemetria, delle proprietà e dei comandi.
È possibile usare Azure IoT SDK per dispositivi per inviare un aggiornamento delle proprietà all'applicazione Azure IoT Central.
Per le implementazioni di esempio in più lingue, vedere Esercitazione: 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 di IoT Central imposta le proprietà scrivibili in un modulo. 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 campi ac e av. Il campo ad è facoltativo. Per altre informazioni, vedere Convenzioni IoT Plug and Play > 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 da un 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
Ora che si è appreso come usare le proprietà nell'applicazione Azure IoT Central, vedere: