文档

在线调试

更新时间:

设备端开发完成后,您可以使用物联网平台的在线调试功能,从物联网平台控制台下发指令到设备端进行物模型功能测试。您也可以使用在线调试的远程登录服务,通过SSH协议的网络服务远程访问设备,在设备远程控制台输入设备的指令,进行调试和定位问题。本文介绍物模型功能调试和远程登录的操作步骤。

前提条件

  • 设备所属产品,已定义物模型功能。具体内容,请参见添加物模型

  • 设备已接入物联网平台并激活在线。设备端开发并接入物联网平台的方法,请参见设备接入Link SDK

    说明

    您也可通过物联网平台的设备模拟器或MQTT.fx工具模拟设备在线后,使用在线调试功能调试在线设备的功能。具体操作,请参见设备模拟器使用MQTT.fx接入物联网平台

    模拟设备在线后会生成设备Topic,相关消息Topic订阅和使用说明,请参见生成设备Topic

  • 如果使用远程登录服务,设备还需满足以下条件:

    • 运行Linux操作系统。

    • 安装了SSH Server应用。

    • 集成了官方Link SDK。具体内容,请参见远程登录功能的SDK

使用限制

  • 仅支持使用MQTT协议连接的设备进行物模型功能调试。

  • 仅华东2(上海)、华北2(北京)、华南1(深圳)地域支持使用远程登录服务。

功能调试

  1. 登录物联网平台控制台

  2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述
    实例概览
  3. 在左侧导航栏,选择监控运维 > 在线调试

  4. 在线调试页面,选择本次调试的设备。

  5. 选择属性调试服务调用远程登录,进行调试。

属性调试

  1. 属性调试页签,选择物模型的模块

  2. 执行以下操作,进行调试。

    重要

    设置设置期望值的属性必须具有读写权限。

    功能

    操作

    说明

    获取

    在属性输入框右侧,单击调试,选择获取

    属性输入框中将显示获取到的最新属性数据。如果设备上没有该属性的数据,则输入框为空。

    设置

    在属性输入框输入值,单击右侧调试,选择设置

    从云端下发设置属性值的指令给设备。在线设备收到指令后,根据设备端的物模型开发功能,处理属性值,例如将最新属性值上报给云端。

    设置期望值

    在属性输入框输入值,单击右侧调试,选择设置期望值

    从云端下发设置期望属性值的指令给设备。

    如果下发指令时:

    • 设备在线,设备立即收到指令,更新该属性值,并将新属性值上报云端。

    • 设备不在线,待设备重新上线时,主动获取期望属性值信息,然后更新属性值并上报。

    您也可单击页面下方的获取设置设置期望值,进行批量属性调试。

服务调用

  1. 服务调用页签,从调试功能下拉列表的选项中,选择模块及对应待调试的服务。

  2. 在输入框中,输入调用服务的入参,单击发送指令

    输入的服务入参数据,需为标准的JSON格式,例如{"Switch":0}

远程登录

远程登录页签,开启远程登录功能,进行调试。具体操作,请参见远程登录

查看调试日志

推送指令后,可在页面右侧实时日志下查看操作日志;在设备详情页面的物模型数据页签,查看调试结果。

重要

在线调试时,物联网平台使用RRPC同步方式下行推送指令。因此对于模拟在线的设备(例如使用MQTT.fx工具接入的设备),即使没有订阅任何设备Topic,也可以收到相关日志。您可在监控运维日志服务页面,查看详细日志。

如下图所示:

  • 属性调试:输入属性值,单击设置

    image

  • 服务调用:选择对应服务,输入服务的入参,单击发送指令

    image

  • 本页导读 (1)