简介本资源是一套完整的STM32F1系列驱动ADXL345三轴加速度传感器GY291模块的嵌入式开发工程面向嵌入式初学者与STM32项目开发者解决I²C通信配置、传感器初始化、原始数据读取与单位换算等典型实践问题适用于运动检测、姿态识别、智能穿戴等场景。压缩包共76个文件含34个头文件.h定义寄存器映射与函数接口、31个源文件.c涵盖HAL库驱动、ADXL345底层读写、串口输出及系统时钟配置、2个启动文件.s以及Keil工程配置.uvprojx/.uvoptx、调试配置.dbgconf、编译输出.map/.lst等整体343KB结构规范便于理解外设驱动分层设计。已有3577人学习下载提供可直接编译运行的完整工程包含ADXL345寄存器配置逻辑、I²C引脚PB10/PB11适配、中断式/轮询式数据采集示例及加速度值转换为g单位的处理代码是掌握传感器驱动开发的实用入门范例。1. STM32驱动ADXL345GY291不是“接上线就能读数”而是要过I²C时序、寄存器配置、数据校准三道关你手里的GY291模块表面看只是个带SCL/SDA引脚的蓝色小板但实际它内部是ADI原厂ADXL345——一款支持±16g量程、13位分辨率、内置FIFO与中断逻辑的数字加速度计。STM32驱动它绝非简单调用HAL_I2C_Master_Transmit就完事I²C总线速率若设为400kHz却未校准GPIO时序会触发NACKINT1引脚若未正确配置为下降沿外部中断就收不到运动事件而原始LSB值不经过零偏补偿和灵敏度归一化输出的X/Y/Z数值在静止状态下就可能漂移±30mg以上。这个.zip包里通常包含Keil工程、初始化代码和基础读取函数但真正决定能否稳定获取有效加速度数据的是I²C通信可靠性、寄存器配置完整性、以及单位换算的物理意义对齐。适合正在做姿态检测、振动监测、跌倒报警或简易惯性导航的STM32开发者——尤其当你发现串口打印的数值忽大忽小、静止时基线跳变、或INT中断根本没触发时问题大概率不在硬件焊接而在驱动层的三个隐性环节。2. 从硬件连接到I²C底层时序为什么GY291在STM32上常报NACK或超时2.1 GY291与STM32的物理连接必须满足电平与上拉双重约束GY291模块默认使用3.3V供电其SCL/SDA引脚为开漏输出必须外接4.7kΩ上拉电阻至3.3V电源而非5V。常见错误是直接复用开发板已有的5V上拉电阻导致STM32 GPIO在开漏模式下无法将SDA拉低至低于0.3×VDD1.0V的逻辑低电平阈值I²C通信在ACK阶段即失败。同时ADXL345的CS引脚必须接高电平GY291模块已内部上拉否则芯片处于SPI模式而非I²C模式——这是很多初学者调试无响应的首要原因。提示用万用表二极管档测量GY291模块SCL/SDA引脚对GND的压降正常应为0.6~0.7VMOSFET导通压降若测得接近3.3V说明上拉失效或CS悬空。2.2 STM32 I²C时钟配置需匹配ADXL345的电气特性ADXL345支持标准模式100kHz和快速模式400kHz但其SCL上升时间要求≤300ns快速模式。STM32F103等经典型号的I²C外设在APB136MHz时若仅设置I2C_CCR寄存器为0x0074对应400kHz实际波形因GPIO驱动能力不足会出现上升沿缓慢导致从机拒绝应答。正确做法是在MX_I2C1_Init()中显式配置hi2c1.Init.ClockSpeed 100000;先用100kHz验证启用GPIO重映射并设置GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH;关键在HAL_I2C_MspInit()中添加__HAL_RCC_I2C1_CLK_ENABLE();后立即插入HAL_Delay(1);确保时钟稳定2.2.1 验证I²C通信是否真正建立的最小代码片段// 使用HAL库前先执行总线扫描 uint8_t addr_list[128]; uint8_t found_count 0; for(uint8_t addr 0x08; addr 0x78; addr) { if(HAL_I2C_IsDeviceReady(hi2c1, (uint16_t)(addr1), 2, 10) HAL_OK) { addr_list[found_count] addr; } } // 若addr_list中包含0x53ADXL345默认I²C地址说明物理连接与基础时序通过此代码必须在MX_I2C1_Init()之后、任何ADXL345寄存器操作之前执行。若返回0个地址优先检查上拉电阻与CS电平若仅返回0x53但后续读写失败则进入时序微调阶段。2.3 ADXL345的I²C地址与寄存器访问协议不可简化ADXL345的7位I²C地址为0x53ALT ADDRESS引脚接地时但所有寄存器读写必须遵循“先写地址再读数据”的复合传输流程。例如读取DATA_X00x32寄存器错误方式HAL_I2C_Master_Receive(hi2c1, 0xA6, buf, 2, 100)—— 直接发读命令从机无法知道要读哪个寄存器正确方式uint8_t reg_addr 0x32; // DATA_X0地址 uint8_t rx_buf[2]; HAL_I2C_Master_Transmit(hi2c1, 0xA6, reg_addr, 1, 100); // 先发送寄存器地址写操作 HAL_I2C_Master_Receive(hi2c1, 0xA7, rx_buf, 2, 100); // 再读取2字节读操作其中0xA6是0x531 | 0写0xA7是0x531 | 1读。HAL库不自动处理寄存器地址预置必须手动拆分为两次独立传输。3. 寄存器级初始化与数据解析避开ADXL345的三大配置陷阱3.1 必须按严格顺序写入的4个核心寄存器ADXL345上电后处于待机模式POWER_CTL[3]0且所有数据寄存器默认为0。以下寄存器必须按顺序写入缺一不可寄存器地址名称推荐值作用说明0x2DPOWER_CTL0x08置位bit3启动测量MEASURE1其他位清零0x31DATA_FORMAT0x08设置full resolution模式FULL_RES1此时灵敏度自动适配量程0x2CBW_RATE0x0A设定输出数据速率ODR100HzRATE1010b平衡功耗与响应速度0x2EINT_ENABLE0x00初始禁用所有中断避免未配置中断服务程序导致HardFault注意DATA_FORMAT若设为0x0010-bit模式则DATA_X0/1返回值需右移6位才得10位有效数据而0x08启用full resolution后13位数据直接拼接DATA_X0(低8位)DATA_X1(高5位)无需位移。3.2 读取加速度原始值的HAL封装函数及单位换算ADXL345的13位数据范围为-8192~8191对应±16g量程因此每LSB 16g / 8192 0.001953125g ≈ 1.95mg/LSB。但实际应用中需考虑零偏Zero-g Offsettypedef struct { int16_t x_raw, y_raw, z_raw; float x_g, y_g, z_g; } adxl345_data_t; void ADXL345_ReadXYZ(adxl345_data_t *data) { uint8_t tx_buf[1] {0x32}; // 从DATA_X0开始连续读6字节 uint8_t rx_buf[6]; HAL_I2C_Master_Transmit(hi2c1, 0xA6, tx_buf, 1, 100); HAL_I2C_Master_Receive(hi2c1, 0xA7, rx_buf, 6, 100); >// 中断服务中读取FIFO内有效样本数 uint8_t fifo_entries; HAL_I2C_Master_Transmit(hi2c1, 0xA6, (uint8_t[]){0x0F}, 1, 100); // FIFO_SRC寄存器地址0x0F HAL_I2C_Master_Receive(hi2c1, 0xA7, fifo_entries, 1, 100); fifo_entries 0x3F; // bit5:0为有效样本数此时每次中断最多可批量读取fifo_entries组XYZ数据将I²C事务次数从每样本3次降至每批1次。4. 实战级调试技巧用逻辑分析仪抓取I²C波形定位三类典型故障4.1 NACK故障的波形特征与修复路径当I²C总线上出现NACKSDA在第九个时钟周期保持高电平逻辑分析仪捕获到的典型波形为SCL有规则方波但SDA在某次传输的第9个CLK上升沿后未被从机拉低常见原因ADXL345未上电VCC无3.3V、CS引脚悬空芯片处于SPI模式、I²C地址错误发送了0x52而非0x534.1.1 快速排除法用示波器验证ADXL345供电与复位# 在STM32端执行前先用万用表确认 # 1. GY291模块VCC引脚对GND电压 3.3V ± 0.1V # 2. GY291模块GND引脚对STM32 GND连通性电阻1Ω # 3. ADXL345的RESET引脚GY291上标为RST接高电平内部上拉无需外接若VCC异常检查STM32的3.3V电源负载能力——GY291工作电流约140μA但若同时驱动OLED屏等大电流器件LDO可能压降过大。4.2 数据跳变的根源未关闭自检SELF_TEST与温度漂移ADXL345的BW_RATE寄存器bit7为SELF_TEST位若误置为1芯片会注入内部测试信号导致读数周期性突变。此外其灵敏度温漂系数为±0.1%/°C当环境温度变化10°C时16g量程下的满量程误差达±160mg。解决方案每次初始化后显式清除BW_RATE的bit7HAL_I2C_Mem_Write(hi2c1, 0xA6, 0x2C, 1, rate_val, 1, 100);rate_val0x0A在ADXL345_ReadXYZ()中加入温度补偿项需外接温度传感器// 假设TMP102测得温度为T℃ADXL345灵敏度基准值为1.0温漂系数0.001/℃ float temp_comp 1.0f (T - 25.0f) * 0.001f;>float pitch_deg 0.0f; int16_t x_arr[10], z_arr[10]; for(int i0; i10; i) { ADXL345_ReadXYZ(data); x_arr[i] data.x_raw; z_arr[i] data.z_raw; } // 中位数滤波略去排序代码 pitch_deg atan2f((float)x_med, (float)z_med) * 57.2958f;5.2 振动频谱分析的最小可行实现利用ADXL345的100Hz ODR可对0~50Hz机械振动进行奈奎斯特采样。关键步骤开启FIFO并设置FIFO_CTL0x9FTrigger模式水位32在中断中批量读取32组数据存入环形缓冲区调用CMSIS-DSP库的arm_rfft_fast_f32()执行32点实数FFT计算幅值谱mag[k] sqrtf(real[k]^2 imag[k]^2)5.2.1 FFT结果频率轴映射表ODR100HzFFT Bin对应频率(Hz)物理意义00直流分量零偏13.125主频成分如电机50Hz26.252倍频.........1650奈奎斯特频率上限此时若在Bin515.625Hz处出现峰值可判定设备存在15.6Hz的共振频率——这比单纯看加速度幅值更能定位机械故障源。5.3 低功耗场景下的动态ODR切换策略ADXL345支持按需调整ODR以节省功耗。例如在智能台灯跌倒检测中静态时加速度模长0.95gBW_RATE0x01ODR3.125Hz功耗30μA动态时模长突变0.2g/100msBW_RATE0x0AODR100Hz功耗140μA实现代码需在ADXL345_ReadXYZ()后立即计算float acc_mag sqrtf(data-x_g*data-x_g style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;" />