Back to Release page

# Release Notes for STM32F3xx HAL Drivers

Copyright 2014 STMicroelectronics

## Update History

### V1.1.0 / 12-Sept-2014

Main Changes

- First official release of STM32F3xx HAL drivers for STM32F303xE, STM32F302xE and STM32F398xx devices.
- HAL generic update

- Add support of new devices STM32F302xE and STM32F398xx in STM32F3xx HAL drivers

- HAL ADC

- Empty weak function return HAL_ERROR

- Misra error corrections

- HAL CORTEX

- Macro IS_SYSTICK_CLKSOURCE renamed IS_SYSTICK_CLK_SOURCE

- HAL DAC

- Empty weak function return HAL_ERROR

- HAL IWDG

- Minor updates (HAL coding rules)

- HAL PCD

- Changed IN/OUT EndPoint parameter array size (PCD Handle Structure)

- HAL RCC

- RCC_MCOSOURCE_PLLCLK_DIV1 define added to RCC_MCO_Clock_Source defgroup for the following devices: STM32F302xE, STM32F303xE, STM32F398xx, STM32F303x8, STM32F328xx, STM32F301x8, STM32F302x8 and STM32F318xx

- HAL SPI

- Removed HAL_ prefix from static function names

- HAL TIM

- Checked DeadTime value in debug mode
- Add new macros __HAL_TIM_URS_ENABLE() and __HAL_TIM_URS_DISABLE()

- HAL WWDG

- Minor updates (HAL coding rules)
- Added macro __HAL_WWDG_CLEAR_IT()
- Use MODIFY_REG() macro to set Prescaler, Window and Counter registers within HAL_WWDG_Init()

### V1.1.0RC2 / 25-August-2014

Main Changes

- HAL generic update

- General improvement of Doxygen Tags for CHM UM generation
- Add support of new devices STM32F303xE in STM32F3xx HAL driver

- HAL update (for STM32F303xE)

- Add new defines for ADC trigger remapping (HAL_REMAPADCTRIGGER_x)
- Add new defines for CCM RAM page write protection (up to 16 pages can be write protected)
- Add new macro IS_HAL_REMAPADCTRIGGER()
- Updated macro IS_HAL_SYSCFG_WP_PAGE ()
- Add new macros to freeze/unfreeze TIM20 in debug mode: __HAL_FREEZE_TIM20_DBGMCU() and __HAL_UNFREEZE_TIM20_DBGMCU()
- Add new macro to remap the FMC banks 1 and 2 at 0x00000000 : __HAL_FMC_BANK()
- Add new macros to enable/disable ADC trigger remapping: __HAL_REMAPADCTRIGGER_ENABLE() and __HAL_REMAPADCTRIGGER_DISABLE()

- HAL ADC update (for STM32F303xE)

- Add new defines for TIM20 related ADC external triggers for regular groups (ADC_EXTERNALTRIGCONV_T20_x)
- Add new defines for TIM20 related ADC external triggers for injected groups (ADC_EXTERNALTRIGINJECCONV_T20_x)
- Updated macro __HAL_ADC_CFGR_EXTSEL() to take into account TIM20 related ADC triggers for regular channels
- Updated macro __HAL_ADC_JSQR_JEXTSEL() to take into account TIM20 related ADC triggers for injected channels

- HAL COMP update

- Defect correction:

- Missing assert param IS_COMP_TRIGGERMODE

- STM32F303xE:

- Add new defines for comparator output redirection: COMP_OUTPUT_TIM20BKIN, COMP_OUTPUT_TIM20BKIN2, COMP_OUTPUT_TIM1BKIN2_TIM8BKIN2_TIM20BKIN2 and COMP_OUTPUT_TIM20OCREFCLR

- HAL FLASH update (for STM32F303xE)

- Add new defines for write protection of pages 32 to 61 and 62-263 (OB_WRP_PAGESxxTOyy)

- HAL GPIO update (for STM32F303xE)

