edit

通讯协议

声明:MCU和模块通信采用的是48帧协议,包括上报帧及下发帧。格式定义及说明请参考《氦氪云一体化客户对接文档-单片机》
本文档只涉及APP或云端与设备之间的通信;根据帧类型表的取值,上报帧为0x01、下发帧为0x02。对于上报帧和下发帧,需要通过创建产品协议来实现。

对应帧说明

上报帧

应用:此类帧应用于MCU主动上报数据给APP,供APP端监控设备状态,因此也称为设备状态上报帧。

上报帧使用规范

  • 上报帧格式:请参考console产品协议中上报帧对应的示例帧。如何查看console产品协议?
  • 上报参数范围:需要在产品协议定义的取值范围内,比如产品协议中参数温度的取值范围为0~60℃,如果上报帧中温度值不在此范围内,则上报不成功,APP将无法接收到该帧。
  • 模块应答:上报帧发送给模块后,模块会原帧返回作为应答(如果发送帧有误,则模块应答错误帧)。
  • APP实时显示设备状态:APP端支持间隔30S下发查询帧查看设备状态。温度数值等自身状态快速变化的无需主动上报。
  • 设备定时上报:主要用于历史统计等功能,请按照HEKR项目经理建议设置定时上报(最短间隔5分钟),不支持实时或间隔小于5分钟的定时上报,否则会影响页面操作及正常使用。
  • 帧间隔时间:必须大于200ms,否则模块接收处理时可能造成丢帧。帧间隔时间适用于所有帧类型。

下发帧

应用:此类帧应用于APP主动发送控制设备的指令,经由模块下发至MCU。

下发帧使用规范

  • 模块将来自APP的数据帧下发后会等待设备MCU返回应答帧,超时时间为3s;MCU须在超时时间内进行应答,原帧返回即可。
  • 如果下发帧出现错误,设备不应答即可,APP上会自动提示响应超时,请重试。
  • MCU应答后还需上报一帧设备状态上报帧。