feat(ota): 实现GD32 OTA包间背压机制,优化传输节奏控制
移除固定的包间延迟配置 `OTA_PACKET_DELAY_MS`,采用基于SPI Link v2 CREDIT背压的动态节奏控制,在SpiMaster中通过remoteCredit==0时wait/拒发 实现流量控制,提高OTA传输稳定性。 refactor(stack): 统一任务栈大小配置并添加CPU统计功能 - 在app_config.h中集中定义所有任务栈大小常量,基于实测水位优化分配 - 新增monitor/cpu_stats.cpp组件,提供1Hz FreeRTOS CPU占用采样 - 更新main.cpp中的任务创建使用新的栈大小常量 - 调整health_monitor和ota_relay等任务的栈分配 perf(ota): 改进ESP32和GD32 OTA分区预擦策略 - ESP32 OTA从边写边擦改为整分区预擦模式,避免写入时的扇区擦除阻塞 - GD32 OTA在prepare阶段进行整分区预擦,提升后续写入吞吐量 - 优化OTA协调器状态管理,修复FINALIZING状态残留问题 fix(log): 改进UDP日志发送的堆内存管理 - 当堆内存不足时记录UDP发送跳过的告警信息到ring buffer - 降低UDP发送跳过的内存阈值从10KB到6KB - 降低日志排水最小内存阈值从8KB到4KB docs(readme): 更新OTA配置参数文档说明 移除已废弃的OTA_PACKET_DELAY_MS参数,更新包间节奏控制说明为 基于CREDIT背压机制的描述。
This commit is contained in:
+9
-11
@@ -63,15 +63,15 @@ typedef enum {
|
||||
} ota_result_t;
|
||||
|
||||
// ============================================================
|
||||
// IRelayListener - 中继事件监听接口(解决 H4 双向耦合)
|
||||
// IRelayListener - 中继事件监听接口
|
||||
// ============================================================
|
||||
// OtaCoordinator 实现此接口并注册到 OtaRelay,
|
||||
// OtaRelay 通过接口回调通知协调器,不再直接 #include ota_coordinator.h。
|
||||
// 依赖方向变为单向:OtaCoordinator → OtaRelay(通过接口)。
|
||||
// 依赖方向为单向:OtaCoordinator → OtaRelay(通过接口)。
|
||||
/**
|
||||
* @brief 中继事件监听器接口。
|
||||
* OtaCoordinator 实现此接口,OtaRelay 通过回调通知状态变更,
|
||||
* 消除 OtaRelay → OtaCoordinator 的直接依赖(解决 H4 双向耦合)。
|
||||
* 避免 OtaRelay → OtaCoordinator 的直接依赖。
|
||||
*/
|
||||
class IRelayListener {
|
||||
public:
|
||||
@@ -181,7 +181,7 @@ public:
|
||||
*/
|
||||
void reset();
|
||||
|
||||
// ── 中继事件监听器(解决 H4 双向耦合)──
|
||||
// ── 中继事件监听器 ──
|
||||
/**
|
||||
* @brief 注册中继事件监听器(由 OtaCoordinator 在 init 时调用)。
|
||||
* @param listener 监听器指针,传 nullptr 取消注册。
|
||||
@@ -193,7 +193,7 @@ public:
|
||||
*/
|
||||
static IRelayListener* getRelayListener();
|
||||
|
||||
// ── 队列访问器(解决 M3: 封装 public static 成员)──
|
||||
// ── 队列访问器 ──
|
||||
/**
|
||||
* @brief 获取事件分发队列句柄。
|
||||
* 外部模块(OtaCoordinator / BLE)通过 getter 访问,不再直接引用静态成员。
|
||||
@@ -207,8 +207,6 @@ public:
|
||||
*/
|
||||
static QueueHandle_t getResultQueue();
|
||||
|
||||
// ── Flash 操作已迁移至 Gd32FlashStore(storage/gd32_flash_store.h)──
|
||||
|
||||
// ── 线程安全锁 ──
|
||||
static void initMutex(); ///< 初始化状态互斥锁(taskEntry 首行调用)
|
||||
static constexpr TickType_t kLockTimeout = pdMS_TO_TICKS(50); ///< 锁获取超时时间
|
||||
@@ -239,11 +237,11 @@ public:
|
||||
static constexpr size_t GD32_CHALLENGE_RESPONSE_LEN = 36;
|
||||
|
||||
private:
|
||||
// ── 队列(M3: 由 getter 访问,外部不再直接引用)──
|
||||
// ── 队列(由 getter 访问)──
|
||||
static QueueHandle_t dispatchQueue; ///< 事件分发队列
|
||||
static QueueHandle_t resultQueue; ///< 结果回传队列
|
||||
|
||||
// ── 状态成员(全部改 private,统一通过 public setter/getter 访问)──
|
||||
// ── 状态成员(统一通过 public setter/getter 访问)──
|
||||
// 外部代码使用 getState()/getRelaySeq()/... 读取,setState()/setRelaySeq()/... 写入。
|
||||
// 内部代码:若已在 StateLockGuard 块内(reset/getSnapshot/启动探测),可直接访问;
|
||||
// 否则必须使用 setter/getter,禁止裸读写(消除数据竞争)。
|
||||
@@ -252,7 +250,7 @@ private:
|
||||
static uint32_t relayTotalPackets; ///< 本次中继总包数
|
||||
static volatile bool gd32AppAlive; ///< GD32 APP 存活标志
|
||||
static gd32_version_t gd32Version; ///< GD32 固件版本信息
|
||||
static IRelayListener *s_relayListener; ///< 中继事件监听器(解决 H4)
|
||||
static IRelayListener *s_relayListener; ///< 中继事件监听器
|
||||
static SemaphoreHandle_t s_stateMutex; ///< 状态成员互斥锁(由 StateLockGuard 使用)
|
||||
|
||||
// taskHandle 为 write-once-at-init 字段:仅 taskEntry 启动首行写入一次,
|
||||
@@ -331,7 +329,7 @@ private:
|
||||
/**
|
||||
* @brief 发送单包并等待 ACK(doRelayPackets 子步骤)。
|
||||
*
|
||||
* 内含重试循环,使用以下命名常量(与历史阈值保持一致):
|
||||
* 内含重试循环,使用以下命名常量:
|
||||
* kMaxResendOnNack=10(ACK 失败/轮询耗尽重发上限)
|
||||
* kMaxResendOnStructError=3(结构化错误重发上限)
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user