IoT Platform:Definir un modelo TSL

Requisitos previos

Debe haber creado un producto. Para obtener más información, consulte Create a product and a device.

Contexto

Este tema utiliza una farola como ejemplo para demostrar cómo definir dos propiedades para un producto: Interruptor de luz principal y Corriente. Después de definir el modelo TSL, puede conectar varios dispositivos de farola al producto. Cada dispositivo hereda automáticamente el modelo TSL definido. Para obtener más información sobre los modelos TSL, consulte What is a tsl model?.

Procedimiento

1. Inicie sesión en la consola de IoT Platform.

2. En la pestaña Overview, haga clic en Public Instance.

3. En el panel de navegación izquierdo, seleccione Devices > Products. En la página Products, busque el producto de farola que creó y haga clic en View en la columna Actions.

4. En la página Product Details, haga clic en la pestaña Define Feature y luego en Edit Draft.

5. En la página Edit Draft, dentro de la sección Default Module, haga clic en Add Self-defined Feature para configurar el modelo TSL y después en OK.

   Configure las propiedades Main Light Switch y Current para el producto de farola.

   • Configure la propiedad Main Light Switch: establezca Feature Type en Property, introduzca Main Light Switch en Feature Name, escriba LightSwitch en Identifier, seleccione bool en Data Type (0 para apagado, 1 para encendido) y elija read/write en Read/Write Type.

   • Configure la propiedad Current: establezca Feature Type en Property, introduzca Current en Feature Name, escriba LightCurrent en Identifier, seleccione float en Data Type, defina el rango de valores de 0 a 9, establezca el paso en 0.1, seleccione Ampere / A como unidad, elija read-only en Read/Write Type e introduzca "Los parámetros eléctricos utilizan datos de punto flotante de 4 bytes." en Description.

6. (Opcional) Haga clic en TSL Model. En la pestaña Full TSL, puede consultar el modelo TSL completo del producto en formato JSON.

   El archivo JSON incluye los arreglos de esquema, perfil y propiedades. Por ejemplo, la propiedad LightSwitch (Interruptor de luz principal) utiliza el tipo de datos bool y el modo de acceso rw (lectura/escritura). Un valor de 0 indica apagado y 1 indica encendido. En la esquina inferior derecha, haga clic en Export Model File para exportar el modelo TSL a un archivo local.

7. Publique el modelo TSL.

   Importante

   Es necesario publicar un modelo TSL para que surta efecto.

   1. En la esquina inferior izquierda de la página Edit Draft correspondiente a Define Feature, haga clic en Publish. Aparecerá el cuadro de diálogo Publish TSL Model?.

   2. Haga clic en Add Publication Note e introduzca un número de versión junto con su descripción.

      Parámetro	Descripción
      Version Number	Establezca el número de versión del modelo TSL actual. Posteriormente podrá gestionar los modelos TSL según estos números. El número de versión admite letras, dígitos y puntos (.). Su longitud puede ser de 1 a 16 caracteres.
      Version Description	Describa la versión actual del modelo TSL. Admite caracteres chinos, letras, caracteres japoneses, dígitos y símbolos especiales. La descripción puede tener hasta 100 caracteres de longitud. Un carácter chino o japonés cuenta como un solo carácter.

   3. Si ya existe una versión publicada, debe comparar el borrador con dicha versión para confirmar los cambios.

      Haga clic en Comparison Result para revisar las modificaciones en el cuadro de diálogo Comparison Result. Tras confirmar los cambios, haga clic en Confirm and View. Regresará al cuadro de diálogo Publish TSL Model y la casilla "I have reviewed the comparison between the current version and the online version" se seleccionará automáticamente.

      Si no necesita comparar las versiones, puede seleccionar manualmente la casilla I have reviewed the comparison between the current version and the online version.

   4. Haga clic en OK para publicar el modelo TSL.

Pasos siguientes

Connect a device to IoT Platform