简介本资源是一份面向嵌入式开发工程师与BMS电池管理系统初学者的STM32S与TI BQ76952芯片SPI通信实战代码示例聚焦多节锂电组的电压、电流、温度实时监测及基础保护逻辑实现。项目以STM32S系列MCU为主控通过标准四线SPI接口MISO/MOSI/SCK/SS驱动BQ76952高精度电池监视IC涵盖外设初始化、寄存器读写、中断响应及关键保护判据等核心环节适用于电动工具、储能模块、便携设备等对电池安全有严苛要求的场景。压缩包共4个文件138KB含1个主程序C源码main_STM32_SPI.c、1个头文件BQ769x2Header.h封装寄存器定义与通信宏以及2份PDF文档README.pdf说明使用流程ImportantNotice.pdf强调硬件连接与配置要点。目前已有1013人学习下载读者可直接复用SPI驱动框架、快速理解BQ76952寄存器映射关系并基于该结构扩展均衡控制或SOC估算功能。1. STM32 BQ76952 用 SPI 通信不是“接上线就能读数”而是要绕过寄存器映射陷阱、时序容限和芯片唤醒三重关卡你手头有一块 STM32F103 或 STM32G0 系列开发板焊好了 BQ76952 电池监视器支持 16 节串联锂电SPI 线也按 datasheet 接了PA4NSS、PA5SCK、PA6MISO、PA7MOSI——但HAL_SPI_TransmitReceive()返回 HAL_OKBQ76952_ReadRegister(0x00)却始终返回 0x00 或 0xFF。这不是代码写错了而是 BQ76952 的 SPI 接口根本不兼容标准 SPI 模式它要求 SCK 空闲电平为高CPOL1采样沿在第二个边沿CPHA1且 NSS 必须由软件精确控制——硬件 NSS 在某些 STM32 型号上会触发意外复位。更关键的是BQ76952 上电后默认处于休眠状态SPI 总线空闲时它根本不响应任何命令。网上搜到的“STM32 SPI 示例代码”大多直接套用 HAL 库默认配置结果就是“没反应啊”——这正是当前技术社区里高频提问的真实痛点。本文不讲理论堆砌只聚焦如何用最小可验证代码在 STM32CubeMX HAL 库环境下让 BQ76952 真正吐出电池电压、温度、SOC 等有效数据。适合已能点亮 LED、熟悉 GPIO 和 UART 的中级嵌入式开发者也包含对error: no STM32 target found!类调试失败的定位路径。2. 配置 STM32 的 SPI 外设必须关闭硬件 NSS、手动拉低片选、并强制 CPOL1/CPHA1BQ76952 的 SPI 协议与标准 SPI 存在关键差异其时钟极性CPOL为 1空闲时 SCK高电平时钟相位CPHA为 1数据在第二个边沿采样且片选信号CS必须在发送前至少 100ns 拉低传输结束后保持低电平至少 50ns 才能释放。STM32 的硬件 NSS由 SPI 外设自动控制在某些型号如 F103上会因内部逻辑导致 CS 时序抖动引发 BQ76952 误判为非法帧而丢弃后续数据。因此必须禁用硬件 NSS改用 GPIO 软件控制。以下以 STM32F103C8T6常见蓝 pill 板为例使用 STM32CubeMX 5.6.1 HAL 库 v1.8.4 实现。2.1 CubeMX 中的关键配置步骤打开 CubeMX选择芯片后执行以下操作RCC 设置HSE 为 8MHz外部晶振系统时钟配置为 72MHzPLL x9。GPIO 设置将 PA4 配置为GPIO_Output用户标签设为BQ76952_CSPA5/PA6/PA7 分别配置为SPI1_SCK/SPI1_MISO/SPI1_MOSI。SPI1 设置Mode:Full-Duplex MasterHardware NSS:Disabled此项必须取消勾选Prescaler:PCLK2/4 18MHz对应 SCK 频率 ≤ 10MHzBQ76952 最高支持 10MHzClock Phase (CPHA):Second EdgeClock Polarity (CPOL):HighData Size:8 BitsFrame Format:Motorola非 TI 模式CRC Calculation:Disabled生成代码前检查确认SPI1_Init()函数中hs-Init.NSS字段为SPI_NSS_SOFT且hs-Init.CRCPolynomial为 0。提示若生成代码后SPI1_Init()中hs-Init.NSS仍为SPI_NSS_HARD说明 CubeMX 版本存在 bug需手动修改MX_SPI1_Init()函数内hi2c1.Init.NSS SPI_NSS_SOFT;并删除SPI_NSS_HARD相关行。2.2 初始化 BQ76952 的关键时序与寄存器操作BQ76952 上电后处于SLEEP模式需通过写入DEVICE_CFG寄存器地址 0x01的EN_SLEEP位为 0 来唤醒。但首次写入前必须先发送一个“唤醒脉冲”将 CS 拉低 ≥ 100μs再拉高 ≥ 100μs然后立即拉低进入正式通信。以下是完整的初始化函数#include bq76952.h // 自定义头文件声明函数原型 // 全局变量用于记录 BQ76952 状态 static uint8_t bq76952_is_awake 0; // 唤醒 BQ76952发送专用唤醒序列 static void BQ76952_Wakeup(void) { HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET); HAL_Delay(1); // ≥100μsHAL_Delay(1) 在 72MHz 下足够 HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_SET); HAL_Delay(1); HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET); } // 写单个寄存器8位地址 8位数据 HAL_StatusTypeDef BQ76952_WriteRegister(uint8_t reg_addr, uint8_t data) { uint8_t tx_buf[2] {reg_addr, data}; HAL_StatusTypeDef ret; // 确保 CS 已拉低 HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET); // 发送地址数据超时设为 10ms ret HAL_SPI_Transmit(hspi1, tx_buf, 2, 10); // 严格满足 CS 保持时间传输后保持低电平 ≥50ns再拉高 __NOP(); __NOP(); // 插入空指令确保时序 HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_SET); return ret; } // 读单个寄存器发送地址接收1字节 HAL_StatusTypeDef BQ76952_ReadRegister(uint8_t reg_addr, uint8_t *data) { uint8_t tx_buf[1] {reg_addr | 0x80}; // 读操作地址最高位置1 uint8_t rx_buf[1] {0}; HAL_StatusTypeDef ret; HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET); ret HAL_SPI_TransmitReceive(hspi1, tx_buf, rx_buf, 1, 10); __NOP(); __NOP(); HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_SET); if (ret HAL_OK) { *data rx_buf[0]; } return ret; } // 初始化函数唤醒 配置 DEVICE_CFG void BQ76952_Init(void) { // 第一步发送唤醒序列 BQ76952_Wakeup(); // 第二步写 DEVICE_CFG 寄存器0x01关闭睡眠模式 // 默认值为 0x00需清除 bit0EN_SLEEP BQ76952_WriteRegister(0x01, 0xFE); // 0xFE 0b11111110 // 第三步验证是否成功读回 DEVICE_CFG uint8_t cfg_val 0; BQ76952_ReadRegister(0x01, cfg_val); if ((cfg_val 0x01) 0) { bq76952_is_awake 1; } }2.2.1 关键参数说明与常见失败原因参数/操作正确值错误示例后果CPOL/CPHACPOL1, CPHA1CPOL0, CPHA0默认BQ76952 无法识别 SCK 边沿返回全 0xFFNSS 控制GPIO 软件拉低SPI_NSS_HARDCS 时序抖动BQ76952 丢帧或锁死唤醒序列CS↓≥100μs → CS↑≥100μs → CS↓省略唤醒或延时不足DEVICE_CFG写入失败芯片持续休眠读地址格式reg_addr0x80直接传reg_addrSPI 速率≤10MHz推荐 2–5MHz10MHz时序违规通信不稳定注意HAL_Delay(1)在 72MHz 系统时钟下实际延时约 1.1ms远超 100μs 要求安全冗余。若需更高精度可用HAL_GPIO_WritePin()__NOP()组合但对唤醒序列而言毫秒级延时完全可接受。3. 解析 BQ76952 的核心寄存器从 Cell Voltage 到 Temperature 的完整读取链BQ76952 的寄存器空间并非线性排列而是分页管理Page 0–3且多数电池参数需通过“命令寄存器”触发 ADC 采集后才能读取。例如单体电压Cell Voltage存储在 Page 0 的CELL1_VOLTAGE0x0D至CELL16_VOLTAGE0x1C共 16 个寄存器中但这些值只有在 ADC 完成转换后才更新。因此不能直接读取必须先写ADC_CTRL10x5A启动转换再轮询STATUS0x00寄存器的ADC_CONV_DONE位bit 6。以下是可直接集成到main()中的完整读取流程3.1 启动 ADC 转换并等待完成BQ76952 的 ADC 控制寄存器ADC_CTRL10x5A是一个 16 位寄存器其中 bit15–bit12 选择转换类型0x8 Cell Voltagebit11–bit8 选择通道数0xF 全部 16 节。写入后需等待STATUS寄存器 bit6 置 1// 启动单体电压 ADC 转换 HAL_StatusTypeDef BQ76952_StartCellVoltageConversion(void) { uint8_t tx_buf[3] {0x5A, 0x80, 0xF0}; // 地址 0x5A 数据高字节 0x80 低字节 0xF0 return HAL_SPI_Transmit(hspi1, tx_buf, 3, 10); } // 检查 ADC 转换是否完成 uint8_t BQ76952_IsADCReady(void) { uint8_t status 0; BQ76952_ReadRegister(0x00, status); return (status 0x40) ? 1 : 0; // bit6 0x40 } // 等待 ADC 完成超时 100ms uint8_t BQ76952_WaitForADCReady(void) { uint32_t timeout 0; while (!BQ76952_IsADCReady()) { HAL_Delay(1); if (timeout 100) return 0; // 超时返回失败 } return 1; }3.2 读取 16 节电池电压并转换为 mV单体电压寄存器为 16 位但 BQ76952 采用 MSB 在前、LSB 在后的顺序即先发高字节。CELL1_VOLTAGE0x0D地址对应第 1 节电池每节占 2 字节地址递增。读取后需左移 4 位因低 4 位为小数位再乘以 LSB 值1.25mV// 读取指定电池编号的电压1–16 uint16_t BQ76952_ReadCellVoltage(uint8_t cell_num) { if (cell_num 1 || cell_num 16) return 0; uint8_t reg_addr 0x0D (cell_num - 1) * 2; // CELL10x0D, CELL20x0F... uint8_t rx_buf[2] {0}; // 发送读地址带读标志 uint8_t tx_addr reg_addr | 0x80; HAL_SPI_TransmitReceive(hspi1, tx_addr, rx_buf, 1, 10); // 读取高字节和低字节 HAL_SPI_TransmitReceive(hspi1, tx_addr, rx_buf, 1, 10); // 实际需两次 TransmitReceive此处简化 // 正确做法用 3 字节传输地址dummydummy或分两次读 // 更可靠的方式一次性读 2 字节需修改底层驱动 // 此处提供简化版假设已获取 rx_buf[0]MSB, rx_buf[1]LSB uint16_t raw_val ((uint16_t)rx_buf[0] 8) | rx_buf[1]; return (raw_val 4) * 125; // 右移 4 位去小数*125 得 mV1.25mV/LSB } // 批量读取所有 16 节电压 void BQ76952_ReadAllCellVoltages(uint16_t voltages[16]) { BQ76952_StartCellVoltageConversion(); if (BQ76952_WaitForADCReady()) { for (uint8_t i 0; i 16; i) { voltages[i] BQ76952_ReadCellVoltage(i 1); } } }3.2.1 温度与 SOC 的读取差异点温度需读TEMP1_MSB0x20和TEMP1_LSB0x21计算公式为(MSB8 | LSB) * 0.0625°C注意 BQ76952 内部温度传感器精度为 ±2°C。SOCState of ChargeBQ76952 不直接输出 SOC需读PACK_SOC0x3A寄存器16 位其值为 0–10000代表 0.01% 精度即PACK_SOC / 100.0得百分比。该值依赖库仑计数需先启用GAUGE_EN位DEVICE_CFG的 bit7。提示PACK_SOC的准确性高度依赖电流检测电阻RSENSE的标定。若未校准读出的 SOC 可能漂移。校准方法为满充后写0x01到FULL_CHARGE寄存器0x3B放电至截止电压后写0x00到EMPTY_CHARGE0x3C。4. 排查“SPI 通信没反应”的五大硬核定位法从示波器抓波形到寄存器快照当BQ76952_ReadRegister(0x00, val)返回val0x00或0xFF且HAL_SPI_GetError(hspi1)为HAL_SPI_ERROR_NONE时问题必然出在物理层或协议层。以下是按优先级排序的现场排查步骤无需额外工具即可完成前三步4.1 第一步用万用表验证 CS 电平跳变与时序断开 STM32 与 BQ76952 的 SCK/MISO/MOSI 线仅保留 CS 线。在BQ76952_Wakeup()函数中插入HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET);后加while(1);烧录程序。用万用表直流档测 CS 引脚正常应显示 0V低电平若为 3.3V检查 GPIO 初始化是否执行MX_GPIO_Init()是否被调用、BQ76952_CS_Pin定义是否匹配实际引脚若电压在 0V 和 3.3V 间缓慢变化如 1.5V说明 GPIO 模式错误配置成了Open-Drain或Alternate Function未正确设置。4.2 第二步用逻辑分析仪捕获 SCK 和 MOSI 波形若条件允许将 Saleae Logic 16 或类似设备接入 SCK 和 MOSI触发条件设为SCK rising edge捕获BQ76952_WriteRegister(0x01, 0xFE)的波形正常波形应显示SCK 空闲为高电平MOSI 在 SCK 第二个下降沿CPHA1稳定输出0x01和0xFE若 MOSI 全为高电平0xFF检查hspi1.Init.Direction是否为SPI_DIRECTION_2LINESHAL_SPI_Transmit()的Size参数是否为 2若 SCK 无波形检查hspi1.Instance是否指向正确的 SPI 外设如SPI1__HAL_RCC_SPI1_CLK_ENABLE()是否执行。4.3 第三步强制读取 STATUS 寄存器并解析错误码BQ76952 的STATUS0x00寄存器不仅指示 ADC 状态其 bit0–bit3 还是故障码FAULT_CODE0x00无故障0x01过压OV0x02欠压UV0x04过温OT0x08短路SC0x10通信错误COMM_ERR——此值出现即表明 SPI 时序严重错误。在main()中添加诊断代码uint8_t status 0; BQ76952_ReadRegister(0x00, status); printf(BQ76952 STATUS 0x%02X\r\n, status); if (status 0x10) { printf(SPI COMM_ERR! Check CPOL/CPHA and CS timing.\r\n); }4.4 第四步验证 BQ76952 供电与参考电压BQ76952 的 VDD3.3V和 VREF内部 2.5V 基准必须稳定。用示波器测 VREF 引脚正常应为 2.5V ± 0.1V 直流若为 0V检查VREF引脚是否悬空需外接 100nF 电容到地若为 3.3V说明内部基准未启用需确认DEVICE_CFG的EN_VREF位bit6是否为 1写0x40到 0x01。4.5 第五步交叉验证——用 I2C 替代 SPI 快速定位芯片健康状态虽然标题要求 SPI但 I2C 是 BQ76952 的备用接口地址 0x08且协议更简单。若 SPI 无法通信可临时改用 I2C将 PB6/PB7 接 I2CBQ76952_CS改为PB8I2C 的 SMBSUS调用HAL_I2C_Mem_Read()读0x00若返回有效STATUS则证明芯片本身正常问题纯属 SPI 配置若 I2C 也失败则检查焊接虚焊、电源纹波或芯片是否损坏BQ76952 的 ESD 敏感度达 ±2kV。5. 优化 SPI 通信效率用 DMA 批量读取 寄存器缓存避免重复访问BQ76952 的寄存器读取耗时显著单次HAL_SPI_TransmitReceive()约 200μs若每 100ms 读取全部 16 节电压温度SOCCPU 占用率将超 30%。通过 DMA 批量传输和本地缓存可将单次采集耗时压缩至 80μs 以内并释放 CPU 处理其他任务。5.1 使用 SPI DMA 一次性读取连续寄存器BQ76952 支持连续地址读取发送起始地址如0x0D | 0x80随后 MISO 自动输出后续寄存器值。利用 STM32 的 SPI RX DMA可一次读取 32 字节16 节电压 × 2 字节// 全局 DMA 缓冲区 uint8_t dma_rx_buffer[32]; // 初始化 DMA在 MX_SPI1_Init() 后调用 void BQ76952_DMA_Init(void) { __HAL_SPI_DISABLE(hspi1); HAL_SPIEx_FlushRxFifo(hspi1); // 清空 FIFO __HAL_SPI_ENABLE(hspi1); // 配置 RX DMA从 SPI1_RX 到 dma_rx_buffer hdma_spi1_rx.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_spi1_rx.Init.PeriphInc DMA_PINC_DISABLE; hdma_spi1_rx.Init.MemInc DMA_MINC_ENABLE; hdma_spi1_rx.Init.PeriphDataAlignment DMA_PDATAALIGN_BYTE; hdma_spi1_rx.Init.MemDataAlignment DMA_MDATAALIGN_BYTE; hdma_spi1_rx.Init.Mode DMA_NORMAL; HAL_DMA_Init(hdma_spi1_rx); __HAL_LINKDMA(hspi1, hdmarx, hdma_spi1_rx); } // DMA 方式读取全部 Cell Voltage void BQ76952_ReadCellVoltageDMA(void) { uint8_t tx_addr 0x0D | 0x80; // CELL1_VOLTAGE 起始地址 // 启动 ADC 转换 BQ76952_StartCellVoltageConversion(); BQ76952_WaitForADCReady(); // 拉低 CS发送地址 HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, tx_addr, 1, 10); // 启动 DMA 接收 32 字节 HAL_SPI_Receive_DMA(hspi1, dma_rx_buffer, 32); // 等待 DMA 完成或使用回调函数 HAL_DMA_PollForTransfer(hdma_spi1_rx, HAL_DMA_FULL_TRANSFER, 10); // 释放 CS HAL_GPIO_WritePin(BQ76952_CS_GPIO_Port, BQ76952_CS_Pin, GPIO_PIN_SET); }5.2 构建寄存器缓存层减少总线访问为避免频繁读取STATUS或DEVICE_CFG在 RAM 中维护一份镜像typedef struct { uint8_t status; uint8_t device_cfg; uint16_t cell_voltages[16]; int16_t temperature; uint16_t pack_soc; } BQ76952_Cache_t; static BQ76952_Cache_t bq_cache {0}; // 更新缓存在每次完整采集后调用 void BQ76952_UpdateCache(void) { BQ76952_ReadRegister(0x00, bq_cache.status); BQ76952_ReadRegister(0x01, bq_cache.device_cfg); // 从 DMA 缓冲区解析电压 for (int i 0; i 16; i) { uint16_t raw ((uint16_t)dma_rx_buffer[i*2] 8) | dma_rx_buffer[i*21]; bq_cache.cell_voltages[i] (raw 4) * 125; } // 读取温度TEMP1_MSB/LSB BQ76952_ReadRegister(0x20, (uint8_t*)bq_cache.temperature); BQ76952_ReadRegister(0x21, (uint8_t*)bq_cache.temperature 1); bq_cache.temperature (bq_cache.temperature * 625) / 10000; // 转为整数 °C // 读取 SOC BQ76952_ReadRegister(0x3A, (uint8_t*)bq_cache.pack_soc); BQ76952_ReadRegister(0x3B, (uint8_t*)bq_cache.pack_soc 1); }5.2.1 缓存策略的边界条件处理场景缓存行为依据STATUS的COMM_ERRbit4置位立即清空缓存强制重新初始化避免使用错误数据device_cfg的EN_SLEEP位被意外置 1触发BQ76952_Wakeup()并重写DEVICE_CFG防止芯片进入休眠连续 3 次BQ76952_ReadCellVoltageDMA()失败切换回 polling 模式启用HAL_SPI_ErrorCallback日志DMA 硬件故障降级处理提示BQ76952_UpdateCache()应在HAL_SPI_RxCpltCallback()中调用而非主循环确保数据一致性。若使用 FreeRTOS可将缓存结构体声明为static volatile并在任务中通过xQueueSend()向处理任务投递更新事件。本文还有配套的精品资源点击获取