- Add new defines for TIM20 and FMC related AF: GPIO_AF2_TIM20, GPIO_AF3_TIM20, GPIO_AF6_TIM20 and GPIO_AF12_FMC

- HAL IRDA update

- TC enabled and TXE disabled at the end of TX in IT mode

- HAL HAL NAND (STM32F303xE specific)

- FMC: generic firmware to drive NAND memories mounted as external device

- HAL NOR (STM32F303xE specific)

- FMC: generic firmware to drive NOR memories mounted as external device

- HAL PCCARD (STM32F303xE specific)

- FMC: generic firmware to drive PCCARD memories mounted as external device

- HAL PCD update

- Add new macros __HAL_USB_EXTI_GET_FLAG() , __HAL_USB_EXTI_CLEAR_FLAG(), __HAL_USB_EXTI_SET_RISING_EDGE_TRIGGER(), __HAL_USB_EXTI_SET_FALLING_EDGE_TRIGGER() and _HAL_USB_EXTI_SET_FALLINGRISING_TRIGGER()

- HAL PWR update

- PVD feature need falling/rising Event modes

- Rename defines:

- PWR_MODE_EVT to PWR_PVD_MODE_NORMAL
- PWR_MODE_IT_RISING to PWR_PVD_MODE_IT_RISING
- PWR_MODE_IT_FALLING to PWR_PVD_MODE_IT_FALLING
- PWR_MODE_IT_RISING_FALLING to PWR_PVD_MODE_IT_RISING_FALLING
- PWR_MODE_IT_RISING to PWR_PVD_MODE_IT_RISING

- Add new defines: PWR_PVD_MODE_EVENT_RISING, PWR_PVD_MODE_EVENT_FALLING and PWR_PVD_MODE_EVENT_RISING_FALLING
- Changed __HAL_PVD_EXTI_ENABLE_IT() macro definition: __EXTILINE__ argument no longer needed (PWR_EXTI_LINE_PVD is used implicitly)
- Changed __HAL_PVD_EXTI_DISABLE_IT() macro definition: __EXTILINE__ argument no longer needed (PWR_EXTI_LINE_PVD is used implicitly)
- Changed __HAL_PVD_EXTI_GET_FLAG () macro definition: __EXTILINE__ argument no longer needed (PWR_EXTI_LINE_PVD is used implicitly)
- Changed _HAL_PVD_EXTI_CLEAR_FLAG () macro definition: __EXTILINE__ argument no longer needed (PWR_EXTI_LINE_PVD is used implicitly)
- Add new macros __HAL_PWR_PVD_EXTI_ENABLE_EVENT(), __HAL_PWR_PVD_EXTI_DISABLE_EVENT(), __HAL_PWR_PVD_EXTI_CLEAR_EGDE_TRIGGER(), __HAL_PWR_PVD_EXTI_SET_FALLING_EGDE_TRIGGER() and __HAL_PWR_PVD_EXTI_SET_RISING_EDGE_TRIGGER()

- HAL RCC update (for STM32F303xE)

- RCC_OcsInitTypeDef and RCC_PLLInitTypeDef definitions are now product dependent:

- STM32F303xE:

- Added PREDIV field to RCC_PLLInitTypeDef: used to set the desired pre-division factor whatever the PLL clock source is (HSI or HSE).
- Removed field HSEPredivValue from RCC_OscInitTypeDef (replaced by PREDIV field in RCC_PLLInitTypeDef)

- Other F3 products: no change in RCC_OcsInitTypeDef and RCC_PLLInitTypeDef definitions

