IoT Platform:Simulación de dispositivos

Funciones

Límites

• Puede configurar una directiva para enviar propiedades y eventos de forma periódica.

  • Si modifica la configuración de la directiva varias veces, solo surte efecto la modificación más reciente.

  • El intervalo mínimo entre mensajes consecutivos es de 1 segundo.

  • El periodo máximo durante el cual se pueden enviar mensajes consecutivos es de 3 horas.

• No puede utilizar el simulador de dispositivos para aquellos cuyo parámetro Data Type esté establecido en Custom.

• No puede utilizar el simulador de dispositivos para dispositivos físicos que estén en línea o deshabilitados.

• Al salir de la página Device Simulation, el simulador de dispositivos se deshabilita.

• Si especifica endpoints y certificados personalizados de Message Queuing Telemetry Transport (MQTT) para una instancia Exclusive, no podrá utilizar la función de simulación de dispositivos en dicha instancia. Para obtener más información sobre los certificados personalizados, consulte Customize the MQTT certificate for Premium Enterprise Edition instances.

Procedimiento

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

2. En la página Overview, busque la instancia que desea gestionar y haga clic en su ID o nombre.

3. En el panel de navegación izquierdo, seleccione Devices > Device Simulation.

4. Seleccione un producto y, a continuación, elija el dispositivo que desea simular. En la página Device Simulation, haga clic en Start Device Simulation.

5. En el cuadro de diálogo MQTT Connection Parameters, seleccione una MQTT protocol version y haga clic en OK.

   Para obtener más información sobre MQTT, consulte MQTT protocol specifications.

   

