background image

68K System Monitor
User's Guide

GE Energy Services

General

SWM0023-1.00 -2

Full Release

3-29

DSTAT - Decompression Status

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.

Syntax

Below is usage and syntax information for this command

Command Format

dstat [l | m]

Variables

l

= leave immediately (default)

m

= maintain connection until process complete,

showing progress while connected.

Parameters

None

Example

Not required

Special
Considerations

None

Summary of Contents for 68K System

Page 1: ...g GE Energy Systems Document Number SWM0023 Version 1 00 Revision 2 Date 20 Mar 2002 Classification General Full Release 68K System Monitor User s Guide ...

Page 2: ...ange without notice and does not represent a commitment on the part of General Electric Canada Inc Any attached hardware schematics and technical descriptions or software listings that disclose source code are for information purposes only Reproduction in whole or in part to create working hardware or software for other than General Electric Canada Inc products is strictly prohibited except as per...

Page 3: ...itor User s Guide GE Energy Services General SWM0023 1 00 2 Full Release iii Modification Record VERSION REVISION DATE INITIALS COMMENT 1 28 Feb 2002 RFN Created 1 00 2 20 Mar 2002 RFN Corrected errors as per review ...

Page 4: ...GE Energy Services 68K System Monitor User s Guide SWM0023 1 00 2 General iv Full Release ...

Page 5: ... Maintenance Commands 2 8 Chapter 3 68K Monitor Commands Section 1 Command Platform Cross Reference 3 2 Platform Specific Commands 3 2 Section 2 Monitor Commands 3 4 AL Change Auto logout Timer 3 4 BAUD Set Baud Rate 3 5 BOOT Startup 3 7 CACHE Control Cache 3 8 CAL Calibrate KI 3 9 CB Clear Breakpoint 3 10 CCA Change Configuration File Attributes 3 11 CCB Create Configuration Storage Block 3 12 CC...

Page 6: ...PRG Program Flash 3 49 QC Query Configuration Storage Parameters 3 50 QP Query Process 3 51 QR Query RAM 3 53 QX Query Exchange 3 54 RB Resume Breakpoint 3 56 RP Resume Process 3 57 RR Report RAM Partitions 3 58 RT RAM Test 3 59 RTB Return To BootROM 3 61 RTC Test CCU RTC 3 62 RX Request Exchange 3 63 RZ ZMODEM Download 3 64 SA Serial Analyzer 3 66 SB Step Breakpoint 3 68 SC Select Active Configur...

Page 7: ...nced 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 ...

Page 8: ...re 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 ...

Page 9: ...lease 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 Support Representatives are available Monday through Friday 8 00 a m to 5 00 p m Mountain Time Contacting Us GE Energy Services 2728 Hopewell Place NE C...

Page 10: ...GE Energy Services 68K System Monitor User s Guide SWM0023 1 00 2 General x Full Release ...

Page 11: ...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 Topic See Pag...

Page 12: ...his device is operating out of you will see this prompt BootROM this is known as the System Monitor D25S D25 FLASH this is known as the Application Monitor D25A Service Mode D20MES D20 ME CCU Base Active Mode D20MEA CPM or D20M Any Mode D20M Terminating a 68K Monitor TELNET Session The 68K Monitor will detect a loss of connection in a TELNET session and will end the monitor session allowing a new ...

Page 13: ...eters arguments Where command_name is one of the recognized commands and parameter arguments are an optional list of command parameters Common Command Syntax You must format these commands in a definite way or syntax You must understand command syntax to understand detailed command descriptions in the following chapters List of Characters This tables lists some of the characters used in command sy...

Page 14: ... first field e must be entered as is because it has no special characters around it If you press ENTER after typing just the e the line above appears to show you the command parameter syntax The second field b w l f d because it is enclosed in is optional Select one of the valid switches within the parenthesis or leave it blank The last field address is required Entering Commands The 68K Monitor a...

Page 15: ...to from overwrite or insert The monitor always starts in overwrite mode Advance CTRL A causes the monitor to copy the character from the previous command buffer reference location to the current location in the input command buffer This character also returns the monitor to overwrite mode Repeat CTRL R allows editing and re execution of the previous command by copying the previous command line fro...

