General Commands Reference Guide R

General Commands Reference Guide R TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents ................................................
Author: Dennis Ward
2 downloads 0 Views 541KB Size
General Commands Reference Guide R TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents ......................................................................................................................



General Commands ......................................................................................................................



General Commands Reference Guide R ..................................................................................

1

REFresh ....................................................................................................................................

4

Function

4

REFresh.Address REFresh.CYcle REFresh.Inc REFresh.OFF REFresh.RESet

Refresh address range

5

Access mode

5

Address distance

5

Switch off

6

Reset command

6

REFresh.StandBy

Standby mode

7

REFresh.state

Status display

7

REFresh.Time

Refresh rate

8

Register ....................................................................................................................................

9

Register Register.Init Register.LOG Register.REFRESH

Processor registers

9

Initialize the processor registers

9

Log registers

13

Refresh register window

14

Reload the compiler register settings

14

Modify register contents

15

Define stack top address

16

Display registers

17

RESet ........................................................................................................................................

20

Register.RELOAD Register.Set Register.StackTop Register.view

RESet

Reset all commands

20

RTP ...........................................................................................................................................

21

RTP.CLEAR

Clear tracebuffer

21

tbd.

21

Direct data mode read/write

21

Halt system on RTP FIFO overflow

21

Selects the trace mode

21

RTP.OFF

Disables the RTP module

21

RTP.ON

Activates the RTP module

21

Configure RTPCLK

22

Size of RTP data port

22

RTP.DirectDataMode RTP.DirectDataMode.Mode RTP.HaltOnOverflow RTP.Mode

RTP.PortClock RTP.PortSize ©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

1

RTP.Register

Display the RTP register

RTP.RESet RTP.state RTP.TraceMode RTP.TraceMode.RAM.SECTion RTP.TraceMode.TraceExclude

Resets RTP settings

22

Display RTP setup

22

Trace mode

22

Configures a trace region

22

Invert all trace regions

22

RTS ........................................................................................................................................... RTS

RTS.FileCompression

23

Real-time profiling (RTS)

23

Code coverage

24

Set the name for the RTS file

25

RTS.COVerage RTS.FILE

22

Set compression level for the RTS file

25

Set size limit for the RTS file

26

Select the data to write to the RTS file

27

Initialize RTS

28

Statistics regarding instruction execution

28

List recorded trace data

30

RTS.ListNesting

Display function call nesting

31

RTS.LOAD

Mount a file as trace source

32

RTS.FileLimit RTS.FileMode RTS.Init RTS.ISTATistic RTS.List

RTS.NestingMode

Set type of program flow analysis

33

Deactivate real-time profiling

34

Activate real-time profiling

34

RTS.PROfile

Display performance characteristics charts

35

RTS.RESet

Restore default settings and initialize RTS

36

Open status and control window

36

Statistics regarding function invocations

38

Configure behavior regarding minor errors

39

RTS.OFF RTS.ON

RTS.state RTS.STATistic RTS.StopOnError RTS.StopOnFifofull

Configure behavior regarding FIFO overflows

39

Configure task analysis

40

Configure analysis of program execution timing

41

RunTime ...................................................................................................................................

42

RTS.TASKMode RTS.TImeMode

RunTime

Runtime measurement

42

Runtime Measurements Using the Debugger

42

Runtime Measurements Using TRACE32-ICE / TRACE32-FIRE

44

Functions related to RunTime

45

RunTime.Init

Clear timers

45

RunTime.refA

Set reference

46

RunTime.refB

Set reference

46

Reset values to zero

46

Display results

47

RunTime.RESet RunTime.state

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

2

Usage: (B) command only available for ICD (E) command only available for ICE (F) command only available for FIRE

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

3

General Commands Reference Guide R Version 26-Oct-2016

REFresh

Function The refresh function has to be activated, when a dynamic RAM is on the target system and is refreshed by the CPU. The refresh function uses burst read cycles for refreshing target memory. Address range and storage class may be defined. StandBy On StandBy mode the refresh burst is forced while no emulation is running. ref.burst

NOTE:

ref.burst

////////////////// realtime emulation

ref.burst

