4.6 KiB
| layout | title | subtitle | description | excerpt | date | author | tags | categories | published | math | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| post | 使用 SEGGER J-Link RTT | 基于 Keil 环境 | 对在 Keil 环境下使用 SEGGER J-Link RTT 功能进行了介绍，并对常见编译错误进行了修正。 | 对在 Keil 环境下使用 SEGGER J-Link RTT 功能进行了介绍，并对常见编译错误进行了修正。 | 2022-09-16 17:09:00 | Rick Chan |
|
|
true | false |
With RTT it is possible to output information from the target microcontroller as well as sending input to the application at a very high speed without affecting the target's real time behavior. SEGGER RTT can be used with any J-Link model and any supported target processor which allows background memory access, which are Cortex-M and RX targets.
1. 工程配置
首先需要向工程添加 RTT 支持代码，可以在 <J-Link 安装目录>/Samples/RTT 下找到该代码。
在 Keil 中创建 SEEGER 分组，添加 RTT 源码中的 SEGGER_RTT.h、SEGGER_RTT.c、SEGGER_RTT_printf.c 和 SEGGER_RTT_Conf.h 文件。使用以下函数初始化并打印信息：
int main(void) {
// ...
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);
SEGGER_RTT_printf(0, "V\r\n");
// ...
}
其中 SEGGER_RTT_SetTerminal() 用于选择终端编号 SEGGER J-Link RTT 支持多个终端。
2. 代码修正
如果 Keil 中使能了 GNU extensions 选项，编译 RTT 代码时会出现类似如下错误：
warning: #47-D: incompatible redefinition of macro "SEGGER_RTT_LOCK" (declared at line 199)
warning: #47-D: incompatible redefinition of macro "SEGGER_RTT_UNLOCK" (declared at line 200)
这是因为使能 GNU extensions 后同时开启了“__CC_ARM” 和 “__GUNC__”宏，导致 SEGGER_RTT_Conf.h 文件中的 SEGGER_RTT_LOCK 和 SEGGER_RTT_UNLOCK 宏重复定义。
此时需要修改 SEGGER_RTT_Conf.h 文件如下：
/*********************************************************************
*
* RTT lock configuration for SEGGER Embedded Studio,
* Rowley CrossStudio and GCC
*/
#if (defined __SES_ARM) || (defined __CROSSWORKS_ARM) || ((defined __GNUC__) && !(defined(__CC_ARM)))
3. 工具使用
需要使用 J-Link RTT Viewer 工具来查看 RTT 的输出（有些环境下需要先连接该工具再在 IDE 中进行调试）。
打开 J-Link RTT Viewer，根据实际情况选择 J-Link 的连接方式，然后选择目标设备，如 STM32F407 等，然后选择 SWD 或 JTAG 接口，并设置速率，点击“OK”继续，若出现类似如下日志，则连接成功。
LOG: Terminal 0 added.
LOG: Device "N32L406CB" selected.
LOG: Found SW-DP with ID 0x2BA01477
LOG: Scanning AP map to find all available APs
LOG: AP[1]: Stopped AP scan as end of AP map has been reached
LOG: AP[0]: AHB-AP (IDR: 0x24770011)
LOG: Iterating through AP map to find AHB-AP to use
LOG: AP[0]: Core found
LOG: AP[0]: AHB-AP ROM base: 0xE00FF000
LOG: CPUID register: 0x410FC241. Implementer code: 0x41 (ARM)
LOG: Found Cortex-M4 r0p1, Little endian.
LOG: FPUnit: 6 code (BP) slots and 2 literal slots
LOG: CoreSight components:
LOG: ROMTbl[0] @ E00FF000
LOG: ROMTbl[0][0]: E000E000, CID: B105E00D, PID: 000BB00C SCS-M7
LOG: ROMTbl[0][1]: E0001000, CID: B105E00D, PID: 003BB002 DWT
LOG: ROMTbl[0][2]: E0002000, CID: B105E00D, PID: 002BB003 FPB
LOG: ROMTbl[0][3]: E0000000, CID: B105E00D, PID: 003BB001 ITM
LOG: ROMTbl[0][4]: E0040000, CID: B105900D, PID: 000BB9A1 TPIU
LOG: ROMTbl[0][5]: E0041000, CID: B105900D, PID: 000BB925 ETM
LOG: RTT Viewer connected.
在 Terminal 菜单中可选择“Add next terminal”，则会出现“Terminal 0”、“Terminal 1”等，代码中使用 SEGGER_RTT_SetTerminal() 函数选择好输出终端后，日志将被输出到对应编号的 Terminal 中。
最后，在 IDE 中进行调试，或全速运行，RTT 终端中就会产生响应输出。
SEGGER_RTT_printf() 的用法与 printf() 用法类似，注意换行使用 “\r\n”。