Page 16: ...ut 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 se...

Page 17: ...isplay this message when defining a new breakpoint DB Breakpoint not suspended a breakpoint was not encountered when attempting a resume RB or step SB breakpoint command Cannot post to exchange a send SX or jam JX exchange command encounters an error in sending the message to the specified exchange Command aborted the user replied NO when asked to verify a Return to BootROM RTB command Command not...

Page 18: ...ction DL Suspend all processes first attempting a download without suspending all processes first Test failed a system error is detected If You Find Yourself in Serious Trouble Using the 68K Monitor it is possible to modify or change something in a device s system that can seriously disrupt the operation of the device Use this procedure to restore the RTU to its former state before you used the 68...

Page 19: ...ommands 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 Topic See Page General System Commands 2 2 Diagnostic Commands 2 3 Memory Commands 2 4 Process Commands 2 5 Exchange Commands 2 6 Breakpoint Commands 2 7 Configuration Maintenance Commands 2 8 ...

Page 20: ...abetical order Command Description See Page AL Change Auto logout Timer 3 4 BAUD Set Baud Rate 3 5 BOOT Boot 3 7 CF Copy File 3 15 CLS Clear Screen 3 16 DF Display File Data 3 23 DHW Display Hardware Data 3 24 DIR Directory 3 25 DL Download 3 27 ECHO Echo Toggle 3 32 EXIT Exit 3 36 FT Find Table 3 38 HE or HELP Help 3 39 IMG Display Image Information 3 41 JTF Jump to Flash 3 42 RR Report PAM Parti...

Page 21: ...mmands in alphabetical order Command Description See Page CACHE Control Cache 3 8 CAL Calibrate Kernel Interface 3 9 CS Check Sum 3 18 DEBUG Debug 3 22 DM Debug Mode 3 28 EL Error Log 3 33 ETH Ethernet Address 3 35 HT HDLC Test 3 40 KIM Kernel Interface Metrics 3 44 PR Profile 3 47 QR Query RAM 3 53 RT RAM Test 3 59 RTC Test CCU Real Time Clock 3 62 SA Serial Analyzer 3 66 ST Serial Test 3 74 SYSC...

Page 22: ...of memory in the system List of Commands This list shows the Memory commands in alphabetical order Command Description See Page D Dump Memory 3 19 E Edit Memory 3 28 ERASE Flash Erase 3 34 F Fill Memory 3 37 M Move Memory 3 44 PRG Program Flash 3 49 WARNING Because executing these commands modifies the memory of your system they can disrupt operation Use caution before proceeding ...

Page 23: ...d alter the state of pSOS processes Note Some of these functions must only used for testing and debugging during software development List of Commands This list shows the Process commands in alphabetical order Command Description See Page CP Change Priority 3 16 QP Query Process 3 51 RP Resume Process 3 57 SP Suspend Process 3 72 VP Signal Process 3 83 ...

Page 24: ...examine and alter pSOS exchange data in the system Note Use these functions primarily for testing and debugging purposes during software development List of Commands This list shows the Exchange commands in alphabetical order Command Description See Page JX Jam Exchange 3 43 QX Query Exchange 3 54 RX Request Exchange 3 62 SX Send Exchange 3 76 ...

Page 25: ...ction 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 Note Diagnostic Commands are suspended in order to use breakpoints List of Commands This list shows...

Page 26: ...re and maintain configuration files List of Commands This list shows the Configuration Maintenance commands in alphabetical order Command Description See Page CCA Change Configuration File Attributes 3 11 CCB Create Configuration Control Block 3 12 CCF Clear Configuration File 3 14 QC Query Configuration Storage Parameters 3 50 SC Select Active Configuration 3 69 ...

Page 27: ...ons 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 Topic See Page Section 1 Command Platform Cross Reference 3 2 Platform Specific Commands 3 2 Section 2 Monitor Commands 3 4 ...

Page 28: ...s table lists all of the possible 68K Monitor commands in the left column in alphabetical order The columns to the right show the platforms where the commands will be available for you to use Command CPM D20 D20ME CCU CCUME D25 AL BAUD BOOT CACHE CAL CB CCA CCB CCF CF CLS CP CS D DB DEBUG DF DHW DIR DL DM DSTAT E ECHO EL ERASE ETH EXIT F FT HE or HELP HT IMG Continued on next page ...

