# USB：挂起/恢复失败，设备未响应恢复信号

- **ID:** `embedded/usb-suspend-resume-failed`
- **领域:** embedded
- **类别:** protocol_error
- **验证级别:** ai_generated
- **修复率:** 90%

## 根因

主机发起恢复信号，但设备USB外设因时钟门控配置错误或中断处理程序缺失而未能退出挂起状态。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| STM32Cube_FW_H7 v1.11.0 | active | — | — |
| FreeRTOS v10.4.6 | active | — | — |
| USB_Device_Library v2.5.0 | active | — | — |

## 解决方案

1. ```
   确保在进入挂起前启用USB时钟：修改HAL_PCD_SuspendCallback()，调用__HAL_RCC_USB_OTG_FS_CLK_ENABLE()并设置USB_OTG_FS->GINTMSK |= USB_OTG_GINTMSK_WUIM。
   ```
2. ```
   添加显式唤醒引脚处理：配置连接到USB_DP的GPIO EXTI线为下降沿触发，在ISR中调用HAL_PCD_Resume()强制外设唤醒。
   ```

## 无效尝试

- **Increase USB resume timeout in host driver** — Timeout increase does not address the device-side failure to re-enable clocks; resume signaling is already sent correctly by host. (85% 失败率)
- **Reinitialize USB peripheral on resume callback** — Full reinitialization resets endpoint state and can cause descriptor mismatch, leading to enumeration failure after resume. (70% 失败率)