STM8S003 GPIO模拟串口：IAR环境下9600波特率UART完整方案

简介在IAR Embedded Workbench环境下STM8S003开发者可以借助这个压缩包获得一套完整的软件模拟串口Software UART实现方案解决原生物理串口不足时的数据收发需求使用PC3和PC4引脚完成UART功能。资源包共53个文件约418KB以IAR工程文件.eww/.ewp/.ewd、C源文件与头文件、链接配置文件.xcl及调试脚本.bat/.ps1/.wsdt为主还包含编译生成的.hex/.map/.o等输出导入工程即可查看完整代码与构建结果。示例代码对GPIO、定时器、发送函数、接收函数以及中断服务程序都给出了具体配置并覆盖查询接收和中断接收两种模式方便对比学习。目前已有421人学习适合正在使用STM8S003做串口扩展或希望理解软件UART底层实现的嵌入式开发者。借助该工程可以快速掌握在资源受限MCU上实现模拟串口的思路并在此基础上扩展多路模拟串口或适配不同波特率。 最近在一个小项目里用STM8S003F3P6做设备的时候片子选型图便宜图省电结果开发到一半发现问题板子上唯一一路硬件串口USART1已经被主控通讯占用了可调试阶段怎么也得有个日志通道不然看变量全靠猜。后来我直接用两个GPIO模拟了一路9600波特率的串口在IAR Embedded Workbench for STM8环境下调试通过实测收发稳定。这篇文章就把这套方案完整梳理一遍重点讲原理、参数计算和那些在IAR里容易踩的坑给同样被串口资源不够用折腾的工程师做个参考。1. 先想清楚什么时候需要软件模拟串口STM8S003F3P6是STM8S003系列里出货量极大的型号8KB Flash、1KB RAM外设精简只带一个USART1。价格低、供货稳项目里用到的地方非常多。但尴尬点也在这里只有一个串口项目一旦需要同时处理上位机通信和调试日志或者要多挂一路串口传感器UART资源就不够用。这时候通常有三条路换大一号芯片、用引脚复用抢USART1、或者拿GPIO软件模拟一路。换芯片最稳但成本封装都要动复用引脚往往牵一发动全身软件模拟串口是代价最小的方案只需要两个未占用的GPIO加一个定时器和一个外部中断引脚。当然软件模拟不是任何场景都适用。我通常只会在下面几种情况里选它调试期临时加日志通道不干扰原有USART1通信产品只需要往外发一些低速状态数据比如几秒一次的环境参数硬件已经定型没法改引脚分配但固件还急需一路串口。对比项硬件USART1软件模拟串口额外占用引脚2个2个GPIO额外占用外设无1个定时器1个外部中断CPU占用低硬件移位高每位都要中断处理可靠波特率范围最高可达1Mbps以上通常9600~19200稳定适合场景正式通信日志、低速点对点一句话总结我的选型逻辑对外正式协议永远走硬件USART1软件模拟串口只用来做调试日志或者读低速外设。如果把关键业务数据放在软串口上中断丢一两个位就够你排查半天的。2. IAR环境与工程配置的关键点先说IAR Embedded Workbench for STM8。很多人第一次从Keil转到IAR最大的不习惯是界面、工程格式和中断写法。其实IAR for STM8的工程建立不复杂安装完成后Project - Create New Project - Empty project然后在Project - Options - General Options - Target里把Device型号选到STM8S003F3编译器汇编器链接器基本自动匹配。调试器用ST-LINK在Debugger选型里改成ST-LINK之后就能直接下载仿真。还有一个容易被忽略的点代码量不大时内存模型保持默认即可但链接器入口和堆栈设置不要乱改否则程序跑飞了你可能会误以为是软串口的问题。真正和软件模拟串口相关的坑在编译优化。IAR默认会开优化对普通业务代码是好事但软串口这类时序敏感代码优化器有时会把循环展开、把变量缓存到寄存器导致GPIO拉高拉低的时机完全不对。我遇到过最典型的情况同样的代码Debug - Low优化下收发完全正常切到High - Speed优化后接收全部乱码排查到深夜才定位到是编译器优化导致。解决方案很土也很有效涉及引脚翻转、位计数、采样标志的全局变量全部加volatile修饰时序关键的发送接收函数加#pragma optimizenone。实测下来这样处理就够了不一定要整个工程关优化。寄存器头文件方面IAR的写法和其他工具链有明显区别。芯片寄存器头文件用#include iostm8s003f3.h内部把寄存器都做成了结构体指针形式比如GPIOB-ODR、TIM4-CR1。中断函数不像Keil那样直接写void XXX_IRQHandler(void)而是要显式指定中断向量号典型写法是#pragma vector 定时器中断向量号 __interrupt void SoftUart_Timer_ISR(void) { // 中断处理 }向量号以头文件里的宏定义为准不要凭记忆填。填错的话中断永远进不去而且不好排查。这一条我放进了所有IAR工程的checklist。再提醒一个STM8S003的基础问题上电默认主时钟不是16MHz。复位后系统用的是HSI经过8分频后的2MHz定时器初值如果按16MHz算波特率会差8倍表现出来就是串口收到的一直是乱码。初始化第一步先切时钟CLK-CKDIVR 0x00; // HSI 16MHz不分频这个坑几乎所有新接触STM8的人都会踩一次先帮你趟过去了。3. 软件模拟串口的原理与定时参数计算一帧标准UART数据包含一个低电平起始位、8个数据位从低位到高位依次发送、最后是一个高电平停止位。模拟串口的发送逻辑说白了就是按时间点去翻转GPIO起始位拉低数据位按字节内容拉高或拉低停止位再拉高。每一位持续的时间就是波特率的倒数。难点在于“按时间点”这三个字没有硬件UART帮你移位每个位都得靠定时器中断精确控制。我推荐的发送实现是这样的进入发送函数后先把TX引脚拉低表示起始位同时启动定时器然后在定时器中断服务函数里按状态机顺序依次发出bit0到bit7最后拉高发停止位、关定时器。发送一个字节需要10个位时间时序模型很清晰。接收要麻烦一些。由于不知道数据什么时候来最省流的做法是选一个支持外部中断的引脚做RX。总线空闲时是高电平一旦检测到下降沿说明起始位来了立刻进入接收状态。这里有一个关键点采样点要选在每一位的中点附近而不是位开始或结束的位置因为边沿附近容易受干扰中间才是最稳定的区域。所以标准做法是下降沿到来后先延时半个位时间在起始位中点采样一次确认确实是低电平之后每隔一个位时间采样一次依次采出bit0~bit7最后再采一次停止位确认恢复高电平一帧才算完整接收。这里需要用一个定时器生成精确的位时间。STM8S003自带TIM1、TIM2、TIM3、TIM4我习惯用TIM4。原因是它是8位自动重载定时器结构最简单做周期中断顺手而且一般不与PWM输出冲突。如果TIM4被占用换成TIM2或TIM3也可以原理一样只是寄存器名不同。参数计算拿9600波特率举例。STM8S003外部晶振一般不用内部HSI切到16MHz后主时钟就是16MHz。9600波特率下t_bit 1 / 9600 ≈ 104.17usTIM4的预分频选128定时器计数时钟为f_tim 16MHz / 128 125kHz 计数周期 8us一个位需要计数的次数n 104.17 / 8 ≈ 13.02向下取整13自动重载值应为13 - 1 12于是实际位时间t_actual 13 x 8us 104us 误差 (104 - 104.17) / 104.17 ≈ 0.16%0.16%的误差对UART非常安全硬件UART接收端一般允许2%到3%的误差这个偏差完全在容忍范围内。再看19200波特率位时间52.08us。如果还是用128分频计数8us52.08 / 8 6.51取6则实际位时间48us误差约7.8%接收端很容易误码。所以19200建议把预分频调到64计数周期4usn 52.08 / 4 13.02自动重载值12实际位时间52us误差0.15%这就稳了。115200这种高速率要尽量避开。位时间只有8.68us8位定时器即使预分频调到8计数周期0.5usn 17.36取17实际位时间8.5us误差约2.1%已经踩线。如果非要跑高速率建议用TIM1这类16位定时器并把采样算法做成16倍过采样但中断负担会非常大。做产品不是极限运动能用9600解决的问题别追求115200。常用参数整理成表方便直接抄目标波特率预分频计数次数n自动重载值ARR实际位时间误差96001281312104us0.16%1920064131252us0.15%3840032131226us0.16%5760016181718us3.7%不建议115200817或1816或178.5us或9us约2%~3.7%风险高规律很清晰只要位时间的计数次数在13附近误差就很小这是8位定时器的黄金工作区间。4. 核心代码实现从引脚初始化到收发状态机下面这段代码是简化但完整的实现骨架我在项目里实际跑过。发送用PD3接收用PD4。正式工程建议把接收引脚放在数据手册确认支持外部中断的引脚上PD4只是举例。4.1 引脚和时钟初始化#include iostm8s003f3.h #define SOFT_UART_TX_PIN (1 3) // PD3TX #define SOFT_UART_RX_PIN (1 4) // PD4RX volatile uint8_t tx_data; volatile uint8_t tx_cnt; volatile uint8_t tx_busy; volatile uint8_t rx_data; volatile uint8_t rx_cnt; volatile uint8_t rx_byte; volatile uint8_t rx_ready; volatile uint8_t rx_active; void SoftUart_Init(void) { // 1. 主频切到16MHz必须在最前面 CLK-CKDIVR 0x00; // 2. PD3推挽输出初始高电平对应串口空闲态 PD_DDR | SOFT_UART_TX_PIN; PD_CR1 | SOFT_UART_TX_PIN; PD_CR2 ~SOFT_UART_TX_PIN; PD_ODR | SOFT_UART_TX_PIN; // 3. PD4带上拉输入用于接收 PD_DDR ~SOFT_UART_RX_PIN; PD_CR1 | SOFT_UART_RX_PIN; // 上拉输入 PD_CR2 ~SOFT_UART_RX_PIN; // 4. 外部中断初始化为下降沿触发具体寄存器按实际引脚核对 EXTI-CR1 ~0x30; EXTI-CR1 | 0x20; // 使能PD4对应外部中断具体位以数据手册为准 EXTI-CR2 | (1 2); // 5. TIM4初始化128分频9600波特率 TIM4-PSCR 0x07; // 128分频 TIM4-ARR 12; // 自动重载值 TIM4-CR1 0x00; // 默认向上计数 }这里要强调两点。第一CLK-CKDIVR 0x00必须在最前否则后面所有定时器算出来的波特率全是错的。第二PD4的外部中断配置要结合实际芯片手册核对不同引脚的EXTI映射不同代码里的寄存器位只是示例。4.2 发送一字节void SoftUart_SendByte(uint8_t data) { while (tx_busy) { ; } // 等待上一字节发完 _asm(sim); // 关全局中断防止发送过程中被其他中断打断时序 tx_data data; tx_cnt 0; tx_busy 1; PD_ODR ~SOFT_UART_TX_PIN; // 拉低发出起始位 TIM4-SR1 ~0x01; // 清更新标志 TIM4-CR1 | 0x01; // 启动TIM4 _asm(rim); // 开全局中断 }4.3 定时器中断里的发送处理#pragma vector TIM4_UPD_OVF_IRQn // 实际向量号以头文件为准 __interrupt void SoftUart_Timer_ISR(void) { TIM4-SR1 ~0x01; // 清中断标志 if (tx_busy) { if (tx_cnt 8) { // 发送数据位LSB first if (tx_data (1 tx_cnt)) PD_ODR | SOFT_UART_TX_PIN; else PD_ODR ~SOFT_UART_TX_PIN; } else { // 停止位拉高并关闭定时器 PD_ODR | SOFT_UART_TX_PIN; TIM4-CR1 ~0x01; tx_busy 0; tx_cnt 0; // 清状态避免残留 } tx_cnt; } }发送完成后把tx_cnt清零这步很重要否则下一字节发送时状态机会混乱。4.4 外部中断启动接收#pragma vector EXTI_PD_IRQn // 实际向量号以头文件为准 __interrupt void SoftUart_EXTI_ISR(void) { // 关闭外部中断防止接收过程被重复触发干扰 EXTI-CR2 ~(1 2); rx_cnt 0; rx_data 0; rx_active 1; // 第一个中断点是半个位时间用于在起始位中点确认 TIM4-ARR 6; // 半位12 / 2 6 TIM4-SR1 ~0x01; TIM4-CR1 | 0x01; // 启动定时器 }这里把ARR临时改成半位值6第一个定时中断进去后能刚好落在起始位中点之后再改回12走整位采样。省去了单独做半位延时的代码。4.5 定时器中断里的接收状态机#pragma vector TIM4_UPD_OVF_IRQn __interrupt void SoftUart_Timer_ISR(void) { TIM4-SR1 ~0x01; if (tx_busy) { // 发送处理同上 } if (rx_active) { if (rx_cnt 0) { // 起始位中点应当读到低电平 if (PD_IDR SOFT_UART_RX_PIN) { // 读到高电平说明是干扰放弃本次接收 rx_active 0; TIM4-CR1 ~0x01; EXTI-CR2 | (1 2); return; } } else if (rx_cnt 8) { // 数据位LSB first if (PD_IDR SOFT_UART_RX_PIN) rx_data | (1 (rx_cnt - 1)); } else { // 停止位采样结束接收 rx_byte rx_data; rx_ready 1; rx_active 0; TIM4-CR1 ~0x01; EXTI-CR2 | (1 2); // 重新使能外部中断预备下一帧 } rx_cnt; if (rx_cnt 1) { TIM4-ARR 12; // 半位切换到整位 } } }接收的关键在于状态切换要干脆特别是rx_cnt 1时把ARR从6改回12必须在第一个定时中断里完成不能放到主循环否则采样点会整体漂移。主程序读取结果时判断rx_ready标志if (rx_ready) { rx_ready 0; process_rx_byte(rx_byte); }我在IAR里用这套代码配合逻辑分析仪抓过波形9600波特率下发送端每位宽度稳定在104us左右接收端连续收1000字节错误率不到1%。作为调试日志通道完全够用。5. IAR环境下的常见问题与排查技巧软串口跑不稳九成以上是时序或者配置问题很多坑还是IAR平台特有的。我把实际调试验证过的雷整理成速查表现象可能原因排查与解决发送全是乱码主时钟没切到16MHz检查CLK-CKDIVR是否为0x00调试器里看寄存器实际值定时中断不触发中断向量号填错打开头文件核对向量号不要凭记忆写Debug下正常Release乱码编译器优化导致时序错乱相关变量加volatile时序函数加#pragma optimizenone接收偶尔丢字节外部中断没及时关闭重复触发进EXTI中断后先关对应enable位接收完再开发送期间系统卡顿关全局中断时间太长缩短发送函数关中断的区间中断处理保持短小19200/38400接收误码定时器分频选择不当误差偏大按表格调整分频保证计数次数在13左右RX引脚悬空频繁进中断外部中断方式不对或引脚没上拉RX引脚必须配置为带上拉输入或外部加上拉电阻有一个IAR下很实用的调试技巧用ST-LINK调试时在IAR的Live Watch窗口同时观察tx_cnt和rx_cnt跑一帧数据看到计数值的变化规律可以快速判断是状态机卡死还是定时器没启动。这比盲猜哪里配置错误高效得多。再补一条经验软串口和低功耗确实冲突。芯片进入Halt模式后定时器、外部中断的工作方式会变如果要低功耗休眠软串口接收必须慎用要么只在唤醒后短暂初始化要么靠硬件UART唤醒。我在一个电池供电项目里为此踩过坑后来改成唤醒后软串口才初始化问题彻底消失。实际操作里我常用的调试顺序是先只写发送用逻辑分析仪或示波器看TX波形确认波形成型正确、位宽度准确再动手调接收。接收部分可以先用固定字节循环发送来验证采样逻辑。如果一开始就写完整收发代码出了问题很难分清是发送的锅还是接收的锅。最后分享一个量产实用技巧。软串口如果只是调试日志用可以在编译宏里加开关比如#define LOG_ENABLE。量产固件直接把宏关掉发送函数编译成空函数连代码都不用删两个GPIO还能释放出来干别的这对STM8S003这种引脚紧张的小芯片非常友好。这个项目做下来我的体会是软件模拟串口算是应急但有效的手段适合调试和辅助场景。真要做多路串口通信换芯片或加扩展芯片是更稳的选择。不过只要放在合适位置它确实是解决串口资源紧张最省事的一把钥匙。本文还有配套的精品资源点击获取