Release Notes for STM32CubeU5 HAL and LL drivers

Copyright ©  2021 STMicroelectronics

Purpose

The STM32Cube HAL and LL, an STM32 abstraction layer embedded software, ensure maximized portability across STM32 portfolio.

The portable APIs layer provides a generic, multi instanced and simple set of APIs to interact with the upper layer (application, libraries and stacks). It is composed of native and extended APIs set. It is directly built around a generic architecture and allows the build-upon layers, like the middleware layer, to implement its functions without knowing in-depth the used STM32 device. This improves the library code reusability and guarantees an easy portability on other devices and STM32 families.

The Low Layer (LL) drivers are part of the STM32Cube firmware HAL that provides a basic set of optimized and one-shot services. The Low layer drivers, contrary to the HAL ones are not fully portable across the STM32 families; the availability of some functions depends on the physical availability of the relative features on the product. The Low Layer (LL) drivers are designed to offer the following features:

Update History

Main Changes

  • Maintenance Release V1.6.0 of STM32CubeU5 Firmware Package to deploy the new HAL SDIO driver.
  • General updates to fix known defects and implementation enhancements.

HAL/LL Drivers updates

  • HAL GENERIC driver
    • update stm32u5xx_hal_conf_template file to add the support for the new HAL SDIO driver.
  • HAL CORTEX driver
    • Use MPUx instead of MPU inside MPU_ConfigRegion() API when disabling the region.
  • HAL DSI driver
    • Update startup sequence: PLL tuning must be done before PLL Enable.
  • HAL DAC driver
    • Fix HAL_DACEx_SelfCalibrate() API to manage case of calibration factor equal to range maximum value: Previously, in this case calibration factor was reset, leading to voltage accuracy not optimal.
    • Update trimming factor to use 6bits width.
  • HAL SDMMC driver
    • Support new HAL SDIO driver.

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • HAL and LL drivers Maintenance Release for STM32U535xx/STM32U545xx, STM32U575xx/STM32U585xx, STM32U599xx/STM32U5A9xx, STM32U595xx/STM32U5A5xx, STM32U5F9xx/STM32U5G9xx and STM32U5F7xx/STM32U5G7xx devices
  • Add the HAL MMC replay protected memory block management feature
  • The HAL and LL drivers provided within this package are MISRA-C, Coverity and MCU ASTYLE compliant, and have been reviewed with a static analysis tool to eliminate possible run-time errors

HAL Drivers updates

  • HAL CORDIC driver
    • Fix incorrect word ‘surcharged’ in functions headers
  • HAL CORTEX driver
    • Fix MPU_ACCESS_OUTER_SHAREABLE and LL_MPU_ACCESS_OUTER_SHAREABLE definitions
    • Add HAL_SYSTICK_GetCLKSourceConfig, HAL_MPU_EnableRegion, HAL_MPU_DisableRegion, HAL_MPU_EnableRegion_NS and HAL_MPU_DisableRegion_NS functions
  • HAL FMAC driver
    • Fix incorrect word ‘surcharged’ in functions headers
  • HAL DSI driver
    • Align DSI Initialization sequence to the recommended ‘Programming procedure overview’ part to avoid DSI read LCD controller register 0x0A error
  • HAL GPIO driver
    • Remove IS_GPIO_SINGLE_PIN define
  • HAL ICACHE driver
    • Update HAL_ICACHE_DeInit to set registers to reset value
    • Update HAL_ICACHE_Invalidate() to prevent launching an invalidation if one has already been launched
  • HAL I2C driver
    • Update HAL_I2C_Mem_Write_IT API to initialize XferSize at 0
    • Update I2C_Slave_ISR_IT, I2C_Slave_ISR_DMA and I2C_ITSlaveCplt to prevent the call of HAL_I2C_ListenCpltCallback twice
    • Update I2C_WaitOnRXNEFlagUntilTimeout to check I2C_FLAG_AF independently from I2C_FLAG_RXNE
    • Remove the unusable code in HAL_I2C_IsDeviceReady function
    • Update HAL_I2C_Slave_Transmit to check if the received NACK is the good one
  • HAL driver
    • Add HAL_SYSCFG_EnableIOAnalogSwitchVoltageSelection and HAL_SYSCFG_DisableIOAnalogSwitchVoltageSelection functions
  • HAL LPTIM driver
    • Removed references to COMP2 for STM32U535xx/STM32U545xx devices
    • Remove IS_LPTIM_AUTORELOAD define
  • HAL MMC driver
    • Add the replay protected memory block management defines:
      • HAL_MMC_ERROR_RPMB_OPERATION_OK
      • HAL_MMC_ERROR_RPMB_GENERAL_FAILURE
      • HAL_MMC_ERROR_RPMB_AUTHENTICATION_FAILURE
      • HAL_MMC_ERROR_RPMB_COUNTER_FAILURE
      • HAL_MMC_ERROR_RPMB_ADDRESS_FAILURE
      • HAL_MMC_ERROR_RPMB_WRITE_FAILURE
      • HAL_MMC_ERROR_RPMB_READ_FAILURE
      • HAL_MMC_ERROR_RPMB_KEY_NOT_YET_PROG
      • HAL_MMC_ERROR_RPMB_COUNTER_EXPIRED
      • HAL_MMC_RPMB_ProgramAuthenticationKey
      • HAL_MMC_RPMB_ProgramAuthenticationKey_IT
      • HAL_MMC_RPMB_GetWriteCounter
      • HAL_MMC_RPMB_GetWriteCounter_IT
      • HAL_MMC_RPMB_WriteBlocks
      • HAL_MMC_RPMB_WriteBlocks_IT
      • HAL_MMC_RPMB_ReadBlocks
      • HAL_MMC_RPMB_ReadBlocks_IT
      • MMC_RPMB_KEYMAC_POSITION
      • MMC_RPMB_DATA_POSITION
      • MMC_RPMB_NONCE_POSITION
      • MMC_RPMB_WRITE_COUNTER_POSITION
    • Add HAL_MMC_SwitchPartition and HAL_MMC_GetRPMBError functions
    • Add the MMC partitions type defines:
      • HAL_MMC_USER_AREA_PARTITION
      • HAL_MMC_BOOT_PARTITION1
      • HAL_MMC_BOOT_PARTITION2
      • HAL_MMC_RPMB_PARTITION
  • HAL PKA driver
    • Add PKA_ECCMulExInTypeDef operation structure definition
    • Add HAL_PKA_ECCMulEx and HAL_PKA_ECCMulEx_IT functions
  • HAL PSSI driver
    • Replace hdmatx by hdmarx in HAL_PSSI_Receive_DMA() function
  • HAL PWR driver
    • Add PWR_SLEEPENTRY_WFE_NO_EVT_CLEAR and PWR_STOPENTRY_WFE_NO_EVT_CLEAR defines
  • HAL RCC driver
    • Update HAL_RCC_NMI_IRQHandler, clear flag before callback
  • HAL RNG driver
    • Add RNG noise source control
  • HAL SAI driver
    • Improve audio quality to avoid potential glitch
    • Fix incorrect word ‘surcharged’ in functions headers
  • HAL SMBUS driver
    • Remove HAL_SMBUS_STATE_TIMEOUT and HAL_SMBUS_STATE_ERROR defines
  • HAL TIM driver
    • Rename TIM_OCMODE_ASSYMETRIC_PWM1 to TIM_OCMODE_ASYMMETRIC_PWM1 define
    • Rename TIM_OCMODE_ASSYMETRIC_PWM2 to TIM_OCMODE_ASYMMETRIC_PWM2 define
    • Removed references to COMP2 for STM32U535xx/STM32U545xxxx devices
  • HAL UART driver
    • Fix incorrect gState check in HAL_UART_RegisterRxEventCallback and HAL_UART_UnRegisterRxEventCallback to allow user Rx Event Callback registration when a transmit is ongoing
  • HAL USB driver
    • Add HCD_PDWN_EXIT_CNT define

