RT_Thread 调试笔记:串口打印、MSH控制台 相关

2024-01-07 18:04:43

说明:记录日常使用?RT_Thread 开发时做的笔记。

持续更新中,欢迎收藏。

1.打印相关

1.打印宏定义,可以打印打印所在文件,函数,行数。

#define PRINT_TRACE() printf("-------%s:%s:%d------\r\n", __FILE__, __FUNCTION__, __LINE__);
__FILE__:正在编译文件的路径及文件名
__LINE__:正在编译文件的行号
__DATE__:编译时刻的日期字符串 如“July 19 2019”
__TIME__:编译时刻的时间字符串  如”22:00:00“
__FUNCTION__:函数名,类型为:字符常量指针
__VER__:IDE版本信息,类型为:整型

2. rt thread 3.1.5? nano版本中添加 rt_kprintf() 函数功能

.1 rtconfig.h头文件中开启控制台相关宏 ?#define RT_USING_CONSOLE
.2 在 board.c 中 添加串口初始化函数 和 ?rt_kprintf() 串口输出调用的函数 rt_hw_console_output()

#ifdef RT_USING_CONSOLE

static int uart_init(void)
{
//#error "TODO 2: Enable the hardware uart and config baudrate."
    USART1_Init();
    return 0;
}
INIT_BOARD_EXPORT(uart_init);

void rt_hw_console_output(const char *str)
{
//#error "TODO 3: Output the string 'str' through the uart."
        /* empty console output */
    rt_enter_critical();
    while (*str != '\0')
    {
        HAL_UART_Transmit(&Uart1Handle, (uint8_t *) (str++), 1, 1000);
    }
    rt_exit_critical();
}

#endif

3. printf 重定向

可通过搜索功能查找到函数 fputc(),修改函数体中的串口数据发送函数。

/* printf 重定向  */
int fputc(int ch, FILE *f)
{
#if PRINTF_PORT_JLINK
    SEGGER_RTT_PutChar(0, ch);
#else
    HAL_UART_Transmit(&Uart1Handle, (uint8_t *)&ch, 1, 1000);
#endif
    return (ch);
}

int fgetc(FILE *f)
{

  int ch;
  HAL_UART_Receive(&Uart1Handle, (uint8_t *)&ch, 1, 1000);
  return (ch);
}

?4.串口打印函数

1.0 RT官方文档对print函数介绍

https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/libc/compiler

标准输出函数 (printf 家族)

printf 函数

在 Keil 和 IAR 编译平台下,用户可以直接使用 printf 函数;在 GCC 下,需要额外使能?RT_USING_POSIX_FS?和?RT_USING_POSIX_STDIO?宏才能使用 printf 函数。

rt_kprintf 函数 与 printf 函数的使用选择

????????如果不是特殊需求,建议使用 rt_kprintf 函数,因为 printf 是由编译平台内部提供的,其空间占用、以及内存使用情况我们无从得知,printf 函数要比 rt_kprintf 函数的 ROM 占用大很多。

????????无论是 rt_kprintf 函数以及 printf 函数都是非线程函数,在多线程同时使用的情况下,会出现交叉打印的现象,该问题是正常现象,因为根据 C 标准的要求,printf 函数就是非线程安全的。

????????原生 rt_kprintf 函数是经过优化的,占用空间要比 printf 函数小很多。但是 rt_kprintf 函数并不支持浮点类型的输出。因此:

  1. 如需 rt_kprintf 函数支持浮点类型的输出,可以安装?rt_vsnprintf_full 软件包
  2. 如需 rt_kprintf 函数支持线程安全输出,可以安装?rt_kprintf_threadsafe 软件包
  3. 上述两个软件包可以同时安装使用,以同时让 rt_kprintf 支持线程安全和浮点类型输出的能力。

????????其他字符串格式化输出函数 (例如 snprintf 等)

????????其他字符串格式化输出函数(例如 snprintf 等)都是可以直接使用的。

