STM32 F4到F1移植MPU9250驱动：从底层接口到工程配置全解析-平芜编程栈

简介：一套将MPU9250九轴传感器驱动从STM32F4平台移植到STM32F1平台的完整源码例程，主要面向需要在Cortex-M3内核上复用DMP运动驱动与姿态解算能力的嵌入式开发者。资源包共219个文件，压缩后仅4.48MB，其中68个.h头文件与46个.c源文件构成主代码，涵盖inv_mpu.c、inv_mpu_dmp_motion_driver.c、data_builder.c等关键驱动；另有Keil工程文件(.uvprojx)、编译生成的hex/axf/map/lst文件，以及bat清理脚本，便于直接打开工程、烧录验证和对比中间产物。移植过程中涉及的GPIO/I2C接口重映射、中断向量表调整、内存占用优化、时钟树配置等关键改动，都可在源码中对照查看，省去从零查阅参考手册的时间。已有2135人学习下载，适合正在开发STM32F1+MPU9250项目或准备从F4向低成本F1迁移的工程师，可显著缩短驱动底层调试周期，快速进入姿态解算与应用逻辑开发。

1. 移植前的整体判断：F4的代码到F1上到底差在哪

拿到一个MPU9250从F4移植到F1的活儿，第一反应千万别是“直接改芯片型号然后编译”，那样你会被报错淹没。F4和F1虽然都是ARM Cortex-M内核，但一个是M4架构带FPU，一个是M3架构不带浮点单元，外设库函数名、时钟树配置、启动文件、甚至默认的晶振频率都不一样。我这次移植的目标板是STM32F103C8T6（蓝色Pill板那种），原工程跑在STM32F407VET6上，底层驱动是标准外设库，不是HAL。既然你标题里写的是“源码例程”，大概率网上流传的也是标准库版本，所以下面的内容全部基于标准库来聊。

先说结论：MPU9250这个传感器的驱动移植，本质上不是“算法移植”，而是“底层接口移植”。传感器本身是I2C或SPI接口，跟MCU型号没直接关系。所谓的型号差异，体现在三个地方：GPIO初始化宏、I2C/延时函数的底层实现、以及编译时头文件路径和启动文件。把这三件事理清楚，移植就成功了一大半。

F1和F4的关键差异我用了个表格给团队新人也讲了很多次：

对比项	STM32F4（F407为例）	STM32F1（F103为例）	对MPU9250移植的影响
内核	Cortex-M4F，带FPU	Cortex-M3，无FPU	F1做浮点运算更慢，注意数据类型
最高主频	168MHz	72MHz	软件I2C延时参数要重新算
Flash/RAM	512KB/192KB	64KB/20KB	注意DMP库能不能装下
I2C外设	I2C模块功能较完善	硬件I2C有“历史遗留问题”	强烈建议用GPIO模拟I2C
启动文件	startup_stm32f40x.s	startup_stm32f10x_hd.s	必须换
标准库	STM32F4xx_DSP_StdPeriph	STM32F10x_StdPeriph	API有细微差异

注意：这里说的“F1硬件I2C历史遗留问题”，不是不能用，而是它在某些时序组合下会卡BUSY状态，比软件模拟I2C更容易出幺蛾子。MPU9250通信频率本来就不高（400kHz以内就够），软件模拟I2C完全扛得住，而且引脚随意映射，改了管脚不用动板子重画。所以我一律推荐软I2C方案。

2. 源码结构拆解：哪些文件必须动，哪些可以原封不动搬过去

打开原来的F4工程，你大概率会看到这样的文件组织：

mpu9250.c / mpu9250.h —— 传感器寄存器读写、初始化、数据读取
inv_mpu.c / inv_mpu_dmp_motion_driver.c —— InvenSense官方DMP库（如果用了的话）
iic_soft.c / iic_soft.h —— GPIO模拟I2C的底层收发
delay.c / delay.h —— 延时函数
usart.c / usart.h —— 串口打印调试
main.c —— 初始化流程和主循环

这里面的关键结论是：mpu9250.c和mpu9250.h基本可以原封不动搬过去，因为里面都是I2C寄存器地址和读取逻辑，跟MCU平台无关。需要动的是 iic_soft、delay、usart 这三个底层文件，以及工程配置。

要特别留个心眼的是DMP库。MPU9250的DMP不像MPU6050那样有公开的完整驱动可用，很多网上所谓的MPU9250 DMP例程，其实是用MPU6050的DMP库跑在9250的加速度计和陀螺仪上（也就是当六轴用），磁力计AK8963的数据是单独读出来再软件融合的。F103C8T6只有64KB Flash，如果你原工程把整个DMP库、磁力计融合代码都搬过来，Flash可能会爆。建议先用裸读方式（直接读加速度计、陀螺仪、磁力计的原始寄存器）跑通，再考虑加DMP。