- Add new definition of RCC_PeriphCLKInitTypeDef to fit STM32F303xE clock selection capabilities (e.g select TIM20 clock source)
- Add new defines to select the pre-division factor (RCC_PREDIV_DIVx)
- Add new defines to set TIM20 clock source (RCC_PERIPHCLK_TIM20, RCC_TIM20CLK_HCLK and RCC_TIM20CLK_PLLCLK)
- Add new defnes to set TIM3 & TIM4 clock source (RCC_PERIPHCLK_TIM34, RCC_TIM34CLK_HCLK, RCC_TIM34CLK_PCLK)
- Add FMC related macros: __FMC_CLK_ENABLE(), __FMC_CLK_DISABLE(), __FMC_FORCE_RESET() and __FMC_RELEASE_RESET()
- Add GPIO port G related macros: __GPIOG_CLK_ENABLE(), __GPIOG_CLK_DISABLE(), __ GPIOG _FORCE_RESET() and __GPIOG _RELEASE_RESET()
- Add GPIO port H related macros:_ __GPIOH_CLK_ENABLE(), __GPIOH_CLK_DISABLE(), __FMC_ GPIOH _RESET() and __GPIOH _RELEASE_RESET()
- Add SPI4 related macros: __SPI4_CLK_ENABLE(), __SPI4_CLK_DISABLE(), __ SPI4_FORCE_RESET() and __SPI4_RELEASE_RESET()
- Add TIM20 related macros: __TIM20_CLK_ENABLE(), __TIM20_CLK_DISABLE(), __ TIM20_FORCE_RESET() and __TIM20_RELEASE_RESET(), __HAL_RCC_TIM20_CONFIG() , __HAL_RCC_GET_TIM20_SOURCE()
- Add new macro to set/get the clock source of TIM3 & TIM4: __HAL_RCC_TIM34_CONFIG() and __HAL_RCC_GET_TIM34_SOURCE()

- HAL SMARTCARD update

- Change SMARTCARD_AdvFeatureConfig() from exported to static private function

- TC enabled and TXE disabled at the end of TX in IT mode

- HAL SMBUS update

- Fix wrong State after a PEC failed
- Fix slave acknowledge issue

- HAL SPI update

- Fix CodeSonar warning: unreachable Call in SPI_CloseRxTx_ISR()

- HAL SRAM (STM32F303xE specific)

- FMC: generic firmware to drive SRAM memories mounted as external device

- HAL TIM update (for STM32F303xE)

- Add defines to set TIM20 option register (link from analog watchdog and TIM20 ETR)

- HAL UART update

- TC enabled and TXE disabled at the end of TX in IT mode

- HAL USART update

- TC enabled and TXE disabled at the end of TX in IT mode

### V1.0.1 / 18-June-2014

Main Changes

- HAL generic update

  - Fix flag clear procedure: use atomic write operation "=" instead of ready-modify-write operation "|=" or "&="
  - Fix on Timeout management, Timeout value set to 0 passed to API automatically exits the function after checking the flag without any wait.
  - Add new macro __HAL_RESET_HANDLE_STATE to reset a given handle state.

- HAL ADC update

- Rename defines:

- ADC_EXTERNALTRIGCONV_Ext_IT11 to ADC_EXTERNALTRIGCONV_EXT_IT11
- ADC_EXTERNALTRIGCONV_Ext_IT12 to ADC_EXTERNALTRIGCONV_EXT_IT12

- Fix define ADC_SOFTWARE_START
- Update external trigger defines to remove HRTIM triggers for STM32F328xx and TIM8 triggers for STM32F302xC
- Add ADC1_2_EXTERNALTRIG_T4_CC4 for STM32F303x8 and STM32F328xx

- HAL CEC update

- Process no more locked during the transmission in interrupt mode.

- HAL COMP update

- Fix on 32-bit register COMP CSR accesses for STM32F373xC and STM32F378xx devices.
- Add new defines for STM32F373xC and STM32F378xx comparators:

COMP_OUTPUT_TIM3IC1, COMP_OUTPUT_TIM3OCREFCLR, COMP_OUTPUT_TIM2IC4 and COMP_OUTPUT_TIM2OCREFCLR
instead of previous defines
COMP_OUTPUT_COMP1_TIM3IC1, COMP_OUTPUT_COMP1_TIM3OCREFCLR, COMP_OUTPUT_COMP1_TIM2IC4, COMP_OUTPUT_COMP1_TIM2OCREFCLR,
COMP_OUTPUT_COMP2_TIM3IC1, COMP_OUTPUT_COMP2_TIM3OCREFCLR, COMP_OUTPUT_COMP2_TIM2IC4, COMP_OUTPUT_COMP2_TIM2OCREFCLR.

