Detailed Explanation of STM32 HAL Library Clock System

 The STM32 HAL (Hardware Abstraction Layer) Library provides a structured way to configure and manage the clock system in STM32 microcontrollers. The clock system is crucial because it determines the speed at which the CPU, peripherals, and buses operate. This guide explains the HAL clock initialization process, clock tree, and configuration methods.

---

1. STM32 Clock Tree Overview

The STM32 clock system is highly flexible, allowing multiple clock sources and distribution paths. The main components are:

A. Clock Sources

Source	Description	Typical Use
HSI (High-Speed Internal)	8-16 MHz RC oscillator (low accuracy, no external component)	Fallback clock, default at startup
HSE (High-Speed External)	4-48 MHz crystal/oscillator (high accuracy)	Main system clock, PLL input
LSI (Low-Speed Internal)	~32 kHz RC oscillator (low power, low accuracy)	RTC, watchdog timer
LSE (Low-Speed External)	32.768 kHz crystal (high accuracy)	RTC, low-power modes

B. PLL (Phase-Locked Loop)

• Used to multiply the input clock (HSE/HSI) to higher frequencies.

• Example:

  • HSE (8 MHz) → PLL → 72 MHz SYSCLK (STM32F1).

  • HSI (16 MHz) → PLL → 168 MHz SYSCLK (STM32F4).

C. Clock Distribution

• SYSCLK → Main system clock (CPU, memory, buses).

• HCLK (AHB bus) → Cortex core, DMA, memory.

• PCLK1 (APB1 bus) → Low-speed peripherals (e.g., USART2, I2C1).

• PCLK2 (APB2 bus) → High-speed peripherals (e.g., SPI1, TIM1).

---

2. HAL Clock Configuration (STM32CubeMX & Manual Setup)

A. Using STM32CubeMX (Auto-generated Code)

1. Clock Configuration Tab:

   • Select HSE/HSI as the source.

   • Configure PLL multipliers & dividers.

   • Set AHB/APB prescalers (e.g., AHB = SYSCLK, APB1 = SYSCLK/2).

   • Enable peripheral clocks (e.g., GPIO, USART).

   

2. Generated Code (SystemClock_Config()):

   c

   void SystemClock_Config(void) {
     RCC_OscInitTypeDef RCC_OscInitStruct = {0};
     RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
   
     // Configure HSE & PLL
     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 = 8;   // Input divider (HSE=8MHz → 1MHz)
     RCC_OscInitStruct.PLL.PLLN = 72;  // Multiplier (1MHz → 72MHz)
     RCC_OscInitStruct.PLL.PLLP = 2;   // SYSCLK divider (72MHz → 72MHz)
     HAL_RCC_OscConfig(&RCC_OscInitStruct);
   
     // Configure AHB/APB 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;  // HCLK = SYSCLK (72MHz)
     RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;   // PCLK1 = HCLK/2 (36MHz)
     RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;    // PCLK2 = HCLK (72MHz)
     HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);
   }

B. Manual Configuration (Without CubeMX)

1. Enable HSE/HSI:

   c

   __HAL_RCC_HSE_ENABLE();  // Enable HSE
   while (!__HAL_RCC_GET_FLAG(RCC_FLAG_HSERDY)); // Wait for HSE ready

2. Configure PLL:

   c

   RCC->PLLCFGR = (8 << 0) | (72 << 6) | (1 << 16);  // PLLM=8, PLLN=72, PLLP=2
   __HAL_RCC_PLL_ENABLE();
   while (!__HAL_RCC_GET_FLAG(RCC_FLAG_PLLRDY));

3. Switch to PLL as SYSCLK:

   c

   RCC->CFGR |= RCC_CFGR_SW_PLL;  // Select PLL as system clock
   while ((RCC->CFGR & RCC_CFGR_SWS) != RCC_CFGR_SWS_PLL); // Wait for switch

---

3. Key HAL Clock Functions

Function	Description
HAL_RCC_OscConfig()	Configures HSE, HSI, PLL, LSE, LSI.
HAL_RCC_ClockConfig()	Sets SYSCLK, HCLK, PCLK1, PCLK2 dividers.
HAL_RCC_GetSysClockFreq()	Returns SYSCLK frequency (in Hz).
HAL_RCC_GetHCLKFreq()	Returns HCLK (AHB) frequency.
__HAL_RCC_GPIOA_CLK_ENABLE()	Enables GPIOA peripheral clock.

---

4. Common Clock Issues & Fixes

1. Clock Not Starting:

   • Check HSE crystal connections (if used).

   • Verify PLL settings (M, N, P values).

   • Ensure FLASH latency matches clock speed (FLASH_LATENCY_x).

2. Peripheral Not Working:

   • Did you enable its clock? (__HAL_RCC_USART1_CLK_ENABLE()).

3. Power Consumption Optimization:

   • Use HAL_RCC_DeInit() to switch back to HSI in low-power modes.

---

5. Example: Measuring Clock Speed

c

#include "stm32f4xx_hal.h"

int main() {
  HAL_Init();
  SystemClock_Config();

  uint32_t sysclk = HAL_RCC_GetSysClockFreq();
  uint32_t hclk = HAL_RCC_GetHCLKFreq();
  uint32_t pclk1 = HAL_RCC_GetPCLK1Freq();
  uint32_t pclk2 = HAL_RCC_GetPCLK2Freq();

  while (1) {
    // Debug via UART or toggling GPIO
  }
}

---

Conclusion

• The HAL library simplifies clock configuration but requires understanding of the STM32 clock tree.

• CubeMX automates the process, but manual tweaking is sometimes needed.

• Always verify clock settings with an oscilloscope or logic analyzer if issues arise.