• 沒有找到結果。

添加temperature字段,表示温度。

数据上报和命令下发

3. 添加temperature字段,表示温度。

– “数据类型”,在产品模型中,temperature属性的“数据类型”为int,最 大值1000,因此在插件中定义temperature字段的“数据类型”为

“int16u”,以满足temperature属性的取值范围。

– “偏移值”是根据与首字段的间隔的字符数自动配置的。“temperature”字 段的起始位置就是前一字段的终点,前一字段“level”的终点位置为2,所以

“temperature”字段的起始位置为2。“temperature”字段长度为2个字 节,终点为4。所以“偏移值”为2-4。

– “长度”根据数据类型的配置自动填充。

– “默认值”不填,此处温度temperature的值不固定,无默认值。

步骤3 单击“新增消息”,新增“SET_ALARM”消息,设置火灾告警的温度阈值。例如超过 60摄氏度,设备上报告警。配置此步骤的主要目的是,将平台下发的JSON格式命令消 息编码成二进制数据,以便烟感设备理解。配置示例如下:

● 消息名:SET_ALARM

● 消息类型:命令下发

● 添加响应字段:是。添加响应字段后,设备在接收命令后,可以上报命令执行结 果。您可以根据自己的需求,选择是否添加响应字段。

设备接入

开发指南 3 产品开发

a. 单击“添加字段”,添加messageId字段,表示消息类型。例如,设置火灾 告警阈值的消息类型为0x3。messageId、数据类型、长度、默认值、偏移值 的说明可参考1。

b. 添加mid字段。这里的mid字段是由平台生成和下发的,用于将下发的命令和 命令下发响应消息关联。mid字段的数据类型默认为int16u。长度、默认值、

偏移值的说明可参考2。

设备接入

开发指南 3 产品开发

c. 添加value字段,表示下发命令的参数值。例如,下发火灾告警的温度阈值。

数据类型、长度、默认值、偏移值的说明可以参考2。

d. 单击“添加响应字段”,添加“messageId”字段,表示消息类型。命令下 发响应消息为上行消息,需要通过messageId和数据上报消息进行区分。上 报火灾告警温度阈值的消息类型为0x4。messageID、数据类型、长度、默认 值、偏移值的说明可参考1。

设备接入

开发指南 3 产品开发

e. 添加mid字段。这里的mid字段需要跟平台下发的命令里的mid字段保持一 致,用于将下发的命令和命令执行结果进行关联。mid字段的数据类型默认为 int16u。长度、默认值、偏移值的说明可参考2。

f. 添加errcode字段,用于表示命令执行状态:00表示成功,01表示失败,如果 未携带该字段,则默认命令执行成功。errcode字段的数据类型默认为int8u。

长度、默认值、偏移值的说明可参考2。

设备接入

开发指南 3 产品开发

g. 添加result字段,用于表示命令执行结果。例如,设备向平台返回当前的告警 阈值。

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

步骤5 单击“保存”,并在插件保存成功后单击“部署”,将编解码插件部署到物联网平 台。

设备接入

开发指南 3 产品开发

----结束

调测编解码插件

步骤1 在烟感产品的开发空间,选择“在线调试”,并单击“新增测试设备”。

步骤2 用户可根据自己的业务场景,选择使用真实设备或者模拟设备进行调测。具体请参考 在线调试。本文以模拟设备为例,调测编解码插件。

在弹出的“新增测试设备”窗口,选择“模拟设备”,单击“确定”,创建一个虚拟 设备。虚拟设备名称包含 “Simulator”字样,每款产品下只能创建一个虚拟设备。

步骤3 单击“调试”,进入调试界面。

步骤4 使用设备模拟器进行数据上报。十六进制码流示例:0008016B。00为地址域 meaasgeID,08表示火灾级别level,长度为1个字节;016B表示温度,长度为2个字 节。

在“应用模拟器”区域查看数据上报的结果:{level=8, temperature=363}。8为十六 进制数08转换为十进制的数值;363为十六进制数016B转换为十进制的数值。

在设备模拟器区域看到平台下发的响应数据AAAA0000。

----结束 总结

● 如果插件需要对命令执行结果进行解析,则必须在命令和命令响应中定义mid字 段。

● 命令下发的mid是2个字节,对于每个设备来说,mid从1递增到65535,对应码流 为0001到FFFF。

● 设备执行完命令,命令执行结果上报中的mid要与收到命令中的mid保持一致,这 样平台才能刷新对应命令的状态。