Page 29: ... RP RR RT RTB RTC RX RZ SA SB SC SET SI SP ST SX SYSC TEST TR UL VER VP WINM Note K K K K Some of the commands such as CAL and KIM are not checked off for any platform This indicates that these commands are only available when specially built engineering or debugging software is running in the device If a product delivered to an end user displays these commands a mistake may have occurred Contact ...

Page 30: ... command to change the monitor s auto logout timer duration from the default of 5 minutes Syntax Below is usage and syntax information for this command Command Format al timout minutes Variables None Parameters minutes 0 to 32767 minutes 0 disables the timer Example Type al 15 and press ENTER Results The monitor will log out after 15 minutes of inactivity Special Considerations If the timer is dis...

Page 31: ...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 WARNING 1 The system will not save speed changes made using this command in NVRAM The monitor will return to 9600 bps after a restart If you execut...

Page 32: ... SWM0023 1 00 2 General 3 6 Full Release BAUD Set Baud Rate Continued Supported Speeds The supported data rates in bps are D25 has a maximum speed of 38400 bps 900 3600 28200 1050 4800 38400 1200 7200 57600 1800 9600 115200 2000 14400 230400 2400 19200 ...

Page 33: ...nloading Syntax Below is usage and syntax information for this command Command Format CPM D20 D20ME CCU CCUME boot D25 boot i delay Variables delay number of milliseconds to wait before the boot is performed Parameters i skip all additional system processing and reset the system immediately Example Type boot and press ENTER Results The system responds with the normal boot up screen It displays a s...

Page 34: ...CU Base þ D20 200 ME CCU Base o D25 Description Use this command to enable and disable the CPU s cache Syntax Below is usage and syntax information for this command Command Format cache d e Variables d disable processor cache e enable processor cache Parameters None Example Type cache d and press ENTER The monitor disables the processor cache Special Considerations None ...

Page 35: ... Base o D20 200 ME CCU Base o D25 Description For D200s only Use this command to calibrate the Kernel Interface inter processor communications Syntax Below is usage and syntax information for this command Command Format cal values h Variables h displays help displays help Parameters Values Example Not required Special Considerations For use by qualified programmer only ...

Page 36: ...at 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 Syntax Below is usage and syntax information for this command Command Format cb break_pt Variables None Parameters break_pt breakpoint number default is all breakpo...

Page 37: ...s giving each a numerical index Use this index with this command to specify the affected file Example Type cca 1 and press ENTER see below Special Considerations When this command is invoked the user is provided with the current attributes of the file using the characters c currently selected file o opened and r corrupt The user is expected to enter the attributes to change by typing the character...

Page 38: ...monitor expects the block to be temporary and allocates memory out of normal pSOS RAM Syntax Below is usage and syntax information for this command WARNING Any existing stored configurations will be lost when this command is invoked Command Format ccb n v r base_address total_ram response_file_size num_cfgs nvram_base Variables n Build configuration block in global NVRAM region using the base_addr...

Page 39: ...block at address 0x600000 taking the next 0x100000 bytes as the space for the configuration storage system After allocating the size of the storage control structures and the 0x400 bytes for the response file the command divides the remaining space into two equal slices to store configurations Special Considerations Use this command primarily when the system first initializes in order to set up th...

Page 40: ...ntents of the file and it clears all attribute flags as well Syntax Below is usage and syntax information for this command Command Format ccf file_num Variables None Parameters file_num The query configuration storage parameters command displays all existing files giving each a numerical index This index specifies the file that you wish cleared Example Type ccf 1 and press ENTER The monitor erases...

Page 41: ...tion_file Variables None Parameters source_file The name of the file containing the source data This is always required and is the full path name of the file If the operation is transferring configuration or FLASH program information DSP or application then only the source name is required destination_file The name of the file into which the source file data is to be copied If you intend to copy c...

Page 42: ...atform 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 clear the monitor s screen Syntax Below is usage and syntax information for this command Command Format cls Variables None Parameters None Example None Required Special Considerations None ...

