1. 为什么你的STM32项目需要EasyLogger？
在嵌入式开发中，调试一直是个让人头疼的问题。还记得我刚开始做STM32项目时，最常用的调试方法就是在代码里到处插入printf，然后通过串口打印出来。这种方法虽然简单，但随着项目规模增大，很快就遇到了几个致命问题：
首先，各种调试信息混杂在一起，根本分不清哪些是错误、哪些是警告。其次，当产品发布时，需要手动删除所有调试代码，稍不注意就会遗漏。最糟糕的是，当系统崩溃时，往往连最后的错误信息都来不及输出。
EasyLogger这个超轻量级日志库完美解决了这些问题。它只有不到2KB的ROM占用和0.3KB的RAM占用，却提供了完整的日志分级、格式化输出和异步记录功能。我在最近的一个智能家居项目中使用了它，调试效率提升了至少3倍。
2. 快速搭建开发环境
2.1 硬件准备清单
我建议使用以下硬件配置来开始：
- 任意型号STM32开发板（我用的是STM32F103CBT6最小系统板）
- USB转TTL串口模块（用于日志输出）
- ST-Link调试器
- 杜邦线若干
2.2 软件工具链安装
软件方面需要准备：
- Keil MDK 5.29或更高版本
- STM32CubeMX 6.01
- 串口调试助手（推荐使用SecureCRT或Putty）
这里有个小技巧：安装完STM32CubeMX后，记得在Help->Manage embedded software packages中安装对应芯片系列的HAL库。我遇到过不少新手因为漏了这一步，导致生成的代码无法编译。
3. EasyLogger的移植与配置
3.1 源码获取与工程集成
从GitHub获取最新源码：
git clone https://github.com/armink/EasyLogger.git将以下文件添加到你的Keil工程：
- easylogger/src/elog.c
- easylogger/src/elog_utils.c
- easylogger/port/elog_port.c
重要提示：第一次移植时，建议先使用demo/non_os/stm32f10x目录下的示例工程进行验证。这个demo已经配置好了基本参数，可以快速验证移植是否成功。
3.2 关键配置参数详解
打开elog_cfg.h文件，这些配置项需要特别注意：
/* 日志输出总开关 */ #define ELOG_OUTPUT_ENABLE /* 日志级别设置 */ #define ELOG_OUTPUT_LVL ELOG_LVL_VERBOSE /* 行缓冲区大小 */ #define ELOG_LINE_BUF_SIZE 128 /* 异步输出模式 */ #define ELOG_ASYNC_OUTPUT_ENABLE #define ELOG_ASYNC_OUTPUT_BUF_SIZE (ELOG_LINE_BUF_SIZE * 10)我在实际项目中发现，对于STM32F103这类资源有限的芯片，将行缓冲区设置为128字节是个不错的平衡点。太小会导致长日志被截断，太大又浪费RAM。
4. HAL库的深度集成技巧
4.1 串口输出重定向
要让日志通过串口输出，需要在main.c中添加重定向代码：
#include "elog.h" int fputc(int ch, FILE *f) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; }注意：使用HAL库时，务必先调用MX_USART1_UART_Init()初始化串口，否则会导致程序卡死。
4.2 中断安全的日志输出
在裸机环境中，我们需要确保日志输出不会被中断打断。修改elog_port.c中的加锁函数：
void elog_port_output_lock(void) { __disable_irq(); } void elog_port_output_unlock(void) { __enable_irq(); }这个简单的实现虽然粗暴，但在大多数场景下已经足够。如果项目对实时性要求极高，可以考虑使用更精细的锁机制。
5. 实战：构建完整的日志系统
5.1 初始化流程最佳实践
建议按照以下顺序初始化EasyLogger：
/* 关闭标准库缓冲 */ setbuf(stdout, NULL); /* 初始化EasyLogger */ elog_init(); /* 设置各等级日志格式 */ elog_set_fmt(ELOG_LVL_ASSERT, ELOG_FMT_ALL); elog_set_fmt(ELOG_LVL_ERROR, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME); elog_set_fmt(ELOG_LVL_WARN, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME); elog_set_fmt(ELOG_LVL_INFO, ELOG_FMT_LVL | ELOG_FMT_TAG | ELOG_FMT_TIME); /* 启动EasyLogger */ elog_start();5.2 日志使用示例
在代码中使用日志非常简单：
log_a("系统初始化失败！"); // ASSERT级别 log_e("传感器读取错误"); // ERROR级别 log_w("内存接近耗尽"); // WARN级别 log_i("系统启动完成"); // INFO级别 log_d("当前温度：%d", temp); // DEBUG级别我在项目中养成了一个好习惯：为每个模块定义自己的日志标签，比如：
#define LOG_TAG "NETWORK" void network_init() { log_i("[%s] 网络初始化开始", LOG_TAG); // ... log_i("[%s] IP地址：%s", LOG_TAG, ip_addr); }这样在查看日志时，可以快速定位问题模块。
6. 高级技巧与性能优化
6.1 异步输出模式实战
启用异步输出可以显著提升系统性能：
#define ELOG_ASYNC_OUTPUT_ENABLE #define ELOG_ASYNC_OUTPUT_BUF_SIZE (ELOG_LINE_BUF_SIZE * 20) #define ELOG_ASYNC_OUTPUT_LVL ELOG_LVL_DEBUG这个配置表示：DEBUG及以下级别的日志使用异步输出，更高等级的日志（如ERROR）仍然同步输出，确保关键错误不被丢失。
6.2 内存占用优化技巧
如果你的项目特别在意资源消耗，可以尝试以下优化：
- 关闭不用的功能：
#define ELOG_COLOR_ENABLE // 关闭颜色输出 #define ELOG_FMT_T_INFO // 关闭线程信息 #define ELOG_FMT_P_INFO // 关闭进程信息- 减小缓冲区大小：
#define ELOG_LINE_BUF_SIZE 64 #define ELOG_ASYNC_OUTPUT_BUF_SIZE (ELOG_LINE_BUF_SIZE * 5)在我的一个穿戴设备项目中，通过这些优化将RAM占用从1.2KB降到了0.5KB。
7. 常见问题与解决方案
7.1 编译错误排查
问题1：提示未定义的__disable_irq/__enable_irq 解决方案：在elog_port.c中添加#include "stm32f1xx_hal.h"
问题2：日志输出不全 解决方案：检查串口波特率设置，确保终端和设备配置一致
7.2 性能问题分析
如果发现日志输出导致系统卡顿，可以：
- 提高日志输出级别，减少日志量
- 启用异步输出模式
- 增大异步缓冲区大小
记得有一次我遇到系统偶尔卡死的问题，最后发现是因为在中断中输出了大量DEBUG日志，导致缓冲区溢出。通过限制中断中的日志级别解决了这个问题。
