STM32:串口_重定向CIO(3)

一 .串口_重定向CIO

在学习 C 语言时,大家经常使用 printf 进行日志打印,在 MCU 系统中没有像电脑那样的标准显示器,那么还能使用 printf 函数进行打印吗?当然可以使用,由于嵌入式单板的多样性,我们需 要根据具体情况重新适配 printf 函数。⼀般嵌入式系统都会有串口,那我们就让 printf 函数通过串口进行打印( 叫做重定向到串口 )。当将 printf 重定向到串口后,我们就可以像学习 C 语言时那样使用 printf 函数了。

工程配置和串口轮询一样。

想要通过printf打印日志,printf底层是通过调用fputc来向显示器⼀次写入⼀个字符的,scanf/fgets底层是通过调用fgetc来从键盘⼀次读取⼀个字符,因此,我们只需要把这两个底层函数进行重写,就可以完成串口的重定向。

cs 复制代码
int fputc(int ch, FILE *f)
{
    uint8_t data = (uint8_t)ch;
    if (HAL_UART_Transmit(&huart1, &data, 1, HAL_MAX_DELAY) == HAL_OK) 
    {
        return ch;
    } else 
        {
            return EOF;
        }
}
int fgetc(FILE *f)
{
    uint8_t ch = 0;
    while (1) 
    {
        if (HAL_UART_Receive(&huart1, &ch, 1, HAL_MAX_DELAY) != HAL_OK) 
        {
        return EOF;
        }
// 忽略 \r,只保留 \n
    if (ch != '\r') 
        {
    return (int)ch;
        }
    }
}


while (1)
{
    char buffer[64];
    fgets(buffer, 63, stdin);
    printf("echo# %s\n", buffer);
    HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_8);
}

这个烧录需要开启MicroLIB

MicroLIB 是 ARM 公司提供的⼀个高度优化的 C 语言标准库,它旨在为资源极度受限的设备( 例如:使用 Cortex-M 系列内核的微控制器 )提供⼀个轻量级、高性能的替代方案,以替代标准的、更庞大的 Newlib 或 Glibc 库。简单来说, MicroLIB 就是 "为单片机量身定制的迷你版标准 C 库"。

cs 复制代码
char *fgets(char *str, int n, FILE *stream);
  1. str(输出缓冲区)

指向一个字符数组的指针,用于存放读取到的字符串。调用者必须保证这块内存足够大,至少能容纳 n 个字符(包括末尾的 '\0')。如果传入 NULL,行为未定义。

  1. n(最大读取字符数)

指定最多读取的字符数量(包含末尾自动添加的 '\0' )。因此,fgets 实际最多从流中读取 n - 1 个字符,然后把 '\0' 放在末尾。例如 n = 10 时,最多读 9 个字符。

读取会在以下任一条件满足时停止:

  • 已读取 n - 1 个字符;

  • 遇到换行符 '\n'(换行符会被读入并保留在字符串中,回车换行不同的环境不一样可能示/r/n所以也要考虑有/r的情况);

  • 到达文件末尾(EOF)或发生错误。

  1. stream(输入流)

指向 FILE 结构的指针,指定从哪个流读取。常见的是 stdin(标准输入)或 fopen 打开的文件流。不能传 NULL。

返回值

  • 成功:返回 str 本身。

  • 失败或到达文件末尾且未读到任何字符:返回 NULL。注意:如果读到 EOF 前已经读到了部分字符,fgets 仍会返回 str,下次调用才返回 NULL。

一个易错点

n 是缓冲区总大小,不是"要读的字符数"。很多人误以为 fgets(buf, 10, stdin) 会读 10 个字符,实际上最多只读 9 个,因为第 10 个位置要留给 '\0'。

二.多文件

代码多文件(多文件编程)的核心原因可以归结为一句话:把"接口"和"实现"分离,让代码可维护、可复用、可并行开发、可增量编译。下面从几个维度展开。

1. 逻辑分离:一个文件只做一件事

单文件写几千行后,函数、变量、宏全混在一起,阅读和定位成本急剧上升。多文件让每个 .c 文件对应一个功能模块(如 list.c 管链表、file.c 管文件读写、main.c 只负责流程),职责清晰。

