物联网平台提供的设备模拟器,可模拟真实设备与物联网平台建立连接。您可使用模拟数据,测试物联网平台与设备端之间的通信功能,并定位问题。本文介绍设备模拟接入物联网平台并进行通信的具体操作。

功能说明

通过设备模拟器,可调试设备通信功能。具体功能如下:
功能项说明
上行指令调试设备上报消息到物联网平台,包含:
  • 自定义Topic的消息上报和消息订阅
  • 属性上报
  • 事件上报
下行指令调试物联网平台下发指令到设备,包含:
  • 自定义Topic的消息下发
  • 属性调试(含获取、设置)
  • 服务调用

使用限制

  • 属性上报和事件上报支持策略推送功能。
    • 多次设置策略推送时,仅保留并执行最后一次的策略推送。
    • 连续推送的最小时间间隔为1秒。
    • 连续推送时间段最多为3小时。
  • 数据格式为透传或自定义的设备不支持启动设备模拟器。
  • 真实设备在线或设备被禁用时,不支持启动设备模拟器。
  • 离开设备模拟器页面后,设备模拟器会自动下线。
  • 若尊享型实例下自定义了MQTT接入的证书和域名,该实例下不支持设备模拟器服务。自定义证书详细内容,请参见自定义公网MQTT接入域名

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,找到对应的实例,单击实例进入实例详情页面。
    重要 目前华东2(上海)、华北2(北京)、华南1(深圳)地域开通了企业版实例服务。其他地域,请跳过此步骤。
    实例概览
  3. 在左侧导航栏,选择设备管理 > 设备模拟器
  4. 选择本次模拟的设备,单击启动设备模拟器
  5. 选择功能类型,推送调试指令,如下表所示。
    功能项功能类型操作步骤
    上行指令调试自定义Topic消息上报:使用设备模拟器发送自定义Topic消息到物联网平台云端。
    1. 选择上行指令调试 > 自定义Topic
    2. 选择消息上报的自定义Topic,输入Playload数据。
    3. 设置QoS01
    4. 单击消息上报
    消息订阅:设备订阅自定义Topic,用于接收物联网平台下发的消息。
    1. 选择上行指令调试 > 自定义Topic
    2. 选择消息订阅的自定义Topic。
    3. 单击订阅消息
    属性上报使用设备模拟器上报模拟属性值到物联网平台云端。
    1. 选择上行指令调试 > 属性上报
    2. 选择物模型的模块
    3. 在属性对应的输入框中,选择或输入符合属性数据类型和取值范围的值。
    4. 推送指令。

      可选方式:

      • 发送指令:立即推送数据。
      • 策略推送: 设置推送策略。
        • 定时推送:在设置好的时间推送数据,仅推送一次。
        • 连续推送:在设置好的时间段内,按照固定时间间隔,推送数据。时间间隔单位为秒。
    事件上报使用设备模拟器上报模拟事件到物联网平台云端。
    1. 选择上行指令调试 > 事件上报
    2. 调试功能中选择物模型模块。
    3. 选择要上报的事件,输入JSON格式的事件上报数据,如{"Power": "on"}
    4. 推送指令。

      可选方式:

      • 发送指令:立即推送数据。
      • 策略推送: 设置推送策略。
        • 定时推送:在设置好的时间推送数据,仅推送一次。
        • 连续推送:在设置好的时间段内,按照固定时间间隔,推送数据。时间间隔单位为秒。
    下行指令调试自定义Topic从物联网平台云端下发自定义Topic消息到设备模拟器。
    1. 选择下行指令调试 > 自定义Topic
    2. 选择自定义Topic,输入Payload数据。
    3. 设置QoS01
    4. 单击发送指令
    属性调试从物联网平台云端下发设置属性值的指令给设备模拟器或从设备模拟器获取指定属性的值。
    1. 选择下行指令调试 > 属性调试
    2. 选择物模型的模块
    3. 在属性输入框输入值,单击调试,选择设置
      重要 设置设备属性成功,只表示物联平台云端下发属性设置请求成功,不保证设备端执行了该请求。所以设备端SDK成功响应云端设置设备属性值的请求后,需上报对应属性值,设备属性值才能真正设置成功。
    4. 在属性输入框右侧,单击调试,选择获取

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

    服务调用
    1. 选择下行指令调试 > 服务调用
    2. 调试功能中选择物模型模块及对应服务。
    3. 在输入框中,输入调用服务的入参,单击发送指令

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

执行结果

推送数据后,可在页面右侧设备端日志下查看设备端日志。

属性上报示例如下。

设备端日志

单击查看云端日志,将跳转到云端运行日志页签,可查询相关云端日志。

更多信息,请参见云端运行日志

云端运行日志