ST STM32F2 Series Manuel utilisateur

September 2015 DocID026120 Rev 2 1/19

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

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

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

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

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

Autres manuels pour STM32F2 Series

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels ST Microcontrôleur

ST STM32F100 Series Instructions d'installation et d'utilisation

ST STEVAL-IDB007V1M SPBTLE-1S Manuel utilisateur

ST STM32F103 series Instructions d'installation et d'utilisation

ST STM32F4DISCOVERY Manuel utilisateur

ST STM32H7B3I-DK Manuel utilisateur

ST STEVAL-MKBOXPRO Manuel utilisateur

ST STM32H723 Manuel utilisateur

ST STEVAL-BFA001V1B Manuel utilisateur

ST STM32F429I-DISCO Manuel utilisateur

ST STM32F7508-DK Manuel

ST STR9 Manuel utilisateur

ST STM8A Instructions d'installation et d'utilisation

ST BlueNRG Manuel utilisateur

ST STEVAL-IPC004V1 Manuel utilisateur

ST STM32F20 Series Instructions d'installation et d'utilisation

ST STM32F423 Series Manuel utilisateur

ST STM32L0x3 Manuel utilisateur

ST EVLKST8500GH868 Manuel utilisateur

ST ST25R3911B Manuel utilisateur

ST STM32 Nucleo Manuel utilisateur

ST STEVAL-L6982NDR Manuel utilisateur

ST UM2334 Manuel utilisateur

ST NUCLEO-WB55RG STM32WB Manuel utilisateur

ST STM32MP157C-DK2 Manuel utilisateur

Manuels Microcontrôleur populaires d'autres marques

AMS

AMS AS7261 Demo Kit Manuel utilisateur

Novatek

Novatek NT6861 Manuel utilisateur

Espressif Systems

Espressif Systems ESP8266 SDK Guide de configuration

Nuvoton

Nuvoton ISD61S00 ChipCorder Mode d’emploi

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Manuel utilisateur

Texas Instruments

Texas Instruments Chipcon CC2420DK Manuel utilisateur

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Manuel utilisateur

NEC

NEC 78GK0S/K 1+ Series Instructions d'installation et d'utilisation

Mikroe

Mikroe SEMITECH N-PLC Click Instructions d'installation et d'utilisation

Intel

Intel Agilex Manuel utilisateur

Cypress

Cypress CY4607 HX2VL Manuel utilisateur

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Manuel utilisateur

Texas Instruments

Texas Instruments TMS320F2837 D Series Manuel utilisateur

CYPRES

CYPRES CY14NVSRAMKIT-001 Manuel utilisateur

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Manuel utilisateur

Espressif Systems

Espressif Systems ESP8266EX Mode d'emploi

Abov

Abov AC33M8128L Manuel utilisateur

Laird

Laird BL654PA Manuel utilisateur