IoT Platform:Crear un producto y un dispositivo

Requisitos previos

Se requiere una instancia de Enterprise Edition. Para más información, consulte Create an Enterprise Edition instance.

Contexto

• Un producto es un conjunto de dispositivos que comparten las mismas funciones. Puede gestionar los dispositivos por producto; por ejemplo, para define a TSL model o customize topics.

• Cada dispositivo físico debe tener una identidad en IoT Platform. Debe aprovisionar el dispositivo físico con el certificado (ProductKey, DeviceName y DeviceSecret) que emite IoT Platform. Dicho certificado autentica al dispositivo cuando se conecta a la plataforma. Para más información, consulte Obtain a device certificate.

Este tema describe cómo crear un producto, definir un modelo TSL, agregar un dispositivo y obtener su certificado para un termostato doméstico en IoT Platform.

Procedimiento

1. En la consola de IoT Platform, dentro de la pestaña Overview, haga clic en la instancia IoT Test Environment.

2. En el panel de navegación izquierdo, seleccione Device Management > Products y luego haga clic en Create Product.

3. En la página Create Product, configure los parámetros y haga clic en OK.

   En este ejemplo, establezca Product Name como Home Thermostat. Mantenga los valores predeterminados en los demás parámetros. Por ejemplo, Node Type queda en Directly Connected Device, Connection Method en Wi-Fi, Data Format en ICA Standard Data Format (Alink JSON), Data Validation Level en Relaxed y Authentication Method en DeviceSecret.

4. En la página Create Product, haga clic en Go to Define Thing Specification Language (TSL) model.

   Definir un modelo TSL para el producto permite abstraer un producto físico en un modelo de datos compuesto por propiedades, servicios y eventos. Este modelo simplifica la gestión de dispositivos y la interacción de datos en IoT Platform.

5. En la pestaña Define Features, haga clic en Edit Draft y siga estos pasos para definir las propiedades de temperatura y humedad del producto Home Thermostat.

   1. En la sección Default Module, haga clic en Add Custom Feature para configurar las propiedades de temperatura y humedad.

      Para la propiedad de temperatura, establezca Feature Type en Property, Feature Name en Temperature, Identifier en temperature, Data Type en double, Value Range en -20–60, Step en 0.1, Unit en Celsius/°C y Access Mode en Read/Write. Para la propiedad de humedad, establezca Feature Name en Humidity, Identifier en humidity, Data Type en int32, Value Range en 0–100, Step en 1, Unit en Percentage/% y Access Mode en Read/Write.

   2. Haga clic en Publish, ubicado en la esquina inferior izquierda de la página Edit Draft dentro de Function Definition. Aparecerá el cuadro de diálogo Publish TSL model?.

   3. Seleccione la casilla I have confirmed the differences between the current and online versions.

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

6. En la página Product Details, haga clic en la pestaña Devices.

7. En la pestaña Devices, haga clic en Add Device. En el cuadro de diálogo que aparece, introduzca un nombre de dispositivo, como Device1, y haga clic en OK.

   Una vez creado el dispositivo, aparecerá el cuadro de diálogo Added. Haga clic en Copy Device Certificate.

   Como alternativa, haga clic en View para abrir la página Device Details. Ahí, haga clic en View junto a DeviceSecret.

   El certificado de dispositivo contiene el ProductKey, el DeviceName y el DeviceSecret. El dispositivo utiliza esta credencial para comunicarse con IoT Platform.

   Importante

   El certificado de dispositivo es obligatorio para conectar su equipo a IoT Platform. Copie la información del certificado y guárdela en un lugar seguro.

   Parámetro	Descripción
   ProductKey	Es el ProductKey del producto al que pertenece el dispositivo. IoT Platform lo emite como identificador único global (GUID) del producto.
   DeviceName	Es el DeviceName del dispositivo, que lo identifica de forma única dentro del producto. La combinación de DeviceName y ProductKey funciona como identificador del dispositivo. IoT Platform usa dicho identificador para autenticar al dispositivo y comunicarse con él.
   DeviceSecret	Es el DeviceSecret del dispositivo. IoT Platform lo emite para la autenticación y el cifrado. Debe usarse siempre junto con el DeviceName.

Siguientes pasos

Connect a device and upload data