Since core version greater than1.5.0, a default STM32 HAL configuration is provided per STM32 series.As those files were almost the same for the same series, a default one per series avoid to add one for each variant.

Each required STM32 HAL configuration file is insystem/STM32YYxx/ (whereYY is the MCU series).

It allows to wrap to the correct HAL configurations. Example for a STM32F2:stm32f2xx_hal_conf.h

/* STM32F2xx specific HAL configuration options. */#if__has_include("hal_conf_custom.h")#include"hal_conf_custom.h"#else#if__has_include("hal_conf_extra.h")#include"hal_conf_extra.h"#endif#include"stm32f2xx_hal_conf_default.h"#endif

Eachstm32yyxx_hal_conf_default.h file disabled all HAL modules and include the samestm32yyxx_hal_conf.h file available here:cores/arduino/stm32/stm32yyxx_hal_conf.h

This file handles:

• mandatory HAL modules definitionthe default list of modules to be used in the HAL driver
• HAL module enabled by default which can be disabled
• HAL modules not defined by default

Extra HAL configuration can be enabled/disabled invariant.h (if required) or in a file named (at sketch level):

• hal_conf_extra.h

Custom HAL configuration file can replace the default one by adding a file named (at sketch level):

• hal_conf_custom.h

• HAL_MODULE_ENABLED
• HAL_CORTEX_MODULE_ENABLED
• HAL_DMA_MODULE_ENABLED: Required by other modules
• HAL_FLASH_MODULE_ENABLED
• HAL_GPIO_MODULE_ENABLED
• HAL_PWR_MODULE_ENABLED
• HAL_RCC_MODULE_ENABLED

• HAL_ADC_MODULE_ENABLED
• HAL_I2C_MODULE_ENABLED
• HAL_RTC_MODULE_ENABLED
• HAL_SPI_MODULE_ENABLED
• HAL_TIM_MODULE_ENABLED

• HAL_CAN_MODULE_ENABLED
• HAL_DAC_MODULE_ENABLED
• HAL_ETH_MODULE_ENABLED
• HAL_SD_MODULE_ENABLED
• HAL_QSPI_MODULE_ENABLED

• HAL_UART_MODULE_ENABLED
• HAL_PCD_MODULE_ENABLED

• HAL_ADC_MODULE_DISABLED
• HAL_I2C_MODULE_DISABLED
• HAL_RTC_MODULE_DISABLED
• HAL_SPI_MODULE_DISABLED
• HAL_TIM_MODULE_DISABLED
• HAL_DAC_MODULE_DISABLED
• HAL_EXTI_MODULE_DISABLED: interrupt API does not used HAL EXTI module anyway API is cleaned with this
• HAL_ETH_MODULE_DISABLED
• HAL_SD_MODULE_DISABLED
• HAL_QSPI_MODULE_DISABLED

*With allHAL_*_MODULE_DISABLED defined inhal_conf_extra.h andSerial disabled

Hereafter, list of possible oscillator values which can be redefined:

• HSE_VALUE: Value of the External oscillator in Hz
• HSE_STARTUP_TIMEOUT: Time out for HSE start up, in ms
• MSI_VALUE: Value of the Internal Multiple Speed oscillator in Hz
• CSI_VALUE: Value of the Internal oscillator in Hz
• HSI_VALUE: Value of the Internal High Speed oscillator in Hz
• HSI_STARTUP_TIMEOUT: Time out for HSI start up, in ms
• HSI14_VALUE: Value of the Internal High Speed oscillator for ADC in Hz. The real value may vary depending on the variations in voltage and temperature.
• HSI48_VALUE: Value of the Internal High Speed oscillator for USB in Hz. The real value may vary depending on the variations in voltage and temperature.
• LSI_VALUE: Value of the Internal Low Speed oscillator in Hz. The real value may vary depending on the variations in voltage and temperature.
• LSI1_VALUE: Value of the Internal Low Speed 1 oscillator in Hz. The real value may vary depending on the variations in voltage and temperature.
• LSI2_VALUE:Value of the Internal Low Speed 2 oscillator in Hz. The real value may vary depending on the variations in voltage and temperature.
• LSE_VALUE: Value of the External Low Speed oscillator in Hz`
• LSE_STARTUP_TIMEOUT: Time out for LSE start up, in ms
• EXTERNAL_CLOCK_VALUE: External clock source for I2S peripheral
• EXTERNAL_SAI1_CLOCK_VALUE: Value of the SAI1 External clock source in Hz
• EXTERNAL_SAI2_CLOCK_VALUE: Value of the SAI2 External clock source in Hz

Hereafter, list of possible HAL system configuration values which can be redefined:

• VDD_VALUE: Value of VDD in mv
• TICK_INT_PRIORITY: tick interrupt priority
• PREFETCH_ENABLE: To enable prefetch
• INSTRUCTION_CACHE_ENABLE: Use to enable I-cache
• DATA_CACHE_ENABLE: Use to enable D-cache
• USE_SPI_CRC: Use to activate CRC feature inside HAL SPI Driver
• ART_ACCLERATOR_ENABLE: To enable ART Accelerator
• USE_SD_TRANSCEIVER: To use µSD Transceiver

STM32 peripherals have many powerful features. Some of them are used by default by the Arduino API: I2C, SPI, TIM, U(S)ART, ... and take over IRQ Handlers (ex:TIMx_IRQHandler) and other HAL weaked functions (ex:HAL_XXX_MspInit()).For advanced user applications, it could be useful to take control of those IRQ handlers.

Since core version greater than1.7.0, it is possible to disable the use of the HAL modules by the Arduino API.

DefiningHAL_PPP_MODULE_ONLY inbuild_opt.h orhal_conf_extra.h allows HAL peripheral (PPP ) module usage without any usage by the core.

Hereafter list of possible definition:

• HAL_UART_MODULE_ONLY
• HAL_TIM_MODULE_ONLY
• HAL_ADC_MODULE_ONLY
• HAL_DAC_MODULE_ONLY
• HAL_RTC_MODULE_ONLY
• HAL_PWR_MODULE_ONLY

I2C and SPI do not required definition as used only thanks built-in library. Do not includeWire.h orSPI.h will allow to use the HAL module.

HAL and LL include assertions which can be enabled by definingUSE_FULL_ASSERT inbuild_opt.h.

By default,assert_failed(uint8_t *file, uint32_t line) will print the assertion location (file and line) and loop forever. Print rely on_Error_Handler(const char *msg, int val) so it is available only when debug is enabled anyway end user can redefine it as it is aWEAK function.

extern"C"voidassert_failed(uint8_t *file,uint32_t line) {// Custom codeprintf("Assert failed: %s (%lu)\n", (char *)file, line);}// the setup function runs once when you press reset or power the boardvoidsetup() {// initialize digital pin LED_BUILTIN as an output.assert_param(LED_BUILTIN ==0);pinMode(LED_BUILTIN, OUTPUT);}

STM23G0xx series shared an irq with theHardwareTimer but the default irq handler did not managed theFDCAN one as the core does not support it.

Sincehttps://github.com/stm32duino/Arduino_Core_STM32/pull/2301 the handler properly forward to the correct handler.

Anyway, application have to declare thephfdcan1 andphfdcan2 handles.

Example:

FDCAN_HandleTypeDefmyhfdcan1;FDCAN_HandleTypeDef*phfdcan1=&myhfdcan1;#if defined(FDCAN2_BASE)FDCAN_HandleTypeDef*phfdcan2=NULL;#endif