环境 #

• Win10系统
• STM32CubeMX v6.5.0
• STM32CubeIDE v1.18.0
• MCU：STM32F103C6

操作步骤 #

• 通过STM32CubeMX或STM32CubeIDE新建项目
• 在「引脚配置」窗口配置USB用于数据传输
• 在「中间件>USB_DEVICE」选项卡选择VPC模式，其余保持默认设置
• 时钟配置为使用8MHz外部振荡器，完成时钟树设置
• 代码生成设置中启用「Generate peripheral initialization as a pair of [...]」选项

问题现象 #

代码生成后，USB的D+（PA11）和D-（PA12）引脚未完成配置，无上下拉电阻设置、未配置复用功能等，相关代码如下：

void HAL_PCD_MspInit(PCD_HandleTypeDef* pcdHandle) {
  if (pcdHandle->Instance == USB) {
    /* USER CODE BEGIN USB_MspInit 0 */
    /* USER CODE END USB_MspInit 0 */
    __HAL_RCC_USB_CLK_ENABLE(); // Enable USB clock
    HAL_NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(USB_LP_CAN1_RX0_IRQn);
    /* USER CODE BEGIN USB_MspInit 1 */
    /* USER CODE END USB_MspInit 1 */
  }
}

void MX_GPIO_Init(void) {
  __HAL_RCC_GPIOC_CLK_ENABLE();
  __HAL_RCC_GPIOD_CLK_ENABLE();
  __HAL_RCC_GPIOA_CLK_ENABLE(); 
}

其他外设（如定时器）代码生成正常。

已尝试方案 #

• 重装软件
• 登录ST账号
• 测试不同USB工作模式

问询 #

为何已在CubeMX中选择USB_DEVICE，PA11和PA12引脚仍未配置？

针对STM32F103C6的USB引脚配置问题，核心原因源于该系列MCU的硬件特性及CubeMX的代码生成逻辑：

1. 专用复用引脚的硬件绑定
   STM32F103C6的USB D+（PA11）、D-（PA12）属于硬件固定复用引脚，其复用功能由硬件电路直接绑定，无需通过GPIO寄存器手动配置复用位。CubeMX会省略这部分冗余配置代码，因为硬件默认已关联USB功能。

2. 内部上拉电阻的自动启用
   USB外设模式下，D+引脚内部自带的1.5K上拉电阻会被硬件自动激活，无需手动配置GPIO上下拉参数。这是STM32F1系列USB模块的原生设计，因此CubeMX不会生成额外的上下拉配置代码。

3. CubeMX的代码生成逻辑
   对于这类硬件固定功能的引脚，CubeMX仅保留必要的时钟使能（代码中已启用GPIOA时钟）和USB外设的时钟、中断配置。如果需要自定义引脚参数（比如调试场景），可在USER CODE BEGIN USB_MspInit 1区域手动添加初始化代码，示例如下：

/* USER CODE BEGIN USB_MspInit 1 */
GPIO_InitTypeDef GPIO_InitStruct = {0};
// 配置PA11、PA12为复用推挽输出
GPIO_InitStruct.Pin = GPIO_PIN_11 | GPIO_PIN_12;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
/* USER CODE END USB_MspInit 1 */

4. VPC模式无影响
   VPC（Virtual Port Com）模式本身不会改变引脚配置逻辑，问题本质还是STM32F1系列的硬件特性导致CubeMX不生成冗余的GPIO配置代码。

内容的提问来源于stack exchange，提问作者Osiris74