从STM32F103迁移到AT32F403A：国产替代的固件移植与性能升级实践

1. 换芯前夜F103用得好好的为什么非要折腾手头这个项目最早是STM32F103C8T6起家的标准库、串口DMA、SPI读传感器、定时器PWM跑了大几年都挺稳。真正让我动换芯片心思的不是功能不够而是两件事一是芯片供应链的不确定性F103的价格和交期在那两年被市场教育得够呛一颗常规料要从代理手里拿货都得排期二是产品要加功能屏幕要升级、数据处理量变大F103的72MHz主频和20KB SRAM开始捉襟见肘跑个稍微复杂点的UI还要为内存精打细算。看了几款替代芯片GD32E103系列本质上还是M3内核APM32F103和F103的兼容度虽然高但主频、SRAM、浮点这部分没有质变。最后落到AT32F403A理由其实很直白同样是引脚兼容的国产方案它给了Cortex-M4F内核、最高240MHz主频、最大256KB SRAMFlash最大能到1MB内部还带XMC接口可以挂LCD和外部RAM。最关键的是它引脚定义和STM32F103的LQFP封装基本对齐意味着原有PCB改动的成本可控。当时心里也清楚所谓兼容这个词在嵌入式圈子里水很深。有的芯片是引脚兼容但外设寄存器完全两码事有的是库函数长得像但行为细节差别很大。AT32F403A走的是引脚兼容、底层不兼容的路线它的外设库和ST标准库风格接近但不是同一个库中断向量表、时钟结构、GPIO复用方式都有差别。这篇文章就是把我从F103迁到F403A的完整过程、踩过的坑、调通后的实测数据整理出来给同样在评估国产替代或想升级性能的同行一个参照。2. 硬件改动清单引脚兼容是真的但别指望直接换芯片就跑2.1 封装与引脚的对应关系先说结论如果你是LQFP48、LQFP64或者LQFP100的封装基本可以做到引脚级替换。AT32F403A在引脚定义上刻意对齐了F103的大量管脚比如PA9/PA10对应USART1_TX/RXPB13/PB14/PB15对应SPI2的SCK/MISO/MOSI这跟F103的AF映射是一致的硬件上不需要飞线。但这里有个很容易误判的地方F103上同一个引脚的功能切换靠的是AFIO重映射比如USART3可以重映射到PB10/PB11或PD8/PD9配置时往AFIO寄存器写重映射位就行。AT32F403A用的则是IOMUX引脚复用矩阵每个引脚有一个MUX编号你要把某个脚配成哪个外设功能必须显式调用引脚复用配置函数。这个机制更像NXP和GD32E系列的做法灵活性更高但代码写法跟F103完全不同后面移植时会反复遇到。2.2 电源、晶振和启动引脚调整硬件上真正要动手的地方有这么几个工作电压范围AT32F403A的VDD范围是2.6V到3.6V比F103的2.0V到3.6V窄。绝大多数3.3V系统没问题但如果你的产品里有2.5V供电或者依赖低压运行这个点必须在校验阶段就发现。外部晶振负载电容官方BSP里推荐的HEXT匹配电容值和ST的参考设计略有出入建议按AT32数据手册和硬件设计指南来选。别小看这个晶振起振不稳会让系统时钟出现偶发问题那可比软件Bug难查得多。复位电路和BOOT引脚我这次基本没动NRST的RC复位、BOOT0接下拉、BOOT1接下拉跟F103最小系统的用法一致。芯片ID和丝印AT32F403A的丝印规则和ST完全不同贴片回来后第一时间用官方工具或者读寄存器确认芯片型号和批次避免贴错料。调试接口芯片默认SWD接口的引脚位置和F103一致JLINK、DAP-Link理论上都能连但AT32官方主推的是AT-Link价格便宜且配套的AT-Link工具软件能直接读芯片UID、配置选项字建议手头备一个。2.3 对外设引脚分配做一次审计换芯片最忌讳的事情就是默认都兼容直接出图。我这次改板前做了一张对照表把项目里用到的每一个外设引脚都过了一遍。举个例子F103上SPI1的NSS可以用硬件管理但AT32F403A的SPI1_NSS引脚在IOMUX里有一个独立的MUX编号如果你之前是软件控制NSS问题不大如果是硬件NSS自动拉低就得确认IOMUX配置正确否则CS时序完全是乱的。另外我项目里还用了定时器TIM2的PWM输出F103上PA0可以映射到TIM2_CH1AT32F403A同样支持但MUX编号不同。这种细节在官方数据手册的引脚定义表里都列得很清楚建议改板前把功能-引脚-复用编号做成表格和硬件工程师逐项核对。3. 工程移植第一关ST标准库和AT32固件库的翻译方法3.1 AT32固件库的目录和基础工程结构AT32官方从官网上能下载到BSP固件包里面有标准外设库、板级例程、FreeRTOS和RT-Thread的适配例程。我用的固件库版本现在可能已经更新过了但目录结构大差不差。跟ST标准库对比的话最大感受是AT32把外设库按功能模块拆得更细比如ADC、CRM、DMA、GPIO、USART各自一个文件命名是at32f403a_adc.c、at32f403a_crm.c这样的规律。建议不要直接在一个STM32工程里改而是先用官方BSP里的空工程或者模板工程建一个新工程然后把业务代码平铺进来。这样能避免库文件混用导致的冲突问题。3.2 常用API对应关系一览我用ST标准库很多年刚开始切AT32库的时候最痛苦的就是函数名对不上。整理一张对照表对从标准库过来的朋友帮助很大功能ST标准库AT32固件库对应版本芯片头文件stm32f10x.hat32f403a.h时钟复位管理stm32f10x_rcc.hat32f403a_crm.h外设时钟使能GPIORCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)crm_periph_clock_enable(CRM_GPIOA_PERIPH_CLOCK, TRUE)GPIO初始化参数GPIO_InitTypeDefgpio_init_typeGPIO初始化函数GPIO_Init()gpio_init()引脚复用配置GPIO_PinRemapConfig()gpio_pin_mux_config()串口初始化USART_Init()usart_init()串口中断标志USART_GetITStatus()usart_interrupt_flag_get()DMA初始化DMA_Init()dma_init()延时函数无标准通常用SysTick无标准可用官方提供的延时例程从这张表能看出来AT32库的函数名是小写开头的结构体名也是小写风格上更贴近新唐或GD32的命名但整体思路和ST标准库是一一对应的。所以只要花半天时间把常用外设的API对照表整理出来迁移速度会非常快。3.3 启动文件和系统初始化文件的替换工程里必须替换的几个文件startup_stm32f10x_md.s→startup_at32f403a.s中断向量表不一样这个不能混用。system_stm32f10x.c→system_at32f403a.cSystemInit()的实现逻辑不同。分散加载文件/链接脚本如果是MDK用的是.sct一般自动生成如果是IAR或者GCC注意Flash和RAM的起始地址及大小要改成AT32F403A的实际容量。有个容易忽略的点AT32F403A中断向量表里IRQ号比F103多如果你的代码里直接写了类似NVIC_InitStructure.NVIC_IRQChannel USART1_IRQn;这样的语句IRQn这个枚举的数值在AT32的库里不一样虽然USART1的IRQHandler名字一样但中断优先级的配置值范围也有差异。建议把所有中断相关的配置统一过一遍。4. 时钟树配置240MHz的性能爽点与稳定性代价4.1 AT32的CRM和ST的RCC有什么不一样AT32F403A的时钟管理模块叫CRM全称是Clock Reset Management对应ST的RCC。功能上大同小异都是管理HEXT、HEXT、PLL、AHB、APB1、APB2这些时钟源和分频器但寄存器布局、配置流程有差异。最核心的问题是PLL的倍频计算。STM32F103的经典配置是外部8MHz晶振PLL倍频到72MHz配9倍频。AT32F403A如果也想冲到240MHzPLL配置链路就完全不一样需要按照参考手册里的PLL配置公式来算N、M、分频器这些参数必须严格在允许范围内。我一开始直接把F103的PLL配置思路套过来结果系统时钟完全不对后来老老实实用官方的时钟配置工具把参数算出来才解决问题。4.2 我最终用的时钟配置我的板子上是8MHz外部晶振目标是把系统时钟跑到240MHz。官方BSP里对这个主频组合有现成的配置但如果你用的晶振不是8MHz比如16MHz或25MHz必须改PLL参数。以下是一段基于8MHz晶振配置的代码骨架函数名以你手里的固件库版本为准// 使能外部高速晶振 crm_clock_source_enable(CRM_CLOCK_SOURCE_HEXT, TRUE); // 等待晶振稳定 while (crm_flag_get(CRM_HEXT_STABLE_FLAG) ! SET); // 配置PLL将8MHz倍频到240MHz crm_pll_config(CRM_PLL_SOURCE_HEXT, ...); // 参数按官方工具生成的传入 // 使能PLL并等待稳定 crm_clock_source_enable(CRM_CLOCK_SOURCE_PLL, TRUE); while (crm_flag_get(CRM_PLL_STABLE_FLAG) ! SET); // 选择PLL作为系统时钟 crm_sysclk_switch(CRM_SCLK_PLL); // 等待切换完成 while (crm_sysclk_switch_status_get() ! CRM_SCLK_PLL);配置完系统时钟之后还要设AHB、APB1、APB2的分频系数。我当时是AHB不分频APB1四分频60MHzAPB2二分频120MHz具体为什么这么分看数据手册里的外设总线频率上限就知道了APB1上挂的定时器、串口如果超过上限外设行为会变得很诡异。4.3 FLASH等待周期是重灾区这是最容易踩且查得最辛苦的坑之一。F103在72MHz下FLASH等待周期配置比较简单而AT32F403A跑到240MHz时如果FLASH等待周期没配够Flash读取速度跟不上CPU执行速度程序会随机跑飞表现出来就是HardFault、变量莫名其妙被改写、函数指针跳到奇怪地址。这个参数一般放在SystemInit()里跟着AHB时钟频率设置如果你是从F103工程改过来的必须确认AT32库的SystemInit()被正确调用且等待周期配置没有因时钟树改动而被跳过。我当时排查了整整两天最后用示波器对比PLL输出和CLKOUT引脚才怀疑到这块后来把系统降频到120MHz就稳定了进一步坐实是高速下Flash读取参数的问题。5. 外设移植实录串口、SPI、ADC这些常用模块怎么改5.1 串口 DMA收发移植串口是几乎所有项目都绕不开的外设。F103上用标准库写串口DMA接收核心思路是串口空闲中断IDLE判断一帧数据接收完成DMA把数据搬到缓冲区。AT32F403A上这套思路完全成立但有几个配置点要改串口时钟使能从RCC_APB2PeriphClockCmd换成crm_periph_clock_enable注意串口1挂APB2串口2和3挂APB1。GPIO复用F103里PA9、PA10默认就是USART1但AT32里除了要把GPIO模式设置成复用模式还要配置PA9的MUX为USART1_TX、PA10的MUX为USART1_RX。DMA通道AT32F403A的DMA通道分配和F103有差异我用的USART1_RX对应的DMA通道在F103是DMA1_Channel5在AT32F403A上需要查数据手册确认。这块不能想当然。我遇到的一个实际问题是串口压力测试时偶发丢字节排查过程后会单开一节详细讲。5.2 SPI通过DMA读传感器项目里用SPI读外部ADC和Flash之前在F103上是SPI1 DMA接收。迁到AT32F403A后SPI的寄存器名、DMA请求映射和F103不一样。AT32库的SPI收发函数、DMA初始化结构体和ST标准库略有区别但套路是通的。我整理了一个简洁的SPI DMA接收配置流程初始化SPI1的SCK、MISO、MOSI引脚配成复用模式并指定MUX。使能SPI1和DMA1的时钟。配置DMA接收通道外设地址指向SPI1的数据寄存器在AT32库里叫SPI1-DT还是类似名称以库为准内存地址指向缓冲区方向为外设到内存。设好传输长度打开DMA通道使能。等待DMA传输完成中断。我实测下来AT32F403A的SPI工作频率可以拉得比F103高很多以前F103上SPI时钟分频还要担心MISO采样时序现在主频高了之后整体时序余量更足。但SPI总线上挂多设备的话NSS的管理要格外注意AT32的硬件NSS引脚复用需要单独配置别漏。5.3 定时器PWM输出和ADC采集定时器PWM输出这块我用的TIM2_CH1在F103上PA0直接复用AT32F403A上配置GPIO_MODE_MUX之后还需要设置PA0的MUX为TIM2_CH1否则引脚不出来波形。刚开始漏了这步示波器一量没有输出查了半天GPIO初始化其实问题就在MUX没配。高级定时器TIM1和TIM8的互补输出、刹车输入这些功能在F103里就麻烦AT32里同样不省心但如果你只做简单的PWM改动不大。ADC部分AT32F403A的ADC是12位逐次逼近型配置思路和F103类似分频确定ADC时钟、设置通道采样时间、选择转换模式。一个不同点是AT32库的ADC初始化函数、通道配置函数的参数和ST标准库不一样但都有官方例程照着抄基本没问题。项目里如果用到多通道扫描DMA搬运结果记得DMA的中断和ADC的EOC信号关联关系确认好F103上这套逻辑已经很成熟AT32上同理但DMA通道号要重新确认。5.4 内部温度采集到底准不准很多F103用户问过内部温度传感器准不准这个问题的答案在AT32F403A上同样适用内部温度传感器适合做芯片结温监测和相对温度变化趋势不适合做高精度的环境温度测量。校准方法是读取芯片出厂时的校准值和对应温度点然后线性换算。换到AT32F403A后内部温度传感器的寄存器映射和校准值存放地址和F103不同不能沿用F103的公式需要查数据手册里温度传感器部分的说明。我实测AT32F403A的结温读数在长时间运行时比F103略高主要原因是主频高了、发热也上去了这点在结构散热设计时要注意。6. 中间件迁移FreeRTOS和LVGL跑起来的那些调整点6.1 FreeRTOS的port层和中断优先级配置手头项目跑的是FreeRTOSF103上用的port文件是port.c对应Cortex-M3AT32F403A是M4F内核要换成CM4F的port文件。这个操作在FreeRTOS官方的移植文档里有明确说明主要区别在于M4F有硬件FPU如果不打算用FPU或者想兼容老工程可以在编译宏里关闭FPU但AT32F403A最香的就是FPU不开可惜。更需要注意的是NVIC中断优先级分组。FreeRTOS要求中断优先级分组配置成组4也就是全部4位都用于抢占优先级。F103的老工程如果用的是分组2或者分组3FreeRTOS跑起来之后中断嵌套行为会超出预期串口中断、定时器中断一旦优先级配置错误可能出现任务调度不及时或者中断卡死的情况。我建议新建工程时直接把优先级分组写成NVIC_PriorityGroup_4然后所有中断优先级都按这个分组来配。6.2 LVGL从v7.11往上走为什么F403A比F103爽项目里的显示屏之前用LVGL v7.11在F103上跑的时候帧率、刷新流畅度都要靠优化打补丁减少控件数量、限制阴影效果、用局部刷新。F103的20KB RAM和72MHz主频说实话就是LVGL的入门底线复杂的仪表盘界面跑起来力不从心。换到AT32F403A之后内存配额直接给了LVGL分配一个200KB的缓冲区池刷新帧率明显提升动画效果和抗锯齿在M4F的浮点能力加持下顺畅多了。LVGL移植的步骤其实都是一样的配置lv_conf.h里的颜色深度、内存大小、时基源写一个tick函数定时调用lv_tick_inc再在屏幕刷新回调里把显存内容刷到LCD驱动。区别在于F103上为了省内存不敢开太大的buffer而F403A上你终于可以放开手脚。如果再接上XMC接口挂并行RGB LCD那体验比F103时代完全不是一个级别。6.3 FreeModbus等其他中间件的情况我的项目里还跑了FreeModbus协议栈这部分迁移工作量相对小。核心就是把串口底层的收发接口换成AT32的USART收发把Modbus协议栈依赖的定时器用于3.5个字符的帧间隔判断换成AT32的定时器。需要注意的坑是Modbus协议的帧间隔时间跟串口波特率强相关之前F103的定时器时基是72MHz主频下的分频配置换到AT32F403A之后如果定时器挂载的APB1时钟从36MHz变成60MHz那么分频参数和重装值必须重新算否则从机响应超时或者帧拼接错误。7. 踩坑链路的完整复盘两个典型问题的排查过程7.1 问题一上电偶发启动失败运行几分钟后进入HardFault这个问题的排查过程对我个人来说算是一次查时钟的完整教学。现象是程序烧进去能跑但偶尔上电卡死如果跑起来过几分钟会进HardFault有时能复现有时不能。一开始我以为是代码里有野指针或者数组越界把项目里所有缓冲区定义、DMA数组都查了一遍又在HardFault_Handler里加了栈回溯打印定位到PC指针跳到了一个不存在的地址。这一步让我更怀疑是执行流乱了而不是数据被改。排查链路往下走我做了三件事一是把所有外设功能关闭只跑一个LED翻转问题依旧二是把系统时钟从240MHz降到120MHz问题消失三是在SystemInit之后读取PLL锁定状态和时钟切换状态发现偶发情况下PLL锁定标志位的建立时间比预期长程序在等待稳定标志时如果超时逻辑不完善就直接往下执行了导致后续总线配置全部错位。最终结论是240MHz时PLL从启动到稳定的时间余量不够且FLASH等待周期的切换时机太早。修复办法有两个一是把SystemInit里的PLL等待超时时间加长确保稳定后再切系统时钟二是严格按照官方参考手册的时序要求先配低主频启动再切到PLL高速模式。这个坑提醒我国产芯片的很多参数规格跟ST并不完全一致不能拿F103的等待时序习惯直接套用。7.2 问题二串口DMA接收偶发丢字节这是很多串口通信项目都会遇到的经典问题。现象是波特率115200主机每秒发100帧数据F403A的串口DMA接收偶尔丢一两个字节导致帧校验失败。排查思路大概是这样的第一步示波器看波形。确认主机的TX引脚波形正常F403A的RX引脚波形幅度和边沿没有异常。这一步排除了电平转换、接线干扰等硬件问题。第二步算波特率误差。当时用的外部晶振精度是20ppm理论上不会导致115200的波特率误差超过1%但为了稳妥还是把USART的BRR寄存器值读出来算了实际波特率误差在可接受范围内。第三步查DMA中断和串口中断的优先级。如果串口的接收中断优先级比DMA中断高当DMA传输完成中断来时可能被串口中断打断导致DMA的缓冲区和当前写入位置不同步。第四步确认DMA循环模式和空闲中断的配合。我最终发现问题出在空闲中断非循环DMA的组合上一帧数据接收完成后DMA把数据搬走、关闭DMA通道、重设长度这一套动作里如果下一帧数据已经在总线上而DMA还没重新使能新进来的字节就丢了。最后的修法是改成DMA循环模式加双缓冲或者改用串口超时接收的思路在接收中断里持续收字节超过一定时间没新字节就视为一帧结束。这两种方案都能规避关闭DMA窗口期导致的丢数据问题。这个坑跟芯片本身无关F103上也会遇到但在AT32F403A上因为DMA通道重设的寄存器操作和F103不同刚开始确实容易忽略。8. 换芯之后实测如何性能、功耗和量产稳定性8.1 性能提升在哪些场景是真的我最直观的感受是三个地方一是主频从72MHz跳到240MHzCPU密集型的计算任务明显变快比如数据处理、CRC校验、Modbus报文组帧这些整个系统响应更轻快二是FPU带来的浮点计算提升如果之前F103上浮点运算靠软件模拟那M4F硬浮点在算法计算上可以说是天壤之别三是256KB SRAM带来的内存自由F103时代动不动就要省RAM现在大缓冲区、LVGL帧缓冲、多个设备的数据缓存可以同时放开。简单跑了一下官方和社区常用的CoreMarkAT32F403A在240MHz下的得分比F103在72MHz下的得分高好几倍当然这个分数的绝对意义有限但量级差距摆在那里。实际产品里最明显的是屏幕刷新率上来了动画掉帧肉眼可见地减少。8.2 功耗和发热情况AT32F403A在240MHz全速运行时的功耗肯定比F103在72MHz时高芯片表面温度会明显上升这是换来性能必须接受的代价。如果你的产品对功耗敏感原来F103的低功耗模式代码不能直接平移AT32F403A的睡眠、停机、待机模式各有自己的配置寄存器需要重新看数据手册来适配。我在实测中发现AT32F403A的睡眠模式唤醒延迟比F103略长所以低功耗场景下的唤醒策略需要重新调整否则会出现看起来睡着了但响应慢半拍的情况。8.3 量产稳定性的个人感受从样板调通到小批量试产再到跑了一段时间的稳定性测试我手里这批AT32F403A整体表现稳定。没有出现批次性烧录失败、工作温度范围异常、主频不稳定这类问题。唯一要提醒的是AT32的选项字Option Bytes配置和ST不一样烧录时如果用到读保护、看门狗配置等功能需要在AT-Link工具或烧录器软件里单独设置不要沿用ST的烧录脚本。9. 给还在犹豫的同行什么项目适合换什么项目别折腾如果按我自己的经验给一个决策参考老产品上用F103代码量巨大、又没有强烈性能需求、项目又急着出货那不建议动换芯片的测试验证成本可能比省下的芯片差价还高但如果是新产品选型或者老产品本来就要大改版本那AT32F403A值得放在评估列表里。特别是需要跑界面、跑浮点算法、需要更大内存的场景换过去之后你会明显感受到以前抠抠搜搜用内存现在终于可以放开写的松弛感。我还想分享一个小技巧AT32官方有类似STM32CubeMX的可视化配置工具叫AT32 Work Bench它可以生成基于固件库的初始化工程。一开始我习惯手动改F103老工程后来用这个工具重新生成外设初始化代码再把自己的业务逻辑搬进去反而比逐个翻译API快得多。建议准备迁移的朋友先花半小时把官方工具生成的例程跑通再动手搬业务代码这个顺序能省下不少踩坑时间。