手把手教你：如何将STM32F103项目快速迁移到国产Air32F103或CH32F203（附代码对比）-程序员充电站

从STM32F103到国产芯片的实战迁移指南：Air32F103与CH32F203代码改造详解

当手头的STM32F103项目面临芯片短缺或成本压力时，国产同架构芯片往往是最佳替代选择。但真正开始移植代码时，你会发现时钟配置、GPIO映射、SDK差异等细节问题接踵而至。本文将用真实项目经验，带你拆解Air32F103和CH32F203的移植要点。

1. 芯片选型与准备工作

在开始移植前，需要明确几个关键参数差异。Air32F103最高支持216MHz主频（超频可达256MHz），而CH32F203最高运行在144MHz。两者都采用Cortex-M3内核，但外设寄存器布局与STM32存在微妙差别。

必备工具清单：

目标芯片开发板（建议选用官方评估板）
原STM32工程代码（建议使用标准库或LL库版本）
国产芯片对应的SDK包（从厂商官网下载最新版）
J-Link或DAP-Link调试器（部分国产芯片需专用固件）

注意：不同厂商的烧录工具兼容性差异较大。例如合宙的DAP-Link固件不支持CH32F203，而WCH的编程器仅限自家芯片使用。

2. 时钟系统重构实战

时钟配置是移植的第一道关卡。以CH32F203为例，需要补充STM32不支持的96MHz和144MHz时钟配置：

// 在system_ch32f20x.c中添加以下宏定义和函数 #define SYSCLK_FREQ_96MHz 96000000 #define SYSCLK_FREQ_144MHz 144000000 void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // 针对144MHz配置 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL18; // 8MHz*18=144MHz HAL_RCC_OscConfig(&RCC_OscInitStruct); RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_5); }

关键差异点对比：

参数	STM32F103	Air32F103	CH32F203
最大主频	72MHz	216MHz	144MHz
PLL倍频范围	2-16倍	2-64倍	2-18倍
Flash等待周期	0-7	0-15	0-5

3. GPIO端口映射改造

CH32F203的PC端口存在13位偏移的"特性"，这是移植过程中最易踩坑的地方。具体修改示例如下：

// 原STM32代码： GPIO_InitStruct.Pin = GPIO_PIN_13; HAL_GPIO_Init(GPIOC, &GPIO_InitStruct); // CH32F203修改后： GPIO_InitStruct.Pin = GPIO_PIN_13 << 13; // 关键修改！ HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

GPIO移植检查清单：

检查所有PC端口引脚的位偏移
验证复用功能(AF)配置是否相同
确认上下拉电阻配置寄存器地址
测试GPIO中断触发方式

对于Air32F103，虽然不需要位偏移操作，但要注意其GPIO驱动能力更强，建议：

// 增加驱动强度配置（Air32特有） GPIO_InitStruct.Drive = GPIO_DRIVE_STRONGER;

4. 外设驱动适配要点

不同厂商的SDK对同一外设的寄存器命名可能不同。以USART为例：

寄存器差异对比表：

功能	STM32寄存器	CH32对应寄存器
状态寄存器	USART_SR	USART_STATR
数据寄存器	USART_DR	USART_DATAR
波特率寄存器	USART_BRR	USART_BAUDR

定时器配置也需特别注意，CH32F203的TIM1高级定时器：

// 原STM32 PWM配置： htim1.Instance = TIM1; htim1.Init.Prescaler = 72-1; htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 1000-1; // CH32F203需增加： htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; htim1.Init.RepetitionCounter = 0; // 新增重复计数器