我在实际项目里的做法是，先把驱动拆成两层：

应用层：mpu9250.c —— 传感器相关逻辑，只调用I2C接口函数
底层：iic_soft.c、delay.c、usart.c —— 跟MCU强相关

这样拆完之后，移植就变成了“换三个底层文件”的工作量，而不是在几百行传感器代码里大海捞针找哪句用了F4专用外设。

3. 实操移植过程：逐文件修改和关键代码解析

3.1 硬件I2C换软I2C：初始化函数重写

原F4工程里的I2C初始化如果是这种写法：

I2C_InitTypeDef initStruct; initStruct.I2C_ClockSpeed = 400000; initStruct.I2C_Mode = I2C_Mode_I2C; initStruct.I2C_DutyCycle = I2C_DutyCycle_2; initStruct.I2C_Ack = I2C_Ack_Enable; initStruct.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_Init(I2C1, &initStruct);

换成软件模拟I2C之后，只需要做两件事：把用到的两个GPIO引脚配置成开漏输出，然后直接操作引脚电平。

#define MPU_SDA_PORT GPIOB #define MPU_SDA_PIN GPIO_Pin_9 #define MPU_SCL_PORT GPIOB #define MPU_SCL_PIN GPIO_Pin_8 #define MPU_SDA_H() GPIO_SetBits(MPU_SDA_PORT, MPU_SDA_PIN) #define MPU_SDA_L() GPIO_ResetBits(MPU_SDA_PORT, MPU_SDA_PIN) #define MPU_SCL_H() GPIO_SetBits(MPU_SCL_PORT, MPU_SCL_PIN) #define MPU_SCL_L() GPIO_ResetBits(MPU_SCL_PORT, MPU_SCL_PIN) void MPU_I2C_GPIO_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = MPU_SDA_PIN | MPU_SCL_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; // 开漏输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(MPU_SDA_PORT, &GPIO_InitStructure); MPU_SDA_H(); MPU_SCL_H(); }

这里有个很重要的点：SDA和SCL都要配置成开漏输出，并外部接上拉电阻（4.7kΩ即可）。开漏的好处是电平可以双向切换，读SDA数据时把引脚配置成输入模式，写的时候配置成输出模式，但开漏模式下输出高电平其实就是释放总线让上拉电阻拉高，所以很多软I2C实现根本不切换GPIO模式，直接操作ODR和IDR。不过稳妥起见，读数据时我习惯把引脚切成输入模式，避免电平冲突。

