ST STM32F2 Series User manual

September 2015 DocID026120 Rev 2 1/19
1
UM1739
User manual
Getting started with STM32CubeF2 firmware package
for STM32F2 series
Introduction
STM32Cube™initiative was originated by STMicroelectronics to ease developers' life by
reducing development efforts, time and cost. STM32Cube™covers the STM32 portfolio.
STM32CubeVersion 1.x includes:
The STM32CubeMX, a graphical software configuration tool that allows the generation of
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 and
graphics,
– All embedded software utilities coming with a full set of examples.
www.st.com

Contents UM1739
2/19 DocID026120 Rev 2
Contents
1 STM32CubeF2 main features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 STM32CubeF2 architecture overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 STM32CubeF2 firmware package overview . . . . . . . . . . . . . . . . . . . . . . 8
3.1 Supported STM32F2 devices and hardware . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 Firmware package overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.1 Running your first example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.2 Developing your own application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.3 Using STM32CubeMX to generate the initialization C code . . . . . . . . . . 16
4.4 Accessing STM32CubeF2 release updates . . . . . . . . . . . . . . . . . . . . . . . 16
4.4.1 Installing and running the STM32CubeUpdater program . . . . . . . . . . . 16
5 Frequently asked questions (FAQs) . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

DocID026120 Rev 2 3/19
UM1739 List of tables
3
List of tables
Table 1. Macros for STM32F2 series . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Table 2. STMicroelectronics boards for STM32F2 series. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Table 3. Number of examples available on the boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Table 4. Document revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

List of figures UM1739
4/19 DocID026120 Rev 2
List of figures
Figure 1. STM32CubeF2 firmware components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Figure 2. Firmware architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Figure 3. STM32CubeF2 firmware package overview (1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Figure 4. Overview of STM32CubeF2 examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

DocID026120 Rev 2 5/19
UM1739 STM32CubeF2 main features
18
1 STM32CubeF2 main features
STM32CubeF2 gathers in one single package all the generic embedded software
components required to develop an application on STM32F2 microcontrollers. Following
STM32Cube initiative, this set of components is highly portable, not only within STM32F2
series but also to other STM32 series.
STM32CubeF2 is fully compatible with STM32CubeMX code generator that allows the user
to generate initialization code. The package includes a low-level hardware abstraction layer
(HAL) that covers the microcontroller hardware, together with an extensive set of examples
running on STMicroelectronics boards. The HAL is available in open-source BSD license for
user convenience.
STM32CubeF2 package also contains a set of middleware components with the
corresponding examples. They come in very permissive license terms:
Full USB Host and Device stack supporting many classes.
– Host Classes: HID, MSC, CDC, Audio, MTP
– Device Classes: HID, MSC, CDC, Audio,
DFU
STemWin, a professional graphical stack solution available in binary format and based
on ST partner solution SEGGER emWin
CMSIS-RTOS implementation with FreeRTOS open source solution
FAT File system based on open source FatFS solution
TCP/IP stack based on open source LwIP solution
SSL/TLS secure layer based on open source PolarSSL
A demonstration implementing all these middleware components is also provided in the
STM32CubeF2 package.
Figure 1. STM32CubeF2 firmware components
06Y9
(YDOXDWLRQERDUGV 'LVFRYHU\ERDUGV 1XFOHRERDUGV
7&3,3 86%+RVW
'HYLFH *UDSKLFV )$7ILOH V\VWHP 5726
8WLOLWLHV
&06,6
670)
+DUGZDUH$EVWUDFWLRQ/D\HU+$/
670) 670) 670) 670) 670/
$SSOLFDWLRQOHYHOGHPRQVWUDWLRQV
8WLOLWLHV0LGGOHZDUHOHYHO
+$/OHYHO
+DUGZDUH
'HGLFDWHGERDUGV
%RDUG6XSSRUW3DFNDJH%63

