Release Notes for

STM32WBAxx HAL Drivers

Copyright © 2022 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

Official Release of STM32CubeWBA Firmware package supporting STM32WBA52xx and STM32WBA55xx devices

Contents

Official Release of HAL/LL Drivers for STM32WBAxx serie

  • HAL/LL Drivers are available for all peripherals:
    • HAL: ADC, COMP, CORTEX, CRC, CRYP, DMA, EXTI, FLASH, GPIO, GTZC, HASH, HSEM, I2C, ICACHE, IRDA, IWDG, LPTIM, PKA, PWR, RAMCFG, RCC, RNG, RTC, SAI, SMARTCARD, SMBUS, SPI, TIM, TSC, UART, USART, WWDG
    • LL: ADC, COMP, CRC, DMA, EXTI, GPIO, I2C, ICACHE, LPTIM, LPUART, PKA, PWR, RCC, RNG, RTC, SPI, TIM, USART, UTILS
  • Update HAL/LL drivers to include latest corrections


HAL Drivers updates

  • HAL CORTEX driver
    • Add functions to configure MPU region without enabling it
  • HAL I2C driver
    • Update HAL_I2C_Slave_Transmit to check if the received NACK is the correct one
    • Update SMBUS_ITErrorHandler to flash TXDR just in case of error
  • HAL RCC driver
    • Add note for Backup domain access to be enabled for RCC_PERIPHCLK_RADIOST use in HAL_RCCEx_PeriphCLKConfig()
  • HAL RTC driver
    • Update access to the SCR register now done via a one-shot write access
  • HAL TIM driver
    • Remove not supported TIM_CLOCKSOURCE_ITR3, TIM_CLOCKSOURCE_ITR9 and TIM_CLOCKSOURCE_ITR10 constants
    • Update HAL_TIM_ConfigOCrefClear() function to check if SMCR.OCCS bit-field is supported by the current instance before updating registers
  • HAL TSC driver
    • Modify assert to track the fordidden prescaler related to DT duration


LL Drivers updates

  • LL LPUART driver
    • Add LL LPUART API allowing TX FIFO flush request


Supported Devices and boards

  • STM32WBA52xx and STM32WBA55xx devices
  • NUCLEO-WBA52CG, NUCLEO-WBA55CG and STM32WBA55G-DK1 boards

Backward compatibility

  • Not applicable

Known Limitations

  • None

Dependencies

  • None

Notes

  • None

Main Changes

Official Release of STM32CubeWBA Firmware package supporting STM32WBA52xx and STM32WBA55xx devices

Contents

Official Release of HAL/LL Drivers for STM32WBAxx serie

  • HAL/LL Drivers are available for all peripherals:
    • HAL: ADC, COMP, CORTEX, CRC, CRYP, DMA, EXTI, FLASH, GPIO, GTZC, HASH, HSEM, I2C, ICACHE, IRDA, IWDG, LPTIM, PKA, PWR, RAMCFG, RCC, RNG, RTC, SAI, SMARTCARD, SMBUS, SPI, TIM, TSC, UART, USART, WWDG
    • LL: ADC, COMP, CRC, DMA, EXTI, GPIO, I2C, ICACHE, LPTIM, LPUART, PKA, PWR, RCC, RNG, RTC, SPI, TIM, USART, UTILS
  • Update SysTick clock source management to handle HCLK, HCLK/8, LSI and LSE sources
    • The SysTick clock source shall be configured with HAL_SYSTICK_CLKSourceConfig()
    • New implementation allowing to not re-initialize the SysTick in RCC after HCLK change if the SysTick source is LSI or LSE
    • Add support of HAL_SYSTICK_GetCLKSourceConfig() API to return the selected SYSTICK clock source set with HAL_SYSTICK_CLKSourceConfig()