????????强烈建议用户使用 rt_snprintf 等 RT-Thread 这侧的函数来代替 snprintf 等函数以降低资源消耗。尤其是在 GCC 编译链下,Newlib(GCC 工具链内部默认的 C 库)内置提供的 snprintf 函数是非线程安全的,在多线程无保护输出浮点数的情况下可能会引发死机(snprintf 函数非线程安全是不正常的)。

????????同理,原生 rt_snprintf 等函数不支持浮点输出,用户可以通过安装?rt_vsnprintf_full 软件包?来支持浮点数输出。

1.1 串口打印函数,可以直接打印字符串,或者变量值。(以下两种方式)

 rt_kprintf("led_test");

打印某个变量的数据,如打印 count 变量值

    while (1)
    {
        rt_kprintf("thread1 count: %d\n", count ++);
        rt_thread_mdelay(500);
    }

1.2 printf 打印函数参数格式

描述:
????????C 库函数?int printf(const char *format, ...)?发送格式化输出到标准输出 stdout。
printf()函数的调用格式为:

printf("<格式化字符串>", <参量表>);

声明:下面是 printf() 函数的声明。

printf("<格式化字符串>", <参量表>);

参数:
????????format?-- 这是字符串,包含了要被写入到标准输出 stdout 的文本。它可以包含嵌入的 format 标签,format 标签可被随后的附加参数中指定的值替换,并按需求进行格式化。format 标签属性是?%[flags][width][.precision][length]specifier,具体讲解如下:

格式字符

意义

d

以十进制形式输出带符号整数(正数不输出符号)

o

以八进制形式输出无符号整数(不输出前缀0)

x,X

以十六进制形式输出无符号整数(不输出前缀Ox)

u

以十进制形式输出无符号整数

f

以小数形式输出单、双精度实数

e,E

以指数形式输出单、双精度实数

g,G

以%f或%e中较短的输出宽度输出单、双精度实数

c

输出单个字符

s

输出字符串

p

输出指针地址

lu

32位无符号整数

llu

64位无符号整数

1.3?按固位数输出

????????按固位数输出,比如4位 xxxx,6位 xxxxxx ,以下用 %x举例,其他格式也是相同用法。
应用说明,如果16进制(%x)输出 0x061E, 实际打印出的结果是 61E ,开始的0被省略掉。
如果需要按固定4位打印,则需要把 %x 改为 %04x,这样就能输出061E。

rt_kprintf("CpuID[0] = %08x ,CpuID[1] = %08x , CpuID[2] = %08x \r\n",CpuID[0],CpuID[1],CpuID[2]);

1.4 串口打印2,串口输出2,如通过串口打印输出一个字符数组。(非 rt_kprintf )

static rt_device_t serial;                                 /* 串口设备句柄 */
static char str[] = "中国加油,武汉加油,全世界加油!\r\n";  /* 需要发送的数据 */
//中间省略了串口配置的部分
rt_device_write(serial, 0, str, (sizeof(str)-1));
//打印输出,str是数组名可直接作为数组首地址的地址指针,sizeof(srt)计算数组的大小,这个语句可以自动全部打印输出str数组

1.5 RT THREAD 串口发送数据(非 rt_kprintf 函数)

向串口中写入数据,可以通过如下函数完成:

rt_size_t rt_device_write(rt_device_t dev, rt_off_t pos, const void* buffer, rt_size_t size);

参数

描述

dev

设备句柄

pos

写入数据偏移量,此参数串口设备未使用

buffer

内存缓冲区指针,放置要写入的数据

size

写入数据的大小

返回

——

写入数据的实际大小

如果是字符设备,返回大小以字节为单位;

0

需要读取当前线程的 errno 来判断错误状态

????????调用这个函数,会把缓冲区 buffer 中的数据写入到设备 dev 中,写入数据的大小是 size。
向串口写入数据示例程序如下所示:

#define SAMPLE_UART_NAME       "uart2"    /* 串口设备名称 */
static rt_device_t serial;                /* 串口设备句柄 */
char str[] = "hello RT-Thread!\r\n";
struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT; /* 配置参数 */
/* 查找串口设备 */
serial = rt_device_find(SAMPLE_UART_NAME);

