1. 嵌入式日志系统概述
做嵌入式开发这些年，我越来越觉得日志系统就像飞机的黑匣子。平时你可能觉得它可有可无，可一旦系统出了故障，你翻遍代码也找不到原因时，才会后悔——当初怎么就没好好设计日志呢？
说白了，日志系统就是嵌入式设备的「记忆」。它记录着系统运行的每一个关键瞬间。我个人习惯是，在项目启动的第一天就把日志框架搭好，而不是等到调试时再临时拼凑。
日志系统在嵌入式开发中的重要性
你想想看，嵌入式设备和普通电脑程序最大的区别是什么？
是「不可见」。你的代码跑在STM32上，跑在ESP32上，跑在某个国产MCU里。没有显示器，没有键盘，甚至没有串口线。程序到底在执行什么？卡在了哪里？内存够不够？——这些问题，日志系统都能回答。
我在项目中遇到过这样一个坑：一个智能家居网关，运行几天后就会死机。用仿真器连上去调试？不行，因为死机是偶发的，可能几个小时才出现一次。后来我在关键路径上加了几行日志，把数据写到Flash里。第二天一查日志，发现是某个传感器返回了异常数据，导致内存越界。
嗯，这就是日志的价值。它让你看到系统「活着」时的状态。
核心价值总结：
- 故障定位：快速找到崩溃或异常的原因
- 性能分析：记录任务执行时间、中断响应延迟
- 状态追踪：了解系统运行路径和状态变化
- 调试辅助：在没有调试器的情况下获取运行信息
- 远程诊断：通过日志接口远程分析设备问题
常见日志级别
日志级别这东西，刚开始做嵌入式时我总觉得「差不多就行」。后来吃过亏才明白，级别设计不好，日志要么太多刷屏，要么太少啥也查不到。
行业内通用的日志级别有5个，我按严重程度从低到高给你列一下：
| 级别 | 含义 | 使用场景 | 我的建议 |
|---|---|---|---|
| DEBUG | 调试信息 | 开发阶段，记录变量值、函数入口/出口 | 正式发布时关闭 |
| INFO | 普通信息 | 系统启动、任务切换、配置加载 | 保留，但控制数量 |
| WARN | 警告 | 资源接近上限、重试操作、非致命异常 | 必须保留，重点关注 |
| ERROR | 错误 | 通信失败、文件损坏、硬件故障 | 必须保留，立即处理 |
| FATAL | 致命错误 | 系统无法继续运行，需要复位 | 必须保留，触发紧急处理 |
我的小技巧：在项目中，我会把日志级别做成可配置的。开发时用DEBUG级别，测试时用INFO级别，正式发布时用WARN级别。这样既不影响性能，又能保留关键信息。
为什么会这样设计？你想想看，DEBUG日志在正式运行时基本没用，但会消耗大量CPU和存储资源。我曾经在一个项目中，DEBUG日志太多，导致串口输出占用了30%的CPU时间——系统响应都变慢了。
日志系统的基本架构
一个成熟的嵌入式日志系统，其实没那么复杂。我习惯把它分成三层：
第一层：日志采集层
这一层负责接收各个模块发来的日志信息。说白了，就是提供一组API接口，比如LOG_DEBUG()、LOG_ERROR()这些宏或函数。我个人习惯用宏定义，因为可以方便地在编译时裁剪掉不需要的级别。
/* 一个简单的日志宏示例 */
#define LOG_DEBUG(fmt, ...) \
do { \
if (g_log_level <= LOG_LEVEL_DEBUG) { \
log_output("[DEBUG] %s:%d: " fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
} \
} while(0)
#define LOG_ERROR(fmt, ...) \
do { \
if (g_log_level <= LOG_LEVEL_ERROR) { \
log_output("[ERROR] %s:%d: " fmt, __FILE__, __LINE__, ##__VA_ARGS__); \
} \
} while(0)
第二层：日志处理层
这一层负责格式化、过滤、缓存。比如加上时间戳、任务ID，或者根据级别决定是否丢弃。我记得有一次，系统在中断里调用了日志输出，结果导致死锁——因为日志输出函数里用了互斥锁。从那以后，我就在处理层加了一个「中断上下文检测」，在中断里只把日志丢进环形缓冲区，不直接输出。
注意：日志处理层一定要考虑实时性和资源占用。不要在中断服务函数里做复杂的日志格式化操作。我曾经见过一个同事，在中断里用sprintf格式化日志字符串，结果中断响应时间从5微秒变成了200微秒——整个系统的实时性都毁了。
第三层：日志输出层
这一层负责把日志写到目标设备上。常见的输出方式有：
- 串口输出：最简单，适合开发调试
- Flash存储：掉电不丢失，适合记录历史
- SD卡文件：容量大，适合长时间记录
- 网络发送：远程查看，适合物联网设备
- SEGGER RTT：高速调试通道，不影响实时性
我个人推荐的做法是：开发阶段用串口+RTT，正式产品用Flash+网络。这样既能保证开发效率，又能保证产品可靠性。
一个完整的日志系统架构图（伪代码描述）：
┌─────────────────────────────────────────┐
│ 应用层模块 │
│ (传感器、通信、控制等) │
└────────────────┬────────────────────────┘
│ 调用 LOG_xxx() 宏
▼
┌─────────────────────────────────────────┐
│ 日志采集层 │
│ - 级别过滤 │
│ - 参数格式化 │
│ - 调用链追踪 │
└────────────────┬────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 日志处理层 │
│ - 时间戳添加 │
│ - 环形缓冲区缓存 │
│ - 异步处理调度 │
└────────────────┬────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 日志输出层 │
│ - 串口驱动 │
│ - Flash写入 │
│ - 网络发送 │
└─────────────────────────────────────────┘嗯，这里要注意一点：日志系统的设计一定要考虑资源受限的情况。嵌入式设备不像PC，内存可能只有几十KB，Flash可能只有几百KB。我曾经在一个只有16KB RAM的MCU上做日志系统，最后不得不把环形缓冲区压缩到256字节——但配合合理的日志级别，依然能定位到大部分问题。
说白了，日志系统不是越复杂越好，而是「够用就好」。你根据项目的实际需求，选择合适的架构和实现方式，这才是嵌入式工程师该有的思路。