嵌入式裸机打印体系设计：从 UART 到 RTT 的工程化落地实践

在嵌入式系统开发中，“打印”从来不是一个简单的 printf，而是一套贯穿开发、联调、试产、量产全生命周期的系统能力。

在裸机（Bare Metal）环境下，没有终端、没有文件系统、没有标准输出流。
开发者观察系统状态的唯一窗口，往往只剩下——日志输出通道。

一个成熟的打印体系，决定的不只是调试体验，更决定：

• 实时性能是否被破坏

• RAM / Flash 是否被侵占

• 量产固件是否干净

• 后期维护成本是否失控

因此，打印系统应被视为基础设施层设计问题，而非临时工具。

---

一、裸机系统的“可观测性”困境

在 PC / Linux 环境中，我们拥有：

• 控制台输出

• 日志文件

• 性能分析工具

• 远程调试

而在 MCU 裸机中，上述能力全部消失，系统可观测性几乎只能依赖：

手段	特点
GPIO 翻转	精准但无语义
UART 输出	可读但慢
SWO / RTT	高效但调试专用

其中，日志打印是唯一具备语义表达能力的调试方式。

---

二、打印通道的工程定位

UART —— 面向量产的外设通道

本质：串行通信接口

优点：

• 通用

• 可保留量产

• 工具成熟

缺点：

• 占 IO

• 波特率瓶颈

• 阻塞发送

• printf 体积巨大

---

SWO —— 面向调试的高速链路

本质：ARM ITM Trace

优点：

• 单线

• 极快

• 无 IO 占用

缺点：

• 仅 ARM 支持

• 不适合量产

• 工具依赖强

---

RTT —— 内存映射式实时传输

本质：

MCU RAM ↔ J-Link ↔ PC

优点：

• 不占 IO

• 不受波特率限制

• 实时性极高

• printf 友好

缺点：

• 依赖 J-Link

• 不适合量产

RTT 的意义在于：
把打印从“外设问题”升级为“内存数据流问题”。

---

三、真正的难点：生命周期管理

大多数项目的问题不在“不能打印”，而在：

• 调试代码残留量产

• RAM 被日志侵占

• printf 引入隐性开销

• 日志与业务耦合

打印系统必须具备四个特性：

• 可插拔

• 可关闭

• 零侵入

• 生命周期隔离

这已经是架构问题，而非函数问题。

---

四、工程级解决方案：日志抽象层

核心原则：

业务代码永远不直接调用具体打印函数。

---

1. 日志抽象接口设计

统一入口：

LOG("Energy=%d\n", energy);

业务层只认 LOG，不认 UART / RTT。

---

2. 工程结构建议

User/ ├─ log.h ├─ SEGGER_RTT.c ├─ SEGGER_RTT_printf.c └─ uart_log.c

---

3. log.h 实现（核心）

#ifndef LOG_H #define LOG_H /* Debug 版本使用 RTT */ #ifdef USE_RTT_DEBUG #include "SEGGER_RTT.h" #include "SEGGER_RTT_printf.h" #define LOG(...) SEGGER_RTT_printf(0, __VA_ARGS__) /* 量产版本关闭日志 */ #elif defined(DISABLE_LOG) #define LOG(...) ((void)0) /* 联调阶段走 UART */ #else void UART_Log(const char *fmt, ...); #define LOG(...) UART_Log(__VA_ARGS__) #endif #endif

---

4. UART_Log 简易实现

void UART_Log(const char *fmt, ...) { char buf[128]; va_list args; va_start(args, fmt); vsnprintf(buf, sizeof(buf), fmt, args); va_end(args); for(int i=0; buf[i]; i++) UART_SendByte(buf[i]); }

---

5. 工程配置

Debug 工程

USE_RTT_DEBUG

Release 工程

DISABLE_LOG

效果：

模式	行为	资源占用
Debug	RTT 打印	有
联调	UART 打印	少量
Release	无打印	0

编译器会直接删除 LOG 代码。

---

五、RTT 集成关键步骤

1. 加入文件：

   • SEGGER_RTT.c

   • SEGGER_RTT.h

   • SEGGER_RTT_printf.c

2. main 初始化（可选）

SEGGER_RTT_Init();

1. 打开 RTT Viewer

---

六、阶段化打印策略

阶段	打印策略
驱动开发	RTT
协议联调	RTT + UART
小批试产	UART 精简日志
正式量产	关闭或仅错误日志

打印能力随产品成熟度逐步“隐退”。