ST Microelectronics UM0986 MDK-ARM Software User Guide

ST Microelectronics UM0986 MDK-ARM Software

Introduction

This document provides an introduction on how to use the MDK-ARMTM software development toolchain (version 4.11 and later) with the STM32VLDiscovery board.

It provides novice users of the MDK-ARM tool-chain with some guidelines to build and run the sample program provided with this document. This should provide them with the skills required to create and build their own applications. The DISCOVER project, referenced in this document, corresponds to the demo Flashed into the STM32VLDISCOVERY board during production. The project is available within the STM32VLDISCOVERY firmware package available at http://www.st.com/stm32vldiscovery. Although this application note cannot show all the topics relevant to the MDK-ARM tool, it demonstrates the first basic steps necessary to get started with the compiler/debugger.

About MDK-ARM toolchain

The MDK-ARM is a window-based software development platform that combines a robust and modern editor with a project manager and make facility tool. It integrates all the tools needed to develop embedded applications including C/C++ compiler, macro assembler, linker/locator, and an AXF file generator. MDK-ARM helps expedite the development process of embedded applications by providing the following:

• Full-featured source code editor.
• Device Database® for configuring the development tool.
• Project manager for creating and maintaining your projects.
• Integrated Make Utility for assembling, compiling, and linking your embedded applications.
• Dialogs for all development environment settings.
• True integrated source-level and assembler-level debugger with high-speed CPU and peripheral simulator.
• Advanced GDI interface for software debugging on target hardware and for connecting to a Keil™ ULINK™ Debug adapter.
• Flash programming utility for downloading the application program into Flash ROM.
• Links to manuals, on-line help, device datasheets, and user guides.

Note:

For generic descriptions, please refer to the Getting Started Guide of uVision4 available from Keil web site at the following link http://www.keil.com/product/brochures/uv4.pdf

Starting an existing MDK-ARM project

Installing the MDK-ARM toolchain (using the default settings) results in the toolchain being installed in C:\Keil on the PC’s local hard disk. The installer creates a start menu uVision4 shortcut.

1. 1. Open uVision4TM from the Start menu. Figure 1 shows the names of the windows referred to in this document.

2. Select Open Project… from the Project menu.

3. Using the Select Project File dialog box, browse and find the DISCOVER.uvproj

4. Double- click this file to launch it within the Project window.

5. Select R ebuild all target Files from the Project menu

6. Your project is successfully compiled.

7. Before running your application, you should establish the connection with the STM32VLDiscovery board as shown in Figure 7.
   Note: For more details on how to establish your hardware environment you can refer to the
   UM0919 User Manual: STM32VLDiscovery available at www.st.com/stm32-discovery.

8. Select Download from the Flash menu

9. Your project is successfully programmed and verified.

10. Click the magnifying glass to program the Flash and begin debugging.

11. The debugger interface supplied by MDK-ARM allows for source code debugging at C and assembly levels, breakpoint setting, individual variables monitoring and watching during the code execution.If everything is working correctly, LED3 should be blinking. Every time the user button is pressed, the LED3 blinking frequency changes and LED4 turns on.

Creating your first application

Source file management

1. Select New μvision Project from the Project menu.
2. Name the project ‘Empty.uvproj’, click on Save.
3. The device window will be displayed. Select the part you will be testing with (the STMicroelectronics part mounted on the STM32VLDiscovery board).
   • Double-click on the STMicroelectronics.
   • Scroll down and select the STM32F100RB Part.
   • Click OK.
4. The “Copy STM32 Startup Code” message is prompted. Select Yes.
5. You may create a new source file with the menu File – New. This opens an empty editor window where you can enter your source code. μVision4 enables the C color syntax highlighting when you save your file with the dialog File – Save As… under a filename with the extension *.c . We save our example file under the name main.c.
6. Once you have created your source file you can add this file to your project. MDK-ARM offers several ways to add source files to a project. For example, you can select the file group in the Project Window – Files page and click with the right mouse key to open a local menu. The option Add Files opens the standard files dialog. Select the file main.c you have just created.
7. Your main source file is successfully added to your project.

Project options configuration

1. Click on Target 1 in Project menu.
2. Click on Project menu and select Options for Target 1.
3. Select Target tab. The IROM1 and IARM1 start and size are automatically set according to the chosen device, just verify the settings and correct them if necessary.
4. If your source files include header files, you should specify their paths in the project settings as shown in Figure 21.
5. Select Debug tab.
   • Click on Use check box.
   • Choose ST-Link Debugger
6. Click on Settings button.
   • Choose the SWD as connection protocol in the STLink setup window.
   • Click on OK button.
   • Click on Run to main() check box
7. Select Utilities tab.
   • Click on Use Target Driver for Flash Programming.
   • Choose ST-Link Debugger.
   • Veify that Update Target befor Debugging option is checked.
   • Click OK to save your settings
8. Click on Project menu and select Build target.
9. In the Build window it should report ‘0 Errors (s), 0 Warnings’.
10. Before running your application, you should establish the connection with the STM32VLDiscovery board as shown in Figure 7.
11. Click the magnifying glass to program the Flash and begin debugging.
12. Now you can start debugging your application.

Revision history

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. 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.
UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED ST REPRESENTATIVE, ST PRODUCTS ARE NOT RECOMMENDED, AUTHORIZED OR WARRANTED FOR USE IN MILITARY, AIR CRAFT, SPACE, LIFE SAVING, OR LIFE SUSTAINING APPLICATIONS, NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY, DEATH, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE. ST PRODUCTS WHICH ARE NOT SPECIFIED AS “AUTOMOTIVE GRADE” MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER’S OWN RISK.

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. © 2010 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 – Sweden – Switzerland – United Kingdom – United States of America www.st.com

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>