文档首页 > > 开发指南> 产品开发> 开发编解码插件> 插件开发示例> 含命令执行结果的编解码插件

含命令执行结果的编解码插件

更新时间: 2019/06/25 GMT+08:00

场景说明

有一款烟感设备,具有如下特征:

  • 具有烟雾报警功能(火灾等级)和温度上报功能。
  • 支持远程控制命令,可远程打开报警功能。比如火灾现场温度,远程打开烟雾报警,提醒住户疏散。
  • 支持上报命令执行结果。

Profile定义

在烟感产品的开发空间完成Profile定义。

编解码插件开发

  1. 在烟感产品的开发空间,选择“编解码插件开发”

  2. 配置数据上报消息,上报火灾等级和温度。

    添加messageId字段,表示消息种类。

    • 在本场景中,数据上报消息有两种,所以需要用messageId来标志消息种类。
    • “数据类型”根据数据上报消息种类的数量进行配置。在本场景中,仅有两种数据上报消息,配置为“int8u”即可满足需求。
    • “默认值”可以修改,但必须为十六进制格式,且数据上报消息的对应字段必须和默认值保持一致。在本场景中,用0x0标识上报火灾等级和温度的消息。

    添加level字段,表示火灾级别。
    • “字段名”只能输入包含字母、数字、_和$,且不能以数字开头的字符。
    • “数据类型”根据设备上报数据的实际情况进行配置,需要和Profile相应字段的定义相匹配。
    • “长度”“偏移值”根据“数据类型”的配置自动填充。

    添加temperature字段,表示温度。在Profile中,temperature属性最大值1000,因此在插件中定义temperature字段的“数据类型”“int16u”,以满足temperature属性的取值范围。

  3. 配置命令下发消息。

    添加messageId字段,表示消息种类。如果只有一种命令下发消息,则可以不配置此字段。

    添加mid字段,用于将下发的命令和命令执行结果进行关联。

    添加value字段,表示下发命令的参数值。

  4. 配置命令下发响应消息。

    添加messageId,表示消息种类。命令执行结果为上行消息,需要通过messageId和数据上报消息进行区分。

    添加mid字段,用于将下发的命令和命令执行结果进行关联。

    添加errcode字段,用于表示命令执行状态:00表示成功,01表示失败,如果未携带该字段,则默认命令执行成功。

    添加result字段,用于表示命令执行结果。

  5. 拖动右侧“设备模型”区域的属性字段和命令字段,数据上报消息和命令下发消息的相应字段建立映射关系。

  6. 点击“保存”,并在插件保存成功后点击“部署”,将编解码插件部署到物联网平台。

调测编解码插件

  1. 在烟感产品的开发空间,选择“在线调测”,使用虚拟设备调试编解码插件。

    勾选“没有真实的物理设备”,点击“创建”

  2. 使用应用模拟器进行命令下发:{ "serviceId": "Smoke", "method": "SET_ALARM", "paras": "{\"value\":0}" }。

    “设备模拟器”区域查看命令接收的结果:01000100。01为messageId字段,0001为mid字段,00为value字段。

  3. 使用设备模拟器进行数据上报。

    十六进制码流示例:0200010000。02表示messageId,此消息上报命令执行结果;0001表示mid,长度为2个字节;00表示命令执行状态,长度为1个字节;00表示命令执行结果,长度为1个字节。

    设备详情 > 历史命令查看命令执行状态:执行成功。

总结

  • 如果插件需要对命令执行结果进行解析,则必须在命令和命令响应中定义mid字段。
  • 命令下发的mid是2个字节,对于每个设备来说,mid从1递增到65535,对应码流为0001到FFFF。
  • 设备执行完命令,命令执行结果上报中的mid要与收到命令中的mid保持一致,这样平台才能刷新对应命令的状态。

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

在文档使用中是否遇到以下问题







请至少选择或填写一项反馈信息

字符长度不能超过200

反馈内容不能为空!

提交反馈 取消