Home

GE 68K System User's Manual

1. SWM0023 1 00 2 General 2 8 Full Release 68K System Monitor User s Guide GE Energy Services Chapter 3 68K Monitor 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 Section 1 Command Platform Cross Reference Platform Specific Commands Section 2 Monitor Commands General SWM0023 1 00 2 Full Release 3 1 68K System Monitor GE Energy Services User s Guide Section 1 Command Platform Cross Reference 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 cous mv eee ccowe is Sa eaa a sor fd ecm O o e T a E a Continued on next page SWM0023 1 00 2 General 3 2 Full Release 68K System Monitor User s Guide GE Energy Services Platform Specific Commands Continued List of Commands continued CPM D20 D20ME CCU Some of the commands such as CAL and KIM are not checked off for any platform Note Keer This indicates that these commands are only available when specially built engineering or debugging software is running in
2. The command also queries the global memory RAM if in a multi processor system Below is usage and syntax information for this command Command Format CPM D20 D25 qr v n pom ieee aeni O Variables volatile static RAM non volatile RAM NVRAM global volatile static RAM global non volatile RAM NVRAM Parameters Example Type qr gn and press ENTER Results This displays the allocation and available free global NVRAM The system displays the address and size of each block in hexadecimal the total free memory and number of free blocks in decimal notation before it returns to the prompt Special Non volatile memory cannot be queried if the NVRAM is Considerations corrupt SWMO0023 1 00 2 3 53 68K System Monitor GE Energy Services User s Guide QX Query Exchange Platform Iv CPM Iv D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to display information on system exchanges e Ifyou request information on more than one exchange then the output is in a list format Each line contains an exchange name and ID and the number of processes and messages queued e Ifyou request information on all exchanges the monitor derives and displays the number of free exchange control blocks e Ifyou request information on a single exchange then the monitor will display a more detailed description The description includes the exchange name queuing
3. Purpose and Audience of this User s Guide Job Titles Experience amp Abilities Prerequisites What This Document Provides AN WARNING What This Document Does Not Provide Document Style and Convention Rules viii 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 GE Energy Services customers and employees who wish to view detailed information about the software and hardware should use this guide This document assumes that you are familiar with software and programming terminology and practices and have some knowledge of both the hardware and software This guide covers the commands found in the 68K Monitors that run on these platforms e CPM running CPM Base e D20 running D20 Base software e D20 with D20 ME running D20 Base software e D20 and D200 using CCU Base software e D20 and D200 with D20 ME processors running CCU Base e 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 syst
4. Variables volatile static RAM non volatile RAM NVRAM destructive sequential test global volatile static RAM 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 finite loop for the specified memory in decimal before stopping use infinite loop Example Type rt gn 510000 510060 25000 and press ENTER Results This tests the integrity of the global non volatile static RAM between the memory range of 510000 and 5100b0 repeatedly for 25 000 times The system simply returns the prompt when it successfully completes this instruction If the test fails the system displays an error message before returning to the prompt Continued on next page SWM0023 1 00 2 3 59 68K System Monitor GE Energy Services User s Guide RT RAM Test Continued 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 SWM0023 1 00 2 General 3 60 Full Release 68K System Monitor User s Guide RTB Return To BootROM Platform Description Syntax General Full Release GE Energy Services O CPM 0O D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this
5. The command requires three numerical arguments in hexadecimal format e first is the starting address of the region to fill e second is the ending address of the region e 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 Below is usage and syntax information for this command f b w 1 beg_addr end addr value Variables bytes octets the default mode words 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 F034 and press ENTER Results This fills the RAM memory from hexadecimal address 200000 to 200400 with words of F034 hexadecimal The system displays the prompt when it completes this instruction Special e Anattempt to fill EPROM memory results in a bus error Considerations e You can modify systems with FLASH EPROM such as the D25 and CCUME using this command SWMO0023 1 00 2 3 37 68K System Monitor User s Guide GE Energy Services FT Find Table Platform v CPM v D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Syntax Below is usage and syntax information
6. It returns the first message in each target message queue Below is usage and syntax information for this command da Parameters i pSOS exchange ID in hexadecimal make an attempt to retrieve a message from a single exchange case sensitive exchange name The monitor supports the new exchange naming 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 displayed as six long hexadecimal words as A999 00000001 00000002 00000003 00000004 The system displays the specified message then returns to the prompt unless it encounters an error If this is the case it displays an error message before it returns to the prompt Special You must only use this command in a testing or debugging Considerations context If you take a message from an exchange indiscriminately you cannot predict the results SWM0023 1 00 2 3 63 GE Energy Services 68K System Monitor User s Guide RZ ZMODEM Download Platform Description Syntax 3 64 Cc CPM O D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to download configuration and application d
7. SP command Syntax Below is usage and syntax information for this command Command Format CPM D20 D25 rp pid name CCU CCUME rp pid gpid name Variables Parameters resume all processes pSOS process ID in hexadecimal resume a specific process global pSOS process ID in hexadecimal resume a specific process 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 enables all suspended processes to resume execution Results Unless it encounters an error the system displays the prompt If it encounters an error the system displays an error message before it returns to the prompt Special Do not use this command to start a D25 after an NVRAM Considerations download or after an error caused it to halt In these cases you must reboot the D25 to ensure that all parameters and variables are re initialized properly General SWM0023 1 00 2 Full Release 3 57 GE Energy Services 68K System Monitor User s Guide RR Report RAM Partitions Platform Description Syntax 3 58 O CPM O D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display information on the RAM divis
8. 42 0O CPM Cc D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to place the D25 in Active Mode The system stops execution out of the BootROM region and it activates the FLASH operating system Below is usage and syntax information for this command Example Type jtf and press ENTER Type yes to confirm D258 gt jtf Jump to the FLASH Operating System yes no yes Jumping to FLASH Operating System Activating FLASH Application code Starting Application Reset Code Spawning Process es Name GP PR Stack Arg_List Proc_Add Sp_Err Ac_Err Spawned B049 0 4000100 0 20AA74 0 0 YES B050 0 1000200 20F974 YES B061 0 3000100 210662 YES 5069 0 5000100 211EDE YES WIN 0 3000600 2212E0 YES WMII 0 2000300 2312EA YES B019 0 1000400 2372AA YES B070 0 1000200 237626 YES 0 A00220 2387D6 YES 0 8000800 23AA14 YES B015 B100 Results The system returns to FLASH operation mode Special The system must be operating out of BootROM to use this Considerations command The system halts and deletes all applications currently executing on the RTU when activating the FLASH operating system This command causes the D25 to shift into active mode immediately without performing any checks on FLASH Be sure that your FLASH region contains valid application data before invoking this command SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide JX Jam Exchange Platform D
9. Bytes SRAM region base address 0x0920000 Size Bytes 0x0200000 Size Bytes 0x0000000 Size Bytes 0x2000000 Size Bytes Ox0006800 Size Bytes Ox0080000 Size Bytes Ox3000000 Size Bytes Ox1000000 Size Bytes Ox2000000 Size Bytes NVA 0x0820000 128K OxO81B000 108K yp 2 Current Bank 2 wes oO o 1 00 00 C3 FE 06 68 00 00 C3 FE 06 69 More _ Results The monitor displays information on the configuration of the system Special In earlier versions of the Monitor this command was dhw Considerations SWMO0023 1 00 2 3 71 GE Energy Services 68K System Monitor User s Guide SP Suspend Process Platform Description Syntax 3 72 Mi CPM Mi D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 e MON monitor input process e MOUT monitor output process e WDOG watchdog process e ROOT root process e IDLE pSOS idle process e LGIN boot login process in some cases e iSCS processes including B100 and file managers Below is usage and syntax information for this command Command Format CPM D20 D25 sp pid name CCU CCUME sp pid gp
10. CCUME qp pid gpid name Variables Parameters display general status information for all processes pSOS process ID in hexadecimal display detailed information for a specific process global pSOS process ID in hexadecimal display detailed information for a specific process case sensitive process name Supports the new process naming convention To display an entire name enter detailed information for that process If you enter the first few characters the command attempts pattern matching The monitor displays general or detailed information depending on the number of matches Example Type qp and press ENTER PID Prior Mode Grp Status 927C86 927BD4 927B22 927A70 9279BE 92790C 92785A 9277A8 9276F6 927644 9264E2 927592 9274E0 92742E 92737C 9272CA 927218 927166 9270B4 Xwait Vwait Paused Vwait Paused Vwait Paused Vwait Vwait Vwait Vwait Vwait Vwait Paused Xwait Vwait Xwait Paused Vwait Xwait Xwait Xwait Xwait Paused ec000000000000000000 Results The system displays process information about all active processes and then returns to the prompt Continued on next page SWM0023 1 00 2 3 51 GE Energy Services 68K System Monitor User s Guide QP Query Process Continued Syntax continued Special All numeric data displayed is in hexadecimal notation Considerations Information The response to all QP commands will include Details e process
11. Input By entering a command at the prompt and pressing ENTER one of the following responses will happen a recognized it does not require the system will execute the command command special parameters a recognized required parameters the system will execute the command command are provided a recognized parameters are a reminder line showing the correct command missing or invalid command syntax will appear including required and optional parameters an unrecognizable a general error will be issued indicating command that the command was not recognized If you type e b w 1 f d address According to the syntax conventions e The first field e must be entered as is because it has no special characters around it Ifyou 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 The 68K Monitor allows editing of the command line by using regular keyboard input as well as a few special key combinations In addition to entering any printable ASCII character onto the command line the following characters can be used This key performs this function ESC deletes all current data on the command line and returns to the first character position except D20 bas
12. Services K KI Metrics Command Move Memory Command Print Breakpoint Command RB ssc n A REA ONE Program Flash Command PRG Bae eee a a ee Q Query Configuration Storage Parameters Command OR aa a hea Gah N ARE RAM Test Command SWM0023 1 00 2 68K System Monitor User s Guide S Select Active Configuration Command T E E T TAE E uN neds 3 72 Test CCU RTC Command Upload Command A aa E A E ETE E S E T 3 81 V Version Command WIN Metrics Command Z ZMODEM Download Command General Full Release
13. This list shows the Exchange commands in alphabetical order Commands SWM0023 1 00 2 General 2 6 Full Release 68K System Monitor User s Guide GE Energy Services 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 e You must define breakpoints in code that is in RAM The program instruction changes to a 68000 family TRAP instruction e You must define all program breakpoints at the beginning of an instruction e Only define breakpoints in a process Ifthe 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 This list shows the Breakpoint commands in alphabetical order Commands General SWM0023 1 00 2 Full Release 2 7 68K System Monitor GE Energy Services User s Guide Configuration Maintenance Commands Description Use these commands to store and maintain configuration files List of This list shows the Configuration Maintenance commands in alphabetical order Commands CCA Change Configuration File Attributes 3 11 CCB Create Configuration Control Block 3 12 Query Configuration Storage Parameters 3 50 CCF Clear Configuration File Select Active Configuration
14. This triggers after the process with the ID of 30123456 runs Special This function is only available as a special debug BootROM as Considerations there is not enough room for it to be permanently included Currently the BootROM code must have the TRACE command compiled into S043 0 before you can use this command You will have to remove some other commands in order to make room for it Syntax continued SWM0023 1 00 2 General 3 80 Full Release 68K System Monitor User s Guide GE Energy Services UL Upload Platform Iv CPM Iv D20 D20 ME D20 200 Iv D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command 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 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 Special None Considerations General SWM0023 1 00 2 Full Release 3 81 68K System Monitor GE Energy Services User s Guide VER Version Platform Iv CPM Iv D20 D20 ME D20 200 Iv D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to display the Base System and pSOS versions plus any application version and embedded image information On the D
15. any parameters will return an error SWM0023 1 00 2 General 3 20 Full Release 68K System Monitor User s Guide DB Define Breakpoint Platform Description Syntax General Full Release GE Energy Services M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command db address loops 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 responds with the breakpoint number assigned to this breakpoint and the prompt Each time it encounters the breakpoint the system displays the breakpoint number loop count and register values If the loop count is greater than zero it is decremented Otherwise the proces
16. 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 Below is usage and syntax information for this command Example At the monitor prompt type rtb and press ENTER Results The system returns to BootROM operation mode Special The system halts and deletes all applications currently Considerations executing on the RTU when it activates the BootROM operating system SWM0023 1 00 2 3 61 68K System Monitor GE Energy Services User s Guide RTC Test CCU RTC Platform o CPM o D20 D20 ME D20 200 o D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 t reset back to initial settings Parameters None Example At the monitor prompt type rtc r and press ENTER Special None Considerations SWM0023 1 00 2 General 3 62 Full Release 68K System Monitor User s Guide RX Request Exchange Platform Description Syntax General Full Release GE Energy Services M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to retrieve a message from one or more exchanges
17. data rate for the port in bps Example Type baud 4800 and press ENTER Results The monitor switches to communicate at 4800 bps Special See warning below Considerations The 68K Monitor has the ability to change the communication speed of the D25 and 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 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 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 Continued on next page SWM0023 1 00 2 68K System Monito
18. ecceccccesseeseeetceessecsseceeceaecsecsseeeseesseens 3 41 Jump To Flash miei e eE EEE EE E AE AEREE doa ed 3 42 rid AIT DD CE te n EN E E E 3 43 SREM ei eSa a a a a e a 3 44 MOve MEMOry ascotara an a a a a a i eaaa ai 3 45 s Print Br akpoltite seiersen a i a E E N aes 3 46 s Prole mae tects tug e a EE N N E A A A EAEN 3 47 Program Flashes ccir av cccte ee iE cease i i A E E E i E 3 49 Query Configuration Storage Parameters ccccsccsscstecetteesteeeteeeteenseens 3 50 Query Proc s Seri eaa a a ake a e aa aa a 3 51 Q ery RAM iis ccccethssecisevecteaadsacishar a E a r aa a E aa 3 53 si Query Exehan penr ernan re AA E E RE a 3 54 Res me Breakpoint pen a e e Gale cg E E N T cade 3 56 Resume ProCeSS inae eieren Sele Sova ba EEEE S EEA TOE 3 57 Report RAM Partitions cccccccescessceseceseceeeeeeeeeeseeeseeeseeeseecaecsseceseenaeens 3 58 RAM TeSt aa a a E O EE an Aa a raa ana EEA eaS EEE avert ops 3 59 Return To BootROM viirin iiia iiih 3 61 SHES CCU RAC zatuta Us a R a e a a ai 3 62 Request EXChan teney iah oie e EEE E A EE 3 63 ZMODEM Domi oa d rn oteta a a erarnan ateei eena nei Caa Eae ea dana SS 3 64 s Serial Amal yZer esnerinan naer mn n E E aaar R 3 66 Step Breakpoint sione lnn aa e A a a e T 3 68 Select Active Configuration ccccccecccecssessseesseessecssecsecneceseeenseceseenseees 3 69 s Set System Parameters inana ire ETE E T A a 3 70 Display System Information ccccccccecssees
19. 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 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 print the error log entries reset delete the error log entries fix an error log that contains an infinite loop Parameters Example INO ERRORS in LOG D25 System Service NO D25 Active YES D25 Application Service NO D25 Disabled D25 Network Init D25 Debug Mode FLASH CRC Failed ID25A gt _ Results This command displays the error log entries maintained by the system and the system state The system returns the prompt when it completes this instruction Special Considerations General SWM0023 1 00 2 Full Release 3 33 GE Energy Services 68K System Monitor User s Guide ERASE Flash Erase Platform Description Syntax AN WARNING 3 34 0O CPM Cc D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Note this command is available only when executing from the BootROM This will be indicated by the D25A gt or the D20MEA gt prompts for the D25 or D20ME based systems respectively Use this command to perform an erase
20. first Test failed a system error is detected 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 Suspend all processes in the RTU Fill the NVRAM memory with zeros Reboot the RTU Re download your configurations and or Flash code SWM0023 1 00 2 General 1 8 Full Release Chapter 2 Command Grouping Overview Seven Groups In This Chapter General Full Release 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 This Chapter of the document contains the following topics General System Commands Diagnostic Commands Memory Commands Process Commands Exchange Commands Breakpoint Commands Configuration Maintenance Commands 2 8 SWMO0023 1 00 2 2 1 68K System Monitor GE Energy Services User s Guide General System Commands 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 cr pit MG s4 SWM0023 1 00 2 General 2 2 Full Rel
21. for this command 3 38 Command Format ft table_name Variables Parameters table name name of the database table to locate not case sensitive Example Type ft p097cpro and press ENTER to locate the PO97CPRO table in the database D25A gt ft pO97cpra able has 1 records starting at 82E928 ID25A gt _ 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 find the table Special This command may not function if NVRAM is corrupted This Considerations is because the NVRAM header inside the D25 contains the location of the root table of the Database Manager and all of the table identification blocks SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services HE or HELP Help Platform v CPM T D20 D20 ME D20 200 T D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Syntax Below is usage and syntax information for this command Command Format CCU CCUME D25 he or help command CPM D20 help command Variables Parameters command name of the specific command you wish to obtain information about Example see an explanation of a command type HELP command_name i e help help Availab
22. mechanism 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 D235 qx xid name CCU CCUME qx xid gxid name Variables Parameters displays general information for all exchanges pSOS exchange ID in hexadecimal displays detailed information for a specific exchange global pSOS exchange ID in hexadecimal displays detailed information for a specific exchange case sensitive exchange name It now supports the new exchange naming convention If you enter an entire name the monitor displays detailed information for that exchange If you enter the first few characters the command attempts pattern matching The monitor displays general or detailed information depending on the number of matches Continued on next page SWM0023 1 00 2 General 3 54 Full Release 68K System Monitor User s Guide GE Energy Services QX Query Exchange Continued Syntax continued Example Type gx 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 None Considerations General SWM0023 1 00 2 Full Release 3 55 68K System Monitor GE Energy Services User s Guide RB Resume Brea
23. name process ID group ID priority current run state The response to QP commands that specify processes will include received signals time slice run ticks run count owned memory segments register values at the time of the last swap Current Run This table lists the states that the processes may be in at any time is spawned but not activated is waiting for a pSOS signal Xwait is waiting for a message from another process to arrive at an exchange State Paused has sent a pause request to processor Suspended has been spawned and activated but is not running e This state may be a normal condition or may indicate a fatal configuration or system error Check the WESMAINT Logger to verify Multi Processor For a multi processor system this command displays Displays 3 52 a specific global process summary consisting of its node and local pid or the process summary of all local processes to the node and all global processes in the system SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services QR Query RAM Platform M CPM Mi D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Syntax General Full Release Use this command to examine the RAM allocation and use for either static RAM or NVRAM The Command displays e the memory block sizes e whether they are used and e the total size of available free memory
24. the device If a product delivered to an end user displays these commands a mistake may have occurred Contact GE Energy Services if in doubt General SWM0023 1 00 2 Full Release 3 3 68K System Monitor GE Energy Services User s Guide Section 2 Monitor Commands AL Change Auto logout Timer Platform o CPM o D20 D20 ME D20 200 T D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this 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 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 If the timer is disabled set to 0 the monitor can be locked Considerations out for any other user SWM0023 1 00 2 General Full Release 3 4 68K System Monitor User s Guide BAUD Set Baud Rate Platform Description Syntax About Changing the Baud Rate AN WARNING 1 A WARNING 2 General Full Release GE Energy Services CO CPM 0O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to change the data rate of the WESMAINT port to a user configured value Below is usage and syntax information for this command Command Format baud baud _rate baud rate the new
25. with a list of all active breakpoints in the system and the process ID loop count and register values in hexadecimal It then displays the prompt without affecting the state of any breakpoint Special None Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide PR Profile Platform Description Syntax General Full Release GE Energy Services M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display run time statistics of all processes in the system including e the number of times the process was swapped in e the number of system real time clock ticks occurring during its run periods e the average number of ticks in tenths of a tick per run average e the CPU usage in 10 of percent of the process e the maximum period between watchdog process operations Note Each clock tick is one millisecond Below is usage and syntax information for this command Command Format CPM D20M pr p r CCU CCUME D25 pr p r t Variables print the process profile reset process profile counts print the process profile in the sequence of CPU usage percentage Parameters Example Type pr r and press ENTER Results The command resets the counts associated with process profiling and watchdog run period The system displays any specified data and then returns the prompt Continued on next page SWMO0023 1 00 2 3
26. 0 Base CCU Base CCU Base Use this command to activate a test tool external to the monitor To use a test tool the test tool application must e be included in the software for the system and e 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 Below is usage and syntax information for this command Command Format Variables Parameters proc_name The name ofthe test tool process normally Txxx Example None Required Special If the test tool application is suspended the command will not Considerations function The monitor must detect that the test tool is waiting for a signal before it will proceed SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services TR Trace Platform o CPM o D20 D20 ME D20 200 o D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to track the execution sequence of the processes in the system Syntax Below is usage and syntax information for this command Command Format tr h c s tr d c e lt start_time gt lt end time gt tr r g lt samples gt t0 lt pre_trigger gt lt address gt lt condition gt lt value gt tr r g lt samples gt tl lt pre_trigger gt lt trigger time gt tr r g lt samples gt t2 lt pre_trigger gt lt process nam
27. 25 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 Syntax Below is usage and syntax information for this command 3 82 Command Format D20 CCU CCU ME D25 d Display DSP flash versions Example Type ver and press ENTER D25A gt ver P104 0 GE Harris D25 BOOTROM V2 17 RELEASE 04 August 2000 P114 0 GE Harris D25 Base System V2 27 17 December 1999 ipSOS 68010 Version 4 1 VERSION LEVEL TARGET DATE 211 000 D25 10701799 201 000 D25 08731799 200 000 D25 02704700 100 000 D25 11 23 97 100 000 D25 09703799 227 000 D25 12717799 113 000 D25 11724799 114 000 D25 11703799 116 000 D25 11724799 503 000 D25 06725799 203 000 D25 12715799 306 000 D25 12716799 101 000 D25 03724798 203 000 D25 04 21 98 Results The monitor displays at least the boot code and pSOS version information and returns to the prompt Special None Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide VP Signal Process Platform Description Syntax General Full Release GE Energy Services M CPM M D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to send a pSOS signal to one or several processes Use it during development of
28. 47 GE Energy Services PR Profile Continued Syntax continued 3 48 Special Considerations 68K System Monitor User s Guide Important points to note Data format of the output run count and 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 between sites and remotes SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide PRG Program Flash Platform Description Syntax General Full Release GE Energy Services 0O CPM 0O D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to program a FLASH memory Below is usage and syntax information for this command prg b w 1 address data Variables bytes octets the default mode words long words Parameters address address at which to store the data in hexadecimal data the data to store Example Not Required Special Use with great care Command will change contents of Flash Considerations memory without updating checksum SWMO0023 1 00 2 3 49 68K System Monitor GE Energy Services User s Guide QC Query C
29. ACHE Control Cache Platform Description Syntax 3 8 O CPM Cc D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to enable and disable the CPU s cache Below is usage and syntax information for this command Command Format cache d e Variables disable processor cache enable processor cache Parameters None Example Type cache d and press ENTER The monitor disables the processor cache Special None Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide CAL Calibrate KI Platform Description Syntax General Full Release GE Energy Services O CPM 0O D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base For D200s only Use this command to calibrate the Kernel Interface inter processor communications Below is usage and syntax information for this command Te Variables displays help displays help Special For use by qualified programmer only Considerations SWM0023 1 00 2 3 9 GE Energy Services 68K System Monitor User s Guide CB Clear Breakpoint Platform Description Syntax 3 10 M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to clear breakpoints that are currently set e By specifying a breakpoint number this command clears that breakpoint e By not specifying a breakpoint it clears all defined breakp
30. After entering the command it prompts you with the current contents of a memory location The different display and edit formats supported are e bytes hexadecimal format e words hexadecimal format e floating point numbers hexadecimal format e scientific format scientific format e double precision numbers scientific format When the contents of the memory location appear type e anew value to store at the location e a hyphen to back up one location e a plus sign or the ENTER key to move forward one location CCU D25 only e 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 command differentiates between a negative number and a hyphen Below is usage and syntax information for this command Command Format CPM D20 e b w 1 f d address CCU CCUME D25 e b w 1 f d x address Variables bytes octets the default mode words long words floating point numbers double precision numbers do not display existing contents of memory location being edited Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services E Edit Memory Continued Syntax continued Parameters address address to edit in hexadecimal notation Example Type e 200000 and press ENTER This indicates that you are
31. GE Energy Systems 68K System Monitor User s Guide NOTICE OF COPYRIGHT amp PROPRIETARY RIGHTS TRADEMARK NOTICES ii 2002 General Electric Canada Inc All rights reserved The contents of this manual are the property of General Electric Canada Inc No part of this work may be reproduced or transmitted in any form or by any means except as permitted in written license agreement with General Electric Canada Inc General Electric Canada Inc has made every reasonable attempt to ensure the completeness and accuracy of this document However the information contained in this manual is subject to change 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 permitted by written license agreement with General Electric Canada Inc WESDAC is a registered trademark of General Electric Company General Electric Canada Inc and or GE Harris Energy Control Systems Canada Inc All other brand and product names mentioned in this document are trademarks or registered trademarks of their respective companies SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Servi
32. O Variables boot code area NVRAM area application code area global NVRAM area Parameters 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 message Checksum is___and shouldbe _ A new prompt appears Special Performing cs on flash memory will require 5 to 10 minutes Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide D Dump Memory Platform Description Syntax General Full Release GE Energy Services M CPM M D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 e bytes hexadecimal format e words hexadecimal format e long words hexadecimal format e floating point numbers scientific format scientific format e double precision numbers then 16 ASCII characters representing the same memory values If an octet does not have a printable ASCH representation the monitor will print a dot instead Below is usage and syntax information for this command d Xb w 1 f d beg_addr end_addr Variables by
33. Special This command is not available on the CPM Considerations sA This command is not available if the D 20 B003 application is active SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide Platform GE Energy Services IMG Display Image Information Oo CPM oO D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Syntax General Full Release 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 Ifany 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 Below is usage and syntax information for this command Command Format img Example Type img and press ENTER Results The monitor displays information on the FLASH BootROM and configuration images currently active in the system Special None Considerations SWM0023 1 00 2 3 41 GE Energy Services 68K System Monitor User s Guide JTF Jump To Flash Platform Description Syntax WARNING 3
34. application software Below is usage and syntax information for this command Command Format CPM D20 D25 vp pid name event CCU CCUME vp pid gpid name event Variables Parameters i pSOS process ID in hexadecimal send the signal to a specific process global pSOS process ID in hexadecimal send the signal to a specific process case sensitive process name 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 hexadecimal format word of the bits with which to signal the process es Example Type vp 308048 1000 and press ENTER This signals the process with pSOS ID 308048 with the 13th bit 1 e bit 12 zero based Results 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 You must only use this command as a testing or debugging Considerations mechanism If you send an indiscriminate signal to a process you cannot predict the results Note The safe way to restore a system to normal operation after using this command is to reboot SWM0023 1 00 2 3 83 68K System Monitor GE Energy Services User s Guide WINM WIN Metrics Platform o CPM o D20 D20 ME D20 200 o D20 200 ME D25 D20 Ba
35. ase beast hci hck ese lSa cb snot snub cates dee aai cuca 3 17 CS SHCN ECKL estrus ects tact tesa Cotes E A atone tonstyryets 3 18 D DUMP MEMOTY i iissseieccicckesechcasceudecsssececus beste a a aea a aereis aare atat 3 19 DB Define Breakpoint issia EA E E EEE e 3 21 DEBUG Debus Moden meiron a a E EE OEE E 3 22 DF Display Fle D ta rererere eine ee e i a E 3 23 DHW Display Hardware Data reniei et i E E RE 3 24 DIR A DDC CON A E E N A 3 25 DL lt Dowiload mecs pior r a Ea E e aa aE eraa aE R e 3 27 DM Debug Moder eraa na e A A E e E E A 3 28 General SWM0023 1 00 2 Full Release GE Energy Services Index vi DSTAT ECHO ERASE ETH EXIT F FT HE or HELP HT IMG JTF JX KIM M PB PR RTB RTC SA SB SET SI SP ST SX SYSC TEST TR UL VER WINM 68K System Monitor User s Guide Decompression Status ccccccccccsseceseceseceeecseeeseeeesseceseeeseecsaecaecsseeneenaeens 3 29 Edit MeMO eiinoeoooe eet Ere iE T E EE E i a i 3 30 Echo Toggle mime a e a E A E a eae 3 32 SETO LOG ciani n a a aed a a e ae ia tat 3 33 Flash Erase sis sevicesteseecijosieckon vesast a a a a E a a a aR 3 34 sBthernet Address enee a a T a a E E TE a e E E ER 3 35 EXIT preden Voe e E E e E E E E E E T TR 3 36 a aT I AY KE a ta p A eE EE E EEEE EEE E E EE 3 37 Find Table er ce cares at clan oaa at e E E A A A e 3 38 SHON o E E EE EREA E A E 3 39 HDLEC Testere a a A a e E E ea 3 40 Display Image Information
36. ata 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 e executing from the BootROM and e 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 Below is usage and syntax information for this command rz Vlevel Mtimeout Ctimeout Wwindow Variables Vlevel 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 Before the start of the download the system must suspend all Considerations non protected process running in the system e If there are parameters on the command line the monitor assumes that the D25 initiated the download and allows 20 seconds for the user to activate the software that will send data to the D25 If there are no parameters the monitor assumes that the sending software initiated the download a
37. attern 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 hexadecimal Example Type sx 304540 1 2 3 4 and press ENTER This sends a message identified as 304540 The command sets the first two reserved messages to 0 Results The system displays the prompt unless it encounters an error In this case it displays an error message before displaying the prompt Special You must only use this command in a testing or debugging Considerations context If you send a message to an exchange indiscriminately you cannot predict the results SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide SYSC System Platform Description Syntax General Full Release GE Energy Services O CPM Cc D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to reset the reboot counter to zero Below is usage and syntax information for this command Command Format sysc command Variables n help Parameters command rcount Example Type sysc rcount and press ENTER Results The reboot counter will be reset to 0 Special None Considerations SWM0023 1 00 2 3 77 GE Energy Services 68K System Monitor User s Guide TEST Invoke Test Tool Platform Description Syntax 3 78 O CPM O D20 D20 ME D20 200 Iv D20 200 ME D25 D20 Base D2
38. ces Modification Record VERSION REVISION DATE INITIALS COMMENT 28 Feb 2002 RFN Created 20 Mar 2002 RFN Corrected errors as per review General SWM0023 1 00 2 Full Release iii 68K System Monitor GE Energy Services User s Guide SWM0023 1 00 2 General iv Full Release Table of Contents About This Document Purpose and Audience of this User s Guide cccccsccssccesscsssceseceseceseeesecseeeseeeeseeeeseeeseeeseeeaecsaes viii Support Services and Training ccccesccesccessecssecseceseceseceseceseceeecseeeeeseeeseeeseeeseeceseeeseeeseeeseeeaeesaees ix Chapter 1 Connecting and Using the 68K Monitor Connecting to the 68K Monitor c cecceccccsssessseeseeescecseeesaeceseceseceaecsaeceaeceseesseeseeeseeeseseseeeeaeesaes 1 2 Command Input and Respomse cccccsccesccesscssseeesceeseeeseeeseecseecsaecsaecsaeceaeceseeeeeseeeseseeeseeeseeeaeesaes 1 3 O8K Monitor Display ienee t cc EEEE e cages ceva ened ha aes eee Sa eee een oe eee CS 1 6 Error Messages aean see tack aena sE aea aaa E tence a A E Ea aE e sages a N ANA ENS 1 7 Chapter 2 Command Grouping General System Commands vei neek erropa Ee a deur east tc erence cease sd Ee EEE EEEa AEE os EEEE RE 2 2 Diagnostic Commands strecis rino acstastadetstvonnsdecdiesetel oe eaS anea i EE E a OOE na Seade iE 2 3 Memioty Commands ys eea a a a a a A A a A AE A EE a t 2 4 Process Comma ndS rssiiseiin aea a E E E E e aE E E aie eee 2 5 Exchange Commands c eveccedccevsctca
39. configuration storage space After that it expects to be only rarely invoked General SWM0023 1 00 2 Full Release 3 13 GE Energy Services 68K System Monitor User s Guide CCF Clear Configuration File Platform Description Syntax 3 14 0O CPM O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to erase the specified configuration file The command clears all contents of the file and it clears all attribute flags as well Below is usage and syntax information for this command Command Format Variables 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 the contents of stored configuration 1 Special Used only when multiple storage regions are defined Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide CF Copy File Platform Description Syntax General Full Release GE Energy Services O CPM 0O D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 an
40. d 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 GE Energy Services 68K System Monitor User s Guide SB Step Breakpoint Platform Description Syntax 3 68 M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command sb break_pt instructions 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 Additionally each time it completes a program step the system displays the breakpoint number instruction count and register values If the instruction count is greater t
41. ddress Example Special Do not use unless qualified Considerations Address change is permanent and will stay in D25 XCOM hardware even if moved to another D25 General SWM0023 1 00 2 Full Release 3 35 GE Energy Services EXIT Exit Platform Description Syntax 3 36 68K System Monitor User s Guide M CPM M D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Example Type exit and press ENTER Results The monitor returns control to the calling routine Special The task that started the 68K Monitor must still exist and be Considerations running i e not suspended This command automatically clears all active breakpoints but does not perform any other clean up operations This means that if you enable debug mode if something has suspended processes or any other system alterations made they will remain in effect even after exiting the monitor SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide F Fill Memory Platform Description Syntax General Full Release GE Energy Services M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to repeatedly write a value to a specified region of memory
42. e and CPM ENTER executes any command that has been entered on the command line BACKSPACE removes the last character from the end of the current command line and moves the cursor one character position to the left Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services Command Input and Response Continued Regular Keyboard Input continued Special Control You can use these special control characters to perform advanced editing and screen Characters navigation functions Abort CTRL C returns the Monitor to the command line prompt and aborts most commands being processed Note a CTRL C command does not work in a TELNET connection Delete CTRL D deletes the current character of the previous command line CTRL I or toggles the current mode to from overwrite or TAB 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 from the character at the previous command reference location up to the end of the previous command buffer into the current input command buffer Note D20ME and D25 have a 5 line command buffer Execute CTRL X copies t
43. e gt Variables display help clear all stop collection display gathered data c continuous display e format for spread sheets gather data 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 samples to store before the trigger address the watch address to trigger on condition Condition to watch for lt gt lt gt change value value to watch for trigger time RTC time to trigger process name name of process to trigger on Continued on next page General SWM0023 1 00 2 Full Release 3 79 68K System Monitor GE Energy Services User s Guide TR Trace Continued Example 1 Type tr r 20 40 10 208000 12345678 and press ENTER Results This will allocate a buffer for 20 samples and triggers when the long memory location becomes 12345678 It saves 10 samples before the trigger the trigger sample and 9 samples more to fill the buffer Example 2 Type tr r 20 0 10 208000 change and press ENTER Results This triggers if the long memory location changes value Example 3 Type tr r 20 0 10 208000 12345678 and press ENTER Results This triggers if long memory value changes from the value 12345678 Example 4 Type tr r 20 tl 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
44. ease 68K System Monitor User s Guide GE Energy Services Diagnostic Commands Description You can use these diagnostic commands for debugging performance analysis and hardware system testing List of This list shows the Diagnostic commands in alphabetical order Commands M Km Zz General SWM0023 1 00 2 Full Release 2 3 68K System Monitor GE Energy Services User s Guide Memory Commands Description Use these memory commands to identify or change the contents of memory in the system List of This list shows the Memory commands in alphabetical order Commands Se ERASE Program Flash Because executing these commands modifies the memory of your system they can disrupt operation WARNING Use caution before proceeding SWM0023 1 00 2 General 2 4 Full Release 68K System Monitor User s Guide GE Energy Services 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 List of This list shows the Process commands in alphabetical order Commands General SWM0023 1 00 2 Full Release 2 5 68K System Monitor GE Energy Services User s Guide 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 List of
45. ecial Considerations 68K System Monitor User s Guide 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 SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide DL Download Platform Description Syntax A WARNING General Full Release GE Energy Services Mi CPM M D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 gt or the D20MEA gt 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 SO 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 Below is usage and syntax information for this command Command F
46. 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 An attempt to display non existent memory or modify Considerations EPROM memory results in a bus error You may modify systems with FLASH EPROM such as the D25 and CCUME using this command General SWM0023 1 00 2 Full Release 3 31 GE Energy Services 68K System Monitor User s Guide ECHO Echo Toggle Platform Description Syntax 3 32 O CPM O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Command Format echo on off Variables Parameters turns command line echoing on turns command line echoing off Example Type echo off and press ENTER Results The monitor no longer displays your keystrokes as you type Special Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services EL Error Log Platform v CPM v D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to display and delete system
47. eeseceecseceeceseeeaecneceeeneeees 3 71 Suspend PTOCES Si a n E a a e a E 3 72 Serial Testre e tae N e a aae a a eta OR an aa RE 3 74 gt Send Exchange aiai a a a E a A a E A 3 76 EPS VSLETIN eE E E E E E E A E NA 3 77 Invoke Test Tool risani raa neki hie E a A E E 3 78 STAC A EE A AEE A E E E O N EET 3 79 Oo e Te E E A O ER 3 81 s Versione A ae ese a E E e E E aa EE EAE Ea EES ES 3 82 Signal Process sooi Hearn aeons ca A E as 3 83 SWIN MECS aoran aane en a a E Aa 3 84 SWM0023 1 00 2 General Full Release About This Document 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 Purpose and Audience of this User s Guide Support Services and Training General SWM0023 1 00 2 Full Release vii GE Energy Services 68K System Monitor User s Guide
48. efined serial port transmits and receives a series of characters of different formats e manually forcing the mark or space line states from the RS 232 drivers allows you to monitor and adjust modem levels or frequencies Below is usage and syntax information for this command Command Format CPM D20 st f I port CCU CCUME D25 st f I port baud Variables force mark or space states automatic loop back test Parameters serial port to test COM 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 CTRL C The loop back test terminates either on an error or on completion of the test The monitor displays the prompt after stopping either test Special These tests temporarily assume control of the specified Considerations communications port and disrupt any current activity They may also depending on the application affect subsequent operation To ensure that you avoid this you must reboot the system when you complete all testing Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services ST Serial Test Continued Loop Test Adapter Selectable Data Rates A WARNING General Full Release T
49. em at a very low level At this low level it is easy to seriously disrupt an operational system You must be aware of this possibility at all times There are no procedures in this document as users should already be familiar with accessing and using GE Energy Services WESMAINT and monitor maintenance facilities This manual uses the Systeme International SI and the Microsoft Manual of Style as a basis for styles and conventions SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services Support Services and Training General Need Help Website Technical Support Contacting Us General Full Release GE Energy Services provides professional assistance in the use of all of its software and hardware products If you feel that the information provided in this document is unclear or in error please contact GE Energy Services for assistance http www gepower com geharrisenergy Unlimited access is available to a wide variety of information and company services including e product information e training and e technical services Representatives are available Monday through Friday 8 00 a m to 5 00 p m Mountain Time GE Energy Services Toll Free 1 800 518 2303 2728 Hopewell Place NE Phone 1 403 214 4600 Calgary Alberta Canada Fax 1 403 243 1815 TLY 7J7 email GEH_Calgary Support ps ge com SWM0023 1 00 2 ix 68K System Monitor GE Energy Servic
50. es User s Guide SWM0023 1 00 2 General x Full Release Chapter 1 Connecting and Using the 68K Overview Connect Defined In This Chapter General Full Release Monitor 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 e WESMAINT or the Login Process can connect the 68K Monitor to a serial port e 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 This Chapter of the document contains the following topics Connecting to the 68K Monitor Command Input and Response 68K Monitor Display Error Messages SWM0023 1 00 2 GE Energy Services 68K System Monitor User s Guide Connecting to the 68K Monitor One 68K Monitor At A Time 68K Monitor Prompts Examples Terminating a 68K Monitor TELNET Session Auto Logout Timer While any application running in the system can activate the 68K Monitor only one instance of the monitor can be active at any one time If a second application attempts to start the 68K Monitor it will refuse the second application s request The prompt produced by the 68K Monitor depends on the hardware platform and the mode t
51. escription Syntax General Full Release GE Energy Services M CPM M D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to force a message to the beginning of the message queue at one or more exchanges Below is usage and syntax information for this command Command Format CPM D20 D25 jx xid name m2 m3 m4 m5 CCU CCUME jx xid gxid name m2 m3 m4 m5 g Variables g Allows the message to be jammed into a queue in a different node Parameters xid pSOS exchange ID in hexadecimal send message to a specific exchange gxid global exchange ID in hexadecimal send message to a specific exchange 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 message in hexadecimal Example Type jx 304540 1 2 3 4 and press ENTER This sends a message to an exchange identified as 304540 The command sets the first two reserved messages to 0 Results Unless it encounters an error the system displays the prompt In the case of an error it displays an error message before the prompt Special You must only use this command in a testing or deb
52. ess 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 200400 up to 200600 The system displays the prompt when it completes this instruction Special An attempt to move to EPROM or non existent memory will Considerations result in a bus error You can modify systems with FLASH EPROM such as the D25 and CCUME using this command SWM0023 1 00 2 3 45 GE Energy Services 68K System Monitor User s Guide PB Print Breakpoint Platform Description Syntax 3 46 M CPM Mi D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Command Format pb break_pt Variables Parameters break_pt breakpoint number as returned with the defined breakpoint command Example Type pb and press ENTER Results Ifthe system encounters a breakpoint it responds
53. g the character representing the attribute c o or r followed by to add it or to remove it The same command can change any of the attributes You can enter the same attribute multiple times but only the last entry will take effect You can separate each attribute by a space but do no separate the attribute and its add subtract character and any other characters on the command line will result in an error General SWM0023 1 00 2 Full Release 3 11 68K System Monitor GE Energy Services User s Guide CCB Create Configuration Storage Block Platform o CPM o D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 e The Monitor invalidates any existing storage block before creating the new one Ifrequested 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 Syntax Below is usage and syntax information for this command N Any existing stored configurations will be lost when this command is invoked WARNING Co
54. han zero it is decremented Otherwise the process is suspended Special None Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide SC Select Active Configuration Platform Description Syntax General Full Release GE Energy Services 0O CPM 0O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command sc file num file name BaseAddress 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 select The command will select the first matching configuration it finds BaseAddress base address at which to write the new configuration Example Type sc config bin and press ENTER Results The monitor selects the stored configurat
55. he automatic loop back test requires this DB 9 pin loop back connector UO DCI RX TXD RTS CTS EA oo yy ww Ne 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 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 communication port SWM0023 1 00 2 3 75 GE Energy Services 68K System Monitor User s Guide SX Send Exchange Platform Description Syntax 3 76 Mi CPM Mi D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to queue a message at one or more exchanges Below is usage and syntax information for this command Command Format CPM D20 D25 sx xid name m2 m3 m4 m5 CCU CCUME sx xid gxid name m2 m3 m4 m5 g Variables g Allows the message to be sent to a queue ina different node Parameters i pSOS exchange ID in hexadecimal send message to a specific exchange global pSOS exchange ID in hexadecimal send message to a specific exchange 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 p
56. he device is in As examples The table below shows examples of the prompts that you may see on various devices in different modes of operation When this is operating out of you will see this device prompt D25 BootROM this is known as the System D25S gt Monitor FLASH this is known as the Application D25A gt 2 D20 ME Service Service Mode S D20MES gt CPM or Any Mode D20M gt D20M The 68K Monitor will detect a loss of connection in a TELNET session and will end the monitor session allowing a new connection to be established The 68K Monitor itself never terminates or initiates a TELNET session Whatever process starts the 68K Monitor handles this functionality Since only one 68K Monitor session is allowed at a time it automatically terminates 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 SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services Command Input and Response Input to the 68K Monitor Command Line Limitations Command Format Common Command Syntax List of Characters General Full Release Input to the 68K Monitor is read from the connected application subsystem The input takes the form of user entered commands The 68K Monitor accepts a command line e that is no longe
57. he file config bin in a manner similar to the dump command Special By not providing any other switch the command selects the Considerations binary dump format and is identical to the dump memory command format except that it lacks the address prefix SWMO0023 1 00 2 3 23 GE Energy Services 68K System Monitor User s Guide DHW Display Hardware Data Platform Description Syntax 3 24 0O CPM Cc D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display information on the hardware configuration of the D25 The provided information consists of e size and base address of all memory regions e DSP and XCOM type e state of the auxiliary output and sysfail signal and e EPLD and PCB revision numbers Below is usage and syntax information for this command Example Type dhw and press ENTER ID25A gt dhw 0x0800000 Size NVRAM region base address Ox0820000 Size SRAM region base address Ox0920000 Size 0x0200000 Size Ox0000000 Size Qx2000000 Size Ox0006800 Size IBOOTROM base address 0x0080000 Size Local I 0 base address 0x3000000 Size 0x1000000 Size Ox2000000 Size NVA 0x0820000 128K wae Ox081B000 108K yp 2 Current Bank 0 1 0 1 Ethernet Address Primary 00 00 C3 FE 06 68 Ethernet Address Secondary 00 00 C3 FE 06 69 ISYSFAIL signal state More Results A comprehensive list of hardware and memory info
58. he most previously used command to the command line and executes it CTRL S the combination of CTRL S Xoff and CTRL Q and CTRL Q Xon stops and starts scrolling of the monitor s display General SWM0023 1 00 2 Full Release 1 5 GE Energy Services 68K System Monitor User s Guide 68K Monitor Display Output from the 68K Monitor Display Output An Example 1 6 The 68K Monitor s output is a stream of ASCII characters written back to the 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 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 e 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 e 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 ApSOS exchange sends this data including unassigned exception and breakpoint data di
59. iables disable debug mode Enable cache or disable show cycles enable debug mode disable cache or enable show cycles Parameters Example Type dm e and press enter Results This command disables the 68020 or 68EC030 on chip instruction cache or enables show cycles for the 68332 The system returns the prompt upon completion of this instruction Special Enabling the Debug Mode degrades the performance of the Considerations system and may cause certain CPU intensive commands to activate the watchdog and reset the system SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide DSTAT Decompression Status Platform Description Syntax General Full Release GE Energy Services Cc CPM 0O D20 D20 ME D20 200 Cc D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to view status of file copy command progress and success Below is usage and syntax information for this command su Variables leave immediately default maintain connection until process complete showing progress while connected Special None Considerations SWMO0023 1 00 2 3 29 GE Energy Services 68K System Monitor User s Guide E Edit Memory Platform Description Syntax 3 30 Mi CPM Mi D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display and modify memory locations The command does not verify memory contents after they are stored
60. id name Variables Parameters suspend all unprotected processes pSOS process ID in hexadecimal suspend a specific process global pSOS process ID in hexadecimal suspend a specific process case sensitive process name The monitor supports the new process naming convention If you enter an entire name a specific process is suspended If you enter the first few characters the command attempts pattern matching All matching processes are suspended Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services SP Suspend Process Continued Syntax continued Example Type sp and press ENTER Results This suspends 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 This function stops the execution of tasks within the remote Considerations 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 General SWM0023 1 00 2 Full Release 3 73 GE Energy Services 68K System Monitor User s Guide ST Serial Test Platform Description Syntax 3 74 M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to start one of these two serial port test procedures e an automatic loop back test of the d
61. ies ae EE E E E REEE A ceed ET iie 2 6 Breakpoint Commands vce ireen eeaeee eE EE EEE EEA E EREE ET 2 7 Configuration Maintenance Commands ccccccsscessecssecsseeesseessecaeceseceseceseeseeseeeeeseeeeeeseeeeeneeeaes 2 8 Chapter 3 68K Monitor Commands Section 1 Command Platform Cross Reference cccceceescessesseeseceeeeseeeceaecaeeeeeeseeeseesecnaeeaeeeeeeas 3 2 Platform Specific Commands 0 cccccsccssccssseesseesecssecesecesecesecsecseeecnsecsseeeeeseeeeeeeceseeeseeeeeeneeeeaes 3 2 Section 2 Monitor Commands wseresisicti niatan iiare i i iii a i 3 4 AL Change Auto logout Timer ccccccecccssscessceseeeeeeeeeeeceecneecseeeeeseeeeeseeeaes 3 4 BAUD S S EUIBAUC Rate ecezs sel esate hla eect ia cosetas tastes Fen cndelate cat detansntet E 3 5 BOOT Starp eria r E E E E E anh srandbesteeaeuss a 3 7 CACHE 2 Control Cacher ea a E A A EA 3 8 CAL Calibrate Korena n N N E E a 3 9 CB Clear Breakpoint essnee eae eat EEE E E E a A iaeedt 3 10 CCA Change Configuration File Attributes cccccccssecsseceseeesteesteeseeeeeeseens 3 11 CCB Create Configuration Storage BIOCK ccccccesceeseeteeeseeeseeseceeenseenaeees 3 12 CCF Clear Configuration File ccccceccccsscessecessceeeceeeeeeseceseeeseeesaeeseeesseseseenseens 3 14 CF COPY Filersassenannre anaa a a a th autbateen eed ent a ons ie 3 15 CLS sG lear Sereen edron Da on cg ecesan cee ve a un EE EEE e ode leben ete fdas 3 16 CP s han ge Print ceryan See e
62. ion config bin as the active configuration and copies it into NVRAM overwriting the existing configuration Special Once this function is invoked it may take some time for the Considerations configuration to be decompressed if necessary and written into memory SWM0023 1 00 2 3 69 GE Energy Services 68K System Monitor User s Guide SET Set System Parameters Platform Description Syntax 3 70 O CPM O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Note This command is for developers only Use this command to quickly modify options in code during run time Below is usage and syntax information for this command set h lt option gt d lt parameters gt Variables Parameters option depends on application parameters depends on application Example Not required Special Very dangerous to use only for programmers Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide SI Display System Information Platform Description Syntax General Full Release GE Energy Services 0O CPM 0O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display information on the hardware software and current configuration of the device Below is usage and syntax information for this command Example Type si and press ENTER 0x0800000 Size Bytes NVRAM region base address 0z0820000 Size
63. ions currently configured in the system e Ona D25 platform this command reports the base addresses of the RAM and NVRAM regions and the size of the NVRAM region e 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 Below is usage and syntax information for this command Command Format rr Example Type rr and press ENTER Results The monitor displays the information about existing RAM configuration Special Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide RT RAM Test Platform Description Syntax General Full Release GE Energy Services M CPM M D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Ifthe input range is not on long word boundary set the range ending address to the first lesser word boundary Below is usage and syntax information for this command Command Format CPM D20 rt 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
64. kpoint Platform T CPM T D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Syntax Below is usage and syntax information for this command ek pa 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 breakpoint address Results The system responds with the prompt Whenever it encounters a breakpoint the system displays the breakpoint number loop count and register values If the loop count is greater than zero it is decremented Otherwise the process is suspended Special None Considerations SWM0023 1 00 2 General 3 56 Full Release 68K System Monitor User s Guide GE Energy Services RP Resume Process Platform Vv CPM v D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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
65. le commands are Warm Boot Return To BOOTROM Jump Into FLASH Check Sum Down Load Up Load Exit Monitor Find Table Help Info Help Info Version Info Error Log Profile Query RAM Ram Test Serial Analyser Serial Test Dump Memory Edit Memory Fill Memory Move Memory Query Process Resume Process Suspend Process Signal Process Query Exchange Jam Exchange Req Exchange Send Exchange Clear Break Pt Define Break Pt Print Break Pt Resume Break Pt Step Break Pt Table Directory Display HW data More Results System displays a list of available monitor commands and returns either to the prompt or will prompt you with More to press any character to display the rest of the list Special Considerations General SWM0023 1 00 2 Full Release 3 39 GE Energy Services 68K System Monitor User s Guide HT HDLC Test Platform Description Syntax 3 40 O CPM M D20 D20 ME D20 200 Mi D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Commana Format FIST Variables configure the link parameters define the application message read monitor the link display configuration status send an application message
66. mmand Format ccb n v r base_address total ram response_file_size num cfgs nvram base Variables Build configuration block in global NVRAM region using the base_address supplied Allocate the configuration block from normal RAM ignoring the base address Reset CCB Old CCB is cleared before new one created Parameters base_address Address of start of configuration storage region in hexadecimal must be present even if it s just zero for RAM configuration blocks total ram Total amount of NVRAM allocated to the region in bytes response file size Size of response file in bytes num_cfgs Total number of configurations to store maximum of 2 nvram_base Address of start of NVRAM region Continued on next page SWM0023 1 00 2 General 3 12 Full Release 68K System Monitor User s Guide GE Energy Services CCB Create Configuration Storage Block Continued Parameters continued Example Type ccb 600000 100000 400 2 and press ENTER Results The monitor creates a configuration storage control 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 Use this command primarily when the system first initializes Considerations in order to set up the
67. nd it will not provide a wait period The command rz is the standard prefix used by the ZMODEM binary protocol to start a file transfer A terminal using this command can connect to the D25 Monitor and simply start sending ZMODEM data without any further user input to the D25 Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services RZ ZMODEM Download Continued A WARNING Note KS General Full Release Executing this command modifies the memory of the D25 and can cause operational disruption 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 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 SWM0023 1 00 2 3 65 GE Energy Services 68K System Monitor User s Guide SA Serial Analyzer Platform Description Syntax Error Codes Display F
68. of the Flash memory region resetting all bytes in Flash to OxFF in preparation for application data download Below is usage and syntax information for this command Command Format D25 erase d y D20 ME CCUME erase y Parameters d erase DSP Flash ly disable the verification prompts Example Type erase and press ENTER Results If you confirm the erase prompt the command erases the Flash EPROM Special The command prompt will return if Flash is already clear when Considerations the erase command is invoked Otherwise the command prompts the user to confirm the Flash erase If you enter any response other than y the command aborts the erase Executing this command modifies RTU memory and will cause operational disruption specifically by destroying all Flash application code Do not use this command unless you are prepared to perform a code download procedure Use caution before proceeding SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services ETH Ethernet Address Platform o CPM o D20 D20 ME D20 200 o D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command 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 a
69. oints 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 Below is usage and syntax information for this command si pe break_pt breakpoint number default is all breakpoints Example Type cb 3 and press ENTER This clears breakpoint number 3 Results The system displays the prompt Special None Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services CCA Change Configuration File Attributes Platform o CPM o D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to modify the configuration file attributes for a given configuration file Overwrites the old attributes with the new attributes Syntax Below is usage and syntax information for this command Command Format cca file num Parameters file num The query configuration storage parameters command displays all existing files 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 When this command is invoked the user is provided with the Considerations current attributes of the file using the characters e currently selected file e opened and e r corrupt The user is expected to enter the attributes to change by typin
70. onfiguration Storage Parameters Platform CPM D20 D20 ME D20 200 D20 200 ME D25 0 0 D20 Base D20 Base CCU Base M CCU Base Description Use this command to display the contents of the configuration storage block providing information such as e how many configurations are stored in the system e how much memory is allocated to configuration storage and e 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 Syntax Below is usage and syntax information for this command Example Type gc and press ENTER Results The monitor displays the information about existing configuration storage Special None Considerations SWM0023 1 00 2 General 3 50 Full Release 68K System Monitor User s Guide QP Query Process Platform Description Syntax General Full Release GE Energy Services M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to display the e general status of all currently active processes e general status of specific processes or e detailed information about one currently active process Below is usage and syntax information for this command Command Format CPM D20 D25 qp pid name CCU
71. ormat 3 66 M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command port serial port to monitor COM Example Type sa com7 and press ENTER Results This 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 This function cannot be used on the port assigned to 68K Considerations Monitor COMO the SPI port _ SPI or the SCC1 port SCC1 This function is completely non intrusive It cannot affect the operation of the application that owns the monitored port 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 The monitor displays all data transmitted and received in hexadecimal format Transmit data is displayed in inverse video receive data is normal video mode Continued on next page SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services SA Serial Analyzer Continue
72. ormat D25 CCUME dl o offset CPM D20 CCU dl offset the offset at which to download o specifies that an offset follows Example Type dl and press ENTER Results This prepares the monitor to receive Motorola S records over the serial port The monitor does not echo any further until it encounters an end record the prompt returns at this point or a format or record checksum error this returns an error message before returning the prompt Special Each S record terminated by a carriage return or line feed Considerations cannot exceed 80 decimal bytes in length Application code download works ONLY when e The BootROM code is being executed AND e The FLASH region has been erased Executing this command modifies the memory of the system and can cause operational disruption Use caution before proceeding SWMO0023 1 00 2 3 27 GE Energy Services 68K System Monitor User s Guide DM Debug Mode Platform Description Syntax 3 28 Mi CPM Mi D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to enable or disable product specific debugging modes e For the 68020 D20M and 68EC030 D20 ME it disables the on chip instruction cache e For the 68332 CPM it enables show cycles When enabled both of these debug mode instructions allow external bus monitoring Below is usage and syntax information for this command Command Format dm d e Var
73. other depending on the support for copying provided by the File System Driver that owns the files Below is usage and syntax information for this command Command Format cf source_file destination _file 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 configuration or FLASH program information DSP or application into its destination region this name is optional and unnecessary Example Type cf flash zlb and press ENTER Results The monitor copies the file flash z b into Flash EPROM Special Once invoking this function it may take some time for the Considerations command to write the file into its destination especially if it consists of compressed configuration or FLASH program information DSP or application SWM0023 1 00 2 3 15 68K System Monitor GE Energy Services User s Guide CLS Clear Screen Platform o CPM go D20 D20 ME D20 200 o D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to clear the monitor s screen Syntax Below is usage and syntax information for this command Command Format Variables Parameters Example None Required S
74. pecial None Considerations SWM0023 1 00 2 General 3 16 Full Release 68K System Monitor User s Guide GE Energy Services CP Change Priority Platform go CPM o D20 D20 ME D20 200 v D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to change the current priority of an existing process Syntax Below is usage and syntax information for this command Command Format cp h pid PName delta abs Variables h display help Parameters i PID number name of the process the priority change to be made A negative value reduces priority A positive value adds priority the final priority of process after change in Hex Example Type cp WESO 20 and press ENTER Results The monitor increases the priority of process WESO by delta 0x20 Note Process Task names like WESO are case sensitive Special If you use this command to change the priority of the IDLE Considerations process the system will reboot General SWM0023 1 00 2 Full Release 3 17 GE Energy Services 68K System Monitor User s Guide CS Check Sum Platform Description Syntax 3 18 M CPM Mi D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to perform a checksum or 32 bit CRC of either the boot code area NVRAM area or application code area Below is usage and syntax information for this command Command Format CPM D20 D25 cs b n p e ucam eama
75. r GE Energy Services User s Guide BAUD Set Baud Rate Continued Supported The supported data rates in bps are Speeds D25 has a maximum speed of 38400 bps 1050 4800 38400 1200 7200 57600 1800 9600 115200 2000 14400 230400 SWM0023 1 00 2 General 3 6 Full Release 68K System Monitor User s Guide GE Energy Services BOOT Startup Platform v CPM T D20 D20 ME D20 200 T D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Description Use this command to remove all defined Monitor breakpoints and then force the Syntax General Full Release system to go through its lowest level start up This ensures that the system is properly re initialized after testing system manipulating or downloading Below is usage and syntax information for this command Command Format CPM D20 D20ME CCU CCUME boot boot delay Variables delay number of milliseconds to wait before the boot is performed Parameters hi 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 series of messages relating to hardware and software initialization Special This command will automatically clear all breakpoints before Considerations execution This command causes all processors in a multi processor system to reboot SWM0023 1 00 2 GE Energy Services 68K System Monitor User s Guide C
76. r than 80 characters and e consists of no more than 16 separate words or symbols The definition of a word or string is one or more characters separated by one or more spaces Input may be either upper or lower case except where noted Input may be either upper or lower case The format of all commands is as follows lt command_name gt lt parameters arguments gt Where e command_name is one of the recognized commands and e parameter arguments are an optional list of command parameters 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 This tables lists some of the characters used in command syntax 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 Continued on next page SWM0023 1 00 2 GE Energy Services 68K System Monitor User s Guide Command Input and Response Continued Possible Responses An Example the EDIT Command Entering Commands Regular Keyboard
77. rmation is displayed Special Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide DIR Directory Platform Description Syntax General Full Release GE Energy Services 0O CPM 0O D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Command Format D25 dir n p CCU CCUME dir 1 g Variables local NVRAM database tables default global NVRAM database tables EPROM Flash default configuration database tables D25 NVRAM D25 Flash Parameters Example ADDRESS of RECORDS RECORD SIZE 820100 0 6 dd795a 1104 82020c 8 820254 829a18 829a74 829ae0 829c58 829eec 82a0c8 82a140 82a248 82a2b4 82a320 82d7fc 824930 82ddbe 82e754 830e88 82e7a4 Results The monitor displays the above information for all NVRAM database tables At the end of every full screen the monitor prompts More and will continue when any key is pressed Continued on next page SWMO0023 1 00 2 3 25 GE Energy Services DIR Directory Continued Syntax continued 3 26 Sp
78. s is suspended Special You may define only one breakpoint at a single address to a Considerations maximum of ten breakpoints per system An attempt to define a breakpoint in read only or non existent memory results in a bus error SWM0023 1 00 2 3 21 GE Energy Services 68K System Monitor User s Guide DEBUG Debug Mode Platform Description Syntax 3 22 O CPM O D20 D20 ME D20 200 gO D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 Below is usage and syntax information for this command Command Format DEBUG Example Type DEBUG and press ENTER Results The output displays 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 accurate Y N Any response other than
79. se D20 Base CCU Base CCU Base 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 lt refer to code gt Example Not required Special Requires special code to use this command Considerations SWM0023 1 00 2 General 3 84 Full Release Index B Boot Command Calibrate KI Command CP E EA E E Copy File Command CE datae A a Create Configuration Storage Block Command C o EEPE E EEEE E E D Debug Mode Command Decompression Status Command DSTA Todar a A ae Define Breakpoint Command DIRA eesi tosis aAA E E ERA NRR DDE E AE A General Full Release Download Command Daen a a EA as E 3 7 E Echo Toggle Command ECHO crine iaie oe Edit Memory Command 3 9 l EE EE E E 7 Error Log Command 3 4 e EEE lest ain sei teen alate tote es 7 Ethernet Address Command 3 11 ETH E ae Exit Command 3 17 EXI erene a 3 18 F 3 10 Fill Memory Command 3 14 TEE A E E Find Table Command 3 16 i e AE E A EAT Flash Erase Command 3 8 PRASE A A uate 3 15 H 3 12 HDLC Test HD eee ee E A A Help Command HELP rre Sa 3 22 3 28 I aed Invoke Test Tool Command 3 21 TES Tiaa i an t SUSI 3 25 J 3 23 Jam Exchange Command 3 24 JX ae Biman Gk a A O Oe Jump To Flash Command 3 41 JEE aaea eA as 3 71 SWM0023 1 00 2 GE Energy
80. splays to the output process 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 SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide GE Energy Services 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 This Message is displayed when Application which a process or user requests an exit command but the activated the monitor process that called 68K Monitor is suspended or has been deleted or deleted suspended Breakpoint defined the specified address is already defined as a breakpoint the monitor will display this message when defining a new breakpoint DB Breakpoint not a breakpoint was not encountered when attempting a suspended resume RB or
81. step SB breakpoint command Cannot post to a send SX or jam JX exchange command encounters exchange 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 found the specified command is not located within 68K Monitor s command list FLASH invalid a directory DIR command on a FLASH default database fails i e no default database could be detected Invalid ID the monitor cannot find the specified identification or it is incorrect The ID can be a breakpoint number communications port table name or process or exchange ID Invalid switch the user does not specify the mode for the chosen function No free breakpoints the define breakpoint DB command is attempted when all available breakpoints are in use Numeric input error a numeric field contains non numeric characters Continued on next page General SWM0023 1 00 2 Full Release 1 7 68K System Monitor GE Energy Services User s Guide Error Messages Continued Message Summary continued This Message is displayed when NVRAM invalid the query RAM QR command specified NVRAM is but it is corrupt Protected process attempting to suspend SP a critical system process Record error an invalid record is detected during the download function DL Suspend all processes attempting a download without suspending all processes first
82. tes octets the default mode words long words floating point numbers double precision numbers Parameters By not entering any parameters the command requests a dump from the last user entered memory dump location The dump is in the previously specified format if any and dumps for 80 bytes beg_addr first address to display in hexadecimal end_addr address up to which to display in hexadecimal the default is beg addr plus 80 hexadecimal Continued on next page SWMO0023 1 00 2 3 19 68K System Monitor GE Energy Services User s Guide D Dump Memory Continued Syntax continued Example Type d w f024 and press ENTER Results The system displays the specified data eight lines consisting of address eight hexadecimal words and 16 ASCII characters starting at hexadecimal address F024 then displays the prompt ID25A gt d w 024 0000F024 0000 0000 0000F034 0000 0000 0000F044 0004 0000 0000F054 FD6A 0000 0000F064 B696 FFEO 0000F074 002A BABE 0000F084 002A B812 0000F094 0000 002A D25A gt d 0000F0A4 0000 002A 0000F0B84 0000 0000 goooFOc4 0000 0000 0000F0D4 0000 0000 QOOOFOE4 0000 0000 0000 0000 0000 0000 0000 0000 Type d and press ENTER Results The system displays the next eight lines starting at hexadecimal address F024 80 F04A4 then displays the prompt Special An attempt to display non existent memory results in a bus Considerations error If this is the first dump not specifying
83. ugging Considerations context If you send an indiscriminate message to an exchange you cannot predict the results SWMO0023 1 00 2 3 43 GE Energy Services 68K System Monitor User s Guide KIM KI Metrics Platform Description Syntax 3 44 im CPM 0O D20 D20 ME D20 200 O D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base D200 only Use this command to view the Kernel Interface Metrics 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 3 processor Special Used during debug process only Requires special code to use Considerations SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide M Move Memory Platform Description Syntax General Full Release GE Energy Services M CPM M D20 D20 ME D20 200 M D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base Use this command to copy memory from one memory region to a writeable memory region It requires three hexadecimal quantities which define the e source address e destination address and e number of bytes to transfer Below is usage and syntax information for this command m from_addr to_addr num_bytes Parameters from_addr start address of the source region in hexadecimal to_addr start addr
84. y will cause the monitor to re issue the prompts for the FLASH SRAM and NVRAM base address and size Pressing CNTRL C will abort the command If the user responds y the command writes new data to the NVRAM header and a new NVRAM header CRC is calculated and stored Special The debug command is a toggle turning the debug mode ON if Considerations it is OFF and OFF if it is ON Enabling the Debug Mode degrades the performance of the system and may cause certain CPU intensive commands to activate the watchdog and reset the system SWM0023 1 00 2 General Full Release 68K System Monitor User s Guide DF Display File Data Platform Description Syntax General Full Release GE Energy Services 0O CPM 0O D20 D20 ME D20 200 CO D20 200 ME D25 D20 Base D20 Base CCU Base CCU Base 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 ASCH values afterward You may view any file recognized by the Installable File System Below is usage and syntax information for this command Command Format df b t filename Variables Display contents in binary format default 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 t

GE 68K System User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents