![]() |
![]() |
![]() |
![]() |
![]() |
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).
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:
- Parameter values of enumeration type are presented in lists, from which the value can be selected (see Figure 606).
- 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
Each button module consists of a title bar and a number of command buttons arranged in rows and columns. The title bar displays:
- A collapse/expand toggle button. Click this to collapse (so that only the title bar is visible) and expand the module.
- The group name of the button module.
- A Group button, providing a menu with commands affecting the buttons in the module.
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.
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.
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.
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.
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
The Execute Module
The Examine Module
The Change Module
The Configure Text Trace Module
The Configure Target Trace Module
Tr-Process * B'00000000000000000000000000000000'
Tr-Process * B'111111111111111111111111111111111'
The SDL & MSC Trace Module
The File Trace Module
The Recorder Module
The SDL Target Tester's Record and Play functions are only available if a Cmicro Recorder license is available.
Input-File recfile.trc
Output-File recfile.trc
Close-File recfile.trc
The Systemcontrol Module
The Breakpoint Module
The Configuration Module
Unit-Scale 1.0
Unit-Name "milliseconds"
The Communication Module
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:
- File Menu
- View Menu
- Buttons Menu
- Help Menu
(See Help Menu.)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:
- Execute Menu
- Environment Menu
- Breakpoint Menu
- Examine Menu
- Change Menu
- Trace Display Menu
- Trace File Menu
- Trace Target Menu
- Recorder Menu
- Config Menu
- Commands Menu
File Menu
The File menu contains the following menu choices
- Open
(See Open.)- Set Directory
- Exit
(See Exit.)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
- Find Next (F3)
- Find Selection
- Copy from Text Area
- Paste into Command Line
- Line Numbering
- Clear Text Area
Find
This menu choice opens a dialog where you can search for text.
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
Environment Menu
Breakpoint Menu
Examine Menu
Change Menu
Trace Display Menu
Trace File Menu
Start-Trace-Log trace.asc
Trace Target Menu
Recorder Menu
Output-File recfile.trc
Close-File recfile.trc
Input-File recfile.trc
Config Menu
Commands Menu
Help *
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.
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:
- COLLAPSED
A button group is created, initially collapsed.- No keyword
A button group is created, initially expanded.- MENU
A new menu is created.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.
http://www.ibm.com/rational |
![]() |
![]() |
![]() |
![]() |