IBM
Contents Index Previous Next



Graphical User Interface


This section describes the appearance and functionality of the graphical user interface of the SDL Target Tester (sdtmtui). Some user interface descriptions common to all tools can be found in User Interface and Basic Operations. These general descriptions are not repeated in this chapter.

Starting the SDL Target Tester UI

The SDL Target Tester UI is automatically started from the Cmicro Postmaster. When the UI is started the definition file for the button groups (see The Button Area) is read in. The default name of this file is sdtmt.btn.

The Main Window

The main window provides a text area (which displays output from the monitor system), an input line (used for entering and displaying textual command line input to the monitor system) and a button area (with buttons for execution of monitor commands).

Figure 605 : The Main window

The Text Area

The text area displays all text output from the monitor system, including user prompts, error messages and command results.

Commands cannot be entered in this area, but a command given on the input line or through the use of the command buttons is echoed after the displayed prompt:

Command> 

The Input Line

The input line is used for entering and editing monitor commands from the keyboard. For information on available monitor commands, see Syntax of SDL Target Tester Commands.

The last commands entered on the input line are saved in a history list. This list can be traversed by using the <Up> and <Down> keys on the input line.

When <Return> is pressed anywhere on the input line, the complete string is saved in the history list and is moved to the text area. The command is then executed.

Parameter Dialogs

If a command entered on the input line requires additional user input (i.e. parameter values), the information will automatically be prompted for in a dialog:

Figure 606 : A typical selection dialog

The value can also be entered or edited on the text input line below the list in the dialog. For those commands that take an optional variable component, the component must be entered on the text input line after the selected variable name. It will not be asked for in a dialog.

Each parameter dialog has an OK button for confirming the value and a Cancel button for cancelling the command.

The Button Area

The button area is used for entering monitor commands by clicking the left mouse button on a command button. Each button corresponds to a specific monitor command. The buttons are divided into groups, roughly corresponding to the different types of commands listed in SDL Target Tester Commands. Each group is shown as a module in the button area. Any number of button modules may reside in the button area. If the modules do not fit in the button area, a vertical scroll bar is added.

The definition of the buttons and button groups are stored in a button definition file (see Button and Menu Definition File). New buttons can be added and existing ones deleted or redefined by using the Group menu in a button module.

If a button's definition contains parameters, the parameter values are prompted for in dialog boxes before the command is executed, in the same way as described for commands entered from the input line. See Parameter Dialogs.

When no more parameter values are requested, the string shown on the input line is saved in the history list and moved to the text area. The command is then executed.

A Button Module

Figure 607 : A button module

Each button module consists of a title bar and a number of command buttons arranged in rows and columns. The title bar displays:

The Group button contains the following menu choices:

Add

This menu choice opens a dialog where you may add one or several new buttons to the button module. You should specify a label of the new button and a command that is to be executed when the button is clicked. Click OK or Apply, to add the button to the end of the module. For the syntax of a button definition, see Button and Menu Definitions.

Figure 608 : Adding a new button

Note:

Several buttons are allowed to have the same name within the same module. When you edit the button definition or delete the button, it is always the first occurrence that will be deleted or modified.

Edit

This menu choice opens a dialog where you can select a button to edit, that is, its label and definition. You edit the button in a similar way as described in Add.

Note:

If several buttons have the same button label, it is always the first button found that will be edited, regardless of the selection.

Delete

This menu choice opens a dialog where you can select one or several buttons to be deleted.

Note:

If several buttons have the same button label, it is always the first button found that will be deleted, regardless of the selection.

Rename Group

This menu choice opens a dialog where you can edit the name of the current button module.

Delete Group

Select this menu choice deletes to delete the current module from the button area. You will be asked to confirm the operation.

The Default Button Modules

The following tables list the default buttons in the button modules and the corresponding monitor command. See SDL Target Tester Commands for more information.

Note:

The buttons in the button modules are specified in the button definition file. If the default button file is not used, the button modules may differ from those described here. See Button and Menu Definitions for more information.

The Environment Module

Button SDL Target Tester command

Send without params

Output-NPAR

Send with params

Output-PAR

The Execute Module

Button SDL Target Tester command

Go-Forever

Go-Forever

The Examine Module

Button SDL Target Tester command

Queue

?Queue

Process

?Process-State

Last Error

?Errors

Timers

?Timer-Table

Process List

?All-Processes

Active

Active-Timer

Profile

?Process-Profile

The Change Module

Button SDL Target Tester command

Set Timer

Set-Timer

Reset Timer

Reset-Timer

Create

Create

Stop

Stop

Nextstate