Page 43: ... Command Format cp h pid PName delta abs Variables h display help Parameters pid PID number PName name of the process delta the priority change to be made A negative value reduces priority A positive value adds priority abs the final priority of process after change in Hex Example Type cp WES0 20 and press ENTER Results The monitor increases the priority of process WES0 by delta 0x20 Note Process ...

Page 44: ...low is usage and syntax information for this command Command Format CPM D20 D25 cs b n p CCU CCUME cs b n p g Variables b boot code area n NVRAM area p application code area g global NVRAM area Parameters None Example Type cs g and press ENTER this performs a check sum of the global NVRAM area Results The system responds with the calculated and expected checksums of the specified area and the mess...

Page 45: ...mat double precision numbers scientific format then 16 ASCII characters representing the same memory values If an octet does not have a printable ASCII representation the monitor will print a dot instead Syntax Below is usage and syntax information for this command Command Format d b w l f d beg_addr end_addr Variables b bytes octets the default mode w words l long words f floating point numbers d...

Page 46: ...sisting of address eight hexadecimal words and 16 ASCII characters starting at hexadecimal address F024 then displays the prompt Type d and press ENTER Results The system displays the next eight lines starting at hexadecimal address F024 80 F0A4 then displays the prompt Special Considerations An attempt to display non existent memory results in a bus error If this is the first dump not specifying ...

Page 47: ...s command Command Format db address loops Variables None Parameters address hexadecimal address for the breakpoint loops number of times to execute the specified address in decimal before stopping default is zero Example Type db 103648 and press ENTER This defines a breakpoint at hexadecimal address 103648 which stops before the first execution of the instruction at that address Results The system...

Page 48: ...splays the current debug state The user receives the following prompt Do you wish to update the NVRAM header y n Any reply other than y aborts the rest of the command Otherwise the command prompts you to enter new values for the FLASH SRAM and NVRAM base address and size Entering a zero indicates that the item is to remain unchanged Once the new data has been entered you are prompted Is this data ...

Page 49: ...d You may view any file recognized by the Installable File System Syntax Below is usage and syntax information for this command Command Format df b t filename Variables b Display contents in binary format default t Display contents as text Parameters filename The full path name of the file to be displayed Example Type df b config bin and press ENTER Results The monitor displays the contents of the...

Page 50: ...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 Syntax Below is usage and syntax information for this command Command Format dhw Variables None Parameters None Example Type dhw and press ENTER Results A comprehensive list of har...

Page 51: ...records the number of valid records in the table record size the size in bytes of each record Syntax Below is usage and syntax information for this command Command Format D25 dir n p CCU CCUME dir l g e Variables l local NVRAM database tables default g global NVRAM database tables e EPROM Flash default configuration database tables n D25 NVRAM p D25 Flash Parameters None Example Type dir n and pre...

Page 52: ...d Syntax continued Special Considerations Global database tables only exist if a multi node CCU is present EPROM database tables form the default configuration for the CCU They are optional and may not have been included in the CCU If any type of database is unavailable the DIR command will return an error message ...

Page 53: ... stored in memory When it receives an S7 S8 or S9 end record the DOWNLOAD command returns control to the Monitor s command line Syntax Below is usage and syntax information for this command Command Format D25 CCUME dl o offset CPM D20 CCU dl Variables offset the offset at which to download Parameters o specifies that an offset follows Example Type dl and press ENTER Results This prepares the monit...

Page 54: ...ctions allow external bus monitoring Syntax Below is usage and syntax information for this command Command Format dm d e Variables d disable debug mode Enable cache or disable show cycles e enable debug mode disable cache or enable show cycles Parameters None Example Type dm e and press enter Results This command disables the 68020 or 68EC030 on chip instruction cache or enables show cycles for th...

Page 55: ...se o D20 200 ME CCU Base þ D25 Description Use this command to view status of file copy command progress and success Syntax Below is usage and syntax information for this command Command Format dstat l m Variables l leave immediately default m maintain connection until process complete showing progress while connected Parameters None Example Not required Special Considerations None ...

