设备模拟器

功能说明

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

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

使用限制

• MQTT型企业版实例下设备不支持使用设备模拟器。

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

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

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

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

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

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

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

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

操作步骤

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

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

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

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

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

   MQTT协议说明，请参见MQTT协议规范。

   

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

   上行指令调试

   自定义Topic

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

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

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

     3. 设置QoS为0或1。

     4. MQTT协议为5.0时，可设置是否为保留消息和消息过期时长（秒）。

        说明

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

     5. 单击消息上报。

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

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

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

     3. MQTT协议为5.0时，可设置：

        • Qos：0或1。

        • 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. 设置QoS为0或1。

   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}。

常见问题

• 如何使用物联网平台设备模拟器进行设备接入和远程控制

• 设备可以订阅其他设备的通信Topic吗？

• 自定义Topic通信数据的标准JSON格式是什么？

• 设备接入云平台时如何自动订阅Topic

• 如何使用客户端连接物联网平台并订阅设备属性实时变化？