STM32F411CEU6开发板HAL_RCC_OscConfig持续返回HAL_TIMEOUT问题求助

我正在配置搭载STM32F411CEU6芯片的开发板，该板配备25MHz HSE和32.768KHz LSE两颗晶振。使用CubeMX生成不同配置的代码编译后，HAL_RCC_OscConfig()始终返回HAL_TIMEOUT。已尝试以下操作但均无效：

• 延长超时时间至1000ms
• 将系统时钟从100MHz降至96MHz、72MHz和50MHz
• 禁用LSE晶振

当前SystemClock_Config函数代码 #

void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Configure the main internal regulator output voltage
  */
  __HAL_RCC_PWR_CLK_ENABLE();
  __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
  RCC_OscInitStruct.PLL.PLLM = 25;
  RCC_OscInitStruct.PLL.PLLN = 200;
  RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
  RCC_OscInitStruct.PLL.PLLQ = 9;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }

  /** Initializes the CPU, AHB and APB buses clocks
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_3) != HAL_OK)
  {
    Error_Handler();
  }
}

排查建议 #

1. 硬件检查优先 #

• 确认25MHz晶振的匹配电容参数（通常为10~22pF），虚焊、参数错误或电容缺失会直接导致HSE起振失败
• 检查HSE引脚（PH0/PH1）的焊接质量，排查短路、断路或引脚接触不良问题
• 用示波器测量HSE引脚波形，确认晶振是否正常起振

2. CubeMX配置校验 #

• 确认CubeMX中HSE模式选择为外部晶振，而非外部时钟旁路（旁路模式需要外部时钟输入，不适用晶振）
• 核对PLL参数是否符合STM32F411规格：
  • PLLM=25，25MHz/25=1MHz，符合1~2MHz的输入要求
  • PLLN=200、PLLP=2，最终系统时钟100MHz，未超过F411的最大主频限制
  • PLLQ=9在2~15的合法范围内
• 检查是否开启了时钟安全系统（CSS），若开启，HSE故障会触发复位，可能导致超时假象

3. 代码分步调试 #

• 在调用HAL_RCC_OscConfig()前添加10~20ms延时，给晶振足够的起振时间
• 拆分初始化步骤，单独初始化HSE再初始化PLL，定位故障点：

  // 先初始化HSE
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_OFF;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) {
    Error_Handler();
  }
  // 再初始化PLL
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_PLL;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
  RCC_OscInitStruct.PLL.PLLM = 25;
  RCC_OscInitStruct.PLL.PLLN = 200;
  RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
  RCC_OscInitStruct.PLL.PLLQ = 9;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) {
    Error_Handler();
  }
  

• 检查Error_Handler()的实现，避免因无限循环或复位导致无法定位问题

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