Page 56: ...cientific format scientific format Description When the contents of the memory location appear type a new value to store at the location a hyphen to back up one location a plus sign or the ENTER key to move forward one location CCU D25 only a period to exit this function Scientific values must subscribe to the following format mantissa e exponent The mantissa can contain a decimal point This comma...

Page 57: ...t you are editing RAM memory starting at address 200000 hexadecimal in long word format Results The system continues to display the current address location and data at that location in hexadecimal format until you use a period to return the monitor prompt Special Considerations An attempt to display non existent memory or modify EPROM memory results in a bus error You may modify systems with FLAS...

Page 58: ...nd line echoing on and off It only affects the 68K Monitor s echoing of user entered keystrokes and not the results of any commands Syntax Below is usage and syntax information for this command Command Format echo on off Variables None Parameters on turns command line echoing on off turns command line echoing off Example Type echo off and press ENTER Results The monitor no longer displays your key...

Page 59: ...rors 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 Syntax Below is usage and syntax information for this command Command Format CPM D20 el p r D20ME CCU D25 el p r f Variables p print the error log entries r reset delete the error log entries f fix an error log that contains an infinite loop Parameter...

Page 60: ...nformation for this command Command Format D25 erase d y D20 ME CCUME erase y Variables None Parameters d erase DSP Flash y disable the verification prompts Example Type erase and press ENTER Results If you confirm the erase prompt the command erases the Flash EPROM Special Considerations The command prompt will return if Flash is already clear when the erase command is invoked Otherwise the comma...

Page 61: ...mmand to change the Ethernet address of a D25 s hardware interfaces Syntax Below is usage and syntax information for this command Command Format eth d u b1 b2 b3 b4 b5 b6 Variables d display address u update address Parameters b1 b2 b3 b4 b5 b6 6 byte Ethernet address Example Nor required Special Considerations Do not use unless qualified Address change is permanent and will stay in D25 XCOM hardw...

Page 62: ...e and syntax information for this command Command Format exit Variables None Parameters None Example Type exit and press ENTER Results The monitor returns control to the calling routine Special Considerations The task that started the 68K Monitor must still exist and be running i e not suspended This command automatically clears all active breakpoints but does not perform any other clean up operat...

Page 63: ...ord depending on the mode selected by the switch Syntax Below is usage and syntax information for this command Command Format f b w l beg_addr end_addr value Variables b bytes octets the default mode w words l long words Parameters beg_addr start address of region in hexadecimal end_addr address to fill up to in hexadecimal value value to put in region in hexadecimal Example Type f w 200000 200400...

Page 64: ...Command Format ft table_name Variables None Parameters table_name name of the database table to locate not case sensitive Example Type ft p097cpro and press ENTER to locate the P097CPRO table in the database Results The monitor displays the hexadecimal format address and decimal format number of records in the specified table It displays zeros for the address and number of records if it does not f...

Page 65: ...ion and usage for a given specific command Syntax Below is usage and syntax information for this command Command Format CCU CCUME D25 he or help command CPM D20 help command Variables None Parameters command name of the specific command you wish to obtain information about Example Type help and press ENTER Results System displays a list of available monitor commands and returns either to the promp...

Page 66: ...ese messages by hand you can not use the command effectively unless you know the protocol used by the D 20 application Syntax Below is usage and syntax information for this command Command Format ht c m r s w Variables c configure the link parameters m define the application message r read monitor the link s display configuration status w send an application message Parameters None Example None re...

Page 67: ...tic 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 Syntax Below is usage and syntax ...

Page 68: ...x information for this command Command Format jtf Variables None Parameters None Example Type jtf and press ENTER Type yes to confirm Results The system returns to FLASH operation mode Special Considerations The system must be operating out of BootROM to use this command The system halts and deletes all applications currently executing on the RTU when activating the FLASH operating system WARNING ...

Page 69: ...pecific exchange name case sensitive exchange name The command supports the new exchange naming convention If you enter an entire name the monitor sends the message to that exchange If you enter the first few characters the command attempts pattern matching It sends the message to one or more exchanges depending on the number of matches m2 m5 first through fourth long words in the body of the mess...

Page 70: ... D200 only Use this command to view the Kernel Interface Metrics Syntax Below is usage and syntax information for this command Command Format kim r node_number 0 Variables r reset Parameters node_number processor number of D200 0 all processors Example Type kim 3 and press ENTER Results Displays the metrics of node 3 3rd processor Special Considerations Used during debug process only Requires spec...

