别再对着GY-521模块发呆了！手把手教你用STM32CubeMX配置MPU6050驱动（附完整代码）
从零玩转MPU6050：基于STM32CubeMX的快速开发指南
第一次拿到GY-521模块时，我和大多数初学者一样感到既兴奋又迷茫。这个火柴盒大小的模块里藏着六轴运动传感器的奥秘，但面对密密麻麻的引脚和晦涩的数据手册，不知从何下手。直到发现STM32CubeMX这个神器，才真正体会到现代嵌入式开发的便捷。本文将带你用最有效率的方式，在30分钟内完成MPU6050的驱动配置和数据采集，避开那些新手常踩的"坑"。
1. 硬件准备与环境搭建
工欲善其事，必先利其器。在开始编码前，我们需要确保手头有这些硬件：
- GY-521模块（搭载MPU6050芯片）
- STM32开发板（推荐F103C8T6最小系统板）
- 杜邦线若干（建议使用彩色线区分功能）
- USB转TTL模块（用于串口调试）
硬件连接看似简单，但这里有几个关键细节需要注意：
| 引脚名称 | 连接目标 | 注意事项 |
|---|---|---|
| VCC | 3.3V或5V | 模块支持宽电压输入 |
| GND | 地线 | 确保共地 |
| SCL | STM32的I2C_SCL | 需接上拉电阻(4.7kΩ) |
| SDA | STM32的I2C_SDA | 需接上拉电阻(4.7kΩ) |
| AD0 | 悬空或接地 | 决定I2C地址(悬空为0x68) |
提示：虽然模块支持5V供电，但建议使用3.3V以避免电平转换问题。I2C总线的上拉电阻不可或缺，否则通信会不稳定。
软件环境准备：
- 安装STM32CubeMX（最新版）
- 安装对应系列的HAL库（如STM32F1xx）
- 准备一个IDE（Keil MDK或STM32CubeIDE）
2. CubeMX工程配置详解
打开CubeMX，新建工程选择你的STM32型号。我们将重点配置以下部分：
2.1 I2C接口配置
在"Pinout & Configuration"标签页中：
- 找到I2C1/I2C2（根据你的硬件连接）
- 设置模式为"I2C"
- 参数保持默认（标准模式100kHz足够）
关键技巧：点击SCL和SDA引脚，确保它们被正确映射到硬件引脚。有些STM32型号有多个I2C接口，选择未被其他功能占用的。
2.2 GPIO配置
虽然CubeMX会自动配置I2C相关GPIO，但我们还需要：
- 为模块的INT引脚配置一个GPIO输入（如果有中断需求）
- 配置一个USART用于调试输出
2.3 时钟树配置
MPU6050对时序要求不高，但合理的时钟配置能让系统更稳定：
// 典型配置示例（STM32F103C8T6） HCLK = 72MHz PCLK1 = 36MHz I2C时钟源选择PCLK1生成工程前，务必在"Project Manager"中：
- 设置工程名称和位置
- 选择IDE类型（MDK-ARM等）
- 勾选"Generate peripheral initialization as a pair of .c/.h files"
3. 驱动代码移植与优化
CubeMX生成的代码已经完成了底层初始化，我们只需添加MPU6050的驱动逻辑。以下是核心功能实现：
3.1 设备初始化函数
uint8_t MPU6050_Init(I2C_HandleTypeDef *hi2c) { uint8_t check; uint8_t Data; // 检查设备ID HAL_I2C_Mem_Read(hi2c, MPU6050_ADDR, WHO_AM_I_REG, 1, &check, 1, 100); if(check != 0x68) return 1; // 不是MPU6050 // 唤醒设备，设置时钟源 Data = 0x00; HAL_I2C_Mem_Write(hi2c, MPU6050_ADDR, PWR_MGMT_1_REG, 1, &Data, 1, 100); // 设置陀螺仪量程 ±2000°/s Data = 0x18; HAL_I2C_Mem_Write(hi2c, MPU6050_ADDR, GYRO_CONFIG_REG, 1, &Data, 1, 100); // 设置加速度计量程 ±8g Data = 0x10; HAL_I2C_Mem_Write(hi2c, MPU6050_ADDR, ACCEL_CONFIG_REG, 1, &Data, 1, 100); // 设置低通滤波器带宽 44Hz Data = 0x03; HAL_I2C_Mem_Write(hi2c, MPU6050_ADDR, CONFIG_REG, 1, &Data, 1, 100); return 0; }3.2 数据读取函数
void MPU6050_Read_Accel(I2C_HandleTypeDef *hi2c, MPU6050_Data *Data) { uint8_t Rec_Data[6]; // 读取加速度计原始数据 HAL_I2C_Mem_Read(hi2c, MPU6050_ADDR, ACCEL_XOUT_H_REG, 1, Rec_Data, 6, 100); // 数据转换 Data->Accel_X_RAW = (int16_t)(Rec_Data[0] << 8 | Rec_Data[1]); Data->Accel_Y_RAW = (int16_t)(Rec_Data[2] << 8 | Rec_Data[3]); Data->Accel_Z_RAW = (int16_t)(Rec_Data[4] << 8 | Rec_Data[5]); // 转换为g值（根据设置的量程） Data->Ax = Data->Accel_X_RAW / 4096.0; Data->Ay = Data->Accel_Y_RAW / 4096.0; Data->Az = Data->Accel_Z_RAW / 4096.0; }注意：原始数据是有符号16位整数，需要先进行类型转换。不同量程对应的灵敏度值不同，上述代码适用于±8g设置。
4. 数据校准与姿态解算
原始数据往往包含误差，校准是提高精度的关键步骤。
4.1 加速度计校准
校准流程：
- 将模块水平静止放置
- 采集100组数据取平均值
- 计算各轴偏移量
- 在后续读数中减去偏移量
// 简易校准函数 void MPU6050_Calibrate_Accel(I2C_HandleTypeDef *hi2c, float *offsets) { int32_t sum[3] = {0}; MPU6050_Data data; for(int i=0; i<100; i++) { MPU6050_Read_Accel(hi2c, &data); sum[0] += data.Accel_X_RAW; sum[1] += data.Accel_Y_RAW; sum[2] += data.Accel_Z_RAW; HAL_Delay(10); } offsets[0] = sum[0] / 100.0; offsets[1] = sum[1] / 100.0; offsets[2] = sum[2] / 100.0 - 4096.0; // Z轴理论值应为1g }4.2 简单姿态计算
通过加速度计数据可以估算俯仰角(pitch)和横滚角(roll)：
void Calculate_Angles(MPU6050_Data *data, float *pitch, float *roll) { *roll = atan2(data->Ay,>