ref.burst

This command is for refreshing target DRAMs only, when having dynamic emulation memory, it is automatically refreshed by dual-port access.

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

4

REFresh

REFresh.Address

Format:

Refresh address range

REFresh.Address

Defines the address range, which is touched by refresh cycles. ref.inc 0x1 ref.a ud:0x10000--0x100ff

; Refresh on USERDATA area

ref.inc 0x0 ref.c word ref.a sd:0x1000++0x0ff

; Refresh burst with 128 words on ; address 1000h

If the REF.Inc value is set to zero, the address range will be define the length of the refresh burst to a single memory address.

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

REFresh.CYcle

Access mode

ICE only

Format:

REFresh.CYcle

:

Byte Word Long

If on 16 bit CPUs the access type is LONG, refresh is made by 2 refresh cycles. If on 8 bit CPUs the option WORD or LONG is selected, 2 or 4 cycles are used for one refresh cycle.

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

5

REFresh

REFresh.Inc

Address distance

ICE only

Format:

REFresh.Inc

:

1. …

Defines the address increment used in the refresh access loop. ; force refresh with 256 cycles ref.t 4.ms ref.a ud:0x0--0x03ff ref.c long ref.i 0x4 ref.on

; ; ; ; ;

cycle time 4 ms address range 0 to 03ffh long word increment 4 switch on refresh operation

; standby refresh on address 1000H ref.a ud:0x1000++0x0 ref.c b ref.standby

; address 1000H ; byte access ; switch refresh on

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

REFresh.OFF

Switch off

ICE only

Format:

REFresh.OFF

Refresh function is switched to OFF automatically, when the refresh parameters don't fit e.g. an odd address range together with word size.

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

6

REFresh

REFresh.RESet

Reset command

ICE only

Format:

REFresh.RESet

The refresh system is switched to OFF and all refresh parameters are initialized.

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

REFresh.StandBy

Standby mode

ICE only

Format:

REFresh.StandBy

Refresh cycles will be executed, if real-time emulation is not active. Refresh command may be activated only when all refresh parameters are correct.

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

7

REFresh

REFresh.state

Status display

ICE only

Format:

REFresh.state

Displays the current setup of the refresh function. E68::w.ref mode OFF ON StandBy Address UD: 000000 0000FF Cycle BYTE Inc 000001

See also ■ REFresh.Address ■ REFresh.RESet

■ REFresh.CYcle ■ REFresh.StandBy

■ REFresh.Inc ■ REFresh.Time

■ REFresh.OFF

▲ ’Refresh Generator’ in ’ICE User’s Guide’

REFresh.Time

Refresh rate

ICE only

Format:

REFresh.Time

:

1.0ms … 1.0s

Will define the refresh time, if cyclic refresh is selected. This field has no effect on standby-refresh. ref.t 4.0ms

; refresh burst every 4 ms

See also ■ REFresh.state ▲ ’Refresh Generator’ in ’ICE User’s Guide’

©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

8

REFresh

Register

Register

Processor registers

The Register command group is used to control the processor registers. In case of subprocessors (e.g., FPU) extra commands are provided. Register values can be returned by the function Register(): PRINT Register(D0)

; print the contents of the ; register D0 in the message line

Register.Set D1 Register(D0)

; set register D1 to the contents ; of register D0

See also ■ Register.Init ■ Register.Set ❏ Register()

■ Register.LOG ■ Register.StackTop ❏ Register.LIST()

■ Register.REFRESH ■ Register.view

■ Register.RELOAD ❏ PP()

▲ ’Release Information’ in ’Release History’

Register.Init

Format:

Initialize the processor registers

Register.Init Register.RESet (deprecated)

Sets the registers to the same state as after the processor reset. Registers which are undefined after RESET are set to zero. B::

; example for the debugger

… SYStem.Up

; establish the communication between the ; processor and the debugger

Register.Init

; initialize the general purpose registers



©1989-2016 Lauterbach GmbH

General Commands Reference Guide R

9

Register

CPU

Behavior of Register.Init

ARC

STATUS STATUS32 DEBUG IRQ_LV12 IENABLE SEMAPHORE