Page 71: ...n for this command Command Format m from_addr to_addr num_bytes Variables None Parameters from_addr start address of the source region in hexadecimal to_addr start address of the destination in hexadecimal num_bytes size in bytes octets hexadecimal of the region to move Example Type m 200000 200400 200 and press ENTER Results This copies the RAM memory region 200000 up to 200200 to the region 2004...

Page 72: ...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 Syntax Below is usage and syntax information for this command Command Format pb break_pt Variables None Parameters break_pt breakpoint number as returned with the defined breakpoint command Example Type pb and press ENTER Results If...

Page 73: ...s of a tick per run average the CPU usage in 10ths of percent of the process the maximum period between watchdog process operations Note Each clock tick is one millisecond Syntax Below is usage and syntax information for this command Command Format CPM D20M pr p r CCU CCUME D25 pr p r t Variables p print the process profile r reset process profile counts t print the process profile in the sequence...

Page 74: ...run ticks are decimal integral values Ticks per run are tenths of milliseconds and CPU use are tenths of a percent decimal The system represents figures in decimal notation This profiler does not account for interrupt service CPU usage Roll over of the profiler s counts occurs after some time more than 14 days The exact roll over time depends on the running applications and may vary greatly betwee...

Page 75: ...s command to program a FLASH memory Syntax Below is usage and syntax information for this command Command Format prg b w l address data Variables b bytes octets the default mode w words l long words Parameters address address at which to store the data in hexadecimal data the data to store Example Not Required Special Considerations Use with great care Command will change contents of Flash memory ...

Page 76: ...mory is allocated to configuration storage and the creation time and date of the stored configurations Note K K K K The number used to identify each file in this display is the file index The system uses this number to identify the file affected by the clear configuration file change configuration file attributes and select active configuration commands Syntax Below is usage and syntax information...

Page 77: ...es None Parameters none display general status information for all processes pid pSOS process ID in hexadecimal display detailed information for a specific process gpid global pSOS process ID in hexadecimal display detailed information for a specific process name case sensitive process name Supports the new process naming convention To display an entire name enter detailed information for that pro...

Page 78: ...Run State This table lists the states that the processes may be in at any time In this state the process Await is spawned but not activated Vwait is waiting for a pSOS signal Xwait is waiting for a message from another process to arrive at an exchange Paused has sent a pause request to processor Suspended has been spawned and activated but is not running This state may be a normal condition or may...

Page 79: ...y RAM if in a multi processor system Syntax Below is usage and syntax information for this command Command Format CPM D20 D25 qr v n CCU CCUME qr v n gv gn Variables v volatile static RAM n non volatile RAM NVRAM gv global volatile static RAM gn global non volatile RAM NVRAM Parameters None Example Type qr gn and press ENTER Results This displays the allocation and available free global NVRAM The ...

Page 80: ...echanism FIFO or priority access rights group only or unlimited and queue length unlimited or decimal notation limit followed by a list of all queued processes and all queued messages Syntax Below is usage and syntax information for this command Command Format CPM D20 D25 qx xid name CCU CCUME qx xid gxid name Variables None Parameters none displays general information for all exchanges xid pSOS e...

Page 81: ...WM0023 1 00 2 Full Release 3 55 QX Query Exchange Continued Syntax continued Example Type qx and press ENTER Results The system displays the name exchange ID and number of queued processes and messages for every exchange in the system Special Considerations None ...

Page 82: ...command Command Format rb break_pt reps Variables None Parameters break_pt breakpoint number as returned with the define breakpoint command reps number of times in decimal to repeat execution of the breakpoint address before stopping default is zero Example Type rb 1 and press ENTER This resumes breakpoint number one 1 that stops again before the second execution of the instruction at the breakpoi...

Page 83: ...ess gpid global pSOS process ID in hexadecimal resume a specific process name case sensitive process name The monitor supports the new process naming convention If you enter an entire name the monitor resumes the specified process If you enter the first few characters the command attempts pattern matching The monitor will then resume all matching processes Example Type rp and press ENTER This enab...

