STM32H5 PB14意外拉低？UCPD Dead Battery功能是 “元凶”，2 步彻底解决

STM32H5（如 H523RET6）中 PB14 引脚被意外拉低，核心原因是UCPD 外设的 Dead Battery（DB）功能默认激活——PC9（复用为 UCPD1_DBCC2）检测到 > 1V 电平时，会触发 PB14（复用为 UCPD1_CC2）内置 Rd 下拉电阻，导致其电平被拉低。解决方案：软件禁用 DB 功能 + 硬件优化，即可释放 PB14/PC9 作为普通 GPIO 使用。

资料获取：经验分享 | STM32H5的PB14引脚被意外拉低的问题解析_v1.0

1. 问题现象：GPIO 配置引发的诡异电平异常

1.1 配置场景

PC9：普通 GPIO 输出模式，内部下拉；
PB14：普通 GPIO 输入模式，内部上拉；
核心操作：程序中让 PC9 输出高电平。

1.2 异常表现

PC9 输出低电平时：PB14 为高电平（符合预期）；
PC9 输出高电平时：PB14 电平被拉低（不符合预期）；
复现性：使用 NUCLEO-H533RE 板，按上述配置可 100% 复现。

2. 问题根源：UCPD DB 功能的隐性影响

2.1 引脚复用关系

STM32H5 的 PC9 和 PB14 默认复用为 UCPD 外设引脚，这是问题的核心前提：

GPIO 引脚	复用功能	作用
PC9	UCPD1_DBCC2	Dead Battery 检测引脚
PB14	UCPD1_CC2	USB Type-C CC 线引脚

3. 解决方案：软件 + 硬件双管齐下（简单易落地）

3.1 软件层面：禁用 UCPD DB 功能（核心步骤）

在HAL_MspInit函数中添加禁用 DB 功能的代码，释放 GPIO 控制权，这是最关键的一步：

void HAL_MspInit(void) {
  /* USER CODE BEGIN MspInit 0 */
  /* USER CODE END MspInit 0 */

  /* 系统中断初始化（原有代码） */

  /* USER CODE BEGIN MspInit 1 */
  // 禁用UCPD的Dead Battery功能，释放PB14/PC9为普通GPIO
  HAL_PWREx_DisableUCPDDeadBattery();
  /* USER CODE END MspInit 1 */
}

原理：通过 HAL 库函数关闭 DB 功能，PB14 的内置 Rd 电阻不再被激活，恢复普通 GPIO 的上拉 / 下拉配置；

兼容性：该函数适用于所有 STM32H5 系列，无需修改其他配置。

3.2 硬件层面：优化 PC9 引脚设计（可选，避免意外触发）

若 PC9 仅作为普通 GPIO 使用，建议在外部添加 100KΩ 下拉电阻：

作用：确保 PC9 未输出时电平稳定，避免因外部干扰导致电平 > 1V，意外激活 DB 功能；

电路参考：PC9 引脚通过 100KΩ 电阻接地，不影响其作为输出 GPIO 的正常功能。

3.3 补充说明：CubeMX 配置差异

STM32G0 系列：CubeMX 中已提供 “关闭 UCPD Dead Battery” 的可视化配置选项；

STM32H5 系列：当前 CubeMX 版本（如 v6.13.0）暂未添加该选项，需手动通过代码禁用，后续版本会更新。

4. 验证结果

执行软件禁用 DB 功能后，PC9 输出高电平时，PB14 保持内部上拉的高电平，无被拉低现象；

硬件添加下拉电阻后，PC9 的电平稳定性提升，进一步避免 DB 功能意外激活。

STM32H5 PB14 意外拉低的核心是 “UCPD DB 功能默认激活”，与 GPIO 配置本身无关。解决思路的关键是 “关闭隐性干扰功能”：软件禁用 DB 功能即可彻底解决，硬件优化可作为补充，确保长期稳定性。该问题在 STM32H5 系列中普遍存在，尤其当 PC9/PB14 作为普通 GPIO 使用时，需优先执行软件禁用操作。