ST STM32CubeF2 Bedienungsanleitung

March 2017 DocID026120 Rev 4 1/22

UM1739

User manual

Getting started with STM32CubeF2 firmware package

for STM32F2 Series

Introduction

The STMCube™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

– The Low Layer APIs (LL) offering a fast lightweight expert-oriented layer which is

closer to the hardware than the HAL. The LL APIs are available only for a set of

peripherals

– A consistent set of middleware components such as RTOS, USB, TCP/IP and

graphics

– All embedded software utilities, with a full set of examples.

www.st.com

Contents UM1739

2/22 DocID026120 Rev 4

Contents

1 STM32CubeF2 main features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 STM32CubeF2 architecture overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 STM32CubeF2 firmware package overview . . . . . . . . . . . . . . . . . . . . . . 9

3.1 Supported STM32F2 Series devices and hardware . . . . . . . . . . . . . . . . . . 9

3.2 Firmware package overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Getting started with STM32CubeF2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.1 How to run a first example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2 How to develop an application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.2.1 HAL application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.2.2 LL application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.3 Using STM32CubeMX to generate the initialization C code . . . . . . . . . . 18

4.4 Getting STM32CubeF2 release updates . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.4.1 Installing and running the STM32CubeUpdater program . . . . . . . . . . . 18

5 Frequently asked questions (FAQs) . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

DocID026120 Rev 4 3/22

UM1739 List of tables

List of tables

Table 1. Macros for STM32F2 Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Table 2. STMicroelectronics boards for STM32F2 Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Table 3. Number of examples available on the boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Table 4. Document revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

List of figures UM1739

4/22 DocID026120 Rev 4

List of figures

Figure 1. STM32CubeF2 firmware components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Figure 2. STM32CubeF2 firmware architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Figure 3. STM32CubeF2 firmware package overview(1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Figure 4. Overview of STM32CubeF2 examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

DocID026120 Rev 4 5/22

UM1739 STM32CubeF2 main features

1 STM32CubeF2 main features

STM32CubeF2 gathers in a single package all the generic embedded software components

required to develop an application on STM32F2 microcontrollers. In line with the

STM32Cube initiative, this set of components is highly portable, not only within the

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 the Low Layer (LL) and the Hardware

Abstraction Layer (HAL) APIs that cover the microcontroller hardware, together with an

extensive set of examples running on STMicroelectronics boards. The HAL and LL APIs are

available in an open-source BSD license for user convenience.

The STM32CubeF2 package also contains a set of middleware components with the

corresponding examples. They come with 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 the emWin solution from the ST partner SEGGER

•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

STM32CubeF2 main features UM1739

6/22 DocID026120 Rev 4

A demonstration implementing all these middleware components is also provided in the

STM32CubeF2 package.

Figure 1. STM32CubeF2 firmware components

069

$SSOLFDWLRQOHYHOGHPRQVWUDWLRQV

8WLOLWLHV

0LGGOHZDUHOHYHO

+$/DQG//$3,V

7KHVHWRIPLGGOHZDUHFRPSRQHQWVGHSHQGVRQWKHSURGXFW6HULHV

8VHU

DSSOLFDWLRQ

(YDOXDWLRQ

ERDUGV

'LVFRYHU\

ERDUGV

6701XFOHR

ERDUGV

'HGLFDWHG

ERDUGV

7&3,3 )$7ILOH

V\VWHP

5726

86% *UDSKLFV

+DUGZDUH$EVWUDFWLRQ/D\HU+$/%RDUG6XSSRUW3DFNDJH%63 /RZ/D\HU//

8WLOLWLHV

&06,6

DocID026120 Rev 4 7/22

UM1739 STM32CubeF2 architecture overview

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. STM32CubeF2 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 on the hardware boards (for example audio codec, IO expander,

Touchscreen, SRAM driver, LCD drivers) and composed of two parts:

– Component: this is the driver related to the external device on the board and not

related to the STM32, the component driver provides specific APIs to the BSP

driver external components and can be ported to 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().

The 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. For example, for the communication peripherals (I2S, UART…) it provides

06Y9

(YDOXDWLRQERDUGDQG'LVFRYHU\.LWGHPRQVWUDWLRQ

$SSOLFDWLRQV

/LEUDU\DQGSURWRFROEDVHGFRPSRQHQWV

IRUH[DPSOH)DW)6)UHH572686%'HYLFH