LL Drivers updates

  • LL CORTEX driver
    • Rename LL_SYSTICK_CLKSOURCE_HCLK_DIV8 to LL_SYSTICK_CLKSOURCE_EXTERNAL
  • LL I2C driver
    • Update LL_I2C_HandleTranfer function to prevent undefined behavior of volatile usage before updating the CR2 register
  • LL PWR driver
    • Rename PWR_SECCFGR_WUP8SEC to PWR_SECCFGR_LPMSEC define
    • Rename PWR_SECCFGR_WUP8SEC to PWR_SECCFGR_VDMSEC define
    • Rename PWR_SECCFGR_WUP8SEC to PWR_SECCFGR_VBSEC define
    • Rename PWR_SECCFGR_WUP8SEC to PWR_SECCFGR_APCSEC define
  • LL TIM driver
    • Rename LL_TIM_OCMODE_ASSYMETRIC_PWM1 to LL_TIM_OCMODE_ASYMMETRIC_PWM1 define
    • Rename LL_TIM_OCMODE_ASSYMETRIC_PWM2 to LL_TIM_OCMODE_ASYMMETRIC_PWM2 define
  • LL USB driver
    • Add HAL_USB_TIMEOUT and HAL_USB_CURRENT_MODE_MAX_DELAY_MS defines
    • Prevent masking NAK IT during start split transfer
  • LL UTILS driver
    • Add LL_UTILS_PACKAGETYPE_WLCSP72_SMPS and LL_UTILS_PACKAGETYPE_LQFP144_DSI_SMPS defines
    • Add LL_Init1msTick_HCLK_Div8, LL_Init1msTick_LSE and LL_Init1msTick_LSI functions
    • Rename LL_UTILS_PACKAGETYPE_WLCSP144 to LL_UTILS_PACKAGETYPE_UFBGA64 define
    • Rename LL_UTILS_PACKAGETYPE_UFBGA144 to LL_UTILS_PACKAGETYPE_UFBGA100 define
    • Rename LL_UTILS_PACKAGETYPE_WLCSP144_SMPS to LL_UTILS_PACKAGETYPE_LQFP100_DSI_SMPS define

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • HAL and LL drivers Maintenance Release for STM32U5XX devices
  • Update ADC HAL and LL drivers to fix known defects and add implementation enhancements
  • The HAL and LL drivers provided within this package are MISRA-C, MCU ASTYLE and CodeSonar compliant, and have been reviewed with a static analysis tool to eliminate possible run-time errors

HAL Drivers updates

  • HAL ADC driver
    • Add new Helper macro for differential mode raw data to voltage conversion
  • HAL ADC_EX driver
    • Enhance calibration procedure implementation