6. Seleccione una función y envíe datos para depurarla. La siguiente tabla describe las funciones disponibles.

   Depuración ascendente

   Temas personalizados

   • Message Reporting: El simulador de dispositivos utiliza un tema personalizado para enviar un mensaje a IoT Platform.

     1. Seleccione Upstream Debug > Topic Category

     2. Seleccione un tema personalizado para enviar el mensaje y configure el parámetro Payload Data.

     3. Establezca el parámetro Qos en 0 o 1.

     4. Si establece el parámetro MQTT Protocol Version en 5.0, puede configurar los parámetros Retained Message y Message Validity Period (Seconds).

        Nota

        Si establece el parámetro Qos en 0, el valor máximo del parámetro Message Validity Period (Seconds) es 86,400. Si establece el parámetro Qos en 1, el valor máximo del parámetro Message Validity Period (Seconds) es 604,800. Si no configura el parámetro Message Validity Period (Seconds), se utiliza el valor máximo. Este valor varía según el valor del parámetro Qos.

     5. Haga clic en Message Reporting.

   • Message Subscription: El simulador de dispositivos se suscribe a un tema personalizado para recibir un mensaje de IoT Platform.

     1. Seleccione Upstream DebugTopic Category.

     2. Seleccione un tema para la suscripción de mensajes.

     3. Si establece el parámetro MQTT Protocol Version en 5.0, puede configurar los siguientes parámetros.

        • Qos. Valores válidos: 0 y 1.

        • No Local (Receive Device Messages). Valores válidos: true y false. El valor true indica que el dispositivo no recibe sus propios mensajes. El valor false indica que el dispositivo sí recibe sus propios mensajes.

        • Retain Handling (Send Retained Messages to Device During Subscription). Valores válidos:

          • 0: Si se configura una suscripción entre el servidor y un cliente, el servidor envía un mensaje retenido.

          • 1: Si se configura una nueva suscripción entre el servidor y un cliente, el servidor envía un mensaje retenido.

          • 2: El servidor no envía ningún mensaje retenido al cliente, independientemente de si existe una suscripción configurada entre ambos.

     4. Haga clic en Subscribe.

   Envío de propiedades

   El simulador de dispositivos envía una propiedad a IoT Platform.

   1. Seleccione Upstream Debug Properties.

   2. Seleccione un módulo de Thing Specification Language (TSL) en la lista desplegable Debugging Device.

   3. Seleccione o introduzca un valor en el campo de la propiedad. El valor debe coincidir con el tipo de datos y el rango de valores de la propiedad. Puede establecer una propiedad de tipo numérico en un valor aleatorio. random(a,b) especifica un valor aleatorio entre el entero a y el entero b.

   4. Envíe los datos. Opciones:

      • Send Command: envía los datos inmediatamente.

      • Push Policy: configura una directiva de mensajería. Valores válidos:

        Importante

        Una vez deshabilitado el simulador de dispositivos, la directiva de mensajería deja de ser válida.

        • At Specific Time: Los datos se envían una sola vez en un momento específico.

        • At Specific Interval: Los datos se envían repetidamente a un intervalo fijo durante un periodo de tiempo determinado. El intervalo se mide en segundos.

   Envío de eventos

   La función de simulación de dispositivos envía un evento a IoT Platform.

   1. Seleccione Upstream Debug > Events

   2. Seleccione un módulo TSL en la lista desplegable Debugging Features.

   3. Seleccione una función e introduzca los datos del evento en formato JSON, por ejemplo, {"Power": "on"}.

   4. Envíe los datos. Opciones:

      • Send Command: envía los datos inmediatamente.

      • Push Policy: configura una directiva de mensajería. Valores válidos:

        Importante

        Una vez deshabilitado el simulador de dispositivos, la directiva de mensajería deja de ser válida.

        • At Specific Time: Los datos se envían una sola vez en un momento específico.

        • At Specific Interval: Los datos se envían repetidamente a un intervalo fijo durante un periodo de tiempo determinado. El intervalo se mide en segundos.

   Depuración descendente

   Temas personalizados

   IoT Platform envía un mensaje a un dispositivo mediante un tema personalizado.

   1. Seleccione Downstream Debug > Topic Category

   2. Seleccione un tema personalizado para enviar el mensaje y configure el parámetro Payload Data.

   3. Establezca el parámetro Qos en 0 o 1.

   4. Si establece la versión del protocolo MQTT en 5.0, puede configurar los parámetros Retained Message y Message Validity Period (Seconds).

      Nota

      Si establece el parámetro Qos en 0, el valor máximo del parámetro Message Validity Period (Seconds) es 86,400. Si establece el parámetro Qos en 1, el valor máximo del parámetro Message Validity Period (Seconds) es 604,800. Si no configura el parámetro Message Validity Period (Seconds), se utiliza el valor máximo. Este valor varía según el valor del parámetro Qos.

   5. Haga clic en Send Command.

   Consulta y configuración de propiedades

   IoT Platform envía un comando al simulador de dispositivos para cambiar o consultar el valor de una propiedad.

   1. Seleccione Downstream Debug > Property debugging

   2. Introduzca un valor en el campo de la propiedad y haga clic en Debugging. A continuación, haga clic en Set. Puede establecer una propiedad de tipo numérico en un valor aleatorio. random(a,b) especifica un valor aleatorio entre el entero a y el entero b.

      Importante

      El mensaje de éxito solo indica que el dispositivo recibió el comando de IoT Platform para cambiar el valor de la propiedad. Es posible que el dispositivo no ejecute el comando. Una vez que el Link SDK utilizado para configurar el dispositivo responde a la solicitud de configuración de la propiedad, el dispositivo debe enviar el valor más reciente de esta para confirmar que se ha modificado.

   3. A la derecha del campo de la propiedad, haga clic en Debugging. A continuación, haga clic en Get.

      El valor más reciente de la propiedad se muestra en el campo. Si el valor de la propiedad no existe en el simulador de dispositivos, no se mostrará ningún dato.

   Invocación de servicios

   1. Seleccione Downstream Debug > Invoke Service

   2. Seleccione el módulo TSL y el servicio en la lista desplegable Debugging Features.

Resultado

Después de enviar los datos, puede consultar los registros del dispositivo en la sección Device log, ubicada en la parte derecha de la página.

La siguiente figura muestra un ejemplo.

Haga clic en View Cloud Logs. En la pestaña Cloud run log, puede consultar los registros relacionados de IoT Platform.

Para obtener más información, consulte IoT Platform logs.