1. 拿到PY32F002B开发板后为什么第一步该调串口而不是点灯很多人拿到一块新的MCU开发板第一反应是写个GPIO翻转让LED闪起来觉得看到灯亮了就说明板子没问题。这个思路放在STM32或者ESP32上没毛病但放在PY32F002B这块板子上我建议你把顺序反过来——先把串口打通让printf能输出字符再去折腾别的外设。原因很直接PY32F002B是一颗ARM Cortex-M0内核的芯片封装小、引脚少、SRAM和Flash都非常有限。这类资源紧张的芯片一旦程序跑飞或者卡在某个初始化环节你靠点灯根本判断不出问题出在哪——灯不亮可能是GPIO配错了可能是时钟没使能也可能是芯片压根没跑起来。但串口不一样只要你能从串口收到一个字符就说明时钟配置对了、GPIO复用功能配对了、波特率算对了、中断或者轮询逻辑跑通了一次性验证了一整条链路。我自己的习惯是新板子到手先花二十分钟把串口调通后面所有调试都靠它输出信息。PY32F002B的串口配置和STM32F0系列非常接近但有几个坑是它独有的后面会详细说。1.1 PY32F002B这颗芯片的定位和资源边界先把这个芯片的基本盘说清楚不然后面配置的时候你不知道哪些东西能省、哪些不能省。PY32F002B是普冉半导体推出的一颗低功耗MCUARM Cortex-M0内核最高主频24MHz。Flash容量根据具体型号有16KB、20KB、24KB几个档位SRAM只有3KB。封装常见的有TSSOP20、QFN20这种超小体积的。外设方面它有两个USART、一个SPI、一个I2C、一个12位ADC、若干定时器基本上该有的都有但数量都很少。3KB的SRAM是什么概念你如果开一个256字节的串口接收缓冲区再开一个256字节的发送缓冲区就已经用掉六分之一了。所以在这颗芯片上做串口调试核心思路就是能省则省不要搞复杂的环形缓冲区不要开大的printf缓冲区能用轮询就不用中断。注意PY32F002B的参考手册和例程包在官方渠道可以获取但网上流传的很多例程是针对PY32F003或者PY32F030的寄存器地址和外设数量有差异直接拿来用会出问题。一定要确认你手上的例程对应的是F002B这个具体型号。1.2 串口调试在这类小板子上的真实价值有人会问都什么年代了还用串口调试JTAG/SWD在线调试不香吗香但要看场景。PY32F002B这种板子通常用在成本敏感的产品里实际部署的时候你可能只有一个SWD接口甚至为了省引脚连SWD都复用掉了。而且很多实际问题是运行时才出现的——比如某个中断偶发触发、某个状态机在特定时序下卡死你在调试器里单步走很难复现。这时候串口打印就是最可靠的观测手段。另外printf输出这个东西一旦调通了后面写代码的效率会高一个档次。你可以直接在代码里插printf(adc value %d\r\n, adc_val);不用打断点、不用看变量窗口信息直接刷到串口助手上。对于PY32F002B这种资源紧张的芯片把printf定向到串口比定向到SWO或者半主机模式要实际得多。2. 从零搭建PY32F002B的串口工程时钟、引脚、波特率三件事这一章是整篇的核心操作部分。我会按照实际配置的顺序来讲先确认时钟树再配GPIO复用再算波特率最后把printf重定向接上。每一步都会说清楚为什么这么做以及PY32F002B和STM32在这方面的差异。2.1 时钟配置PY32F002B的HSI和PLL该怎么选PY32F002B内部有一个HSI振荡器默认频率是8MHz可以通过PLL倍频到最高24MHz。也可以用外部晶振HSE但很多小封装型号没有外部晶振引脚所以大多数情况下我们用HSIPLL。串口波特率的精度直接取决于系统时钟的精度。HSI的精度一般在±1%到±2%之间对于波特率9600、115200这些常见值来说这个精度是够用的。但如果你要用更高的波特率比如921600HSI的偏差就可能导致误码。所以我的建议是调试阶段用HSI跑24MHz系统时钟波特率用115200这个组合最稳。配置时钟的代码大概长这样基于常见的HAL库风格// 使能HSI RCC-CR | RCC_CR_HSION; while(!(RCC-CR RCC_CR_HSIRDY)); // 配置PLLHSI/2 * 6 24MHz RCC-CFGR ~RCC_CFGR_PLLSRC; RCC-CFGR | RCC_CFGR_PLLMUL6; RCC-CR | RCC_CR_PLLON; while(!(RCC-CR RCC_CR_PLLRDY)); // 切换系统时钟到PLL RCC-CFGR ~RCC_CFGR_SW; RCC-CFGR | RCC_CFGR_SW_PLL; while((RCC-CFGR RCC_CFGR_SWS) ! RCC_CFGR_SWS_PLL);这里有个细节PY32F002B的PLL配置寄存器和STM32F0不完全一样倍频系数的编码方式有差异。如果你直接抄STM32F0的代码PLL可能不锁或者频率不对。一定要对着PY32F002B的参考手册确认PLLMUL字段的编码。2.2 GPIO复用TX和RX引脚到底接在哪两个脚上PY32F002B的USART1默认引脚是PA9TX和PA10RX但这两个脚在很多小封装型号上可能没有引出来。所以实际用的时候通常要把USART1重映射到PA2TX和PA3RX或者用USART2的PA14TX和PA13RX。具体用哪组引脚取决于你的开发板把哪两个脚引到了排针上。我手上这块板子是把PA2和PA3引出来了所以用USART1的重映射功能。配置GPIO的步骤// 使能GPIOA时钟 RCC-IOPENR | RCC_IOPENR_GPIOAEN; // PA2配置为复用推挽输出高速 GPIOA-MODER ~GPIO_MODER_MODE2; GPIOA-MODER | GPIO_MODER_MODE2_1; // 复用模式 GPIOA-OTYPER ~GPIO_OTYPER_OT_2; // 推挽 GPIOA-OSPEEDR | GPIO_OSPEEDER_OSPEED2; // 高速 GPIOA-AFR[0] | (1 8); // AF1 USART1 // PA3配置为复用输入 GPIOA-MODER ~GPIO_MODER_MODE3; GPIOA-MODER | GPIO_MODER_MODE3_1; GPIOA-PUPDR | GPIO_PUPDR_PUPD3_0; // 上拉 GPIOA-AFR[0] | (1 12); // AF1 USART1提示RX引脚一定要配上拉否则串口空闲时可能收到乱码。TX引脚不需要上拉配推挽输出就行。这个细节很多例程里没写但实际用的时候如果RX悬空串口助手会一直收到0x00或者0xFF。2.3 波特率计算为什么你的115200可能变成114000波特率的计算公式是USARTDIV fCK / (16 * baudrate)。以24MHz系统时钟、115200波特率为例USARTDIV 24000000 / (16 * 115200) 13.0208。整数部分是13小数部分是0.0208。小数部分乘以16得到0.333四舍五入为0。所以BRR寄存器的值应该是(13 4) | 0 0xD0。但如果你直接用这个值实际波特率是24000000 / (16 * 13) 115384误差0.16%这个误差在可接受范围内。但如果你的系统时钟不是精确的24MHz比如HSI实际跑在23.8MHz那误差就会累积。我实测下来PY32F002B用HSI跑24MHz、波特率115200的时候串口助手收到的数据基本没有误码。但如果你把波特率提到230400以上就建议用外部晶振了。系统时钟目标波特率BRR值实际波特率误差24MHz96000x9C4096000%24MHz192000x4E20192000%24MHz1152000x00D01153840.16%24MHz2304000x00682307690.16%8MHz1152000x00451111113.5%从表里能看出来8MHz时钟下跑115200的误差已经到了3.5%这个就偏大了串口助手可能会收到乱码。所以系统时钟尽量往高了配。2.4 printf重定向fputc和fgetc到底怎么写printf重定向的本质是把C库标准输出流定向到串口。在ARM GCC环境下需要重写_write或者fputc函数。在Keil MDK环境下需要重写fputc。在IAR环境下需要重写__write。我用的是Keil MDK ARMCC所以重写fputc#include stdio.h int fputc(int ch, FILE *f) { // 等待发送数据寄存器空 while(!(USART1-ISR USART_ISR_TXE)); // 写入数据 USART1-TDR (uint8_t)ch; // 等待发送完成 while(!(USART1-ISR USART_ISR_TC)); return ch; }如果你用的是GCC代码要改成int _write(int file, char *ptr, int len) { for(int i 0; i len; i) { while(!(USART1-ISR USART_ISR_TXE)); USART1-TDR ptr[i]; while(!(USART1-ISR USART_ISR_TC)); } return len; }注意重定向之后一定要在工程设置里勾选Use MicroLIBKeil或者链接时加上-specsnosys.specsGCC否则printf可能不工作或者卡死。这个坑我踩过好几次代码没问题就是printf没输出最后发现是没开MicroLIB。3. 串口调通了但printf输出乱码排查链路和根因分析串口调试最让人抓狂的不是完全没输出而是有输出但全是乱码。这一章我把常见的乱码原因按排查顺序列出来你照着一步步查基本能定位到问题。3.1 第一层排查波特率、数据位、停止位是否匹配串口助手和MCU两边的配置必须完全一致波特率、数据位通常8位、停止位通常1位、校验位通常无。任何一项不一致都会导致乱码。我遇到过的情况是代码里配的是115200串口助手默认打开是9600结果收到一堆乱码。这种问题最蠢但也最常见。所以第一步永远是确认两边配置一致。PY32F002B的USART配置代码USART1-CR1 ~USART_CR1_UE; // 先关闭USART USART1-CR1 ~USART_CR1_M; // 8位数据 USART1-CR2 ~USART_CR2_STOP; // 1位停止位 USART1-CR1 ~USART_CR1_PCE; // 无校验 USART1-BRR 0x00D0; // 115200 24MHz USART1-CR1 | USART_CR1_TE | USART_CR1_RE; // 使能收发 USART1-CR1 | USART_CR1_UE; // 使能USART3.2 第二层排查系统时钟是否真的跑到了预期频率如果两边配置一致但还是乱码就要怀疑系统时钟了。你以为跑的是24MHz实际可能是8MHz或者别的频率。验证方法很简单用示波器或者逻辑分析仪量一下TX引脚上的波形测一个位的宽度。115200波特率下一个位的宽度是1/115200 ≈ 8.68微秒。如果量出来是26微秒左右那说明实际波特率是38400系统时钟可能只有8MHz。没有示波器怎么办可以写一个GPIO翻转的测试代码翻转频率设成1kHz然后用示波器量。或者更简单把波特率降到9600如果9600能正常输出115200不行那基本就是时钟频率不对。3.3 第三层排查printf的中文乱码和格式符问题中文乱码是另一个高频问题。根本原因是编码格式不匹配你的代码文件可能是UTF-8编码但串口助手按GBK解码或者反过来。解决方法有两个一是把串口助手的编码设成UTF-8二是把代码文件转成GBK编码。我一般用后者因为很多串口助手默认是GBK。另外printf的格式符也要注意。在ARMCC下%f默认是不支持的需要开启浮点打印支持。%d对应int%ld对应long%u对应unsigned int。如果你用错了格式符输出的数值会完全不对。// 正确的用法 int adc_val 1234; printf(ADC: %d\r\n, adc_val); // 错误的用法用%f打印int printf(ADC: %f\r\n, adc_val); // 输出会是0.000000或者乱码3.4 一个容易被忽略的坑发送完成标志和TXE的区别在fputc函数里我用的是先等TXE发送数据寄存器空写入TDR再等TC发送完成。这两个标志的区别是TXE表示数据已经从TDR搬到了移位寄存器可以写入下一个字节了TC表示移位寄存器也发完了整个帧发送完毕。如果你只等TXE不等TC在连续发送大量数据的时候没问题但在发送最后一个字节后立刻进入低功耗模式或者关闭USART最后一个字节可能没发完就被截断了。所以稳妥的做法是等TC。但等TC也有代价每次printf都要多等一个帧的时间。对于115200波特率一个字节大概87微秒等TC会多花几十微秒。如果你对性能敏感可以只在关键位置等TC平时只等TXE。4. 进阶实战用环形缓冲区让串口收发不再阻塞主循环前面讲的printf重定向是阻塞式的每调用一次printfCPU就停在fputc里等发送完成。对于调试输出这没问题。但如果你要在主循环里频繁打印或者要在中断里打印阻塞式就会影响实时性。这一章讲怎么用环形缓冲区把串口收发做成非阻塞的。这个方案在PY32F002B这种资源紧张的芯片上要特别小心内存占用我会给出一个精简版的实现。4.1 环形缓冲区的最小实现64字节够不够3KB的SRAM我建议发送缓冲区给64字节接收缓冲区给64字节一共128字节占SRAM的4%左右。这个大小对于调试输出足够了。环形缓冲区的核心结构typedef struct { uint8_t buffer[64]; volatile uint16_t head; volatile uint16_t tail; } ring_buffer_t; ring_buffer_t tx_buf; ring_buffer_t rx_buf;写入和读取的函数uint8_t rb_write(ring_buffer_t *rb, uint8_t data) { uint16_t next (rb-head 1) % 64; if(next rb-tail) return 0; // 缓冲区满 rb-buffer[rb-head] data; rb-head next; return 1; } uint8_t rb_read(ring_buffer_t *rb, uint8_t *data) { if(rb-head rb-tail) return 0; // 缓冲区空 *data rb-buffer[rb-tail]; rb-tail (rb-tail 1) % 64; return 1; }提示head和tail要用volatile修饰因为它们会在中断和主循环里同时被访问。另外取模运算% 64在Cortex-M0上没有硬件除法会比较慢。可以把缓冲区大小设成2的幂然后用 63代替% 64速度快很多。4.2 发送中断的使能时机TXE中断不是随便开的非阻塞发送的逻辑是printf把数据写入tx_buf然后使能TXE中断。在TXE中断服务函数里从tx_buf读一个字节写入TDR。当tx_buf空了关闭TXE中断。关键点是TXE中断的使能时机。如果你在写入第一个字节之前就使能了TXE中断中断会立刻触发但此时tx_buf里可能还没有数据导致读取出错。正确的做法是先写入数据再使能TXE中断。void uart_send_byte(uint8_t data) { while(!rb_write(tx_buf, data)); // 等待缓冲区有空位 USART1-CR1 | USART_CR1_TXEIE; // 使能TXE中断 } void USART1_IRQHandler(void) { if(USART1-ISR USART_ISR_TXE) { uint8_t data; if(rb_read(tx_buf, data)) { USART1-TDR data; } else { USART1-CR1 ~USART_CR1_TXEIE; // 缓冲区空关闭中断 } } }4.3 接收中断和空闲中断的配合使用接收这边我建议用RXNE中断加IDLE中断的组合。RXNE中断在每收到一个字节时触发把数据存入rx_buf。IDLE中断在总线空闲时触发表示一帧数据接收完毕。void USART1_IRQHandler(void) { // 发送处理 if(USART1-ISR USART_ISR_TXE) { // ... 同上 } // 接收处理 if(USART1-ISR USART_ISR_RXNE) { uint8_t data USART1-RDR; rb_write(rx_buf, data); } // 空闲中断 if(USART1-ISR USART_ISR_IDLE) { USART1-ICR | USART_ICR_IDLECF; // 清除空闲标志 // 这里可以设置一个标志位告诉主循环一帧数据收完了 rx_frame_ready 1; } }IDLE中断的好处是你不需要知道对方发了多少个字节只要总线空闲下来就说明一帧结束了。这对于接收不定长数据特别方便。5. 那些年我在PY32F002B串口上踩过的坑这一章不讲理论只讲实际踩过的坑。每个坑都是真实遇到过的有些坑花了我大半天才定位到。5.1 坑一使能USART之前必须先使能GPIO时钟这个坑说起来很蠢但确实容易犯。PY32F002B的外设时钟是分开使能的GPIOA、USART1各有各的时钟使能位。如果你先使能USART1再使能GPIOAUSART1的引脚复用可能不生效。正确的顺序是先使能GPIO时钟配置GPIO复用再使能USART时钟配置USART。RCC-IOPENR | RCC_IOPENR_GPIOAEN; // 先GPIO // ... 配置GPIO复用 RCC-APBENR1 | RCC_APBENR1_USART1EN; // 再USART // ... 配置USART5.2 坑二TX引脚配置成复用输出后还要设置AFR寄存器PY32F002B的GPIO复用功能是通过AFR寄存器选择的。PA2和PA3的USART1功能对应的是AF1。如果你只配了MODER为复用模式没配AFR引脚不会有任何输出。这个坑的隐蔽之处在于代码编译没问题运行也不报错就是串口没输出。我第一次遇到的时候查了半天时钟和波特率最后才发现是AFR没配。5.3 坑三printf的缓冲区溢出导致程序卡死标准库的printf默认会使用一个缓冲区。在PY32F002B这种小内存芯片上如果printf的格式化字符串很长或者你连续调用printf缓冲区可能溢出导致程序卡死或者输出错乱。解决方法把printf的缓冲区设小一点或者用setvbuf把缓冲区设成无缓冲。setvbuf(stdout, NULL, _IONBF, 0); // 无缓冲无缓冲的代价是每次printf都会直接调用fputc效率低一点但在调试阶段完全够用。5.4 坑四串口助手的DTR/RTS信号导致芯片复位有些串口助手在打开串口的时候会拉低DTR或者RTS信号。如果你的开发板把这两个信号接到了MCU的复位引脚或者BOOT引脚上打开串口助手就会导致芯片复位或者进入Bootloader模式。这个坑的表现是程序烧进去之后运行正常一打开串口助手芯片就重启。解决方法是在串口助手里把DTR和RTS关掉或者硬件上不接这两个信号。5.5 坑五中断优先级配置不当导致串口数据丢失PY32F002B的Cortex-M0内核只有4级中断优先级。如果你把串口中断的优先级设得比较低而系统里有其他高优先级中断频繁触发串口中断可能被延迟响应导致RXNE标志溢出数据丢失。我的建议是串口中断优先级设成最高的0级或者1级确保数据能及时取走。特别是用RXNE中断接收的时候如果中断响应不及时下一个字节来了就会覆盖上一个字节。6. 串口调试之外PY32F002B还能怎么玩串口调通之后这颗芯片还有很多可以折腾的地方。这一章简单聊聊后续可以扩展的方向给已经跑通串口的读者一些思路。6.1 用串口做命令行交互printf输出只是单向的。如果你把接收也做好就可以在串口助手里输入命令MCU解析命令并执行。比如输入led on点亮LED输入adc读取ADC值。这个功能的实现思路是在IDLE中断里设置帧接收完成标志主循环检测到标志后解析rx_buf里的数据根据命令内容执行对应操作。命令解析可以用简单的字符串比较不需要复杂的解析库。if(strcmp((char*)rx_buf.buffer, led on) 0) { GPIOA-BSRR GPIO_BSRR_BS_5; // 点亮PA5 printf(LED ON\r\n); }6.2 串口ADC做一个简易的数据采集器PY32F002B有一个12位ADC配合串口可以做一个简易的数据采集器。ADC采样之后把数值通过串口打印出来在串口助手里就能看到实时数据。ADC的配置这里不展开核心是使能ADC时钟配置采样通道启动转换读取结果printf输出。注意ADC的参考电压通常是VDDA如果VDDA不稳定采样值会跳动。6.3 串口定时器输出PWM占空比实时监控如果你在用PY32F002B做电机控制或者LED调光可以用串口实时输出PWM的占空比。这样在调参的时候不用反复烧录程序直接看串口输出就能知道当前参数。实现方式是在定时器中断里更新PWM占空比同时把占空比数值存入一个全局变量。主循环里每隔一段时间printf一次这个变量。6.4 关于低功耗模式下串口的注意事项PY32F002B支持低功耗模式但在低功耗模式下串口是停止工作的。如果你需要在低功耗模式下保持串口唤醒功能要配置USART的唤醒中断并且注意在进入低功耗之前把串口配置成能唤醒的模式。这个部分比较复杂涉及到的寄存器操作也多。我的建议是调试阶段先不要碰低功耗等串口和主要功能都稳定了再考虑低功耗优化。7. 完整代码框架和工程配置要点最后把完整的代码框架整理一下方便你直接参考。代码基于Keil MDK ARMCC环境使用HAL库风格但直接操作寄存器。7.1 工程文件结构和编译选项工程目录建议这样组织PY32F002B_UART_Demo/ ├── CMSIS/ │ ├── core_cm0plus.h │ └── py32f002b.h ├── User/ │ ├── main.c │ ├── uart.c │ ├── uart.h │ └── retarget.c └── Project/ └── PY32F002B.uvprojx编译选项里要加上-DUSE_MICROLIBKeil下勾选Use MicroLIB优化等级建议用-O0或者-O1调试阶段不要开高优化否则断点和变量观察会不准7.2 main函数里的初始化和主循环#include py32f002b.h #include uart.h #include stdio.h int main(void) { // 时钟配置HSI PLL 24MHz SystemClock_Config(); // 串口初始化 UART_Init(115200); // 重定向printf setvbuf(stdout, NULL, _IONBF, 0); printf(PY32F002B UART Demo Start\r\n); printf(System Clock: %d Hz\r\n, SystemCoreClock); uint32_t counter 0; while(1) { printf(Counter: %d\r\n, counter); for(volatile int i 0; i 1000000; i); // 简单延时 } }7.3 烧录和验证步骤烧录工具用PY32官方的烧录器或者通用的SWD工具都行。烧录之后打开串口助手选择对应的COM口波特率1152008位数据1位停止无校验。如果一切正常你应该能看到PY32F002B UART Demo Start和递增的Counter值。如果没输出按这个顺序查串口助手的COM口选对了吗波特率、数据位、停止位、校验位匹配吗开发板的TX引脚接到USB转串口模块的RX引脚了吗TX接RXRX接TX别接反了开发板和USB转串口模块共地了吗系统时钟配置对吗GPIO复用和AFR配置对吗这六步查完基本能解决90%的串口无输出问题。7.4 一个实用的调试技巧用GPIO翻转辅助定位如果你实在找不到问题可以在fputc函数里加一句GPIO翻转然后用示波器或者逻辑分析仪看这个GPIO有没有波形。如果有波形但串口没输出说明问题在串口配置或者硬件连接上如果没波形说明printf根本没被调用到问题在代码逻辑上。int fputc(int ch, FILE *f) { GPIOA-BSRR GPIO_BSRR_BS_5; // PA5置高 while(!(USART1-ISR USART_ISR_TXE)); USART1-TDR (uint8_t)ch; while(!(USART1-ISR USART_ISR_TC)); GPIOA-BSRR GPIO_BSRR_BR_5; // PA5置低 return ch; }这个技巧我用了很多年特别是在没有调试器或者调试器连不上的时候一个GPIO加一个示波器就能定位大部分问题。串口调试这件事说难不难说简单也不简单。PY32F002B这颗芯片的串口配置和STM32F0系列很像但细节上的差异不少。把上面这些坑都避开基本上一两个小时就能把printf跑通。跑通之后后面所有的调试都会轻松很多。