/* 以中断接收及轮询发送模式打开串口设备 */
rt_device_open(serial, RT_DEVICE_FLAG_INT_RX);
/* 发送字符串 */
rt_device_write(serial, 0, str, (sizeof(str) - 1));

1.6 打印输出数据按格式对齐

????????比如输出数据1和11对齐,即输出01,11,这样有助于通过串口输出的数据整齐,方便后期数据处理;如下图,时分秒按2位显示对齐,只有各位数的,在十位补空格。这样让整个数据格式整齐。

????????具体输出函数如下,在需要显示指定位数的地方 %2d ,表示按2位数据格式输出10进制数据。
经过测试发现,如果限制数据为 %2d 但是实际数据是3位,则输出任然按3位输出。

rt_kprintf("%d.%d.%d/%2d:%2d:%2d:AHT10 温度:%d;SHT30 湿度:%d;SHT30 温度:%d;SHT30 湿度:%d;\n",\
		rtc_data_hex[6],rtc_data_hex[5],rtc_data_hex[4],rtc_data_hex[2],rtc_data_hex[1],rtc_data_hex[0],\
		AHT10_temperature,AHT10_humidity,SHT30_temperature,SHT30_humidity);

1.7 rt_kprintf 打印输出数据按格式对齐

????????使用 rt_kprintf 函数打印小数、浮点数,

rt_kprintf("表头 PA7 电压 = %d.%03d ,   传感器 PB0 电压 = %d.%03d\n", vol_bt / 1000, vol_bt % 1000, vol_sig / 1000, vol_sig % 1000);

1.8 调试信息、编译信息打印,如:编译路径,时间,日期,文件名字等等

__FILE__:正在编译文件的路径及文件名
__LINE__:正在编译文件的行号
__DATE__:编译时刻的日期字符串 如“July 19 2019”
__TIME__:编译时刻的时间字符串  如”22:00:00“
__FUNCTION__:函数名,类型为:字符常量指针
__VER__:IDE版本信息,类型为:整型


char BuildFile[] = __FILE__;
int  BuildLine = __LINE__;
char BuildDate[] = __DATE__;
char BuildTime[] = __TIME__;
/* 为打印调试提供文件,行数,函数名等附加信息:*/
rt_kprintf("编译文件路径:%s\n", BuildFile);
rt_kprintf("编译代码所在行:%d\n", TestLine);
rt_kprintf("编译日期:%s\n", BuildDate);
rt_kprintf("编译时间:%s\n", BuildTime);

打印效果

1.9 串口底层直接发送数据

for( i = 0 ; i < Send_Count; i++)  //循环发送,直到发送完毕
{
  while((USART1->SR&0X40)==0);//判断串口数据是否发送完
  USART1->DR = DataScope_OutPut_Buffer[i]; //从串口丢一个字节数据出去
}

1.10 串口函数 rt_kprintf 打印字符串数组

/*定义一个字符串数组*/
u_char Adc_Channel_Name[CH_NUM][12] = \
       {
            {"ch1_vh2_r "},\
            {"ch1_vh1_ra"},\
            {"ch1_vh1_la"},\
            {"ch1_vh2_l "},\
            {"ch1_vh1_rb"},\
            {"ch1_vh1_lb"},\
            {"ch2_vh2_r "},\
            {"ch2_vh1_ra"},\
            {"ch2_vh1_la"},\
            {"ch2_vh2_l "},\
            {"ch2_vh1_rb"},\
            {"ch2_vh1_lb"},\
            {"ch1_th1   "},\
            {"ch2_th1   "},\
            {"24v_th1   "},\
            {"3v3_th1   "},\

       };/*通道名称*/
     ---------------------  
       /*打印输出*/
    if (argc != 3 )
    {
        rt_kprintf("校准命令:请输入校准命令 和 校准目标值,单位mV,输入如: vcf ch1_vh2_r 14000 \n");
        rt_kprintf("当前采样电压 \n");
        for (uint8_t var = 0; var < CH_NUM; ++var)
        {
            rt_kprintf("%s = %d \n",&Adc_Channel_Name[var][0],Adc_Channel_InVol[var]);
        }

        return;
    } 