Page 84: ...ommand 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 Syntax Below is usage and syntax information for this command Command Format rr Variables None Paramet...

Page 85: ...v n CCU CCUME rt v n gv gn beg_addr end_addr loops i D25 rt v n s beg_addr end_addr loops i Variables v volatile static RAM n non volatile RAM NVRAM s destructive sequential test gv global volatile static RAM gn global non volatile RAM NVRAM Parameters beg_addr first address of memory range in hexadecimal end_addr end address of memory range in hexadecimal loops number of times to execute the fini...

Page 86: ...ull Release RT RAM Test Continued Syntax continued Special Considerations If you enable the Debug Mode the function can be CPU 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 ...

Page 87: ...ing 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 Syntax Below is usage and syntax information for this command Command Format rtb Variables None Parameters None Example At the monitor prompt type rtb and press ENTER Results The system returns to BootROM operation mode Special Consi...

Page 88: ...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 Syntax Below is usage and syntax information for this command Command Format rtc r Variables r reset back to initial settings Parameters None Example At the monitor prompt type rtc r and press ENTER Special Considerations None ...

Page 89: ...aming convention If you enter an entire name the monitor retrieves the message from that exchange If you enter the first few characters the command attempts pattern matching The monitor retrieves messages from one or more exchanges depending on the number of matches Example Type rx 304540 and press ENTER This requests a message from the exchange with an ID of 304540 Results The message is displaye...

Page 90: ...vel verbose level which determines the level of debug messages displayed default is zero any non zero value will activate debug messages Mtimeout set receive message timeout to the user specified value the default is 2000 ms Ctimeout set inter character timeout to user specified value default is 500 ms Wwindow set receiver window size to user specified value default is 1400 bytes Special Considera...

Page 91: ...sing ZMODEM all files sent to the 68K Monitor must have file names 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...

Page 92: ...activates the serial analyzer monitor on communications port seven SIO7 The monitor displays all communications on the specified channel until it receives CNTRL C on the monitor channel The display then returns to the prompt Special Considerations This function cannot be used on the port assigned to 68K Monitor COM0 the SPI port _SPI or the SCC1 port SCC1 This function is completely non intrusive ...

Page 93: ...isplay 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 ...

Page 94: ...eak_pt instructions Variables None Parameters break_pt breakpoint number as returned with the define breakpoint command instructions number of additional instructions to execute prior to stopping default is zero Example Type sb 2 1 and press ENTER This allows the process defined by the breakpoint number of 2 to perform two program instructions Results The system responds with the prompt Additional...

Page 95: ...usage and syntax information for this command Command Format sc file_num file_name BaseAddress Variables None Parameters file_num The query configuration storage parameters command displays all existing files giving each a numerical index The monitor uses this index with the command to specify the file that it will copy into memory and make active file_name The name of the configuration file to se...

Page 96: ...þ D25 Description Note This command is for developers only Use this command to quickly modify options in code during run time Syntax Below is usage and syntax information for this command Command Format set h option d parameters Variables h help d Parameters option depends on application parameters depends on application Example Not required Special Considerations Very dangerous to use only for pr...

Page 97: ...5 Description Use this command to display information on the hardware software and current configuration of the device Syntax Below is usage and syntax information for this command Command Format si Variables None Parameters None Example Type si and press ENTER Results The monitor displays information on the configuration of the system Special Considerations In earlier versions of the Monitor this...

Page 98: ...cess 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 Below is usage and syntax information for this command Command Format CPM D20 D25 sp pid name CCU CCUME sp pid gpid name Variables None Parameters none suspend all unprotected processes pid pSOS process ID in hexadecimal suspend a specific...

Page 99: ...ds all unprotected processes Unless it encounters an error the system displays the prompt If it encounters an error it displays an error message before it returns to the prompt Special Considerations This function stops the execution of tasks within the remote you must not use it when the remote is active Note The safe way to restore normal operation after using this command is to reboot ...

Page 100: ... port baud Variables f force mark or space states l automatic loop back test Parameters port serial port to test COM baud data rate in bps decimal Example Type st l com7 9600 and press ENTER Results This forces the RS 232 transmitter driver for communications port seven 7 to perform the loop back test at 9600 bps The system displays the current state of the test Cancel the force test manually with...