LL Drivers updates

  • LL ADC driver
    • Add new Helper macro for differential mode raw data to voltage conversion

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • HAL and LL drivers official Release for STM32U5F7xx/STM32U5G7xx, STM32U5F9xx/STM32U5G9xx, STM32U535xx/STM32U545xx, STM32U575xx/STM32U585xx, STM32U595xx/STM32U5A5xx and STM32U599xx/STM32U5A9xx devices
  • Add 2 new HAL drivers : GFXTIM and JPEG highlighting the graphics aspect of STM32U5F7/STM32U5G7/STM32U5F9/STM32U5G9 devices
  • The HAL and LL drivers provided within this package are MISRA-C, MCU ASTYLE and CodeSonar compliant, and have been reviewed with a static analysis tool to eliminate possible run-time errors
  • General updates to fix known defects and implementation enhancements

HAL Drivers updates

  • HAL CRYP driver
    • Add HAL_CRYP_ERROR_RNG and CRYP_IVCONFIG_ONCE defines
  • HAL DMA driver
    • Add NODE_MAXIMUM_SIZE define
  • HAL FMAC driver
    • Add FMAC_PARAM_P_MAX_IIR define
    • Add FMAC_PARAM_P_MAX_FIR define
    • Add FMAC_PARAM_P_MIN define
    • Add FMAC_PARAM_Q_MAX define
    • Add FMAC_PARAM_Q_MIN define
    • Add FMAC_PARAM_R_MAX define
  • HAL GFXTIM driver
    • Add new GFXTIM HAL driver highlighting the graphic Timer features to manage the functionalities of the Multi-function Digital Filter
  • HAL GPIO_EX driver
    • Add GPIO_AF8_SDMMC2 define
    • Add GPIO_AF10_DSI define
    • Add GPIO_AF14_FMC define
  • HAL JPEG driver
    • Add new JPEG HAL driver highlighting the graphic encoder/decoder features
  • HAL TIM driver
    • Add IS_TIM_CCX_CHANNEL define

LL Drivers updates

  • LL PWR driver
    • Replace LL_PWR_EnableVDDUSB by LL_PWR_EnableVddUSB define
    • Replace LL_PWR_DisableVDDUSB by LL_PWR_DisableVddUSB define
    • Replace LL_PWR_IsEnabledVDDUSB by LL_PWR_IsEnabledVddUSB define
    • Replace LL_PWR_EnableVDDIO2 by LL_PWR_EnableVddIO2 define
    • Replace LL_PWR_DisableVDDIO2 by LL_PWR_DisableVddIO2 define
    • Replace LL_PWR_IsEnabledVDDIO2 by LL_PWR_IsEnabledVddIO2 define
    • Replace LL_PWR_EnableVDDA by LL_PWR_EnableVddA define
    • Replace LL_PWR_DisableVDDA by LL_PWR_DisableVddA define
    • Replace LL_PWR_IsEnabledVDDA by LL_PWR_IsEnabledVddA define
    • Replace LL_PWR_EnableVDDUSBMonitor by LL_PWR_EnableVddUSBMonitor define
    • Replace LL_PWR_DisableVDDUSBMonitor by LL_PWR_DisableVddUSBMonitor define
    • Replace LL_PWR_IsEnabledVDDUSBMonitor by LL_PWR_IsEnabledVddUSBMonitor define
    • Replace LL_PWR_EnableVDDIO2Monitor by LL_PWR_EnableVddIO2Monitor define
    • Replace LL_PWR_DisableVDDIO2Monitor by LL_PWR_DisableVddIO2Monitor define
    • Replace LL_PWR_IsEnabledVDDIO2Monitor by LL_PWR_IsEnabledVddIO2Monitor define
    • Replace LL_PWR_EnableVDDAMonitor1 by LL_PWR_EnableVddAMonitor1 define
    • Replace LL_PWR_DisableVDDAMonitor1 by LL_PWR_DisableVddAMonitor1 define
    • Replace LL_PWR_IsEnabledVDDAMonitor1 by LL_PWR_IsEnabledVddAMonitor1 define
    • Replace LL_PWR_EnableVDDAMonitor2 by LL_PWR_EnableVddAMonitor2 define
    • Replace LL_PWR_DisableVDDAMonitor2 by LL_PWR_DisableVddAMonitor2 define
    • Replace LL_PWR_IsEnabledVDDAMonitor2 by LL_PWR_IsEnabledVddAMonitor2 define
  • LL RTC driver
    • invert the RTC ALARM OUTPUT TYPE:
      • Set LL_RTC_ALARM_OUTPUTTYPE_PUSHPULL to zero in RTC_ALARM is push-pull output
      • Replace LL_RTC_ALARM_OUTPUTTYPE_OPENDRAIN by RTC_CR_TAMPALRM_TYPE in RTC_ALARM is open-drain output
  • LL SDMMC driver
    • Add SDMMC_SWDATATIMEOUT define
    • Add SDMMC_FIFO_SIZE define
  • LL TIM driver
    • Add LL_TIM_CC_IsEnabledPreload define

Note: HAL/LL Backward compatibility ensured by legacy defines.

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • HAL and LL drivers Official Release for STM32U535xx / STM32U545xx, STM32U575xx / STM32U585xx, STM32U595xx, STM32U5A5xx, STM32U599xx and STM32U5A9xx devices.
  • Update STM32U545xx_User_Manual, STM32U585xx_User_Manual and STM32U5A9xx_User_Manual CHM User Manuals

