The following definitions will be used throughout:
o All answers must be terminated by pressing the Return key which is symbolized by <CR>.
o dddddd represents a Decimal value.
o hhhhhh represents a Hexadecimal value.
o cccccc represents an Ascii character string.
o [abcd] represents an optional parameter.
@FNAME[.CMD] .......................... Execute a command file
BEGIN ................................ Re-start SNOOPY
RESET ................................ Reset FASTBUS interface
CSR0 ................................ Display SSP CSR0 content
HELP ................................ Display list of commands
DIR [directory] .................... Display list of SSP files
STOP ................................ Exit SNOOPY
QUIT ................................ Exit SNOOPY
DUMP ERRORS ......................... Dump system error counters
DUMP FILE filename[.SSP] ............ Dump SSP disk file
DUMP COMMON /LIST ................... Dump list of commons
DUMP COMMON name [start [nwrds]] .... Dump contents of COMMON
DUMP PM | DM [start [nwrds]] ........ Dump contents of PM or DM
Dump options : none ............ Output to Terminal
(DISK ........... Output to Disk
(PRINT .......... Output to Printer
WRITE PM | DM [start [nwrds [value] .. Write a pattern into PM or DM
LOAD filename[.SSP] [(VERIFY ........ Load program from disk
EXEC filename[.SSP] ................. Load program and execute
SAVE filename[.SSP] ................. Save program onto disk
EDIT ................................ Examine, deposit, execute,
dump registers
(EEPM ................................ Enable Extended Program Memory )
(DEPM ................................ Disable Extended Program Memory)
A "command file" is a VAX disk file created by any editor. It contains variable-size records, but the maximum length of each record is limited to 128 characters. Each record must contain one single command, that may be followed by a comment separated from the command itself by a semi-colon character ";". "Blank records" or records beginning with ";" are ignored; they are treated as comments. Mutiple spaces between words of a command are ignored.
The file is defined by its name, with a default type = .CMD; it MUST be specified in the command line after the character "@", can be adjacent to it or separated from it by a space.
When Edit commands are specified in a command file, their format is slightly different, and will be described in Section 5.4.
This command allows you to re-define the parameters of the Interface (see above). This command is NOT ALLOWED in a command file.
This command allows you to initialize the interface.
This command displays the contents of the SSP Control Register (CSR0) on the Terminal :
SSP control register = hhhhhhhh
This command displays the list of commands on the Terminal.
This command displays on the Terminal a list of the SSP binary load files ( i.e. *.SSP ) available under the directory specified in the command line. If a directory is specified, it may be a straight name or a logical name, and it must not contain any embedded blanks. If no directory is specified, the default directory is searched.
These commands terminate the execution of the SNOOPY program and return control to the VAX operating system.
This command has the following different possibilities :
Additional Information on:
This command writes a pattern into Program or Data memory.
1. WRITE PM [start_location [number_of_words [pattern]]]
e.g. WRITE PM 100 50 E0E0E0E0
o start_location = WORD address.
o maximum number of words = 4096 (1000(hex)).
o pattern = value to be written.
2. WRITE DM [start_location [number_of_words [pattern]]]
e.g. WRITE DM 100 50 E0E0E0E0
o start_location = BYTE address.
o maximum number of words = 32768 (8000(hex))
o pattern = value to be written.
For both WRITE PM and DM :
- Default for "start_location" is 0.
- Default for "number_of_words" is (maximum - start).
- Default for "pattern" is 0.
- Parameters must be entered in Hexadecimal.
Then, SNOOPY types :
Write PROGRAM [DATA] MEMORY starting at hhhhhh(hex) ...
... for hhhhh(hex) words with pattern = hhhhhhhh
Enter Ok(=CR) or Quit :
The Program or Data memory will NOT be modified, if you answer "q(uit)" or "Q(UIT)" to this prompt.
After execution, SNOOPY returns to command mode.
e.g. LOAD 787EXAMPLES:TEST7_K7
These commands download a program, previously linked by the VAX SSP Linker and saved on disk, into the SSP memory. The program is not executed unless the EXEC command is given. If "filename" is not specified, you will be prompted :
Disk filename (default type =.SSP) :
If you enter "<CR>" only, the command is aborted.
After the file has been loaded, a number of messages appear, stating the type of load file (BNL or SLAC type), the size of the SSP memory, the lowest free location in DM (in bytes) and in PM (in bytes and in words).
For example, for a BNL file (i.e. one created using the BNL method) the following messages may appear on the screen:
Loading symbols from
787EXAMPLES:TEST7_K7.MAP
This is a BNL .SSP file
Downloading a 32K DM SSP.
SSP program: TEST7_K7
The SSP system is: BNLSYS , version: 4.00 .
Lowest free DM location: 00013774
Lowest free PM location: 3618 ( D86).
Number of marker words in use: 767
After the program has been loaded into the SSP memory,
o if the "LOAD" command is used with the option (VERIFY, SNOOPY compares the contents of the SSP Program and Data memory with the values read from the disk file and types an error message if they do not match.
o if the "EXEC" command is used, the processor is started and the program executed.
Then, SNOOPY types "*" and enters the Edit mode.
Additional Information on:
This command saves a program previously loaded into the SSP memory onto disk. This command is NOT ALLOWED in a command file.
NOTE
Regardless of the format of the original load file, the new file has the same format as an SSP file created by the VAX SSP Linker.
If "filename" is not specified, you will be prompted :
Disk filename (default type =.SSP) :
If you enter "<CR>" only, the command is aborted.
Then, SNOOPY will prompt you for the parameters that define the program:
Program load address (word) :
Program length (words) :
Data Load address (byte) :
Data constants length (bytes) :
Program start address (word) :
Data start address (byte) :
Error handler address (word) :
Number of common blocks :
All parameters must be entered in hexadecimal. If the
number of common blocks is not 0, you will be prompted to
define them :
Common name :
Common address (byte) :
Common length (bytes) :
SNOOPY then reads the SSP Program memory and Data memory,
saves the program as a disk file and returns to Command
mode.
This is the Edit mode of SNOOPY which allows the user to:
o Examine CSR space, Data space, Program or Data memory, one word at a time. Program memory instructions are de-assembled and displayed in symbolic form.
o Deposit into CSR space, Data space, Program or Data memory, one word at a time.
o Search for a specified pattern in Program or Data memory. Program instructions are de-assembled and displayed in symbolic form.
o Execute a program in Continuous Run Mode.
o Display contents of PSW and CSR0.
o Dump or Display contents of the SSP general registers.
SNOOPY tells you that it is entering the Edit Mode by typing a star on the left margin of the next line:
*
Then, it waits for a command.
Each Edit command is defined by two letters that can be followed by optional parameter(s), then by <CR>.
The edit commands are described in Chapter 5.