Visual Circuits H-DVP Manual do Utilizador

April 2010 Doc ID 7705 Rev 11 1/385UM0036User ManualST Visual Develop(STVD)IntroductionWelcome to ST Visual Develop (STVD). STVD is a powerful, integr

List of tables UM003610/385 Doc ID 7705 Rev 11List of tablesTable 1. Debugging configurations and supported hardware . . . . . . . . . . . . . . . . .

Project creation and build UM0036100/385 Doc ID 7705 Rev 11Figure 65. Cosmic C debug information viewIn this tab view, you can choose from the optimiz

UM0036 Project creation and buildDoc ID 7705 Rev 11 101/385Customizing Cosmic C compiler optimizationsTo further customize optimizations, select Custo

Project creation and build UM0036102/385 Doc ID 7705 Rev 11Minimum number of bytes for activation of factorizationThis field allows you to enter an in

UM0036 Project creation and buildDoc ID 7705 Rev 11 103/385Figure 67. Cosmic C language viewIn this tab view, you can choose from the C language optio

Project creation and build UM0036104/385 Doc ID 7705 Rev 11Customizing Cosmic C compiler listings To customize compiler listings, select Customize in

UM0036 Project creation and buildDoc ID 7705 Rev 11 105/385Customizing Cosmic C compiler preprocessor definitionsWhen the Category list box is set to

Project creation and build UM0036106/385 Doc ID 7705 Rev 11Figure 70. Cosmic C compiler input viewThe input options are:● Treat Source files as C file

UM0036 Project creation and buildDoc ID 7705 Rev 11 107/385 4.7.2 Cosmic C Assembler tabThe Assembler tab (see Figure 72) provides an interfa

Project creation and build UM0036108/385 Doc ID 7705 Rev 11The Category list box allows you to access a general view for easy access to standard setti

UM0036 Project creation and buildDoc ID 7705 Rev 11 109/385 Customizing Cosmic Assembler language settingsThe assembler language settings allo

UM0036 List of tablesDoc ID 7705 Rev 11 11/385Table 52. Metrowerks C compiler language options. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Project creation and build UM0036110/385 Doc ID 7705 Rev 11 4.7.3 Cosmic C linker tabThe Linker tab provides an interface for setting the opt

UM0036 Project creation and buildDoc ID 7705 Rev 11 111/385General settings for Cosmic linkerWith the category set to General, you can access the foll

Project creation and build UM0036112/385 Doc ID 7705 Rev 11The Startup File list box allows you to choose to use one of the provided startup files. Th

UM0036 Project creation and buildDoc ID 7705 Rev 11 113/385<BEGIN OBJECT_FILES>, <END OBJECT_FILES><BEGIN LIBRARY_FILES>, <END LI

Project creation and build UM0036114/385 Doc ID 7705 Rev 11● Protect - Protects the selected code section from optimization. Adds the -k option to the

UM0036 Project creation and buildDoc ID 7705 Rev 11 115/385Figure 76. Cosmic linker output viewIn this view, the options listed in Ta ble 41 are avail

Project creation and build UM0036116/385 Doc ID 7705 Rev 114.8 Customizing build settings for Raisonance C toolsetThe Project Settings window for bui

UM0036 Project creation and buildDoc ID 7705 Rev 11 117/385Figure 77. Standard optionsTo further customize options, select a category in the Category

Project creation and build UM0036118/385 Doc ID 7705 Rev 114.8.1 Raisonance C compiler tabThe C Compiler tab provides an interface for setting the op

UM0036 Project creation and buildDoc ID 7705 Rev 11 119/385General settings for the Raisonance toolsetWith the category set to General, you can access

List of figures UM003612/385 Doc ID 7705 Rev 11List of figuresFigure 1. New Workspace window. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Project creation and build UM0036120/385 Doc ID 7705 Rev 11When the category is set to General, the standard optimization options are:● Default optimi

UM0036 Project creation and buildDoc ID 7705 Rev 11 121/385Customizing Raisonance C compiler optimizationsOn the C Compiler tab of the Project Setting

Project creation and build UM0036122/385 Doc ID 7705 Rev 11 As you select each option, you can see the changes in the command line in the Comm

UM0036 Project creation and buildDoc ID 7705 Rev 11 123/385In the C Language field, you can choose:● Default: compiler default language options● Ansi

Project creation and build UM0036124/385 Doc ID 7705 Rev 11From the Listings field, you can choose:● None: all options are grayed out.● Default listin

UM0036 Project creation and buildDoc ID 7705 Rev 11 125/385Adding preprocessor definitionsWhen entering a preprocessor definition, you must specify th

Project creation and build UM0036126/385 Doc ID 7705 Rev 11The category list box gives you access to the following views:● General, see General settin

UM0036 Project creation and buildDoc ID 7705 Rev 11 127/3854.8.3 Raisonance C linker tabThe Linker tab of the Project Settings window provides an int

Project creation and build UM0036128/385 Doc ID 7705 Rev 11General settings for Raisonance linkerWhen the category is set to General, you can access t

UM0036 Project creation and buildDoc ID 7705 Rev 11 129/385Customizing Raisonance linker input settingsOn the Linker tab of the Project Settings windo

UM0036 List of figuresDoc ID 7705 Rev 11 13/385Figure 49. Adding custom commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Project creation and build UM0036130/385 Doc ID 7705 Rev 11Figure 87. Raisonance linker output viewThe following options are available in this view:●

UM0036 Project creation and buildDoc ID 7705 Rev 11 131/3854.9 Customizing build settings for Metrowerks C toolsetThe Project Settings window for bui

Project creation and build UM0036132/385 Doc ID 7705 Rev 11Using the Project Settings interfaceThe tabs (C Compiler, Assembler and Linker) have a comm

UM0036 Project creation and buildDoc ID 7705 Rev 11 133/385Figure 89. Customizing options4.9.1 Metrowerks C Compiler tabThe C Compiler tab provides a

Project creation and build UM0036134/385 Doc ID 7705 Rev 11The Category list box provides a choice of standard options to choose from. For description

UM0036 Project creation and buildDoc ID 7705 Rev 11 135/385Message DisplayWith the Category list box set to General, you can choose what types of mess

Project creation and build UM0036136/385 Doc ID 7705 Rev 11When the Category list box is set to General, the standard listing options are: ● C and Ass

UM0036 Project creation and buildDoc ID 7705 Rev 11 137/385User-defined options This field allows you to enter the command for an option that you have

Project creation and build UM0036138/385 Doc ID 7705 Rev 11Customizing Metrowerks C compiler inputThe compiler input settings allow you to specify the

UM0036 Project creation and buildDoc ID 7705 Rev 11 139/385Figure 92. Metrowerks C compiler input viewIn this view, you can choose from the optimizati