2. 接口与实现分离(头文件的作用)

  • .h 头文件声明对外接口 :函数原型、类型定义、宏、extern 变量声明。

  • .c 源文件写具体实现 ,内部辅助函数用 static 隐藏,外部不可见。

这样调用者只需 #include 头文件就知道怎么用,不需要关心实现细节,也防止了内部符号污染全局命名空间。

3. 可复用性

一个写好的模块(如 stack.c + stack.h)可以原样拿到另一个项目中使用,只需拷贝这两个文件并编译,无需从大文件里"抠"代码。

4. 增量编译,提升构建效率

编译器以翻译单元 (一个 .c 文件预处理后的结果)为单位编译。修改一个 .c 文件时,只需重新编译该文件并重新链接,其他 .o 目标文件可复用。单文件项目改一行就要全量重编,大项目里差异巨大。

5. 并行开发与团队协作

多人协作时,每人负责不同模块文件,减少代码冲突。版本控制中 diff 也更清晰,谁改了哪个模块一目了然。

6. 避免重复定义与链接错误

C 语言中,函数和全局变量在整个程序 里只能有一处定义(ODR 原则的 C 版本体现)。多文件配合头文件声明(extern、函数原型)和 .c 中的定义,天然符合"声明可多处、定义仅一处"的规则。若全写一个文件反而容易因重复包含导致重定义。

7. 控制符号可见性

  • static 函数/变量:文件作用域,仅本 .c 可见,避免命名冲突。

  • 非 static 的全局符号:通过头文件暴露给其他文件。

多文件结构让"哪些对外、哪些私有"有明确的物理边界。

8. 编译期检查与模块化测试

每个模块可单独编译(gcc -c module.c),甚至单独写测试程序链接该模块的 .o 进行单元测试,不依赖 main 和其他模块。

三.实线多文件

创建一个公共模块文件夹,在里面新建头,源文件夹。

添加Usart重定向驱动文件

引入到项目中,先新建组

添加刚刚建立的源文件

要是想要编译成功,还需要添加刚刚加的源文件头文件路径,魔法棒的C/C++中添加

选择编译通过了,可以打开vscoed把项目文件夹添加到keil assistant

头文件编写

cs 复制代码
#ifndef _BSP_USART_REDIR_H
#define _BSP_USART_REDIR_H//防止头文件被重复包含

 #ifdef __cplusplus
 extern "C"{//告诉编译器头文件的函数是用C语言编译的`
 #endif

#include "stm32f1xx_hal.h"
#include "stdio.h"

extern UART_HandleTypeDef *ghuart1;

void BSP_Usart_Init(UART_HandleTypeDef *huart1);

#ifdef __cplusplus
}
 #endif
#endif

源文件编写

cs 复制代码
#include "BSP_Usart_Redir.h"

 UART_HandleTypeDef *ghuart1 = NULL;

 void BSP_Usart_Init(UART_HandleTypeDef *huart1)
 {
     if(NULL == huart1)
     {
         return;
     }
     ghuart1 = huart1;
 }

 int fputc(int ch, FILE *f)
 {
     UNUSED(f);
     if (NULL != ghuart1)
     {
        
         if(HAL_UART_Transmit(ghuart1, (uint8_t*)&ch, 1, HAL_MAX_DELAY) == HAL_OK)
         {
             return ch;
         }
         else
             return EOF;
     }
     else
         return EOF;
 }
 int fgetc (FILE *f)
 {
     UNUSED(f);
     if (NULL != ghuart1)
     {
         uint8_t ch;
         while(1)  
         {
             if(HAL_UART_Receive(ghuart1, &ch, 1, HAL_MAX_DELAY) != HAL_OK)
             {
                 return EOF;
             }
             if(ch != '\r')
             {
                 return (int)ch;
             }
           
         }
         
     }
      else
         return EOF;               
 }

main函数

cs 复制代码
/* USER CODE BEGIN Includes */
#include "BSP_Usart_Redir.h"
#include <string.h>
/* USER CODE END Includes */


/* USER CODE BEGIN PV */
char inbuffer[32];
int size = sizeof(inbuffer) / sizeof(inbuffer[0]);
/* USER CODE END PV */


