小龙虾
f598b9acb3
更新了 README.md 中关于调试日志与上位机通信的部分，详细说明了当 前通信架构分为两类： 1. 业务通信：HTTP 接口用于 WebUI 与 ESP32 通信 2. 调试镜像：UART0 + UDP 用于独立调试接收器 明确区分了 WebUI 使用的 HTTP 接口功能，并移除了不再需要的心跳包 说明。 refactor(health): 移除健康监控模块的备份文件 删除了 _assistant_backups 目录中的 health_monitor.cpp 和 health_monitor.h 备份文件，清理项目结构。
92 lines
2.7 KiB
C
92 lines
2.7 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 "app_config.h"
|
||
|
||
// 调试日志配置（DEBUG_LOG_IP/PORT/ENABLED 已在 app_config.h 中定义）
|
||
|
||
// UART0 调试配置
|
||
#define UART_DEBUG_TX_GPIO 21
|
||
#define UART_DEBUG_RX_GPIO 20
|
||
#define UART_DEBUG_BAUD_RATE 115200
|
||
|
||
// 日志级别
|
||
typedef enum {
|
||
DEBUG_LOG_NONE = 0,
|
||
DEBUG_LOG_ERR = 1, // 错误
|
||
DEBUG_LOG_WARN = 2, // 警告
|
||
DEBUG_LOG_INFO = 3, // 信息
|
||
DEBUG_LOG_DBG = 4, // 调试
|
||
DEBUG_LOG_ALL = 5 // 全部
|
||
} debug_log_level_t;
|
||
|
||
// 当前日志级别（运行时可改）
|
||
extern debug_log_level_t g_debug_log_level;
|
||
|
||
/**
|
||
* @brief 初始化日志系统，包括 UART 输出、UDP 目标和内部缓冲区。
|
||
* @return ESP_OK 成功，其他失败。
|
||
*/
|
||
esp_err_t debug_log_init(void);
|
||
|
||
/**
|
||
* @brief 初始化 UART0 调试串口。
|
||
* @return ESP_OK 成功，其他失败。
|
||
*/
|
||
esp_err_t uart_debug_init(void);
|
||
|
||
/**
|
||
* @brief 通过 UART0 直接发送一段原始字节数据。
|
||
* @param data 待发送的数据指针。
|
||
* @param len 数据长度。
|
||
* @return ESP_OK 成功，其他失败。
|
||
*/
|
||
esp_err_t uart_debug_send(const uint8_t *data, size_t len);
|
||
|
||
/**
|
||
* @brief 发送原始日志数据到底层输出通道。
|
||
* @param data 日志数据指针。
|
||
* @param len 数据长度。
|
||
* @return ESP_OK 成功，其他失败。
|
||
*/
|
||
esp_err_t debug_log_send(const uint8_t *data, size_t len);
|
||
|
||
/**
|
||
* @brief 按日志级别与标签格式化输出一条日志。
|
||
* @param level 日志级别。
|
||
* @param tag 日志标签。
|
||
* @param fmt 格式化字符串。
|
||
*/
|
||
void debug_log(debug_log_level_t level, const char *tag, const char *fmt, ...);
|
||
|
||
/**
|
||
* @brief 获取当前环形日志缓冲区中的日志条数。
|
||
* @return 当前日志条数。
|
||
*/
|
||
int debug_log_ring_count(void);
|
||
|
||
// 读取并清空环形日志缓冲区，返回 JSON 数组字符串，需由调用者 free。
|
||
char *debug_log_ring_drain_json(int *out_len); // 调用者 free
|
||
|
||
#define DEBUG_ERR(tag, fmt, ...) debug_log(DEBUG_LOG_ERR, tag, fmt, ##__VA_ARGS__)
|
||
#define DEBUG_WARN(tag, fmt, ...) debug_log(DEBUG_LOG_WARN, tag, fmt, ##__VA_ARGS__)
|
||
#define DEBUG_INFO(tag, fmt, ...) debug_log(DEBUG_LOG_INFO, tag, fmt, ##__VA_ARGS__)
|
||
#define DEBUG_DBG(tag, fmt, ...) debug_log(DEBUG_LOG_DBG, tag, fmt, ##__VA_ARGS__)
|
||
|
||
#endif // DEBUG_LOG_H
|