List of figures UM003614/385 Doc ID 7705 Rev 11Figure 101. Customizing Metrowerks linker output view . . . . . . . . . . . . . . . . . . . . . . . . .

Project creation and build UM0036140/385 Doc ID 7705 Rev 11Extra include filesThis field allows you to enter multiple files to include when compiling

UM0036 Project creation and buildDoc ID 7705 Rev 11 141/385 In addition, this view includes an Encryption field that allows you to enable and

Project creation and build UM0036142/385 Doc ID 7705 Rev 11Figure 94. Metrowerks C compiler listing viewIn this view, you choose from the listing opti

UM0036 Project creation and buildDoc ID 7705 Rev 11 143/385Customizing Metrowerks C compiler language settingsIn the C Compiler tab, select C Language

Project creation and build UM0036144/385 Doc ID 7705 Rev 11Figure 96. Metrowerks Assembler general viewThe Category list box allows you to access a ge

UM0036 Project creation and buildDoc ID 7705 Rev 11 145/385Message displayWith the category set to General, you can choose what types of messages the

Project creation and build UM0036146/385 Doc ID 7705 Rev 11You can type the path name. When you begin typing, the -I for this compiler option is autom

UM0036 Project creation and buildDoc ID 7705 Rev 11 147/385 Customizing Metrowerks Assembler listingsIf you choose Customize in the Listings l

Project creation and build UM0036148/385 Doc ID 7705 Rev 114.9.3 Metrowerks linker tabThe Linker tab provides an interface for customizing the comman

UM0036 Project creation and buildDoc ID 7705 Rev 11 149/385Output filename optionsAllows you to specify the name for the output file. It appears in th

UM0036 List of figuresDoc ID 7705 Rev 11 15/385Figure 153. Define a periodic signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Project creation and build UM0036150/385 Doc ID 7705 Rev 11“Do not use environment” option (-NoEnv)This checkbox enables and disables the no environme

UM0036 Project creation and buildDoc ID 7705 Rev 11 151/385Customizing Metrowerks linker optimization settingsTo further customize optimizations, sele

Project creation and build UM0036152/385 Doc ID 7705 Rev 11Customizing Metrowerks linker output settingsTo further customize the linker output, select

UM0036 Project creation and buildDoc ID 7705 Rev 11 153/385 Configuring the Metrowerks linker PRM fileThe Linker PRM file tab provides an inte

Project creation and build UM0036154/385 Doc ID 7705 Rev 11Note: If you specified to output in Hiware format in the Compiler or Assembler tabs, you mu

UM0036 Project creation and buildDoc ID 7705 Rev 11 155/385You can also modify the memory type for any segment. Right-click on the Type cell for any s

Project creation and build UM0036156/385 Doc ID 7705 Rev 114.10 Configuring folder and file settingsSTVD’s folder and file settings allow you to confi

UM0036 Project creation and buildDoc ID 7705 Rev 11 157/385When settings are available you can configure the following:● Always use custom build step:

Project creation and build UM0036158/385 Doc ID 7705 Rev 114.11 Specifying dependencies between projectsBecause a project may use an element or object

UM0036 Project creation and buildDoc ID 7705 Rev 11 159/385 Once you have built your application for the selected microcontroller you are read

List of figures UM003616/385 Doc ID 7705 Rev 11Figure 205. Code coverage and profiling analysis: functions/instructions view . . . . . . . . . . . . .

Basic debugging features UM0036160/385 Doc ID 7705 Rev 115 Basic debugging featuresOnce you have built your application for debugging, you can choose

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 161/3855.1 Selecting the debug instrumentYour choice of target microcontroller and debugging hardwa

Basic debugging features UM0036162/385 Doc ID 7705 Rev 113. If the selected debug instrument is SWIM RLink or SWIM STice, then you can optionally ena

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 163/385Figure 104. Add an Ethernet connectionFor USB connections, either:● Enter the number for the

Basic debugging features UM0036164/385 Doc ID 7705 Rev 11This returns you to the Debug Instrument Settings window. The new connection option has been

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 165/385For most target MCUs, you may modify the following types of memory zone: RAM, ROM, Reserved a

Basic debugging features UM0036166/385 Doc ID 7705 Rev 11Figure 107. Specifying a new memory zone5.2.2 On-chip peripheralsThe Options tab of the MCU C

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 167/3855.3 Running an applicationAn application loaded into the STVD may be run using the commands

Basic debugging features UM0036168/385 Doc ID 7705 Rev 11The commands Go To PC, Run to Cursor and Set PC are also available in the Editor contextual m

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 169/3855.3.3 Program and STVD status bar displayFigure 109. Debugger status on status bar● The left

UM0036 List of figuresDoc ID 7705 Rev 11 17/385Figure 257. Emulator update window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Basic debugging features UM0036170/385 Doc ID 7705 Rev 11For debugging, the Editor's active window may contain either a C-language or an Assembly

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 171/385Watch pop-upWhen a variable is selected in the active Editor window (the mouse pointer paused

Basic debugging features UM0036172/385 Doc ID 7705 Rev 115.4.1 Editor debug marginThe left margin of an Editor window is a special area for placing de

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 173/385Note: A breakpoint and a bookmark may be placed together at the same position.● Breakpoint ic

Basic debugging features UM0036174/385 Doc ID 7705 Rev 11Figure 113. Call Stack frame indicatorThis highlighted line is the source for the instruction

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 175/385Figure 114. QuickWatch windowQuickWatch functions are:● Recalculate: Recalculates the value o

Basic debugging features UM0036176/385 Doc ID 7705 Rev 11Figure 116. PC in editor windowThe Disassembly window provides a disassembly of the selected

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 177/385Figure 117. Program halted at breakpointNote: The information appearing in the Disassembly wi

Basic debugging features UM0036178/385 Doc ID 7705 Rev 11This simply means that the PC is placed in the middle of an instruction, rather than at the b

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 179/3851. Select the address (so that it is highlighted in blue) at which you want to begin your ass

Introduction UM003618/385 Doc ID 7705 Rev 111 IntroductionThis chapter summarizes the features that are detailed later in this manual.1.1 Building an

Basic debugging features UM0036180/385 Doc ID 7705 Rev 114. Click Assemble. The disassembly window will be refreshed as the new instruction is loaded

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 181/385The search and edit options Find, Find Next and Replace may be used in the Memory window, to

Basic debugging features UM0036182/385 Doc ID 7705 Rev 11Figure 126. Fill Memory dialog boxNote: Memory may also be modified directly by typing over t

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 183/385To restore a previously saved memory layout:a) Select File>Restore layout from the context