uint8_t MPU_I2C_ReadByte(void) { uint8_t data = 0; GPIO_InitTypeDef GPIO_InitStructure; // 切输入模式 GPIO_InitStructure.GPIO_Pin = MPU_SDA_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(MPU_SDA_PORT, &GPIO_InitStructure); for (int i = 0; i < 8; i++) { MPU_SCL_H(); delay_us(2); data = (data << 1) | GPIO_ReadInputDataBit(MPU_SDA_PORT, MPU_SDA_PIN); MPU_SCL_L(); delay_us(2); } // 切回输出模式 GPIO_InitStructure.GPIO_Pin = MPU_SDA_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(MPU_SDA_PORT, &GPIO_InitStructure); return data; }

每次读字节都切一次GPIO模式，会损失一点速度，但MPU9250的采样率顶天了也就1kHz级别，这点开销完全可以忽略。换来的是代码简单不易出错，排查问题的时候脑筋不用在“输入输出方向切换”上多绕一道弯。

3.2 延时函数适配F1的72MHz主频

原F4工程里的延时常写成这样的形式：

void delay_us(uint32_t nus) { uint32_t temp; SysTick->LOAD = nus * 21; // F4跑168MHz，1us=168个时钟周期，一般留余量取21 SysTick->VAL = 0; SysTick->CTRL |= SysTick_CTRL_ENABLE_Msk; // ...等待标志位置位 }

F103的主频是72MHz，如果直接把这段代码搬过来，LOAD寄存器填入的延时计数是原来的168/21倍关系，实际延时时间会差很多。最典型的问题就是I2C时序整体偏短，传感器偶尔能读到数据，偶尔读不到，或者读到的数据偶发错位。

我重新写的基于SysTick的延时函数是这样的：

static uint8_t fac_us = 0; static uint16_t fac_ms = 0; void delay_init(void) { SysTick_CLKSourceConfig(SysTick_CLKSource_HCLK_Div8); fac_us = SystemCoreClock / 8000000; // 72MHz / 8 = 9MHz => 1us = 9 tick fac_ms = (uint16_t)fac_us * 1000; } void delay_us(uint32_t nus) { uint32_t temp; SysTick->LOAD = nus * fac_us; SysTick->VAL = 0; SysTick->CTRL |= SysTick_CTRL_ENABLE_Msk; do { temp = SysTick->CTRL; } while ((temp & SysTick_CTRL_ENABLE_Msk) && !(temp & SysTick_CTRL_COUNTFLAG_Msk)); SysTick->CTRL &= ~SysTick_CTRL_ENABLE_Msk; SysTick->VAL = 0; }

注意SysTick时钟源选择这里，F1和F4的寄存器映射略有不同，但标准库的SysTick_CLKSourceConfig两个平台都能用，直接调库函数最省事。这里用HCLK/8，得到9MHz的SysTick时钟，1us就是9个tick，算出来的fac_us是整数，延时精度好。

3.3 MPU9250初始化配置：寄存器值不用改，但建议核实版本

MPU9250的初始化流程，从F4到F1是完全一致的，因为操作对象是传感器芯片而不是MCU。标准流程如下：

复位：向PWR_MGMT_1（0x6B）写0x80，延时100ms
唤醒：向PWR_MGMT_1写0x00
配置陀螺仪量程：GYRO_CONFIG（0x1B）写0x18（±2000dps）
配置加速度计量程：ACCEL_CONFIG（0x1C）写0x18（±16g）
配置采样率：SMPLRT_DIV（0x19）写0x04，得到1kHz采样率
配置数字低通滤波器：CONFIG（0x1A）写0x03，DLPF约44Hz
读取WHO_AM_I（0x75）验证通信，期望值0x71（多数MPU9250模块返回0x71，部分新批次返回0x73）

我建议在初始化函数里加一道WHO_AM_I校验，读回来不对就不继续往下走，并且通过串口把实际读到的值打出来。这一步对排查I2C地址错误、引脚接反、模块损坏都极其有帮助。

uint8_t MPU9250_Check(void) { uint8_t reg = 0; MPU9250_ReadReg(MPU9250_WHO_AM_I, &reg, 1); if (reg == 0x71 || reg == 0x73) { return 0; } printf("WHO_AM_I error: 0x%02X (expect 0x71 or 0x73)\r\n", reg); return 1; }

3.4 磁力计AK8963单独读取：这是最容易漏掉的一块

MPU9250内部集成的磁力计AK8963，物理上是独立芯片，通过MPU9250内部的一个I2C master通道挂在同一个I2C总线上，从机地址是0x0C。很多移植失败的案例都是因为只读加速度计和陀螺仪，磁力计数据全是0或者不变。

在F1上跑磁力计的正确姿势是给AK8963单独走一套I2C读写逻辑，或者通过MPU9250的I2C Master模式去读。更省心的方案是直接用MPU9250内置的I2C Master直通（bypass）模式，把AK8963暴露在主I2C总线上，这样代码里直接用0x0C地址访问AK8963就行了。关键配置是INT_PIN_CFG（0x37）写0x02开启bypass，I2C_MST_CTRL（0x24）写0x0D设置I2C Master时钟。

AK8963初始化要特别注意：先读WHO_AM_I（0x00），期望0x48；然后设置连续测量模式（CNTL寄存器0x0A写0x16，即100Hz连续测量模式2）；如果读出来的磁力计数据一直是0，大概率是bypass没开对，或者模块上磁力计走的是独立引脚需要额外供电。

3.5 工程配置：启动文件、宏定义、头文件路径三件套

代码层面改完之后，工程配置是另一个大坑。我总结成三个必改项：

首先是启动文件。原F4工程里的startup_stm32f40x.s必须删除，换成startup_stm32f10x_hd.s（大容量产品）。文件路径一般在Keil安装目录或标准库的 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/arm 下。F103C8T6虽然是中容量（64KB Flash），但用hd版本是可以的，因为启动文件只是按向量表定义中断处理函数名，多出来的中断向量不会影响运行。当然你也可以选md.s，但hd.s兼容性最好，很多网上工程都是这么干的。

第二个是预处理宏。F4工程里可能定义了STM32F40XX，编译F1时要改成STM32F10X_HD，同时把USE_STDPERIPH_DEVICE保留。这个宏决定了标准库头文件里到底包含哪些外设声明，漏了它编译直接报一堆undefined identifier。

第三个是C/C++ Include Path。把原来指向F4标准库头文件的路径全部删掉，新增：

.../STM32F10x_StdPeriph_Driver/inc .../CMSIS/CM3/DeviceSupport/ST/STM32F10x .../CMSIS/CM3/CoreSupport .../硬件驱动/（你自己工程文件夹）

同时注意C/C++选项卡里的Define栏，至少要写：

STM32F10X_HD, USE_STDPERIPH_DEVICE

3.6 浮点运算和printf重定向的差异

F4带FPU，float运算基本零开销；F1的Cortex-M3没有浮点单元，float四则运算全靠编译器调用软浮点库，速度和代码体积都不占优势。如果你的MPU9250上位机程序里大量使用double类型做姿态解算，在F1上跑起来会明显变慢。建议把所有double改成float，省Flash也省运算时间。

另外，原来的F4工程里大概率用了printf重定向到串口，代码类似：

int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); return ch; }

这段在F1上同样适用，前提是usart.c里改掉RCC和GPIO配置。F1的USART1时钟挂在APB2上，GPIOA时钟也挂在APB2上：

RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

而F4里GPIO时钟使能用的是RCC_AHB1PeriphClockCmd，这里差异挺容易漏。改完之后串口引脚用PA9（TX）和PA10（RX）就行。

4. 常见问题排查与踩坑实录

4.1 编译报错：一大批stm32f4xx.h相关头文件找不到

这是最典型的移植报错，原因几乎都是Include Path没改干净，编译器还在找F4的头文件目录。解决方法是把工程里所有跟F4相关的头文件路径删干净，只保留F1标准库三个核心目录。如果还报错，就检查启动文件是不是换成了F1版本。

另外，如果报错里出现“error: no stm32 target found!”这类和调试器相关的提示，那不是编译问题，是下载调试时Keil找不到目标芯片。多半是Debug选项卡里的调试器型号没换，或者Flash Download里的编程算法（Programming Algorithm）还是F4的，要改成STM32F10x High-density Flash。

4.2 I2C通信失败：读WHO_AM_I返回0xFF或随机值

这个问题的排查顺序我建议按照以下清单走：

接线检查：VCC接3.3V，GND共地，SDA接PB9，SCL接PB8，SDA和SCL都要有上拉电阻。很多蓝色Pill板模块板载了上拉，不需要额外接；如果是裸芯片就得自己加4.7kΩ上拉。
代码检查：I2C起始条件和停止条件时序是否正确，SDA在SCL高电平期间不能变化，这是I2C协议的基础。
延时检查：软件模拟I2C的每个时钟周期延时不能太短，我建议至少延时2us，也就是时钟频率250kHz左右，太快的时序MPU9250不一定响应。
地址确认：MPU9250的7位从机地址是0x68（AD0接地时），8位写地址是0xD0，读地址是0xD1。在代码里要区分清楚你写的是7位还是8位地址。如果用模拟I2C每次都发0x68后跟读写位，那是7位地址的正确操作；如果你直接把0xD0当作从机地址发出去，就相当于发了0x68左移一位加0，其实也是对的，但容易把自己绕晕。

4.3 加速度计和陀螺仪有数据，磁力计全是0

这就是我前面提到的AK8963没配置好。先读AK8963的WHO_AM_I（0x00），应该返回0x48。返回0x48但数据还是0，检查是不是处于power-down模式，要往CNTL寄存器写0x16开启连续测量。如果WHO_AM_I都读不到，优先检查MPU9250的bypass模式有没有打开，这步不配好，主I2C总线根本看不到AK8963。

4.4 串口输出乱码

波特率配置没问题的话，十有八九是时钟配置不对。F1的USART波特率发生器直接依赖于APB时钟，而APB时钟由RCC_PCLK1/PCLK2决定。如果工程里SystemInit没配好，或者外部晶振不是8MHz，串口算出来的波特率就会偏差。最常遇到的情况是板载晶振是8MHz，但代码里HSE_VALUE还是默认的8000000，这个没问题；如果用的是12MHz晶振的板子，就要改stm32f10x.h里的HSE_VALUE，或者在SystemInit里做对应配置。

4.5 Flash不够用：DMP库和磁力计融合代码太大

F103C8T6的64KB Flash，如果原F4工程把完整的InvenSense DMP库加进去，编译后很容易超限。两个方向：第一，把编译器优化等级调到-O2或-O3，有时候能省出几千字节；第二，放弃DMP，改用裸读方式读取六轴数据，姿态解算用互补滤波，代码量只有DMP库的零头。对于大多数不需要高精度姿态的应用，裸读加互补滤波完全够用。