Page 101: ... 2 TXD 3 RTS 7 CTS 8 Selectable Data Rates The command used in CCU based and D25 products allows you to select the data rate for the loopback test Supported data rates in bps are 50 110 134 200 300 600 1050 1200 2400 4800 7200 9600 38400 WARNING The command has failed when used for stress testing Do not use the serial test for that purpose You must only use it to verify the device driver for the c...

Page 102: ...e name case sensitive exchange name The command supports the new exchange naming convention If you enter an entire name the system sends the message to that exchange If you enter the first few characters the command attempts pattern matching The system sends the message to one or more exchanges depending on the number of matches m2 m5 first through fourth long words in the body of the message in h...

Page 103: ...D20 200 CCU Base o D20 200 ME CCU Base þ D25 Description Use this command to reset the reboot counter to zero Syntax Below is usage and syntax information for this command Command Format sysc command Variables help Parameters command rcount Example Type sysc rcount and press ENTER Results The reboot counter will be reset to 0 Special Considerations None ...

Page 104: ...d 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 Syntax Below is usage and syntax information for this command Command Format test proc_name Variables None Parameters proc_name The name of the test tool process normally Txxx Example None Required Sp...

Page 105: ...ess condition value tr r g samples t1 pre_trigger trigger time tr r g samples t2 pre_trigger process name Variables h display help c clear all s stop collection d display gathered data c continuous display e format for spread sheets r gather data g allocate buffers from global memory Parameters start_time start time for trace to display end time end time for trace to display pre_trigger number of ...

Page 106: ...ue Example 3 Type tr r 20 t0 10 208000 12345678 and press ENTER Results This triggers if long memory value changes from the value 12345678 Example 4 Type tr r 20 t1 10 00123456 and press ENTER Results This triggers when the RTC value if greater than or equal to 00123456 Example 5 Type tr r 20 t2 10 30123456 and press ENTER Results This triggers after the process with the ID of 30123456 runs Specia...

Page 107: ...nd to retrieve an S record from the device s memory Syntax Below is usage and syntax information for this command Command Format CPM D20 ul CCU CCU ME D25 ul beg_addr end_addr width Variables None Parameters beg_addr start of address range end_addr end of address range Example Type ul and press ENTER Results uploads the contents of NVRAM to the terminal and returns to the prompt when completed Spe...

Page 108: ...splay 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 Syntax Below is usage and syntax information for this command Command Format D20 CCU CCU ME ver D25 ver d Variables d Display DSP flash versions Parameters No...

Page 109: ...me The command supports the new naming convention If you enter an entire name the command sends the signal to a specific process If you enter the first few characters the command attempts pattern matching It then sends the signal to all matching processes event hexadecimal format word of the bits with which to signal the process es Example Type vp 308048 1000 and press ENTER This signals the proce...

Page 110: ...CU Base o D20 200 ME CCU Base o D25 Description Use this command to report statistics on processing in the Base System software Syntax Below is usage and syntax information for this command Command Format winm r data_type data_type Variables r reset Parameters data_type refer to code Example Not required Special Considerations Requires special code to use this command ...

Page 111: ...UG 3 22 DM 3 28 Decompression Status Command DSTAT 3 29 Define Breakpoint Command DB 3 21 Directory Command DIR 3 25 Display File Data Command DF 3 23 Display Hardware Command DHW 3 24 Display Image Information Command IMG 3 41 Display System Information Command SI 3 71 Download Command DL 3 27 Dump Memory Command D 3 19 E Echo Toggle Command ECHO 3 32 Edit Memory Command E 3 30 Error Log Command ...

Page 112: ...artitions Command RR 3 58 Request Exchange Command RX 3 63 Resume Breakpoint Command RB 3 56 Resume Process Command RP 3 57 Return To BootROM Command RTB 3 61 S Select Active Configuration Command SC 3 69 Send Exchange Command SX 3 76 Serial Analyzer Command SA 3 66 Serial Test Command ST 3 74 Set System Parameters Command SET 3 70 Signal Process Command VP 3 83 Step Breakpoint Command SB 3 68 Sus...

Reviews: