Uso de las propiedades en una solución de Azure IoT Central
En esta guía paso a paso se muestra cómo usar las propiedades del dispositivo que se definen en una plantilla de dispositivo en la aplicación de Azure IoT Central.
Las propiedades representan valores de un momento dado. Por ejemplo, un dispositivo puede usar una propiedad para notificar la temperatura objetivo que está intentando alcanzar. De manera predeterminada, las propiedades del dispositivo son de solo lectura en IoT Central. Las propiedades editables permiten sincronizar el estado entre el dispositivo y la aplicación de Azure IoT Central.
También puede definir las propiedades de la nube en una aplicación de Azure IoT Central. Los valores de propiedad de la nube nunca se intercambian con un dispositivo y están fuera del ámbito de este artículo.
Para obtener información sobre las convenciones de propiedades de IoT Pug y Play, vea convenciones de IoT Plug and Play.
Para más información sobre los datos de propiedad que un dispositivo intercambia con IoT Central, consulte Cargas de telemetría, propiedades y comandos.
Para información sobre cómo administrar propiedades mediante la API REST de IoT Central, consulte Uso de la API REST de IoT Central para controlar dispositivos.
Para obtener información sobre cómo implementar propiedades en un dispositivo sin usar los SDK de dispositivo, vea Comunicación con un centro de IoT mediante el protocolo MQTT.
Definición de las propiedades
Las propiedades son campos de datos que representan el estado de un dispositivo. Se usan para representar el estado duradero del dispositivo, como el estado de encendido-apagado de un dispositivo. Las propiedades también pueden representar propiedades básicas del dispositivo, como la versión del software del dispositivo. Las propiedades se declaran como de solo lectura o de escritura.
En la captura de pantalla siguiente se muestra una definición de propiedad en la aplicación de Azure IoT Central.
En la siguiente tabla se muestran las opciones de configuración de una funcionalidad de propiedad.
| Campo | Description |
|---|---|
| Nombre para mostrar | Nombre para mostrar del valor de la propiedad que se usa en los iconos de paneles y formularios de dispositivos. |
| Nombre | El nombre de la propiedad. Azure IoT Central genera un valor para este campo a partir del nombre para mostrar, pero puede elegir su propio valor si es necesario. Este campo debe ser alfanumérico. El código del dispositivo usa este valor de Nombre. |
| Tipo de funcionalidad | Propiedad. |
| Tipo semántico | El tipo semántico de la propiedad, como la temperatura, el estado o el evento. La elección del tipo semántico determina cuál de los campos siguientes está disponible. |
| Schema | El tipo de datos de la propiedad, como doble, cadena o vector. El tipo semántico determina las opciones disponibles. El esquema no está disponible para los tipos semánticos de evento y estado. |
| Editable | Si la propiedad no se puede escribir, el dispositivo puede notificar los valores de propiedad a Azure IoT Central. Si la propiedad se puede escribir, el dispositivo puede notificar los valores de propiedad a Azure IoT Central. Después, Azure IoT Central puede enviar actualizaciones de propiedades al dispositivo. |
| severity | Solo está disponible para el tipo semántico de evento. Los niveles de gravedad son Error, Información o Advertencia. |
| Valores de estado | Solo está disponible para el tipo semántico de estado. Defina los valores de estado posibles, cada uno de los cuales tiene el nombre para mostrar, el nombre, el tipo de enumeración y el valor. |
| Unidad | Unidad para el valor de propiedad, como km/h, % o °C. |
| Unidad de visualización | Una unidad de visualización para su uso en iconos de paneles y formularios de dispositivos. |
| Comentario | Cualquier comentario sobre la funcionalidad de propiedad. |
| Descripción | Una descripción de la funcionalidad de propiedad. |
Para obtener información sobre el lenguaje de definición de gemelos digitales (DTDL) que Azure IoT Central usa para definir propiedades en una plantilla de dispositivo, consulte convenciones de IoT Plug and Play > propiedades de solo lectura.
Los campos opcionales, como el nombre para mostrar y la descripción, permiten agregar más detalles a la interfaz y las funcionalidades.
Al crear una propiedad, puede especificar tipos de esquema complejos, como Object y Enum.
Al seleccionar el esquema complejo, como Object, deberá definir también el objeto.
Implementación de propiedades de solo lectura
De forma predeterminada, las propiedades son de solo lectura. Las propiedades de solo lectura permiten a un dispositivo informar de las actualizaciones de los valores de las propiedades a la aplicación de Azure IoT Central. La aplicación de Azure IoT Central no puede establecer el valor de una propiedad de solo lectura.
Azure IoT Central usa dispositivos gemelos para sincronizar valores de propiedad entre el dispositivo y la aplicación de Azure IoT Central. Los valores de propiedades del dispositivo usan propiedades notificadas del dispositivo gemelo. Para más información, consulte los detalles sobre dispositivos gemelos.
Un dispositivo envía actualizaciones de propiedades como una carga JSON. Para obtener más información, vea Telemetría, propiedad y cargas de comandos.
Puede usar el SDK de dispositivo IoT de Azure para enviar una actualización de propiedad a la aplicación de Azure IoT Central.
Para ver implementaciones de ejemplo en varios lenguajes, vea Creación y conexión de una aplicación cliente a la aplicación de Azure IoT Central.
En la siguiente vista de la aplicación de Azure IoT Central se muestran las propiedades de solo lectura del dispositivo:
Implementación de propiedades editables
Un operador de IoT Central establece propiedades grabables en un formulario. Azure IoT Central envía la propiedad al dispositivo. Azure IoT Central espera una confirmación del dispositivo.
Para ver implementaciones de ejemplo en varios lenguajes, vea Creación y conexión de una aplicación cliente a la aplicación de Azure IoT Central.
El mensaje de respuesta debe incluir los campos ac y av. El campo ad es opcional. Para más información, vea convenciones de IoT Plug and Play > propiedades grabables.
Cuando el operador establece una propiedad grabable en la interfaz de usuario de Azure IoT Central, la aplicación usa una propiedad deseada del dispositivo gemelo para enviar el valor al dispositivo. A continuación, el dispositivo responde con una propiedad notificada del dispositivo gemelo. Cuando Azure IoT Central recibe el valor de la propiedad notificada, actualiza la vista de la propiedad con el estado Aceptada.
Al escribir el valor y seleccionar Guardar, el estado inicial es Pendiente. Cuando el dispositivo acepta el cambio, el estado cambia a Aceptado.
Uso de propiedades en dispositivos sin asignar
Puede ver y actualizar propiedades grabables en un dispositivo que no está asignado a una plantilla de dispositivo.
Para ver las propiedades existentes en un dispositivo sin asignar, vaya al dispositivo en la sección Dispositivos, seleccione Administrar dispositivo y, a continuación, Propiedades de dispositivo:
Puede actualizar las propiedades grabables en esta vista:
Pasos siguientes
Ahora que ha aprendido a usar propiedades en una aplicación de Azure IoT Central, consulte: