文档

设备模拟器

更新时间:

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

功能说明

通过设备模拟器,可调试设备通信功能。具体功能如下:

功能项

说明

上行指令调试

设备上报消息到物联网平台,包含:

  • 自定义Topic的消息上报和消息订阅

  • 属性上报

  • 事件上报

下行指令调试

物联网平台下发指令到设备,包含:

  • 自定义Topic的消息下发

  • 属性调试(含获取、设置)

  • 服务调用

设备模拟器启动后,会自动订阅基础通信Topic和物模型Topic。详细说明,请参见使用消息通信Topic

使用限制

  • 属性上报和事件上报支持策略推送功能。

    • 多次设置策略推送时,仅保留并执行最后一次的策略推送。

    • 连续推送的最小时间间隔为1秒。

    • 连续推送时间段最多为3小时。

  • 数据格式为透传或自定义的设备不支持启动设备模拟器。

  • 真实设备在线或设备被禁用时,不支持启动设备模拟器。

  • 离开设备模拟器页面后,设备模拟器会自动下线。

  • 若尊享型实例下自定义了MQTT接入的证书和域名,该实例下不支持设备模拟器服务。自定义证书详细内容,请参见为尊享型实例自定义MQTT接入证书

操作步骤

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

  2. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  3. 在左侧导航栏,选择设备管理 > 设备模拟器

  4. 选择本次模拟的设备,单击启动设备模拟器

  5. MQTT连接参数窗口,选择MQTT协议版本,然后单击确认

    MQTT协议说明,请参见MQTT协议规范

    MQTT协议版本

  6. 选择功能类型,推送调试指令,如下表所示。

    上行指令调试

    自定义Topic

    • 消息上报:使用设备模拟器发送自定义Topic消息到物联网平台云端。

      1. 选择上行指令调试 > 自定义Topic

      2. 选择消息上报的自定义Topic,输入Payload数据。

      3. 设置QoS01

      4. MQTT协议为5.0时,可设置是否为保留消息消息过期时长(秒)

        说明

        QoS 0的消息过期时长(秒)最长为86400秒,QoS 1的消息过期时长(秒)最长为604800秒。消息过期时长(秒)不设置时,默认使用对应QoS消息的最长时长。

      5. 单击消息上报

    • 消息订阅:设备订阅自定义Topic,用于接收物联网平台下发的消息。

      1. 选择上行指令调试 > 自定义Topic

      2. 选择消息订阅的自定义Topic。

      3. MQTT协议为5.0时,可设置:

        • Qos01

        • No Local(是否接收自身发布的消息)true(不接收)或false(接收)。

        • Retain Handling(指定订阅时是否向设备发送保留消息)

          • 0:只要客户端订阅成功,服务端就发送保留消息。

          • 1:客户端订阅成功且该订阅之前不存在,服务端才发送保留消息。

          • 2:即使客户端订阅成功,服务端也不会发送保留消息。

      4. 单击订阅消息

    属性上报

    使用设备模拟器上报模拟属性值到物联网平台云端。

    1. 选择上行指令调试 > 属性上报

    2. 选择物模型的模块

    3. 在属性对应的输入框中,选择或输入符合属性数据类型和取值范围的值。 数值类型的属性支持设置随机数,random(a,b)代表整数a和整数b范围之间的随机数。

    4. 推送指令。

      • 发送指令:立即推送数据。

      • 策略推送: 设置推送策略。

        重要

        关闭设备模拟器后,策略推送将不再执行。

        • 定时推送:在设置好的时间推送数据,仅推送一次。

        • 连续推送:在设置好的时间段内,按照固定时间间隔,推送数据。时间间隔单位为秒。

    事件上报

    使用设备模拟器上报模拟事件到物联网平台云端。

    1. 选择上行指令调试 > 事件上报

    2. 调试功能中选择物模型模块。

    3. 选择要上报的事件,输入JSON格式的事件上报数据,如{"Power": "on"}

    4. 推送指令。

      • 发送指令:立即推送数据。

      • 策略推送: 设置推送策略。

        重要

        关闭设备模拟器后,策略推送不再执行。

        • 定时推送:在设置好的时间推送数据,仅推送一次。

        • 连续推送:在设置好的时间段内,按照固定时间间隔,推送数据。时间间隔单位为秒。

    下行指令调试

    自定义Topic

    从物联网平台云端下发自定义Topic消息到设备模拟器。

    1. 选择下行指令调试 > 自定义Topic

    2. 选择自定义Topic,输入Payload数据。

    3. 设置QoS01

    4. MQTT协议为5.0时,可设置是否为保留消息消息过期时长(秒)

      说明

      QoS 0的消息过期时长(秒)最长为86400秒,QoS 1的消息过期时长(秒)最长为604800秒。消息过期时长(秒)不设置时,默认使用对应QoS消息的最长时长。

    5. 单击发送指令

    属性调试

    从物联网平台云端下发设置属性值的指令给设备模拟器或从设备模拟器获取指定属性的值。

    1. 选择下行指令调试 > 属性调试

    2. 在属性输入框输入值,单击调试,选择设置。数值类型的属性支持设置随机数,random(a,b)代表整数a和整数b范围之间的随机数。

      重要

      设置设备属性成功,只表示物联平台云端下发属性设置请求成功,不保证设备端执行了该请求。所以设备端SDK成功响应云端设置设备属性值的请求后,需上报对应属性值,设备属性值才能真正设置成功。

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

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

    服务调用

    1. 选择下行指令调试 > 服务调用

    2. 调试功能中选择物模型模块及对应服务。

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

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

执行结果

推送数据后,可在页面右侧设备端日志区域查看策略推送开启状态、日志时间、日志内容等信息。

属性上报示例如下。

image.png

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

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

云端运行日志

常见问题

  • 本页导读 (1)
文档反馈