Release Notes for STM32Cube F2 Firmware Package

Copyright 2017 STMicroelectronics

 

STMCubeTM initiative was originated by STMicroelectronics to ease developers life by reducing development efforts, time and cost. STM32Cube covers STM32 portfolio.

STM32Cube Version 1.x includes:
    • The STM32CubeMX, a graphical software configuration tool that allows to generate C initialization code using graphical wizards.
    • A comprehensive embedded software platform, delivered per series (such as STM32CubeF2 for STM32F2 series)
      • The STM32Cube HAL, an STM32 abstraction layer embedded software, ensuring maximized portability across STM32 portfolio
      • A consistent set of middleware components such as RTOS, USB, TCP/IP, Graphics
      • All embedded software utilities coming with a full set of examples
  • The STM32Cube firmware solution offers a straightforward API with a modular architecture, making it simple to fine tune custom applications and scalable to fit most requirements




  • The HAL (Hardware Abstraction Layer) drivers provided within this package supports the following STM32F2 product lines 205xx/215xx/207xx/217xx

  • The STM32CubeF2 firmware package comes with an updater utility, STM32CubeUpdater, that can be configured for automatic or on-demand checks for new firmware package updates (new releases or/and patches)
  • For quick getting started with the STM32CubeF2 firmware package, refer to UM1739 and you can download firmware updates and all the latest documentation from www.st.com/stm32cubefw
  • Below links to the most useful documents 
    • UM1709: STM32Cube Ethernet IAP example
    • UM1713: Developing applications on STM32Cube with LwIP TCP/IP stack
    • UM1720: STM32Cube USB host library
    • UM1721: Developing Applications on STM32Cube with FatFs
    • UM1722: Developing Applications on STM32Cube with RTOS
    • UM1940: Description of STM32F2xx HAL drivers
    • UM1739: Getting started with STM32CubeF2 firmware package for STM32F2xx series
    • UM1734: STM32Cube USB Device library

Update History

V1.7.0 / 29-September-2017

Main Changes

  • General updates to be compliant with Linux platforms
  • General update to fix known defects and several implementations enhancement
  • Remove support of TrueSTUDIO tool chain 
  • Remove Date and version from all header files
  • \HAL
    • General updates to fix known defects and enhancements implementation
    • stm32f2xx_hal_mmc.c: Fix compilation warning with GCC compiler
  • \CMSIS
    • General update to fix known defects and several implementations enhancement
  • \BSP
    • General updates to fix known defects and enhancements implementation
    • stm322xg_eval_lcd.c: Fix LCD compilation errors with GCC compiler
  • \Projects
    • Fix MDK-ARM limitation with STemWin sample demo application on STM322xG_EVAL.
  • For the complete list of changes, please refer to the release notes of each firmware component

Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain V7.80.4 + ST-Link
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.23 + ST-LINK
  • System Workbench for STM32 (SW4STM32) toolchain V1.14 + ST-Link

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC
  • STM32F207ZG and STM32F207ZG-Nucleo board RevB

V1.6.0 / 14-April-2017

Main Changes

  • General update to fix known defects and several implementations enhancement
  • \HAL
    • HAL CONF Template update
      • Add support for HAL MMC driver. 
    • HAL CAN update
      • Add management of overrun error. 
      • Allow possibility to receive messages from the 2 RX FIFOs in parallel via interrupt.
      • Fix message lost issue with specific sequence of transmit requests.
      • Handle transmission failure with error callback, when NART is enabled.
      • Add __HAL_CAN_CANCEL_TRANSMIT() call to abort transmission when timeout is reached

Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain v7.80.1
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain v5.23
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) toolchain v7.0.0
  • System Workbench for STM32 (SW4STM32) toolchain V1.14

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC
  • STM32F207ZG and STM32F207ZG-Nucleo board RevB


Known  Limitations

  • STemWin sample demo application on STM322xG_EVAL is not fully functional with MDK-ARM toolchain: the application doesn't run successfully after the second hit of the Hide Button. in fact when presing the button again while the progress bar displays the next steps, pressing Hide or Next Buttons are not working anymore. 

V1.5.0 / 17-March-2017

