User manual

ManualsBrandsSTMICROELECTRONICS ManualsDev KitsPCB design board

October 2013 DocID025326 Rev 1 1/18

UM1677

User manual

Getting started with STM32F030 Value Line Discovery

development tools

Introduction

This document describes the software, firmware environment and development

recommendations required to build an application around the STM32F0308-DISCOVERY

board (32F0308DISCOVERY) with demonstration firmware (STSW-STM32140).

It presents the firmware applications package provided within this board with details on its

architecture and contents. It provides guidelines to novice users on how to build and run a

sample application and allows them to create and build their own application.

This document is structured as follows:

• System requirements to use this board and how to run the built-in demonstration are

provided in Section 1: Getting started.

• Section 2 describes the firmware applications package.

• Section 4 presents development toolchain installation and overview of ST-LINK/V2

interface.

• Section 5, Section 6, Section 7, and Section 8 introduce how to use the following software

development toolchains:

– IAR Embedded Workbench

for ARM (EWARM) by IAR Systems

– Microcontroller Development Kit for ARM (MDK-ARM) by Keil™

– TrueSTUDIO

by Atollic

Although this user manual cannot cover all the topics relevant to software development

environments, it demonstrates the first basic steps necessary to get started with the

compilers/debuggers.

Reference documents:

• STM32F0308-DISCOVERY high-performance discovery board data brief

• STM32F0308-DISCOVERY peripherals firmware examples (AN4062)

• STM32F0xx reference manual (RM0360)

• STM32F030x4 STM32F030x6 STM32F030x8 datasheet

The above documents are available at www.st.com/stm32f0-discovery.

www.st.com

Summary of content (18 pages)