HAL Drivers updates

  • HAL ADC driver
    • Rename ADC4_RESOLUTION_12B to ADC_RESOLUTION_12B
    • Rename ADC4_RESOLUTION_10B to ADC_RESOLUTION_10B
    • Rename ADC4_RESOLUTION_8B to ADC_RESOLUTION_8B
    • Rename ADC4_RESOLUTION_6B to ADC_RESOLUTION_6B
    • Add HAL_ADC_END_OF_CALIBRATION_CB_ID, HAL_ADC_VOLTAGE_REGULATOR_CB_ID and HAL_ADC_ADC_READY_CB_ID callbacks
    • Add ADC_IT_EOCAL, ADC_IT_LDORDY, ADC_FLAG_EOCAL and ADC_FLAG_LDORDY defines
  • HAL ADC_EX driver
    • Add IS_ADC4_OVERSAMPLING_RATIO and IS_ADC12_RIGHT_BIT_SHIFT defines
  • HAL COMP driver
    • Rename macro __HAL_COMP_COMP1_EXTI_CLEAR_RASING_FLAG to __HAL_COMP_COMP1_EXTI_CLEAR_RISING_FLAG
  • HAL DMA2D driver
    • Add DMA2D_INPUT_YCBCR define
    • Add DMA2D_NO_CSS, DMA2D_CSS_422 and DMA2D_CSS_420 defines
    • Add IS_DMA2D_CHROMA_SUB_SAMPLING and IS_DMA2D_INPUT_COLOR_MODE defines
  • HAL DSI driver
    • Enhance the implementation of the following functions:
      • HAL_DSI_EnterULPMData()
      • HAL_DSI_ExitULPMData()
      • HAL_DSI_EnterULPM()
      • HAL_DSI_ExitULPM()
  • HAL EXTI driver
    • Add HAL_EXTI_LockAttributes and HAL_EXTI_GetLockAttributes functions
    • Add EXTI_LINE_23, EXTI_LINE_24 and EXTI_LINE_25 defines
  • HAL FLASH driver
    • Rename OB_USER_SRAM134_RST to OB_USER_SRAM_RST
    • Rename OB_SRAM134_RST_ERASE to OB_SRAM_RST_ERASE
    • Rename OB_SRAM134_RST_NOT_ERASE to OB_SRAM_RST_NOT_ERASE
  • HAL GFXMMU driver
    • Add GFXMMU_ADDRESSCACHE_LOCK_BUFFER0, GFXMMU_ADDRESSCACHE_LOCK_BUFFER1, GFXMMU_ADDRESSCACHE_LOCK_BUFFER2 and GFXMMU_ADDRESSCACHE_LOCK_BUFFER3 defines
    • Add IS_GFXMMU_ADDRESSCACHE_LOCK_BUFFER define
  • HAL GPIO driver
    • Add HAL_GPIO_WriteMultipleStatePin() function
  • HAL GPIO_EX driver
    • Rename GPIO_AF0_S2DSTOP to GPIO_AF0_SRDSTOP
    • Rename GPIO_AF11_LPGPIO to GPIO_AF11_LPGPIO1
  • HAL GTZC driver
    • Rename GTZC_MCPBB_NB_VCTR_REG_MAX to GTZC_MPCBB_NB_VCTR_REG_MAX
    • Rename GTZC_MCPBB_NB_LCK_VCTR_REG_MAX to GTZC_MPCBB_NB_LCK_VCTR_REG_MAX
    • Rename GTZC_MCPBB_SUPERBLOCK_UNLOCKED to GTZC_MPCBB_SUPERBLOCK_UNLOCKED
    • Rename GTZC_MCPBB_SUPERBLOCK_LOCKED to GTZC_MPCBB_SUPERBLOCK_LOCKED
    • Rename GTZC_MCPBB_BLOCK_NSEC to GTZC_MPCBB_BLOCK_NSEC
    • Rename GTZC_MCPBB_BLOCK_SEC to GTZC_MPCBB_BLOCK_SEC
    • Rename GTZC_MCPBB_BLOCK_NPRIV to GTZC_MPCBB_BLOCK_NPRIV
    • Rename GTZC_MCPBB_BLOCK_PRIV to GTZC_MPCBB_BLOCK_PRIV
    • Rename GTZC_MCPBB_LOCK_OFF to GTZC_MPCBB_LOCK_OFF
    • Rename GTZC_MCPBB_LOCK_ON to GTZC_MPCBB_LOCK_ON
    • Add GTZC_PERIPH_LTDCUSB define
  • HAL driver
    • Add SYSCFG_OTG_HS_PHY_PREEMP_DISABLED, SYSCFG_OTG_HS_PHY_PREEMP_1X, SYSCFG_OTG_HS_PHY_PREEMP_2X and SYSCFG_OTG_HS_PHY_PREEMP_3X defines
    • Add SYSCFG_OTG_HS_PHY_SQUELCH_15PERCENT and SYSCFG_OTG_HS_PHY_SQUELCH_0PERCENT defines
    • Add SYSCFG_OTG_HS_PHY_DISCONNECT_5_9PERCENT and SYSCFG_OTG_HS_PHY_DISCONNECT_0PERCENT defines
    • Add HAL_GetUIDw0(), HAL_GetUIDw1() and HAL_GetUIDw2()
    • Add __HAL_DBGMCU_FREEZE_I2C5 and __HAL_DBGMCU_UNFREEZE_I2C5 macros
    • Add __HAL_DBGMCU_FREEZE_I2C6 and __HAL_DBGMCU_UNFREEZE_I2C6 macros
  • HAL I2C_EX driver
    • Add IS_I2C_TRIG_INPUT_INSTANCE define
  • HAL LPTIM driver
    • Add IS_LPTIM_INPUT2_SOURCE define
  • HAL NOR driver
    • Add NOR_CMD_ADDRESS_FIRST_BYTE, NOR_CMD_ADDRESS_FIRST_CFI_BYTE, NOR_CMD_ADDRESS_SECOND_BYTE and NOR_CMD_ADDRESS_THIRD_BYTE defines
  • HAL OPAMP driver
    • Rename HAL_OPAMP_MSP_INIT_CB_ID to HAL_OPAMP_MSPINIT_CB_ID
    • Rename HAL_OPAMP_MSP_DEINIT_CB_ID to HAL_OPAMP_MSPDEINIT_CB_ID
  • HAL PWR_EX driver
    • Add HAL_PWREx_EnableOTGHSPHYLowPowerRetention and HAL_PWREx_DisableOTGHSPHYLowPowerRetention functions
    • Add HAL_PWREx_EnableVDD11USB and HAL_PWREx_DisableVDD11USB functions
    • Rename PWR_SRAM6_PAGE1_STOP_RETENTION to PWR_SRAM6_PAGE1_STOP
    • Rename PWR_SRAM6_PAGE2_STOP_RETENTION to PWR_SRAM6_PAGE2_STOP
    • Rename PWR_SRAM6_PAGE3_STOP_RETENTION to PWR_SRAM6_PAGE3_STOP
    • Rename PWR_SRAM6_PAGE4_STOP_RETENTION to PWR_SRAM6_PAGE4_STOP
    • Rename PWR_SRAM6_PAGE5_STOP_RETENTION to PWR_SRAM6_PAGE5_STOP
    • Rename PWR_SRAM6_PAGE6_STOP_RETENTION to PWR_SRAM6_PAGE6_STOP
    • Rename PWR_SRAM6_PAGE7_STOP_RETENTION to PWR_SRAM6_PAGE7_STOP
    • Rename PWR_SRAM6_PAGE8_STOP_RETENTION to PWR_SRAM6_PAGE8_STOP
    • Rename PWR_SRAM6_FULL_STOP_RETENTION to PWR_SRAM6_FULL_STOP
  • HAL RCC driver
    • Remove __HAL_RCC_WWDG_CLK_DISABLE macro
    • Add __HAL_RCC_USB_FS_CLK_ENABLE, __HAL_RCC_USB_FS_CLK_DISABLE, __HAL_RCC_USB_IS_CLK_ENABLED, __HAL_RCC_USB_OTG_FS_IS_CLK_ENABLED, __HAL_RCC_USB_IS_CLK_DISABLED, __HAL_RCC_USB_OTG_FS_IS_CLK_DISABLED, __HAL_RCC_USB_FS_IS_CLK_ENABLED, __HAL_RCC_USB_FS_IS_CLK_DISABLED macros
    • Add __HAL_RCC_USB_FORCE_RESET, __HAL_RCC_USB_OTG_FS_FORCE_RESET, __HAL_RCC_USB_RELEASE_RESET, __HAL_RCC_USB_OTG_FS_RELEASE_RESET, __HAL_RCC_USB_FS_FORCE_RESET, __HAL_RCC_USB_FS_RELEASE_RESET, __HAL_RCC_USB_CLK_SLEEP_ENABLE, __HAL_RCC_USB_OTG_FS_CLK_SLEEP_ENABLE, __HAL_RCC_USB_CLK_SLEEP_DISABLE, __HAL_RCC_USB_OTG_FS_CLK_SLEEP_DISABLE, __HAL_RCC_USB_FS_CLK_SLEEP_ENABLE and __HAL_RCC_USB_FS_CLK_SLEEP_DISABLE macros
    • Add TSC_GROUPX_NOT_SUPPORTED
    • Rename RCC_SPI4CLKSOURCE_D2PCLK1 to RCC_SPI4CLKSOURCE_D2PCLK2
    • Rename RCC_SPI5CLKSOURCE_D2PCLK1 to RCC_SPI5CLKSOURCE_D2PCLK2
    • Rename RCC_SPI45CLKSOURCE_D2PCLK1 to RCC_SPI45CLKSOURCE_D2PCLK2
    • Rename RCC_SPI45CLKSOURCE_CDPCLK1 to RCC_SPI45CLKSOURCE_CDPCLK2
    • Rename RCC_SPI45CLKSOURCE_PCLK1 to RCC_SPI45CLKSOURCE_PCLK2
    • Rename __HAL_RCC_PLLFRACN_ENABLE to __HAL_RCC_PLL_FRACN_ENABLE
    • Rename __HAL_RCC_PLLFRACN_DISABLE to __HAL_RCC_PLL_FRACN_DISABLE
    • Rename __HAL_RCC_PLLFRACN_CONFIG to __HAL_RCC_PLL_FRACN_CONFIG
    • Rename IS_RCC_PLLFRACN_VALUE to IS_RCC_PLL_FRACN_VALUE
  • HAL RCC_EX driver
    • Add HAL_RCCEx_EnableLSECSS_IT, HAL_RCCEx_EnableMSIPLLUNLCK_IT, HAL_RCCEx_MSIPLLUNLCK_IRQHandler and HAL_RCCEx_MSIPLLUNLCK_Callback functions
  • HAL RTC driver
    • Add __HAL_RTC_IS_CALENDAR_INITIALIZED macro
  • HAL RTC_EX driver
    • Add RTC_ATAMP_ASYNCPRES_RTCCLK_2048 macro
  • HAL SMBUS_EX driver
    • Add IS_SMBUS_TRIG_INPUT_INSTANCE define
  • HAL USB driver
    • Add __HAL_HCD_SET_HC_CSPLT, __HAL_HCD_CLEAR_HC_CSPLT and __HAL_HCD_CLEAR_HC_SSPLT macros
    • Add HAL_HCD_HC_SetHubInfo and HAL_HCD_HC_ClearHubInfo macros