Main Changes

  • Add Low Layer drivers under Drivers\STM32F2xx_HAL_Driver
    • Low Layer drivers allow performance and memory footprint optimization
      • Low Layer drivers APIs provide register level programming: they require deep knowledge of peripherals described in STM32F2xx Reference Manuals
      • Low Layer drivers are available for: ADC, Cortex, CRC, DAC, DMA, EXTI, GPIO, I2C, IWDG, PWR, RCC, RNG, RTC, SPI, TIM, USART, WWDG peripherals and additionnal Low Level Bus, System and Utilities APIs. 
      • Low Layer drivers APIs are implemented as static inline function in new Inc/stm32f2xx_ll_ppp.h files for PPP peripherals, there is no configuration file and each stm32f2xx_ll_ppp.h file must be included in user code.
      • Refer to UM1739 for Low Layer presentation and UM1940 for API list
  • General update to fix known defects and several implementations enhancement
  • \HAL
    • Add Low Layer drivers under Drivers\STM32F2xx_HAL_Driver
    • Add new HAL driver for MMC 
    • HAL SD drivers overall rework for more efficient implementation
      • Note: this driver rework implied:
        • STM32F2xx Evaluation boards and Discovery boards BSP drivers update
        • FatFS Middleware update
        • All SD applications and examples update
    • HAL NAND driver update to
      • Modify NAND_AddressTypeDef, NAND_DeviceConfigTypeDef and NAND_HandleTypeDef structures fields
      • Add new HAL_NAND_ConfigDevice API
  • \CMSIS
    • Use _Pos and _Mask macros for all Bit Definitions
    • Fix known defects and several implementation enhancement
  • \Middleware
    • Upgrade to use new version of LwIP V2.0.0
      • Note:  Applications based on previous version LwIP V1.4.1 require update to cope with the upgrade to the currently used V2.0.0. For details please refer to its Release Note and to the updated LwIP applications provided by this firmware package.
    • Update to new version of FreeRTOS V9.0.0
    • Update FatFS to implement changes on sd_diskio.c file to be aligned with HAL SD driver and BSP drivers API changes.
    • Add the support of mbedTLS V2.4.0
      • Note:  Starting from this STM32Cube Firmware release PolarSSL is no more supported
    • Update LibJPEG Library V.8d  with a new build to remove all links to FatFS components
      • Note: The updates made on this new build have impact on application based on previous version LibJPEG V8d ST modified 20161118. For details please refer to its Release Note.
    • Update STemWin Library V5.32 with a new build with EWARM V7.70
  • \Projects
    • Add Low Layer examples and MIX examples on the STM32F207ZG-Nucleo board
    • Add new mbedTLS applications to replace PolarSSL middleware applications
    • Update overall projects to be aligned with latest version of HAL, BSP and Middleware drivers

Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain v7.80.1
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain v5.23
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) toolchain v7.0.0
  • System Workbench for STM32 (SW4STM32) toolchain V1.14

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC
  • STM32F207ZG and STM32F207ZG-Nucleo board RevB


Known  Limitations

  • STemWin sample demo application on STM322xG_EVAL is not fully functional with MDK-ARM toolchain: the application doesn't run successfully after the second hit of the Hide Button. in fact when presing the button again while the progress bar displays the next steps, pressing Hide or Next Buttons are not working anymore. 

V1.4.0 / 01-July-2016

Main Changes

  • Maintenance release to fix known defects and several enhancements implementation
  • \HAL
    • General updates to fix known defects and enhancements implementation
    • stm32f2xx_hal_conf_template.h
      • Optimize HSE Startup Timeout value from 5000ms to 100 ms
      • Add new define LSE_STARTUP_TIMEOUT
      • Add new define USE_SPI_CRC for code cleanup when the CRC calculation is disabled.    
    • Update HAL drivers to support MISRA C 2004 rule 10.6
    • Add new template driver to configure timebase using TIMER :

      • stm32f2xx_hal_timebase_tim_template.c
    • Enhance HAL delay and Timebase implementation by means of RTC Alarm or RTC Wakeup usage
    • Almost HAL drivers implementation enhancement requiring update on user application code based on HAL V1.1.3
      • Add peripheral error management during DMA process for HAL UART, USART, IRDA, SMARTCARD, SPI and I2C drivers  
      • Update HAL I2C driver to avoid waiting on STOPF/BTF/AF flag under DMA ISR by using the peripheral end of transfer interrupt in the DMA transfer process.
      • Overall HAL IWDG and WWDG drivers rework
  • \CMSIS
    • General updates to fix known defects and enhancements implementation

  • \Middlewares
    • Update to STemWin 5.32 version
    • Updated USB Device V2.4.2: Fix known defects and enhancement implementation
    • Update to FreeRTOS V8.2.3
    • Update to new build of LwIP V1.4.1 ST modified 20160211
      • Note: Updated architecture having impact on application based on previous version LwIP V1.4.1 ST modified 20140619
  • \BSP
    • General updates to fix known defects and enhancements implementation
  • \Projects
    • General updates to fix known defects and enhancements implementation

    • Update applications and demonstrations related to STemWin library in order to support the latest STemWin version

    • Update HAL_TimeBase_TIM example to use the new HAL timebase template
    • Add HAL_TimeBase_RTC_ALARM and HAL_TimeBase_RTC_WKUP  examples on all the supported boards
    • Projects are updated following changes in latest version of HAL and Middlewares
  • For the complete list of changes, please refer to the release notes of each firmware component


Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain v7.60.1
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain v5.20
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) toolchain v5.5.2
  • System Workbench for STM32 (SW4STM32) toolchain V1.9

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC
  • STM32F207ZG and STM32F207ZG-Nucleo board RevB