([DPSOHV

%63GULYHUV

&RUHGULYHUVRSWLRQDO

+DUGZDUHDEVWUDFWLRQOD\HU+$/

,>

>ĞǀĞůϬ

>ĞǀĞůϭ

>ĞǀĞůϮ

/RZ/D\HU//

STM32CubeF2 architecture overview UM1739

8/22 DocID026120 Rev 4

APIs allowing to initialize and configure the peripheral, manage data transfer based on

polling, interrupt or DMA process, and handle 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 the examples of the basic

operation of the STM32F2 peripherals using either the HAL or/and the Low Layer

drivers APIs as well as the BSP resources.

•Low Layer (LL):

– The low layer APs provide low-level APIs at register level, with a better

optimization but less portability. They require a deep knowledge of MCU and

peripheral specifications. The LL drivers are designed to offer a fast lightweight

expert-oriented layer which is closer to the hardware than the HAL. Contrary to the

HAL, the LL APIs are not provided for peripherals where the optimized access is

not a key feature, or those requiring a heavy software configuration and/or a

complex upper-level stack (such as FMC, USB or SDMMC).

The LL drivers feature:

– A set of functions to initialize peripheral main features according to the parameters

specified in data structures

– A set of functions used to fill initialization data structures with the reset values

corresponding to each field

– A function for peripheral de-initialization (peripheral registers restored to their

default values)

– A set of inline functions for a direct and atomic register access

– A full independence from the HAL and the capability to be used in standalone

mode (without HAL drivers)

– A full coverage of the supported peripheral features.

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 (called also Applications) showing how to use the

component. Integration examples using several middleware components are provided

as well.

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. The user can rely on the Level 2 projects provided with the STM32CubeF4

firmware package as example.

DocID026120 Rev 4 9/22

UM1739 STM32CubeF2 firmware package overview

3 STM32CubeF2 firmware package overview

3.1 Supported STM32F2 Series devices and hardware

STM32Cube offers a highly portable Hardware Abstraction Layer (HAL) built around a

generic and modular architecture. It allows the upper layers, the middleware and

application, to implement its functions without knowing, in-depth, the MCU used. This

improves the library code re-usability and guarantees an easy portability from one device to

another.

The STM32CubeF2 offers a full support for all the STM32F2 Series devices. The user only

needs to define the right macro in stm32f2xx.h.

Table 1 lists which macro to define depending on the used STM32F2 device. 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/or middleware components. These examples are

running on the STMicroelectronics boards listed in Table 2.

The STM32CubeF2 firmware can run on any compatible hardware. Simply update the BSP

drivers to port the provided examples on the user board if its hardware features are the

same (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

STM32F207ZG-Nucleo STM32F207ZG

STM32CubeF2 firmware package overview UM1739

10/22 DocID026120 Rev 4

3.2 Firmware package overview

The STM32CubeF2 firmware solution is provided in one single zip package with the

structure shown in Figure 3.

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 STM32F207ZG-Nucleo 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

%63GULYHUVIRUWKHVXSSRUWHG

ERDUGV

'ULYHUVRIH[WHUQDOFRPSRQHQWV

670)[[+$/DQG//GULYHUV

IRUDOOPRGXOHV

Inhaltsverzeichnis

Andere ST Computerhardware Handbücher

ST ST10R272L Bedienungsanleitung

ST X-NUCLEO-IHM07M1 Bedienungsanleitung

ST X-NUCLEO-OUT17A1 Bedienungsanleitung

ST ZigBee SNDEV-260 Bedienungsanleitung

ST X-NUCLEO-GNSS1A1 Bedienungsanleitung

ST STM32U5 Bedienungsanleitung

ST STEVAL-MIC008A Bedienungsanleitung

ST STEVAL-IHM017V1 Bedienungsanleitung

ST STR9 Bedienungsanleitung

ST FP-ATR-ASTRA1 Bedienungsanleitung

ST STM32L562E-DK Bedienungsanleitung

ST STM32 Nucleo Bedienungsanleitung

ST CLT01-38SQ7 Bedienungsanleitung

ST FP-LIT-BLEMESH1 Bedienungsanleitung

ST I-CUBE-LRWAN Bedienungsanleitung

ST STM32F107Series Bedienungsanleitung

ST X-LINUX-NFC5 Bedienungsanleitung

ST STEVAL-ST25R3916B Bedienungsanleitung

ST MB467 Bedienungsanleitung

ST STM32U575 Series Montage- und Bedienungsanleitung

ST Nomadik NHK-15 Bedienungsanleitung

ST STEVAL-ETH001V1 Bedienungsanleitung

ST X-NUCLEO-GFX01M1 Bedienungsanleitung

ST STEVAL-IOD002V1 Bedienungsanleitung

Beliebte Computerhardware Handbücher anderer Marken

EMC2

EMC2 VNX Series Betriebsanleitung

Panasonic

Panasonic DV0PM20105 Bedienungsanleitung

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Bedienungsanleitung

Gigabyte

Gigabyte B660M DS3H AX DDR4 Bedienungsanleitung

Raidon

Raidon iT2300 Bedienungsanleitung

National Instruments

National Instruments PXI-8186 Bedienungsanleitung

Hauppauge

Hauppauge WinTV-HVR-2250 Bedienungsanleitung

Kontron

Kontron CP6002 Bedienungsanleitung

Manhattan

Manhattan 702843 Bedienungsanleitung

Aphex

Aphex 230 Bedienungsanleitung

Intel

Intel NUC 12 Pro Bedienungsanleitung

Galaxy

Galaxy GHDX2-2430S-24F4D Bedienungsanleitung

Intel

Intel AXXRMFBU4 Bedienungsanleitung

Kontron

Kontron DIMM-PC/MD Bedienungsanleitung

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Bedienungsanleitung

Advantech

Advantech ASMB-935 Series Bedienungsanleitung

Jupiter

Jupiter RAM PACK Bedienungsanleitung

Measurement Computing

Measurement Computing CIO-EXP-RTD16 Bedienungsanleitung