#设备通信协议

#一、WiFi

#1. 什么是 WiFi

• 具体介绍查看 WiFi 基础知识 wiki 或 WiFi 基础知识 百科

#2. 项目开发

• 注意事项
  • WiFi、BLE、Zigbee设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致。
  • WiFi 设备离线提示时间在 150s 左右，即设备离线后 150s 后才会发送事件给 APP 通知。

#二、BLE

#1. 什么是 BLE

• 具体介绍查看 BLE 基础知识 wiki 或 BLE 基础知识 百科

#2. 项目开发

• 注意事项
  • BLE 设备通过蓝牙直连，可能存在断网使用场景（缓存必要数据或必须联网的能力需要进行提示），开发时需要考虑。
  • WiFi、BLE、Zigbee设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致。
  • WiFi 设备离线提示时间在 150s 左右，即设备离线后 150s 后才会发送事件给 APP 通知。

#三、Beacon

#1. 什么是 Beacon

• 具体介绍查看 Beacon 基础知识 wiki 或 WiFi 基础知识 百科

#2. 项目开发

• 注意事项
  • 由于 Beacon 协议的特殊性，控制指令延时比较严重， Beacon 设备下发 DP 之后，APP SDK 会直接把 DP 上报给面板。 如果设备再上报 DP， 在快速控制的时候，经常面板状态和设备状态不一致
  • 如果需要持久化，面板端进行云端保存然后同步
    • 保存数据：import { saveDevProperty } from '@ray-js/ray';
    • 获取数据：import { getDevProperty } from '@ray-js/ray';
  • Sig Mesh、Beacon 设备滑动过程中，灯不会跟随变化，需要松开滑块，面板与灯光颜色一致
  • 打开设备面板，APP 只会接收 30s 的数据，超过这个时间，APP 就不再接收了。如果需要修改该限制，可以定制面板， 所以在 Beacon 设备配网后，APP立即控制，设备端上报，面板能够正常显示，但过一段时间后设备端主动上报，面板不能正常显示

#四、BLE Mesh

#1. 什么是 BLE Mesh

• 具体介绍查看 BLE Mesh 基础知识 百科

#2. 项目开发

• 注意事项
  • 需要在开发过程中注意 DP 同步问题，不建议高频上报下发数据，可能引起数据风暴，导致丢包。
  • 需要主动查询非标准 DP ，DP Id > 50的一般都属于非标准 DP。
  • 群组暂不支持高级定时
  • 不支持的dp
    • control_data （实时下发数据，频率过高）
  • 面板需要根据 Sig Mesh 设备是否添加到网关下
    • 判断方法 useIsSigmeshGatewayConnected
  • Sig Mesh、Beacon 设备滑动过程中，灯不会跟随变化，需要松开滑块，面板与灯光颜色一致。

#五、Zigbee

#1. 什么是 Zigbee

• 具体介绍查看 Zigbee 基础知识 百科

#2. 项目开发

• 注意事项
  • WiFi、BLE、Zigbee 设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致
  • WiFi 设备离线提示时间在150s左右，即设备离线后 150s 后才会发送事件给 APP 通知