PowerView User's Guide

[Pages:125]PowerView User's Guide

TRACE32 Online Help

TRACE32 Directory

TRACE32 Index

TRACE32 Documents ......................................................................................................................

PowerView User Interface ............................................................................................................

PowerView User's Guide ........................................................................................................... 1

History ...................................................................................................................................... 5

Structure and Contents of the Documentation .................................................................... 5

Online Documentation

5

In-Circuit Debugger TRACE32-ICD

6

Program Start .......................................................................................................................... 8

In-Circuit Debugger TRACE32-ICD

8

Program End ............................................................................................................................ 9

PowerView - Screen Display .................................................................................................. 10

Concept

10

Graphical User Interface - Window Modes

10

MDI User Interface

11

MWI User Interface

12

Main Menu Bar

13

Accelerators

13

Main Toolbar

14

Work Area

14

Message Line

15

Error Messages

15

General Messages

15

Additional Information on Cursor Position

15

Softkeys

16

State Line

17

Cursor

17

Cursor - In a Hypervisor Environment

18

Debug

18

Trace

19

Debugger Activity

19

Mode

20

Task

21

Task - In a Hypervisor Environment

21

PowerView User's Guide

?1989-2021 Lauterbach GmbH

1

SMP Systems

22

Advanced

22

Show/Hide State Line

22

Window Pages

23

Colors

24

How the TRACE32 PowerView GUI Assists You in Scripting

25

Commands ............................................................................................................................... 27

Command Structure

27

Long Form and Short Form of Commands and Functions

28

Entering Commands

29

Command Line

29

Device Selection

30

Command History

31

Command and Function Parameters

32

Parameter Types

34

Operators

38

Arithmetic Rules and Operator Precedence

40

Parentheses and Braces

41

Parameter History

41

File Names

42

Path Prefixes

43

General Command Parameter Parser - Behavior in the Different Radix Modes .............. 44

Parser Changes in Version V2.00 and Higher

44

A. Object of Description

44

B. Support of C Language Expressions

46

C. Radix Mode Support

47

D. Incompatibilities in RADIX.Classic Mode

48

Operands

49

Operand Format Examples (Literals)

50

Operand Transition Table

51

Operators

52

Operator Formats

53

Operator Transition Table

55

Window System ....................................................................................................................... 56

Windows

56

Window Captions - What Makes Them Special in TRACE32

57

Local Buttons

57

Local Popup Menus

58

Slider Controls

59

Window Operations

60

Basic Operations

60

Old Position, Bookmarks, and Current Selection

60

PowerView User's Guide

?1989-2021 Lauterbach GmbH

2

Getting Information

61

Changing Data or Setups

61

Window Manager Menu

62

Window Position and Name

65

Freezing a Window

65

Erasing a Window

65

Window Scroll Bars

65

Printing Window Contents

66

Saving Window Contents

67

Special Window Options

68

Text-based Functions

69

Selection Service

69

Message Windows .................................................................................................................. 70

Window Tracking ..................................................................................................................... 71

File and Folder Operations ..................................................................................................... 73

File Contents ............................................................................................................................ 74

Encrypt/Execute Encrypted Files .......................................................................................... 75

Host Commands ...................................................................................................................... 76

Printer Operations ................................................................................................................... 77

System Setup and Configuration ........................................................................................... 79

Logging Commands ................................................................................................................ 80

Dialog Programming ............................................................................................................... 81

Dialog Syntax and File Types

81

Comments in Dialogs

83

Dialog Commands

84

Control Your Custom Dialogs

84

Control Behavior of Individual Dialog Elements on Custom Dialogs

84

Interact with the File System

84

Display Message Boxes of the Operating System

84

Dialog Elements

85

Return Values and Labels

87

PRACTICE Macros inside Dialog Definitions

88

HELP System ........................................................................................................................... 89

Ways to Get Help

89

Context-Sensitive Help

90

Structure of the Help System

91

Configure the Help System

92

Recommendations for Choosing a PDF Viewer

93

Bookmarks for Help Topics

94

Create Help Bookmarks

94

PowerView User's Guide

?1989-2021 Lauterbach GmbH

3

Store and Load Help Bookmarks Manually

95

Store and Load Help Bookmarks Automatically

95

Troubleshooting the Help System

96

Change the Installation Path of the PDF Files

97

Winhelp Compatibility

97

Previous Releases - HELP System ........................................................................................ 98

Previous Releases - HELP Installation and Setup

98

Previous Releases - Configuring an Alternate PDF Viewer

98

Previous Releases - HELP Installation Problems

102

InterCom ................................................................................................................................... 104

Version Management and Licensing ..................................................................................... 106

Text Editors .............................................................................................................................. 107

Built-in Editors

107

OS-Native Editor

107

PowerView Editor

107

Context Sensitive Context Menu

108

Keyboard Shortcuts

Automatic Formatting

109

Special Purpose Editor Windows

110

External Editors

112

Configuring an External Editor

112

Working with TRACE32 and the External Editor

114

Icons ......................................................................................................................................... 115

Built-in Icons and Icon Library

116

Inserting a Placeholder for User-Defined Icons

117

Drawing Icons

118

Interface ................................................................................................................................... 120

Shortcuts .................................................................................................................................. 121

Appendix - About the TRACE32 Software Version Numbers .............................................. 125

PowerView User's Guide

?1989-2021 Lauterbach GmbH

4

PowerView User's Guide

Version 30-Apr-2021

History

28-Jun-19 25-Jan-19 22-Jan-19

Updated the entry of the parameter type "symbol" in section "Parameter Types".

New chapter "Editing Files in the TRACE32 Editors - Syntax Highlighting".

