曲线图
适用范围:蓝牙项目。 蓝牙的图表数据由设备上报;物联 / WiFi 的图表是平台从数据库查询后展示的,设备不需要发曲线帧。本文不适用于那两个产品。
曲线图显示“一段时间内的变化”,例如最近一小时温度怎么走。
它和普通数值组件最大的不同:数值只显示当前一个点,曲线图要一串点 + 时间。
界面上有什么
- 一条或多条线
- 每条线有自己的名字(key)
- 横轴是时间,纵轴是数值
字段:注意不是 bindKey
曲线图用的是图表的 key,不是组件里的 bindKey。
- key 在图表设置里配置,例如
temp、humi - 设备发数据时必须用这个 key
- 页面里的数值组件可以叫别的名字,两者互不影响
和设备的约定
一条数据 = 值 + 毫秒时间戳:
text
$X#C#A,temp,26.5,1750000000000&校验\r\n| 部分 | 意思 |
|---|---|
A | 追加(在已有曲线后面加) |
N | 替换(先清空这条线,再放这一批) |
temp | 图表的 key |
26.5 | 值 |
1750000000000 | 毫秒时间戳 |
规则:
- 值和时间的顺序不能反,必须成对
- 一帧可以带多个点,但别超过单包上限
- 第一次发用
N,之后都用A
设备离线时怎么办
想让“昨天没连手机的数据”也显示出来:
- 设备自己存一份(按天或环形存储)
- 连上后先补历史:第一条用
N,后面用A - 补完再进入实时:每来一个新点发一条
A
注意:每个 key 只能发一次 N,否则前面的历史会被清掉。
页面重新连接
设备记住“最后成功发到哪个时间点”,重连只补这之后的数据。
否则每次重连都重发一遍,曲线会来回跳。
常见错误
| 现象 | 原因 |
|---|---|
| 不画线 | key 和图表配置不一致 |
| 只有一个点,看不到线 | 至少要有两个点 |
| 时间轴全错 | 时间戳不是毫秒,或者设备没对时 |
| 曲线来回跳 | 重连重复回放了历史 |
| 只有最后一段 | 多次发了 N,把前面的覆盖了 |