HAL Drivers updates

  • HAL CORTEX driver
    • Check preemption priority and subpriority versus current priority grouping
    • Remove check of __MPU_PRESENT flag in HAL CORTEX
    • Add support of HAL_SYSTICK_GetCLKSourceConfig() API to return the selected SYSTICK clock source set with HAL_SYSTICK_CLKSourceConfig()
  • HAL DMA driver
    • Update HAL_DMA_GetConfigChannelAttributes() to return DMA attributes even when TZEN=0
    • Update HAL_DMA_IRQHandler() to remove unnecessary hardware flag check upon suspend interrupt management
  • HAL FLASH driver
    • Update HAL FLASH API to support ECC management
  • HAL GPIO driver
    • Update HAL_GPIO_Init() using CMSIS definitions
    • Update GetConfigPinAttributes() to ensure it is used on a single pin
  • HAL I2C driver
    • Update HAL_I2C_Mem_Write_IT() to initialize XferSize at 0
    • Update HAL I2C driver to disable all interrupts after end of transaction
    • 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
    • Update HAL_I2C_IsDeviceReady() function to remove unusable code
  • HAL ICACHE driver
    • Update description of HAL_ICACHE_Enable() function
    • Update HAL_ICACHE_DeInit() to set registers to their reset value
    • Update HAL_ICACHE_Invalidate() to prevent launching an invalidation if one has already been launched
  • HAL PKA driver
    • Update HAL_PKA_IRQHandler() to fix MISRA C:2012-Rule-10.3, and Rule-10.4_a warnings
  • HAL RCC driver
    • Rename RCC_SYSTICKCLKSOURCE_HSI to RCC_SYSTICKCLKSOURCE_HSI_DIV4
    • Update HAL_RCC_NMI_IRQHandler() to clear flag before callback
  • HAL SAI driver
    • Improve audio quality (avoid potential glitch)
  • HAL SMARTCARD driver
    • Fix CONSTANT_EXPRESSION_RESULT coverity warning
  • HAL SMBUS driver
    • Remove default value to solve MISRA warning
  • HAL SPI driver
    • In Full Duplex mode, calling HAL_SPI_TransmitReceive_DMA() can generate a RX HDMA busy if HDMA TX is not well initialized. To avoid this, now a DMA abort is done on RX path to reset HDMA RX to ready state.
    • Add a check before send a Tx to not exceed RxFifo capacity
    • Update IT API to enable interrupts after process unlock
    • Remove HAL Lock/UnLock mechanism inside HAL_SPI_RegisterCallback and HAL_xxx_UnRegisterCallback functions
  • HAL SYSCFG driver
    • Update assert macro in HAL_SYSCFG_GetConfigAttributes() for accurate argument filtering
    • Allow HAL_SYSCFG_GetConfigAttributes() to be available in both secure and non-secure mode
  • HAL TIM driver
    • Fix MISRA warning in TIM_CCxNChannelCmd
    • Generalize bidirectional break input(s) configuration
    • Update HAL_TIM_IRQHandler() to clear System break interrupt flag
    • Update TIM_Base_SetConfig() to clear IUF flag after a software update triggered by HAL
    • Update HAL_TIMEx_OCN_Stop_IT() and HAL_TIMEx_PWMN_Stop_IT() using TIM_CCER_CCxNE_MASK definitions
    • Improve HAL_TIMEx_ConfigBreakDeadTime() function implementation
    • Update TIM_DMAErrorCCxN() to handle CH4N support
  • HAL UART driver
    • Fix incorrect gState check in HAL_UART_RegisterRxEventCallback()/HAL_UART_UnRegisterRxEventCallback() to allow user Rx Event Callback registration when a transmit is ongoing
    • Avoid RTOF flag to be cleared by a transmit process in polling mode


LL Drivers updates

  • LL GPIO driver
    • Update LL_GPIO_SetPinMode() using CMSIS definitions
  • LL I2C driver
    • Update LL_I2C_HandleTranfer() function to prevent undefined behavior of volatile usage before updating the CR2 register
  • LL RTC driver
    • Update comments about RTC shadow registers
  • LL TIM driver
    • Remove support for LL_TIM_ReArmBRK() and LL_TIM_ReArmBRK2()
    • Add new function LL_TIM_CC_IsEnabledPreload()
    • Update LL_TIM_BDTR_Init() implementation
    • Update OCxConfig() functions to configure complementary channels only when supported
    • Remove LL_TIM_TIM3_ETRSOURCE_TIM4_ETR definition


Supported Devices and boards

  • STM32WBA52xx and STM32WBA55xx devices
  • NUCLEO-WBA52CG, NUCLEO-WBA55CG and STM32WBA55G-DK1 boards

Backward compatibility

  • Not applicable

Known Limitations

  • None

Dependencies

  • None

Notes

  • None

Main Changes

Official Release of STM32CubeWBA Firmware package supporting STM32WBA52xx devices

Contents

