小龙虾
a93dba60d2
- 新增 ota_channel_t(WiFi/BLE) + m_otaEpoch 会话代次， abortCurrentIfEpoch 防止同类型重启后旧 handler 误清新会话 - 同通道再次发起 OTA 时自动中止旧会话并重开 - 统一 prepareGd32Storage(validate+begin+erase+meta)， 消除 BLE/WiFi 两路径隐式差异 - OtaRelay 拆分子步骤(doRelayPackets/doFinishAndVerify)， 状态成员私有化消除数据竞争 - Gd32FlashStore NVS 读写加 mutex，metaUpdate 原子化 - BLE OTA 新增 0xFB 中止命令（保持连接）+ 0x20 ABORTED 处理 - HTTP handler 改 per-request buffer 支持并发 - 修复 CRITICAL 状态 RSSI 恢复无法降级的缺陷 - main.cpp 关键任务失败触发看门狗重启 - style.css 增强动画 + prefers-reduced-motion 兼容
4.8 KiB
4.8 KiB
Tasks
-
Task 1: 快速清理仓库根临时文件
- SubTask 1.1: 删除
old_wifi_ota.cpp.tmp、original_app.js.tmp、appjs_diff.txt、build_baseline.log、build_output.log - SubTask 1.2: 评估
sdkconfig.bak.mbedtls_trim/sdkconfig.ci.c3eco7/sdkconfig.ci.esp32c2*/sdkconfig.ci.wpa_psk是否与 ESP32-C3FH4 目标相关，无关则删除（需确认未被 CMake/CI 引用）— 已确认未被 CMake/CI 引用，均为其他芯片变体配置，已删除
- SubTask 1.1: 删除
-
Task 2: A.2 — OtaCoordinator 状态查询单次取值
- SubTask 2.1:
isIdle()改为ota_system_state_t s = getSystemState();后一次比较 IDLE/STORED/COMPLETE - SubTask 2.2:
isGd32Busy()已是单次取值，确认无需改动 - SubTask 2.3:
isEsp32Busy()已是单次取值，确认无需改动 - SubTask 2.4:
getSystemStateString()改为switch(getSystemState())单次取值（当前每次 case 隐式调用）
- SubTask 2.1:
-
Task 3: A.1 — OtaCoordinator 9 个存储 wrapper inline 化
- SubTask 3.1: 在
ota_coordinator.h中将writeGd32Chunk/saveGd32Meta/loadGd32Meta/updateGd32Meta/clearGd32Meta/verifyGd32Firmware/finalizeGd32Checksum/eraseGd32Partition改为inline实现并直接委托Gd32FlashStore::instance() - SubTask 3.2: 删除
ota_coordinator.cpp中这 8 个函数的对应实现（注意writeGd32Chunk等） - SubTask 3.3: 确认头文件已
#include "storage/gd32_flash_store.h"（当前已包含）
- SubTask 3.1: 在
-
Task 4: B — WiFi HTTP URI 路由表化
- SubTask 4.1: 在
wifi_ota.cpp::httpServerStart()顶部定义UriEntry { uri, method, handler }静态数组，列出 9 个端点 - SubTask 4.2: 用 for 循环对每个 entry 注册主 method + HTTP_OPTIONS（
http_options_handler） - SubTask 4.3: 保留 NVS 恢复固件状态的前置逻辑与启动日志不变
- SubTask 4.4: 确认
max_uri_handlers=32仍足够（9×2=18，余量充足）
- SubTask 4.1: 在
-
Task 5: C — OtaRelay 事件分发去重
- SubTask 5.1: 在
ota_relay.cpp匿名命名空间添加commonReject(relay_event_t e, bool allowHealth=false)，返回OTA_RESULT_OK或对应错误码（不改状态） - SubTask 5.2:
handleHandshaking/handleSizeNeg/handleTransferring/handleFinishing开头调用commonReject，仅在其返回非 OK 时setState(RELAY_ERROR)并返回（handleTransferring传allowHealth=true） - SubTask 5.3:
forwardFirmware()将 5 次顺序processEvent(START)改为 while 循环：当前状态非 DONE/ERROR 时持续推进，任一步非 OK 即跳出；去掉goto cleanup，失败路径统一reset() - SubTask 5.4: 保持 5 步驱动顺序与"同步 handler 执行后才检查超时"的语义不变
- SubTask 5.1: 在
-
Task 6: D — SpiMaster *Unlocked 镜像折叠
- SubTask 6.1: 保留
transferClocked/transferRequestResponse/otaPollResponseUnlocked作为内部 Impl（已持锁路径调用） - SubTask 6.2:
syncTransfer公共 API：LockGuard+ 直接调transferRequestResponse（删除syncTransferUnlocked，其唯一调用方transferWithRetry改为调transferRequestResponse） - SubTask 6.3:
send公共 API：LockGuard+ 直接调transferRequestResponse（删除sendUnlocked，确认无外部调用方） - SubTask 6.4:
otaPollResponse公共 API：LockGuard+ 调otaPollResponseUnlocked（保持不变，已是该模式） - SubTask 6.5: 更新
spi_master.h：移除已删除的syncTransferUnlocked/sendUnlocked声明
- SubTask 6.1: 保留
-
Task 7: F — HealthMonitor RAII LockGuard
- SubTask 7.1: 在
health_monitor.h私有区添加LockGuard内部类（与 SpiMaster 风格一致：构造 take portMAX_DELAY，析构 give，禁拷贝） - SubTask 7.2:
getState/setState/getLastTemperature/getLastWifiRssi/tempMonitorCallback改用LockGuard lock(m_mutex); - SubTask 7.3:
setWifiConnected中m_wifiConnected为volatile，确认是否仍需加锁（当前未加锁，保持现状，仅文档化其为原子推送）
- SubTask 7.1: 在
-
Task 8: 编译验证
- SubTask 8.1: 运行
idf.py build确认无编译错误/警告回归（15 个源文件 0 warning / 0 error，CMake 配置 + 编译阶段均通过；ninja 链接阶段因 TRAE 沙箱与 Windows overlapped I/O 不兼容无法在 IDE 内执行，需在 ESP-IDF PowerShell 终端外完成） - SubTask 8.2: 确认
main/行数减少符合预期（关键削减：httpServerStart 173→67、ota_coordinator.cpp 8 wrapper 删除、spi_master.cpp 2 Unlocked 删除、ota_relay.cpp goto 重构）
- SubTask 8.1: 运行
Task Dependencies
- Task 3（A.1 inline 化）依赖 Task 2（A.2）先完成，避免合并冲突
- Task 5（OtaRelay）与 Task 6（SpiMaster）独立，可并行
- Task 7（HealthMonitor）独立，可并行
- Task 8（编译验证）依赖 Task 2~7 全部完成