68k System
68k System
68k System
ii Full Release
Modification Record
General SWM0023-1.00 -2
Full Release iii
iv Full Release
Index
vi Full Release
Overview
Introduction The 68K Monitor is a feature of all GE Energy Services products that use a variant
of the Motorola 68000 series of microprocessor.
Since the introduction of the first D20 products, the commands that are available in
the 68K Monitor have changed, been added to, and enhanced to address the
requirements of the newer products and their software components.
This guide summarizes all of the commands that you will find in any of GE Energy
Services’ products to-date. You will see in the next chapters that not all commands
are available in all products. Some commands exist only for product and software
development, and are not found in end-user products.
In This Section This section of the document contains the following topics
General SWM0023-1.00 -2
Full Release vii
Job Titles While only experienced programmers should use many of the commands found in
this guide, maintenance technicians and other support personnel will also find this
guide useful.
Experience & GE Energy Services’ customers and employees who wish to view detailed
Abilities information about the software and hardware should use this guide.
Prerequisites This document assumes that you are familiar with software and programming
terminology and practices, and have some knowledge of both the hardware and
software.
What This This guide covers the commands found in the 68K Monitors that run on these
Document platforms:
Provides
• CPM running CPM Base
• D20 running D20 Base software
• D20 with D20 ME running D20 Base software
• D20 and D200 using CCU Base software
• D20 and D200 with D20 ME processors running CCU Base
• D25
Notes will show where a command or feature is unique to a specific platform.
This guide is a user reference for the 68K Monitor. It describes in detail the contents
and usage for each available user command. These commands are useful for testing
and debugging hardware and software as they provide a means for controlling the
system environment at a very low level.
The functions provided by 68K Monitors enable you to alter and manipulate the
! system at a very low level. At this low level, it is easy to seriously disrupt an
operational system.
WARNING
You must be aware of this possibility at all times.
What This There are no procedures in this document as users should already be familiar with
Document Does accessing and using GE Energy Services’ WESMAINT and monitor maintenance
Not Provide. facilities.
Document Style This manual uses the Systeme International (SI) and the Microsoft Manual of Style as
and Convention a basis for styles and conventions.
Rules
General GE Energy Services provides professional assistance in the use of all of its software
and hardware products.
Need Help? If you feel that the information provided in this document is unclear or in error,
please contact GE Energy Services for assistance.
Website http://www.gepower.com/geharrisenergy/
Unlimited access is available to a wide variety of information and company services
including:
• product information
• training and,
• technical services.
Technical Representatives are available Monday through Friday, 8:00 a.m. to 5:00 p.m.
Support Mountain Time.
General SWM0023-1.00 -2
Full Release ix
x Full Release
Overview
Connect Defined An application interface provides an input to and output from the 68K Monitor.
This allows the 68K Monitor to ‘connect’ to any application or subsystem, and to
any type of hardware (capable of stream or block transfers).
As examples:
• WESMAINT or the Login Process can connect the 68K Monitor to a serial port.
• WESMAINT and the TELNET application can connect it to the TELNET
session.
The 68K Monitor can also be ‘connected’ to a file system to receive (read)
commands from a file and send (write) responses to another file.
In This Chapter This Chapter of the document contains the following topics
General SWM0023-1.00 -2
Full Release 1-1
One 68K While any application running in the system can activate the 68K Monitor, only one
Monitor At-A- instance of the monitor can be active at any one time.
Time
If a second application attempts to start the 68K Monitor, it will refuse the second
application’s request.
68K Monitor The prompt produced by the 68K Monitor depends on the hardware platform and
Prompts the mode the device is in.
As examples:
Examples The table below shows examples of the prompts that you may see on various devices
in different modes of operation.
Terminating a The 68K Monitor will detect a loss of connection in a TELNET session and will end
68K Monitor the monitor session, allowing a new connection to be established.
TELNET Session
The 68K Monitor itself never terminates or initiates a TELNET session. Whatever
process starts the 68K Monitor handles this functionality.
Auto-Logout Since only one 68K Monitor session is allowed at a time, it automatically terminates
Timer a session if no input is received for 5 minutes (default) or after a user-programmed
interval.
Refer to: Page 3-4, AL - Change Auto-logout Timer for details about how this timer
can be changed.
Input to the 68K Input to the 68K Monitor is read from the ‘connected’ application / subsystem. The
Monitor input takes the form of user-entered commands.
Where:
• command_name is one of the recognized commands, and
• parameter arguments are an optional list of command parameters.
Common You must format these commands in a definite way or syntax. You must understand
Command command syntax to understand detailed command descriptions in the following
Syntax chapters.
List of This tables lists some of the characters used in command syntax:
Characters
Character Name Description
/ switch identifies that the character following it affects
the type of processing performed by the
command
[] square brackets any arguments listed within them are optional
parameters that the command may use but does
not require
| OR symbol only one of several consecutive arguments listed
within parenthesis “( )” is to be used
() multiple when not separated by the OR “|” character
arguments means that if one of the arguments is used, they
must all be used
General SWM0023-1.00 -2
Full Release 1-3
Possible By entering a command at the prompt and pressing ENTER, one of the following
Responses responses will happen.
Entering The 68K Monitor allows editing of the command line by using regular keyboard
Commands input as well as a few special key combinations.
Regular In addition to entering any printable ASCII character onto the command line, the
Keyboard Input following characters can be used:
Special Control You can use these special control characters to perform advanced editing and screen
Characters navigation functions.
General SWM0023-1.00 -2
Full Release 1-5
Output from the The 68K Monitor’s output is a stream of ASCII characters written back to the
68K Monitor ‘connected’ application / subsystem. The command executed determines the exact
contents of the output.
When encountering a system exception error, or a defined breakpoint, exception and
breakpoint handling routines will generate additional output.
Display Output While most output to the monitor port is a direct result of command input, some
occurs asynchronously of the command input.
This requires the use of two methods of output display.
• The first method uses the monitor-input process, which formats the output into
a common buffer and signals the output process that data is available.
− All output that occurs synchronously with the input uses this method,
including command data and input line display.
• The second method uses exception-handling routines to display data that may
or may not occur as the result of a monitor command, but cannot be expected to
occur synchronously with the input.
− A pSOS exchange sends this data (including unassigned exception and
breakpoint data displays) to the output process.
An Example: Once a breakpoint is set, the monitor cannot control when or if the system encounters
the breakpoint.
The exception and breakpoint display output may occur at any time, and this output
has priority over monitor input process output. This may cause occasional
interruption of a command or input in progress, or the lack of a prompt re-appearing
after displaying the data, but does not affect these functions in any way
Error Messages
Introduction 68K Monitor returns several general error messages resulting from input or syntax
errors in the command input, or system or test failures during execution.
These error messages are identified below:
Message The most general error is an incorrect number of arguments for the command
Summary defined. This error causes a display of the correct use of the specified function.
Other possible error messages are listed below:
General SWM0023-1.00 -2
Full Release 1-7
If You Find Using the 68K Monitor it is possible to modify or change something in a device’s
Yourself in system that can seriously disrupt the operation of the device
Serious
Trouble... Use this procedure to restore the RTU to its former state, before you used the 68K
Monitor facility to make changes.
Step Action
1. Suspend all processes in the RTU.
2. Fill the NVRAM memory with zeros.
3. Re-download your configurations and/or Flash code.
4. Reboot the RTU.
Overview
Seven Groups The 68K Monitor commands are grouped into seven groups.
The following pages list the commands in each of the groups, and provide a
functional cross-reference to help you locate them in this guide.
In This Chapter This Chapter of the document contains the following topics
General SWM0023-1.00 -2
Full Release 2-1
Description This group of commands is essentially a list of unrelated commands that do not
logically fit into the other command groups.
List of This list shows the General System commands, in alphabetical order:
Commands
Diagnostic Commands
Description You can use these diagnostic commands for debugging, performance analysis and
hardware system testing.
General SWM0023-1.00 -2
Full Release 2-3
Memory Commands
Description Use these memory commands to identify or change the contents of memory in the
system.
Because executing these commands modifies the memory of your system, they can
! disrupt operation.
WARNING Use caution before proceeding.
Process Commands
Description Use these commands to examine and alter the state of pSOS processes.
Note: Some of these functions must only used for testing and debugging during
software development.
General SWM0023-1.00 -2
Full Release 2-5
Exchange Commands
Description Use these commands to examine and alter pSOS exchange data in the system.
Note: Use these functions primarily for testing and debugging purposes during
software development.
Breakpoint Commands
Description Use these commands with the 68K Monitor for control and display of process
breakpoints in the system.
The three restrictions with the definition of breakpoints are:
• You must define breakpoints in code that is in RAM.
− The program instruction changes to a 68000 family TRAP instruction.
• You must define all program breakpoints at the beginning of an instruction.
• Only define breakpoints in a process.
− If the interrupt mask is non-zero when you enter the breakpoint handler, the
assumption is that the calling routine is an interrupt service procedure (ISP)
and breakpoints are not valid.
General SWM0023-1.00 -2
Full Release 2-7
List of This list shows the Configuration Maintenance commands, in alphabetical order:
Commands
Overview
Introduction This Chapter is divided into two sections, the first providing a cross-reference table
where you can see which platform support what commands.
The second section details each command, listed in alphabetical order.
In This Chapter This Chapter of the document contains the following Sections and topics
General SWM0023-1.00 -2
Full Release 3-1
Platform-Specific Commands
List of This table lists all of the possible 68K Monitor commands in the left column, in
Commands alphabetical order. The columns to the right show the platforms where the
commands will be available for you to use.
Some of the commands, such as CAL and KIM, are not checked-off for any platform.
Note K This indicates that these commands are only available when specially built
engineering or debugging software is running in the device.
General SWM0023-1.00 -2
Full Release 3-3
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to change the monitor’s auto-logout timer duration from the
default of 5 minutes.
Platform
o CPM
o D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to change the data rate of the WESMAINT port to a user-
configured value.
About Changing The 68K Monitor has the ability to change the communication speed of the D25 and
the Baud Rate D20 ME WESMAINT ports. This is useful when downloading large files.
Example: A 1 M code file may take upwards of 40 minutes to download at 9600 bps
(the default). At 38400 bps, only 10 – 15 minutes.
Note: Most PCs cannot exceed 115,200 bps, and some terminal programs
(Windows Terminal for example) may have other restrictions. Check the
respective program's User's Guide for help.
The system will not save speed changes made using this command in NVRAM.
! The monitor will return to 9600 bps after a restart.
WARNING 1 If you execute this command in a D25 monitor, it will modify the data rate of both
the WESMAINT and the D25MAINT ports, since they run off the same data rate
generator.
GE Energy Services recommends that you use this command only to speed up a
serial download, and not to redefine the operational state.
Enter the baud rate correctly, as the function is capable of setting the data rate
! to any value.
WARNING 2 Example:
Forgetting to enter the final zero when trying to change the data rate
to 19200 bps would result in a rate of 1920 bps, preventing any
further communication. A reboot will return the speed to the 9600
bps default.
General SWM0023-1.00 -2
Full Release 3-5
BOOT - Startup
-
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to remove all defined Monitor breakpoints and then force the
system to go through its lowest level start-up.
This ensures that the system is properly re-initialized after testing, system
manipulating, or downloading.
General SWM0023-1.00 -2
Full Release 3-7
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base o D25
Description Use this command to enable and disable the CPU’s cache.
CAL - Calibrate KI
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
General SWM0023-1.00 -2
Full Release 3-9
CB - Clear Breakpoint
Platform
þ CPM
þ D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to clear breakpoints that are currently set.
• By specifying a breakpoint number, this command clears that breakpoint.
• By not specifying a breakpoint, it clears all defined breakpoints.
Breakpoints are cleared by:
1. replacing the 68000 family TRAP instruction with the original instruction, and
then
2. clearing the entry in the breakpoint table
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to modify the configuration file attributes for a given
configuration file.
Overwrites the old attributes with the new attributes.
General SWM0023-1.00 -2
Full Release 3-11
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to create the configuration storage block at a specified location or
allocate it out of RAM.
The amount of memory space allocated to configuration storage and other relevant
parameters are also required.
• The Monitor invalidates any existing storage block before creating the new one.
− If requested to make the block in NVRAM, the command assumes it to be a
part of a static configuration storage region and will simply use the memory
as specified (base address and size).
− By specifying RAM, the monitor expects the block to be temporary, and
allocates memory out of normal pSOS RAM.
! Any existing stored configurations will be lost when this command is invoked!!!
WARNING
Parameters (continued)
General SWM0023-1.00 -2
Full Release 3-13
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
CF - Copy File
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to copy file information from one file to another.
Primarily, use the command to transfer files containing configuration, application
FLASH and DSP FLASH program data into their destination regions.
Also, use it to copy any one file to another, depending on the support for copying
provided by the File System Driver that owns the files.
General SWM0023-1.00 -2
Full Release 3-15
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
CP - Change Priority
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to change the current priority of an existing process.
General SWM0023-1.00 -2
Full Release 3-17
CS - Check Sum
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to perform a checksum or 32-bit CRC of either the boot code
area, NVRAM area, or application code area.
D - Dump Memory
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display memory contents as bytes, words, long words, floating-
point numbers, or double-precision numbers.
Each line of output is formatted as:
at the left margin:
− starting address of the memory, hexadecimal.
then:
− 16 bytes (octets) of data grouped as:
General SWM0023-1.00 -2
Full Release 3-19
Syntax (continued)
DB - Define Breakpoint
Platform
þ CPM
þ D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to activate a breakpoint in a section of code located within RAM.
At the specified address, the command saves 68000 family instruction in the
breakpoint table and replaces it with a TRAP instruction. When a process reaches the
TRAP instruction, it traps into a breakpoint handling routine, which displays a
message indicating that it encountered a breakpoint.
The 68K Monitor allows up to ten active breakpoints.
General SWM0023-1.00 -2
Full Release 3-21
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to put the D25 into Debug Mode.
This mode disables certain checks in the system so that it will ignore small system
violations during debugging sessions (such as allowing the writing of FLASH code
to RAM during a download).
In this mode, you can make making changes to the base address and size of the
SRAM, NVRAM and FLASH regions in the NVRAM configuration header.
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to display the contents of any file in memory in text or binary
format.
The default is binary format, which mimics the dump command by displaying the
binary values first, then the printable ASCII values afterward.
You may view any file recognized by the Installable File System.
General SWM0023-1.00 -2
Full Release 3-23
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to display information on the hardware configuration of the D25.
The provided information consists of:
• size and base address of all memory regions
• DSP and XCOM type
• state of the auxiliary output and sysfail signal, and
• EPLD and PCB revision numbers.
DIR - Directory
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display a directory of the database tables residing in a specified
memory type. Database table information consists of:
name - table name
address - the absolute table memory address
records - the number of valid records in the table
record size - the size, in bytes of each record
General SWM0023-1.00 -2
Full Release 3-25
Syntax (continued)
DL - Download
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to download data (typically configuration files (all platforms) or
D25 and CCUME application (FLASH) code).
Note: When downloading application code files, this command must be used only
when executing from the BootROM. This will be indicated by the D25A>,
or the D20MEA> prompts for the D25 or D20ME-based systems,
respectively.
The Monitor accepts S1, S2 and S3 data records, and S7, S8 and S9 end records, and
optional S0 comment records in the downloaded file. The monitor rejects all other
types of records.
Once the command verifies the checksum within the record, the contents of data
records (S1, S2 or S3) are stored in memory. When it receives an S7, S8 or S9 end
record, the DOWNLOAD command returns control to the Monitor’s command line.
Executing this command modifies the memory of the system, and can cause
! operational disruption.
WARNING Use caution before proceeding.
General SWM0023-1.00 -2
Full Release 3-27
DM - Debug Mode
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to view status of file copy command progress and success.
General SWM0023-1.00 -2
Full Release 3-29
E - Edit Memory
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display and modify memory locations. The command does not
verify memory contents after they are stored. After entering the command, it
prompts you with the current contents of a memory location.
The different display and edit formats supported are:
• bytes − hexadecimal format
• words − hexadecimal format
• floating-point numbers − hexadecimal format
• scientific format − scientific format
• double-precision numbers − scientific format
Syntax (continued)
General SWM0023-1.00 -2
Full Release 3-31
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to turn command line echoing on and off.
It only affects the 68K Monitor’s echoing of user-entered keystrokes, and not the
results of any commands.
EL - Error Log
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display and delete system error log entries stored in NVRAM
for a single or multi-processor system.
The display command also presents the current system state, and any significant low-
level system errors which occur.
The delete function deletes system error log entries from memory, and clears the
disabled state if the system is in a disabled state.
General SWM0023-1.00 -2
Full Release 3-33
Platform
o CPM
o D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Note: this command is available only when executing from the BootROM. This
will be indicated by the D25A>, or the D20MEA> prompts for the D25 or
D20ME-based systems, respectively.
Use this command to perform an erase of the Flash memory region, resetting all
bytes in Flash to 0xFF in preparation for application data download.
Executing this command modifies RTU memory and will cause operational
! disruption (specifically by destroying all Flash application code).
WARNING Do not use this command unless you are prepared to perform a code download
procedure.
Use caution before proceeding.
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Description Use this command to change the Ethernet address of a D25’s hardware interfaces.
General SWM0023-1.00 -2
Full Release 3-35
EXIT - Exit
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to perform a limited clean up of the 68K Monitor, and return to
the calling routine (such as WESMAINT) if it has not been suspended.
F - Fill Memory
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to repeatedly write a value to a specified region of memory.
The command requires three numerical arguments in hexadecimal format:
• first is the starting address of the region to fill
• second is the ending address of the region
• third is the value to write to the memory region
The fill value may be a byte (octet), a word, or a long word, depending on the mode
selected by the switch.
General SWM0023-1.00 -2
Full Release 3-37
FT - Find Table
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to search available Database Manager resources to obtain the
address and number of records in a database table within the database management
system.
HE or HELP - Help
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display a list of all available monitor commands on the screen,
or a description and usage for a given specific command.
General SWM0023-1.00 -2
Full Release 3-39
HT - HDLC Test
Platform
o CPM
þ D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base o D25
Description Use this command to transmit specific application messages over the HDLC
communication link.
Note: Because you must assemble these messages by hand, you can not use the
command effectively unless you know the protocol used by the D.20
application.
Platform
o CPM
o D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display information on the BootROM, FLASH, and NVRAM
configuration images.
The information consists of:
For the BootROM and FLASH images, a description string and a part number;
For the NVRAM configuration, the static CRC and configuration version.
Note: If any of this information is not available, the monitor will display a
message indicating this in place of the expected information.
Because the IMG command only displays information entered into the
MODULE.MAK file used in the SDS system, any omissions or mistakes in
the MAK file will be reflected in the output of this command.
General SWM0023-1.00 -2
Full Release 3-41
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
This command causes the D25 to shift into active mode immediately, without
! performing any checks on FLASH.
WARNING Be sure that your FLASH region contains valid application data before invoking this
command.
JX - Jam Exchange
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to force a message to the beginning of the message queue at one
or more exchanges.
General SWM0023-1.00 -2
Full Release 3-43
KIM - KI Metrics
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
M - Move Memory
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to copy memory from one memory region to a writeable memory
region.
It requires three hexadecimal quantities, which define the:
• source address
• destination address, and
• number of bytes to transfer
General SWM0023-1.00 -2
Full Release 3-45
PB - Print Breakpoint
Platform
þ CPM
þ D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display breakpoint information about any or all-active
breakpoints in the system.
While the system suspends a process at a breakpoint, this instruction causes the
display of the suspended process ID and the register values when it encounters the
breakpoint. These values differ from those printed with the query process command,
as the latter prints the values at the time of the last process swap.
PR - Profile
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display run-time statistics of all processes in the system,
including:
• the number of times the process was swapped in
• the number of system real-time clock ticks occurring during its run periods
• the average number of ticks (in tenths of a tick) per run (average)
• the CPU usage (in 10ths of percent) of the process
• the maximum period between watchdog process operations.
General SWM0023-1.00 -2
Full Release 3-47
PR - Profile, Continued
Syntax (continued)
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base o D25
General SWM0023-1.00 -2
Full Release 3-49
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display the contents of the configuration storage block,
providing information such as:
• how many configurations are stored in the system
• how much memory is allocated to configuration storage, and
• the creation time and date of the stored configurations.
The number used to identify each file in this display is the file index.
Note K
The system uses this number to identify the file affected by the clear configuration
file, change configuration file attributes, and select active configuration commands.
Command Format qc
Variables None
Parameters None
Example Type qc and press ENTER.
QP - Query Process
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
General SWM0023-1.00 -2
Full Release 3-51
Syntax (continued)
Current Run This table lists the states that the processes may be in at any time:
State
QR - Query RAM
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to examine the RAM allocation and use for either static RAM or
NVRAM.
The Command displays:
• the memory block sizes
• whether they are used, and
• the total size of available free memory.
The command also queries the global memory RAM if in a multi-processor system.
General SWM0023-1.00 -2
Full Release 3-53
QX - Query Exchange
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Syntax (continued)
General SWM0023-1.00 -2
Full Release 3-55
RB - Resume Breakpoint
Platform
þ CPM
þ D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to restart a process that stopped at a breakpoint, without removing
the breakpoint.
It verifies the specified breakpoint, restarts the associated process, and then reinserts
the breakpoint trap.
RP - Resume Process
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to restart all processes, some processes, or a specific suspended
process.
Use this command to restart processes that have been suspended using the suspend
process (SP) command.
General SWM0023-1.00 -2
Full Release 3-57
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display information on the RAM divisions currently configured
in the system.
• On a D25 platform, this command reports the base addresses of the RAM and
NVRAM regions, and the size of the NVRAM region.
• On a D200 platform, this command reports the base addresses of the global
RAM and global NVRAM regions, and the size of the global NVRAM region.
In either case, the monitor reports total amount of free RAM.
Command Format rr
Variables None
Parameters None
Example Type rr and press ENTER.
RT - RAM Test
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to perform a non-destructive read-write test of specified RAM
memory.
The test may be for the entire RAM or NVRAM regions, or for a specified range of
values. You may also select to run the test for a set number of loops, or to loop
infinitely.
Note: If the input range is not on long word boundary, set the range ending
address to the first lesser word boundary.
General SWM0023-1.00 -2
Full Release 3-59
Syntax (continued)
Special If you enable the Debug Mode, the function can be CPU
Considerations intensive, and could cause a system reset under these
circumstances.
You cannot use this function when the NVRAM is corrupt.
Do not use the /s switch on a D25.
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
Description Use this command to place the device in System Service Mode. When you issue the
command, the system stops executing out of the FLASH region, and it activates the
BootROM operating system.
The primary use of this mode is for the downloading of FLASH application software
to the RTU.
General SWM0023-1.00 -2
Full Release 3-61
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Description Use this command to test the RTC synchronization between nodes in a D200.
RX - Request Exchange
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to retrieve a message from one or more exchanges.
It returns the first message in each target message queue.
General SWM0023-1.00 -2
Full Release 3-63
RZ - ZMODEM Download
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Description Use this command to download configuration and application data over the serial
port into RAM or FLASH. The 68K Monitor accepts a transfer of ZMODEM
binary data to the D25 initiated either by the D25 user or by the sending terminal.
When the transfer is complete, the DOWNLOAD command returns control to 68K
Monitor’s command line.
Application code download only works when:
• executing from the BootROM, and
• the monitor has erased the FLASH region.
While the command downloads the file, it recognizes the ZLIB format of the
compressed data and uncompresses it.
Executing this command modifies the memory of the D25, and can cause operational
! disruption.
WARNING Use caution before proceeding. Be sure that you really want to use this command
and that you use it correctly.
When using ZMODEM, all files sent to the 68K Monitor must have file names.
Note K
The file name for a FLASH image must start with “PROM”. The file name for a
ZLIB compressed image must end with the extension “.ZLB”.
The name in these cases is case insensitive (i.e. “prom” and “.zlb” are acceptable as
well). The monitor assumes that any other names are non-compressed NVRAM
configuration data.
Since there is no addressing inherent in ZMODEM data, you must change the
location of NVRAM in any existing configuration before downloading if you want to
change the NVRAM header address.
General SWM0023-1.00 -2
Full Release 3-65
SA - Serial Analyzer
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to monitor communications on one of the defined serial ports
(other than the assigned 68K Monitor port).
It uses serial I/O system transmit and receive call-outs to intercept all
communications on the channel.
Error Codes If any of the following receiver errors are detected, these codes are displayed:
− over-run errors OV
− parity errors PA
− framing errors FR
− detected breaks BR.
Display Format The monitor displays all data transmitted and received in hexadecimal format.
Transmit data is displayed in inverse video; receive data is normal video mode.
Buffered Data The serial analyzer does not display data immediately. It buffers the data so that the
serial analyzer remains non-intrusive. The buffer is large enough (1000 bytes) that
overflow is unlikely. If the buffer does overflow, however, the indication provided
is:
buffer overflow
The monitor discards incoming data as long as the buffer is in the overflow state. It
does not destroy the current buffer contents.
General SWM0023-1.00 -2
Full Release 3-67
SB - Step Breakpoint
Platform
þ CPM
þ D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to single step a process that was suspended at a breakpoint.
It also allows executing multiple program steps in a single command.
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to select one of the stored configurations as the active
configuration.
The system is halted and the stored configuration is uncompressed (if necessary) and
written into NVRAM (local on the D25, global on a D200) as the new configuration.
The selected configuration file is marked as the active configuration.
Note: Upon completion, the Monitor leaves the system halted so that you can
restart the system with the new configuration.
General SWM0023-1.00 -2
Full Release 3-69
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display information on the hardware, software and current
configuration of the device.
Command Format si
Variables None
Parameters None
Example Type si and press ENTER.
General SWM0023-1.00 -2
Full Release 3-71
SP - Suspend Process
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to stop all unprotected processes, some unprotected processes, or
a specific unprotected process.
Use this command to stop all processes before CPU-intensive operations, for
example, an NVRAM download.
Protected processes must remain running at all times. Protected processes include:
• MON monitor input process
• MOUT monitor output process
• WDOG watchdog process
• ROOT root process
• IDLE pSOS idle process
• LGIN boot login process (in some cases)
• iSCS processes, including B100 and file managers.
Syntax (continued)
General SWM0023-1.00 -2
Full Release 3-73
ST - Serial Test
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to start one of these two serial port test procedures:
• an automatic loop-back test of the defined serial port
− transmits and receives a series of characters of different formats.
• manually forcing the mark or space line states from the RS-232 drivers
− allows you to monitor and adjust modem levels or frequencies.
Loop Test The automatic loop-back test requires this DB-9 pin loop-back connector:
Adapter
DCD 1 ────┐
RXD 2 ──┐ │
TXD 3 ──┘ │
RTS 7 ────┤
CTS 8 ────┘
Selectable Data The command used in CCU-based and D25 products allows you to select the data
Rates rate for the loopback test.
Supported data rates in bps are:
50 110
134 200
300 600
1050 1200
2400 4800
7200 9600
38400
The command has failed when used for stress testing. Do not use the serial test for
! that purpose!
WARNING You must only use it to verify the device driver for the communication port.
General SWM0023-1.00 -2
Full Release 3-75
SX - Send Exchange
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
SYSC - System
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base þ D25
General SWM0023-1.00 -2
Full Release 3-77
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to activate a test tool external to the monitor.
To use a test tool, the test tool application must:
• be included in the software for the system, and
• be created specifically to make use of this monitor function.
The 68K Monitor relinquishes communications control to the test tool and waits for
the tool to complete its processing before continuing.
TR - Trace
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Description Use this command to track the execution sequence of the processes in the system.
General SWM0023-1.00 -2
Full Release 3-79
TR - Trace, Continued
Syntax (continued)
UL - Upload
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base o D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to retrieve an S-record from the device’s memory.
General SWM0023-1.00 -2
Full Release 3-81
VER - Version
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to display the Base System and pSOS versions, plus any
application version and embedded image information. On the D25, the monitor will
also display the BootROM version.
The provided information consists of:
name - application or embedded image name
version - image version number
level - image compilation level
target - hardware target (i.e., D20M++, D25, D25_FF)
date - image compilation date and time
Results: The monitor displays at least the boot code and pSOS
version information and returns to the prompt.
Special None
Considerations
VP - Signal Process
Platform
þ CPM
þ D20
D20 Base þ D20 ME
D20 Base þ D20/200
CCU Base þ D20/200 ME
CCU Base þ D25
Description Use this command to send a pSOS signal to one or several processes. Use it during
development of application software.
General SWM0023-1.00 -2
Full Release 3-83
Platform
o CPM
o D20
D20 Base o D20 ME
D20 Base o D20/200
CCU Base o D20/200 ME
CCU Base o D25
Description Use this command to report statistics on processing in the Base System software.
Download Command
DL .............................................................................. 3-27
B Dump Memory Command
D................................................................................. 3-19
Boot Command
BOOT ...........................................................................3-7
E
C Echo Toggle Command
ECHO......................................................................... 3-32
Edit Memory Command
Calibrate KI Command
E ................................................................................. 3-30
CAL ..............................................................................3-9
Error Log Command
Change Auto-logout Timer Command
EL............................................................................... 3-33
AL.................................................................................3-4
Ethernet Address Command
Change Configuration File Attributes Command
ETH ............................................................................ 3-35
CCA ............................................................................ 3-11
Exit Command
Change Priority Command
EXIT........................................................................... 3-36
CP ............................................................................... 3-17
Check Sum Command
CS ............................................................................... 3-18
Clear Breakpoint Command F
CB............................................................................... 3-10
Clear Configuration File Command Fill Memory Command
CCF............................................................................. 3-14 F ................................................................................. 3-37
Clear Screen Command Find Table Command
CLS ............................................................................. 3-16 FT ............................................................................... 3-38
Control Cache Command Flash Erase Command
CACHE.........................................................................3-8 ERASE ....................................................................... 3-34
Copy File Command
CF ............................................................................... 3-15
Create Configuration Storage Block Command H
CCB ............................................................................ 3-12
HDLC Test
HT .............................................................................. 3-40
D Help Command
HELP.......................................................................... 3-39
Debug Mode Command
DEBUG....................................................................... 3-22
DM.............................................................................. 3-28 I
Decompression Status Command
DSTAT ....................................................................... 3-29
Invoke Test Tool Command
Define Breakpoint Command
TEST .......................................................................... 3-78
DB............................................................................... 3-21
Directory Command
DIR ............................................................................. 3-25
Display File Data Command J
DF ............................................................................... 3-23
Display Hardware Command Jam Exchange Command
DHW........................................................................... 3-24 JX ............................................................................... 3-43
Display Image Information Command Jump To Flash Command
IMG............................................................................. 3-41 JTF.............................................................................. 3-42
Display System Information Command
SI................................................................................. 3-71
General SWM0023-1.00 -2
Full Release I-1
K S
KI Metrics Command Select Active Configuration Command
KIM ............................................................................ 3-44 SC............................................................................... 3-69
Send Exchange Command
SX............................................................................... 3-76
M Serial Analyzer Command
SA............................................................................... 3-66
Serial Test Command
Move Memory Command
ST ............................................................................... 3-74
M................................................................................. 3-45
Set System Parameters Command
SET............................................................................. 3-70
Signal Process Command
P VP............................................................................... 3-83
Step Breakpoint Command
Print Breakpoint Command SB............................................................................... 3-68
PB ............................................................................... 3-46 Suspend Process Command
Profile Command SP ............................................................................... 3-72
PR ............................................................................... 3-47 System Command
Program Flash Command SYSC.......................................................................... 3-77
PRG ............................................................................ 3-49
T
Q
Test CCU RTC Command
Query Configuration Storage Parameters Command RTC ............................................................................ 3-62
QC............................................................................... 3-50 Trace Command
Query Exchange Command TR............................................................................... 3-79
QX .............................................................................. 3-54
Query Process Command
QP ............................................................................... 3-51 U
Query RAM Command
QR............................................................................... 3-53
Upload Command
UL .............................................................................. 3-81
R
V
RAM Test Command
RT ............................................................................... 3-59
Version Command
Report RAM Partitions Command
VER............................................................................ 3-82
RR............................................................................... 3-58
Request Exchange Command
RX............................................................................... 3-63
Resume Breakpoint Command W
RB............................................................................... 3-56
Resume Process Command WIN Metrics Command
RP ............................................................................... 3-57 WINM ........................................................................ 3-84
Return To BootROM Command
RTB............................................................................. 3-61
Z
ZMODEM Download Command
RZ............................................................................... 3-64