用 AI 生成固件
目标:把控制台里的页面配置交给 AI,让它直接写出能烧录的 BLE 固件。 AI 不知道的部分(用哪块板子、接什么传感器、用哪些引脚)由它向你提问,你回答即可。
# 准备材料
| 材料 | 从哪里拿 | 说明 |
|---|---|---|
| 组件描述 | 页面编辑器 → 模拟调试 → 左侧「组件描述」→ 复制 | 页面有哪些字段、类型、方向、量程 |
| 位表 JSON | 页面编辑器 → 二进制转换表 → 查看 JSON → 复制 | 字节/bit 布局与项目身份;文本协议项目不需要 |
| 协议文档 | 本文末尾的链接 | 帧格式、鉴权、编码规则 |
| 平台与接线 | 你自己决定 | 板子型号、框架、引脚、传感器 |
位表 JSON 含项目密钥
位表 JSON 里的 ProjectSecret 是设备身份凭证,只应粘贴给你信任的 AI 工具。 不要发到公开聊天、论坛或 Issue 里。
# 操作步骤
- 在控制台打开要对接的页面,进入「模拟调试」,复制组件描述。
- 如果是二进制项目,打开「二进制转换表」,点「查看 JSON」,复制整段内容。
- 打开 AI 工具,按下面的模板提问。
- AI 会先向你确认平台与接线,回答完再让它写代码。
- 生成后按「验收」一节自测。
提问模板
text
你是嵌入式工程师,要为一个「小机云蓝牙」项目写设备固件。
项目信息与位表(JSON):
<粘贴位表 JSON>
页面字段描述(JSON):
<粘贴组件描述>
协议参考:
- 二进制协议:https://m.xsgee.com/manual-ble/二进制协议.html
- 设备校验 HMAC:https://m.xsgee.com/manual-ble/设备校验%20HMAC.html
- 组件语义:https://m.xsgee.com/manual-ble/组件语义.html
要求:
1. 先检查材料是否完整,缺什么直接问我,不要猜。
2. 先输出一张 IO 表(字段 | 方向 | 引脚 | 器件 | 换算),等我确认。
3. 再按表驱动的方式写代码:协议与鉴权用现成 SDK,只把映射表和硬件读写留空。
4. 不要修改协议常量,不要臆造 SDK API;不确定就问我。
5. 最后给出自测步骤。# AI 会问你什么
正常情况下只有三类:
- 平台:ESP32 / STM32 / 其他,Arduino 还是 ESP-IDF,SDK 版本。
- 接线:每个可写字段对应哪个引脚或哪个传感器(如开关 → 继电器 GPIO7)。
- 数据来源:每个只读字段从哪里读(如温度 → DHT22,上报周期)。
平台和引脚无法从控制台推断,回答得越具体,生成的代码越接近可用。
# 验收
生成代码后,至少确认:
- 鉴权能通过(日志出现认证成功,收不到
0x0E)。 - 页面操作能到达设备(开关、滑块、按钮)。
- 设备上报能改变页面(数值、图表追加、设备状态电量)。
- 属性帧电量正确(不是 rssi 的数值)。
- 越界值被钳位,没有出现负数或跳变。
调试时可继续用控制台「模拟调试」当作假设备,向页面发数据,验证上行显示。
