General Commands Reference Guide V

[Pages:83]General Commands Reference Guide V

Release 09.2021

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-2021 Lauterbach GmbH

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-2021 Lauterbach GmbH

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 ALTIVEC registers 82

VPU.Set

Modify ALTIVEC registers 82

VPU.view

Display ALTIVEC register window 83

?1989-2021 Lauterbach GmbH

General Commands Reference Guide V | 4

General Commands Reference Guide V

Version 04-Nov-2021

History

08-May-20 Description for command Var.OBJECT.

?1989-2021 Lauterbach GmbH

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 '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-2021 Lauterbach GmbH

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-2021 Lauterbach GmbH

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-2021 Lauterbach GmbH

General Commands Reference Guide V | 8

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download