Skip to content

用 AI 生成固件 ​

目标:把控制台里的页面配置交给 AI,让它直接写出能烧录的 BLE 固件。 AI 不知道的部分(用哪块板子、接什么传感器、用哪些引脚)由它向你提问,你回答即可。

# 准备材料 ​

材料从哪里拿说明
组件描述页面编辑器 → 模拟调试 → 左侧「组件描述」→ 复制页面有哪些字段、类型、方向、量程
位表 JSON页面编辑器 → 二进制转换表 → 查看 JSON → 复制字节/bit 布局与项目身份;文本协议项目不需要
协议文档本文末尾的链接帧格式、鉴权、编码规则
平台与接线你自己决定板子型号、框架、引脚、传感器

位表 JSON 含项目密钥

位表 JSON 里的 ProjectSecret 是设备身份凭证,只应粘贴给你信任的 AI 工具。 不要发到公开聊天、论坛或 Issue 里。

# 操作步骤 ​

  1. 在控制台打开要对接的页面,进入「模拟调试」,复制组件描述。
  2. 如果是二进制项目,打开「二进制转换表」,点「查看 JSON」,复制整段内容。
  3. 打开 AI 工具,按下面的模板提问。
  4. AI 会先向你确认平台与接线,回答完再让它写代码。
  5. 生成后按「验收」一节自测。

提问模板 ​

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 会问你什么 ​

正常情况下只有三类:

  1. 平台:ESP32 / STM32 / 其他,Arduino 还是 ESP-IDF,SDK 版本。
  2. 接线:每个可写字段对应哪个引脚或哪个传感器(如开关 → 继电器 GPIO7)。
  3. 数据来源:每个只读字段从哪里读(如温度 → DHT22,上报周期)。

平台和引脚无法从控制台推断,回答得越具体,生成的代码越接近可用。

# 验收 ​

生成代码后,至少确认:

  • 鉴权能通过(日志出现认证成功,收不到 0x0E)。
  • 页面操作能到达设备(开关、滑块、按钮)。
  • 设备上报能改变页面(数值、图表追加、设备状态电量)。
  • 属性帧电量正确(不是 rssi 的数值)。
  • 越界值被钳位,没有出现负数或跳变。

调试时可继续用控制台「模拟调试」当作假设备,向页面发数据,验证上行显示。

# 相关文档 ​