STM32CubeF2 architecture overview UM1739
6/19 DocID026120 Rev 2
2 STM32CubeF2 architecture overview
The STM32Cube firmware solution is built around three independent levels that can easily
interact with each other as described in Figure 2.
Figure 2. Firmware architecture
Level 0: this level is divided into three sub-layers:
Board Support Package (BSP): this layer offers a set of APIs related to the hardware
components in the hardware boards (for example Audio codec, IO expander,
Touchscreen, SRAM driver, LCD drivers) and composed of two parts:
– Component: the driver related to the external device on the board and not related
to the STM32, the component driver provide specific APIs to the BSP driver
external components and can be ported on any other board.
– BSP driver: it enables the component driver to be linked to a specific board and
provides a set of user-friendly APIs. The API naming rule is
BSP_FUNCT_Action(), for example BSP_LED_Init(),BSP_LED_On().
BSP is based on a modular architecture that allows it to be ported easily to any
hardware by just implementing the low-level routines.
Hardware Abstraction Layer (HAL): this layer provides the low-level drivers and the
hardware interfacing methods to interact with the upper layers (application, libraries
and stacks). It provides a generic, multi instance and function-oriented APIs which
allow to offload the user application implementation by providing ready-to-use
processes. As an example, for the communication peripherals (I2S, UART…) it
06Y9
(YDOERDUGDQG'LVFRYHU\.LWGHPRQVWUDWLRQ
$SSOLFDWLRQV
/LEUDU\DQGSURWRFROEDVHGFRPSRQHQWV)DW)6)UHH572686%
+RVW86%'HYLFH(WKHUQHW«
([DPSOHV
%63GULYHUV
/RZOHYHO'ULYHU&RUHRSWLRQDO
+$/SHULSKHUDOGULYHUV
,>
>ĞǀĞůϬ
>ĞǀĞůϭ
>ĞǀĞůϮ

DocID026120 Rev 2 7/19
UM1739 STM32CubeF2 architecture overview
18
provides APIs allowing to initialize and configure the peripheral, manage data transfer
based on polling, interrupt or DMA process, and manage communication errors that
may raise during communication. The HAL Drivers APIs are split into two categories:
– the generic APIs that provide common and generic functions to all the STM32
series,
– the extension APIs that provide specific and customized functions for a specific
family or a specific part number.
Basic peripheral usage examples: this layer contains examples of basic operation of
the STM32F2 peripherals using only the HAL and BSP resources.
Level 1: This level is divided into two sub-layers:
Middleware components: set of Libraries covering USB Host and Device Libraries,
STemWin, FreeRTOS, FatFS, LwIP, and PolarSSL. The horizontal interactions
between the components of this layer are done directly by calling the feature APIs while
the vertical interaction with the low-level drivers is done through specific callbacks and
static macros implemented in the library system call interface. As an example, the
FatFs implements the disk I/O driver to access the microSD drive or the USB Mass
Storage Class.
Examples based on the Middleware components: each Middleware component
comes with one or more examples (also called Applications) showing how to use the
component. Integration examples using several Middleware components are also
provided.
Level 2: This level is composed of a single layer which is a global real-time and graphical
demonstration based on the Middleware service layer, the low-level abstraction layer and
the basic peripheral usage applications for board-based functions.
In the current version of the STM32CubeF2 firmware package, no Level 2 projects are
provided. You can rely on the Level 2 projects provided with the STM32CubeF4 firmware
package as example.

STM32CubeF2 firmware package overview UM1739
8/19 DocID026120 Rev 2
3 STM32CubeF2 firmware package overview
3.1 Supported STM32F2 devices and hardware
STM32Cube offers a highly portable Hardware Abstraction Layer (HAL) built around a
generic architecture allowing the upper layers, for example the Middleware layer, to
implement its functions without the need to know in-depth the MCU in use. This improves
the library code re-usability and guarantees an easy portability from one device to another.
The STM32CubeF2 offers full support for all devices of the STM32F2 series. The user only
has to define the right macro in stm32f2xx.h.
Table 1 lists the macro to define depending on the STM32F2 device in use. Note that the
macro must also be defined in the compiler preprocessor.
STM32CubeF2 features a rich set of examples and applications at all levels making it easy
to understand and use any HAL driver and/orMiddleware components. These examples are
running on the STMicroelectronics boards listed in Table 2.
The STM32CubeF2 firmware is able to run on any compatible hardware. The users can
simply update the BSP drivers to port the provided examples on their own board, providing
that their board support the same hardware functions (for example LED, LCD Display,
Buttons).
Table 1. Macros for STM32F2 series
Macro defined in
stm32f2xx.h STM32F2 devices
STM32F205xx STM32F205RB,STM32F205RC, STM32F205RE, STM32F205RF, STM32F205RG, STM32F205VB, STM32F205VC, STM32F205VE, STM32F205VF STM32F205VG,
STM32F205ZC, STM32F205ZE, STM32F205ZF and STM32F205ZG
STM32F215xx STM32F215RE, STM32F215RG, STM32F215VE, STM32F215VG, STM32F215ZE
and STM32F215ZG
STM32F207xx STM32F207IC, STM32F207IE, STM32F207IF, STM32F207IG, STM32F207VC, STM32F207VE, STM32F207VF, STM32F207VG, STM32F207ZC, STM32F207ZE,
STM32F207ZF and STM32F207ZG
STM32F217xx STM32F217VG, STM32F217VE, STM32F217ZG, STM32F217ZE, STM32F217IG and
STM32F217IE
Table 2. STMicroelectronics boards for STM32F2 series
Board STM32F2 devices supported
STM322xG_EVAL STM32F207xx and STM32F217xx

DocID026120 Rev 2 9/19
UM1739 STM32CubeF2 firmware package overview
18
3.2 Firmware package overview
The STM32CubeF2 firmware solution is provided in one single zip package with the
structure shown in Figure 3 hereafter.
Figure 3. STM32CubeF2 firmware package overview (1)
1. The library files cannot be modified by the user while the set of examples are modifiable files.
For each board supporting the devices of the STM32F2 series, a set of examples with
preconfigured projects is provided for EWARM, MDK-ARM, TrueSTUDIO and SW4STM32
toolchains.
Figure 4 shows the projects structure for the STM322xG-EVAL board.
069
0LVFHOODQHDRXVXWLOLWLHV
6HWRIH[DPSOHVRUJDQL]HG
E\ERDUGDQGSURYLGHGZLWK
SUHFRQILJXUHGSURMHFWV
&RQWDLQV670)[[&06,6
ILOHVWKDWGHILQHWKHSHULSKHUDO
UHJLVWHUGHFODUDWLRQV
WKHELWGHILQLWLRQVDQG
WKHDGGUHVVPDSSLQJ
67HP:LQSURIHVVLRQDO
VWDFNFRPLQJIURP
6(**(5DQGDYDLODEOH
LQELQDU\IRUP
86%+RVW/LEUDU\
VXSSRUWLQJERWK27*)6
DQG+6FRUHVDQGRIIHULQJ
WKHIROORZLQJFODVVHV
+,'06&&'&$XGLR
DQG073
2SHQVRXUFHPLGGOHZDUH
VWDFNV
86%'HYLFH/LEUDU\
VXSSRUWLQJERWK27*)6
DQG+6FRUHVDQGRIIHULQJWKH
IROORZLQJFODVVHV+,'06&
&'&$XGLRDQG')8
$XGLRSURFHVVLQJOLEUDULHV
670)[[+$/GULYHUV
IRUDOOPRGXOHV
%63GULYHUVIRUWKHVXSSRUWHG
ERDUGV
'ULYHUVRIH[WHUQDOFRPSRQHQWV

STM32CubeF2 firmware package overview UM1739
10/19 DocID026120 Rev 2
Figure 4. Overview of STM32CubeF2 examples