LL Drivers updates

  • LL ADC driver
    • Add ADC4_OVERSAMPLING_RATIO_PARAMETER and ADC4_OVERSAMPLING_RATIO_PARAMETER_MASK defines
  • LL BUS driver
    • Add LL_APB2_GRP1_PERIPH_USB_FS define
  • LL EXTI driver
    • Add LL_EXTI_LockAttributes and LL_EXTI_GetLockAttributes functions
  • LL I2C driver
    • Add LL_I2C_EnableAutoClearFlag_ADDR, LL_I2C_DisableAutoClearFlag_ADDR, LL_I2C_IsEnabledAutoClearFlag_ADDR, LL_I2C_EnableAutoClearFlag_STOP, LL_I2C_DisableAutoClearFlag_STOP, LL_I2C_IsEnabledAutoClearFlag_STOP functions
  • LL PWR driver
    • Add LL_PWR_EnableOTGHSPHYLowPowerRetention, LL_PWR_DisableOTGHSPHYLowPowerRetention and LL_PWR_IsEnabledOTGHSPHYLowPowerRetention functions
    • Add LL_PWR_EnableVDD11USB, LL_PWR_DisableVDD11USB and LL_PWR_IsEnabledVDD11USB functions
  • LL RCC driver
    • Add LL_RCC_IsEnabledPLLMode function
  • LL RTC driver
    • Add LL_RTC_TAMPER_ATAMP_ASYNCPRES_RTCCLK_2048 define
    • Add ISO_SPLT_MPS, HCSPLT_BEGIN, HCSPLT_MIDDLE, HCSPLT_END and HCSPLT_FULL defines
  • LL USB driver
    • Add USB_EMBEDDED_PHY define
  • LL UTILS driver
    • Add LL_UTILS_PACKAGETYPE_UFBGA100_SMPS, LL_UTILS_PACKAGETYPE_WLCSP56_SMPS and LL_UTILS_PACKAGETYPE_WLCSP150_SMPS defines

