小龙虾
51c89b3065
移除固定的包间延迟配置 `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背压机制的描述。
130 lines
4.8 KiB
C++
130 lines
4.8 KiB
C++
/*
|
||
* debug_log.h - 调试日志输出
|
||
*
|
||
* 当前日志会并行写入：
|
||
* - UART0 串口
|
||
* - UDP 单播（独立调试接收端可选）
|
||
* - 环形缓冲区，供 HTTP /logs 拉取
|
||
*
|
||
* 注意：当前 tools/WebUI 日志面板走的是 HTTP /logs，
|
||
* 不是直接监听 UDP 6666。
|
||
*
|
||
* UART0: TX=GPIO21, RX=GPIO20, 115200 波特率
|
||
*/
|
||
#ifndef DEBUG_LOG_H
|
||
#define DEBUG_LOG_H
|
||
|
||
#include <stdint.h>
|
||
#include <stdarg.h>
|
||
#include "esp_err.h"
|
||
#include "freertos/FreeRTOS.h"
|
||
#include "freertos/semphr.h"
|
||
#include "app_config.h"
|
||
#include <sys/socket.h>
|
||
#include <netinet/in.h>
|
||
|
||
// 调试日志配置（DEBUG_LOG_IP/PORT/ENABLED 已在 app_config.h 中定义）
|
||
|
||
// UART0 调试配置
|
||
#define UART_DEBUG_TX_GPIO 21 ///< UART0 TX GPIO 引脚号
|
||
#define UART_DEBUG_RX_GPIO 20 ///< UART0 RX GPIO 引脚号
|
||
#define UART_DEBUG_BAUD_RATE 115200 ///< UART0 波特率
|
||
|
||
// 日志级别
|
||
typedef enum {
|
||
DEBUG_LOG_ERR = 1, // 错误
|
||
DEBUG_LOG_WARN = 2, // 警告
|
||
DEBUG_LOG_INFO = 3, // 信息
|
||
DEBUG_LOG_DBG = 4 // 调试
|
||
} debug_log_level_t;
|
||
|
||
/**
|
||
* @brief 调试日志类（单例）
|
||
*
|
||
* 封装 UART0、UDP 和环形缓冲区三路日志输出通道，
|
||
* 所有内部状态（socket、缓冲区、互斥锁等）均为私有成员。
|
||
*/
|
||
class DebugLog {
|
||
public:
|
||
/**
|
||
* @brief 获取 DebugLog 单例实例。
|
||
* @return DebugLog 引用。
|
||
*/
|
||
static DebugLog& instance();
|
||
|
||
/** @brief 初始化日志系统，包括 UART 输出、UDP 目标和内部缓冲区。 */
|
||
esp_err_t init();
|
||
|
||
/** @brief 初始化 UART0 调试串口。 */
|
||
esp_err_t uartInit();
|
||
|
||
/** @brief 通过 UART0 直接发送一段原始字节数据。 */
|
||
esp_err_t uartSend(const uint8_t *data, size_t len);
|
||
|
||
/** @brief 发送原始日志数据到底层输出通道。 */
|
||
esp_err_t send(const uint8_t *data, size_t len);
|
||
|
||
/** @brief 按日志级别与标签格式化输出一条日志。 */
|
||
void log(debug_log_level_t level, const char *tag, const char *fmt, ...);
|
||
|
||
/** @brief 获取当前环形日志缓冲区中的日志条数。 */
|
||
int ringCount();
|
||
|
||
/** @brief 弹出一条最旧日志并从环形缓冲区移除。 */
|
||
bool ringPopOldest(char *out, size_t out_size, int *out_len);
|
||
|
||
/**
|
||
* @brief 将环形缓冲区所有日志导出为 JSON 数组字符串。
|
||
* @param out_len 输出 JSON 字符串长度。
|
||
* @return 动态分配的 JSON 字符串，调用者须 free()。
|
||
*/
|
||
char* ringDrainJson(int *out_len);
|
||
|
||
/** @brief 当前日志级别（运行时可改）。 */
|
||
debug_log_level_t logLevel = DEBUG_LOG_INFO;
|
||
|
||
private:
|
||
DebugLog() = default;
|
||
~DebugLog() = default;
|
||
DebugLog(const DebugLog&) = delete;
|
||
DebugLog& operator=(const DebugLog&) = delete;
|
||
|
||
int m_udpSock = -1;
|
||
struct sockaddr_in m_debugAddr;
|
||
bool m_initialized = false;
|
||
bool m_uartInitialized = false;
|
||
// 记录 UART 是否真正可用（uartInit 失败时为 false，跳过 uart_write_bytes）。
|
||
// m_uartInitialized 仅表示曾尝试初始化，m_uartAvailable 才是写日志的判据。
|
||
bool m_uartAvailable = false;
|
||
|
||
/* 环形日志：OTA 中继期需保留关键 INFO，64×160≈10KB BSS。 */
|
||
static constexpr int LOG_RING_SLOTS = 64;
|
||
static constexpr int LOG_RING_SIZE = 160;
|
||
char m_logRing[LOG_RING_SLOTS][LOG_RING_SIZE];
|
||
int m_logRingLens[LOG_RING_SLOTS];
|
||
int m_logRingHead = 0;
|
||
int m_logRingCount = 0;
|
||
SemaphoreHandle_t m_logRingMutex = NULL;
|
||
|
||
/* 堆门控（防 OTA 时 UDP/格式化抢 LWIP 堆）：
|
||
* free < kDropWarnFree → 非 OTA/SPI 只保留 ERR
|
||
* free < kDropInfoFree → 非 OTA/SPI 丢 INFO/DBG（OTA/SPI 的 INFO 仍进 ring）
|
||
* free < kSkipUdpFree → 不 sendto（仍 UART+ring）
|
||
* free < kDrainMinFree → /logs 尽量仍返回 ring（降低门槛，避免“沉默失败”） */
|
||
static constexpr uint32_t kDropWarnFree = 6U * 1024U;
|
||
static constexpr uint32_t kDropInfoFree = 10U * 1024U;
|
||
static constexpr uint32_t kSkipUdpFree = 6U * 1024U; // ★ 修复：从 10KB 降至 6KB，sendto 本身不需大块堆
|
||
static constexpr uint32_t kDrainMinFree = 4U * 1024U; // ★ 修复：从 8KB 降至 4KB，降低 /logs 返空的概率
|
||
|
||
esp_err_t ensureUdpSocket();
|
||
void ringPush(const char *data, int len);
|
||
};
|
||
|
||
// 便捷宏 — 直接调用单例方法
|
||
#define DEBUG_ERR(tag, fmt, ...) DebugLog::instance().log(DEBUG_LOG_ERR, tag, fmt, ##__VA_ARGS__) ///< 错误级别日志宏
|
||
#define DEBUG_WARN(tag, fmt, ...) DebugLog::instance().log(DEBUG_LOG_WARN, tag, fmt, ##__VA_ARGS__) ///< 警告级别日志宏
|
||
#define DEBUG_INFO(tag, fmt, ...) DebugLog::instance().log(DEBUG_LOG_INFO, tag, fmt, ##__VA_ARGS__) ///< 信息级别日志宏
|
||
#define DEBUG_DBG(tag, fmt, ...) DebugLog::instance().log(DEBUG_LOG_DBG, tag, fmt, ##__VA_ARGS__) ///< 调试级别日志宏
|
||
|
||
#endif // DEBUG_LOG_H
|