Nextstate

Remove Q

Remove-Queue

Remove S

Remove-Signal

Remove all S

Remove-All-Signals

Scale Timers

Scale-Timers

The Configure Text Trace Module

Button SDL Target Tester command

ON

Display-On

OFF

Display-Off

Detail Level

Tr-Detail

Show Params

Tr-Params 1

Hide Params

Tr-Params 0

The Configure Target Trace Module

Button SDL Target Tester command

ON

Tr-On

OFF

Tr-Off

Signal

Tr-Signal

Process

Tr-Process

NO Symbols

Tr-Process * B'00000000000000000000000000000000'

ALL Symbols

Tr-Process * B'111111111111111111111111111111111'


The SDL & MSC Trace Module

Button SDL Target Tester command

Start MSC

Start-MSC-Log

Stop MSC

Stop-MSC-Log

Start SDL

Start-SDLE-Trace

Stop SDL

Stop-SDLE-Trace

The File Trace Module

Button SDL Target Tester command

Binary Infile

Input-File

Binary Outfile

Output-File

Close binaries

Close-File

ASCII Outfile

Start-Trace-Log

Close ASCII

Stop-Trace-Log

Page File

Page-File

Convert File

Convert-File

The Recorder Module

Note:

The SDL Target Tester's Record and Play functions are only available if a Cmicro Recorder license is available.

Button SDL Target Tester command

Recorder off

Recorder-Off

Record

Recorder-On

Play

Recorder-Play

Delay

Recorder-Delay

Real-time

Recorder-Realtime

Input recfile

Input-File recfile.trc

Output recfile

Output-File recfile.trc

Close recfile

Close-File recfile.trc

The Systemcontrol Module

Button SDL Target Tester command

Single-Step

Single-Step

Next-Step

Next-Step

Exit-Single-Step

Exit-Single-Step

Reinit

Reinitialize

Shutdown

Shutdown

Resume

Resume

Disable Timer

Disable-Timer

Enable Timer

Enable-Timer

Suspend

Suspend

The Breakpoint Module

Button SDL Target Tester command

Break input

BPI

Break nextstate

BPS

Break all

BP

View Breakpoints

?Breaklist

Clear all

BA

Continue

Continue

The Configuration Module

Button SDL Target Tester command

Unit scale

Unit-Scale 1.0

Unit name

Unit-Name "milliseconds"

Target

Get-Configuration

The Communication Module

Button SDL Target Tester command

Start Gateway

Start-Gateway

Coder Config

?Coder

Interface State

Line

The Menu Bar

This section describes the menu bar of the SDL Target Tester main window and all the available menu choices in the default configuration.

The menu bar contains the following fixed menus:

The menu bar can also contain additional menus listed in a menu definition file (see Button and Menu Definition File). The following menus are defined in the delivered version of this file:

File Menu

The File menu contains the following menu choices

Set Directory

This menu choice opens a dialog where you can enter the path to your current project directory.

View Menu

The View menu contains the following menu choices:

Find

This menu choice opens a dialog where you can search for text.

Figure 609 : The Find dialog

It is possible to use regular expressions for finding text or to select to find a process, signal or timer belonging to the SDL system.

Find Next

This menu choice will search again for text already found.

Find Selection

This menu choice will search for text currently selected in the SDL Target Tester's text area.

Copy from Text Area

This menu choice will copy the text selected in the SDL Target Tester's text area.

Paste into Command Line

The menu choice will paste the content of the clipboard to the command line.

Line Numbering

This menu choice toggles line numbering in the SDL Target Tester's text area. Line numbering allows a better overview.

Clear Text Area

This menu choice will clear the complete text area of the SDL Target Tester.

Buttons Menu

The Buttons menu contains the following menu choices:

For more information on the UI's button definition file, mentioned in the menu commands below, see Button and Menu Definition File.

Load

This menu choice opens a dialog where you can specify a new button definition file. This will override the current button definitions. All buttons and modules currently in the button area are deleted and replaced by the buttons and modules defined in the new file.

Append

This menu choice opens a dialog where you can specify to append the contents of a new button definition file into the current button definitions. Buttons with new labels are added to the button area, while buttons with already existing labels in the same module will be duplicated (possibly with different definitions).

Save

This menu choice saves the current button and module definitions in the button definition file under its current file name.

Save As

This menu choice opens a dialog where you can save the current button and module definitions in a new button definition file.

Expand Groups

This menu choice expands all modules in the button area.

Collapse Groups

This menu choice collapses all modules in the button area.

Add Group

