百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

教你如何使用SEGGER RTT优雅的实现日志系统

wptr33 2025-07-06 17:25 3 浏览

今天开始了 BMS 系统的软件代码部分的搭建,计划是分成三层:硬件驱动,AFE 层和系统应用层。

第一步肯定是先把底层的 IIC 通信调通,CG861xx 的 IIC 通信和 TI 的 BQ769X0 系列一样,IIC 里面有一个 CRC8 的校验,因此调试起来不是很直观,因此想先把调试打印的接口建立好。

首先想到的肯定是把串口调试好,通过 printf 的底层 fputc 函数重映射到串口的发送函数上进行信息输出。

int fputc(int ch, FILE *f)
{ 
    uint8_t temp[1]={ch};   
    HAL_UART_Transmit(&huart2, temp, 1, 2); 
}

但是,串口还需要多一个 USB 转 TTL 的转接线,无奈手头没有现成的,转眼看到了自己调试用的 JlinkOB,突然想到这上面是有一个 RTT 可以通过 SWD 接口进行信息输出的。

那就折腾起来。

我会把完善后的 RTT 驱动打包放到文末,想使用的同学可以直接copy 到自己的工程中即可使用。

使用 RTT 的好处是:

  1. 调试,下载,打印信息只需要一条线。
  2. 节省一个串口,可以另做他用,对于资源紧张的小型 MCU 很重要。
  3. 在量产产品中可以保留 SWD 端口进行故障排除。

看一眼,JlinkOB 就是这个东西了。

当然使用完整版的 Jlink 也是可以的,不过我比较喜欢简洁而小型化的东西。

RTT的全称是实时传输(Real Time Transmit),是Segger公司推出的,搭配Jlink使用的调试手段,与其它的日志打印手段相比,其具备下列特点:

RTT连接示意图如下图所示:

驱动移植


一、下载Jlink驱动


搞 Arm 单片机的同学对 SEGGER 的Jlink一定不陌生,网络上铺天盖地的盗版和简易版都可以 DIY 的,SEGGER RTT是Jlink驱动里面的功能,我们首先要到官网上去下载驱动
https://www.segger.com/downloads/jlink/


二、提取单片机上的RTT库


打开Jlink驱动的安装位置(默认为:C:\Program Files\SEGGER\JLink),不知道的话可以重新安装一下,或者右键快捷方式选择打开所在位置,然后在这个目录下找到RTT的库文件:

解压后我们会用到压缩包里面的这两个文件夹:


三、移植RTT库


把RTT文件夹放到项目里面去,这些文件都放进去

然后MDK里面建立一个新的文件夹命名为 SEGGER_RTT,然后将相应的 C 文件引入进工程:

include文件夹也需要加入到 C/C++的的环境变量中,这样可以在工程中比较方便的引用。

现在你就可以用如下的代码就行打印的测试了:

void SEGGER_RTT_Test(void)

{

    SEGGER_RTT_Init();        

    uint32_t count = 10;

    while (count--)

    {

        SEGGER_RTT_printf(0, "system init ok\r\n");

    }

}


四、上位机的使用


如果有Jlink,可以直接使用J-Link RTT Viewer、J-Link RTT Logger、J-Link RTT Client进行日志查看。就拿最简单的J-Link RTT Viewer举例子,在开始菜单或者是搜索框找到它:

默认情况下只需设置需要调试的芯片跟调试器接口即可,可以参照下图:

