Disable HAL feature when not used in the sketch

[fpistm]

Goal of this issue is to be able to disable HAL module if not used in the sketch in order to reduce binary size.

• I2C: done thanks 07dcdc4
• SPI: done thanks c41d8af
• ADC: done thanks e4b1121
• DAC: done thanks 68d3450
• TIM: done thanks b10696d
• UART: done thanks 83d872f
• ETH: done thanks 680e01b
• SD: done thanks e0e90cc
• QSPI: done thanks 4e25050
• RTC: done thanks 0753358
• USB: done thanks Arduino menu.
• EXTI: done thanks 0e1f5a7. Interrupt API does not used HAL EXTI module anyway API is cleaned with HAL_EXTI_MODULE_DISABLED
• RCC: mandatory. User can use LL to override SystemClock_Config()

Mainly useful for MCU with smallflash size (See #165)

Proposition:

handle a default HAL conf file which could be override by end user at sketch level or variant.
PeripheralPins arrays could also use new switch to force an array to be disable even if the HAL module is enabled.

Implementation done thanks #518

• Extra HAL module can be enabled/disabled in variant.h if required or in a file named (at sketch level): hal_conf_extra.h

  • To enable a HAL modules use the standard HAL definition: HAL_PPP_MODULE_ENABLED with PPP the peripheral to enable.
  • To disable a HAL modules use one or more following values:
    • HAL_ADC_MODULE_DISABLED
    • HAL_I2C_MODULE_DISABLED
    • HAL_RTC_MODULE_DISABLED
    • HAL_SPI_MODULE_DISABLED
    • HAL_DAC_MODULE_DISABLED
    • HAL_ETH_MODULE_DISABLED
    • HAL_SD_MODULE_DISABLED
    • HAL_QSPI_MODULE_DISABLED
    • HAL_EXTI_MODULE_DISABLED
    • HAL_TIM_MODULE_DISABLED
      Note: HAL_UART_MODULE_ENABLED and HAL_PCD_MODULE_ENABLED are handled thanks Arduino menu.

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

[aster94]

With "small flash size" do you consider also the blue pill and similar 48pins f1 boards?
As you know it should be 64kb, even if we use it as a 128kb i think that a smaller bin would be safer

[fpistm]

This will be available for all variants. It's a core feature not specific to a variant.
Anyway, depending of the feature used, the HAL part is not embed if not used.
Example for SPI or I2C if SPI.h or Wire.h is not include, the HAL part is removed by the compiler as it is not used. Only the pinmap array is kept but it should be removed if not used to save some space.

[fpistm]

Serial can now be enabled or not:
83d872f

This allow to build without HAL_UART_MODULE_ENABLED (save memory)
HAL_UART_MODULE_ENABLED should not be defined in stm32yyxx_hal_conf.h

[tve]

Shouldn't RCC also be on the list here, e.g., following the comment #165 (comment) ("I've generate the code with CubeMx to use LL instead of HAL for RCC") ?

[fpistm]

This could.

[Adminius]

hi @fpistm ,
for this points:

ADC: be able to build without HAL_ADC_MODULE_ENABLED
DAC: it's already possible to build without HAL_DAC_MODULE_ENABLED, maybe a menu could be proposed to enable or not the feature...
PWM: be able to build without HAL_PWM_MODULE_ENABLED

we need menu and some ifdef "only", right?

[fpistm]

Hi @Adminius,
probably yes, I have to find a nice and easiest way to do this.