输出效果

1.11?关于 %*.*s , %.*s

????????小数点.后“*”表示输出位数,具体的数据来自参数表 printf 格式字符串中,与宽度控制和精度控制有关的常量都可以换成变量,方法就是使用一个“*”代替那个常量,然后在后面提供变量给“*”。同样,小数点.前也可以添加*,也要用户输入一个位宽值来代替,表示输出的字符所占位宽。也就是说,前面定义输出总宽度,后面定义输出字符个数。

举例:

#include <cstdio>  
#include <iostream>  
  
int main()  
{      
    char *s = "this is test example";  
    int a,b;  
    printf("%.*s\n", 10, s);//这里的常量10就是给*号的,你也可以用一个变量来控制宽度  
    printf("%*.*s\n", 20, 10, s);//常量20控制输出所占位宽,也可以用一个变量控制  
    std::cin>>a>>b; //输入15 10  
    printf("%*.*s\n", a, b, s);//输出为:-----this is te  前面定义输出总宽度,后面定义输出字符个数
    std::cin.get();  
    std::cin.ignore();//暂停程序执行  
}  
输出结果为:

this is te

----------this is te//-代表空格

15 ?10 //输入

-----this is te

转载于:https://www.cnblogs.com/ph829/p/5576832.html

1.12 打印宏定义内容

#define def_buffer_swver_data  "SW-MCU-V1.3-20210720"  /* 软件版本号 */
    
/* 软件版本号打印 */
rt_kprintf("软件版本号: ");
rt_kprintf("%s",def_buffer_swver_data);
rt_kprintf("\r\n");

1.13 仿 rt_kprintf()函数,用在调试串口外的串口,更方便发送数据

?修改代码中 rt_device_write() 串口句柄参数,就可以像 rt_kprintf()一样使用自定义的串口了。

/**
 * This function will print a formatted string on system console
 * 本函数基于 系统的 rt_kprintf 改动而来,主要改动了 指向串口硬件的变量  yl_uart_device
 * @param fmt the format
 */
void yl_kprintf(const char *fmt, ...)
{
    rt_device_t  yl_uart_device = serial_uart3;   /* 定义一个本函数用的串口硬件句柄 */

    va_list args;
    rt_size_t length;
    static char rt_log_buf[RT_CONSOLEBUF_SIZE];

    va_start(args, fmt);
    /* the return value of vsnprintf is the number of bytes that would be
     * written to buffer had if the size of the buffer been sufficiently
     * large excluding the terminating null byte. If the output string
     * would be larger than the rt_log_buf, we have to adjust the output
     * length. */
    length = rt_vsnprintf(rt_log_buf, sizeof(rt_log_buf) - 1, fmt, args);
    if (length > RT_CONSOLEBUF_SIZE - 1)
        length = RT_CONSOLEBUF_SIZE - 1;

    if (yl_uart_device == RT_NULL)
    {
        rt_hw_console_output(rt_log_buf);
    }
    else
    {
        rt_uint16_t old_flag = yl_uart_device->open_flag;

        yl_uart_device->open_flag |= RT_DEVICE_FLAG_STREAM;

        //rt_device_write(serial_uart3, 0, rt_log_buf, length); /* 串口对应 RS232 */
        yl_rt_device_write(serial_uart3, 0, rt_log_buf, length);/* 串口对应硬件是RS485接口 */

        yl_uart_device->open_flag = old_flag;
    }

    va_end(args);
}
RTM_EXPORT(yl_kprintf);

1.14 仿 rt_kprintf()函数,方便打印调试信息的开关

通过宏定义来统一管理调试信息输出的开关

以下代码通过仿  LOG_D("Hello RT-Thread!"); 改变而得。

