Un modelo Thing Specification Language (TSL) es un modelo de datos que se define para un producto en IoT Platform. Este modelo sirve para describir las funciones de un producto. En este tema se explican los conceptos y los límites de un modelo TSL.
Funciones
Un modelo TSL digitaliza una entidad física en la nube, como un sensor, un dispositivo instalado en un vehículo, un edificio o una fábrica. Incluye las propiedades, los servicios y los eventos de dicha entidad. Describe qué es la entidad, qué puede hacer y qué información proporciona. Las funciones TSL de un producto se definen a partir de las dimensiones de propiedades, servicios y eventos.
Tipo de función | Descripción |
Propiedad | Es una función TSL que describe el estado o la información de un dispositivo en ejecución. Por ejemplo, puede tratarse de la información de temperatura que recopila un dispositivo de monitoreo ambiental, del estado de encendido o apagado de una lámpara inteligente, o de la velocidad del viento de un ventilador eléctrico. Las propiedades se clasifican en propiedades de lectura y escritura, y propiedades de solo lectura. En las primeras, usted especifica valores y los lee; en las segundas, únicamente lee los valores. |
Servicio | Es un comando o método que un dispositivo ofrece para invocación externa. Configure los parámetros de entrada y salida del servicio que desea invocar. El servicio lee los valores de los parámetros de entrada y devuelve los resultados en los parámetros de salida. A diferencia de las propiedades, los servicios se invocan mediante un comando para implementar lógica de negocio compleja. Por ejemplo, invoque un servicio para ejecutar una tarea específica. Un servicio se invoca de forma síncrona o asíncrona. |
Evento | Contiene la información que un dispositivo reporta a IoT Platform para su notificación y procesamiento durante la ejecución, lo cual incluye alertas y fallas. Un evento admite varios parámetros de salida. Por ejemplo, puede ser una notificación al finalizar una tarea, la temperatura y la hora de falla cuando ocurre un error en el dispositivo, o el estado del equipo cuando se activa una alerta. Puede suscribirse a los eventos o entregarlos según sus necesidades. |
IoT Platform le permite definir varios conjuntos de funciones para un producto, entre ellas propiedades, servicios y eventos. Cada módulo TSL representa uno de estos conjuntos, y los distintos módulos no se afectan entre sí.
Estos módulos resuelven problemas complejos de modelado de dispositivos en escenarios industriales. Así, desarrolla dispositivos con distintas funciones a partir de un mismo producto.
Por ejemplo, las propiedades del producto de calefactor eléctrico con ventilador incluyen Power Switch, Gear (high, medium, and low) y Indoor Temperature. Agregue las dos primeras propiedades en un módulo y las tres en otro. Después, desarrolle los dispositivos basándose en dichos módulos TSL. De esta manera, los distintos dispositivos de un mismo producto tienen funciones diferentes.
IoT Platform proporciona un módulo predeterminado. Agregue módulos personalizados según los requisitos de su negocio. La suma de los módulos predeterminados y los módulos personalizados de cada producto no debe superar los 20.
Las funciones definidas antes del 1 de enero de 2021 se clasifican dentro del módulo predeterminado.
Descripción
IoT Platform utiliza TSL para describir los módulos y las funciones de los productos.
Defina propiedades, servicios o eventos en un módulo TSL según su escenario de negocio.
Cada archivo TSL utiliza el formato JSON. Para consultar o exportar un modelo TSL en formato JSON desde la consola de IoT Platform, siga estos pasos: en la página Product Details, haga clic en Define Feature. En la pestaña Define Feature, haga clic en TSL Model. Para obtener más información sobre los campos TSL, consulte TSL field descriptions.
Agregue uno o más modelos TSL en IoT Platform. Si necesita importar varios modelos TSL al mismo tiempo, cree archivos TSL personalizados. Para obtener más información, consulte Límites.
Límites
Para conocer los límites de las funciones TSL, consulte Límites. A continuación se describen los límites aplicables al importar archivos TSL.
Operación | Límite |
Importar un solo archivo TSL | El sufijo del archivo debe ser Los saltos de línea y los caracteres de alineación no se consideran caracteres válidos. |
Importar varios archivos TSL |
|