控制台日志实现迁出HAL生成文件至App/log并新增设计说明;defaultTask任务体迁至App/task,freertos.c恢复纯CubeMX接线形态
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
/*
|
||||
* 模块名称:Console Single-Writer Logging — 控制台单写者日志(USART1 调试串口)
|
||||
* 模块功能:调试控制台单写者环形缓冲的公共 API:所有任务/上下文(含 printf)只把
|
||||
* 已格式化整行文本入环形缓冲,写者任务(defaultTask)为唯一
|
||||
* HAL_UART_Transmit 发送点(行级原子 + 指针可控)
|
||||
* 使用方法:
|
||||
* 1. 生产者:DBG_ERROR/DBG_INFO/DBG_DEBUG 宏(dbg_log.h,内部用库 snprintf
|
||||
* 有界格式化整行后调 dbg_console_write_line);或直接调 dbg_console_write_line
|
||||
* 2. 写者任务:进入主循环前调 dbg_console_writer_attach() 注册为唯一发送者,
|
||||
* 循环中周期调 dbg_console_drain() 排空(defaultTask 已接线,见 Src/freertos.c)
|
||||
* 适用平台:STM32F407ZGTx(仅 MCU 端;模拟器不编译本模块——模拟器 DBG_*
|
||||
* 直接映射 printf,见 simulator/dbg_log.h)
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-09-24
|
||||
* 修改记录:
|
||||
* 2026-09-24 王建锋 创建(自 Src/usart.c USER CODE 区迁出:
|
||||
* HAL 库生成文件不得包含应用代码)
|
||||
*/
|
||||
|
||||
#ifndef CONSOLE_LOG_H
|
||||
#define CONSOLE_LOG_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#include <stdio.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/*
|
||||
* 单写者控制台 API(与 DBG_ENABLE 无关,任何构建都必须可见):
|
||||
* dbg_console_write_line - 生产者入口:调用方已格式化好的整行文本一次入环形缓冲
|
||||
* (刻意**不用**自研可变参数函数——规范 S12 7.6 禁止;格式化在
|
||||
* DBG_PRINT 宏内用库 snprintf 完成)
|
||||
* dbg_console_write_raw - 异常/早期路径:有界单次直发(不加锁)
|
||||
* dbg_console_writer_attach- 写者任务(defaultTask)注册自己为唯一发送者
|
||||
* dbg_console_drain - 写者任务排空缓冲并发送
|
||||
* dbg_console_dropped - 因缓冲满丢弃的行数(诊断)
|
||||
*/
|
||||
#define DBG_CON_LINE_MAX 192U /* 单行文本上限(含结尾 '\0',超出截断) */
|
||||
int dbg_console_write_line(const char *line, unsigned len);
|
||||
void dbg_console_write_raw(const char *buf, unsigned len);
|
||||
void dbg_console_writer_attach(void);
|
||||
void dbg_console_drain(void);
|
||||
uint32_t dbg_console_dropped(void);
|
||||
|
||||
/*
|
||||
* 函数功能:MicroLIB printf 底层重定向(C 库 retarget 钩子,须为全局符号)
|
||||
* 入口参数:ch - 字符;f - 文件流(忽略)
|
||||
* 返回值:原样返回 ch
|
||||
* 限定条件:printf 调用点执行(任意任务上下文);字节交单写者路径
|
||||
*/
|
||||
int fputc(int ch, FILE *f);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* CONSOLE_LOG_H */
|
||||
Reference in New Issue
Block a user