修改固件

firmware/README.md

@@ -6,31 +6,10 @@
 
 `ai_light.ino` 支持 BLE + MQTT 双模式，通过 BOOT 按钮切换。
 
-## Web Bluetooth 配置页面
-
-`web/ble-config.html` 是一个独立的 Web 页面，通过浏览器的 Web Bluetooth API 连接设备进行配置。
-
-### 使用方法
-
-1. 用 **Chrome / Edge / Opera** 浏览器打开 `web/ble-config.html`
-2. 点击 **Connect** 按钮，选择 `AI-Light` 设备
-3. 连接后可查看设备状态、切换灯效、配置 WiFi/MQTT 参数
-4. 点击 **Save & Restart** 保存配置
-
-### 功能
-
-| 功能 | 说明 |
-|------|------|
-| 设备状态 | 显示 WiFi/MQTT 连接状态、当前灯效 |
-| 灯效控制 | 点击按钮切换灯效模式 |
-| WiFi 配置 | SSID、密码 |
-| MQTT 配置 | Broker、Port、用户名、密码、Client ID、Topic |
-
-### 注意事项
-
-- 需要支持 Web Bluetooth 的浏览器（Chrome/Edge/Opera）
-- 首次使用需在 HTTPS 环境或 localhost 打开
-- ESP32 需在 BLE 广播范围内（约 10 米）
+| 通信方式 | 灯效控制 | 配置修改 |
+|---------|---------|---------|
+| BLE | ✅ | ✅ |
+| MQTT | ✅ | ✅ |
 
 ## BLE 参数（双模式版）
 
@@ -55,9 +34,17 @@ Config Characteristic: b8b7e003-7a6b-4f4f-9a8b-11c0ffee0001  (WiFi/MQTT 配置)
 | `error` | 红灯快闪 | 任务失败 |
 | `alarm` | 红黄交替警灯 | 严重异常 |
 | `traffic` | 模拟红绿灯 | 展示模式 |
+| `red` | 红灯常亮 | 手动控制 |
+| `yellow` | 黄灯常亮 | 手动控制 |
+| `green` | 绿灯常亮 | 手动控制 |
+| `idle` | 同 traffic | 空闲状态 |
 | `off` | 全灭 | 关闭 |
 
-### WiFi/MQTT 配置（BLE）
+### WiFi/MQTT 配置
+
+配置可通过 BLE 或 MQTT 进行：
+
+#### BLE 配置
 
 向 Config 特征写入 JSON 配置，设备自动保存到 NVS 并重启：
 
@@ -70,14 +57,43 @@ Config Characteristic: b8b7e003-7a6b-4f4f-9a8b-11c0ffee0001  (WiFi/MQTT 配置)
   "mqtt_user": "mqtt用户名",
   "mqtt_pass": "mqtt密码",
   "mqtt_client": "AI-Light",
-  "mqtt_topic": "opencode/status",
-  "mqtt_status": "openCodeLight/status"
+  "mqtt_topic": "agent/status",
+  "mqtt_status": "agentLight/status",
+  "mqtt_topic_config": "agent/status/config",
+  "pin_red": 4,
+  "pin_green": 3,
+  "pin_yellow": 2,
+  "ota_url": "https://example.com/firmware.bin"
 }
 ```
 
-## 双模式版（combined）
+#### MQTT 配置
+
+向配置 topic 发送 JSON 配置，设备自动保存到 NVS 并重启：
+
+- 默认 topic：`agent/status/config`
+- 可通过 `mqtt_topic_config` 字段自定义
+
+```bash
+# 示例：使用 mosquitto_pub 配置设备
+mosquitto_pub -h 192.168.1.100 -t "agent/status/config" -m '{
+  "wifi_ssid": "你的WiFi名",
+  "wifi_pass": "你的WiFi密码",
+  "mqtt_broker": "192.168.1.100"
+}'
+```
+
+### OTA 固件更新
+
+配置 `ota_url` 后，可通过以下方式触发 OTA：
+- BLE：向 Mode 特征写入 `ota`
+- MQTT：发送 `{"code": "ota"}`
 
-`combined/ai_light.ino` 同时支持 BLE 和 MQTT：
+设备会从 URL 下载固件并自动更新重启。
+
+## 双模式版
+
+`ai_light.ino` 同时支持 BLE 和 MQTT：
 
 | 操作 | 效果 |
 |------|------|
@@ -85,21 +101,36 @@ Config Characteristic: b8b7e003-7a6b-4f4f-9a8b-11c0ffee0001  (WiFi/MQTT 配置)
 
 - **开机始终启动 BLE**，可用于灯效控制和 WiFi/MQTT 配置
 - 默认 MQTT 模式，切换后自动保存到 NVS
-- 使用 `web/ble-config.html` 通过浏览器配置设备
 
 ## 硬件接线
 
-基于公共正极灯板：
+基于公共正极灯板（默认引脚，可通过配置修改）：
 
 ```
 ESP32 3.3V  -> 灯板正极
