Back to Release page
# Release Notes for STM32F4xx HAL Drivers Copyright 2015 STMicroelectronics
## Update History ### V1.4.3 / 11-December-2015 Main Changes HAL Generic update Update HAL weak empty callbacks to prevent unused argument compilation warnings with some compilers by calling the following line: UNUSED(hppp); STM32Fxxx_User_Manual.chm files regenerated for HAL V1.4.3 HAL ETH update Update HAL_ETH_Init() function to add timeout on the Software reset management ### V1.4.2 / 10-November-2015 Main Changes General updates to fix known defects and enhancements implementation One change done on the HAL CRYP requires an update on the application code based on HAL V1.4.1 Update HAL_CRYP_DESECB_Decrypt() API to invert pPlainData and pCypherData parameters HAL generic update Update HAL weak empty callbacks to prevent unused argument compilation warnings with some compilers by calling the following line: UNUSED(hppp); HAL CORTEX update Remove duplication for __HAL_CORTEX_SYSTICKCLK_CONFIG() macro HAL HASH update Rename HAL_HASH_STATETypeDef to HAL_HASH_StateTypeDef Rename HAL_HASH_PhaseTypeDef to HAL_HASH_PhaseTypeDef HAL RCC update Add new macros __HAL_RCC_PPP_IS_CLK_ENABLED() to check on Clock enable/disable status Update __HAL_RCC_USB_OTG_FS_CLK_DISABLE() macro to remove the disable for the SYSCFG Update HAL_RCC_MCOConfig() API to use new defines for the GPIO Speed Generic update to improve the PLL VCO min value(100MHz): PLLN, PLLI2S and PLLSAI min value is 50 instead of 192 HAL FLASH update __HAL_FLASH_INSTRUCTION_CACHE_RESET() macro: update to reset ICRST bit in the ACR register after setting it. Update to support until 15 FLASH wait state (FLASH_LATENCY_15) for STM32F446xx devices HAL CRYP update Update HAL_CRYP_DESECB_Decrypt() API to fix the inverted pPlainData and pCypherData parameters issue HAL I2S update Update HAL_I2S_Init() API to call __HAL_RCC_I2S_CONFIG() macro when external I2S clock is selected HAL LTDC update Update HAL_LTDC_SetWindowPosition() API to configure Immediate reload register instead of vertical blanking reload register. HAL TIM update Update HAL_TIM_ConfigClockSource() API to check only the required parameters HAL NAND update Update HAL_NAND_Read_Page()/HAL_NAND_Write_Page()/HAL_NAND_Read_SpareArea() APIs to manage correctly the NAND Page access HAL CAN update Update to use "=" instead of "|=" to clear flags in the MSR, TSR, RF0R and RF1R registers HAL HCD update Fix typo in __HAL_USB_OTG_HS_WAKEUP_EXTI_ENABLE_RISING_FALLING_EDGE() macro implementation HAL PCD update Update HAL_PCD_IRQHandler() API to avoid issue when DMA mode enabled for Status Phase IN stage LL FMC update Update the FMC_NORSRAM_Extended_Timing_Init() API to remove the check on CLKDIvison and DataLatency parameters Update the FMC_NORSRAM_Init() API to add a check on the PageSize parameter for STM32F42/43xx devices LL FSMC update Update the FSMC_NORSRAM_Extended_Timing_Init() API to remove the check on CLKDIvison and DataLatency parameters ### V1.4.1 / 09-October-2015 Main Changes HAL DSI update Update TCCR register assigned value in HAL_DSI_ConfigHostTimeouts() function Update WPCR register assigned value in HAL_DSI_Init(), HAL_DSI_SetSlewRateAndDelayTuning(), HAL_DSI_SetSlewRateAndDelayTuning(), HAL_DSI_SetLowPowerRXFilter() / HAL_DSI_SetSDD(), HAL_DSI_SetLanePinsConfiguration(), HAL_DSI_SetPHYTimings(), HAL_DSI_ForceTXStopMode(), HAL_DSI_ForceRXLowPower(), HAL_DSI_ForceDataLanesInRX(), HAL_DSI_SetPullDown() and HAL_DSI_SetContentionDetectionOff() functions Update DSI_HS_PM_ENABLE define value Implement workaround for the hardware limitation: “The time to activate the clock between HS transmissions is not calculated correctly” ### V1.4.0 / 14-August-2015 Main Changes Add support of STM32F469xx, STM32F479xx, STM32F410Cx, STM32F410Rx and STM32F410Tx devices General updates to fix known defects and enhancements implementation Add new HAL drivers for DSI and LPTIM peripherals HAL ADC update Rename ADC_CLOCKPRESCALER_PCLK_DIV2 define to ADC_CLOCK_SYNC_PCLK_DIV2 Rename ADC_CLOCKPRESCALER_PCLK_DIV4 define to ADC_CLOCK_SYNC_PCLK_DIV4 Rename ADC_CLOCKPRESCALER_PCLK_DIV6 define to ADC_CLOCK_SYNC_PCLK_DIV6 Rename ADC_CLOCKPRESCALER_PCLK_DIV8 define to ADC_CLOCK_SYNC_PCLK_DIV8 HAL CORTEX update Add specific API for MPU management add MPU_Region_InitTypeDef structure add new function HAL_MPU_ConfigRegion() HAL DMA update Overall driver update for code optimization add StreamBaseAddress and StreamIndex new fields in the DMA_HandleTypeDef structure add DMA_Base_Registers private structure add static function DMA_CalcBaseAndBitshift() update HAL_DMA_Init() function to use the new added static function update HAL_DMA_DeInit() function to optimize clear flag operations update HAL_DMA_Start_IT() function to optimize interrupts enable update HAL_DMA_PollForTransfer() function to optimize check on flags update HAL_DMA_IRQHandler() function to optimize interrupt flag management HAL FLASH update update HAL_FLASH_Program_IT() function by removing the pending flag clear update HAL_FLASH_IRQHandler() function to improve erase operation procedure update FLASH_WaitForLastOperation() function by checking on end of operation flag HAL GPIO update Rename GPIO_SPEED_LOW define to GPIO_SPEED_FREQ_LOW Rename GPIO_SPEED_MEDIUM define to GPIO_SPEED_FREQ_MEDIUM Rename GPIO_SPEED_FAST define to GPIO_SPEED_FREQ_HIGH Rename GPIO_SPEED_HIGH define to GPIO_SPEED_FREQ_VERY_HIGH HAL I2S update Move I2S_Clock_Source defines to extension file to properly add the support of STM32F410xx devices HAL LTDC update rename HAL_LTDC_LineEvenCallback() function to HAL_LTDC_LineEventCallback() add new function HAL_LTDC_SetPitch() add new functions HAL_LTDC_StructInitFromVideoConfig() and HAL_LTDC_StructInitFromAdaptedCommandConfig() applicable only to STM32F469xx and STM32F479xx devices HAL PWR update move __HAL_PWR_VOLTAGESCALING_CONFIG() macro to extension file move PWR_WAKEUP_PIN2 define to extension file add PWR_WAKEUP_PIN3 define, applicable only to STM32F10xx devices add new functions HAL_PWREx_EnableWakeUpPinPolarityRisingEdge() and HAL_PWREx_EnableWakeUpPinPolarityFallingEdge(), applicable only to STM32F469xx and STM32F479xx devices HAL RTC update Update HAL_RTCEx_SetWakeUpTimer() and HAL_RTCEx_SetWakeUpTimer_IT() functions to properly check on the WUTWF flag HAL TIM update add new defines TIM_SYSTEMBREAKINPUT_HARDFAULT, TIM_SYSTEMBREAKINPUT_PVD and TIM_SYSTEMBREAKINPUT_HARDFAULT_PVD, applicable only to STM32F410xx devices ### V1.3.2 / 26-June-2015 Main Changes General updates to fix known defects and enhancements implementation One changes done on the HAL may require an update on the application code based on HAL V1.3.1 HASH IT process: update to call the HAL_HASH_InCpltCallback() at the end of the complete buffer instead of every each 512 bits HAL RCC update HAL_RCCEx_PeriphCLKConfig() updates: Update the LSE check condition after backup domain reset: update to check LSE ready flag when LSE oscillator is already enabled instead of check on LSE oscillator only when LSE is used as RTC clock source Use the right macro to check the PLLI2SQ parameters HAL RTC update __HAL_RTC_TAMPER_TIMESTAMP_EXTI_GET_FLAG() macro: fix implementation issue __HAL_RTC_ALARM_GET_IT(), __HAL_RTC_ALARM_CLEAR_FLAG(), __HAL_RTC_WAKEUPTIMER_CLEAR_FLAG(), __HAL_RTC_TIMESTAMP_CLEAR_FLAG() and __HAL_RTC_TAMPER_CLEAR_FLAG() macros implementation changed: remove unused cast IS_RTC_TAMPER() macro: update to use literal instead of hardcoded value Add new parameter SecondFraction in RTC_TimeTypeDef structure HAL_RTC_GetTime() API update to support the new parameter SecondFraction HAL ADC update Add new literal: ADC_INJECTED_SOFTWARE_START to be used as possible value for the ExternalTrigInjecConvEdge parameter in the ADC_InitTypeDef structure to select the ADC software trigger mode. HAL FLASH update FLASH_OB_GetRDP() API update to return uint8_t instead of FlagStatus __HAL_FLASH_GET_LATENCY() new macro add to get the flash latency HAL SPI update Fix the wrong definition of HAL_SPI_ERROR_FLAG literal HAL I2S update HAL_I2S_Transmit() API update to check on busy flag only for I2S slave mode HAL CRC update __HAL_CRC_SET_IDR() macro implementation change to use WRITE_REG() instead of MODIFY_REG() HAL DMA2D update HAL_DMA2D_ConfigLayer() API update to use "=" instead of "|=" to erase BGCOLR and FGCOLR registers before setting the new configuration HAL HASH update HAL_HASH_MODE_Start_IT() (MODE stands for MD5, SHA1, SHA224 and SHA36) updates: Fix processing fail for small input buffers Update to unlock the process and call return HAL_OK at the end of HASH processing to avoid incorrectly repeating software Update to properly manage the HashITCounter Update to call the HAL_HASH_InCpltCallback() at the end of the complete buffer instead of every each 512 bits __HAL_HASH_GET_FLAG() update to check the right register when the DINNE flag is selected HAL_HASH_SHA1_Accumulate() updates: Add a call to the new IS_HASH_SHA1_BUFFER_SIZE() macro to check the size parameter. Add the following note in API description * @note Input buffer size in bytes must be a multiple of 4 otherwise the digest computation is corrupted. HAL RTC update Update to define hardware independent l iterals names: Rename RTC_TAMPERPIN_PC13 by RTC_TAMPERPIN_DEFAULT Rename RTC_TAMPERPIN_PA0 by RTC_TAMPERPIN_POS1 Rename RTC_TAMPERPIN_PI8 by RTC_TAMPERPIN_POS1 Rename RTC_TIMESTAMPPIN_PC13 by RTC_TIMESTAMPPIN_DEFAULT Rename RTC_TIMESTAMPPIN_PA0 by RTC_TIMESTAMPPIN_POS1 Rename RTC_TIMESTAMPPIN_PI8 by RTC_TIMESTAMPPIN_POS1 HAL ETH update Remove duplicated IS_ETH_DUPLEX_MODE() and IS_ETH_RX_MODE() macros Remove illegal space ETH_MAC_READCONTROLLER_FLUSHING macro Update ETH_MAC_READCONTROLLER_XXX defined values (XXX can be IDLE, READING_DATA and READING_STATUS) HAL PCD update HAL_PCD_IRQHandler API: fix the bad Configuration of Turnaround Time HAL HCD update Update to use local variable in USB Host channel re-activation LL FMC update FMC_SDRAM_SendCommand() API: remove the following line: return HAL_ERROR; LL USB update USB_FlushTxFifo API: update to flush all Tx FIFO Update to use local variable in USB Host channel re-activation ### V1.3.1 / 25-Mars-2015 Main Changes HAL PWR update Fix compilation issue with STM32F417xx product: update STM32F17xx by STM32F417xx HAL SPI update Remove unused variable to avoid warning with TrueSTUDIO HAL I2C update I2C Polling/IT/DMA processes: move the wait loop on busy flag at the top of the processes, to ensure that software not perform any write access to I2C_CR1 register before hardware clearing STOP bit and to avoid also the waiting loop on BUSY flag under I2C/DMA ISR. Update busy flag Timeout value I2C Master Receive Processes update to disable ACK before generate the STOP HAL DAC update Fix V1.3.0 regression issue with DAC software trigger configuration ### V1.3.0 / 09-Mars-2015 Main Changes Add support of STM32F446xx devices General updates to fix known defects and enhancements implementation Add new HAL drivers for CEC, QSPI, FMPI2C and SPDIFRX peripherals Two changes done on the HAL requires an update on the application code based on HAL V1.2.0 Overall SAI driver rework to have exhaustive support of the peripheral features: details are provided in HAL SAI update section below --> Compatibility with previous version is impacted CRYP driver updated to support multi instance,so user must ensure that the new parameter Instance is initalized in his application(CRYPHandle.Instance = CRYP) HAL Generic update stm32f4xx_hal_def.h Remove NULL definition and add include for stdio.h stm32_hal_legacy.h Update method to manage deference in alias implementation between all STM32 families stm32f4xx_hal_ppp.c HAL_PPP_Init(): update to force the HAL_PPP_STATE_RESET before calling the HAL_PPP_MspInit() HAL RCC update Add new function HAL_RCCEx_GetPeriphCLKFreq() Move RCC_PLLInitTypeDef structure to extension file and add the new PLLR field specific to STM32F446xx devices Move the following functions to extension file and add a __weak attribute in generic driver : this update is related to new system clock source (PLL/PLLR) added and only available for STM32F44xx devices HAL_RCC_OscConfig() HAL_RCC_GetSysClockFreq() HAL_RCC_GetOscConfig() Move the following macro to extension file as they have device dependent implementation __HAL_RCC_PLL_CONFIG() __HAL_RCC_PLLI2S_CONFIG() __HAL_RCC_I2S_CONFIG() Add new structure RCC_PLLI2SInitTypeDef containing new PLLI2S division factors used only w/ STM32F446xx devices Add new structure RCC_PLLSAIInitTypeDef containing new PLLSAI division factors used only w/ STM32F446xx devices Add new RCC_PeriphCLKInitTypeDef to support the peripheral source clock selection for (I2S, SAI, SDIO, FMPI2C, CEC, SPDIFRX and CLK48) Update the HAL_RCCEx_PeriphCLKConfig() and HAL_RCCEx_GetPeriphCLKConfig() functions to support the new peripherals Clock source selection Add __HAL_RCC_PLL_CONFIG() macro (the number of parameter and the implementation depend on the device part number) Add __HAL_RCC_PLLI2S_CONFIG() macro(the number of parameter and the implementation depend on device part number) Update __HAL_RCC_PLLSAI_CONFIG() macro to support new PLLSAI factors (PLLSAIM and PLLSAIP) Add new macros for clock enable/Disable for the following peripherals (CEC, SPDIFRX, SAI2, QUADSPI) Add the following new macros for clock source selection : __HAL_RCC_SAI1_CONFIG() / __HAL_RCC_GET_SAI1_SOURCE() __HAL_RCC_SAI2_CONFIG() / __HAL_RCC_GET_SAI2_SOURCE() __HAL_RCC_I2S1_CONFIG() / __HAL_RCC_GET_I2S1_SOURCE() __HAL_RCC_I2S2_CONFIG() / __HAL_RCC_GET_I2S2_SOURCE() __HAL_RCC_CEC_CONFIG() / __HAL_RCC__GET_CEC_SOURCE() __HAL_RCC_FMPI2C1_CONFIG() / __HAL_RCC_GET_FMPI2C1_SOURCE() __HAL_RCC_SDIO_CONFIG() / __HAL_RCC_GET_SDIO_SOURCE() __HAL_RCC_CLK48_CONFIG() / __HAL_RCC_GET_CLK48_SOURCE() __HAL_RCC_SPDIFRXCLK_CONFIG() / __HAL_RCC_GET_SPDIFRX_SOURCE() __HAL_RCC_PPP_CLK_ENABLE(): Implement workaround to cover RCC limitation regarding peripheral enable delay HAL_RCC_OscConfig() fix issues: Add a check on LSERDY flag when LSE_BYPASS is selected as new state for LSE oscillator. Add new possible value RCC_PERIPHCLK_PLLI2S to be selected as PeriphClockSelection parameter in the RCC_PeriphCLKInitTypeDef structure to allow the possibility to output the PLLI2S on MCO without activating the I2S or the SAI. __HAL_RCC_HSE_CONFIG() macro: add the comment below: * @note Transition HSE Bypass to HSE On and HSE On to HSE Bypass are not supported by this macro. * User should request a transition to HSE Off first and then HSE On or HSE Bypass. __HAL_RCC_LSE_CONFIG() macro: add the comment below: * @note Transition LSE Bypass to LSE On and LSE On to LSE Bypass are not supported by this macro. * User should request a transition to LSE Off first and then LSE On or LSE Bypass. Add the following new macros for PLL source and PLLM selection : __HAL_RCC_PLL_PLLSOURCE_CONFIG() __HAL_RCC_PLL_PLLM_CONFIG() Macros rename: HAL_RCC_OTGHS_FORCE_RESET() by HAL_RCC_USB_OTG_HS_FORCE_RESET() HAL_RCC_OTGHS_RELEASE_RESET() by HAL_RCC_USB_OTG_HS_RELEASE_RESET() HAL_RCC_OTGHS_CLK_SLEEP_ENABLE() by HAL_RCC_USB_OTG_HS_CLK_SLEEP_ENABLE() HAL_RCC_OTGHS_CLK_SLEEP_DISABLE() by HAL_RCC_USB_OTG_HS_CLK_SLEEP_DISABLE() HAL_RCC_OTGHSULPI_CLK_SLEEP_ENABLE() by HAL_RCC_USB_OTG_HS_ULPI_CLK_SLEEP_ENABLE() HAL_RCC_OTGHSULPI_CLK_SLEEP_DISABLE() by HAL_RCC_USB_OTG_HS_ULPI_CLK_SLEEP_DISABLE() Add __HAL_RCC_SYSCLK_CONFIG() new macro to configure the system clock source (SYSCLK) __HAL_RCC_GET_SYSCLK_SOURCE() updates: Add new RCC Literals: RCC_SYSCLKSOURCE_STATUS_HSI RCC_SYSCLKSOURCE_STATUS_HSE RCC_SYSCLKSOURCE_STATUS_PLLCLK RCC_SYSCLKSOURCE_STATUS_PLLRCLK Update macro description to refer to the literals above HAL PWR update Add new define PWR_WAKEUP_PIN2 Add new API to Control/Get VOS bits of CR register HAL_PWR_HAL_PWREx_ControlVoltageScaling() HAL_PWREx_GetVoltageRange() __HAL_PWR_ VOLTAGESCALING_CONFIG(): Implement workaround to cover VOS limitation delay when PLL is enabled after setting the VOS configuration HAL GPIO update Add the new Alternate functions literals related to remap for SPI, USART, I2C, SPDIFRX, CEC and QSPI HAL_GPIO_DeInit(): Update to check if GPIO Pin x is already used in EXTI mode on another GPIO Port before De-Initialize the EXTI registers HAL FLASH update __HAL_FLASH_INSTRUCTION_CACHE_RESET() macro: update to reset ICRST bit in the ACR register after setting it. __HAL_FLASH_DATA_CACHE_RESET() macro: update to reset DCRST bit in the ACR register after setting it. HAL ADC update Add new literal: ADC_SOFTWARE_START to be used as possible value for the ExternalTrigConv parameter in the ADC_InitTypeDef structure to select the ADC software trigger mode. IS_ADC_CHANNEL() macro update to don't assert stop the ADC_CHANNEL_TEMPSENSOR value HAL_ADC_PollForConversion(): update to manage particular case when ADC configured in DMA mode and ADC sequencer with several ranks and polling for end of each conversion HAL_ADC_Start()/HAL_ADC_Start_IT() /HAL_ADC_Start_DMA() update: unlock the process before starting the ADC software conversion. Optimize the ADC stabilization delays __HAL_ADC_GET_IT_SOURCE() update macro implementation Add more details in 'How to use this driver' section HAL DAC update Add new macro to check if the specified DAC interrupt source is enabled or disabled __HAL_DAC_GET_IT_SOURCE() HAL_DACEx_TriangleWaveGeneration() update to use DAC CR bit mask definition HAL_DACEx_NoiseWaveGeneration() update to use DAC CR bit mask definition HAL CAN update CanTxMsgTypeDef structure: update to use uint8_t Data[8] instead of uint32_t Data[8] CanRxMsgTypeDef structure: update to use uint8_t Data[8] instead of uint32_t Data[8] HAL RTC update Update to use CMSIS mask definition instead of hardcoded values (EXTI_IMR_IM17, EXTI_IMR_IM19..) HAL LTDC update LTDC_SetConfig() update to allow the drawing of partial bitmap in active layer. HAL USART update HAL_USART_Init() fix USART baud rate configuration issue: USART baud rate is twice Higher than expected HAL SMARTCARD update HAL_SMARTCARD_Transmit_IT() update to force the disable for the ERR interrupt to avoid the OVR interrupt HAL_SMARTCARD_IRQHandler() update check condition for transmission end Clean up: remove the following literals that aren't used in smartcard mode SMARTCARD_PARITY_NONE SMARTCARD_WORDLENGTH_8B SMARTCARD_STOPBITS_1 SMARTCADR_STOPBITS_2 HAL SPI update HAL_SPI_Transmit_DMA()/HAL_SPI_Receive_DMA()/HAL_SPI_TarnsmitReceive_DMA() update to unlock the process before enabling the SPI peripheral HAL_SPI_Transmit_DMA() update to manage correctly the DMA RX stream in SPI Full duplex mode Section SPI_Exported_Functions_Group2 update to remove duplication in *.chm UM HAL CRYP update Update to manage multi instance: Add new parameter Instance in the CRYP_HandleTypeDef Handle structure. Add new parameter in all HAL CRYP macros example: __HAL_CRYP_ENABLE() updated by __HAL_CRYP_ENABLE(__HANDLE__) HAL DCMI update Add an extension driver stm32f4xx_hal_dcmi_ex.c/h to manage the support of new Black and White feature Add __weak attribute for HAL_DCMI_Init() function and add a new implementation in the extension driver to manage the black and white configuration only available in the STM32F446xx devices. Move DCMI_InitTypeDef structure to extension driver and add the following new fields related to black and white feature: ByteSelectMode, ByteSelectStart, LineSelectMode and LineSelectStart HAL PCD update Add the support of LPM feature add PCD_LPM_StateTypeDef enum update PCD_HandleTypeDef structure to support the LPM feature add new functions HAL_PCDEx_ActivateLPM(), HAL_PCDEx_DeActivateLPM() and HAL_PCDEx_LPM_Callback() in the stm32f4xx_hal_pcd_ex.h/.c files HAL TIM update Add TIM_TIM11_SPDIFRX define HAL SAI update Add stm32f4xx_hal_sai_ex.h/.c files for the SAI_BlockSynchroConfig() and the SAI_GetInputClock() management Add new defines HAL_SAI_ERROR_AFSDET, HAL_SAI_ERROR_LFSDET, HAL_SAI_ERROR_CNREADY, HAL_SAI_ERROR_WCKCFG, HAL_SAI_ERROR_TIMEOUT in the SAI_Error_Code group Add new defines SAI_SYNCEXT_DISABLE, SAI_SYNCEXT_IN_ENABLE, SAI_SYNCEXT_OUTBLOCKA_ENABLE, SAI_SYNCEXT_OUTBLOCKB_ENABLE for the SAI External synchronization Add new defines SAI_I2S_STANDARD, SAI_I2S_MSBJUSTIFIED, SAI_I2S_LSBJUSTIFIED, SAI_PCM_LONG and SAI_PCM_SHORT for the SAI Supported protocol Add new defines SAI_PROTOCOL_DATASIZE_16BIT, SAI_PROTOCOL_DATASIZE_16BITEXTENDED, SAI_PROTOCOL_DATASIZE_24BIT and SAI_PROTOCOL_DATASIZE_32BIT for SAI protocol data size Add SAI Callback prototype definition Update SAI_InitTypeDef structure by adding new fields: SynchroExt, Mckdiv, MonoStereoMode, CompandingMode, TriState Update SAI_HandleTypeDef structure: remove uint16_t *pTxBuffPtr, *pRxBuffPtr, TxXferSize, RxXferSize, TxXferCount and RxXferCount and replace them respectively by uint8_t *pBuffPtr, uint16_t XferSize and uint16_t XferCount add mutecallback field add struct __SAI_HandleTypeDef *hsai field Remove SAI_CLKSOURCE_PLLR and SAI_CLOCK_PLLSRC defines Add SAI_CLKSOURCE_NA define Add SAI_AUDIO_FREQUENCY_MCKDIV define Add SAI_SPDIF_PROTOCOL define Add SAI_SYNCHRONOUS_EXT define Add new functions HAL_SAI_InitProtocol(), HAL_SAI_Abort(), HAL_SAI_EnableTxMuteMode(), HAL_SAI_DisableTxMuteMode(), HAL_SAI_EnableRxMuteMode(), HAL_SAI_DisableRxMuteMode() Update HAL_SAI_Transmit(), HAL_SAI_Receive(), HAL_SAI_Transmit_IT(), HAL_SAI_Receive_IT(), HAL_SAI_Transmit_DMA(), HAL_SAI_Receive_DMA() functions to use uint8_t *pData instead of uint16_t *pData --> This update is mainly impacting the compatibility with previous driver version. HAL I2S update Split the following functions between Generic and Extended API based on full duplex management and add the attribute __weak in the Generic API HAL_I2S_Init(), HAL_I2S_DMAPause(), HAL_I2S_DMAStop(), HAL_I2S_DMAResume(), HAL_I2S_IRQHandle() Move the following static functions from generic to extension driver I2S_DMARxCplt() and I2S_DMATxCplt() Remove static attribute from I2S_Transmit_IT() and I2S_Receive_IT() functions Move I2SxEXT() macro to extension file Add I2S_CLOCK_PLLR and I2S_CLOCK_PLLSRC defines for I2S clock source Add new function I2S_GetInputClock() HAL LL FMC update Add WriteFifo and PageSize fields in the FMC_NORSRAM_InitTypeDef structure Add FMC_PAGE_SIZE_NONE, FMC_PAGE_SIZE_128, FMC_PAGE_SIZE_256, FMC_PAGE_SIZE_1024, FMC_WRITE_FIFO_DISABLE, FMC_WRITE_FIFO_ENABLE defines Update FMC_NORSRAM_Init(), FMC_NORSRAM_DeInit() and FMC_NORSRAM_Extended_Timing_Init() functions HAL LL USB update Update USB_OTG_CfgTypeDef structure to support LPM, lpm_enable field added Update USB_HostInit() and USB_DevInit() functions to support the VBUS Sensing B activation ### V1.2.0 / 26-December-2014 Main Changes Maintenance release to fix known defects and enhancements implementation Macros and literals renaming to ensure compatibles across STM32 series, backward compatibility maintained thanks to new added file stm32_hal_legacy.h under /Inc/Legacy Add *.chm UM for all drivers, a UM is provided for each superset RPN Update drivers to be C++ compliant Several update on source code formatting, for better UM generation (i.e. Doxygen tags updated) Two changes done on the HAL requires an update on the application code based on HAL V1.1.0 LSI_VALUE constant has been corrected in stm32f4xx_hal_conf.h file, its value changed from 40 KHz to 32 KHz UART, USART, IRDA and SMARTCARD (referenced as PPP here below) drivers: in DMA transmit process, the code has been updated to avoid waiting on TC flag under DMA ISR, PPP TC interrupt is used instead. Below the update to be done on user application: Configure and enable the USART IRQ in HAL_PPP_MspInit() function In stm32f4xx_it.c file, PPP_IRQHandler() function: add a call to HAL_PPP_IRQHandler() function HAL generic update stm32f4xx_hal_def.h Update NULL definition to fix C++ compilation issue Add UNUSED() macro Add a new define __NOINLINE to be used for the no inline code independent from tool chain stm32f4xx_hal_conf_template.h LSI_VALUE constant has been corrected, its value changed from 40 KHz to 32 KHz Update all macros and literals naming to be uper case ErrorCode parameter in PPP_HandleTypeDef structure updated to uint32_t instead of enum HAL_PPP_ErrorTypeDef Remove the unused FLAG and IT assert macros HAL ADC update Fix temperature sensor channel configuration issue for STM32F427/437xx and STM32F429/439xx devices HAL DAC update HAL_DAC_ConfigChannel(): update the access to the DAC peripheral registers via the hdac handle instance HAL_DAC_IRQHandler(): update to check on both DAC_FLAG_DMAUDR1 and DAC_FLAG_DMAUDR 2 HAL_DACEx_NoiseWaveGenerate(): update to reset DAC CR register before setting the new DAC configuration HAL_DACEx_TriangleWaveGenerate(): update to reset DAC CR register before setting the new DAC configuration HAL CAN update Unlock the CAN process when communication error occurred HAL CORTEX update Add new macro IS_NVIC_DEVICE_IRQ() to check on negative values of IRQn parameter HAL CRYP update HAL_CRYP_DESECB_Decrypt_DMA(): fix the inverted pPlainData and pCypherData parameters issue CRYPEx_GCMCCM_SetInitVector(): remove the IVSize parameter as the key length 192bits and 256bits are not supported by this version Add restriction for the CCM Encrypt/Decrypt API's that only DataType equal to 8bits is supported HAL_CRYPEx_AESGCM_Finish(): Add restriction that the implementation is limited to 32bits inputs data length (Plain/Cyphertext, Header) compared with GCM stadards specifications (800-38D) Update Size parameter on 32bits instead of 16bits Fix issue with 16-bit Data Type: update to use intrinsic __ROR() instead of __REV16() HAL DCMI update HAL_DCMI_ConfigCROP(): Invert assert macros to check Y0 and Ysize parameters HAL DMA update HAL_DMA_Init(): Update to clear the DBM bit in the SxCR register before setting the new configuration DMA_SetConfig(): add to clear the DBM bit in the SxCR register HAL FLASH update Add "HAL_" prefix in the defined values for the FLASH error code Example: FLASH_ERROR_PGP renamed by HAL_FLASH_ERROR_PGP Clear the Flash ErrorCode in the FLASH_WaitForLastOperation() function Update FLASH_SetErrorCode() function to use "|=" operant to update the Flash ErrorCode parameter in the FLASH handle IS_FLASH_ADDRESS(): Update the macro check using '<=' condition instead of '<' IS_OPTIONBYTE(): Update the macro check using '<=' condition instead of '<' Add "FLASH_" prefix in the defined values of FLASH Type Program parameter Example: TYPEPROGRAM_BYTE renamed by FLASH_TYPEPROGRAM_BYTE Add "FLASH_" prefix in the defined values of FLASH Type Erase parameter Example: TYPEERASE_SECTORS renamed by FLASH_TYPEERASE_SECTORS Add "FLASH_" prefix in the defined values of FLASH Voltage Range parameter Example: VOLTAGE_RANGE_1 renamed by FLASH_VOLTAGE_RANGE_1 Add "OB_" prefix in the defined values of FLASH WRP State parameter Example: WRPSTATE_ENABLE renamed by OB_WRPSTATE_ENABLE Add "OB_" prefix in the defined values of the FLASH PCROP State parameter PCROPSTATE_DISABLE updated by OB_PCROP_STATE_DISABLE PCROPSTATE_ENABLE updated by OB_PCROP_STATE_ENABLE Change "OBEX" prefix by "OPTIONBYTE" prefix in these defines: OBEX_PCROP by OPTIONBYTE_PCROP OBEX_BOOTCONFIG by OPTIONBYTE_BOOTCONFIG HAL ETH update Fix macros naming typo Update __HAL_ETH_EXTI_SET_RISING_EGDE_TRIGGER() by __HAL_ETH_EXTI_SET_RISING_EDGE_TRIGGER() Update __HAL_ETH_EXTI_SET_FALLING_EGDE_TRIGGER() by __HAL_ETH_EXTI_SET_FALLING_EDGE_TRIGGER() HAL PWR update Add new API to manage SLEEPONEXIT and SEVONPEND bits of SCR register HAL_PWR_DisableSleepOnExit() HAL_PWR_EnableSleepOnExit() HAL_PWR_EnableSEVOnPend() HAL_PWR_DisableSEVOnPend() HAL_PWR_EnterSTOPMode() Update to clear the CORTEX SLEEPDEEP bit of SCR register before entering in sleep mode Update usage of __WFE() in low power entry function: if there is a pending event, calling __WFE() will not enter the CortexM4 core to sleep mode. The solution is to made the call below; the first __WFE() is always ignored and clears the event if one was already pending, the second is always applied __SEV() __WFE() __WFE() Add new PVD configuration modes PWR_PVD_MODE_NORMAL PWR_PVD_MODE_EVENT_RISING PWR_PVD_MODE_EVENT_FALLING PWR_PVD_MODE_EVENT_RISING_FALLING Add new macros to manage PVD Trigger __HAL_PWR_PVD_EXTI_ENABLE_RISING_EDGE() __HAL_PWR_PVD_EXTI_DISABLE_RISING_EDGE( __HAL_PWR_PVD_EXTI_ENABLE_FALLING_EDGE() __HAL_PWR_PVD_EXTI_DISABLE_FALLING_EDGE() __HAL_PWR_PVD_EXTI_ENABLE_RISING_FALLING_EDGE() __HAL_PWR_PVD_EXTI_DISABLE_RISING_FALLING_EDGE() PVD macros: Remove the __EXTILINE__ parameter Update to use prefix "__HAL_PWR_PVD_" instead of prefix "__HAL_PVD" Rename HAL_PWR_PVDConfig() by HAL_PWR_ConfigPVD() Rename HAL_PWREx_ActivateOverDrive() by HAL_PWREx_EnableOverDrive() Rename HAL_PWREx_DeactivateOverDrive() by HAL_PWREx_DisableOverDrive() HAL GPIO update HAL_GPIO_Init()/HAL_GPIO_DeInit(): add a call to the CMSIS assert macro to check GPIO instance: IS_GPIO_ALL_INSTANCE() HAL_GPIO_WritePin(): update to write in BSRR register Rename GPIO_GET_SOURCE() by GET_GPIO_INDEX() and move this later to file stm32f4xx_hal_gpio_ex.h Add new define for alternate function GPIO_AF5_SPI3 for STM32F429xx/439xx and STM32F427xx/437xx devices HAL HASH update HAL_HASH_MD5_Start_IT(): fix input address management issue HAL RCC update Rename the following Macros __PPP_CLK_ENABLE() by __HAL_RCC_PPP_CLK_ENABLE() __PPP_CLK_DISABLE() by __HAL_RCC_PPP_CLK_DISABLE() __PPP_FORCE_RESET() by __HAL_RCC_PPP_FORCE_RESET() __PPP_RELEASE_RESET() by __HAL_RCC_PPP_RELEASE_RESET() __PPP_CLK_SLEEP_ENABLE() by __HAL_RCC_PPP_CLK_SLEEP_ENABLE() __PPP_CLK_SLEEP_DISABLE() by __HAL_RCC_PPP_CLK_SLEEP_DISABLE() IS_RCC_PLLSAIN_VALUE() macro: update the check condition Add description of RCC known Limitations Rename HAL_RCC_CCSCallback() by HAL_RCC_CSSCallback() HAL_RCC_OscConfig() fix issues: Remove the disable of HSE oscillator when HSE_BYPASS is used as system clock source or as PPL clock source Add a check on HSERDY flag when HSE_BYPASS is selected as new state for HSE oscillator. Rename __HAL_RCC_I2SCLK() by __HAL_RCC_I2S_Config() HAL I2S update HAL_I2S_Init(): add check on I2S instance using CMSIS macro IS_I2S_ALL_INSTANCE() HAL_I2S_IRQHandler() update for compliancy w/ C++ Add use of tmpreg variable in __HAL_I2S_CLEAR_OVRFLAG() and __HAL_I2S_CLEAR_UDRFLAG() macro for compliancy with C++ HAL_I2S_GetError(): update to return uint32_t instead of HAL_I2S_ErrorTypeDef enumeration HAL I2C update Update to clear the POS bit in the CR1 register at the end of HAL_I2C_Master_Read_IT() and HAL_I2C_Mem_Read_IT() process Rename HAL_I2CEx_DigitalFilter_Config() by HAL_I2CEx_ConfigDigitalFilter() Rename HAL_I2CEx_AnalogFilter_Config() by HAL_I2CEx_ConfigAnalogFilter() Add use of tmpreg variable in __HAL_I2C_CLEAR_ADDRFLAG() and __HAL_I2C_CLEAR_STOPFLAG() macro for compliancy with C++ HAL IrDA update DMA transmit process; the code has been updated to avoid waiting on TC flag under DMA ISR, IrDA TC interrupt is used instead. Below the update to be done on user application: Configure and enable the USART IRQ in HAL_IRDA_MspInit() function In stm32f4xx_it.c file, UASRTx_IRQHandler() function: add a call to HAL_IRDA_IRQHandler() function IT transmit process; the code has been updated to avoid waiting on TC flag under IRDA ISR, IrDA TC interrupt is used instead. No impact on user application Rename Macros: add prefix "__HAL" __IRDA_ENABLE() by __HAL_IRDA_ENABLE() __IRDA_DISABLE() by __HAL_IRDA_DISABLE() Add new user macros to manage the sample method feature __HAL_IRDA_ONE_BIT_SAMPLE_ENABLE() __HAL_IRDA_ONE_BIT_SAMPLE_DISABLE() HAL_IRDA_Transmit_IT(): update to remove the enable of the parity error interrupt Add use of tmpreg variable in __HAL_IRDA_CLEAR_PEFLAG() macro for compliancy with C++ HAL_IRDA_Transmit_DMA() update to follow the right procedure "Transmission using DMA" in the reference manual Add clear the TC flag in the SR register before enabling the DMA transmit request HAL IWDG update Rename the defined IWDG keys: KR_KEY_RELOAD by IWDG_KEY_RELOAD KR_KEY_ENABLE by IWDG_KEY_ENABLE KR_KEY_EWA by IWDG_KEY_WRITE_ACCESS_ENABLE KR_KEY_DWA by IWDG_KEY_WRITE_ACCESS_DISABLE Add new macros __HAL_IWDG_RESET_HANDLE_STATE() and __HAL_IWDG_CLEAR_FLAG() Update __HAL_IWDG_ENABLE_WRITE_ACCESS() and __HAL_IWDG_DISABLE_WRITE_ACCESS() as private macro HAL SPI update HAL_SPI_TransmitReceive_DMA() update to remove the DMA Tx Error Callback initialization when SPI RxOnly mode is selected Add use of UNUSED(tmpreg) in __HAL_SPI_CLEAR_MODFFLAG(), __HAL_SPI_CLEAR_OVRFLAG(), __HAL_SPI_CLEAR_FREFLAG() to fix "Unused variable" warning with TrueSTUDIO. Rename Literals: remove "D" from "DISABLED" and "ENABLED" SPI_TIMODE_DISABLED by SPI_TIMODE_DISABLE SPI_TIMODE_ENABLED by SPI_TIMODE_ENABLE SPI_CRCCALCULATION_DISABLED by SPI_CRCCALCULATION_DISABLE SPI_CRCCALCULATION_ENABLED by SPI_CRCCALCULATION_ENABLE Add use of tmpreg variable in __HAL_SPI_CLEAR_MODFFLAG(), __HAL_SPI_CLEAR_FREFLAG() and __HAL_SPI_CLEAR_OVRFLAG() macros for compliancy with C++ HAL SDMMC update IS_SDIO_ALL_INSTANCE() macro moved to CMSIS files HAL LTDC update HAL_LTDC_ConfigCLUT: optimize the function when pixel format is LTDC_PIXEL_FORMAT_AL44 Update the size of color look up table to 16 instead of 256 when the pixel format is LTDC_PIXEL_FORMAT_AL44 HAL NAND update Rename NAND Address structure to NAND_AddressTypeDef instead of NAND_AddressTypedef Update the used algorithm of these functions HAL_NAND_Read_Page() HAL_NAND_Write_Page() HAL_NAND_Read_SpareArea() HAL_NAND_Write_SpareArea() HAL_NAND_Write_Page(): move initialization of tickstart before while loop HAL_NAND_Erase_Block(): add whait until NAND status is ready before exiting this function HAL NOR update Rename NOR Address structure to NOR_AddressTypeDef instead of NOR_AddressTypedef NOR Status literals renamed NOR_SUCCESS by HAL_NOR_STATUS_SUCCESS NOR_ONGOING by HAL_NOR_STATUS_ONGOING NOR_ERROR by HAL_NOR_STATUS_ERROR NOR_TIMEOUT by HAL_NOR_STATUS_TIMEOUT HAL_NOR_GetStatus() update to fix Timeout issue and exit from waiting loop when timeout occurred HAL PCCARD update Rename PCCARD Address structure to HAL_PCCARD_StatusTypeDef instead of CF_StatusTypedef PCCARD Status literals renamed CF_SUCCESS by HAL_PCCARD_STATUS_SUCCESS CF_ONGOING by HAL_PCCARD_STATUS_ONGOING CF_ERROR by HAL_PCCARD_STATUS_ERROR CF_TIMEOUT by HAL_PCCARD_STATUS_TIMEOUT Update "CF" by "PCCARD" in functions, literals and macros HAL PCD update Rename functions HAL_PCD_ActiveRemoteWakeup() by HAL_PCD_ActivateRemoteWakeup() HAL_PCD_DeActiveRemoteWakeup() by HAL_PCD_DeActivateRemoteWakeup() Rename literals USB_FS_EXTI_TRIGGER_RISING_EDGE by USB_OTG_FS_WAKEUP_EXTI_RISING_EDGE USB_FS_EXTI_TRIGGER_FALLING_EDGE by USB_OTG_FS_WAKEUP_EXTI_FALLING_EDGE USB_FS_EXTI_TRIGGER_BOTH_EDGE() by USB_OTG_FS_WAKEUP_EXTI_RISING_FALLING_EDGE USB_HS_EXTI_TRIGGER_RISING_EDGE by USB_OTG_HS_WAKEUP_EXTI_RISING_EDGE USB_HS_EXTI_TRIGGER_FALLING_EDGE by USB_OTG_HS_WAKEUP_EXTI_FALLING_EDGE USB_HS_EXTI_TRIGGER_BOTH_EDGE by USB_OTG_HS_WAKEUP_EXTI_RISING_FALLING_EDGE USB_HS_EXTI_LINE_WAKEUP by USB_OTG_HS_EXTI_LINE_WAKEUP USB_FS_EXTI_LINE_WAKEUP by USB_OTG_FS_EXTI_LINE_WAKEUP Rename USB EXTI macros (FS, HS referenced as SUBBLOCK here below) __HAL_USB_SUBBLOCK_EXTI_ENABLE_IT() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_ENABLE_IT() __HAL_USB_SUBBLOCK_EXTI_DISABLE_IT() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_DISABLE_IT() __HAL_USB_SUBBLOCK_EXTI_GET_FLAG() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_GET_FLAG() __HAL_USB_SUBBLOCK_EXTI_CLEAR_FLAG() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_CLEAR_FLAG() __HAL_USB_SUBBLOCK_EXTI_SET_RISING_EGDE_TRIGGER() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_ENABLE_RISING_EDGE() __HAL_USB_SUBBLOCK_EXTI_SET_FALLING_EGDE_TRIGGER() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_ENABLE_FALLING_EDGE() __HAL_USB_SUBBLOCK_EXTI_SET_FALLINGRISING_TRIGGER() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_ENABLE_RISING_FALLING_EDGE() __HAL_USB_SUBBLOCK_EXTI_GENERATE_SWIT() by __HAL_USB_OTG_SUBBLOCK_WAKEUP_EXTI_GENERATE_SWIT() HAL RNG update Add new functions HAL_RNG_GenerateRandomNumber(): to generate a 32-bits random number, return random value in argument and return HAL status. HAL_RNG_GenerateRandomNumber_IT(): to start generation of the 32-bits random number, user should call the HAL_RNG_ReadLastRandomNumber() function under the HAL_RNG_ReadyCallback() to get the generated random value. HAL_RNG_ReadLastRandomNumber(): to return the last random value stored in the RNG handle HAL_RNG_GetRandomNumber(): return value update (obsolete), replaced by HAL_RNG_GenerateRandomNumber() HAL_RNG_GetRandomNumber_IT(): wrong implementation (obsolete), replaced by HAL_RNG_GenerateRandomNumber_IT() __HAL_RNG_CLEAR_FLAG() macro (obsolete), replaced by new __HAL_RNG_CLEAR_IT() macro Add new define for RNG ready interrupt: RNG_IT_DRDY HAL RTC update HAL_RTC_GetTime() and HAL_RTC_GetDate(): add the comment below * @note You must call HAL_RTC_GetDate() after HAL_RTC_GetTime() to unlock the values * in the higher-order calendar shadow registers to ensure consistency between the time and date values. * Reading RTC current time locks the values in calendar shadow registers until Current date is read. Rename literals: add prefix "__HAL" FORMAT_BIN by HAL_FORMAT_BIN FORMAT_BCD by HAL_FORMAT_BCD Rename macros (ALARM, WAKEUPTIMER and TIMESTAMP referenced as SUBBLOCK here below) __HAL_RTC_EXTI_ENABLE_IT() by __HAL_RTC_SUBBLOCK_EXTI_ENABLE_IT() __HAL_RTC_EXTI_DISABLE_IT() by __HAL_RTC_SUBBLOCK_EXTI_DISABLE_IT() __HAL_RTC_EXTI_CLEAR_FLAG() by __HAL_RTC_SUBBLOCK_EXTI_CLEAR_FLAG() __HAL_RTC_EXTI_GENERATE_SWIT() by __HAL_RTC_SUBBLOCK_EXTI_GENERATE_SWIT() Add new macros (ALARM, WAKEUPTIMER and TAMPER_TIMESTAMP referenced as SUBBLOCK here below) __HAL_RTC_SUBBLOCK_GET_IT_SOURCE() __HAL_RTC_SUBBLOCK_EXTI_ENABLE_EVENT() __HAL_RTC_SUBBLOCK_EXTI_DISABLE_EVENT() __HAL_RTC_SUBBLOCK_EXTI_ENABLE_FALLING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_DISABLE_FALLING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_ENABLE_RISING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_DISABLE_RISING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_ENABLE_RISING_FALLING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_DISABLE_RISING_FALLING_EDGE() __HAL_RTC_SUBBLOCK_EXTI_GET_FLAG() HAL SAI update Update SAI_STREOMODE by SAI_STEREOMODE Update FIFO status Level defines in upper case Rename literals: remove "D" from "DISABLED" and "ENABLED" SAI_OUTPUTDRIVE_DISABLED by SAI_OUTPUTDRIVE_DISABLE SAI_OUTPUTDRIVE_ENABLED by SAI_OUTPUTDRIVE_ENABLE SAI_MASTERDIVIDER_ENABLED by SAI_MASTERDIVIDER_ENABLE SAI_MASTERDIVIDER_DISABLED by SAI_MASTERDIVIDER_DISABLE HAL SD update Rename SD_CMD_SD_APP_STAUS by SD_CMD_SD_APP_STATUS SD_PowerON() updated to add 1ms required power up waiting time before starting the SD initialization sequence SD_DMA_RxCplt()/SD_DMA_TxCplt(): add a call to HAL_DMA_Abort() HAL_SD_ReadBlocks() update to set the defined DATA_BLOCK_SIZE as SDIO DataBlockSize parameter HAL_SD_ReadBlocks_DMA()/HAL_SD_WriteBlocks_DMA() update to call the HAL_DMA_Start_IT() function with DMA Datalength set to BlockSize/4 as the DMA is configured in word HAL SMARTCARD update DMA transmit process; the code has been updated to avoid waiting on TC flag under DMA ISR, SMARTCARD TC interrupt is used instead. Below the update to be done on user application: Configure and enable the USART IRQ in HAL_SAMRTCARD_MspInit() function In stm32f4xx_it.c file, UASRTx_IRQHandler() function: add a call to HAL_SMARTCARD_IRQHandler() function IT transmit process; the code has been updated to avoid waiting on TC flag under SMARTCARD ISR, SMARTCARD TC interrupt is used instead. No impact on user application Rename macros: add prefix "__HAL" __SMARTCARD_ENABLE() by __HAL_SMARTCARD_ENABLE() __SMARTCARD_DISABLE() by __HAL_SMARTCARD_DISABLE() __SMARTCARD_ENABLE_IT() by __HAL_SMARTCARD_ENABLE_IT() __SMARTCARD_DISABLE_IT() by __HAL_SMARTCARD_DISABLE_IT() __SMARTCARD_DMA_REQUEST_ENABLE() by __HAL_SMARTCARD_DMA_REQUEST_ENABLE() __SMARTCARD_DMA_REQUEST_DISABLE() by __HAL_SMARTCARD_DMA_REQUEST_DISABLE() Rename literals: remove "D" from "DISABLED" and "ENABLED" SMARTCARD_NACK_ENABLED by SMARTCARD_NACK_ENABLE SMARTCARD_NACK_DISABLED by SMARTCARD_NACK_DISABLE Add new user macros to manage the sample method feature __HAL_SMARTCARD_ONE_BIT_SAMPLE_ENABLE() __HAL_SMARTCARD_ONE_BIT_SAMPLE_DISABLE() Add use of tmpreg variable in __HAL_SMARTCARD_CLEAR_PEFLAG() macro for compliancy with C++ HAL_SMARTCARD_Transmit_DMA() update to follow the right procedure "Transmission using DMA" in the reference manual Add clear the TC flag in the SR register before enabling the DMA transmit request HAL TIM update Add TIM_CHANNEL_ALL as possible value for a ll Encoder Start/Stop APIs Description HAL_TIM_OC_ConfigChannel() remove call to IS_TIM_FAST_STATE() assert macro HAL_TIM_PWM_ConfigChannel() add a call to IS_TIM_FAST_STATE() assert macro to check the OCFastMode parameter HAL_TIM_DMADelayPulseCplt() Update to set the TIM Channel before to call HAL_TIM_PWM_PulseFinishedCallback() HAL_TIM_DMACaptureCplt() update to set the TIM Channel before to call HAL_TIM_IC_CaptureCallback() TIM_ICx_ConfigChannel() update to fix Timer CCMR1 register corruption when setting ICFilter parameter HAL_TIM_DMABurst_WriteStop()/HAL_TIM_DMABurst_ReadStop() update to abort the DMA transfer for the specifc TIM channel Add new function for TIM Slave configuration in IT mode: HAL_TIM_SlaveConfigSynchronization_IT() HAL_TIMEx_ConfigBreakDeadTime() add an assert check on Break & DeadTime parameters values HAL_TIMEx_OCN_Start_IT() add the enable of Break Interrupt for all output modes Add new macros to ENABLE/DISABLE URS bit in TIM CR1 register: __HAL_TIM_URS_ENABLE() __HAL_TIM_URS_DISABLE() Add new macro for TIM Edge modification: __HAL_TIM_SET_CAPTUREPOLARITY() HAL UART update Add IS_LIN_WORD_LENGTH() and IS_LIN_OVERSAMPLING() macros: to check respectively WordLength and OverSampling parameters in LIN mode DMA transmit process; the code has been updated to avoid waiting on TC flag under DMA ISR, UART TC interrupt is used instead. Below the update to be done on user application: Configure and enable the USART IRQ in HAL_UART_MspInit() function In stm32f4xx_it.c file, USARTx_IRQHandler() function: add a call to HAL_UART_IRQHandler() function IT transmit process; the code has been updated to avoid waiting on TC flag under UART ISR, UART TC interrupt is used instead. No impact on user application Rename macros: __HAL_UART_ONEBIT_ENABLE() by __HAL_UART_ONE_BIT_SAMPLE_ENABLE() __HAL_UART_ONEBIT_DISABLE() by __HAL_UART_ONE_BIT_SAMPLE_DISABLE() Rename literals: UART_WAKEUPMETHODE_IDLELINE by UART_WAKEUPMETHOD_IDLELINE UART_WAKEUPMETHODE_ADDRESSMARK by UART_WAKEUPMETHOD_ADDRESSMARK Add use of tmpreg variable in __HAL_UART_CLEAR_PEFLAG() macro for compliancy with C++ HAL_UART_Transmit_DMA() update to follow the right procedure "Transmission using DMA" in the reference manual Add clear the TC flag in the SR register before enabling the DMA transmit request HAL USART update DMA transmit process; the code has been updated to avoid waiting on TC flag under DMA ISR, USART TC interrupt is used instead. Below the update to be done on user application: Configure and enable the USART IRQ in HAL_USART_MspInit() function In stm32f4xx_it.c file, USARTx_IRQHandler() function: add a call to HAL_USART_IRQHandler() function IT transmit process; the code has been updated to avoid waiting on TC flag under USART ISR, USART TC interrupt is used instead. No impact on user application HAL_USART_Init() update to enable the USART oversampling by 8 by default in order to reach max USART frequencies USART_DMAReceiveCplt() update to set the new USART state after checking on the old state HAL_USART_Transmit_DMA()/HAL_USART_TransmitReceive_DMA() update to follow the right procedure "Transmission using DMA" in the reference manual Add clear the TC flag in the SR register before enabling the DMA transmit request Rename macros: __USART_ENABLE() by __HAL_USART_ENABLE() __USART_DISABLE() by __HAL_USART_DISABLE() __USART_ENABLE_IT() by __HAL_USART_ENABLE_IT() __USART_DISABLE_IT() by __HAL_USART_DISABLE_IT() Rename literals: remove "D" from "DISABLED" and "ENABLED" USART_CLOCK_DISABLED by USART_CLOCK_DISABLE USART_CLOCK_ENABLED by USART_CLOCK_ENABLE USARTNACK_ENABLED by USART_NACK_ENABLE USARTNACK_DISABLED by USART_NACK_DISABLE Add new user macros to manage the sample method feature __HAL_USART_ONE_BIT_SAMPLE_ENABLE() __HAL_USART_ONE_BIT_SAMPLE_DISABLE() Add use of tmpreg variable in __HAL_USART_CLEAR_PEFLAG() macro for compliancy with C++ HAL WWDG update Add new parameter in __HAL_WWDG_ENABLE_IT() macro Add new macros to manage WWDG IT & correction: __HAL_WWDG_DISABLE() __HAL_WWDG_DISABLE_IT() __HAL_WWDG_GET_IT() __HAL_WWDG_GET_IT_SOURCE() ### V1.1.0 / 19-June-2014 Main Changes Add support of STM32F411xE devices HAL generic update Enhance HAL delay and time base implementation Systick timer is used by default as source of time base, but user can eventually implement his proper time base source (a general purpose timer for example or other time source) Functions affecting time base configurations are declared as __Weak to make override possible in case of other implementations in user file, for more details please refer to HAL_TimeBase example 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 Common update for the following communication peripherals: SPI, UART, USART and IRDA Add DMA circular mode support Remove lock from recursive process Add new macro __HAL_RESET_HANDLE_STATE to reset a given handle state Add a new attribute for functions executed from internal SRAM and depending from Compiler implementation When USE_RTOS == 1 (in stm32l0xx_hal_conf.h), the __HAL_LOCK() is not defined instead of being defined empty Miscellaneous comments and formatting update stm32f4xx_hal_conf_template.h Add a new define for LSI default value LSI_VALUE Add a new define for LSE default value LSE_VALUE Add a new define for Tick interrupt priority TICK_INT_PRIORITY (needed for the enhanced time base implementation) Important Note: aliases has been added for any API naming change, to keep compatibility with previous version HAL GPIO update Add a new macro __HAL_GPIO_EXTI_GENERATE_SWIT() to manage the generation of software interrupt on selected EXTI line HAL_GPIO_Init(): use temporary variable when modifying the registers, to avoid unexpected transition in the GPIO pin configuration Remove IS_GET_GPIO_PIN macro Add a new function HAL_GPIO_LockPin() Private Macro __HAL_GET_GPIO_SOURCE renamed into GET_GPIO_SOURCE Add the support of STM32F411xx devices : add the new Alternate functions values related to new remap added for SPI, USART, I2C Update the following HAL GPIO macros description: rename EXTI_Linex by GPIO_PIN_x __HAL_GPIO_EXTI_CLEAR_IT() __HAL_GPIO_EXTI_GET_IT() __HAL_GPIO_EXTI_CLEAR_FLAG() __HAL_GPIO_EXTI_GET_FLAG() HAL DMA update Fix in HAL_DMA_PollForTransfer() to: set DMA error code in case of HAL_ERROR status set HAL Unlock before DMA state update HAL DMA2D update Add configuration of source address in case of A8 or A4 M2M_PFC DMA2D mode HAL FLASH update Functions reorganization update, depending on the features supported by each STM32F4 device Add new driver (stm32f4xx_hal_flash_ramfunc.h/.c) to manage function executed from RAM, these functions are available only for STM32F411xx Devices FLASH_StopFlashInterfaceClk() : Stop the flash interface while System Run FLASH_StartFlashInterfaceClk() : Stop the flash interface while System Run FLASH_EnableFlashSleepMode() : Enable the flash sleep while System Run FLASH_DisableFlashSleepMode() : Disable the flash sleep while System Run HAL PWR update HAL_PWR_PVDConfig(): add clear of the EXTI trigger before new configuration 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_PWR_EnterSLEEPMode() Remove disable and enable of SysTick Timer Update usage of __WFE() in low power entry function: if there is a pending event, calling __WFE() will not enter the CortexM4 core to sleep mode. The solution is to made the call below; the first __WFE() is always ignored and clears the event if one was already pending, the second is always applied __SEV() __WFE() __WFE() Add new macro for software event generation __HAL_PVD_EXTI_GENERATE_SWIT() Remove the following defines form Generic driver and add them under extension driver because they are only used within extension functions. CR_FPDS_BB: used within HAL_PWREx_EnableFlashPowerDown() function CSR_BRE_BB: used within HAL_PWREx_EnableBkUpReg() function Add the support of STM32F411xx devices add the define STM32F411xE For STM32F401xC, STM32F401xE and STM32F411xE devices add the following functions used to enable or disable the low voltage mode for regulators HAL_PWREx_EnableMainRegulatorLowVoltage() HAL_PWREx_DisableMainRegulatorLowVoltage() HAL_PWREx_EnableLowRegulatorLowVoltage() HAL_PWREx_DisableLowRegulatorLowVoltage() For STM32F42xxx/43xxx devices, add a new function for Under Driver management as the macro already added for this mode is not sufficient: HAL_PWREx_EnterUnderDriveSTOPMode() HAL RCC update In HAL_RCC_ClockConfig() function: update the AHB clock divider before clock switch to new source Allow to calibrate the HSI when it is used as system clock source Rename the following macros __OTGFS_FORCE_RESET () by __USB_OTG_FS_FORCE_RESET() __OTGFS_RELEASE_RESET () by __USB_OTG_FS_RELEASE_RESET() __OTGFS_CLK_SLEEP_ENABLE () by __USB_OTG_FS_CLK_SLEEP_ENABLE() __OTGFS_CLK_SLEEP_DISABLE () by __USB_OTG_FS_CLK_SLEEP_DISABLE() Add new field PLLI2SM in RCC_PLLI2SInitTypeDef structure, this division factor is added for PLLI2S VCO input clock only STM32F411xE devices => the FW compatibility is broken vs. STM32F401xx devices Update HAL_RCCEx_PeriphCLKConfig() and HAL_RCCEx_GetPeriphCLKConfig() functions to support the new PLLI2SM Add new function to manage the new LSE mode : HAL_RCCEx_SelectLSEMode() Reorganize the macros depending from Part number used and make them more clear HAL UART update Add new macros to control CTS and RTS Add specific macros to manage the flags cleared only by a software sequence __HAL_UART_CLEAR_PEFLAG() __HAL_UART_CLEAR_FEFLAG() __HAL_UART_CLEAR_NEFLAG() __HAL_UART_CLEAR_OREFLAG() __HAL_UART_CLEAR_IDLEFLAG() Add several enhancements without affecting the driver functionalities Remove the check on RXNE set after reading the Data in the DR register Update the transmit processes to use TXE instead of TC Update HAL_UART_Transmit_IT() to enable UART_IT_TXE instead of UART_IT_TC HAL USART update Add specific macros to manage the flags cleared only by a software sequence __HAL_USART_CLEAR_PEFLAG() __HAL_USART_CLEAR_FEFLAG() __HAL_USART_CLEAR_NEFLAG() __HAL_USART_CLEAR_OREFLAG() __HAL_USART_CLEAR_IDLEFLAG() Update HAL_USART_Transmit_IT() to enable USART_IT_TXE instead of USART_IT_TC HAL IRDA update Add specific macros to manage the flags cleared only by a software sequence __HAL_IRDA_CLEAR_PEFLAG() __HAL_ IRDA _CLEAR_FEFLAG() __HAL_ IRDA _CLEAR_NEFLAG() __HAL_ IRDA _CLEAR_OREFLAG() __HAL_ IRDA _CLEAR_IDLEFLAG() Add several enhancements without affecting the driver functionalities Remove the check on RXNE set after reading the Data in the DR register Update HAL_IRDA_Transmit_IT() to enable IRDA_IT_TXE instead of IRDA_IT_TC Add the following APIs used within DMA process HAL_StatusTypeDef HAL_IRDA_DMAPause(IRDA_HandleTypeDef *hirda); HAL_StatusTypeDef HAL_IRDA_DMAResume(IRDA_HandleTypeDef *hirda); HAL_StatusTypeDef HAL_IRDA_DMAStop(IRDA_HandleTypeDef *hirda); void HAL_IRDA_TxHalfCpltCallback(IRDA_HandleTypeDef *hirda); void HAL_IRDA_RxHalfCpltCallback(IRDA_HandleTypeDef *hirda); HAL SMARTCARD update Add specific macros to manage the flags cleared only by a software sequence __HAL_SMARTCARD_CLEAR_PEFLAG() __HAL_SMARTCARD_CLEAR_FEFLAG() __HAL_SMARTCARD_CLEAR_NEFLAG() __HAL_SMARTCARD_CLEAR_OREFLAG() __HAL_SMARTCARD_CLEAR_IDLEFLAG() Add several enhancements without affecting the driver functionalities Add a new state HAL_SMARTCARD_STATE_BUSY_TX_RX and all processes has been updated accordingly Update HAL_SMARTCARD_Transmit_IT() to enable SMARTCARD_IT_TXE instead of SMARTCARD_IT_TC HAL SPI update Bugs fix SPI interface is used in synchronous polling mode: at high clock rates like SPI prescaler 2 and 4, calling HAL_SPI_TransmitReceive() returns with error HAL_TIMEOUT HAL_SPI_TransmitReceive_DMA() does not clean up the TX DMA, so any subsequent SPI calls return the DMA error HAL_SPI_Transmit_DMA() is failing when data size is equal to 1 byte Add the following APIs used within the DMA process HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi); HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi); HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi); void HAL_SPI_TxHalfCpltCallback(SPI_HandleTypeDef *hspi); void HAL_SPI_RxHalfCpltCallback(SPI_HandleTypeDef *hspi); void HAL_SPI_TxRxHalfCpltCallback(SPI_HandleTypeDef *hspi); HAL RNG update Add a conditional define to make this driver visible for all STM32F4xx devices except STM32F401xx and STM32F411xx Devices. HAL CRC update These macros are added to read/write the CRC IDR register: __HAL_CRC_SET_IDR() and __HAL_CRC_GET_IDR() HAL DAC update Enhance the DMA channel configuration when used with DAC HAL TIM update HAL_TIM_IRQHandler(): update to check the input capture channel 3 and 4 in CCMR2 instead of CCMR1 __HAL_TIM_PRESCALER() updated to use '=' instead of '|=' Add the following macro in TIM HAL driver __HAL_TIM_GetCompare() __HAL_TIM_GetCounter() __HAL_TIM_GetAutoreload() __HAL_TIM_GetClockDivision() __HAL_TIM_GetICPrescaler() HAL SDMMC update Use of CMSIS constants instead of magic values Miscellaneous update in functions internal coding HAL NAND update Fix issue of macros returning wrong address for NAND blocks Fix issue for read/write NAND page/spare area HAL NOR update Add the NOR address bank macro used within the API Update NOR API implementation to avoid the use of NOR address bank hard coded HAL HCD update HCD_StateTypeDef structure members renamed These macro are renamed __HAL_GET_FLAG(__HANDLE__, __INTERRUPT__) by __HAL_HCD_GET_FLAG(__HANDLE__, __INTERRUPT__) __HAL_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) by __HAL_HCD_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) __HAL_IS_INVALID_INTERRUPT(__HANDLE__) by __HAL_HCD_IS_INVALID_INTERRUPT(__HANDLE__) HAL PCD update HAL_PCD_SetTxFiFo() and HAL_PCD_SetRxFiFo() renamed into HAL_PCDEx_SetTxFiFo() and HAL_PCDEx_SetRxFiFo() and moved to the extension files stm32f4xx_hal_pcd_ex.h/.c PCD_StateTypeDef structure members renamed Fix incorrect masking of TxFIFOEmpty stm32f4xx_ll_usb.c: fix issue in HS mode New macros added __HAL_PCD_IS_PHY_SUSPENDED() __HAL_USB_HS_EXTI_GENERATE_SWIT() __HAL_USB_FS_EXTI_GENERATE_SWIT() These macro are renamed __HAL_GET_FLAG(__HANDLE__, __INTERRUPT__) by __HAL_PCD_GET_FLAG(__HANDLE__, __INTERRUPT__) __HAL_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) by __HAL_PCD_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) __HAL_IS_INVALID_INTERRUPT(__HANDLE__) by __HAL_PCD_IS_INVALID_INTERRUPT(__HANDLE__) __HAL_PCD_UNGATE_CLOCK(__HANDLE__) by __HAL_PCD_UNGATE_PHYCLOCK(__HANDLE__) __HAL_PCD_GATE_CLOCK(__HANDLE__) by __HAL_PCD_GATE_PHYCLOCK(__HANDLE__) HAL ETH update Update HAL_ETH_GetReceivedFrame_IT() function to return HAL_ERROR if the received packet is not complete Use HAL_Delay() instead of counting loop __HAL_ETH_MAC_CLEAR_FLAG() macro is removed: the MACSR register is read only Add the following macros used to Wake up the device from STOP mode by Ethernet event : __HAL_ETH_EXTI_ENABLE_IT() __HAL_ETH_EXTI_DISABLE_IT() __HAL_ETH_EXTI_GET_FLAG() __HAL_ETH_EXTI_CLEAR_FLAG() __HAL_ETH_EXTI_SET_RISING_EGDE_TRIGGER() __HAL_ETH_EXTI_SET_FALLING_EGDE_TRIGGER() __HAL_ETH_EXTI_SET_FALLINGRISING_TRIGGER() HAL WWDG update Update macro parameters to use underscore: __XXX__ Use of CMSIS constants instead of magic values Use MODIFY_REG macro in HAL_WWDG_Init() Add IS_WWDG_ALL_INSTANCE in HAL_WWDG_Init() and HAL_WWDG_DeInit() HAL IWDG update Use WRITE_REG instead of SET_BIT for all IWDG macros __HAL_IWDG_CLEAR_FLAG removed: no IWDG flag cleared by access to SR register Use MODIFY_REG macro in HAL_IWDG_Init() Add IS_IWDG_ALL_INSTANCE in HAL_IWDG_Init()Add the following macros used to Wake ### V1.0.0 / 18-February-2014 Main Changes First official release ## License Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 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. 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