Getting started with STM32 Nucleo board software development tools
Contents
1. wl mm wl KG ml wel rie Fl 0x08000000 Go New Tab Monitors dk 3t 2 x 8008088 20002000 x 80G808C 8800028F 8000000 Traditional 23 1 The debugger in the Atollic TrueSTUDIO can be used to debug source code at C and assembly levels set breakpoints monitor individual variables and watch events during the code execution To run your application from the Run menu select Resume or alternatively click the Resume button in the toolbar DocID025840 Rev 1 17 20 Firmware package UM1727 4 2 18 20 Software toolchain helpful references and web sites Table 2 gives useful references about the integrated development environments described in this document Table 2 References and web sites Toolchain Web sites EWARM www iar com MDK ARM www keil com TrueSTUDIO www atollic com DoclDO25840 Rev 1 3 UM1727 Revision history 5 3 Revision history Table 3 Document revision history Date 19 May 2014 Revision 1 Initial release Changes DoclDO25840 Rev 1 19 20 UM1727 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 serv2. 3 14 20 DoclDO25840 Rev 1 UM1727 Firmware package Figure 15 Atollic TrueSTUDIO import source select dialog box Ore yg ka Select Create new projects from an archive file or directory Ed Select an import source type filter text 4 amp General Archive File Existing Projects into Workspace CJ File System E Preferences gt amp C C amp cvs 2 Example projects Git gt Install 2 Run Debug SVN Tasks gt amp Team 5 Click Select root directory and browse to the TrueSTUDIO workspace folder DoclDO25840 Rev 1 15 20 3 Firmware package UM1727 Figure 16 Atollic TrueSTUDIO import projects dialog box 25 Don EE en Import Projects Select a directory to search for existing Eclipse projects Select root directory CASTM32_Nucleo_FW_V1 0 0 Projects NUCLEC Select archive file Projects V 10_Toggle CASTM32_Nucleo_FW_V1 0 0 Projects NUCLEO F030F Select All Deselect All Refresh aNG NT Copy projects into workspace Working sets Add project to working sets Working set Cana 6 Inthe Projects panel select the project and click Finish 7 Inthe Project Explorer select the project open the Project menu and click Build Project 8 If your project is successfully compiled the following messages will be displayed on the Console
3. Oxf Ha 9 STM32F Ox brief Main program E DataTablei 5 Ha DJ User param None ie Ox800061c Oxf La Output retval None 2 DataTablei 6 af Ox8000620 0x4 main void DataTablel 7 z 0x8000624 Oxf lt At this stage the microcontroller clock setting is a int main void this is done through SystemInit function which is f file startup stm32f030 s before to branch to appli To reconfigure the default setting of SystemInit fi A Soca en AE 08000628 Oxk l0 Toggle ee bow matibag U Messages Building configuration O Toggle 0O Toggle Updating build tree Configuration is up to date Ready Errors 0 Warnings 0 To run your application from the Debug menu select Go Alternatively click the Go button in the toolbar to run your application Figure 8 Go button F Sys Tick IAR Embedded Workbench IDE File Edit View Project Debug Disassembly ST Dada i SB amp PN i gt FT TTITTEOI i ETM SWO Workspace x 3 DoclDO25840 Rev 1 11 20 Firmware package UM1727 4 1 2 MDK ARM toolchain 1 Open Keil MDK ARM Microcontroller Kit Figure 9 shows the basic names of the Keil uvision4 windows referred to in this document Figure 9 uvisiond IDE Foe ten Project Flach Oabop Pengderak Tosh SVCS Window Map NG dels sa o TABLA MED ar Jaaa ale SJSN NAR Workspace window File window Bui
4. AERONAUTIC APPLICATIONS C AUTOMOTIVE APPLICATIONS OR ENVIRONMENTS AND OR D AEROSPACE APPLICATIONS OR ENVIRONMENTS WHERE ST PRODUCTS ARE NOT DESIGNED FOR SUCH USE THE PURCHASER SHALL USE PRODUCTS AT PURCHASER S SOLE RISK EVEN IF ST HAS BEEN INFORMED IN WRITING OF SUCH USAGE UNLESS A PRODUCT IS EXPRESSLY DESIGNATED BY ST AS BEING INTENDED FOR AUTOMOTIVE AUTOMOTIVE SAFETY OR MEDICAL INDUSTRY DOMAINS ACCORDING TO ST PRODUCT DESIGN SPECIFICATIONS PRODUCTS FORMALLY ESCC QML OR JAN QUALIFIED ARE DEEMED SUITABLE FOR USE IN AEROSPACE BY THE CORRESPONDING GOVERNMENTAL AGENCY Resale of ST products with provisions different from the statements and or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever any liability of ST ST and the ST logo are trademarks or registered trademarks of ST in various countries Information in this document supersedes and replaces all information previously supplied The ST logo is a registered trademark of STMicroelectronics All other names are the property of their respective owners 2014 STMicroelectronics All rights reserved STMicroelectronics group of companies Australia Belgium Brazil Canada China Czech Republic Finland France Germany Hong Kong India Israel Italy Japan Malaysia Malta Morocco Philippines Singapore Spain
5. EE EE OE OE OE EE ED 8 IAR Embedded Workbench IDE ee eens 9 EWARM project successfully compiled 1 0 2 2 0000 cee 10 Download and Debug button 2 0 eae 10 IAR Embedded Workbench debugger screen Ee eee 11 SOs UCU ss EER ORE EO eh ag EE A 11 vision4 dIE RE eda ein eke RE deb vee tee ek Chav bd EIE ET 12 MDK ARM project successfully compiled 1 EE EE EG Ee eee 12 Start Stop Debug Session button 00 eee 13 MDK ARM debugger screen 000 cette 13 Run oie RR OE OE ER OE iad pide NE EE EE N a seas 13 TrueSTUDIO workspace launcher dialog BOX ei EE EE eee 14 Atollic TrueSTUDIO import source select dialog box 15 Atollic TrueSTUDIO import projects dialog box a 16 TrueSTUDIO project successfully compiled EE EE EE Ee eee 16 TrueSTUDIO debug window ii EE ee eee 17 3 DoclDO25840 Rev 1 UM1727 System requirements 1 System requirements Before running your application you should 1 Install your preferred Integrated Development Environment IDE 2 Install the ST LINK V2 driver from the ST web site The ST LINK V2 driver is installed automatically In case of problem you can install manually the driver from toolchains install directory further details available at Section 3 3 Download the STM32 Nucleo firmware from www st com stm32nucleo 4 Establish the connection with the STM32 Nucleo board by connecting CN
6. Nucleo development tools niles SIAR n DoclD025840 Rev 1 1 20 www st com Contents UM1727 Contents 1 System requirements seke ss ss ka RR RR ER RR RR RR RR Ee 5 2 IDEs supporting STM32 Families iss ske ee ee RR eee eee ER RR 6 3 ST LINK V2 installation ee ee ese ee RR RR ER RR eee 7 4 Firmware package EES ama NG NEER KERE NEE EES EE RENEE ER KE se 8 4 1 Executing and debugging firmware using software toolchains 8 4 1 1 EWARM toolchain EE EE GE tees 8 4 1 2 MDK ARM toolchain 00 cee eee 12 4 1 3 TrueSTUDIO toolchain nanana EE eee ee 14 4 2 Software toolchain helpful references and web sites 18 5 Revision history vsncusaeestacek RR Ed AARDE hb AGE RE DE 19 2 20 DoclD025840 Rev 1 ky UM1727 List of tables List of tables Table 1 Nucleo board general information ie 000 Ee ee eee 6 Table 2 References and web sites EE EE EG SE teens 18 Table 3 Document revision history ect eee eee 19 DoclDO25840 Rev 1 3 20 3 List of figures UM1727 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 Figure 18 4 20 Nucleo development tools EE EE EE EE EE tte ee 1 Hardware environment is Se se ee ee eee 5 Package CONE NB OR OR ANG OE
7. Sweden Switzerland United Kingdom United States of America www st com 20 20 DocID025840 Rev 1 ky
8. 1 of the Nucleo board to the USB port of the PC The above steps will be details in the coming sections Figure 2 Hardware environment To run and develop any firmware application on an STM32 Nucleo board the minimum requirements are as follows e Windows PC XP Vista 7 8 e USB type A to Mini B cable used to power the board through USB connector CN1 from host PC and connect to the embedded ST LINK V2 for debugging and programming q DoclDO25840 Rev 1 5 20 IDES supporting STM32 Families UM1727 2 IDES supporting STM32 Families STMicroelectronics STM32 families of 32 bit ARM Cortex M core based microcontrollers are supported by a complete range of software tools It encompasses traditional integrated development environment IDEs with C C compilers and debuggers from major third parties free versions up to 64KB of code depending on partner completed with innovative tools from STMicroelectronics Table 1 displays general information about Nucleo boards available for the following STM32 devices as well as some integrated development environments Table 1 Nucleo board general information Order code Targeted MCU NUCLEO F030R8 STM32F030R8T6 NUCLEO F072RB STM32F072RBT6 NUCLEO F103RB STM32F103RBT6 NUCLEO F302R8 STM32F302R8T6 NUCLEO F401RE STM32F401RET6 NUCLEO L152RE STM32L152RET6 Toolchains supporting all Nucleos EWARM v7 10 3 and later 7 30 day eval
9. 3 Command a Call Stack Locals g Load C STM32_Nucleo_FW_V1 0 0 Projects NUCLEO FO30R 4 Name Location Value Kane 9 main 0x080006AC int fp Ti m J r 4 ASSIGN BreakDisable BreakEnable BreakKill BreakList Een Stack Locals Memory 1 ST Link Debugger 41 0 00000000 sec L60 G1 To run your application from the Debug menu select Run Alternatively click the Run button in the toolbar to run your application Figure 13 Run button NG ad aa 2 EO amp P OD 3 DoclDO25840 Rev 1 13 20 Firmware package UM1727 4 1 3 TrueSTUDIO toolchain 1 Open Atollic TrueSTUDIO for ARM product The program launches and requires the Workspace location Figure 14 TrueSTUDIO workspace launcher dialog box NN Select a workspace Atollic TrueSTUDIO for ARME stores your projects in a folder called a workspace Choose a workspace folder to use for this session Workspace C STM32_Nucleo_FW_V1 0 0 Projects NUCLEO FO30R8 I0_Toggle TrueSTU Use this as the default and do not ask again 2 Browse to select a TrueSTUDIO workspace of either an example or demonstration or template workspace file and click OK to load it 3 Toload an existing project in the selected workspace select Import from the File menu to display the Import dialog box 4 In the Import window open General select Existing Projects into Workspace and click Next
10. SEEN wa UM1727 WI life augmented User manual Getting started with STM32 Nucleo board software development tools May 2014 Introduction The STM32 Nucleo board NUCLEO F030R8 NUCLEO F072RB NUCLEO F103RB NUCLEO F302R8 NUCLEO F401RE NUCLEO L152RE is a low cost and easy to use development platform used to quickly evaluate and start a development with an STM32 microcontroller in LQFP64 package This document describes the software environment and development recommendations required to build an application around the STM32 Nucleo board It provides guidelines to beginners on how to build and run a sample application and allows them to create and build their own application It has the following structure e The first chapter presents software and hardware requirements some toolchains supporting the STM32 families ST LINK V2 installation and firmware package presentation e The second chapter provides step by step guideline on how to execute and debug an application example using some toolchains IAR Embedded Workbench for ARM EWARM by IAR systems Microcontroller Development Kit for ARM MDK ARM by Keil TrueSTUDIO by Atollic Although this 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 and offers links to the documents needed to fully understand every single step Figure 1
11. debug and run the application select the project In the Project Explorer and press F11 to start a debug session Figure 18 TrueSTUDIO debug window File Edit View Run Window Help Se CRW ERIA EP O H G ri RE Debug Be c c 47 48 9 o 4 5 5 5 5 Whe Debug BN k 7 7 O 09 Variables Po Breakpoint E SFRs i BA Module O 4 E 10_Toggle elf Embedded C C Application s3 BE is as NG 4 4 10_Toggle elf ai 4 n Thread 1 smain Suspended Breakpoint E pi gdb s9 ST LINK E STM32F030R8_FLASH Id B startup_stm32030 s main c 3 B Outline 23 P j param None ERV o gt int main void TimingDelay volatile uint32 t Descri main at main c 51 0x80002F4 eneral Registers Generi 536870936 0 Wh retval None z N main h BlinkSpeed uint8_t lt At this stage the microcontroller clock setting is already config RCC Clocks RCC this is done through SystemInit function which is called from s main void int file startup_stm32f 3 s before to branch to application main sp To reconfigure the default setting of SystemInit function refe Delay volatile uint32 t void system stm32f xx c file x TimingDelay Decrement void void ClocksTypeDef le Console 4 Tasks Tak Problem Executab O Memory z E SWW Trace Log EJ SWW Console Memory 22 ju L assert failed uint8 t uint32_t void
12. els set breakpoints monitor individual variables and watch events during the code execution 4 Figure 12 MDK ARM debugger screen EB cast s2 Nace FW VL00 rectsWUCLED FE20REYO Toggle MDK ARMO Toggle read Ong wer eee File Edit View Project Flash Debug Peripherals Tools SVCS Window Help Nea s sa MR Bw ES MK GP Rese a tM oe o os eE 3 S O ar eo ORE 0a m 3 B x amp Registers g Disassembly Ba B Ox080006AA 0000 MOVS r0 ro 60 RCC GetClocksFreq amp RCC Clocks 0 020000 OXOBOOOGAE F7FFFE33 BL W RCC GetClocksFreq 0x08000318 BE 0 00000 61 SysTick Config RCC Clocks HCLK Frequency 1000 LA 0 ME 62 s agi lt Gl 000000 Ox08000 xFFFFF To reconfigure the default setting of SystemInit function refer to OxFFFFF 56 system_stm32f0xx c file R9 Ox FFF a K R10 OxFFFFF B8 59 SysTick end of count event each ims 60 RCC GetClocksFreq RCC Clocks R13 SP 61 SysTick Config RCC Clocks HCLK Frequency 1000 62 R15 PC 63 Initialize LED2 a Es 64 STM EVAL LEDInit LED2 Banked Es a E System 66 Initialize User Button on STM32NUCLEO 8 intemal 67 STM EVAL PBInit BUTTON USER BUTTON MODE EXTI Mode Thread Be Stack MSP 69 Initiate Blink Speed variable 70 BlinkSpeed 0 71 na J Project BE Registers gr m
13. he peripherals drivers e Example project includes toolchain projects for each peripheral example ready to be run Executing and debugging firmware using software toolchains EWARM toolchain The following procedure explains how to compile link and execute an existing EWARM project The steps below can be applied to an already existing example demonstration or template project available from STM32 Nucleo FW VX Y Z firmware at www st com web site First of all you need to go through the firmware readme txt file which contains the firmware description and hardware software requirements 3 DoclDO25840 Rev 1 UM1727 Firmware package 1 Open IAR Embedded Workbench for ARM EWARM Figure 4 shows the basic names of the windows referred to in this document Figure 4 IAR Embedded Workbench IDE Workspace window File window Build window eedr tana weng 0 2 Inthe File menu select Open and click Workspace to display the Open Workspace dialog box Browse to select either an example or demonstration or template workspace file and click Open to launch it in the Project window 3 Inthe Project menu select Rebuild All to compile your project 4 If your project is successfully compiled Figure 5 is displayed 3 DoclDO25840 Rev 1 9 20 Firmware package UM1727 Figure 5 EWARM project successfully compiled Linking Total number of errors 0 Total number of warn
14. ices described herein at any time without notice All ST products are sold pursuant to ST s terms and conditions of sale Purchasers are solely responsible for the choice selection and use of the ST products and services described herein and ST assumes no liability whatsoever relating to the choice selection or use of the ST products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein UNLESS OTHERWISE SET FORTH IN ST S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION OR INFRINGEMENT OF ANY PATENT COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT ST PRODUCTS ARE NOT DESIGNED OR AUTHORIZED FOR USE IN A SAFETY CRITICAL APPLICATIONS SUCH AS LIFE SUPPORTING ACTIVE IMPLANTED DEVICES OR SYSTEMS WITH PRODUCT FUNCTIONAL SAFETY REQUIREMENTS B
15. ings 0 Ready If you need to change the project settings Include and preprocessor defines go through the following project options For Include directories Project gt Options gt C C compiler For pre processor defines Project gt Options C C compiler gt pre processor gt 5 In IAR Embedded Workbench IDE from the Project menu select Download and Debug or alternatively click the Download and Debug button in the toolbar to program the Flash memory and start debugging Figure 6 Download and Debug button File Edit View Project Tools Window Help Dela Workspace boc E x Download and Debug 6 The debugger in IAR Embedded Workbench can be used to debug source code at C and assembly levels set breakpoints monitor individual variables and watch events during the code execution 3 10 20 DoclDO25840 Rev 1 UM1727 Firmware package Figure 7 IAR Embedded Workbench debugger screen File Edit View Project Debug Disassembly ST LINK Tools Window Help iD S Hga Belo 4y kA HAB U GIKIETEELSIR Workspace x x Disassembly 5 Go to ba 10 Toggle X uint8 t BlinkSpeed 0 Private function prototypes Files n BR Disassembly RCC ClocksTypeDef RCC Clocks t BIO Toggle v ANT IG AA AN Ox8000614 Oxf CJ EWARM DataTablel 4 Ha CI STM32_N O es Ox8000618
16. ld Output window 2 Inthe 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 Inthe Project menu select Rebuild All target files to compile your project 4 If your project is successfully compiled the following window is displayed Figure 10 MDK ARM project successfully compiled Build target IO Toggle linking Program Size Code 1616 RO data 232 RW data 32 ZI data 1064 NIO Toggle IO Toggle axf 0 Error s 0 Warning s If you need to change your project settings Include and preprocessor defines go through the project options For Include directories Project gt Options for Target gt C C gt Include Paths For pre processor defines Project gt Options for Target gt C C gt Preprocessor symbols gt Define 5 In MDK ARM IDE from the Debug menu select Start Stop Debug Session or alternatively click the Start Stop Debug Session button in the toolbar to program the Flash memory and start debugging 12 20 DoclD025840 Rev 1 ky UM1727 Firmware package Figure 11 Start Stop Debug Session button GA 4 sels CHS PRAM EH Mw cesas Ja 0 ala TES NG KAT Start Stop Debug Session Ctri F5 Project a TEE EE m gt UI Enter or leave a debug session E 6 The debugger in the MDK ARM can be used to debug source code at C and assembly lev
17. teps needed to install the driver from the recommended location Atollic TrueSTUDIO STM32 The toolchain is installed by default in the C Program Files Atollic directory on the PC s local hard disk The ST Link_V2_USB exe file is automatically installed when installing the software toolchain Complementary information on the firmware package content and the STM32 Nucleo requirements is available on the Getting started with STM32 Firmware The embedded ST LINK V2 only supports SWD interface for STM32 devices DoclDO25840 Rev 1 7 20 Firmware package UM1727 4 4 1 8 20 Firmware package The STM32 Nucleo firmware applications demonstration and IP examples are provided in one single package and supplied in one single zip file The extraction of the zip file generates one folder STM32 Nucleo FW VX Y Z which contains the following subfolders see Figure 3 Figure 3 Package contents 4 STM32 Nucleo FW VXYZ WY _htmresc WY Libraries al Projects 4 NUCLEO F030R8 PM Demonstration 4 B 10_Toggle di Binary Ji EWARM J MDK ARM Example project Ji TrueSTUDIO Ji IWDG Reset a PWR_CurrentConsumption 4 P Template J EWARM Ji MDK ARM Jo TrueSTUDIO Ji TIM PWMInput Ji NUCLEO F103RB Ji NUCLEO L152RE Jo Utilities Template project e Template project is a pre configured project with empty main function to be customized by the user This is helpful to start creating your own application based on t
18. uation edition 32 KB Limited QuickStart edition 16KB Limitation for Cortex MO MDK ARM v5 01 and later N2 MDK Lite 32KB Code size limitation TrueSTUDIO v5 and later 1 32 KB Limitation 8KB for Cortex MO 1 Registration before download is required 2 The device support pack is separate from MDK ARM releases 6 20 DoclDO25840 Rev 1 3 UM1727 ST LINK V2 installation 3 Note a ST LINK V2 installation STM32 Nucleo board includes an ST LINK V2 embedded debug tool interface The interface needs an ST Link V2 dedicated USB driver to be installed This driver is available at ST web site at www st com ST LINK V2 and supported within software toolchains IAR Embedded Workbench for ARM EWARM The toolchain is installed by default in the C Program FilesVAR Systems Embedded Workbench x x directory on the PC s local hard disk After installing EWARM install the ST LINK V2 driver by running the ST Link_V2_USB exe from IAR_INSTALL_DIRECTORY Embedded Workbench x x arm drivers ST Link ST Link_V2_USBdriver exe RealView Microcontroller Development Kit MDK ARM toolchain The toolchain is installed by default in the C Keil directory on the PC s local hard disk the installer creates a start menu uVisiond shortcut When connecting the ST LINK V2 tool the PC detects new hardware and requires to install the ST LINK_V2_USB driver The Found New Hardware wizard appears and guides you through the s
19. window Figure 17 TrueSTUDIO project successfully compiled fa Problems V2 Tasks El Console 23 Properties GF S GE BE Ex AE CDT Build Console IO Toggle STM32F xx_StdPeriph_Driver stm32f xx_dbgmcu o STM32F xx StdPeriph DriverVstm32f xx dac o STM32F xx_StdPeriph_Driver stm32f xx_crc o STM32F xx_StdPeriph_Driver stm32f xx_comp o STM32F xx StdPeriph DriverVstm32f xx cec o STM32F xx_StdPeriph_Driver stm32f xx_adc o o IO Toggle elf mthumb mcpu cortex m T NSTM32F 30R8 FLASH ld Wl start group lc lm Wl end group static WI cref u Reset Handler Wl Map IO Toggle map Wl gc sections Wl defsym malloc getpagesize P x1 C Program Files x86 Atollic TrueSTUDIO for ARM Pro 4 3 1 ide jre bin java jar C Program Files x86 Atollic TrueSTUDIO for ARM Pro 4 3 1 Tools arm atollic reports jar sizeinfo IO Toggle elf Generate build reports Print size information text data bss dec hex filename 2064 32 2090 2296 8f8 IO Toggle elf Print size information done Generate build reports done N 3 16 20 DoclDO25840 Rev 1 UM1727 Firmware package If you need to change the project settings Include directories and preprocessor defines go through Project Properties and select C C Build gt Settings from the left panel For Include directories C Compiler gt Directories gt Include path For pre processor defines C Compiler gt Symbols gt Defined symbols 9 To
Download Pdf Manuals
Related Search