-ESP32 IO2   -> 220Ω -> 绿灯
-ESP32 IO3   -> 220Ω -> 红灯
-ESP32 IO4   -> 220Ω -> 黄灯
+ESP32 IO4   -> 220Ω -> 红灯（默认）
+ESP32 IO3   -> 220Ω -> 绿灯（默认）
+ESP32 IO2   -> 220Ω -> 黄灯（默认）
+ESP32 IO8   -> 状态 LED（固定）
+ESP32 IO9   -> BOOT 按钮（固定）
 ```
 
 公共正极逻辑：GPIO LOW = 灯亮，GPIO HIGH = 灯灭
 
+### 引脚配置
+
+灯引脚可通过 BLE 或 MQTT 配置动态修改，无需重新烧录：
+
+```json
+{
+  "pin_red": 4,
+  "pin_green": 3,
+  "pin_yellow": 2
+}
+```
+
+配置后设备自动重启生效。状态 LED (IO8) 和 BOOT 按钮 (IO9) 固定不可修改。
+
 ## 烧录方法
 
 1. 安装 [Arduino IDE 2.x](https://www.arduino.cc/en/software)

firmware/ai_light/ai_light.ino

@@ -22,7 +22,7 @@
 //   Mode:     b8b7e002-... (读写/通知 - 灯效模式)
 //   Config:   b8b7e003-... (读写 - WiFi/MQTT 配置 JSON)
 //
-// 配置 JSON 格式（写入 Config 特征）：
+// 配置 JSON 格式（写入 Config 特征或 MQTT config topic）：
 //   {
 //     "wifi_ssid": "xxx",
 //     "wifi_pass": "xxx",
@@ -31,8 +31,9 @@
 //     "mqtt_user": "user",
 //     "mqtt_pass": "pass",
 //     "mqtt_client": "AI-Light",
-//     "mqtt_topic": "opencode/status",
-//     "mqtt_status": "openCodeLight/status",
+//     "mqtt_topic": "agent/status",
+//     "mqtt_status": "agentLight/status",
+//     "mqtt_topic_config": "agent/status/config",
 //     "pin_red": 4,
 //     "pin_green": 3,
 //     "pin_yellow": 2,
@@ -102,8 +103,9 @@ uint16_t cfgMqttPort = 1883;
 String cfgMqttUser = "";
 String cfgMqttPass = "";
 String cfgMqttClient = "AI-Light";
-String cfgMqttTopic = "opencode/status";
-String cfgMqttStatus = "openCodeLight/status";
+String cfgMqttTopic = "agent/status";
+String cfgMqttStatus = "agentLight/status";
+String cfgMqttTopicConfig = "agent/status/config";
 String cfgOtaUrl = "";
 bool otaInProgress = false;
 
@@ -120,8 +122,9 @@ void loadConfig() {
   cfgMqttUser = preferences.getString("mqtt_user", "");
   cfgMqttPass = preferences.getString("mqtt_pass", "");
   cfgMqttClient = preferences.getString("mqtt_client", "AI-Light");
-  cfgMqttTopic = preferences.getString("mqtt_topic", "opencode/status");
-  cfgMqttStatus = preferences.getString("mqtt_status", "openCodeLight/status");
+  cfgMqttTopic = preferences.getString("mqtt_topic", "agent/status");
+  cfgMqttStatus = preferences.getString("mqtt_status", "agentLight/status");
+  cfgMqttTopicConfig = preferences.getString("mqtt_topic_cfg", "agent/status/config");
   redPin = preferences.getUInt("pin_red", 4);
   greenPin = preferences.getUInt("pin_green", 3);
   yellowPin = preferences.getUInt("pin_yellow", 2);
@@ -142,6 +145,7 @@ String getConfigJson() {
   doc["mqtt_client"] = cfgMqttClient;
   doc["mqtt_topic"] = cfgMqttTopic;
   doc["mqtt_status"] = cfgMqttStatus;
+  doc["mqtt_topic_config"] = cfgMqttTopicConfig;
   doc["comm_mode"] = useMQTT ? 1 : 0;
   doc["pin_red"] = redPin;
   doc["pin_green"] = greenPin;
@@ -179,6 +183,8 @@ void saveConfigFromJson(const String& json) {
     preferences.putString("mqtt_topic", doc["mqtt_topic"].as<String>());
   if (doc.containsKey("mqtt_status"))
     preferences.putString("mqtt_status", doc["mqtt_status"].as<String>());
+  if (doc.containsKey("mqtt_topic_config"))
+    preferences.putString("mqtt_topic_cfg", doc["mqtt_topic_config"].as<String>());
   if (doc.containsKey("pin_red"))
     preferences.putUInt("pin_red", doc["pin_red"].as<uint8_t>());
   if (doc.containsKey("pin_green"))
@@ -552,6 +558,11 @@ void mqttCallback(char* topic, byte* payload, unsigned int length) {
   for (unsigned int i = 0; i < length; i++) message += (char)payload[i];
   Serial.print("MQTT: "); Serial.print(topic); Serial.print(" -> "); Serial.println(message);
 
+  if (String(topic) == cfgMqttTopicConfig) {
+    saveConfigFromJson(message);
+    return;
+  }
+
   JsonDocument doc;
   if (deserializeJson(doc, message)) { setMode(message); return; }
   const char* code = doc["code"];
@@ -606,6 +617,7 @@ bool connectMQTT() {
     if (mqttClient.connect(cfgMqttClient.c_str(), cfgMqttUser.c_str(), cfgMqttPass.c_str())) {
       Serial.println("\nMQTT OK.");
       mqttClient.subscribe(cfgMqttTopic.c_str());
+      mqttClient.subscribe(cfgMqttTopicConfig.c_str());
       allOff(); breathingGreen(3); publishStatus();
       return true;
     }