Skip to content

第四章 和设备对上 ​

页面做好了,怎么让设备的数据真的动起来?这一章讲最小必要知识。

先看这一句:本章第 2~7 节以蓝牙项目为例($X 文本帧 / 二进制帧)。 物联(MQTT JSON)和 WiFi 的页面操作完全一样,但数据格式不同,见文末「8. 其它产品」。

1. 先想清楚谁发谁收 ​

你的操作谁处理例子
点开关、拖滑块、按按钮页面发给设备light:1、speed:60
看温度、看电量设备发给页面temp:26.5
开关既要能点、又要显示真实状态双向你点 light:1,设备开完回 light:1

页面只负责显示和收集操作,真正做事的是设备。

2. 两种常见通道 ​

通道长什么样什么时候用
文本$X#D#light:1&校验\r\n字段少、调试直观;默认走这个
二进制一串字节,按位表排字段多、要省流量;需要在控制台配“二进制转换表”

页面是文本还是二进制,由项目配置决定;设备必须按同样的方式回。

3. 图表怎么动 ​

图表不看普通字段,它按“一路数据”发:

text
$X#C#A,temp,26.5,1750000000000&校验\r\n
  • temp 是图表的 key(不是组件的 bindKey)
  • 后面是“值 + 毫秒时间戳”,可以一次发多个点
  • 第一次用 N 清空并放一批,后面用 A 追加

页面只管画线,历史数据要设备自己存。

4. 倒计时怎么动 ​

倒计时的值带单位,单位是毫秒:

text
shutdown:start_600000     开始,跑 10 分钟
shutdown:pause_300000     暂停,还剩 5 分钟
shutdown:reset_600000     设成 10 分钟并停下
shutdown:finished         我这边跑完了
  • start_ / pause_ / reset_ 后面必须带毫秒
  • 设备连上后,按当前状态发一条,页面就能恢复显示
  • 详细规则见《倒计时协议》文档

5. 电量 ​

电量是单独的一路,格式固定:

text
$X#SP#capacity:80
  • 0~100 是电量百分比
  • 充电中发 101
  • 不需要电量就别发,页面没有电量组件时发了也没用

6. 在电脑上先验证 ​

不用连设备也能验证页面:

  1. 打开页面编辑器
  2. 进入「AI/模拟调试」
  3. 在“设备发送”里手动发一条 temp:26.5
  4. 看页面上的温度和图表有没有变化

这一步能确认“页面配置对不对”;如果模拟调试正常、接上设备不正常,问题就在设备固件或连接。

7. 让 AI 写设备代码 ​

最省事的方式是让 AI 生成:

  1. 在编辑器里复制「组件描述」
  2. 在控制台「项目秘钥」里复制「设备身份」
  3. 按《用 AI 生成固件》里的模板提问

AI 会按你的字段和设备情况生成固件,包括开机打印蓝牙地址、上报、接收和日志。

8. 其它产品 ​

页面操作(拖组件、起字段名、保存)在三个产品里完全一样,不一样的是数据怎么发。

产品数据长什么样看哪篇
蓝牙(BLE)$X#D#light:1&校验 或二进制帧本章第 2~7 节 + 文本协议、二进制协议
物联(IoT)MQTT 上的 JSON,例如 {"light":1}小机云文本协议
WiFi与物联类似,走网络连接如何使用小机云

一句话区分:

  • 蓝牙是手机直连设备,所以有广播、连接、鉴权
  • 物联/WiFi 是设备连云,所以有服务器地址、密钥、Topic
  • 页面字段(bindKey)三边通用,换产品时页面不用重做,设备和云端要换