ai-status-light/firmware

AI-Light 固件

基于 ESP32-C3 SuperMini 的桌面状态灯固件，通过 BLE 蓝牙或 MQTT 接收状态指令，控制红绿灯挂件显示 AI 工作状态。

固件版本

版本	文件	通信方式	说明
BLE	ble/ai_light.ino	BLE 蓝牙	无需 WiFi，适合本地使用
MQTT	mqtt/ai_light.ino	WiFi + MQTT	远程控制（V2 红黄互换 + 黄绿互换）

BLE 参数

Device Name:          AI-Light
Service UUID:         b8b7e001-7a6b-4f4f-9a8b-11c0ffee0001
Characteristic UUID:  b8b7e002-7a6b-4f4f-9a8b-11c0ffee0001

写入 UTF-8 字符串即可控制灯效，支持的模式：

模式	灯效	典型场景
init	开机初始化	启动
thinking	跑马灯	AI 分析中
ai	慢速跑马灯	AI 生成中
busy	黄灯慢闪	命令执行中
success	绿灯常亮	任务成功
error	红灯快闪	任务失败
alarm	红黄交替警灯	严重异常
traffic	模拟红绿灯	展示模式
off	全灭	关闭

硬件接线

基于公共正极灯板：

ESP32 3.3V  -> 灯板正极
ESP32 IO2   -> 220Ω -> 绿灯
ESP32 IO3   -> 220Ω -> 红灯
ESP32 IO4   -> 220Ω -> 黄灯

公共正极逻辑：GPIO LOW = 灯亮，GPIO HIGH = 灯灭

烧录方法

1. 安装 Arduino IDE 2.x
2. 安装 ESP32 开发板包：esp32 by Espressif Systems
3. 选择开发板：ESP32C3 Dev Module
4. 打开 .ino 文件，点击 Upload
5. 串口监视器波特率：115200

依赖库（MQTT 版）

• WiFi.h
• PubSubClient.h
• ArduinoJson.h

通过 Arduino IDE → Sketch → Include Library → Manage Libraries 安装。