Note: HAL/LL Backward compatibility ensured by legacy defines.

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • HAL and LL drivers Maintenance Release for STM32U575xx / STM32U585xx devices and new support of STM32U595xx, STM32U5A5xx, STM32U599xx and STM32U5A9xx devices
  • Add New LTDC, GFXMMU, DSI, GPU2D HAL drivers highlighting the graphics aspect of STM32U595/STM32U5A5/STM32U599/STM32U5A9 devices
  • Add New HAL XSPI driver which supports OCTOSPI and Hexa-Deca SPI interface for both STM32U575/STM32U585 and STM32U595/STM32U5A5/STM32U599/STM32U5A9 devices
  • All the HAL/LL drivers are updated to support both STM32U575/STM32U585 and STM32U595/STM32U5A5/STM32U599/STM32U5A9 devices
  • General updates to fix known defects and implementation enhancements
  • The HAL and LL drivers provided within this package are MISRA-C, MCU ASTYLE and CodeSonar compliant, and have been reviewed with a static analysis tool to eliminate possible run-time errors

HAL Drivers updates

  • All the HAL drivers are updated to support both STM32U575/STM32U585 and STM32U595/STM32U5A5/STM32U599/STM32U5A9 devices
  • HAL ADC driver
    • Add the following functions:
      • HAL_ADCEx_MultiModeStart_DMA_Data32()
      • HAL_ADCEx_MultiModeGetValue_Data32()
    • Update the DMA data length management implementation according to source/destination width
    • Enhance HAL_ADCEx_Calibration_GetValue() function implementation for proper ADC4 instance support
    • Enhance HAL_ADC_DeInit() and HAL_ADC_ConfigChannel() function implementation
  • HAL DCACHE driver
    • Add HAL_DCACHE_IsEnabled API to check whether the DCACHE is enabled or not
    • Enhance HAL_DCACHE_UnRegisterCallback() API
    • Enhance the timeout management
    • Enhance error code management by :
      • Resetting DCACHE handle error code any time a new operation is launched
      • Adding HAL_DCACHE_ERROR_INVALID_OPERATION error code: used in HAL_DCACHE_SetReadBurstType() API when DCACHE is enabled
      • Adding HAL_DCACHE_ERROR_EVICTION_CLEAN error code: used in HAL_DCACHE_IRQHandler() API when DCACHE error interrupt flag is set
    • Change the returned HAL status when there is an ongoing operation from HAL_ERROR to HAL_BUSY
    • Change DCACHE handle state to HAL_DCACHE_STATE_READY any time a new operation is launched
  • HAL DMA driver
    • Enhance LinkAllocatedPort implementation
  • HAL GPIO driver
    • Reorder EXTI configuration in HAL_GPIO_Init() API
  • HAL GTZC driver
    • Rename GTZC_PERIPH_DCMI define to GTZC_PERIPH_DCMI_PSSI
  • HAL driver
    • Add the following functions:
      • HAL_SYSCFG_SetOTGPHYReferenceClockSelection()
        • HAL_SYSCFG_SetOTGPHYPowerDownConfig()
        • HAL_SYSCFG_EnableOTGPHY()
      • HAL_SYSCFG_EnableVddCompensationCell()
        • HAL_SYSCFG_EnableVddIO2CompensationCell()
        • HAL_SYSCFG_EnableVddHSPICompensationCell()
        • HAL_SYSCFG_DisableVddCompensationCell()
        • HAL_SYSCFG_DisableVddIO2CompensationCell()
        • HAL_SYSCFG_DisableVddHSPICompensationCell()
  • HAL HCD driver
    • Fix handling of ODDFRM bit in OTG_HCCHARx for Isochronous IN transactions
  • HAL ICACHE driver
    • Add HAL_ICACHE_IsEnabled() API to check whether the ICACHE is enabled or not
  • HAL LPTIM driver
    • Add HAL_LPTIM_IC_GetOffset() function
    • Rename HAL_LPTIM_ReadCompare to HAL_LPTIM_ReadCapturedValue
    • Add parameters checks in HAL_LPTIM_xxx_Start_DMA functions
  • HAL MMC driver
    • Add the following functions:
      • HAL_MMC_SleepDevice()
      • HAL_MMC_AwakeDevice()
  • HAL PCD driver
    • Add the following functions:
      • HAL_PCD_EP_Abort()
      • HAL_PCD_SetTestMode()
    • Correct received transfer length with USB DMA activated
    • Add handling of USB OUT Endpoint disable interrupt
    • Fix device IN endpoint isoc incomplete transfer interrupt handling
    • Fix USB device Isoc OUT Endpoint incomplete transfer interrupt handling
    • Set DCD timeout to minimum value of 300ms before starting BCD primary detection process
  • HAL PWR driver
    • Add the following functions:
      • HAL_PWREx_EnableUSBHSTranceiverSupply()
      • HAL_PWREx_DisableUSBHSTranceiverSupply()
      • Rename PWR_SRAMx_PAGEx_MODE_RETENTION to PWR_SRAMx_PAGEx_MODE
  • HAL RCC driver
    • Enhance HAL_RCC_ClockConfig() function implementation
    • Update HAL_RCC_OscConfig() function implementation on PWR clocking control
    • Update HAL_RCC_OscConfig() function implementation to be tolerant to an identical PLL1 parameters re-configuration
    • Enhance of PLL1 outputs clearing time in HAL_RCC_OscConfig()
    • Remove RCC_PLL_SOURCE_NONE from correct parameters list on PLL1 configuration
    • Rename RCC_PERIPHCLK_CLK48 to RCC_PERIPHCLK_ICLK defines
    • Rename RCC_CLK48CLKSOURCE_XXX to RCC_ICLK_CLKSOURCE_XXX defines
    • Rename __HAL_RCC_ADC1_XXX_YYY to __HAL_RCC_ADC12_XXX_YYY macros
    • Rename __HAL_RCC_USB_OTG_FS_CLK_XXX to __HAL_RCC_USB_CLK_XXX macros
    • Rename Clk48ClockSelection to IclkClockSelection in RCC_PeriphCLKInitTypeDef
  • HAL SPI driver
    • Fix compilation warning with GNU compiler
  • HAL TIM driver
    • Add IS_TIM_PERIOD macro in HAL_TIM_xxx_Init functions
  • HAL UART driver
    • Rework HAL_UART_DMAPause() function in order to use DMA instead of UART to pause data transfer
    • Rework HAL_UART_DMAResume() function in order to use DMA instead of UART to resume data transfer
  • HAL USART driver
    • Rework HAL_USART_DMAPause() function in order to use DMA instead of USART to pause data transfer
    • Rework HAL_USART_DMAResume() function in order to use DMA instead of USART to resume data transfer

