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 -
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

  • 输出效果

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 :连接 RTT Viewer/Server 的 TCP 端口(19021),实时旁听显示 RTT 输出(支持中文)

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

文件默认保存路径:%APPDATA%\SEGGER(可指定如:D:\log\rtt.log)

转义符号不识别


ref: