STM32

All STM32 families code and definitions. More...

Detailed Description

All STM32 families code and definitions.

This module contains the code and definitions for STM32 cpu families supported by RIOT: F0, F1, F2, F3, F4, F7, G0, G4, L0, L1, L4, L5 and WB.

All constants described below can be configured using CFLAGS from the command line or in the application Makefile.

Clock configuration

All STM32 cpus have clock configuration code and macros. It is recommend to read the reference manual of the CPU of interest to learn about the corresponding clock tree and the possible configurations.

For all families, different input clock sources are available for the SYSCLK system clock (but only one can be used at a time):

• HSE (High Speed External): HSE depends on the board configuration and its presence is specified by the CONFIG_BOARD_HAS_HSE constant at board level. The CONFIG_CLOCK_HSE constant specifies the frequency of the external oscillator in Hz. To use HSE as system clock (SYSCLK), set CONFIG_USE_CLOCK_HSE constant to 1;
• HSI (High Speed Internal): HSI is either 8MHz or 16MHz, depending on the families. To use HSI as system clock (SYSCLK), set CONFIG_USE_CLOCK_HSI constant to 1;
• MSI (Multi-Speed Internal): This internal oscillator is only available on L0, L1, L4, L5 and WB families. To use MSI as system clock (SYSCLK), set CONFIG_USE_CLOCK_MSI constant to 1 The MSI clock frequency can be configured using the CONFIG_CLOCK_MSI constant (in Hz);

• PLL (Phase-Locked Loop) provides a finely configurable clock source for SYSCLK and allows to reach precise and high clock speeds, depending on the input source. In RIOT, this is the default clock source for SYSCLK. To use the PLL as system clock (SYSCLK), set CONFIG_USE_CLOCK_PLL constant to 1 (default).

  If an HSE is provided by the board, it is automatically selected as input source for the PLL, otherwise HSI is selected.

  On L4 and WB, the PLL input source can be selected between HSE, HSI and MSI (default): to configure the PLL input source, just set CONFIG_CLOCK_PLL_SRC_HSI, CONFIG_CLOCK_PLL_SRC_HSE or CONFIG_CLOCK_PLL_SRC_MSI to 1.

  2 types of PLL are available on STM32:

  • for stm32f[2|4|7], stm32g[0|4] and stm32[l4|l5|wb], the PLL can be configured with several parameters M, N, P, Q and R (optional). M is the input divider, N is the multiplier and P, Q and R are output dividers. On stm32f[2|4|7], the clock source from the P output divider is used as SYSCLK input, the clock source from the Q output divider can be used as 48MHz. On stm32g[0|4] and stm32[l4|l5|wb], the clock source from the R output divider is used as SYSCLK input.

    Constants used to configure the PLL on these families are CONFIG_CLOCK_PLL_M, CONFIG_CLOCK_PLL_N, CONFIG_CLOCK_PLL_P, CONFIG_CLOCK_PLL_Q and CONFIG_CLOCK_PLL_R.

  • for stm32f[0|1|3] and stm32l[0|1], the PLL can be configured with a predivider parameter and a multiplier parameter. Constants used to configure the PLL on these families are CONFIG_CLOCK_PLL_DIV (l0, l1) or CONFIG_CLOCK_PLL_PREDIV (f0, f1, f3) and CONFIG_CLOCK_PLL_MUL.

Advanced Peripheral Bus (APB) clock prescalers:

These prescalers are used to compute the PCLK1 and PCLK2 clock values. Use CONFIG_CLOCK_APB1_DIV and CONFIG_CLOCK_APB2_DIV constants to configure the prescalers (just set the frequency factor). APB2 is not available on f0 and g0 families so setting CONFIG_CLOCK_APB2_DIV will have no effect on them.

MCO (Microcontroller Clock Output) parameters:

For stm32f[2|4|7], clock outputs can be configured as follows:

• set CONFIG_CLOCK_ENABLE_MCO1 to enable MCO1 (on PA8) and use CONFIG_CLOCK_MCO1_PRE constant to specify the MCO1 prescaler (default to 1). Possible sources are HSE, HSI and PLL (the default): set 1 to CONFIG_CLOCK_MCO1_USE_HSE, CONFIG_CLOCK_MCO1_USE_HSI or CONFIG_CLOCK_MCO1_USE_PLL to select the source;
• set CONFIG_CLOCK_ENABLE_MCO2 to enable MCO1 (on PC9) and use CONFIG_CLOCK_MCO2_PRE constant to specify the MCO2 prescaler (default to 1). Possible sources are HSE, SYSCLK, PLLI2S and PLL (the default): set 1 to CONFIG_CLOCK_MCO1_USE_HSE, CONFIG_CLOCK_MCO1_USE_SYSCLK, CONFIG_CLOCK_MCO1_USE_PLLI2S or CONFIG_CLOCK_MCO1_USE_PLL to select the source;