LL Drivers updates

  • All the LL drivers are updated to support both STM32U575/STM32U585 and STM32U595/STM32U5A5/STM32U599/STM32U5A9 devices
  • LL ADC driver
    • Add the following functions:
      • LL_ADC_SetVrefProtection()
      • LL_ADC_GetVrefProtection()
  • LL I2C driver
    • Add I2C instances 5 and 6 configuration within LL driver
  • LL LPTIM driver
    • Add LL_LPTIM_IC_GET_OFFSET macro
    • Rename the following static inline functions:
      • LL_LPTIM_SetCompareCH1 to LL_LPTIM_OC_SetCompareCH1
      • LL_LPTIM_SetCompareCH2 to LL_LPTIM_OC_SetCompareCH2
      • LL_LPTIM_GetCompareCH1 to LL_LPTIM_OC_GetCompareCH1
      • LL_LPTIM_GetCompareCH2 to LL_LPTIM_OC_GetCompareCH2
  • LL OPAMP driver
    • Add __LL_OPAMP_COMMON_INSTANCE macro
  • LL LPUART driver
    • Add LL_LPUART_RequestTxDataFlush macro
  • LL RCC driver
    • Add the following functions:
      • LL_RCC_SetUSBPHYClockSource()
      • LL_RCC_PLL3_EnableDomain_HSPI_LTDC()
      • LL_RCC_PLL3_DisableDomain_HSPI_LTDC()
      • LL_RCC_PLL3_ConfigDomain_HSPI_LTDC()
      • LL_RCC_PLL1_IsEnabledDomain_SAI()
      • LL_RCC_PLL1_IsEnabledDomain_48M()
      • LL_RCC_PLL1_IsEnabledDomain_SYS()
      • LL_RCC_PLL2_IsEnabledDomain_SAI()
      • LL_RCC_PLL2_IsEnabledDomain_48M()
      • LL_RCC_PLL2_IsEnabledDomain_ADC()
      • LL_RCC_PLL3_IsEnabledDomain_SAI()
      • LL_RCC_PLL3_IsEnabledDomain_48M()
      • LL_RCC_PLL3_IsEnabledDomain_HSPI_LTDC()
    • Enhance the following functions implementation:
      • LL_RCC_GetUSARTClockFreq(): Fix LPUART1 returned frequency when PCLK3 is set as clock source
      • LL_RCC_GetPPPClockFreq: Add check of PLL output enable bit status
    • Rename the macro __LL_RCC_CALC_PLL3CLK_HSPI_FREQ to __LL_RCC_CALC_PLL3CLK_HSPI_LTDC_FREQ
    • Rename the static API RCC_PLL3_GetFreqDomain_HSPI to RCC_PLL3_GetFreqDomain_HSPI_LTDC
    • Rename LL_RCC_USART6_CLKSOURCE_PCLK2 to LL_RCC_USART6_CLKSOURCE_PCLK1
  • LL SDMMC driver
    • Add SDMMC_TRANSFER_MODE_SDIO define
    • Add SDMMC_CmdBlockCount function
  • LL RTC driver
    • Add LL_RTC_IsActiveFlag_ITAMP7() function
  • LL USART driver
    • Add USART instance 6 configuration within LL driver
  • LL USB driver
    • Add USB_EPStopXfer() function