Placed chapter "External Editors - Syntax Highlighting" into this manual; previously the chapter was located in practice_user.pdf.

Structure and Contents of the Documentation

This chapter describes the structure of the TRACE32 documentation. The release history in the documentation always lists the latest changes in the TRACE32 software. When you get a new version of the TRACE32 software, please always check the Release history first.

Online Documentation

There are several ways to get access to the documentation: 1. If the TRACE32 software is already running, you can use the Help command in the main menu

bar. 2. On the TRACE32 software DVD and in your TRACE32 system path (e.g. C:\T32), you can find

a directory pdf. This directory contains the complete TRACE32 documentation in PDF format. Open directory.pdf to get the table of contents for the complete TRACE32 documentation.

Documentation on how to use the online help can be found in chapter Help System.

The documentation is automatically filtered by your currently used hardware and/or software configuration. The filter automatically reduces the whole documentation to the part that is relevant for you. If you want to change the filter, take a look at the command HELP.FILTER.

PowerView User's Guide

?1989-2021 Lauterbach GmbH

5

In-Circuit Debugger TRACE32-ICD

TRACE32-ICD includes all debuggers based on an on-chip debug interface (e.g. JTAG, BMD, OCDS ...) as well as ROM monitor solutions. Lauterbach also provides a trace extension for most debuggers (TRACE32-ICT). TRACE32-ICD comes with a number of manuals that should make you familiar with important features of TRACE32-ICD.

Manuals to help you get started:

? "ICD Tutorial" (icd_tutorial.pdf) A guided tour through the TRACE32 graphical user interface (GUI) called TRACE32 PowerView. We use a simple program example in C to illustrate the most important debug features and give lots of helpful tips & tricks for everyday use.

? "Debugger Basics - Training" (training_debugger.pdf) - An introduction to debugging with TRACE32

? "Debugger Basics - SMP Training" (training_debugger_smp.pdf) - An introduction to SMP debugging

? "Training Script Language PRACTICE" (training_practice.pdf) - An introduction to PRACTICE, the scripting language for TRACE32

Sources of information beyond the PDF files of the TRACE32 online help:

? - Reference Card for the most common commands of the PRACTICE scripting language

? - An introduction to asymmetrical and symmetrical multiprocessing (AMP/SMP)

? - A variety of tutorials on the Lauterbach YouTube channel

For more information on the features of TRACE32-ICD, refer to the following parts of the TRACE32 online help:

? "TRACE32 Installation Guide" (installation.pdf) This part is the general installation guide for all TRACE32 development tools.

? "ICD In-Circuit Debugger" This part provides all CPU specific information for your TRACE32-ICD, chiefly how to set up the debugger for your target. Here you will also find all extra features that are supported for your CPU.

? "General Reference Guide" (general_ref_.pdf) This part provides an alphabetical list of all debugger commands. All commands that are not available for TRACE32-ICD are marked with:

- (E) - TRACE32-ICE only

- (F) - TRACE32-FIRE only

? "PowerView User's Guide" (ide_user.pdf)

PowerView User's Guide

?1989-2021 Lauterbach GmbH

6

All TRACE32 development tools share the common user interface TRACE32 PowerView. This part describes the basic functions of the user interface (command structure, online help, editing and managing files, printer operations, etc.)

? "PowerView Command Reference" (ide_ref.pdf) This part provides an alphabetical list of all TRACE32 PowerView commands.

? "PRACTICE Script Language User's Guide" (practice_user.pdf) The TRACE32 script language PRACTICE is mainly used to perform automatic setups, to automate test sequences or to store the system settings for later recall. This part describes the basic structure and features of PRACTICE.

? "PRACTICE Script Language Reference Guide" (practice_ref.pdf) This part provides an alphabetical list of all PRACTICE commands.

? "OS Awareness Manuals" (rtos_.pdf) Refer to this part if you want to use the TRACE32 OS Awarenesses (= RTOS Debuggers in previous TRACE32 releases).

? "3rd-Party Tool Integrations" (int_.pdf) Refer to this part, if you want to run TRACE32-ICD from a 3rd-party user interface.

PowerView User's Guide

?1989-2021 Lauterbach GmbH

7

Program Start

After installing the driver program to the appropriate host system, the executable can be started.

The TRACE32 system has to be powered up. If this is not the case, the error message "NO CARRIER ...", "LINK ERROR ..." or "TRACE32 not responding" will appear.

If all environment variables are installed correctly, the driver program can be invoked from any sub-directory or drive.

To start a TRACE32 executable, you can use: ? The T32Start utility ? The command line of the operating system

T32Start The user interface of the T32Start utility assists you in creating as many start environments for TRACE32 as you need for your different debug projects. Based on the start environment you have created with a few mouse-clicks, T32Start auto-generates the configuration file that is essential for starting TRACE32 correctly.

For more information, see "T32Start" (app_t32start.pdf).

Command Line If you want to start TRACE32 via the command line of the operating system, you need to manually create the configuration file (by default config.t32). The configuration file settings are described in "TRACE32 Installation Guide" (installation.pdf).

For information about the command line syntax and command line options, see "Command Line Arguments for Starting TRACE32" (debugger_user.pdf).

The following list is a selection of the available command line options: ? --t32-help ? --t32-safestart ? --t32-logautostart

In-Circuit Debugger TRACE32-ICD

t32m.exe t32m

PowerView User's Guide

Windows version for TRACE32-ICD. TRACE32-ICD system software is running on PC. Workstation version for TRACE32-ICD. TRACE32-ICD system software is running on workstation.

?1989-2021 Lauterbach GmbH

8

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

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

Google Online Preview   Download