设置好点击OK就可以开始愉快的看日志了(SEGGERRTTprintf函数的第一个参数就是指定在哪个Terminal窗口显示,默认是0。


五、封装RTT库接口


使用RTT毕竟是拿来打日志的,直接调用printf还是比较麻烦的,不如重新封装一下,先来看看效果:

有了各种信息的标记以及不同的颜色,是不是显得优雅了很多,我们来看如何做到这样。

首先我们新建个log.h文件,把下面的内容放进去,这样就在RTT的print上面封装了一层。

#ifndef __LOG_H

#define __LOG_H




#include "SEGGER_RTT.h"




#define LOG_DEBUG   1




#if LOG_DEBUG




#define LOG_PRINT(type,color,format,...)   \

        SEGGER_RTT_printf(0,"%s%s"format"%s", \

        color,               \

        type,                \

        ##__VA_ARGS__,       \

        RTT_CTRL_RESET)




/* 清屏*/

#define LOG_CLEAR() SEGGER_RTT_WriteString(0, RTT_CTRL_CLEAR)




/* 无颜色日志输出 */

#define LOG(format,...) LOG_PRINT("","",format,##__VA_ARGS__)




/* 有颜色格式日志输出 */

#define LOG_INFO(format,...)    LOG_PRINT("LOG: ", RTT_CTRL_TEXT_BRIGHT_GREEN , format, ##__VA_ARGS__)

#define LOG_WARNING(format,...) LOG_PRINT("WAR: ", RTT_CTRL_TEXT_BRIGHT_YELLOW, format, ##__VA_ARGS__)

#define LOG_ERROR(format,...)   LOG_PRINT("ERR: ", RTT_CTRL_TEXT_BRIGHT_RED   , format, ##__VA_ARGS__)




#else




#define LOG_CLEAR()

#define LOG

#define LOG_INFO(format,...)

#define LOG_WARNING(format,...)

#define LOG_ERROR(format,...)




#endif




#endif

使用的时候,我们先 #include"log.h" ,然后再使用以下函数调用即可:

LOG_INFO("Read %d  %d  %d \r\n",m_ADCOffset,temp1,temp2);

m_ADCGain = ((temp2 >> 5) & 0x07) + ((temp1 << 1) & 0x18) + 365;




LOG_WARNING("ADC Gain is %d \r\n",m_ADCGain);




LOG_ERROR("The ADC Gain is error \r\n");




CG_WriteReg(PROTECT3, 0x11);     //测试写入功能

CG_ReadReg(PROTECT3, &temp1);

if(temp1 != 0x11)

    return I2C_TIMEOUT;

LOG_INFO(" Test the CG861xx write ok\r\n");

通过不同的日志等级还可以有不同的颜色显示,这里先放个效果:

到这里,单片机上需要的工作就结束了,只需要接上Jlink,用USB进行连接就行了。


总结及资料领取


SEGGER RTT毕竟是设计来与Jlink配合进行使用的,日志传输的速度非常快,并且支持在裸机、RTOS环境下运行,下图是官方宣传的理论性能:

作为一种不占用串口的日志输出方式,在部分应用场景下还是值得一试的,以下链接是打包好的代码,可以直接放到自己的工程中调用。

教你如何使用SEGGER RTT优雅的实现日志系统

相关推荐

F103C8T6移植FATFS文件系统 版本R0.15

STM32F103C8T6芯片在W25Q64上移植FATFS(版本R0.15)实现过程:1、首先完成USART初始化和调试,用于传输信息到串口调试软件。2、完成SPI相关参数配置及调试,用于单片机和存...

stm32使用MPU6050或ADXL345控制的车辆减速灯

本实验例程采用MPU6050六轴运动处理组件...

STM32F103串口输出prtinf覆盖(stm32printf函数的串口输出)

采用正点原子的板子,有如下坑,记录如下:(1)main中应用头文件#include"stdio.h"(2)采用hal进行fputc和fgetc覆盖,如下intfputc(intc...

STM32 学习8 USART串口通讯与printf重定向

一、串口通信介绍STM32F103ZET6包含多个UART、USART串口。...

教你如何使用SEGGER RTT优雅的实现日志系统

今天开始了BMS系统的软件代码部分的搭建,计划是分成三层:硬件驱动,AFE层和系统应用层。第一步肯定是先把底层的IIC通信调通,CG861xx的IIC通信和TI的BQ769X0...

终极调试利器,各种Link通吃(link4a调制方式)

今天继续更新一期KEIL调试方法。事实上,关于调试方法,鱼鹰写了一个系列,汇总文为《佛祖保佑,永无BUG,永不修改|KEIL调试系列总结篇》,对于KEIL方法感兴趣的可以看看。这个调试...

在 STM32 中使用 printf() 函数,别漏掉这几行代码!

问:在STM32上轻松使用printf函数除了点亮LED外,向串行控制台发送打印信息可能是调试嵌入式项目时最简单、最直接且最常用的技术。虽然大多数平台都拥有可以在UART总线上传输数据的API,但它们...

高性能异步io机制:io_uring(异步io select)

io_uring是linux内核5.10引入的异步io接口。相比起用户态的DPDK、SPDK,io_uring作为内核的一部分,通过mmap的方式实现用户和内核共享内存,并基于m...

精品博文ARM中打印函数print 的几种实现方法

1利用C库函数printf步骤:1)首先需要包含头文件stdio.h。2)然后定义文件句柄。实际上就是一个int型变量封装在结构体中。struct__FILE{inthandle;};3)定...

C语言char的详解(c语言(char))

在C语言中,char是一种基础数据类型,用于表示字符或小整数值。对char的理解和处理非常重要,尤其是在字符串操作、文件读写或其他需要直接控制内存的应用场景中。下面从基本定义、存储方式、常见用法...

C语言之文件操作(c语言文件操作实验总结)

文件操作是C语言中非常重要的功能,用于读取和写入文件中的数据。C语言提供了一组标准库函数(如fopen、fclose、fread、fwrite等)来实现文件操作。以下是针对C语言初学者的详细讲解。...

STM32-ADC如何把采集的数据转换为小数

编辑一、代码原理解析这段代码围绕“STM32中ADC数据采集、整数与小数计算及串口输出”展开,核心是数据类型的使用(unsignedint/signedint/float)、ADC数...

循环队列原理及在单片机串口通讯中的应用(二)

前言书接上回,前文主要介绍了环形队列的实现原理以及C语言实现及测试过程,本文将回归到嵌入式平台的应用中,话不多说,淦,上干货!...

STM32编程中printf函数重定向背后的原理

  在C语言中,printf是一个非常好用的函数,尤其是在程序调试阶段,我们可以通printf打印变量的值来帮助查错。在学习C语言的时候我们的开发环境和运行环境都是PC机,printf函数打印到PC机...

MySQL 避坑指南之隐式数据类型转换

...