Backward compatibility ensured by legacy defines

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • Patch release V1.0.2 of HAL and LL drivers for STM32U575xx / STM32U585xx devices

LL Drivers updates

  • LL DAC driver
    • Rename of the LPTIM1/3 trigger of the LL DAC to be in line with Reference Manual:
      • Rename LL_DAC_TRIG_EXT_LPTIM1_OUT to LL_DAC_TRIG_EXT_LPTIM1_CH1
      • Rename LL_DAC_TRIG_EXT_LPTIM3_OUT to LL_DAC_TRIG_EXT_LPTIM3_CH1
  • Backward compatibility ensured by legacy defines

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • Patch release V1.0.1 of HAL and LL drivers for STM32U575xx / STM32U585xx devices

HAL Drivers updates

  • HAL ADC driver
    • Update the DMA data length management implementation according source/destination width
    • Finetune HAL_ADCEx_Calibration_GetValue API to return correct calibration value for ADC4
  • HAL DAC driver
    • Rename of the LPTIM1/3 trigger of the DAC to be in line with Reference Manual:
      • Rename DAC_TRIGGER_STOP_LPTIM1_OUT to DAC_TRIGGER_STOP_LPTIM1_CH1
      • Rename DAC_TRIGGER_STOP_LPTIM3_OUT to DAC_TRIGGER_STOP_LPTIM3_CH1
      • Rename DAC_TRIGGER_LPTIM1_OUT to DAC_TRIGGER_LPTIM1_CH1
      • Rename DAC_TRIGGER_LPTIM3_OUT to DAC_TRIGGER_LPTIM3_CH1
  • HAL DMA driver
    • Fix DMA register callback error returning in case of invalid callback.
    • Enhance HAL_DMA_GetLockChannelAttributes API implementation to detect wrong parameters values
    • Enhance IS_DMA_ATTRIBUTES macro implementation to detect uncovered cases.
    • Optimize DMA_List_CheckNodesBaseAddresses API implementation by reducing parameters number
    • Optimize DMA_List_CheckNodesTypes API implementation by reducing parameters number
  • HAL GTZC driver
    • Fix issue with the APIs HAL_GTZC_MPCBB_ConfigMem : The CFGLOCK register should be updated after the update of SECCFGR and PRIVCFGR
  • HAL I2C driver
    • Add handle errors support in polling mode
  • HAL RCC driver
    • Fix setting Flash latency from MSIRange in Oscillator Configuration

LL Drivers updates

  • LL I2C driver
    • Add LL_I2C_EnableFastModePlus, LL_I2C_DisableFastModePlus and LL_I2C_IsEnabledFastModePlus APIs

Known Limitations

  • N/A

Backward compatibility

  • N/A

Main Changes

  • First official release of HAL and LL drivers for STM32U575xx / STM32U585xx devices

Known Limitations

  • N/A