Modules
	STM32 CAN controller
	STM32 CAN controller driver (bxCAN)
	STM32 FMC/FSMC LCD low-level parallel interface driver
	STM32 FMC/FSMC peripheral driver
	The periph_fmc module implements a driver for STM32 FMC/FSMC peripherals.
	STM32WL hardware debugging
	stm32 USB OTG FS/HS peripheral
	USB interface functions for the stm32 class devices.

Files
file	cfg_clock_default.h
	Configure STM32C0 clock.
file	cfg_clock_common_fx_gx_mp1_c0.h
	Base STM32Fx/Gx/MP1/C0 clock configuration.
file	cfg_clock_common_lx_u5_wx.h
	Base STM32Lx/U5/Wx clock configuration.
file	clk_conf.h
	Main header for STM32 clock configuration.
file	cfg_clock_default.h
	Default clock configuration for STM32F0/F1/F3.
file	cfg_clock_default.h
	Main header for STM32F2/F4/F7 clock configuration.
file	cfg_clock_default_100.h
	Default STM32F4 clock configuration for 100MHz boards.
file	cfg_clock_default_120.h
	Default STM32F2/4/7 clock configuration for 120MHz boards.
file	cfg_clock_default_180.h
	Default STM32F4 clock configuration for 180MHz boards.
file	cfg_clock_default_216.h
	Default STM32F7 clock configuration for 216MHz boards.
file	cfg_clock_default_84.h
	Default STM32F4 clock configuration for 84MHz boards.
file	cfg_clock_default.h
	Configure STM32G0/G4 clock.
file	cfg_clock_default.h
	Default STM32L0/STM32L1 clock configuration.
file	cfg_clock_default.h
	Default STM32L4 clock configuration.
file	cfg_clock_default.h
	Main header for STM32MP1 clock configuration.
file	cfg_clock_default.h
	Default STM32U5 clock configuration.
file	cpu_conf.h
	Implementation specific CPU configuration options.
file	gpio_ll_arch.h
	CPU specific part of the Peripheral GPIO Low-Level API.
file	periph_cpu.h
	STM32C0 CPU specific definitions for internal peripheral handling.
file	cpu_backup_ram.h
	Backup SRAM CPU specific definitions for the STM32 family.
file	cpu_common.h
	Common CPU definitions for the STM32 family.
file	cpu_dma.h
	DMA CPU specific definitions for the STM32 family.
file	cpu_eth.h
	Ethernet CPU specific definitions for the STM32 family.
file	cpu_gpio.h
	GPIO CPU definitions for the STM32 family.
file	cpu_gpio_ll.h
	GPIO LL CPU definitions for the STM32 family.
file	cpu_i2c.h
	I2C CPU specific definitions for the STM32 family.
file	cpu_ltdc.h
	LTDC CPU specific definitions for the STM32 family.
file	cpu_pm.h
	Power Management (PM) CPU specific definitions for the STM32 family.
file	cpu_pwm.h
	PWM CPU specific definitions for the STM32 family.
file	cpu_qdec.h
	QDEC CPU specific definitions for the STM32 family.
file	cpu_sdmmc.h
	CPU specific definitions for SDIO/SDMMC for the STM32 family.
file	cpu_spi.h
	SPI CPU specific definitions for the STM32 family.
file	cpu_timer.h
	Timer CPU specific definitions for the STM32 family.
file	cpu_uart.h
	UART CPU specific definitions for the STM32 family.
file	cpu_usbdev.h
	USB CPU specific definitions for the STM32 family.
file	cpu_vbat.h
	CPU internal VBAT interface and definitions of the STM32 family.
file	cpu_wdt.h
	Watchdog CPU definitions for the STM32 family.
file	periph_cpu.h
	STM32F0 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32F1 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32F2 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32F3 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32F4 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32F7 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32G0 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM3G4 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32L0 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32L1 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32L4 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32L5 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32U5 CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32WB CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	STM32WL CPU specific definitions for internal peripheral handling.
file	periph_cpu.h
	Shared CPU specific definitions for the STM32 family.
file	stmclk.h
	Interface for configuring the clock tree of STM32 CPUs.
file	tinyusb_hw_defaults.h
	STM32 specific default configurations for tinyUSB.