从STM32到CH32F103：MPU6050小车程序移植实战指南
对于习惯了STM32生态的开发者来说，初次接触CH32F103系列芯片可能会感到既熟悉又陌生。这两款基于Cortex-M3内核的微控制器在硬件设计上高度相似，但在库函数实现细节上却存在一些关键差异。本文将带您深入探索如何将一个基于MPU6050传感器的智能小车控制程序从STM32平台迁移到CH32平台，重点关注那些容易导致移植失败的"暗礁"。
1. 开发环境准备与基础认知
在开始移植工作前，我们需要建立对这两个平台的基本认识。CH32F103和STM32F103都采用ARM Cortex-M3内核，外设地址映射也基本一致，这使得二进制级别的兼容成为可能。但在实际开发中，我们更多使用的是各自的官方库函数，这就带来了第一个需要注意的点。
开发工具链配置要点：
- 下载最新版CH32官方标准库（目前版本为V1.0）
- 安装WCH-Link调试器驱动
- 在IDE（Keil或IAR）中正确配置芯片型号为CH32F103C8T6
- 设置正确的Flash下载算法
提示：虽然CH32可以使用STM32的工程模板，但建议从WCH提供的示例工程开始，避免底层配置差异导致的问题。
一个常见的误区是认为两个平台的库函数可以完全互换。实际上，虽然功能相同，但命名规范存在系统性的差异。例如，STM32库中常见的"GPIO_SetBits"在CH32库中变为"GPIO_WriteBit"，这种变化不是随机的，而是贯穿整个库函数体系。
2. GPIO配置差异详解
GPIO作为最基础的外设，在传感器控制中扮演着关键角色。MPU6050使用I2C接口通信，而小车电机驱动通常需要PWM输出，这些都离不开正确的GPIO配置。让我们深入分析两个平台在GPIO处理上的区别。
2.1 寄存器命名差异对比
下表展示了GPIO相关寄存器在两种库中的命名对比：
| 功能描述 | STM32库命名 | CH32库命名 |
|---|---|---|
| 端口输出数据寄存器 | GPIOx->ODR | GPIOx->OUTDR |
| 置位/复位寄存器 | GPIOx->BSRR | GPIOx->OUTDR |
| 配置寄存器低位 | GPIOx->CRL | GPIOx->CFGLR |
| 配置寄存器高位 | GPIOx->CRH | GPIOx->CFGHR |
这种命名差异在直接操作寄存器时会带来困扰。例如，在STM32中常见的快速置位操作：
GPIOA->BSRR = GPIO_Pin_5; // STM32写法在CH32中需要改为：
GPIOA->OUTDR = GPIO_Pin_5; // CH32写法2.2 库函数接口变化
除了寄存器名称，库函数接口也有相应调整。以下是常见GPIO操作的对比：
// STM32库函数 GPIO_SetBits(GPIOA, GPIO_Pin_4 | GPIO_Pin_5); GPIO_ResetBits(GPIOB, GPIO_Pin_0); // CH32库函数等效写法 GPIO_WriteBit(GPIOA, GPIO_Pin_4 | GPIO_Pin_5, Bit_SET); GPIO_WriteBit(GPIOB, GPIO_Pin_0, Bit_RESET);在MPU6050的I2C接口实现中，SCL和SDA线需要频繁切换输入输出方向。STM32中常用的配置方式：
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; // 开漏输出在CH32中对应的配置为：
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; // 注意：模式定义值可能不同注意：虽然模式名称相同，但对应的数值可能不同，务必检查头文件中的具体定义。
3. USART通信配置调整
调试过程中，串口打印是必不可少的工具。许多开发者习惯使用printf重定向到串口，这在两个平台上的实现也有差异。
3.1 串口寄存器差异
USART相关寄存器的命名差异主要体现在控制寄存器上：
| 寄存器功能 | STM32命名 | CH32命名 |
|---|---|---|
| 状态寄存器 | USARTx->SR | USARTx->STATR |
| 数据寄存器 | USARTx->DR | USARTx->DATAR |
| 波特率寄存器 | USARTx->BRR | USARTx->BRR |
3.2 printf重定向实现
在STM32中常见的printf重定向代码：
int fputc(int ch, FILE *f) { while((USART1->SR & 0x40)==0); // 等待发送缓冲区空 USART1->DR = (u8)ch; return ch; }移植到CH32时需要修改为：
int fputc(int ch, FILE *f) { while((USART1->STATR & 0x40)==0); // 注意STATR替代SR USART1->DATAR = (u8)ch; // DATAR替代DR return ch; }4. MPU6050传感器驱动适配
有了前面的基础，我们现在可以专注于MPU6050驱动程序的移植。这个过程中最关键的环节是I2C通信的实现。
4.1 I2C接口初始化
STM32标准的I2C初始化代码：
I2C_InitTypeDef I2C_InitStructure; I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle = I2C_DutyCycle_2; I2C_InitStructure.I2C_OwnAddress1 = 0x00; I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed = 400000; I2C_Init(I2C1, &I2C_InitStructure);CH32中的对应实现：
I2C_InitTypeDef I2C_InitStructure; I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle = I2C_DutyCycle_16_9; // 注意占空比定义差异 I2C_InitStructure.I2C_OwnAddress1 = 0x00; I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed = 400000; I2C_Init(I2C1, &I2C_InitStructure);4.2 传感器数据读取
MPU6050数据读取的典型代码在移植时需要注意以下几点：
- I2C起始条件生成函数名可能不同
- 等待事件标志的判断方式可能有差异
- 错误处理机制可能需要调整
以下是读取加速度计数据的代码对比：
// STM32版本 uint8_t MPU6050_Read_Accel(uint8_t reg_addr, int16_t *accel_data) { uint8_t buffer[6]; I2C_GenerateSTART(I2C1, ENABLE); // ... 其他I2C操作 return 0; } // CH32适配版本 uint8_t MPU6050_Read_Accel(uint8_t reg_addr, int16_t *accel_data) { uint8_t buffer[6]; I2C_GenerateStart(I2C1, ENABLE); // 注意函数名大小写差异 // ... 其他I2C操作 return 0; }5. 电机控制与PID算法实现
智能小车的核心是电机控制，这通常涉及PWM生成和PID算法。在移植这部分代码时，需要注意定时器相关寄存器的命名差异。
5.1 PWM输出配置
STM32的PWM配置示例：
TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse = 1000; TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC1Init(TIM2, &TIM_OCInitStructure);CH32中的对应配置：
TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse = 1000; TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC1Init(TIM2, &TIM_OCInitStructure); // 函数接口保持一致5.2 PID控制算法
PID算法的实现通常是硬件无关的，可以直接复用。但需要注意：
- 定时器中断配置的差异
- 编码器接口的实现差异
- 系统时钟频率可能不同，需要调整时间常数
// 通用PID结构体定义 typedef struct { float Kp, Ki, Kd; float integral; float prev_error; } PID_Controller; // PID计算函数（可直接复用） float PID_Update(PID_Controller* pid, float setpoint, float measurement) { float error = setpoint - measurement; pid->integral += error; float derivative = error - pid->prev_error; pid->prev_error = error; return pid->Kp * error + pid->Ki * pid->integral + pid->Kd * derivative; }6. 系统时钟与延时函数调整
系统时钟配置是嵌入式系统的基础，两个平台在这方面的差异可能导致微秒级延时函数的偏差。
6.1 时钟树配置
STM32通常使用外部8MHz晶振，通过PLL倍频到72MHz。CH32的默认配置类似，但库函数接口不同：
// STM32时钟配置 RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); RCC_PLLCmd(ENABLE); // CH32时钟配置 RCC_PLLConfig(RCC_PLLSource_HSE, RCC_PLLMul_9); RCC_PLLCmd(ENABLE);6.2 精确延时实现
基于SysTick的微秒延时函数需要针对CH32进行调整：
// STM32版本 void delay_us(uint32_t us) { uint32_t temp; SysTick->LOAD = SystemCoreClock/1000000 * us; SysTick->VAL = 0x00; SysTick->CTRL = 0x01; do { temp = SysTick->CTRL; } while((temp&0x01) && !(temp&(1<<16))); SysTick->CTRL = 0x00; SysTick->VAL = 0x00; } // CH32适配版本 void delay_us(uint32_t us) { uint32_t temp; SysTick->CMP = SystemCoreClock/1000000 * us; SysTick->CNT = 0; SysTick->CTLR = 0x01; do { temp = SysTick->CTLR; } while((temp&0x01) && !(temp&(1<<16))); SysTick->CTLR = 0x00; SysTick->CNT = 0; }7. 调试技巧与常见问题排查
移植过程中难免遇到各种问题，以下是一些实用的调试技巧：
- 寄存器级调试：当库函数行为不符合预期时，直接查看外设寄存器值
- 时钟检查：确认系统时钟、外设时钟使能是否正确
- GPIO状态验证：使用逻辑分析仪或示波器检查关键信号线
- 最小系统测试：从最简单的LED闪烁程序开始，逐步增加功能
常见问题及解决方案：
问题1：程序下载后无反应
- 检查BOOT引脚配置
- 验证复位电路是否正常
- 确认Flash下载算法选择正确
问题2：I2C通信失败
- 检查上拉电阻是否接好
- 确认SCL/SDA引脚配置正确
- 降低通信速率测试
问题3：PWM输出异常
- 验证定时器时钟是否使能
- 检查GPIO复用功能配置
- 确认预分频和自动重载值设置合理
移植完成后的小车程序应该能够准确读取MPU6050的姿态数据，并通过PID算法控制电机实现平衡或转向。通过这个项目，开发者不仅能够掌握跨平台移植的技巧，还能深入理解ARM Cortex-M系列芯片的通用设计理念。
