Todos los productos
Search
Centro de documentos

IoT Platform:Depuración en línea

Última actualización: Sep 03, 2026

Una vez desarrollado un dispositivo, utilice la función Online Debug en la consola de IoT Platform para enviar comandos al dispositivo y probar las funciones de su modelo TSL. También puede usar el servicio de inicio de sesión remoto para acceder a su dispositivo mediante SSH. Esto le permite introducir comandos directamente en la consola remota del dispositivo para depurar y solucionar problemas. Este tema describe cómo depurar las funciones del modelo TSL y utilizar el inicio de sesión remoto.

También puede usar el servicio de inicio de sesión remoto para acceder a su dispositivo mediante SSH. Esto le permite introducir comandos directamente en la consola remota del dispositivo para depurar y solucionar problemas.

y utilizar el inicio de sesión remoto

Requisitos previos

  • El producto del dispositivo debe tener un modelo TSL definido. Para obtener más información, consulte Add a TSL model.

  • El dispositivo debe estar conectado a IoT Platform, activado y en línea. Para aprender a desarrollar y conectar su dispositivo, consulte Connect a device by using a Link SDK.

    Nota

    También puede utilizar el simulador de dispositivos en IoT Platform o una herramienta como MQTT.fx para simular un dispositivo en línea. Posteriormente, use la función Online Debug para probar las funciones del dispositivo simulado. Para obtener más información, consulte Use the device simulator o Connect a device to IoT Platform by using MQTT.fx.

    Cuando un dispositivo simulado se conecta, se genera un topic de dispositivo. Para obtener más información sobre cómo suscribirse y utilizar topics, consulte Generate device topics.

Limitaciones

Solo puede depurar funciones del modelo TSL para dispositivos conectados mediante MQTT.

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 el ID o el nombre de la instancia.

  3. En el panel de navegación izquierdo, seleccione Maintenance > Online Debug.

  4. En la página Online Debug, seleccione el dispositivo que desea depurar.

  5. Seleccione la pestaña Property Debugging, Service Calls, para comenzar la depuración.

Depuración de propiedades

  1. En la pestaña Property Debugging, seleccione un módulo en la lista desplegable Module.

  2. Realice las siguientes operaciones para depurar propiedades.

    Importante

    Para utilizar las operaciones Set o Set expectations, las propiedades deben contar con permisos de lectura y escritura.

    Función

    Operación

    Descripción

    Get

    A la derecha del campo de propiedad, haga clic en Debugging y seleccione Get.

    Los datos más recientes de la propiedad del dispositivo se muestran en el campo de entrada. Si el dispositivo no tiene datos para la propiedad, el campo aparece vacío.

    Set

    Introduzca un valor en el campo de propiedad, haga clic en Debugging a la derecha y seleccione Set.

    IoT Platform envía un comando al dispositivo para establecer el valor de la propiedad. Cuando un dispositivo en línea recibe el comando, procesa el valor según la implementación de su modelo TSL. Por ejemplo, el dispositivo reporta el valor más reciente de la propiedad a IoT Platform.

    Set expectations

    Introduzca un valor en el campo de propiedad, haga clic en Debugging a la derecha y seleccione Set expectations.

    IoT Platform envía un comando al dispositivo para establecer un valor de propiedad deseado.

    Al enviar el comando:

    • Si el dispositivo está en línea, recibe el comando inmediatamente, actualiza el valor de la propiedad y reporta el nuevo valor a IoT Platform.

    • Si el dispositivo está fuera de línea, obtiene proactivamente el valor deseado al conectarse; luego actualiza la propiedad y reporta el nuevo valor.

    También puede hacer clic en Get, Set o Set expectations en la parte inferior de la página para depurar varias propiedades en lote.

Llamadas de servicio

  1. En la pestaña Service Calls, seleccione el módulo y el servicio que desea depurar en la lista desplegable Debug Feature.

  2. En el campo de entrada, introduzca los parámetros para la llamada de servicio y luego haga clic en Send Command.

    Los parámetros de entrada deben tener un formato JSON válido, como {"Switch":0}.

Consulta de registros de depuración

Después de enviar un comando, consulte el registro de operaciones en la sección Real-time Logs ubicada en el lado derecho de la página. También puede ver los resultados de la depuración en la pestaña TSL Data de la página de detalles del dispositivo.

Importante

Durante la depuración en línea, IoT Platform utiliza un mecanismo RRPC síncrono para enviar comandos a los dispositivos. Como resultado, los dispositivos simulados en línea, como aquellos conectados mediante MQTT.fx, pueden recibir registros relevantes incluso sin suscribirse a ningún topic de dispositivo. Puede consultar registros detallados en la página Maintenance > Device Log.

  • Depuración de propiedades: Introduzca un valor de propiedad y haga clic en Set.

    El lado izquierdo de la página muestra la lista de propiedades y sus valores actuales. La sección Real-time Logs a la derecha muestra el estado del dispositivo y los registros de operaciones. En el contenido del registro, el valor del campo Operation es thing.service.property.set, lo cual indica que la plataforma envió el comando de configuración de propiedad.

    属性设置

  • Llamadas de servicio: Seleccione un servicio, introduzca sus parámetros de entrada y haga clic en Send Command.

    El lado izquierdo de la página muestra la lista desplegable Debug Feature y un editor JSON para los parámetros de entrada, con los botones Send Command y Reset en la parte inferior. La sección Real-time Logs a la derecha muestra el registro de solicitud para la llamada de servicio (donde el campo Operation es el identificador del servicio) y la respuesta del dispositivo.

    调用服务