如何将RTT对接到RT-Thread Nano中来代替常用的串口打印

CharlesX

一、RTT是什么

J-Link RTT – Real Time Transfer: SEGGER’s Real Time Transfer (RTT) is the proven technology for system monitoring and interactive user I/O in embedded applications. It combines the advantages of SWO and semihosting at very high performance.

Bi-directional communication with the target application

Very high transfer speed without affecting real time behavior

Uses debug channel for communication

No additional hardware or pin on target required

Supported by any J-Link model

Supported by ARM Cortex-M0/M0+/M1/M3/M4/M7/M23/M33 and Renesas RX100/200/600

Complete implementation code providing functionality and freedom

简而言之，RTT是SEGGER基于J-Link开发的一款可使用SWO接口（仅SWDIO、SWCLK和GND三线即可）与嵌入式系统进行输入输出交互的组件，不影响、不占用系统中的任何硬件资源。

二、为什么要使用RTT

在一些项目中，由于成本考量等原因，选用了硬件资源较为紧张的STM32，譬如只有两个串口。如果这仅有的两个串口都被系统占用了的话，我们在调试的时候就没有办法使用串口来对接控制台以及打印调试信息了。

令人欣慰的是，RT-Thread（Nano）的FinSH（shell）组件并非只局限于串口，且它的输入输出接口都被剥离了出来，方便我们将控制台重定向到其它硬件上如以太网、USB以及本文的J-Link RTT 等。

三、RTT怎么用

IDE: Windows + MDK + LL Libraries for STM32

需要下载安装：J-Link / J-Trace

移植RTT到MDK工程中

举例说明：

①找到JLink安装目录

我的安装目录：

②将..\SEGGER\JLink\Samples\RTT目录中的SEGGER_RTT_Vxxxx.zip拷贝到工程目录中解压，创建相关文件夹管理，并加入工程，添加头文件目录。

我的工程结构：

修改代码与配置（LL库）

①修改SEGGER_RTT_Conf.h

按需修改上、下行以及缓冲区大小

//
// Most common case:
// Down-channel 0: RTT
// Down-channel 1: SystemView
//
#ifndef SEGGER_RTT_MAX_NUM_DOWN_BUFFERS
#define SEGGER_RTT_MAX_NUM_DOWN_BUFFERS (3) // Max. number of down-buffers (H->T) available on this target (Default: 3)
#endif
#ifndef BUFFER_SIZE_UP
#define BUFFER_SIZE_UP (1024) // Size of the buffer for terminal output of target, up to host (Default: 1k)
#endif
#ifndef BUFFER_SIZE_DOWN
#define BUFFER_SIZE_DOWN (16) // Size of the buffer for terminal input to target from host (Usually keyboard input) (Default: 16)
#endif
#ifndef SEGGER_RTT_PRINTF_BUFFER_SIZE
#define SEGGER_RTT_PRINTF_BUFFER_SIZE (64u) // Size of buffer for RTT printf to bulk-send chars via RTT (Default: 64)
#endif
#ifndef SEGGER_RTT_MODE_DEFAULT
#define SEGGER_RTT_MODE_DEFAULT SEGGER_RTT_MODE_NO_BLOCK_SKIP // Mode for pre-initialized terminal channel (buffer 0)
#endif

②修改RT-Thread Nano -> board.c

我使用了一个宏来管理该模块和串口的互斥，方便调试的时候相互切换：

#define USART_SHELL USART1
#ifndef USART_SHELL
#include "SEGGER_RTT.h"
#endif
使用如下代码来导出至RT-Thread Nano的自动初始化功能：

#ifndef USART_SHELL
int RTT_init()
{
SEGGER_RTT_ConfigUpBuffer(0, "RTTUP", NULL, 0, SEGGER_RTT_MODE_NO_BLOCK_SKIP);
SEGGER_RTT_ConfigDownBuffer(0, "RTTDOWN", NULL, 0, SEGGER_RTT_MODE_NO_BLOCK_SKIP);
SEGGER_RTT_SetTerminal(0);
return RT_EOK;
}
INIT_COMPONENT_EXPORT(RTT_init);
#endif
使用如下代码来对接RT-Thread Nano的输入输出函数（LL库）：

void rt_hw_console_output(const char str)
{
#ifdef USART_SHELL
rt_size_t i = 0, size = 0;
char a = '\r';
size = rt_strlen(str);
for (i = 0; i < size; i++)
{
while(!LL_USART_IsActiveFlag_TXE(USART_SHELL))
{
}
if ((str + i) == '\n')
{
LL_USART_TransmitData8(USART_SHELL, a);
while(!LL_USART_IsActiveFlag_TXE(USART_SHELL))
{
}
}
LL_USART_TransmitData8(USART_SHELL, *(str + i));
}
#else
SEGGER_RTT_printf(0, str);
#endif
}
char rt_hw_console_getchar()
{
int ch = -1;
#ifdef USART_SHELL
if(LL_USART_IsActiveFlag_RXNE(USART_SHELL))
{
ch = LL_USART_ReceiveData8(USART_SHELL);
}
else
{
if(LL_USART_IsActiveFlag_ORE(USART_SHELL))
{
LL_USART_ClearFlag_ORE(USART_SHELL);
}
rt_thread_mdelay(10);
}
#else
if(SEGGER_RTT_HasKey())
ch = SEGGER_RTT_GetKey();
else
rt_thread_mdelay(10);
#endif
return ch;
}
使用J-Link RTT Viewer