General Commands Reference Guide V
[Pages:84]General Commands Reference Guide V
Release 09.2023
MANUAL
General Commands Reference Guide V
TRACE32 Online Help
TRACE32 Directory
TRACE32 Index
TRACE32 Documents ......................................................................................................................
General Commands ......................................................................................................................
General Commands Reference Guide V .................................................................................. 1
History ...................................................................................................................................... 5
Var ............................................................................................................................................. 6
Var
HLL variables and expressions 6
Overview Var
6
Symbol Prefix and Postfix
6
Symbol Paths
7
Search Paths
7
Mangled Names and C++ Classes
8
Function Return Values
8
Special Expressions
8
Calling Functions
11
Display Formats
12
Functions
23
Var.AddSticker
Add variable sticker to source listing window 23
Var.AddWatch
Add variable to Var.Watch window 24
Var.AddWatchPATtern
Add variables to Var.Watch window using wildcards 24
Var.Assign
Assignment to a variable 25
Var.Break
Breakpoint on variable 26
Var.Break.Delete
Delete breakpoint on variable 26
Var.Break.direct
Set temporary breakpoint on HLL expression 28
Var.Break.Pass
Define pass condition for breakpoint 29
Var.Break.Set
Set breakpoint to HLL expression 30
Var.Call
Call a new procedure 31
Var.CHAIN
Display linked list 32
Var.DelWatch
Delete variable from watch 33
Var.DRAW
Graphical variable display 33
Var.DRAWXY
Graphical variable display 37
Var.DUMP
Memory dump 38
Var.Eval
Evaluate high-level expression 39
Var.EXPORT
Export variables in CSV format to file 39
Var.FixedCHAIN
Display linked list 41
?1989-2023 Lauterbach
General Commands Reference Guide V | 2
Var.FixedTABle Var.Go Var.Go.Back Var.Go.Change Var.Go.direct Var.Go.Till Var.IF Var.Local Var.LOG Var.NEW Var.NEWGLOBAL Var.NEWLOCAL Var.OBJECT Var.PATtern Var.PRINT Var.PROfile Var.Ref Var.set Var.Step Var.Step.BackChange Var.Step.BackTill Var.Step.Change Var.Step.Till Var.TABle Var.TREE Var.TYPE Var.View Var.Watch Var.WHILE Var.WRITE
Display table 41 Real-time emulation 43 Re-run program backwards until variable access (CTS) 43 Real-time emulation till expression changes 44 Real-time emulation with breakpoint 45 Real-time emulation till expression true 46 PRACTICE conditional branching 47 View information about HLL variable or HLL expression 48
Local variables 49 Log variables 50
Creates a TRACE32-internal variable 52 Creates a global TRACE32-internal variable 53
Creates a local TRACE32-internal variable 54 Pretty printing for C++ objects 56
Display variables allowing wildcards for symbol name and type 58 Display variables 59
Graphical display of variable 60 Referenced variables 61 Modify variable 62 Step 65
Step back till expression changes 65 Step back till expression true 65 Step till expression changes 66 Step till expression true 66 Display table 67
Display variables in the form of a tree structure 68 Display variable types 69 Display variables 70
Open Var.Watch window 72 PRACTICE loop construction 73
Write variables to file 74
VCO ........................................................................................................................................... 75
VCO
Clock generator 75
VCO.BusFrequency
Control bus clock 75
VCO.Down
Frequency down 75
VCO.Frequency
Control VCO clock 76
VCO.Rate
VCO rate 76
VCO.RESet
VCO reset 77
VCO.state
State display 77
VCO.TimeBaseFrequency
Set the time base clock 77
VCO.Up
Frequency up 78
VCU ........................................................................................................................................... 79
VCU
VCU registers (Vector Computational Unit) 79
?1989-2023 Lauterbach
General Commands Reference Guide V | 3
VCU.Init VCU.RESet VCU.Set VCU.view
Initialize VCU registers 79 Reset VCU registers 79 Set VCU register 80
Display VCU registers 80
VE .............................................................................................................................................. 81
VE
Virtual execution mode 81
VE.OFF
Turn off virtual execution mode 81
VE.ON
Turn on virtual execution mode 81
VPU ........................................................................................................................................... 82
VPU
Vector Processing Unit (VPU) 82
VPU.Init
Initialize VPU registers 82
VPU.Set
Modify VPU registers 83
VPU.view
Display ALTIVEC register window 84
?1989-2023 Lauterbach
General Commands Reference Guide V | 4
General Commands Reference Guide V
Version 09-Oct-2023
History
23-Jan-2023 VPU commands support different architectures other than PowerPC.
?1989-2023 Lauterbach
General Commands Reference Guide V | 5
Var
Var
HLL variables and expressions
See also
Var.AddSticker Var.Break Var.DRAW Var.EXPORT Var.IF Var.NEW Var.PATtern Var.set Var.TYPE Var.WRITE Var.END() Var.TYPEOF()
Var.AddWatch Var.Call Var.DRAWXY Var.FixedCHAIN Var.NEWGLOBAL Var.PRINT Var.Step Var.View SETUP.Var Var.RANGE() Var.VALUE()
'Var Functions' in 'General Function Reference' 'Release Information' in 'Legacy Release History'
Var.AddWatchPATtern Var.CHAIN Var.DUMP Var.FixedTABle Var.Local Var.NEWLOCAL Var.PROfile Var.TABle Var.Watch sYmbol.CASE Var.SIZEOF()
Var.Assign Var.DelWatch Var.Eval Var.Go Var.LOG Var.OBJECT Var.Ref Var.TREE Var.WHILE Var.ADDRESS() Var.STRing()
Overview Var
Lower and upper case letters are distinguished in symbol names. The command sYmbol.CASE switches off this differentiation. The length of symbol names is limited to 255 characters. The maximum number of symbols depends on the size of the system memory.
Symbol Prefix and Postfix
Most of the compilers add a special character (for example "." or "_") in front of or behind the users symbol names. The user does not need to enter this character. The symbol management automatically adds the character, if necessary.
Example for the processing of prefix/postfix characters.
Symbol Table _vfloat
Entry _vfloat or vfloat
HLL-Windows vfloat
Assembler windows _vfloat
?1989-2023 Lauterbach
General Commands Reference Guide V | 6
Symbol Paths
There are two modes during entry a symbol name: entering a complete symbol path or solely a symbol name. If only a symbol name is used, the access will occur to the symbol valid for the used program part (if symbol names are used more than once, local symbols are preferred to symbols of higher blocks).
By specifying a complete symbol path access to any symbol is possible. Each part of the symbol path is separated by a '\'. A complete path has to begin with a '\'. The following path versions are allowed:
\modul\global ... \modul\modul-local ... \\program\modul ...
If the specified symbol represents a function, the access to local variables of this function and of nested functions will be possible:
...\function\local ...\function\function ...
If using PASCAL, as many functions as chosen will be nested. Line numbers can be specified in the following way:
\linenumber \linenumber\columnnumber \module\linenumber \\program\module\linenumber ..\function\relative_linenumber
The address of the high level language block containing the specified line number is returned by this operation.
Search Paths
If no complete path is entered, the symbol will be searched in the following sequence 1. Local symbols (interior block ... exterior block) 2. Static symbols of block 3. Static symbols of module 4. Global symbols of current program 5. All other static symbols
?1989-2023 Lauterbach
General Commands Reference Guide V | 7
Mangled Names and C++ Classes
The class of a method can be left out, if this method exists only in one class and the names are ANSI mangled. The class is always required, if the constructor, destructor or an overloaded operator must be accessed. The quotation marks can help to allow special characters if the C++ name is used in the regular TRACE32 syntax. They are not required in the Var command group. However they can be used when specifying a local symbol. The command sYmbol.MATCH can control the behavior if an overloaded method is not specified with the prototype.
List `class1::method1` List method1
List `class1::class1` List `class1::~class1` List `class1::operator++` List `class1::operator+(int)`
Var.set `class1::operator+(int)\i`
//access to same method (ANSI // mangled)
//creator of class class1 //destructor of class class1
//overloaded operator
//overloaded operator with // prototype
//local variable of function
Function Return Values
The return value of a function is entered in the symbol list as a local variable of the function. It has always the name 'return'.
Special Expressions
The expression interpreter accept some extensions to the language. All type checks and range checks are handled as free as possible. Accessing data beyond the array limits is allowed.
A dereference of a plain number will assume that it is a pointer to character:
Var.set *0x2000 = 1
//set byte at location 2000 (decimal)
All labels (typeless symbols) can be used in expressions. They are taken as variables of the type void. They can be cast directly to the wanted type.
Var.set __HEAP Var.set *__HEAP Var.set (long)__HEAP
//displays nothing (if __HEAP is a label) //assumes __HEAP as a pointer to character //takes __HEAP as a 'long' variable
?1989-2023 Lauterbach
General Commands Reference Guide V | 8
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related download
- c reference card ansi constants flow of control program
- c notes for professionals
- accessing structure members in c tantia university
- interrupts ms dos function calls int 21h
- c language questions and answers techtud
- general commands reference guide v
- java basics university of san francisco
- c quick reference
- lab manual vvitengineering