- HAL DMA update

- Fix in HAL_DMA_PollForTransfer() to set error code HAL_DMA_ERROR_TE in case of HAL_ERROR status

- HAL GPIO update

  - Fix GPIO_AF5_SPI1 define instead of GPIO_AF5_SPI1 for STM32F303x8 device.

- HAL HRTIM update

- HRTIM peripheral not available for STM32F328xx device.
- Fix macros __HAL_HRTIM_CLEAR_FLAG, __HAL_HRTIM_MASTER_CLEAR_FLAG and __HAL_HRTIM_TIMER_CLEAR_FLAG

- HAL I2C update

- Add management of NACK event in Master transmitter mode and Slave transmitter/receiver modes (only in polling mode), in that case the current transfer is stopped.

- HAL IRDA update

  - Add new enum typedef IRDA_ClockSourceTypeDef
  - Add new macro __HAL_IRDA_GETCLOCKSOURCE
  - Change in HAL_IRDA_Transmit_IT() to enable IRDA_IT_TXE instead of IRDA_IT_TC.
  - Process no more locked during the transmission in interrupt mode.

- HAL OPAMP update

- __SYSCFG_CLK_ENABLE() is now handled internally in HAL_OPAMP_Init() and no more in user HAL_OPAMP_MspInit().

- HAL PCD update

- Add new macro __HAL_USB_EXTI_GENERATE_SWIT

- HAL PWR update

- Fix in HAL_PWR_EnterSTANDBYMode() to not clear Wakeup flag (WUF), which need to be cleared at application level before to call this function

- HAL RCC update

- Change for STM32F303x8, STM32F334x8 and STM32F328xx devices:

- Add missing macro __DAC2_FORCE_RESET

- Rename RCC_USART1CLKSOURCE_PCLK2 into RCC_USART1CLKSOURCE_PCLK1

- Remove HRTIM1 peripheral and clocking macros for STM32F328xx device.
- Fix HSI Calibration issue when selected as SYSCLK

- HAL SMARTCARD update

- Change in HAL_SMARTCARD_Transmit_IT() to enable SMARTCARD_IT_TXE instead of SMARTCARD_IT_TC.
- Process no more locked during the transmission in interrupt mode.

- HAL SMBUS update

- Fix Slave acknowledge issue: Slave should ack each bit and so stretch the line till the bit is not ack

- HAL TIM update

- Fix macro __HAL_TIM_PRESCALER

- HAL TSC update

- Fix define TSC_ACQ_MODE_SYNCHRO

- HAL UART update

- Change in HAL_LIN_Init() parameter BreakDetectLength to uint32_t
- Change in HAL_UART_Transmit_IT() to enable UART_IT_TXE instead of UART_IT_TC.
- Process no more locked during the transmission in interrupt mode.

- HAL USART update

- Change USART_InitTypeDef fields to uint32_t type
- Rename __USART_ENABLE and __USART_DISABLE macros to respectively __HAL_USART_ENABLE and __HAL_USART_DISABLE
- Change in HAL_USART_Transmit_IT() to enable USART_IT_TXE instead of USART_IT_TC.
- Process no more locked during the transmission in interrupt mode.
- Change in HAL_USART_TransmitReceive_DMA() to manage DMA half transfer mode

### V1.0.0 / 06-May-2014

Main Changes

- First official release of STM32F3xx HAL drivers for STM32F301x6/x8, STM32F302x6/x8, STM32F302xB/xC, STM32F303x6/x8, STM32F373xB/xC, STM32F334x4/x6/x8, STM32F318xx, STM32F328xx, STM32F358xx and STM32F378xx devices.

## License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived

from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

For complete documentation on STM32 Microcontrollers visit www.st.com/STM32