Official Release of HAL/LL Drivers for STM32WBAxx serie

  • HAL/LL Drivers are available for all peripherals:
    • HAL: ADC, CORTEX, CRC, CRYP, DMA, EXTI, FLASH, GPIO, GTZC, HASH, HSEM, I2C, ICACHE, IRDA, IWDG, LPTIM, PKA, PWR, RAMCFG, RCC, RNG, RTC, SMARTCARD, SMBUS, SPI, TIM, TSC, UART, USART, WWDG
    • LL: ADC, CRC, DMA, EXTI, GPIO, I2C, ICACHE, LPTIM, LPUART, PKA, PWR, RCC, RNG, RTC, SPI, TIM, USART, UTILS


HAL Drivers updates

  • HAL CORTEX driver
    • Use synchronization barriers instead of memory barriers for MPU configuration (as recommended by ARM)
    • Update MPU_ACCESS_OUTER_SHAREABLE and LL_MPU_ACCESS_OUTER_SHAREABLE definitions
  • HAL CRYP driver
    • Update Crypt/Decrypt IT processes to avoid Computation Completed IRQ fires before DINR pointer increment
  • HAL DMA driver
    • Downsize LinkRegisters internal table from 8 to 6 for memory size optimization
    • Remove 2D addressing as not supported
    • Remove RepeatBlockConfig from DMA_NodeConfTypeDef structure and internal get function as not used
    • Update Assert checking the selected request. Assert can now also check in peripheral to memory case
    • Add missing TIM3 trigger and Request/trigger when I2C1, SAI1, AES, LPTIM2 feature available
  • HAL EXTI driver
    • Fix computation of pExtiConfig->GPIOSel in HAL_EXTI_GetConfigLine()
  • HAL Generic driver
    • Allow redefinition of macro UNUSED(x)
    • Move HAL version definition to HAL generic header file (stm32XXxx_hal.h)
  • HAL I2C driver
    • Update HAL_I2C_IsDeviceReady() to support 10-bit addressing mode
    • Update HAL I2C driver to disable all interrupts after end of transaction
    • Update HAL_I2C_Init() API to clear ADD10 bit in 7-bit addressing mode
  • HAL PWR driver
    • Remove __force_stores intrinsic keyword usage
  • HAL RTC driver
    • Remove useless polling of RTC_ICSR_WUTWF flag
    • Remove all useless RTC Write Protection Disable/Enable usage
    • Rework of HAL_RTC_GET_FLAG() macro implementation to return flag bit status
    • Rework of macro implementation to avoid confusion with parameters input
  • HAL TIM driver
    • Assert check for the right channels
    • Remove multiple volatile reads or writes in interrupt handler, for better performance
  • HAL TSC driver
    • Add parameter assertion depends on Duration time restriction link to product
  • HAL UART driver
    • Update initialisation sequence for TXINV, RXINV and TXRXSWAP settings


LL Drivers updates

  • LL DMA driver
    • Clarifies that Linked List Address Offset can be chosen by steps of 4 bytes within 0 to 0xFFFC range
    • Fix inversion in LL_DMA_ConfigChannelTransfer description parameter
  • LL ICACHE driver
    • Update LL_ICACHE_GetRegionBaseAddress() to return the complete address
  • LL RCC driver
    • Add LL_RCC_HSE_IsEnabledPrescaler() to check HSE prescaler status
  • LL TIM driver
    • Remove unnecessary change of MOE bitfield in LL_TIM_BDTR_Init()


Supported Devices and boards

  • STM32WBA52xx devices
  • NUCLEO-WBA52CG board

Backward compatibility

  • Not applicable

Known Limitations

  • None

Dependencies

  • None

Notes

  • None

Main Changes

First Official Release of STM32CubeWBA Firmware package supporting STM32WBA52xx devices

Contents

First Official Release of HAL/LL Drivers for STM32WBAxx serie

  • HAL/LL Drivers are available for all peripherals:
    • HAL: ADC, CORTEX, CRC, CRYP, DMA, EXTI, FLASH, GPIO, GTZC, HASH, HSEM, I2C, ICACHE, IRDA, IWDG, LPTIM, PKA, PWR, RAMCFG, RCC, RNG, RTC, SMARTCARD, SMBUS, SPI, TIM, TSC, UART, USART, WWDG
    • LL: ADC, CRC, DMA, EXTI, GPIO, I2C, ICACHE, LPTIM, LPUART, PKA, PWR, RCC, RNG, RTC, SPI, TIM, USART, UTILS


Supported Devices and boards

  • STM32WBA52xx devices
  • NUCLEO-WBA52CG board

Backward compatibility

  • Not applicable

Known Limitations

  • None

Dependencies

  • None

Notes

  • None