/**************************以下内容放到 .h 文件中**************************************/
#define DEBUG_PRINTF_ONOFF 0        /* 调试信息打印开关 */
/* 调试信息打印函数 */
#define debug_printf(fmt, ...)                                  \
    do                                                          \
    {                                                           \
        if(DEBUG_PRINTF_ONOFF)rt_kprintf(fmt, ##__VA_ARGS__);   \
    }                                                           \
    while (0)
 
 /************************** .c 文件中的调用 **************************************/   
    for (uint8_t var = 0; var < max; ++var)
    {
        debug_printf("函数回调功能触发  =  %d \r\n",var);
        rt_thread_mdelay(100);
    }

2. MSH 控制台功能

1. rt thread 3.1.5? nano版本中添加 MSH 控制台功能

.1 在 keil 软件包中勾选 shell 功能

.2 在 finsh_port.c 中看提示开启宏和串口接收函数。

添加 shell 功能后编译 在 finsh_port.c 文件中会有2个错误的提示。

/* 在 rtconfig.h  中开启 #include "finsh_config.h 宏 */
#ifndef RT_USING_FINSH
#error Please uncomment the line <#include "finsh_config.h"> in the rtconfig.h 
#endif

#ifdef RT_USING_FINSH

/* 定义串口接收功能 */
RT_WEAK char rt_hw_console_getchar(void)
{
    /* Note: the initial value of ch must < 0 */
    int ch = -1;

//#error "TODO 4: Read a char from the uart and assign it to 'ch'."

    return ch;
}

#endif /* RT_USING_FINSH */

.3 定义一个接收函数,放到 rt_hw_console_getchar 中调用

前提:串口已经实现了对串口数据的接收,接收的数据存储在了接收缓存中,缓存的前2个字节用于存储 shell 取了第几个字节数据,第3个字节开始存储串口收到的数据。

void read_uart1_ch(int *ch)
{
    uint16_t *count = NULL;
    count = (uint16_t *)usart1_rx_buf;

    *ch = usart1_rx_buf[*count];

    if (*ch == 0)
    {
        *ch = -1;
    }
    else
    {
        *count = *count +1;
    }
}

3.调试笔记:

1.rt thread ?内存申请失败调试笔记

问题描述:
1.在线程中调用了一个函数A,该函数会申请内存函数结束前会再释放。测试中发现这个函数在线程中调用几次后就提示异常,申请不到内存。
2:请教:内存的释放 是否是在 rt_free 后就完成?
3:大概逻辑

线程()
{
  while(n)
  {
    调用函数:A(申请内存,执行相关工作,释放内存);
    延时;
    调用函数:A(申请内存,执行相关工作,释放内存);
    延时;
  }
}

?问题已解决自己回答:
1:调试发现内存堆分配了15K,关掉发现问题的线程后,发现系统跑起来其他线程都运行后,内存最大已经使用了13K多,这就反应了为什么前几次能申请到内存后面就申请不到了,因为这个线程运行的比较早开始时内存充足可以申请到,后面问题线程延时时系统调度启动了别的线程,导致内存堆空间减少,延时结束继续申请内存时就出现了内存不足。
2:增大内存堆后问题解决。

2. rt-thread 3.1.5 内存堆大小设置

.1 修改位置

在 board.c 文件中修改  #define RT_HEAP_SIZE (30*1024)
#if defined(RT_USING_USER_MAIN) && defined(RT_USING_HEAP)
/*
 * Please modify RT_HEAP_SIZE if you enable RT_USING_HEAP
 * the RT_HEAP_SIZE max value = (sram size - ZI size), 1024 means 1024 bytes
 */
#define RT_HEAP_SIZE (30*1024)
static rt_uint8_t rt_heap[RT_HEAP_SIZE];

.2 官方介绍: RT-Thread 堆区大小设置

?RT-Thread 堆区大小设置

链接:https://www.cnblogs.com/jzcn/p/16427067.html

介绍了 RT-THREAD 内存堆的设置,STM32内存分布情况。

文章来源:https://blog.csdn.net/yutian0606/article/details/135395269
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。