µVision4 User's Guide

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 Cortex-M Code and Data Trace Trace Features Tracepoint Expressions Tracepoint Intrinsics Tracepoint Limitations Configuring the Trace Hardware Tracepoint Marks 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

Fully Qualified Symbols

Fully Qualified Symbols are identified through a unique string. This can include the:

  • ApplicationName identifying the application.
  • [\path]/ModuleName identifying the module of the application.
  • FunctionName identifying the function in the module.
  • Identifier which can be one of the following:
    • LineNumber identifying the source code line number.
    • Symbol identifying the name of the symbol.

The components above can be combined as shown in the following table:

Symbol Name Structure Description
[path/]ModName\LN Identifies a line number LN in the module ModName.

For non-Cortex-M processors, path requires the back-slash (\) within the path qualifier.

For Cortex-M processors, path requires the slash (/) within the path qualifier. Paths can include relative path qualifiers ( \../../prog.c\ ).
\ModName\FuncName Identifies the function FuncName in the module ModName.
\ModName\SymName ... global symbol SymName in ModName.
\ModName\FuncName\SymName Identifies the local symbol SymName in the function FuncName.

Examples

Fully Qualified Symbol Name Identifies the ...
\MEASURE\clear_records\idx ... local symbol idx in the function clear_records of the module MEASURE.
\MEASURE\MAIN\cmdbuf ... local symbol cmdbuf in the function MAIN of the module MEASURE.
\MEASURE\sindx ... symbol sindex in the module MEASURE.
\MEASURE\225 ... line number 225 in the module MEASURE.
\MEASURE\TIMER0 ... the symbol TIMER0 in the module MEASURE. This symbol can be a function or a global variable.
\\MEASURE\MEASURE.c\TIMER0 ... the symbol TIMER0 in the module MEASURE.c of the application MEASURE (for Cortex-M).
\\MEASURE\MFolder/MEASURE.c\25 ... the line number 25 in the module MEASURE.c with the path MFolder of the application MEASURE (for Cortex-M).
\ ../../MFolder/MEASURE.c\TIMER0 ... the symbol TIMER0 in the module MEASURE.c with the relative path ../../MFolder (for Cortex-M).

Note

  • Drag and drop symbols from the Symbol Window to the Command Window to get the fully qualified symbol name.