PAGE 1
UM1677 User manual Getting started with STM32F030 Value Line Discovery development tools Introduction This document describes the software, firmware environment and development recommendations required to build an application around the STM32F0308-DISCOVERY board (32F0308DISCOVERY) with demonstration firmware (STSW-STM32140). It presents the firmware applications package provided within this board with details on its architecture and contents.
PAGE 2
Contents UM1677 Contents 1 2 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2 Running the built-in demonstration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Description of the firmware package . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.1 2.2 2.3 Libraries folder . . . . . . . . . . . . . . .
PAGE 3
UM1677 List of figures List of figures Figure 1. Figure 2. Figure 3. Figure 4. Figure 5. Figure 6. Figure 7. Figure 8. Figure 9. Figure 10. Figure 11. Figure 12. Figure 13. Figure 14. Figure 15. Figure 16. Figure 17. Hardware environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Hardware environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 4
Getting started UM1677 1 Getting started 1.1 System requirements Before running your application, you should establish the connection with the STM32F0308DISCOVERY board as following. Figure 1. Hardware environment To run and develop any firmware applications on your STM32F0308-DISCOVERY board, the minimum requirements are as follows: 1.
PAGE 5
UM1677 2 Description of the firmware package Description of the firmware package The STM32F0308-DISCOVERY firmware applications are provided in one single package and supplied in one single zip file. The extraction of the zip file generates one folder, STM32F0308-Discovery_FW_VX.Y.Z, which contains the following subfolders: Figure 2. Hardware environment 1. VX.Y.Z refer to the package version, ex. V1.0.0 2.
PAGE 6
Description of the firmware package 2.1.2 UM1677 STM32F0xx_StdPeriph_Driver subfolder This subfolder contains sources of STM32F0xx peripheral drivers. Each driver consists of a set of routines and data structures covering all peripheral functionalities. The development of each driver is driven by a common API (application programming interface) which standardizes the driver structure, the functions and the parameter names. Each peripheral has a source code file, stm32f0xx_ppp.
PAGE 7
UM1677 3 Binary images for reprogramming firmware applications Binary images for reprogramming firmware applications This section describes how to use the provided binary images to reprogram the firmware applications. The STM32F030 Discovery firmware package contains binary images (*.hex) of the provided applications under Binary subfolder. You can use any in-system programming tool to reprogram the demonstration using this binary image.
PAGE 8
ST-LINK/V2 installation and development 4 UM1677 ST-LINK/V2 installation and development STM32F030 Discovery board includes an ST-LINK/V2 embedded debug tool interface that is supported by the following software toolchains: • IAR™ Embedded Workbench for ARM (EWARM) available from www.iar.com The toolchain is installed by default in the C:\Program Files\IAR Systems\Embedded Workbench 6.5 directory on the PC’s local hard disk.
PAGE 9
Using IAR Embedded Workbench® for ARM UM1677 5 Using IAR Embedded Workbench® for ARM 5.1 Building an existing EWARM project The following is the procedure for building an existing EWARM project. 1. Open the IAR Embedded Workbench® for ARM (EWARM). Figure 3 shows the basic names of the windows referred to in this document. Figure 3. IAR Embedded Workbench IDE (Integrated Design Environment) 2. In the File menu, select Open and click Workspace to display the Open Workspace dialog box.
PAGE 10
Using IAR Embedded Workbench® for ARM UM1677 If you need to change your project settings (Include and preprocessor defines), you need just to go through project options: – For Include directories Project>Options…>C/C++ compiler> – For pre-processor defines Project>Options…C/C++ compiler>pre-processor> 5.
PAGE 11
UM1677 Using IAR Embedded Workbench® for ARM To run your application, from the Debug menu, select Go. Alternatively, click the Go button in the toolbar to run your application. Figure 7.
PAGE 12
MDK-ARM toolchain 6 UM1677 MDK-ARM toolchain 1. Open Keil MDK-ARM Microcontroller Kit, Figure 8 shows the basic names of the "Keil uVision4"windows referred to in this document. Figure 8. uVision4 IDE 2. In the Project menu, select Open Project... Browse to select either an example or demonstration or template project file and click Open to launch it in the Project window. 3. In the Project menu, select Rebuild All target files to compile your project 4.
PAGE 13
UM1677 MDK-ARM toolchain If you need to change your project settings (Include and preprocessor defines), you need just to go through project options: – For Include directories' Project>Options for Target > C/C++ > Include Paths – For pre-processor defines Project>Options for Target > C/C++ > Preprocessor symbols > Define 5.
PAGE 14
TrueSTUDIO toolchain 7 UM1677 TrueSTUDIO toolchain Follow these steps to use the TrueSTUDIO® toolchain: 1. Open Atollic TrueSTUDIO® for ARM product. The program launches and asks for the Workspace location. Figure 13. TrueSTUDIO® workspace launcher dialog box 2. Browse to select a TrueSTUDIO® workspace of either an example or demonstration or template workspace file and click OK to load it. 3.
PAGE 15
UM1677 TrueSTUDIO toolchain 5. Click Select root directory, browse to the TrueSTUDIO® workspace folder and select the following shownin Figure 15: Figure 15. Atollic TrueSTUDIO® import projects dialog box 6. In the Projects panel, select the project and click Finish. 7. In the Project Explorer, select the project, open the Project menu, and click Build Project.
PAGE 16
TrueSTUDIO toolchain 8. UM1677 If your project is successfully compiled, the following messages will be displayed on the Console window. Figure 16. TrueSTUDIO® project successfully compiled If you need to change the project settings (Include directories and preprocessor defines), you need just to go through Project>Properties, select C/C++ Build>Settings from the left panel: – For Include directories C Compiler>Directories>Include path – For pre-processor defines C Compiler>Symbols> Defined symbols 9.
PAGE 17
UM1677 8 Revision history Revision history Table 1. Document revision history Date Revision 03-Oct-2013 1 Changes Initial release.
PAGE 18
UM1677 Please Read Carefully: Information in this document is provided solely in connection with ST products. STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, modifications or improvements, to this document, and the products and services described herein at any time, without notice. All ST products are sold pursuant to ST’s terms and conditions of sale.