Basic debugging features UM0036184/385 Doc ID 7705 Rev 115.8.2 Viewing the instruction breakpointsTo open the Instruction Breakpoints window, either c

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 185/385If a breakpoint is set at the beginning of function f, such that:● The breakpoint condition i

Basic debugging features UM0036186/385 Doc ID 7705 Rev 115.9 Data breakpointsNote: Data breakpoints are not available on the STVD EMU3 version. Howeve

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 187/385Figure 131. Inserting write data breakpointNote: Only read data breakpoints can be inserted t

Basic debugging features UM0036188/385 Doc ID 7705 Rev 11Figure 132. Data breakpoints window (EMU2)Figure 133. Data breakpoints window (DVP and Simula

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 189/385Figure 134. Call stack window and interaction with other debug windowsNow, if you want to ste

UM0036 IntroductionDoc ID 7705 Rev 11 19/3851.2 Programming your microcontrollerWhen you are ready to program your application to your microcontroller

Basic debugging features UM0036190/385 Doc ID 7705 Rev 11Figure 135. Stepping backwards in call stack5.11 Local variables windowThe Local Variables w

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 191/3855.12 Watch windowIn addition to the Watch window description, this section provides informati

Basic debugging features UM0036192/385 Doc ID 7705 Rev 11Modifying valuesVariable values can be modified directly in the Watch window. Double-click in

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 193/385Interrupts (IT), and for the Simulator version only, the Simulator Time registers and the Sim

Basic debugging features UM0036194/385 Doc ID 7705 Rev 115.14 MSCI tools windowWhen developing applications that use the ST7 Mass Storage Communicati

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 195/385MSCI registers tabThe MSCI Registers tab displays the MSCI internal registers memeory and the

Basic debugging features UM0036196/385 Doc ID 7705 Rev 11In the resulting listing, there are three fields: File, which is the filename in which the sy

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 197/385This allows you to check the value of the peripheral registers at any breakpoint in the debug

Basic debugging features UM0036198/385 Doc ID 7705 Rev 11Peripheral registers display optionsUsing the display options in the contextual menu, you can

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 199/3855.18 Online commandsAn online command is a single line of input that you can use to control t

Contents UM00362/385 Doc ID 7705 Rev 11Contents1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Introduction UM003620/385 Doc ID 7705 Rev 11ST7-DVP series emulator– Output signals triggered by advanced breakpoints– Trace recording and trace filte

Basic debugging features UM0036200/385 Doc ID 7705 Rev 115.18.4 The symbol-file commandsymbol-file filename [-readnow ] [ -mapped ]You can override th

UM0036 Basic debugging featuresDoc ID 7705 Rev 11 201/385Limitations are documented in the current STVD Release Notes. When possible, workaround proce

Simulator features UM0036202/385 Doc ID 7705 Rev 116 Simulator featuresIn addition to debugging with emulation hardware and in-circuit debugging devic

UM0036 Simulator featuresDoc ID 7705 Rev 11 203/3854. To view/change the configuration settings, click on the Conf... button.The configuration setup

Simulator features UM0036204/385 Doc ID 7705 Rev 11signal while your application is not running, the signal is taken into account, or the countdown fo

UM0036 Simulator featuresDoc ID 7705 Rev 11 205/385Trigger a periodic binary signal with or without a time delay1. Select View>I/O Stimulation from

Simulator features UM0036206/385 Doc ID 7705 Rev 11Trigger a binary signal on-the-fly1. Select View>I/O Stimulation from the main menu bar.The I/O

UM0036 Simulator featuresDoc ID 7705 Rev 11 207/385 In the same stimuli file you can script inputs for multiple pins and different types of in

Simulator features UM0036208/385 Doc ID 7705 Rev 11format. Exported items can be quickly and easily imported into later simulations, facilitating comp

UM0036 Simulator featuresDoc ID 7705 Rev 11 209/3851. Click on an item to select it. 2. Click on Add Item, or double-click on the item that you want t

UM0036 IntroductionDoc ID 7705 Rev 11 21/3851.4 Getting assistanceFor more information, application notes, FAQs and software updates on all the ST mic

Simulator features UM0036210/385 Doc ID 7705 Rev 11Figure 156. View plotted elementsThe following sections explain in greater detail how to use the pl

UM0036 Simulator featuresDoc ID 7705 Rev 11 211/385 In the display area, value changes for selected items are displayed as:● Bus – a bar conta

Simulator features UM0036212/385 Doc ID 7705 Rev 11cannot be sorted or moved. They remain in their initial order with the first level item that contai

UM0036 Simulator featuresDoc ID 7705 Rev 11 213/385Figure 157. No information to plotYou can also right-click in the row for an item to get the contex

Simulator features UM0036214/385 Doc ID 7705 Rev 11Scroll features include a scroll bar with integrated scaling control, precision scrolling and fast

UM0036 Simulator featuresDoc ID 7705 Rev 11 215/385The Previous / Next Change buttons allow you to navigate from one value change to another for the s

Simulator features UM0036216/385 Doc ID 7705 Rev 11 Table 68. Plotter tab management commandsCommand DescriptionIn the Project MenuAdd New Tab

UM0036 Simulator featuresDoc ID 7705 Rev 11 217/385Modifying item display characteristicsTo improve the readability of your plot, you can modify the d

Simulator features UM0036218/385 Doc ID 7705 Rev 11the simulation (time=0). Entering a value a value greater than zero shifts the start point to the r

UM0036 Simulator featuresDoc ID 7705 Rev 11 219/3852. Select the items you want to export. To select all the items in a display tab, place a checkmar

Introduction UM003622/385 Doc ID 7705 Rev 111.6 ConventionsThe following conventions are used in the documentation:● Bold text highlights key terms an

Simulator features UM0036220/385 Doc ID 7705 Rev 11Figure 160. Select items for printing2. Select the items that you want to print. To select all the

UM0036 Simulator featuresDoc ID 7705 Rev 11 221/385Figure 161. Memory and Watch windows with Read/Write on the flyNote that when you scroll in the Mem

Simulator features UM0036222/385 Doc ID 7705 Rev 11Create and load a stimuli file on page 206 to trigger a signal on an interrupt request pseudo pin.T

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 223/3857 In-circuit debuggingIn-circuit debugging (ICD) allows you to debug an application in its final

In-circuit debugging UM0036224/385 Doc ID 7705 Rev 11When you enter a debugging session, the SWIM entry sequence activates the communication channel o

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 225/385For more information about setting up this hardware connection for STice, refer to the STice adva

In-circuit debugging UM0036226/385 Doc ID 7705 Rev 11STVD attempts to connect to the microcontroller on your application board. If the connection fail

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 227/385 Caution: For XFlash devices, if write protection is enabled, the XFlash memory behaves l

In-circuit debugging UM0036228/385 Doc ID 7705 Rev 11Figure 163. Setting the option byte valuesNote: After changing an option byte setting that is not

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 229/385Note: ST7 MCUs with XFlash memory do not allow software breakpoints in memory sector 0. This sect

UM0036 Getting started with STVDDoc ID 7705 Rev 11 23/3852 Getting started with STVDOnce you have installed and launched ST Visual Develop (STVD), th

In-circuit debugging UM0036230/385 Doc ID 7705 Rev 117.2.3 Setting advanced breakpointsDepending on your target microcontroller and its debug modules,

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 231/385Figure 165. Disable instruction breakpoints promptDisable instruction breakpoints by clicking on

In-circuit debugging UM0036232/385 Doc ID 7705 Rev 117.2.4 Advanced breakpoint optionsIn each debug module tab, you can program the following breakpoi

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 233/385occurrence of a data access at a specified address. (The addresses specified for each instance ca

In-circuit debugging UM0036234/385 Doc ID 7705 Rev 111. Power up the STice box/RLink/STLink, depending on the hardware that you are using.2. Connect

UM0036 In-circuit debuggingDoc ID 7705 Rev 11 235/385TRAP instruction limitation (ICC only)The TRAP interrupt vector is reserved for the ICC monitor d

In-circuit debugging UM0036236/385 Doc ID 7705 Rev 11SWIM debugger limitationWhile the microcontroller is executing either a "Halt", "W

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 237/3858 DVP and EMU2 (HDS2) emulator featuresThis section explains how to use the fea

DVP and EMU2 (HDS2) emulator features UM0036238/385 Doc ID 7705 Rev 11The EMU2 Emulator version and the DVP versions are slightly different in the way

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 239/385From this contextual menu, you can:● Refresh: Updates the window.● New Hardware

Getting started with STVD UM003624/385 Doc ID 7705 Rev 11Note: Workspace files for previous versions of STVD (.wsp) can be opened in STVD 3.0 and late

DVP and EMU2 (HDS2) emulator features UM0036240/385 Doc ID 7705 Rev 11Figure 169. Hardware event settings window for DVP2If you are using a Developmen

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 241/385Figure 171. Hardware events window (DVP2 emulators)– Right-click the mouse. The

DVP and EMU2 (HDS2) emulator features UM0036242/385 Doc ID 7705 Rev 11To set a hardware event on a line of code1. Open the Hardware Events window.2.

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 243/385Figure 174. Trace contextual menuShow/hide columnsColumns may be disabled if the

DVP and EMU2 (HDS2) emulator features UM0036244/385 Doc ID 7705 Rev 11Move columnsColumns may be also shifted right or left for convenience of use. Pi

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 245/385Figure 178. Save Trace Contents dialog box8.3.2 Viewing trace contentsThe Trace

DVP and EMU2 (HDS2) emulator features UM0036246/385 Doc ID 7705 Rev 11Figure 179 and Figure 180 show all of the trace columns for each STVD version. Y

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 247/385Figure 181. Hardware Test dialog box (DVP version)The Hardware Test dialog box s

DVP and EMU2 (HDS2) emulator features UM0036248/385 Doc ID 7705 Rev 118.5 Logical analyser (EMU2 emulators only)You can access the Logical Analyser w

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 249/385If the condition you define with the Logical Analyser consists of a single event

UM0036 Getting started with STVDDoc ID 7705 Rev 11 25/3852.2.2 Create a project in your workspaceFigure 2. New project windowIn the New Project windo

DVP and EMU2 (HDS2) emulator features UM0036250/385 Doc ID 7705 Rev 11set to 0 or 1 except in the case of the Read/Write signal, where for clarity&apo

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 251/385Figure 186. Event 1 as programmed8.5.2 Advanced breaks using the logical analys

DVP and EMU2 (HDS2) emulator features UM0036252/385 Doc ID 7705 Rev 11Figure 187. Defining an advanced breakpointYou can continue to apply break condi

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 253/385previous event condition recordings are completed (for example, Event 2 conditio

DVP and EMU2 (HDS2) emulator features UM0036254/385 Doc ID 7705 Rev 11Figure 190. Trace filtering event schematics8.6 Stack control window (DVP emula

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 255/385Figure 192. Configuration setup window5. Click on OK when you have set up the St

DVP and EMU2 (HDS2) emulator features UM0036256/385 Doc ID 7705 Rev 11an external measurement instrument, such as an oscilloscope. When a user-defined

UM0036 DVP and EMU2 (HDS2) emulator featuresDoc ID 7705 Rev 11 257/385Figure 194. DVP1 trigger settingsWorking with trace filtering (DVP2 and DVP3 onl

STice features UM0036258/385 Doc ID 7705 Rev 119 STice featuresThe STice advanced emulation tool used in conjunction with STVD supports all of the fea

UM0036 STice featuresDoc ID 7705 Rev 11 259/385Figure 196. STice trace windowFigure 196 shows most of the trace columns. You can preselect which of th

Getting started with STVD UM003626/385 Doc ID 7705 Rev 11Figure 3. MCU selection dialog boxNote: If necessary, you can change the MCU selection later

STice features UM0036260/385 Doc ID 7705 Rev 11window (all others are hidden). The record number and timestamp are not recalculated when lines are rem

UM0036 STice featuresDoc ID 7705 Rev 11 261/385wide. As a result, the read value may be 1, 2 or 3-bytes long. These data bytes are constants or part o

STice features UM0036262/385 Doc ID 7705 Rev 11events when a Discontinuity message occurs between them. However, the relative time elapsed between two

UM0036 STice featuresDoc ID 7705 Rev 11 263/385Figure 198. Trace Display Filter dialog box● Filter lines: Trace records can be filtered using the Trac

STice features UM0036264/385 Doc ID 7705 Rev 11● Goto Source, Goto Disassembly: You may use these commands in the contextual menu to jump to either an

UM0036 STice featuresDoc ID 7705 Rev 11 265/385select Column Display in the Trace contextual menu. This opens a list of all the columns available in t

STice features UM0036266/385 Doc ID 7705 Rev 11window (via the BEM)—but doing so disables the Trace On/Off command in the Trace Contextual menu. 9.2

UM0036 STice featuresDoc ID 7705 Rev 11 267/385There are three counter sizes:● Small 15-bit occurrence counters with a maximum value of 32767● Large 3

STice features UM0036268/385 Doc ID 7705 Rev 11Figure 202. Data coverage and occurrence profiling settings windowFigure 203. Code coverage and profili

UM0036 STice featuresDoc ID 7705 Rev 11 269/3853. If you have selected Code coverage and profiling in the Time Profiling section, select the Time rec

UM0036 Getting started with STVDDoc ID 7705 Rev 11 27/385 2.3 Add source files (.asm, .c, .s) to your projectSource files (.asm, .c, .s) cont

STice features UM0036270/385 Doc ID 7705 Rev 11Figure 204. Code coverage and profiling settings windowYou can select the frequency of the profiler tim

UM0036 STice featuresDoc ID 7705 Rev 11 271/385have chosen two small counters to record read and write operations separately, the maximum value may be

STice features UM0036272/385 Doc ID 7705 Rev 111. In the main window, from the Debug Instrument menu, select Profiling Session Start.2. Start executi

UM0036 STice featuresDoc ID 7705 Rev 11 273/385● Contextual percentageIndicates the time spent executing code in the function as a percentage of the t

STice features UM0036274/385 Doc ID 7705 Rev 11It is possible to sort the columns according to alphabetical order for Function, Interrupt and Source f

UM0036 STice featuresDoc ID 7705 Rev 11 275/385● Read (Yes/No)Indicates whether the variable was read or not.● Write (Yes/No)Indicates whether the var

STice features UM0036276/385 Doc ID 7705 Rev 11Figure 208. Data coverage and profiling analysis: source viewThe green spot in the margin identifies th

UM0036 STice featuresDoc ID 7705 Rev 11 277/385Caution: Code that is not executed because it is not properly covered in the validation test plan can b

STice features UM0036278/385 Doc ID 7705 Rev 11Figure 210. Source view of test suiteFigure 211. Coverage and Profiling Analysis of test suite after a

UM0036 STice featuresDoc ID 7705 Rev 11 279/385Detecting dead codeWhen you run a coverage and profiling session, the areas of code that are not execut

Getting started with STVD UM003628/385 Doc ID 7705 Rev 11Figure 6. Workspace windowCaution: When building with ST Assembler Linker, your application s

STice features UM0036280/385 Doc ID 7705 Rev 11Optimizing variablesUnused variables: The results of a coverage and profiling session can help you exam

UM0036 STice featuresDoc ID 7705 Rev 11 281/3854. Expand each code block in turn.Expand successively the most time-consuming functions and instructio

STice features UM0036282/385 Doc ID 7705 Rev 11Figure 216. Bottleneck detection: bottom levelstatic unsigned int result=0;unsigned int Speed = 100;uns

UM0036 STice featuresDoc ID 7705 Rev 11 283/385Assessing the performance of time-critical codeTime-critical sections of code are those that are execut

EMU3 emulator features UM0036284/385 Doc ID 7705 Rev 1110 EMU3 emulator featuresThis section explains how to use the features that are specific to th

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 285/385Figure 217. EMU3 trace windowFigure 217 shows most of the trace columns. You can preselect whic

EMU3 emulator features UM0036286/385 Doc ID 7705 Rev 11The event column serves chiefly to allow you to filter out the hardware cycles of interest usin

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 287/385Figure 218. Trace contextual menuFilter linesTrace records can be filtered using the Trace Disp

EMU3 emulator features UM0036288/385 Doc ID 7705 Rev 11Figure 219. Trace Display Filter dialog box● Display Source Lines: This option includes the sou

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 289/385Previous Code Fetch, Next Code Fetch commandsIf you highlight a trace record of an opcode fetch

UM0036 Getting started with STVDDoc ID 7705 Rev 11 29/385Figure 7. Project configurations window3. To view the project settings that have been applie

EMU3 emulator features UM0036290/385 Doc ID 7705 Rev 11Figure 221. Show/hide columnsColumns may also be shifted right or left for convenience of use.

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 291/385Figure 223. Setting timestamp clockThe timestamp clock frequency determines the granularity of

EMU3 emulator features UM0036292/385 Doc ID 7705 Rev 11Actions that may be performed upon the occurrence of the defined event or sequence of events ca

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 293/385Each level can incorporate up to four events. The level defines the relationship between these

EMU3 emulator features UM0036294/385 Doc ID 7705 Rev 11When you click on the IF button in the Programmable Level portion of the window, as shown in Fi

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 295/385Figure 226. Defining Level 1, Event 1An event may incorporate any of the following:–A Memory Ev

EMU3 emulator features UM0036296/385 Doc ID 7705 Rev 11Figure 227. Then window9. Continue defining the level using the remaining Else If and Then com

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 297/385Figure 228. Memory eventsAn event may be defined as one of the following types of memory access

EMU3 emulator features UM0036298/385 Doc ID 7705 Rev 11Figure 230. Memory Access with Data dialog boxThe dialog box at right is the same as for the Me

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 299/385Figure 231. Opcode Fetch dialog box● Opcode Fetch with Data: An opcode fetch of a specified val

UM0036 ContentsDoc ID 7705 Rev 11 3/3853.6.2 Find in Files 1 & Find in Files 2 tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.6.3

Getting started with STVD UM003630/385 Doc ID 7705 Rev 112.5 Select and connect to your debug instrumentSTVD allows you to debug your application usi

EMU3 emulator features UM0036300/385 Doc ID 7705 Rev 11Figure 232. Opcode Fetch with Data dialog boxNote: When Any Memory Access or Opcode Fetch is se

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 301/385that shows how to specify a value with selected bits masked, is given in Section 10.5.1 on page

EMU3 emulator features UM0036302/385 Doc ID 7705 Rev 11Figure 235. Advanced breakpoints configuration summary10.2.7 Synoptic representation of advance

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 303/385Programmed and unused levels are differentiated by color coding. The currently active Level is

EMU3 emulator features UM0036304/385 Doc ID 7705 Rev 11Figure 238. Configuration disabled10.2.8 Saving and loading advanced breakpointsYou can store

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 305/3851. From the main menu, select Debug Instrument > Advanced Breakpoints.2. In the Advanced Bre

EMU3 emulator features UM0036306/385 Doc ID 7705 Rev 11Figure 241. Programming Then6. Check the Enable Configuration box at the top left corner of the

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 307/385 Example 2—Break on memory access with data maskingThis example is an elaboration of th

EMU3 emulator features UM0036308/385 Doc ID 7705 Rev 11Figure 243. Programming memory access with data4. In the Level 1 tab, click Then and set the de

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 309/385 The Configuration Summary of the Advanced Breakpoints window should appear as shown in

UM0036 Getting started with STVDDoc ID 7705 Rev 11 31/385Figure 10. Debug instrument target port selectionThe SWIM debugger has two additional paramet

EMU3 emulator features UM0036310/385 Doc ID 7705 Rev 11Example 1—Trace ON inside a functionThis example shows you how to program the Advanced Breakpoi

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 311/3851. Open the Advanced Breakpoints window.2. Configure your Advanced Breakpoints window as summar

EMU3 emulator features UM0036312/385 Doc ID 7705 Rev 11Example 5—Measuring long time periods between eventsThe trace recording includes a Timestamp fi

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 313/3851. Open the Trace window.2. Right-click the mouse in the Trace window and select Show/Hide Col

EMU3 emulator features UM0036314/385 Doc ID 7705 Rev 11Figure 247. Output trigger action modes10.4.1 Trigger programming examplesThe following exampl

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 315/385 The Advanced Breakpoints window should appear as shown in Figure 248.Figure 248. Progr

EMU3 emulator features UM0036316/385 Doc ID 7705 Rev 11Figure 249. Programming level 1Example 3: Setting the trigger output high or lowIn the previous

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 317/385 Yo u r Advanced Breakpoints window should appear as shown in Figure 250.Figure 250.

EMU3 emulator features UM0036318/385 Doc ID 7705 Rev 11Figure 251. Defining events using Analyzer probe signalsAs shown in Figure 251, you can provide

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 319/385Example 2—Setting an advanced breakpoint on an input probe valueThis program allows you to make

Getting started with STVD UM003632/385 Doc ID 7705 Rev 11Figure 12. Restart with SWIM off option2.6 Debug your applicationIn the Debug context, STVD p

EMU3 emulator features UM0036320/385 Doc ID 7705 Rev 11Figure 253. Performance Analysis dialog boxIn this dialog box, you must specify the following:●

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 321/385number of passes executed are reset to zero and a new record is made, starting from the Program

EMU3 emulator features UM0036322/385 Doc ID 7705 Rev 11● Statistics for one pass through portion of code: These values concern timing data for the sel

UM0036 EMU3 emulator featuresDoc ID 7705 Rev 11 323/385● Show All modifies the scale of the graph to include the whole record in the visible area.● Pr

EMU3 emulator features UM0036324/385 Doc ID 7705 Rev 1110.8 Performing automatic firmware updatesYour emulation hardware contains programmable logic

UM0036 ProgramDoc ID 7705 Rev 11 325/38511 ProgramOnce you have finished debugging your application and have built the final version, you can program

Program UM0036326/385 Doc ID 7705 Rev 11Depending on your target microcontroller you will be able to configure the following:● The programming hardwar

UM0036 ProgramDoc ID 7705 Rev 11 327/385ICP mode with Option Bytes Disabled is a safe programming mode that allows you to start your MCU while ignorin

Program UM0036328/385 Doc ID 7705 Rev 11Unlock deviceThe Unlock Device option is only available for specific Flash devices. If you check this option,

UM0036 ProgramDoc ID 7705 Rev 11 329/3851. Select a memory area from the Memory Area list box. 2. Click on the Add button to open a browse window. 3.

UM0036 Getting started with STVDDoc ID 7705 Rev 11 33/385Figure 13. Programmer windowFrom this window, you have interfaces that allow you to:● Select

Program UM0036330/385 Doc ID 7705 Rev 111. Right-click in the option byte’s Description field to see the pop-up list of possible settings.2. Click on

UM0036 ProgramDoc ID 7705 Rev 11 331/385To start the programing sequence, click on the Start button. The Programmer connects to your target MCU and be

STM8 C tutorial UM0036332/385 Doc ID 7705 Rev 1112 STM8 C tutorialThe STM8 tutorial illustrates some of the main features of STVD by guiding you thro

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 333/38512.1 SetupIn this lesson you will learn how to setup the workspace environment so that you can build,

STM8 C tutorial UM0036334/385 Doc ID 7705 Rev 1112.1.2 Create a workspaceBefore you can build or debug an application with STVD, you must create a wo

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 335/3851. In the main menu bar, select Project>Add New Project to Workspace.2. In the New Project window,

STM8 C tutorial UM0036336/385 Doc ID 7705 Rev 11Figure 265. MCU selection8. Save your workspace; select File>Save Workspace.RESULT: <toolset>

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 337/385The working directory contains the following:● three files: main.c, and– for Cosmic: cosmic.stp, stm8_

STM8 C tutorial UM0036338/385 Doc ID 7705 Rev 11Figure 267. Project with source file and dependenciesRESULT:Your project workspace now contains the ap

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 339/38512.2 BuildIn this lesson you will learn how to configure project settings and build the application fo

Your STVD graphical environment UM003634/385 Doc ID 7705 Rev 113 Your STVD graphical environmentThese sections describe the layout of STVD: the vario

STM8 C tutorial UM0036340/385 Doc ID 7705 Rev 11Figure 268. Select the MCU4. Click on the name of the MCU (STM8S208MB), then click on the Select butt

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 341/385Note that STVD automatically fills in the Additional include directories when you add files to your pr

STM8 C tutorial UM0036342/385 Doc ID 7705 Rev 11Figure 270. C compiler options for Cosmic12.2.3 Change build settings for a specific fileIn addition

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 343/385Figure 271. Exclude the makefile from buildNote: At the file level the Project Settings window only di

STM8 C tutorial UM0036344/385 Doc ID 7705 Rev 1112.3 Start debuggingIn this lesson you will learn how to start a debugging session and run the applica

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 345/385Activate a featureYou can enable and disable some debug options. For this session we want to use the W

STM8 C tutorial UM0036346/385 Doc ID 7705 Rev 111. If it is not already open, double-click on timer.c to open the source file in an Editor window.2. S

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 347/385Figure 275. Step over line 242 to line 2431. Select Debug>Step Over to step over the reset_bug_coun

STM8 C tutorial UM0036348/385 Doc ID 7705 Rev 1112.4.1 Set an instruction breakpoint1. If it is not already open, double-click on timer.c to open the

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 349/385Figure 277. Instruction breakpoints5. Select Debug>Continue to run the application from line 107 to

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 35/385Figure 14. Main application windowStatus barThe status bar in the lower frame of the ST

STM8 C tutorial UM0036350/385 Doc ID 7705 Rev 1112.4.3 Set a condition on an instruction breakpoint1. In the Instruction Breakpoints window double-cl

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 351/38512.5 View executionIn this lesson you will learn the STVD features that allow you to view the applicat

STM8 C tutorial UM0036352/385 Doc ID 7705 Rev 11Figure 282. QuickWatch window7. In the Editor window place the cursor over the count variable, a pop-

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 353/385Figure 284. Watch window6. In the Editor window, click to place the cursor on line 123.7. Click on De

STM8 C tutorial UM0036354/385 Doc ID 7705 Rev 11Figure 285. Memory and Watch windows12. In the Watch window right-click to display the Watch window co

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 355/38512.6 Perform memory mappingMemory mapping is the process of defining which areas of memory can be acce

STM8 C tutorial UM0036356/385 Doc ID 7705 Rev 11Figure 287. MCU configuration9. Click on OK in the error message box. In the MCU Configuration window

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 357/38512.7.1 View program execution historyThe Trace window is used to view the contents of the trace buffe

STM8 C tutorial UM0036358/385 Doc ID 7705 Rev 11Figure 289. Saving trace contentsThe last 100 records are saved to file where they can be read using a

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 359/385Figure 290. Memory and Watch windows6. In the Editor window, locate the bugCountDown variable, select

Your STVD graphical environment UM003636/385 Doc ID 7705 Rev 113.2 The main menus and their commandsSTVD’s menus provide a range of common commands f

STM8 C tutorial UM0036360/385 Doc ID 7705 Rev 1112.7.3 Set an advanced breakpointThe Advanced Breakpoints window gives access to a powerful function

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 361/3856. The Configuration Summary field shows the logic structure, event definitions and actions to take fo

STM8 C tutorial UM0036362/385 Doc ID 7705 Rev 118. In the Advanced Breakpoints window click on the Synoptic tab. This tab displays a block diagram of

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 363/38515. From the Trace contextual menu select Column Display... Click on Uncheck all, then check the foll

STM8 C tutorial UM0036364/385 Doc ID 7705 Rev 11Figure 296. Setting up a performance analysis4. Click on Apply and then Run.5. When the program execu

UM0036 STM8 C tutorialDoc ID 7705 Rev 11 365/385To make the trap interrupt occur more frequently: 1. Restart the application.2. Locate the state vari

ST Assembler/Linker build tutorial UM0036366/385 Doc ID 7705 Rev 1113 ST Assembler/Linker build tutorialThis build tutorial takes you through the ste

UM0036 ST Assembler/Linker build tutorialDoc ID 7705 Rev 11 367/385RESULT:The Workspace window now contains the workspace my_workspace.stw. Note, howe

ST Assembler/Linker build tutorial UM0036368/385 Doc ID 7705 Rev 11To do this:1. First, enter the name realtime in the Project Filename field2. Enter

UM0036 ST Assembler/Linker build tutorialDoc ID 7705 Rev 11 369/385Adding source files to the project1. Selecting Project>Insert Files Into Project

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 37/385View menuThe commands in the View menu open the Workspace, Output and Instruction Break

ST Assembler/Linker build tutorial UM0036370/385 Doc ID 7705 Rev 115. Drag the file st72311n4.inc to the Include Files folder.6. You can save your w

UM0036 ST Assembler/Linker build tutorialDoc ID 7705 Rev 11 371/385The application source contains a routine under the #ifdef DEBUG_IT (lines 153-155

ST Assembler/Linker build tutorial UM0036372/385 Doc ID 7705 Rev 11Figure 303. Exclude file from buildTo do this:1. In the field on the left side of t

UM0036 ST Assembler/Linker build tutorialDoc ID 7705 Rev 11 373/385RESULT:The commands invoked, error messages and warnings that occur during the buil

ST Assembler/Linker build tutorial UM0036374/385 Doc ID 7705 Rev 11Figure 304. Change the build configurationTo change the build configuration:1. From

UM0036 ST Assembler/Linker build tutorialDoc ID 7705 Rev 11 375/385Entering a user-defined commandUser-defined commands such as those applied in the P

ST Assembler/Linker build tutorial UM0036376/385 Doc ID 7705 Rev 117. Type a space then the pathname for the folder where you want to save the copy o

UM0036 Product supportDoc ID 7705 Rev 11 377/385Appendix A Product supportIf you experience any problems with this product, or if you need spare part

Product support UM0036378/385 Doc ID 7705 Rev 11A.3 Getting prepared before you callCollect the following information about the product before contac

UM0036 Revision historyDoc ID 7705 Rev 11 379/385Revision history Table 87. Document revision historyDate Revision Changes1 Initial release.1-

Your STVD graphical environment UM003638/385 Doc ID 7705 Rev 11Build menuThe Build menu contains the commands that allow you to set the configuration

Revision history UM0036380/385 Doc ID 7705 Rev 1122-Nov-2007 6Added section What’s new with STVD 4.0.1 on page 24.Deleted Section 6.4: Trace recording

Index UM0036381/385 Doc ID 7705 Rev 11IndexAadvanced breakpoints . . . . . . . . . . . . . . . . . . .19EMU3analyzer input signals . . . . . . . .

Index UM0036382/385 Doc ID 7705 Rev 11between files . . . . . . . . . . . . . . . . . . . . . . . .157between projects . . . . . . . . . . . . . . . .

Index UM0036383/385 Doc ID 7705 Rev 11console . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58go to . . . . . . . . . . . . . . . . . . .

Index UM0036384/385 Doc ID 7705 Rev 11Ssimulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202read/write on the fly . . . . . . . . . .

UM0036Doc ID 7705 Rev 11 385/385 Please Read Carefully:Information in this document is provided solely in connection with ST products. STMicr

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 39/385 Window menuThis menu gives you access to commands for arranging and navigating

Contents UM00364/385 Doc ID 7705 Rev 114.8.1 Raisonance C compiler tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1184.8.2 Rai

Your STVD graphical environment UM003640/385 Doc ID 7705 Rev 11For details about these features, refer to Help and support features on page 70.Contex

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 41/385Docking view windowsAll of the View windows (the windows accessible from the View menu

Your STVD graphical environment UM003642/385 Doc ID 7705 Rev 11Figure 16. Workspace window tabsThe project file contains the target file name, the set

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 43/385Depending on the element that you select in the Workspace window (workspace, project, f

Your STVD graphical environment UM003644/385 Doc ID 7705 Rev 11This section provides a description of Editor window features, including: ● Editor wind

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 45/385File display and editing featuresThe Editor window has a number of advanced features to

Your STVD graphical environment UM003646/385 Doc ID 7705 Rev 11File foldingThis feature allows you to hide or display sections of C source code. Folds

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 47/385Figure 20. Left margin featuresBookmarks are particularly useful when editing large fil

Your STVD graphical environment UM003648/385 Doc ID 7705 Rev 11Editor status bar informationThe status information for each file in the Editor window

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 49/3853.5.1 Editor window contextual menuBy right-clicking in any Editor window, you can acc

UM0036 ContentsDoc ID 7705 Rev 11 5/3855.8.3 Setting counters and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1845.8.4 Show

Your STVD graphical environment UM003650/385 Doc ID 7705 Rev 11Note: To edit source files during a debugging session, ensure that the Read-only source

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 51/385If you have just created a new Assembler source file, the parameter information feature

Your STVD graphical environment UM003652/385 Doc ID 7705 Rev 11Brace matchingWhen viewing and navigating in source code, brace matching highlights mat

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 53/385FindYou can select the string for a search by placing the cursor anywhere in the string

Your STVD graphical environment UM003654/385 Doc ID 7705 Rev 11Figure 31. Find/replace windowIn addition to common find options (Match whole word, Mat

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 55/385The results of your search are displayed in the Output window, by default in the Find i

Your STVD graphical environment UM003656/385 Doc ID 7705 Rev 11These are just a few of the regular expressions that you might use to search your files

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 57/385The tabs located at the bottom of the Output window area are used to flip through the d

Your STVD graphical environment UM003658/385 Doc ID 7705 Rev 11Figure 39. Parser error selection optionsOnce a parser is selected, you can use the Par

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 59/385to enter commands directly. However, in Section 5.18: Online commands on page 199, you

Contents UM00366/385 Doc ID 7705 Rev 117.1.3 Ignoring option bytes (ICC only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2267.1.4 Con

Your STVD graphical environment UM003660/385 Doc ID 7705 Rev 113.7 Customizing your work environmentSTVD offers a flexible working environment for de

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 61/385The Customize window (Tools>Customize) provides an interface for creating your own c

Your STVD graphical environment UM003662/385 Doc ID 7705 Rev 11Edit/Debug tabUse the Edit/Debug tab to enable/disable and configure editor features re

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 63/385Debug allows you to access the debugging options described in Table 20 . Long L

Your STVD graphical environment UM003664/385 Doc ID 7705 Rev 11When you open a file with end of line characters that are different from the default li

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 65/3853.7.2 Customizing toolbarsA number of predefined relocatable toolbars are present by de

Your STVD graphical environment UM003666/385 Doc ID 7705 Rev 11Moving toolbarsToolbars can be transformed to independent always-on-top windows, by pla

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 67/385Rearranging toolbar icons1. From the main menu select Tools>Options. 2. Select the C

Your STVD graphical environment UM003668/385 Doc ID 7705 Rev 11For example, imagine that you want to add a command that would link directly to an exte

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 69/3856. In the Initial Directory field, you can specify the directory from which you want th

UM0036 ContentsDoc ID 7705 Rev 11 7/3859.2.3 Reading coverage and profiling results . . . . . . . . . . . . . . . . . . . . . . . . 2729.2.4 Typical

Your STVD graphical environment UM003670/385 Doc ID 7705 Rev 11Figure 52. Tool description3.9 Help and support featuresFrom the Help menu you can acc

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 71/385– Start.log– Contains the target debug and STVD version information. Old information is

Your STVD graphical environment UM003672/385 Doc ID 7705 Rev 11 For a full migration of your project, follow the 7 steps outlined in this sect

UM0036 Your STVD graphical environmentDoc ID 7705 Rev 11 73/385 Note: Most options for the supported toolsets can be set in the Project Settin

Your STVD graphical environment UM003674/385 Doc ID 7705 Rev 11Note: Metrowerks We recommend that users working with the Hiware format migrate their w

UM0036 Project creation and buildDoc ID 7705 Rev 11 75/3854 Project creation and buildSTVD provides a build interface that allows you to control the

Project creation and build UM003676/385 Doc ID 7705 Rev 11Toolset path informationUpon installation, STVD will attempt to identify the toolsets and th

UM0036 Project creation and buildDoc ID 7705 Rev 11 77/385Opening a .stw workspaceTo load a workspace (*.stw) created by STVD7 3.0 or later versions,

Project creation and build UM003678/385 Doc ID 7705 Rev 11Note: If a pop-up message appears indicating that your makefile was not found, click on OK a

UM0036 Project creation and buildDoc ID 7705 Rev 11 79/385Create a workspace by wrapping an executableYou can create a workspace for an executable fil

Contents UM00368/385 Doc ID 7705 Rev 1112 STM8 C tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33212

Project creation and build UM003680/385 Doc ID 7705 Rev 115. Select the MCU for you application and then click on OK.Your workspace is created and na

UM0036 Project creation and buildDoc ID 7705 Rev 11 81/385Add a project (.stp) to your workspaceClick on the New Project icon and then OK. This launch

Project creation and build UM003682/385 Doc ID 7705 Rev 11Create a project from an existing executableTo create a project from an executable (.abs, .e

UM0036 Project creation and buildDoc ID 7705 Rev 11 83/3854.3.3 Adding and removing folders and filesProjects contain the files that you will use to

Project creation and build UM003684/385 Doc ID 7705 Rev 11saved as Build Configurations so that you can easily switch between two or more configuratio

UM0036 Project creation and buildDoc ID 7705 Rev 11 85/385Some aspects of this interface are common to all toolsets, these common tabs are described i

Project creation and build UM003686/385 Doc ID 7705 Rev 114.5.2 Debug settings tabThis tab allows you to specify common settings for debugging your a

UM0036 Project creation and buildDoc ID 7705 Rev 11 87/385The current microcontroller setting is displayed in the gray Selected MCU field at the botto

Project creation and build UM003688/385 Doc ID 7705 Rev 114.6 Customizing build settings for ST Assembler/Linker toolsetThe ST Assembler/Linker tools

UM0036 Project creation and buildDoc ID 7705 Rev 11 89/385link and Post-Build) and three tabs that contain options and settings that are specific to S

UM0036 ContentsDoc ID 7705 Rev 11 9/38513.4 Creating a folder to organize files in the project . . . . . . . . . . . . . . . . . . . 37013.5 Project

Project creation and build UM003690/385 Doc ID 7705 Rev 11Include pathsThe Include path field introduces the -I option in the command line. This optio

UM0036 Project creation and buildDoc ID 7705 Rev 11 91/385The source file with the segment declarations (default is mapping.asm) is regenerated each t

Project creation and build UM003692/385 Doc ID 7705 Rev 11 4.6.3 ST Post-Link tabThe ST Post-Link tab allows you to view any instructions that

UM0036 Project creation and buildDoc ID 7705 Rev 11 93/3854.7 Customizing build settings for Cosmic C toolsetsThe Project Settings window for buildin

Project creation and build UM003694/385 Doc ID 7705 Rev 11Figure 62. Standard optionsTo further customize options, select a category in the Category l

UM0036 Project creation and buildDoc ID 7705 Rev 11 95/3854.7.1 Cosmic C compiler tabThe C Compiler tab provides an interface for setting the options

Project creation and build UM003696/385 Doc ID 7705 Rev 11General settings for Cosmic toolsetWith the category set to General, you can access the foll

UM0036 Project creation and buildDoc ID 7705 Rev 11 97/385 Debug informationThe Debug Info settings allow you to choose the debug information

Project creation and build UM003698/385 Doc ID 7705 Rev 11When the category is set to General, the standard optimization options for ST7 are:● Default

UM0036 Project creation and buildDoc ID 7705 Rev 11 99/385ListingsThe Listing settings allow you to generate a listing file and log errors to a file.L