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 |
- |
c
#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
-
输出效果
c
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: