第四章 和设备对上
页面做好了,怎么让设备的数据真的动起来?这一章讲最小必要知识。
先看这一句:本章第 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\ntemp是图表的 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:800~100是电量百分比- 充电中发
101 - 不需要电量就别发,页面没有电量组件时发了也没用
6. 在电脑上先验证
不用连设备也能验证页面:
- 打开页面编辑器
- 进入「AI/模拟调试」
- 在“设备发送”里手动发一条
temp:26.5 - 看页面上的温度和图表有没有变化
这一步能确认“页面配置对不对”;如果模拟调试正常、接上设备不正常,问题就在设备固件或连接。
7. 让 AI 写设备代码
最省事的方式是让 AI 生成:
- 在编辑器里复制「组件描述」
- 在控制台「项目秘钥」里复制「设备身份」
- 按《用 AI 生成固件》里的模板提问
AI 会按你的字段和设备情况生成固件,包括开机打印蓝牙地址、上报、接收和日志。
8. 其它产品
页面操作(拖组件、起字段名、保存)在三个产品里完全一样,不一样的是数据怎么发。
| 产品 | 数据长什么样 | 看哪篇 |
|---|---|---|
| 蓝牙(BLE) | $X#D#light:1&校验 或二进制帧 | 本章第 2~7 节 + 文本协议、二进制协议 |
| 物联(IoT) | MQTT 上的 JSON,例如 {"light":1} | 小机云文本协议 |
| WiFi | 与物联类似,走网络连接 | 如何使用小机云 |
一句话区分:
- 蓝牙是手机直连设备,所以有广播、连接、鉴权
- 物联/WiFi 是设备连云,所以有服务器地址、密钥、Topic
- 页面字段(
bindKey)三边通用,换产品时页面不用重做,设备和云端要换
