µVision4 User's Guide
Home Products Download Events Support
Search Keil.com for:

Technical Support

On-Line Manuals

µVision4 User's Guide

About µVision User Interface Creating Applications Utilities Debugging Using the Debugger Simulation Start Debugging Application Program Execution Debug Windows and Dialogs Breakpoints Window Call Stack and Locals Window Code Coverage Command Window Disassembly Window Event Viewer Execution Profiler Instruction Trace Window Logic Analyzer Setup Setup in Detail Restrictions Using the Logic Analyzer Memory Map Memory Window Performance Analyzer Registers Window Serial Window Symbols Window System Viewer Adding System Viewer Windows Toolbox Trace Data Window Trace Navigation Watch Window Expressions Constants System Variables Peripheral Variables I/O Ports Serial Ports Program Variables (Symbols) Fully Qualified Symbols Non-Qualified Symbols Literal Symbols Using Symbols Line Numbers Bit Addresses Type Specifications Operators Memory Type Specifiers Differences Between µVision4 and C Expression Examples Tips and Tricks Review Peripherals and CPU Configuration Simulate I/O Ports Simulate Interrupts and Clock Inputs Simulate external I/O Devices Assign Serial I/O to a PC COM Port Check Illegal Memory Access Command Input from File Preset I/O Ports or Memory Contents Write Debug Output to a File Keyboard Shortcuts TPIU Initialization after RESET (Cortex-M) Debug Commands Debug Functions Simulation Flash Programming Dialogs Example Programs Command Line Appendix

Program Variables (Symbols)

Symbols are representations of source code identifiers, such as the names of applications, modules, variables, functions, special function registers, or virtual registers. Usually, symbols are associated with debug information, for example: type, scope, or location of the identifier they represent. Symbols allow using the names of identifiers as defined in the original source code.

Enable Options for Target — Output — Debug Information to generate the information required for performing source-level and symbolic debugging.

The general form of a symbol name is:

[\\Application][[\[Path/]Module][\Identifier]]
Applicationrepresents the application name. Must be preceded with a double backslash (\\).
Pathrepresents the folder of the source code file. Separate folders from sub-folders with a slash (/). Must end with a slash (/). Path can:
  • be ignored for devices not using a Cortex-M processor.
  • have an absolute or relative notation for devices that are using a Cortex-M processor.

See examples in Module.
Modulerepresents the name of a source module ( *.c, *.cpp). Can be preceded with a Path. Must begin with a backslash (\). For example, the compiler generates the object file Mcommand.obj for the source file Mcommand.c, then Module is:
  • Mcommand for devices not using a Cortex-M processor.
  • Mcommand.c for devices that are using a Cortex-M processor.


Examples

Assuming the application folder is C:\ARM\Projs\Measure. Then the symbol name can have the form:

/*  Mcommand.c resides in  C:\ARM\Proj\Measure\src  */
\\Measure\Mcommand                            // path ignored for non-Cortex-M.
                                              // Module without file extension.

\\Measure\C:/ARM/Proj/Measure/src/Measure.c   // absolute path (Cortex-M)
\\Measure\src/Measure.c                       // relative path

/*  Mcommand.c resides in  C:\ARM\Proj\src  */
\\Measure\../src/Measure.c                    // relative path

Module names can be queried from the Command Window with the debugging command:

DIR module
Identifierrepresents a source code object. Must be separated from Module with a backslash (\). Can be used standalone and without backslash when unique in the application. Identifier can be a:
  • code line number.
  • scalar variable (char, int, long, float, double).
  • composite variable (array, structure, file).
  • function.
  • meaningful combination of the above.


Examples

\\Measure\Measure.c\87                             // Code line number
\\Measure\Measure.c\sindex                         // Scalar variable
\\Measure\Measure.c\setinterval.min                // Structure.StructMember
\\Measure\Measure.c\menu[1]                        // Array[element]
\\Measure\Measure.c\read_index                     // Function
\\Measure\Measure.c\read_index\index               // Function\Scalar variable

This section contains descriptions for:

Contact Site Map Press PrivacyCopyright © 2012 ARM Ltd and ARM Germany GmbH. All rights reserved.