SEGGER_RTT 打印
SEGGER_RTT

J-Link支持通过调试接口进行RTT(Real Time Transfer)打印,RTT默认实现是每个方向使用一个通道,该通道用于可打印的终端输入和输出。
使用J-Link RTT Viewer,该通道可用于多个 “虚拟” 终端,从而仅使用一个目标缓冲区即可打印到多个窗口(例如,一个用于标准输出,一个用于错误输出,一个用于调试输出)。
[!NOTE]
RTT 只操作 RAM 中的环形缓冲区,数据由 J-Link 通过 SWD 调试口直接读取,只要J-Link 访问CPU的 RAM即可,不依赖任何内核特性与外设
唯一与内核相关的是带 Cache 的核(如 Cortex-A、ESP32)需配置
SEGGER_RTT_UNCACHED_OFF保证读写一致性
- 上行缓冲区 (Target -> Host)——打印
写入指针由Target写入,读取指针由调试探针 (J-Link、Host) 写入。当读取和写入指针指向同一个元素时,缓冲区为空(ring buffer)
对 MCU 来说只是一次内存拷贝,不涉及任何通信外设。
- 下行缓冲区 (Host-> Target)——接收主机输入:方向相反,J-Link 写入、MCU 轮询读取。

平均一行文本打印时间仅需1us(STM32F407 Cortex-M4 running at 168 MHz)

MDK使用方法
安装J-Link后,安装目录下包含RTT源码: ..\SEGGER\JLink\Samples\RTT
MDK配置如下:
- 添加文件

- 添加文件路径

SEGGER_RTT_printf
int SEGGER_RTT_printf(unsigned BufferIndex, const char * sFormat, ...)
BufferIndex:写入的上行缓冲区通道编号(_SEGGER_RTT.aUp[n]),0 为默认Terminal
缓冲区通道数量由
SEGGER_RTT_Conf.h的SEGGER_RTT_MAX_NUM_UP_BUFFERS宏决定,未初始化的缓冲区,需先SEGGER_RTT_ConfigUpBuffer分配内存
J-Link RTT Viewer软件的的 Terminal窗口:

sFormat:格式化字符串,支持 ANSI 转义 (仅Terminal 0支持 ANSI 转义,可实现彩色日志)
| 类型 | 转义序列 | 颜色 |
|---|---|---|
| 错误 | \033[31m |
红 |
| 警告 | \033[33m |
黄 |
| 正常 | \033[32m |
绿 |
| 信息 | \033[36m |
青 |
| 恢复默认 | \033[0m |
- |
#define LOG_E(fmt, ...) SEGGER_RTT_printf(0, "\033[31m"fmt"\033[0m", ##__VA_ARGS__)
#define LOG_W(fmt, ...) SEGGER_RTT_printf(0, "\033[33m"fmt"\033[0m", ##__VA_ARGS__)
#define LOG_I(fmt, ...) SEGGER_RTT_printf(0, "\033[32m"fmt"\033[0m", ##__VA_ARGS__)
#define LOG_D(fmt, ...) SEGGER_RTT_printf(0, "\033[36m"fmt"\033[0m", ##__VA_ARGS__)
注:
- 打印完需恢复默认
\033[0m,否则会影响后续其他日志输出样式 SEGGER_RTT_printf调用前无需显式初始化,其仅首次调用会执行INIT()初始化,且不依赖外设
J-Link RTT Viewer
- 连接J-Link

- 输出效果

SEGGER_RTT_printf(0, "cnt = %d\n",cnt++); //RTT打印
LOG_E("EER! "); LOG_W("WARN! "); LOG_I("INFO! "); LOG_D("DEBUG!\n");
ALT + R可清空显示
J-Link RTT Viewer软件不支持中文显示,可使用开源的mini-rtt-viewer:

此外,还支持本地日志.log导出保存(自动过滤颜色转义符号):

J-Link RTT Client & Logger
- J-Link RTT Client:连接 RTT Viewer/Server 的 TCP 端口(19021),实时旁听显示 RTT 输出(支持中文)

- J-Link RTT Logger:自带 DLL 会话直接读 RTT,把上行数据持续写入文件(记录日志用,不依赖 RTT Viewer)

文件默认保存路径:%APPDATA%\SEGGER(可指定如:D:\log\rtt.log)
转义符号不识别

ref:
浙公网安备 33010602011771号