# AI-Light 固件

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

## 固件版本

| 版本 | 文件 | 通信方式 | 说明 |
|------|------|----------|------|
| BLE | `ble/ai_light.ino` | BLE 蓝牙 | 无需 WiFi，适合本地使用 |
| MQTT v1 | `mqtt/ai_light.ino` | WiFi + MQTT | 远程控制 |
| MQTT v2 | `mqtt/ai_light_v2.ino` | WiFi + MQTT | 改进版 |

## 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](https://www.arduino.cc/en/software)
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 安装。