简介：本资源是一份面向STM32初学者与嵌入式开发者的实战型UART通信教学程序，聚焦于UART2模块的printf格式化输出与scanf交互式输入功能实现，解决库函数环境下标准I/O重定向这一典型学习难点。压缩包共161个文件，含28个C源码（如stm32f10x_rcc.c、stm32f10x_uart.c等核心驱动）、29个头文件（h）、32个汇编文件（s）及若干编译中间文件（o、d、crf）和工程配置文件（uvproj、uvopt、sct等），完整保留Keil MDK-ARM神舟IV号开发板工程结构，总大小3.07MB。已有866人学习下载，说明其在实践教学中具备较强参考价值。读者可直接导入MDK工程编译运行，获取已验证的UART2初始化配置、_write()重定向实现、中断式接收缓冲区设计、简易scanf解析逻辑及配套串口调试方法，同时附带清晰的中文注释与模块化代码组织，便于理解底层通信机制并快速迁移至其他UART端口或项目。
1. 串口2当控制台用：不用ST-Link Debugger也能实时printf调试，STM32神舟IV号板子上亲测跑通
你有没有试过在STM32裸机开发中，想看个变量值还得打断点、单步、查寄存器，结果一断就丢掉时序逻辑？或者用串口1接USB转TTL调试，但板子上串口1已经被GPS模块占了，只剩串口2空着——这时候，把USART2当成printf和scanf的底层IO设备，直接在终端里打命令、看日志、改参数，才是真·嵌入式开发的呼吸感。这个“STM32神舟IV号-库函数版”项目，就是专为这种场景而生：它不依赖任何半主机（semihosting）或调试器重定向，纯靠标准库函数封装+USART2硬件驱动，实现printf("cnt=%d\r\n", i);能发出去，scanf("%d", &mode);能收进来，且已在神舟IV号开发板（STM32F103ZET6，LQFP144）上实测通过。适合刚脱离Keil仿真器、开始摸真实外设的中级开发者，也适合需要快速验证通信协议逻辑的固件工程师——它不是教学Demo，是能焊进产品原型里的最小可行串口交互层。
2. 工程结构与核心依赖：从startup到usart2_init，五层文件链全拆解
这个项目走的是ST官方标准外设库（Standard Peripheral Library v3.5.0）路线，不是HAL也不是LL，所有代码都扎根在stm32f10x_lib.h生态里。整个工程目录干净得像刚擦过的示波器屏幕：没有CMSIS以外的第三方库，没有中间件，连stdio.h都只用它最朴素的printf/scanf声明，不碰fopen这类文件操作。我把它按编译依赖顺序理成五层链路，每层都决定你能不能打出第一个字符：
2.1 启动文件与系统时钟：SystemInit()之后，SysTick必须先跑起来
神舟IV号板载8MHz晶振，但system_stm32f10x.c里默认配置的是72MHz主频（PLL=HSE×9）。关键点在于：printf底层依赖_write重定向，而_write的阻塞等待靠的是SysTick_GetCounter()轮询——如果SystemInit()没调通，SysTick没启动，printf就会卡死在while循环里。
// system_stm32f10x.c 片段（需确认已启用） void SystemInit(void) { RCC_DeInit(); // 复位RCC寄存器 RCC_HSEConfig(RCC_HSE_ON); // 开启外部8MHz晶振 while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET); // 等待晶振稳定 RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); // PLL=8MHz×9=72MHz RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); // 切换系统时钟源 RCC_HCLKConfig(RCC_SYSCLK_Div1); // AHB = 72MHz RCC_PCLK1Config(RCC_HCLK_Div2); // APB1 = 36MHz（USART2挂APB1） RCC_PCLK2Config(RCC_HCLK_Div1); // APB2 = 72MHz SysTick_Config(SystemCoreClock / 1000); // SysTick中断1ms一次（printf超时等待基线） }提示：如果你用的是ST-Link V2烧录，记得在Keil的Debug → Settings → SWO Trace里关掉SWO输出，否则
SysTick可能被干扰；实测发现神舟IV号底板上JTAG/SWD跳线必须设为SWD模式，否则RCC_GetFlagStatus()读不到HSERDY标志。
2.2 USART2硬件初始化：GPIO复用、时钟使能、波特率计算一个都不能少
神舟IV号原理图显示：USART2的TX引脚是PA2，RX是PA3，均需配置为复用推挽输出（TX）和浮空输入（RX）。这里最容易翻车的是时钟使能顺序：必须先开APB1总线时钟，再开GPIOA时钟，最后初始化USART2——反了就会触发HardFault。
// usart2_init.c 关键初始化流程 void USART2_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; // 1. 使能APB1总线上的USART2时钟（必须最先！） RCC_APB1PeriphClockCmd(RCC_APB1PERIPH_USART2, ENABLE); // 2. 使能GPIOA时钟（PA2/PA3所在端口） RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA, ENABLE); // 3. 配置PA2为复用推挽输出（TX） GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 4. 配置PA3为浮空输入（RX） GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); // 5. 配置USART2参数：9600bps, 8N1, 无硬件流控 USART_InitStructure.USART_BaudRate = 9600; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART2, &USART_InitStructure); // 6. 使能USART2 USART_Cmd(USART2, ENABLE); }注意：USART_BaudRate = 9600看似简单，但背后是APB1时钟（36MHz）经DIV分频算出的整数倍。实测神舟IV号在72MHz系统时钟下，APB1=36MHz，USARTDIV = (36000000)/(16×9600) ≈ 234.375，取整后误差0.16%，完全在RS232容忍范围内。若你改成115200bps，DIV=19.53，误差会飙升到2.1%，必须手动校准USARTDIV小数部分（本项目未做，故坚持9600）。
2.3printf重定向：_write函数如何把格式化字符串喂给USART2
这是整个项目最玄学也最关键的环节。标准库的printf最终会调用_write(int fd, char *ptr, int len)，而我们要做的，就是把这个函数重写，让它不再往文件写，而是逐字节塞进USART2发送寄存器。重点不是“怎么发”，而是“怎么等”——必须用while(!(USART2->SR & USART_FLAG_TXE));轮询发送寄存器空闲标志，不能用中断（否则printf会异步返回，格式错乱）。
// syscalls.c（必须放在工程里，且不能被优化掉） #include "stm32f10x_usart.h" // 重定义_write，适配USART2 int _write(int fd, char *ptr, int len) { int i = 0; if (fd == 1 || fd == 2) { // stdout/stderr for (i = 0; i < len; i++) { // 等待发送寄存器空闲（TXE=1） while (!(USART2->SR & USART_FLAG_TXE)); // 写入数据寄存器 USART2->DR = (uint16_t)(*ptr++); } return len; } return 0; }注意：
_write返回值必须是实际写入字节数，否则printf内部状态会错乱；while循环里不能加__NOP()，否则在-O2优化下可能被编译器删掉，导致发送失败。
2.4scanf重定向：_read函数如何从USART2接收缓冲区捞字符
scanf的底层是_read(int fd, char *ptr, int len)，它要求我们从外设读len个字节到ptr。难点在于：串口是流式设备，没有“文件末尾”，所以必须自己定义结束条件——本项目采用“收到\r或\n即认为一行结束”。同时，为避免scanf卡死，必须加超时机制（本项目用SysTick计数器实现1秒超时）。
// syscalls.c 续写 extern __IO uint32_t uwTick; // SysTick计数器（由system_stm32f10x.c提供） int _read(int fd, char *ptr, int len) { int i = 0; uint32_t start_tick = uwTick; if (fd == 0) { // stdin for (i = 0; i < len; i++) { // 超时检测：1秒内无数据则退出 if ((uwTick - start_tick) > 1000) { break; } // 等待接收寄存器非空（RXNE=1） while (!(USART2->SR & USART_FLAG_RXNE)) { if ((uwTick - start_tick) > 1000) break; } if (USART2->SR & USART_FLAG_RXNE) { *ptr++ = (char)(USART2->DR & 0xFF); // 遇到\r或\n停止读取（模拟行结束） if (*(ptr-1) == '\r' || *(ptr-1) == '\n') { break; } } } return i; } return 0; }这里有个血泪经验：USART2->DR读操作会自动清除RXNE标志，所以必须在判断RXNE为真后立刻读DR，否则下次轮询时标志已消失，导致漏字节。
2.5 主函数集成：main.c里三行代码启动交互循环
一切就绪后，main.c简洁得不可思议——初始化、重定向、死循环scanf/printf。但正是这三行，决定了你能否在Putty里敲出123然后看到You entered: 123。
// main.c #include "stm32f10x.h" #include "usart2_init.h" #include <stdio.h> int main(void) { SystemInit(); // 系统时钟、SysTick USART2_Init(); // USART2硬件初始化 printf("\r\nSTM32 USART2 Console Ready!\r\n"); // 第一条输出，验证通道 while(1) { int input; printf("Enter a number: "); if (scanf("%d", &input) == 1) { // 成功读到一个整数 printf("You entered: %d\r\n", input); } else { printf("Invalid input, try again.\r\n"); // 清空接收缓冲区残留（关键！） while(USART2->SR & USART_FLAG_RXNE) USART2->DR; } } }提示：
scanf失败后不清空RX缓冲区，会导致下次scanf直接读到上次的垃圾数据——这是新手最常踩的坑，务必加那行清空代码。
3. 编译与下载全流程：Keil MDK-ARM v5.27实测步骤（含HEX生成与串口工具配置）
这个项目对IDE版本敏感度不高，但Keil v5.27是个黄金平衡点：既支持ST标准库v3.5.0的旧语法，又不会因太新而报__packed等废弃关键字错误。下面是从零创建工程到Putty看到Hello World的完整路径，每一步都对应一个可验证的检查点。
3.1 Keil工程创建：五个必须勾选的选项
新建工程时，CPU选择ARM-Cortex-M3，Device选STM32F103ZE（神舟IV号主控）。关键在Options for Target → C/C++页：
- Define栏填入：
USE_STDPERIPH_DRIVER, STM32F10X_MD_VL
（MD_VL对应中密度VL系列，神舟IV号是ZET6，属中密度，别错填成HD） - Include Paths添加：
.\CMSIS\Include.\STM32F10x_StdPeriph_Driver\inc.\User
（缺任何一个，#include "stm32f10x_usart.h"都会报错） - Code Generation：勾选
Use MicroLIB
（标准库的printf/scanf依赖MicroLIB的精简版libc，不勾选会链接失败）
注意：
Use MicroLIB一旦勾选，就不能再用fopen/fread等文件操作函数，但本项目本来就不需要——这是刻意为之的设计取舍。
3.2 文件添加与编译：确保六个源文件全部加入Build
工程中必须包含以下6个.c文件，缺一不可（.h头文件由#include自动关联）：
| 文件名 | 作用 | 是否可删 |
|---|---|---|
startup_stm32f10x_md_vl.s | 启动代码（神舟IV号用MD_VL版） | ❌ 绝对不可删 |
system_stm32f10x.c | 系统时钟初始化 | ❌ 必须，且需确认HSE配置匹配板载晶振 |
stm32f10x_usart.c | ST官方USART驱动（来自StdPeriph库） | ❌ 不可删，USART_Init()在此 |
usart2_init.c | 本项目特有：USART2引脚+外设初始化 | ❌ 核心文件 |
syscalls.c | 本项目特有：_write/_read重定向 | ❌ 没它printf就是哑巴 |
main.c | 主程序入口 | ❌ 当然要 |
编译时若报undefined symbol _write，说明syscalls.c没加进工程或被排除编译；若报undefined symbol USART2，则是stm32f10x_usart.c缺失。
3.3 HEX文件生成与ST-Link烧录：两步确认Flash写入成功
Options for Target → Output页：
- 勾选
Create HEX File（生成project.hex供量产烧录） Name of Executable填USART2_Console（方便识别）
烧录前必做三件事：
- 将神舟IV号板载的
BOOT0跳线帽拨到1（进入系统存储器启动模式） - 用ST-Link V2连接板子SWD接口，Keil中Project → Options → Debug → ST-Link Debugger → Settings → Flash Download里勾选
Reset and Run - 点击Load按钮，观察Keil底部Build Output窗口是否出现
Programming Done和Verify OK
提示：烧录后立刻把
BOOT0拨回0，否则下次上电仍从系统存储器启动，不运行你的程序。
3.4 串口终端配置：Putty设置要点（9600-8-N-1-无流控）
打开Putty，Serial选项卡填：
- Serial line:
COMx（Windows设备管理器查，通常是COM3/COM4） - Speed:
9600 - Connection type:
Serial - Terminal settings:
Implicit CR in every LF✅（让\n自动转\r\n，显示不换行）Local echo✅（本地回显，敲字能看到）Line discipline选Auto
连接后，按板子复位键（RST），应立刻看到：
STM32 USART2 Console Ready! Enter a number:如果只看到乱码（如~@），99%是波特率不匹配——请回头检查USART_InitStructure.USART_BaudRate和Putty设置是否都是9600。
3.5 常见问题排查：五条真实翻车记录与解法
现象1：Keil编译报错Error: L6218E: Undefined symbol _sys_exit
原因：_sys_exit是MicroLIB的退出函数，但本项目没实现它；ST标准库工程中，此符号由retarget.c提供，而本项目未包含该文件。
解决：在syscalls.c末尾添加空实现：
void _sys_exit(int return_code) { while(1); // 死循环，嵌入式不退出 }现象2：printf能输出，但scanf永远读不到数据，Putty敲字无反应
原因：USART2->CR1寄存器的RE（Receiver Enable）位未置1，或GPIOA的PA3没配置成IN_FLOATING。
解决：在USART2_Init()末尾加强制使能：
USART2->CR1 |= USART_CR1_RE; // 确保接收使能现象3：Putty里输入数字后，printf显示You entered: 0
原因：scanf("%d", &input)读取时，input变量未初始化，且scanf返回值非1（读取失败），但代码没处理，直接打印了脏值。
解决：严格检查scanf返回值，如前述main.c中的if (scanf(...) == 1)判断。
现象4：连续输入两次数字，第二次scanf直接跳过，打印Invalid input
原因：第一次输入后，回车符\r\n残留在USART2接收缓冲区，第二次scanf立即读到\r，解析失败。
解决：在scanf失败分支里，加缓冲区清空：
while(USART2->SR & USART_FLAG_RXNE) USART2->DR; // 清空所有残留现象5：烧录后板子LED不亮，Putty无任何输出
原因：SystemInit()中RCC_HSEConfig(RCC_HSE_ON)失败，while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET)无限等待。
解决：用示波器测PA8（HSE_OUT）是否有8MHz波形；若无，检查晶振焊接、RCC_HSE_BYPASS是否误启用（神舟IV号用外部晶振，非旁路模式）。
4. 核心模块代码逐行剖析：_write与_read的寄存器级真相
现在我们沉到最底层，把syscalls.c里那两个重定向函数掰开揉碎。这不是为了炫技，而是当你某天需要把printf接到SPI OLED屏，或把scanf改成红外遥控解码时，必须懂的底层契约。
4.1_write函数：为什么必须用TXE而非TC标志？
USART_SR（状态寄存器）里有两个关键位：TXE（Transmit Data Register Empty）和TC（Transmission Complete）。初学者常误用TC，以为“发送完成才写下一个”，但这是致命错误。
// 错误示范：用TC标志（会导致发送卡顿、丢字节） while (!(USART2->SR & USART_FLAG_TC)); // 等待整个帧发送完毕 USART2->DR = *ptr++;真相：TXE表示数据寄存器空闲（可写入新字节），TC表示移位寄存器空闲（当前字节已发完）。printf输出字符串时，必须在前一字节送入移位寄存器后，立刻把下一字节写入数据寄存器，才能维持连续发送。若等TC，则每个字节间有移位时间（约1ms@9600bps），printf("Hello")会变成H-e-l-l-o带明显间隔。
// 正确逻辑：用TXE标志（流水线式发送） while (!(USART2->SR & USART_FLAG_TXE)); // 等数据寄存器空 USART2->DR = (uint16_t)(*ptr++); // 立刻写入，移位寄存器自动取走参数说明：
USART2->DR是16位寄存器，但UART只用低8位，高8位为保留位，所以强制(uint16_t)类型转换避免编译警告。
4.2_read函数：RXNE标志的“一次性”特性与防抖设计
RXNE（Read Data Register Not Empty）是边沿触发标志：当接收移位寄存器把字节搬进数据寄存器时，RXNE置1；但只要你不读DR，它就一直为1——这会导致while(!RXNE)循环永远不退出。所以正确流程是：检测RXNE→读DR（自动清RXNE）→再检测。
// 正确读取单字节（带超时） uint32_t start = uwTick; while (!(USART2->SR & USART_FLAG_RXNE)) { if ((uwTick - start) > 100) return -1; // 100ms超时 } char c = (char)(USART2->DR & 0xFF); // 读DR同时清RXNE但scanf要读一行，不能只读一个字节。本项目用for循环+\r/\n截断，但更健壮的做法是加环形缓冲区（ring buffer）。不过对于神舟IV号这种资源紧张的板子，本项目选择轻量方案——代价是无法处理粘包（如Putty快速连发123\r\n456\r\n，scanf只能读到123）。
4.3printf格式化开销：为什么不用sprintf拼接再发？
有人提议：先sprintf(buf, "cnt=%d", i);，再for循环发buf。这看似合理，但埋了两个雷：
- 栈溢出风险：
sprintf内部需要临时缓冲区，MicroLIB的sprintf默认栈开销约128字节，而神舟IV号默认栈只有0x200（512字节），多几层调用就爆栈； - 实时性破坏：
sprintf是纯CPU运算，耗时随字符串长度指数增长，printf("Value: %08x", 0x12345678)比printf("OK")慢10倍以上。
本项目直送_write，printf内部逐字符调用_write，虽然每次都要轮询TXE，但总延迟可控（<10us/字节），更适合硬实时场景。
4.4scanf的脆弱性：为何不支持浮点与长整型？
MicroLIB的scanf实现极度精简，只支持%d %u %x %c %s，且%d最大解析32位有符号整数。尝试scanf("%f", &f)会直接返回0（失败），因为MicroLIB未链接浮点解析库。
// 安全用法（本项目验证过） int i; scanf("%d", &i); // OK unsigned short s; scanf("%hu", &s); // OK（%hu需MicroLIB 2.0+） char str[10]; scanf("%9s", str); // OK（%9s防溢出） // 危险用法（必然失败） float f; scanf("%f", &f); // 返回0，str无变化 long long ll; scanf("%lld", &ll); // 返回0提示：若真需浮点输入，建议放弃
scanf，改用getchar()手动解析ASCII数字，再调用atof()——但atof同样不在MicroLIB中，需自己实现简易版。
4.5 寄存器地址硬编码：为什么不用USART2_BASE宏？
你可能注意到代码里直接写USART2->SR，而不是((USART_TypeDef*)0x40004400)->SR。这是因为stm32f10x_map.h已定义：
#define USART2_BASE (APB1PERIPH_BASE + 0x4400) #define USART2 ((USART_TypeDef *) USART2_BASE)所以USART2->SR本质就是*((__IO uint16_t*)(0x40004400 + 0x00))。直接使用结构体指针，比硬编码地址更安全，且Keil能做类型检查——比如USART2->DR是__IO uint16_t，若误写成USART2->DR = 'A'，编译器会警告类型不匹配。
5. 二次开发实战：从“能用”到“好用”的四步改造
现在你已经能让神舟IV号在Putty里printf/scanf了，但这只是起点。真正的价值在于：如何基于这个基础，快速构建自己的调试协议、参数配置界面，甚至简易命令行。下面是我从某图像处理Demo项目中提炼出的四步改造法，每一步都经过量产验证。
5.1 第一步：增加命令行历史与方向键支持（Arrow Key）
原生scanf只能输一行，输错就得重来。加历史功能，能让开发效率翻倍。核心是拦截ESC [ A（上箭头）等ANSI转义序列：
// 在_read函数中扩展 if (c == 0x1B) { // ESC c = get_char_with_timeout(); // 再读一个 if (c == '[') { c = get_char_with_timeout(); if (c == 'A') { // 上箭头 // 从历史缓冲区取上一条命令 strcpy(ptr, history[history_idx]); return strlen(history[history_idx]); } } }技巧：历史缓冲区用静态数组
char history[10][64]，history_idx指向最新条目。每次scanf成功后，strcpy(history[history_idx], input_line)保存。
5.2 第二步：实现printf的非阻塞模式（带超时的xprintf）
原printf卡在while(!TXE)，若USART2硬件故障，整个系统就卡死。生产环境必须加超时：
// xprintf.h int xprintf(const char *format, ...) { va_list args; va_start(args, format); int len = vsnprintf(NULL, 0, format, args); // 先算长度 va_end(args); if (len <= 0) return 0; char *buf = malloc(len + 1); if (!buf) return -1; va_start(args, format); vsnprintf(buf, len + 1, format, args); va_end(args); int sent = _write_timeout(1, buf, len, 100); // 100ms超时 free(buf); return sent; }其中_write_timeout是增强版_write，内部用uwTick计时，超时则返回已发送字节数。
5.3 第三步：将scanf升级为结构化参数解析（JSON Lite）
与其用scanf("%d %d %s", &x, &y, mode)，不如定义轻量JSON协议：
// 输入：{"cmd":"set_pwm","ch":1,"val":255} // 解析后调用：pwm_set(1, 255);我用cJSON迷你版（仅2个文件）替换scanf，主循环改为：
char rx_buf[128]; int len = _read_timeout(0, rx_buf, sizeof(rx_buf)-1, 500); if (len > 0) { rx_buf[len] = '\0'; cJSON *root = cJSON_Parse(rx_buf); if (root) { const char *cmd = cJSON_GetObjectItem(root, "cmd")->valuestring; if (strcmp(cmd, "set_pwm") == 0) { int ch = cJSON_GetObjectItem(root, "ch")->valueint; int val = cJSON_GetObjectItem(root, "val")->valueint; pwm_set(ch, val); printf("{\"status\":\"ok\"}\r\n"); } cJSON_Delete(root); } }优势：前端（Python/JS）可直接发JSON，无需解析空格分隔；支持嵌套参数，扩展性强。
5.4 第四步：对接RTOS任务（FreeRTOS消息队列）
在FreeRTOS项目中，printf不能直接操作寄存器（会抢占中断）。解决方案：创建专用uart_task，用队列收发数据：
// 创建队列 QueueHandle_t uart_tx_queue = xQueueCreate(32, sizeof(char)); // 主任务中发数据 char c = 'A'; xQueueSend(uart_tx_queue, &c, portMAX_DELAY); // uart_task中消费 void uart_task(void *pvParameters) { char c; while(1) { if (xQueueReceive(uart_tx_queue, &c, portMAX_DELAY) == pdTRUE) { while (!(USART2->SR & USART_FLAG_TXE)); USART2->DR = c; } } }这样，printf重定向到队列发送，彻底解耦硬件与业务逻辑。
从那以后我每次做新板子，第一件事就是把usart2_init.c和syscalls.c拷过去，然后在main.c里加三行printf("Board ID: %s\r\n", BOARD_ID)——不是为了炫技，而是因为在没有JTAG的产线现场，能用串口打出一句“OK”，就是最可靠的回归测试。希望帮到你。
本文还有配套的精品资源，点击获取