This menu choice opens a dialog where you can specify the of a new button module to add. The new module will be added after the last module in the button area. It is also possible to add several modules.

Execute Menu

Item SDL Target Tester command

Start Gateway

Start-Gateway

Go-Forever

Go-Forever

Single-Step

Single-Step

Reinit

Reinitialize

Disable-Timer

Disable-Timer

Next-Step

Next-Step

Shutdown

Shutdown

Enable Timer

Enable-Timer

Exit-Single-Step

Exit-Single-Step

Resume

Resume

Suspend

Suspend

Environment Menu

Item SDL Target Tester command

Send with params

Output-PAR

Send without params

Output-NPAR

Breakpoint Menu

Item SDL Target Tester command

Break Input

BPI

View Breakpoints

?Breaklist

Break Nextstate

BPS

Clear all

BA

Break all

BP

Continue

Continue

Examine Menu

Item SDL Target Tester command

Queue

?Queue

Timers

?Timer-Table

Active

Active-Timer

Process

?Process-State

Process List

?All-Processes

Profile

?Process-Profile

Last Error

?Errors

Change Menu

Item SDL Target Tester command

Set Timer

Set-Timer

Stop

Stop

Remove Signal

Remove-Signal

Reset Timer

Reset-Timer

Nextstate

Nextstate

Remove all S

Remove-All-Signals

Create

Create

Remove Q

Remove-Queue

Scale Timers

Scale-Timers

Trace Display Menu

Item SDL Target Tester command

Display on

Display-On

Display off

Display-Off

Trace Detail

Tr-Detail

Show Params

Tr-Params 1

Hide Params

Tr-Params 0

Start MSC

Start-MSC-Log

Stop MSC

Stop-MSC-Log

Trace File Menu

Item SDL Target Tester command

Binary Infile

Input-File

ASCII Outfile

Start-Trace-Log trace.asc

Page File

Page-File

Binary Outfile

Output-File

Close ASCII

Stop-Trace-Log

Convert File

Convert-File

Close Binaries

Close-File

Trace Target Menu

Item SDL Target Tester command

Trace on

Tr-On

Trace off

Tr-Off

Trace Process

Tr-Process

Trace Signal

Tr-Signal

Recorder Menu

Item SDL Target Tester command

Recorder off

Recorder-Off

Delay

Recorder-Delay

Output recfile

Output-File recfile.trc

Record

Recorder-On

Realtime

Recorder-Realtime

Close Recfile

Close-File recfile.trc

Play

Recorder-Play

Input recfile

Input-File recfile.trc

Config Menu

Item SDL Target Tester command

Unit scale

Unit-Scale

Unit name

Unit-Name

Target

Get-Configuration

Coder-Config

?Coder

Interface state

Line

Commands Menu

Item SDL Target Tester command

Quick Info

Help

Info

Help *

Remove cmd

Remove-Command

Button and Menu Definition File

In the SDL Target Tester UI, the button definition information is stored on file (per default this file is named sdtmt.btn), i.e. definitions of button groups and button commands in the main window's button area. Furthermore it is possible to define menu entries.

At start-up of the UI, the file is determined in the following way. If the file name does not contain a directory path, the files are searched for in the following directories:

Once the file has been found, it is read and the contents of the corresponding window is set up. If the file cannot be found, the corresponding window area becomes empty and a file selection dialog is opened to enter the required file name.

The text file can contain comment lines starting with the `#' character. Empty lines are discarded.

Note:

When a file is read, no checks are made upon the relevance or correctness of the definitions contained in the file.

Button and Menu Definitions

The button and menu definitions are stored in a definition file with the default extension .btn. The definitions are divided into groups where each group defines a button module in the main window's button area or a menu in the menu bar.

Syntax

In the file, a button group has the following syntax:

:[DISPLAY_AS] <entry name>
<item label>
<definition>
<button label>
<definition>
  . . .

The [DISPLAY_AS] prefixes the button group's or menu's name <entry name> and can take three different keywords:

The <item label> is either the label of the button in a button module or the label of an menu item.

The <definition> is the SDL Target Tester command that will be executed when the button is pressed/the menu item is selected. The syntax of a button definition is the same as when entering a command textually to the monitor.

Missing parameters at the end of the command will open dialogs for those parameters.

After all there is no limit in the amount of buttons in a button group or the amount of items in a menu entry except the visibility and usability of the buttons/items.

Comparing with the Simulator there is a simple rule of ordering the buttons shown in Figure 610. A new button row is added only if the previous row has got 3 buttons.

Figure 610 : Ordering of the buttons in a button group


http://www.ibm.com/rational
Contents Index Previous Next