Known  Limitations

  • STemWin sample demo application on STM322xG_EVAL is not fully functional with MDK-ARM toolchain: the application doesn't run successfully after the second hit of the Hide Button. in fact when presing the button again while the progress bar displays the next steps, pressing Hide or Next Buttons are not working anymore. 

V1.3.1 / 11-December-2015

Main Changes

  • Patch release to fix issue in Ethernet HAL driver

Contents

V1.3.0 / 20-November-2015

Main Changes

  • Support new  board: STM32F207ZG NUCLEO144
  • Fix known defects and enhancements implementation
  • \HAL
    • 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.1.0
      • Update HAL_CRYP_DESECB_Decrypt() API to invert pPlainData and pCypherData parameters
    • HSE_STARTUP_TIMEOUT constant has been corrected in stm32f2xx_hal_conf_template.h file, its value changed from 5000 to 100. 
  • \CMSIS
    • General updates to fix known defects and enhancements implementation

  • \Middlewares
    • No changes
  • \BSP
    • Add new BPS drivers for STM32F2xx_Nucleo_144 boards
  • \Utilities
    • Use latest version of STM32CubeUpdater V4.10.0
  • \Projects
    • General updates to fix known defects and enhancements implementation

    • Add 34 projects for STM32F207ZG NUCLEO144 boards
For the complete list of changes, please refer to the release notes of each firmware component


Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain v7.40.1
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain v5.16
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) toolchain v5.3.1
  • System Workbench for STM32 (SW4STM32) toolchain V1.3.0

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC
  • STM32F207ZG and STM32F207ZG-Nucleo board RevB


Known  Limitations

  • None

V1.2.0 / 09-October-2015

Main Changes

  • Maintenance release to fix known defects and several enhancements implementation
  • \HAL
    • Macros and literals renaming to ensure full compatibility across STM32 series, backward compatibility with HAL V1.0.1 maintained thanks to new added file stm32_hal_legacy.h under /Inc/Legacy
    • Fix known defects and several enhancements implementation. Four changes done on the HAL requires an update on the application code based on HAL V1.0.1
      • LSI_VALUE constant has been corrected in stm32f2xx_hal_def.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 stm32f2xx_it.c file, PPP_IRQHandler() function: add a call to HAL_PPP_IRQHandler() function
      • HASH IT process: update to call the HAL_HASH_InCpltCallback() at the end of the complete buffer instead of every each 512 bits
      • HAL CRYP driver updated to support multi instance, so user must ensure that the new parameter Instance is initialized in his application(CRYPHandle.Instance = CRYP)
    • Update drivers to be C++ compliant
    • Several update on source code formatting, for better UM generation (i.e. Doxygen tags updated)
    • Add *.chm UM for all drivers, a UM is provided for each superset RPN
  • \CMSIS
    • General updates to fix known defects and enhancements implementation
  • \Middlewares
    • Updated USB Device V2.4.1: fix known defects and several enhancement implementation
    • Updated USB Host V3.2.2: fix known defects and several enhancement implementation
  • \BSP
    • Update STM322xG-EVAL BSP driver to support the cs43l22 audio codec component
  • \Projects
    • Add more Examples and Applications for STM322xG_EVAL board (47 in total)
    • Add the support of System Workbench for STM32 (SW4STM32) toolchain
  • For the complete list of changes, please refer to the release notes of each firmware components


Contents


Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain v7.40.1
  • RealView Microcontroller Development Kit (MDK-ARM) toolchain v5.16
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) toolchain v5.3.1
  • System Workbench for STM32 (SW4STM32) toolchain V1.3.0

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board RevC


Known  Limitations

  • None

V1.1.0 / 13-March-2014

Main Changes

  • Added LCD ili9320 component

V1.0.0 / 07-March-2014

Main Changes

  • First official release of STM32CubeF2 (STM32Cube for STM32F2 Series) 

Contents

  • Drivers

Development Toolchains and Compilers

  • IAR Embedded Workbench for ARM (EWARM) toolchain V6.70.2 + ST-Link
  • RealView Microcontroller Development Kit (MDK-ARM toolchain v4.73)
  • Atollic TrueSTUDIO STM32 (TrueSTUDIO) tool

Supported Devices and EVAL boards

  • STM32F217xx/215xx/207xx/205xx devices and STM322xG_EVAL board
  • This package contains the list of components mentionned above but the current FW package Examples and Applications have used only the following components
    • LCD ili9325
    • Audio Codec cs43l22
    • IO Expander stmpe811
    • Camera ov2640
    • plus
      • eeprom M24C64
      • SRAM IS61WV1024

Known Limitations (planned for next releases)

  • TrueSTUDIO projects are not provided for a few Applications
  • The LCD ili9320 mounted on previous versions of the STM322xG_EVAL board will be supported in a future version of the STM32Cube F2 FW package (V1.1.0)

License

Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); You may not use this package except in compliance with the License. You may obtain a copy of the License at:


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

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