基于jlink-RTT-view 和 lettershell的shell管理工具

在我们实际的项目里，很多时候都没有串口留出来用于调试，这样增加了调试的难度，做一些测试也没有预留的接口可以修改，很麻烦，因此我这边整合了RTT-view和lettershell，提供了一套只需要使用jlink即可使用shell工具调试代码的功能。

qq_45019496

1030人浏览 · 2025-08-14 16:21:40

qq_45019496 · 2025-08-14 16:21:40 发布

1.RTT-View如何使用

【嵌入式小技巧】STM32 实现 SEGGER RTT 打印（超详细）-CSDN博客

基本移植我就不再赘述，我这边介绍一些一个如何快速上手

1.1RTT-View初始化

#define  SEGGER_UP_BUFF_SIZE		(256)
#define  SEGGER_DOWN_BUFF_SIZE	    (256)
#define  SEGGER_INDEX_LINE			(0)

uint8_t g_ucaRTTUp0Buffer[SEGGER_UP_BUFF_SIZE] = {0};
uint8_t g_ucaRTT_BufferDown0Buffer[SEGGER_DOWN_BUFF_SIZE] = {0};

void SeggerInit(void)
{
	SEGGER_RTT_ConfigUpBuffer(SEGGER_INDEX_LINE, "Terminal", g_ucaRTTUp0Buffer, sizeof(g_ucaRTTUp0Buffer), SEGGER_RTT_MODE_NO_BLOCK_SKIP);
	SEGGER_RTT_ConfigDownBuffer(SEGGER_INDEX_LINE, "Terminal", g_ucaRTT_BufferDown0Buffer, sizeof(g_ucaRTT_BufferDown0Buffer), SEGGER_RTT_MODE_NO_BLOCK_SKIP);
	SEGGER_RTT_SetTerminal(SEGGER_INDEX_LINE);
}

初始化代码很简单，只需要指定指定发送的端口，并且设置收发的缓冲区即可，但事实上，我指定rtt-view发出的端口无效，最终内容输出在All Terminals，但是无伤大雅。

SEGGER_RTT_Write(SEGGER_INDEX_LINE, buff, size)

RTT发送十分简单，直接调用SEGGER_RTT_Write即可

	if(SEGGER_RTT_HasKey())
	{
		uint8_t ucGetChar;
		ucGetChar = SEGGER_RTT_GetKey();
		buff[0] = ucGetChar;
		return 1;
	}

RTT的接受有多种方式，我这边通过SEGGER_RTT_HasKey和SEGGER_RTT_GetKey组合即可，SEGGER_RTT_HasKey判断接受的缓冲是否有内容，SEGGER_RTT_GetKey读取一个字节

2.Letter-shell如何使用

STM32HAL 移植功能强大letter-shell开源库（裸机开发）_裸机 letter shell-CSDN博客

介绍letter-shell的文章也很多，我这边简述以下

void log_write(char *buff,short len);

Shell shell;
char shellBuffer[512];
Log uartLog = {
    .write = log_write,
    .active = LOG_ENABLE,
    .level = LOG_DEBUG
};
    
signed short shell_read(char *buff, unsigned short len) 
{
	if(SEGGER_RTT_HasKey())
	{
		uint8_t ucGetChar;
		ucGetChar = SEGGER_RTT_GetKey();
		buff[0] = ucGetChar;
		return 1;
	}
	
	return 0;

}

signed short shell_write(char *buff, unsigned short len)
{
	SEGGER_OUT(buff, len);
  return len;
}

void log_write(char *buff,short len)
{
	SEGGER_OUT(buff, len);
}

void userShellInit(void)
{
    shell.write = shell_write;
    shell.read = shell_read;
    shellInit(&shell, shellBuffer, 512);
    logRegister(&uartLog, &shell);
}

实际上letter-shell的移植也就三个部分，实现shell的读，写，以及日志的读写，如果不需要使用日志，有关日志注册的内容可以删除，我这边就保留了

简单介绍以下代码shell_write直接调用SEGGER_OUT，将内容打印到RTT-View上，shell_read通过读取一个字节，并返回给shell，log部分的内容我就不介绍了

注意，letter-shell有两种使用办法，第一种办法是在接受到字符的中断中调用 shellHandler,第二种办法实在主循环中调用shellTask(&shell),其中的shell是我们注册的shell结构体。

以上我们就能将letter-shell和RTT-View结合到一起