【技能储备】J-link RTT的使用
技能储备系列是一些暂时由于时间或者其他客观因素暂时无法进行的工作,但是觉得很有用,因此做个记录,文章参考自Snow_2018在CSDN上的文章,原文链接为点击我
写在前面
本文介绍了J-Link RTT的部分使用内容,很多地方参考和使用了J-Link的官方资料,有的地方可能翻译的不太准确,请见谅。
什么是RTT?
RTT(Real Time Transfer)是一种用于嵌入式中与用户进行交互的技术,它结合了SWO和半主机的优点,具有极高的性能。
使用RTT可以从MCU非常快速输出调试信息和数据,且不影响MCU实时性。这个功能可以用于很多支持J-Link的设备和MCU,兼容性强。
RTT支持两个方向的多个通道,上到主机,下到目标,它可以用于不同的目的,为用户提供尽可能多的自由。默认实现每个方向使用一个通道,用于可打印终端输入和输出。
使用J-Link RTT Viewer,可用于“虚拟”终端,允许打印到多个窗口(例如,一个用于标准输出,一个对于错误输出,一个用于调试输出)。
RTT的工作原理
RTT在MCU的存储器中使用SEGGER RTT控制块结构管理数据读写。控制块对于每个可用的信道都在内存中包含了一个ID,通过J-Link或者环形缓冲结构区(链表)都可以通过ID找到对应的控制块。
可用信道的最大数目可以在编译时配置,并且每个缓冲区都可以在MCU运行时配置和使用。上下缓冲区可以分开处理。每个通道都可以配置为阻塞或非阻塞。
在阻塞模式下,应用程序将等待缓冲区写满,直到可以写入所有内存为止,这将导致应用程序处于阻塞状态,但可以防止数据丢失。
在非阻塞模式下,只会写入适合缓冲区的数据,或完全不写入缓冲区,其余的数据将被丢弃。这样即使没有连接调试器,也可以实时运行。开发人员不必创建特殊的调试版本,并且代码可以保留在发布应用程序中。
RTT的性能
RTT的性能明显高于其他任何用于将数据输出到主机PC的方式。平均一行文本可以在1微秒或更短的时间内输出。基本上相当于做一个memcopy()的时间。
RTT实现代码使用大约500字节的ROM和(n(通道数) * (24字节ID+24字节))的RAM。推荐的大小是1 kByte(上行信道)和16到32字节(下行信道),这取决于输入/输出的负载。
快速使用教程
1、安装jlink的驱动,这里不做过多赘述
2、在jlink安装目录中找到如下路径SEGGER\JLink_V632f\Samples\RTT
,解压路径里面的压缩包SEGGER_RTT_V632f.zip(不同的版本,V后面的数字可能不一样)。
3.将解压完的文件拷贝到代码工程目录中。
4.在项目工程中加入SEGGER_RTT_V632f\RTT目录下的全部四个文件。工程添加文件方法请自行百度。
5.工程加入文件后,在想要用到RTT的文件中包含#include "SEGGER_RTT.h",然后直接调用SEGGER_RTT_printf()就好了,
例如SEGGER_RTT_printf(0,"hello world!")这个和C语言的printf的格式差不多,就是前面加了一个端口0的参数。
6.然后点击开始->SEGGR->J-Link RTT Viewer,打开J-Link RTT Viewer 选择好你的芯片型号后,点击确认。
7.然后就能看到我们打印的内容了。
高级使用教程
1.部分函数介绍:
(1)void SEGGER_RTT_Init (void); RTT初始化函数,应放于程序开始阶段。
(2)int SEGGER_RTT_GetKey (void); 从RTT终端获取一个按键字符。返回字符大于0代表有效,小于0代表无效
(3)int SEGGER_RTT_HasKey (void);检测缓存区中是否还有字符。
(4)int SEGGER_RTT_printf (unsigned BufferIndex, const char * sFormat, …)格式化输出字符串
附加信息:
转换规范具有以下语法:
%标志[.精度]转换指定程序
支持的标志:
-:在字段宽度内左对齐
+:始终打印有符号转换的符号扩展名
0:用0代替空格。使用“-”标志或精度时忽略
支持的转换说明符:
c:将参数打印为一个字符
d:将参数打印为有符号整数
u:将参数打印为无符号整数
x:将参数打印为十六进制整数
s:打印参数指向的字符串
p:将参数打印为8位十六进制整数。
ps.似乎官方没有给float类型格式化输出方式。
(5)void SEGGER_RTT_SetTerminal(char TerminalId);设置虚拟终端ID。
(6)int SEGGER_RTT_WaitKey (void);检测缓存区中是否还有字符。
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。