/* USER CODE BEGIN PV */
char inbuffer[32];
int size = sizeof(inbuffer) / sizeof(inbuffer[0]);
/* USER CODE END PV */


/* USER CODE BEGIN PFP */
void Usart_Control_LED();
/* USER CODE END PFP */


int main(void)
{
  /* USER CODE BEGIN 2 */
  BSP_Usart_Init(&huart1);
  
  printf("usart test begin\n");
  /* USER CODE END 2 */


/* USER CODE BEGIN WHILE */
while (1)
{
    
    Usart_Control_LED();
    /* USER CODE END WHILE */
}


/* USER CODE BEGIN 4 */
void Usart_Control_LED()
{
  fgets(inbuffer, size-1, stdin);
if (strncasecmp("LED1", inbuffer, strlen("LED1")) == 0)
  {
    BSP_LED_Blink(LED1);
  }
  else if (strncasecmp("LED2", inbuffer, strlen("LED2")) == 0)
  {
    BSP_LED_Blink(LED2);
  }
  else if (strncasecmp("LED3", inbuffer, strlen("LED3")) == 0)
  {
    BSP_LED_Blink(LED3);
  }
  else if (strncasecmp("LED4", inbuffer, strlen("LED4")) == 0)
  {
    BSP_LED_Blink(LED4);
  }
   else if (strncasecmp("ALL", inbuffer, strlen("ALL")) == 0)
  {
    BSP_LED_Blink(ALL);
  }
}
/* USER CODE END 4 */

输入特定的字符相应的LED亮

cs 复制代码
#include <strings.h>

int strncasecmp(const char *s1, const char *s2, size_t n);

参数与返回值

  • 参数 :s1、s2 为待比较的字符串;n 为最多比较的字节数。

  • 返回值:返回一个整数,其符号表示比较结果。

    • 小于 0:s1 小于 s2。

    • 等于 0:s1 等于 s2(在比较的 n 个字节内,忽略大小写)。

    • 大于 0:s1 大于 s2。

核心行为与细节

  1. 比较逻辑 :它逐字节比较,并在比较前将字符转换为小写(或进行等效的大小写折叠)。比较过程在遇到 '\0'、达到 n 个字节,或字符不匹配时停止。

  2. 提前终止 :即使 n 很大,只要在任一字符串中遇到了空字符 '\0',比较也会立即结束。这意味着它不会读取字符串结尾之后的内存。

  3. Locale 依赖 :该函数的行为受当前 locale 的 LC_CTYPE 类别影响。在标准的 "POSIX" locale 下,它严格按字节小写转换后比较;在其他 locale 下,结果可能因实现而异。

  4. 线程安全 :它是 MT-Safe locale 的。这意味着它本身是线程安全的,但其行为依赖于全局 locale 设置,如果其他线程同时调用 setlocale,结果可能不确定。

相关推荐
少司府10 小时前
嵌入式外设篇(二)GPIO·二:GPIO输出与LED控制
linux·stm32·单片机·嵌入式硬件·mcu·51单片机·系统
Flying Bear14 小时前
Keithley 2450 SourceMeter源表上位机开发笔记
笔记·单片机·嵌入式硬件
无敌贵点大王16 小时前
从寄存器层面重学STM32(11)——ADC理论
stm32·单片机·嵌入式硬件
Zw-awa17 小时前
卡尔曼到底在算什么:从一维到它的变式以及工程版卡尔曼滤波算法C语言实现
stm32
希和202721 小时前
代码讲解:STM32F103C8T6 驱动 HC-SR04 超声波测距
stm32·单片机·嵌入式硬件
编程小白菜1231 天前
STM32L0 ADC串扰揭秘:充电电压如何“伪造”压力数据
stm32·单片机·嵌入式硬件
Zw-awa1 天前
两路信号,两种滤波:角速度走低通滤波,加速度走卡尔曼滤波
stm32
橘为己有4412 天前
STM32:USART 串口(2)
stm32·单片机·嵌入式硬件
少司府2 天前
嵌入式外设篇(一)GPIO·一:认识GPIO
linux·单片机·嵌入式硬件·mcu·系统·rtos·嵌入式软件