一 .串口_重定向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);
str(输出缓冲区)
指向一个字符数组的指针,用于存放读取到的字符串。调用者必须保证这块内存足够大,至少能容纳 n 个字符(包括末尾的 '\0')。如果传入 NULL,行为未定义。
n(最大读取字符数)
指定最多读取的字符数量(包含末尾自动添加的 '\0' )。因此,fgets 实际最多从流中读取 n - 1 个字符,然后把 '\0' 放在末尾。例如 n = 10 时,最多读 9 个字符。
读取会在以下任一条件满足时停止:
-
已读取
n - 1个字符; -
遇到换行符
'\n'(换行符会被读入并保留在字符串中,回车换行不同的环境不一样可能示/r/n所以也要考虑有/r的情况); -
到达文件末尾(EOF)或发生错误。
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。
-
核心行为与细节
-
比较逻辑 :它逐字节比较,并在比较前将字符转换为小写(或进行等效的大小写折叠)。比较过程在遇到
'\0'、达到n个字节,或字符不匹配时停止。 -
提前终止 :即使
n很大,只要在任一字符串中遇到了空字符'\0',比较也会立即结束。这意味着它不会读取字符串结尾之后的内存。 -
Locale 依赖 :该函数的行为受当前 locale 的
LC_CTYPE类别影响。在标准的 "POSIX" locale 下,它严格按字节小写转换后比较;在其他 locale 下,结果可能因实现而异。 -
线程安全 :它是
MT-Safe locale的。这意味着它本身是线程安全的,但其行为依赖于全局 locale 设置,如果其他线程同时调用setlocale,结果可能不确定。