Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En esta guía paso a paso se muestra cómo usar las propiedades del dispositivo definidas en una plantilla de dispositivo en la aplicación de Azure IoT Central.
Las propiedades representan valores a un momento dado. Por ejemplo, un dispositivo puede usar una propiedad para notificar la temperatura de destino que intenta alcanzar. De forma predeterminada, las propiedades del dispositivo son de solo lectura en IoT Central. Las propiedades grabables permiten sincronizar el estado entre el dispositivo y la aplicación de Azure IoT Central.
También puede definir propiedades en la nube en una aplicación de Azure IoT Central. Los valores de propiedad en la nube nunca se intercambian con un dispositivo y están fuera del ámbito de este artículo.
Para más información sobre las convenciones de propiedades de IoT Plug and Play, consulte Convenciones de IoT Plug and Play.
Para más información sobre los datos de propiedad que intercambia un dispositivo con IoT Central, consulte Telemetría, propiedad y cargas de comandos.
Para obtener 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 los dispositivos.
Para obtener información sobre cómo implementar propiedades en un dispositivo sin usar los SDK de dispositivo, consulte Comunicación con un centro de IoT mediante el protocolo MQTT.
Define tus propiedades
Las propiedades son campos de datos que representan el estado del dispositivo. Use propiedades para representar el estado duradero del dispositivo, como el estado activado o desactivado de un dispositivo. Las propiedades también pueden representar propiedades básicas del dispositivo, como la versión de 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 una aplicación de Azure IoT Central.
En la tabla siguiente se muestran los valores 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 visible, pero puede elegir su propio valor si es necesario. Este campo debe ser alfanumérico. El código del dispositivo usa este valor name . |
| Tipo de funcionalidad | Propiedad. |
| Tipo semántico | Tipo semántico de la propiedad, como temperatura, estado o evento. La elección del tipo semántico determina cuáles de los campos siguientes están disponibles. |
| Schema | Tipo de datos de propiedad, como double, string o vector. El tipo semántico determina las opciones disponibles. El esquema no está disponible para los tipos semánticos de eventos y estado. |
| Se puede escribir | 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. Las gravedades son Error, Información o Advertencia. |
| Valores de estado | Solo está disponible para el tipo semántico denominado "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 mph, %o °C. |
| Unidad de visualización | Unidad de visualización para su uso en iconos de paneles y formularios de dispositivo. |
| Comentario | Cualquier comentario sobre la funcionalidad de propiedad. |
| Description | 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, le 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, debe definir el esquema de objetos.
Implemente 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 los 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 obtener más información, consulte Tutorial: Configuración de los dispositivos desde un servicio back-end.
Un dispositivo envía actualizaciones de propiedades como una carga JSON. Para obtener más información, consulte 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, consulte Tutorial: 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, consulte 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 propiedades con el estado Aceptado.
Cuando escriba el valor y seleccione 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 las 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 del dispositivo:
Puede actualizar las propiedades grabables en esta vista:
Pasos siguientes
Ahora que sabe cómo usar propiedades en la aplicación de Azure IoT Central, consulte: