● 命令下发的mid是2个字节，对于每个设备来说，mid从1递增到65535，对应码流 为0001到FFFF。
● 设备执行完命令，命令执行结果上报中的mid要与收到命令中的mid保持一致，这 样平台才能刷新对应命令的状态。
字符串及可变长字符串的编解码插件
如果该烟感设备需要支持描述信息上报功能，描述信息支持字符串和可变长度字符串 两种类型，则按照以下步骤创建消息。
产品模型定义
在烟感产品的开发空间完成产品模型定义。
编解码插件开发
步骤1 在烟感产品的开发空间，选择“插件开发”，单击“图形化开发”。
设备接入
开发指南 3 产品开发
步骤2 单击“新增消息”，新增消息“otherinfo”，上报字符串类型的描述信息。配置此步 骤的主要目的是，将设备上传的字符串二进制码流消息解码成JSON格式，以便物联网 平台理解。配置示例如下：
● 消息名：otherinfo
● 消息类型：数据上报
● 添加响应字段：是。添加响应字段后，物联网平台在收到设备上报的数据后，会 下发用户设置的响应数据到设备。
● 响应数据：AAAA0000（默认）
1. 单击“添加字段”，添加messageId字段，表示消息种类。在本场景中，0x0用于 标识上报火灾等级和温度的消息，0x1用于标识只上报温度的消息，0x2用于标识 上报描述信息（字符串类型）的消息。messageID、数据类型、长度、默认值、
偏移值的说明可参考1。
2. 添加other_info字段，表示字符串类型的描述信息。在本场景中，字符串类型的 字段数据类型选择“string”，“长度”配置 6个字节。字段名、默认值、偏移值 的说明可参考2。
设备接入
开发指南 3 产品开发
步骤3 单击“新增消息”，新增“other_info2”消息名，配置数据上报消息，上报可变长度 字符串类型的描述信息。配置此步骤的主要目的是，将设备上传的可变长度字符串二 进制码流消息解码成JSON格式，以便物联网平台理解。配置示例如下：
● 消息名：other_info2
● 消息类型：数据上报
● 添加响应字段：是。添加响应字段后，物联网平台在收到设备上报的数据后，会 下发用户设置的响应数据到设备。
● 响应数据：AAAA0000（默认）
1. 添加messageId字段，表示消息种类。在本场景中，0x0用于标识上报火灾等级和 温度的消息，0x1用于标识只上报温度的消息，0x3用于标识上报描述信息（可变 长度字符串类型）的消息。messageID、数据类型、长度、默认值、偏移值的说 明可参考1。
设备接入
开发指南 3 产品开发
2. 添加length字段，表示可变字符串长度。“数据类型”根据可变长度字符串的长 度进行配置，此场景可变字符串长度在255以内，配置为“int8u”。长度、默认 值、偏移值的说明可参考2。
3. 添加other_info字段，数据类型选择“varstring”，表示可变长度字符串类型的 描述信息。“长度关联字段”选择“length”，“长度关联字段差值”和“数值 长度”自动填充。“掩码”默认为“0xff”。偏移值说明可参考2。
设备接入
开发指南 3 产品开发
步骤4 拖动右侧“设备模型”区域的属性字段，与数据上报消息的相应字段建立映射关系。
步骤5 单击“保存”，并在插件保存成功后单击“部署”，将编解码插件部署到物联网平 台。
----结束
调测编解码插件
步骤1 在烟感产品的开发空间，选择“在线调试”，并单击“新增测试设备”。
步骤2 用户可根据自己的业务场景，选择使用真实设备或者模拟设备进行调测。具体请参考 在线调试。本文以模拟设备为例，调测编解码插件。
在弹出的“新增测试设备”窗口，选择“模拟设备”，单击“确定”，创建一个虚拟 设备。虚拟设备名称包含 “Simulator”字样，每款产品下只能创建一个虚拟设备。
设备接入
开发指南 3 产品开发
步骤3 单击“调试”，进入调试界面。
步骤4 使用设备模拟器上报字符串类型的描述信息。
十六进制码流示例：0231。02表示messageId，此消息上报字符串类型的描述信息；
31表示描述信息，长度为1个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=null}。描述信息不足6个字 节，编解码插件无法解析。
十六进制码流示例：02313233343536。02表示messageId，此消息上报字符串类型的 描述信息；313233343536表示描述信息，长度为6个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=123456}。描述信息长度为 6个字节，编解码插件解析成功。
在“应用模拟器”区域查看数据上报的结果：{other_info=123456}。描述信息长度超 过6个字节，编解码插件截取前6个字节进行解析。
十六进制码流示例：02013132333435。02表示messageId，此消息上报字符串类型的 描述信息；013132333435表示描述信息，长度为6个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=\u000112345}。01在ASCII 码表里表示“标题开始”，无法用具体字符表示，因此编解码插件解析为\u0001。
步骤5 使用设备模拟器上报可变长度字符串类型的描述信息。
十六进制码流示例：030141。03表示messageId，此消息上报可变长度字符串类型的 描述信息；01表示描述信息长度（1个字节），长度为1个字节；41表示描述信息，长 度为1个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=A}。41是A的十六进制 ASCII码。
设备接入
开发指南 3 产品开发
十六进制码流示例：03024142。03表示messageId，此消息上报可变长度字符串类型 的描述信息；02表示描述信息长度（2个字节），长度为1个字节；4142表示描述信 息，长度为2个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=AB}。4142是AB的十六进制 ASCII码。
十六进制码流示例：030341424344。03表示messageId，此消息上报可变长度字符串 类型的描述信息；03表示描述信息长度（3个字节），长度为1个字节；41424344表示 描述信息，长度为4个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=ABC}。描述信息长度超过3 个字节，编解码插件截取前3个字节进行解析，414243是ABC的十六进制ASCII码。
十六进制码流示例：0304414243。03表示messageId，此消息上报可变长度字符串类 型的描述信息；04表示字符串长度（4个字节），长度为1个字节；414243表示描述信 息，长度为4个字节。
在“应用模拟器”区域查看数据上报的结果：{other_info=null}。描述信息长度不足4 个字节，编解码插件解析失败。
总结