When using this document, keep the following in mind:ntialGeneral Notice

1. This document is confidential. By accepting this document you acknowledge that you are boundby the terms set forth in the nondisclosure and confidentiality agreement signed separately and in
the possession of SEGA. If you have not signed such a nondisclosure agreement, please contact
SEGA immediately and return this document to SEGA.

de2. This document may include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new versions of the
document. SEGA may make improvements and/or changes in the product(s) and/or the
program(s) described in this document at any time.

nfi

3. No one is permitted to reproduce or duplicate, in any form, the whole or part of this document
without SEGA’s written permission. Request for copies of this document and for technicalinformation about SEGA products must be made to your authorized SEGA Technical Services
representative.
4. No license is granted by implication or otherwise under any patents, copyrights, trademarks, orother intellectual property rights of SEGA Enterprises, Ltd., SEGA of America, Inc., or any third party.

Co

5. Software, circuitry, and other examples described herein are meant merely to indicate the characteristics and performance of SEGA’s products. SEGA assumes no responsibility for any intellectual
property claims or other problems that may result from applications based on the examples
described herein.

GA

6. It is possible that this document may contain reference to, or information about, SEGA products(development hardware/software) or services that are not provided in countries other than Japan.
Such references/information must not be construed to mean that SEGA intends to provide such
SEGA products or services in countries other than Japan. Any reference of a SEGA licensed product/program in this document is not intended to state or imply that you can use only SEGA’slicensed products/programs. Any functionally equivalent hardware/software can be used instead.

SE

7. SEGA will not be held responsible for any damage to the user that may result from accidents or any
other reasons during operation of the user’s equipment, or programs according to this document.

(11/2/94- 002)

NOTE: A reader's comment/correction form is provided with thisdocument. Please address comments to :SEGA of America, Inc., Developer Technical Support (att. Evelyn Merritt)
150 Shoreline Drive, Redwood City, CA 94065
SEGA may use or distribute whatever information you supply in any way
it believes appropriate without incurring any obligation to you.

SE

GA

Co

nfi

de

nti
al

TM

SEGA SATURN
Address Checker
Reference ManualDoc. # ST-254-B-110395© 1995-96 SEGA. All Rights Reserved.

nti
al

SEGA SATURNADDRESS CHECKER
REFERENCE MANUAL

Co

nfi

de

REVISION-1• Description of Commands• Technical Materials

SE

GA

SI Electronics
2-28-16 Shimomaruko, Ota-ku, Tokyo 146
TEL: 03-3756-4111
TEL: 03-3756-4114 (Tech Development)
FAX: 03-3756-5377

Copyright SI Electronics Ltd. 1995. All rights reserved.

(1)
(2)
(3)

nti
al

Notes:
This manual is copyrighted by SI Electronics Ltd.. Unauthorized reproduction inentirety or in part is prohibited by law.
Our best efforts have gone into preparation of this manual, but we welcome questions regarding the contents. Contents subject to change without notice.
Regardless of (2), no responsibility is assumed for any consequences of operation.

deMS DOS is a registered trademark of Microsoft Corporation, USA.

Other program, system, and CPU names are trademarks registered trademarks of theirrespective manufacturers.

SE

GA

Co

nfi

SI Electronics
2-28-16 Shimomaruko, Ota-ku, Tokyo 146
TEL: 03-3756-4111
TEL: 03-3756-4114 (Tech Development)
FAX: 03-3756-5377

4

nti
al

Introduction
This manual provides a description of commands used with the SEGA SATURN
Address Checker, and technical specifications.

SE

GA

Co

nfi

de

See the separate SEGA SATURN Address Checker Operation Manual (Doc. # ST-254-A110395) for a description of Address Checker setup, program installation, and operation.

SEGA SATURN Address Checker Reference Manual

5

nti
al

Notes and Symbols Used in This Manual
Explanatory symbol indicating a one-character space. Only used
to denote a space when particularly important.
2. ‘ø’
Explanatory symbol indicating pressing the Enter key (carriage
return key)
3. ‘_’ (underline)
Explanatory symbol indicating a character to be actually input
from the keyboard.
4. ‘\’ASCII symbol termed ‘backslash’ and assigned code 5C. In JIS
code,
displays ‘¥’(yen symbol).
5. ‘^A’ or <CTRL> Indicates pressing the ‘A’ key while holding down the control key.
Indicates, for example (^A)→01, (^B) →02, ... (^Z) →1A.
6.
Special keys are denoted by < >.
For example, besides ‘U’, the space key may be indicated by<SPACE>.
7.
‘xxxxH’ indicates that the value ‘xxxx’ is hexadecimal.

SE

GA

Co

nfi

de

1. ‘U’

6

nti
alTable of Contents
1. Address Checker Specifications .................................................................................. 9
1.1 SEGA System Specifications .............................................................................. 9
1.2 Address Checker Function Specifications .......................................................... 10

SE

GA

Co

nfi

de

2. Detailed Description of Commands ............................................................................ 11
2.1!
Execute Commands in the History Buffer .................................... 12
2.2:
Edit and Execute Commands in the History Buffer ..................... 13
2.3@
MS-DOS Call and Command Shell Execution ............................ 14
2.4<
Command File Execution ............................................................ 16
2.5
ALIAS
Define an Alias ............................................................................ 17
2.6?ALIAS Display an Alias ........................................................................... 18
2.7_ALIAS Delete an Alias ............................................................................ 19
2.8_ALIASU Delete User-Defined Alias ........................................................... 20
2.9
AUTO
Execute Auto Re-test ................................................................... 21
2.10 BELL
Bell Sound ................................................................................... 23
2.11 BB
Set Path Breakpoint .................................................................... 24
2.12 ?BB
Display Path Breakpoint .............................................................. 25
2.13 _BB
Delete Path Breakpoint ............................................................... 26
2.14 CAT
Display File Contents .................................................................. 27
2.15 CLS
Clear Command Window Screen ................................................ 28
2.16 ECHO
Display Character String .............................................................. 29
2.17 _ECHOSuppress Display ......................................................................... 30
2.18 FK
Define Function Keys .................................................................. 31
2.19 ?FK
Display Function Key Definition Character String ....................... 32
2.20 _FK
Delete Function Key Definition .................................................... 33
2.21 GO
Execute Program ......................................................................... 34
2.22 HELP
Display Command Syntax ........................................................... 35
2.23 LOG
Start Log Acquisition .................................................................... 36
2-24 ?LOG
Display Log File Name ................................................................ 37
2.25 _LOG
End Log Acquisition ..................................................................... 38
2.26 MAN
Manual Display ............................................................................ 39
2.27 MIDX
Create Index File for Message Display ....................................... 40
2.28 MORE
MORE Format Display <Filter Command> .................................. 41
2.29 QUIT
Quit Address Checker .................................................................. 42
2.30 REM
Comment Line ............................................................................. 43
2.31 RIDX
Read Index File for Message Display .......................................... 44
2.32 SET
Set Address Checker Operating Environment ............................. 45
2.33 ?SET
Display Address Checker Operating Environment ...................... 46
2.34 STOP
Stop ............................................................................................. 47
2.35 TDMP
Display Trace Data ...................................................................... 48
2.36 TRC
Set Trace Conditions ................................................................... 50
2.37 ?TRC
Display Trace Conditions ............................................................. 52
2.38 _TRC
Delete Trace Conditions .............................................................. 53
2.39 TSET
Set Trigger Detection Condition .................................................. 54
2.40 VRAMStore Display Contents to a File .................................................. 55

3. Detailed Description of TRCMAP.DAT Contents ......................................................... 56
4. Error Messages ........................................................................................................... 58

SEGA SATURN Address Checker Reference Manual

7

nti
al

Appendices

SE

GA

Co

nfi

de

SATURN System Address Map ................................................................................ 59
SMPC Register Map ................................................................................................. 64
DCC Register Map ................................................................................................... 66
CDROM Register Map .............................................................................................. 66
SCSP Register Map .................................................................................................. 72
VDP1 Register Map .................................................................................................. 74
VDP2 Register Map .................................................................................................. 74,79
SCU Register Map .................................................................................................... 80

8

nti
al

1. Address Checker Specifications

The Address Checker is used to perform address checks and debugging of programs
such as games that run on the SEGA system (custom SATURN board 17106833E). For
this purpose, the SEGA system and Address Checker board employ C-BUS connections.

1.1 SEGA System Specifications

Co

nfi

de

The Address Checker structure is illustrated below.

SEGA System (custom SATURN board)

Address Checker board(Top view)SE

GA

The SEGA System and Address Checker board are connected through the UCN1 and
UCN2 connectors shown in the drawing.

SEGA SATURN Address Checker Reference Manual

9

I

nti
al

1.2 Address Checker Function Specifications
Command Specifications

Principal commands that can be used with the Address Checker are given below.
See section §2 “Detailed Description of Commands” for details of commands.

GO command: start execution of user program (always reset before starting)
SET command: specifies bus master, specifies break at TRG detection
TRC command: specifies history acquisition conditions
TDMP command: displays history acquisition contents
BB command: specifies bus break conditions
ABORT command: aborts user program

II

Address Error Detection (TRG Detection) Specifications

de

(1)
(2)
(3)
(4)
(5)
(6)

nfi

TRG detection is performed under the following conditions:(1) Free access area: no TRG detection, accessible area

Co(2) Detection 1 area: area without memory allocation
During READ: read not allowed
During WRITE: write not allowedGA(3) Detection 2 area: VDP1, SCSP, SMPC areas
When free bits and used bits are mixed
During READ: unconditional access (free access)During WRITE: permits only “0” writes to free bits (bit-determined for D15 - D0)
When free bits and used bits are not mixed (free bit string=path width)
During READ: unconditional access (free access)During WRITE: write not allowedSE(4) Detection 3 area: SCU, CDROM, VDP2 areas
When free bits and used bits are mixed
During READ: unconditional access (free access)During WRITE: unconditional access (free access)
When free bits and used bits are not mixed (free bit string=path width)
During READ: unconditional access (free access)During WRITE: write not allowed(5) 5FE00AC’H - 5FE00AF’H (in SCU area)
During READ: read not allowed
During WRITE: write not allowed

10Detailed Descriptions of Commands

nti
al

2.

The commands are described in detail in this section. The format states the command
syntax. The following symbols are used in the format.
Specify one of the items x, y and z that are within the brackets.
The item within the square brackets can be omitted.
Parameters can be entered one after the other.
This is used to make the parameters easier to spot and has no special
meaning.

SE

GA

Co

nfi

de

{x|y|z}[x]
x …
<>

SEGA SATURN Address Checker Reference Manual11

! Execute Commands in the History Buffer

nti
al

2.1
Format! [ {numeral|character string} ]Function

Executes a command recorded in the command history.

Description

Searches for and executes the command recorded in the command history
as follows.

Executes the nth command recorded in the com
mand history. If the value is negative, executes thecommand located that number of commands
previous to the current command.
! character string
Executes the last command executed that starts
with the character string.
!
Executes the previously entered command.
The command history can be displayed with the HIS command.
Execute the 10th command in the command history.
>!10
Execute the last BB0 command executed.
>!BB0

nfi

SE

GA

Co

Examplede! numeral12

: Edit and Execute Commands in the History Buffer

nti
al

2.2
Format: [ {numeral|character string} ]Function

Edits and executes a command recorded in the command history.

Description

Searches for and edits a command recorded in the command history as
follows and executes it upon entry of a carriage return.

Displays the nth command recorded in the
numerical command history and allows editing
and command entry. If the value is negative,
executes the command located that number ofcommands previous to the current command.

; character string

Displays the last command executed that starts
with the character string and allows editing
and command entry.

nfi

Displays the previously entered command andallows editing and command entry.
The command history can be displayed with the HIS command.
Execute the 10th command in the command history after editing:>:10
Execute the last BB1 command executed after editing.
>:BB1
;

SE

GA

Co

Examplede; numeral

SEGA SATURN Address Checker Reference Manual13

@ MS-DOS Call and Command Shell Execution

Format

nti
al

2.3

@ [[/P]<space><MS-DOS command>]
where /P indicates that key input for returning to the Address Checker isomitted.
Function

Calls COMMAND.COM of MS-DOS.

Description

Shifts control to MS-DOS as described below.

nfi

de

When <MS-DOS command> is not specified, the screen display disappears
and the command line entry mode starts. When an MS-DOS command isentered in this state, COMMAND.COM is called and control shifts to MSDOS. Upon returning from MS-DOS, the command line input mode resumes. Enter the EXIT command or the escape key to return. The commandline input mode is managed by the Address Checker, so the command
history and command editing are available.

Co

When <MS-DOS command> is specified, the specified MS-DOS command is
executed. Hitting any key thereafter will return to the Address Checker,
which will wait for command entry. When option /P is specified, control
returns to the Address Checker without any key input. A space is necessary
between “@” and “<MS-DOS command>”.

SE

GA

The amount of Address Checker that is MS-DOS resident is at least 40
Kbyte, provided there is a sufficient margin in protect mode memory.
When “Not enough memory for environment” is displayed when a batch
command is run, set the following environment variable before starting up
the Address Checker.
A>SET IENV=<n>; <n> is a decimal numeral
The function of the environment variable IENV depends on the MS-DOS
version. In Ver. 3.1, specify 10 or more paragraph units where each is 16
bytes.

14

Example; Sets an environment variable area of 640 bytes
Starting from Ver. 3.3., specify 160 or more in byte units.

nti
al

A>SET IENV=40
ExampleA>SET IENV=640; Sets an environment variable area of 640 bytes
The IENV function is not valid in MS-DOS ver. 2 or earlier. When

COMMAND.COM is not on the MS-DOS path, MS-DOS commands
cannot be executed.
Display the MS-DOS directory:>@ DIR(Executes the DIR command of MS-DOS)deExamplenfi............. (The DIR command display is presented.).............
push any key!
(To return)
When entry includes a reserved character of the Address Checker (;, <,>, |, -), surround it in quotation marks.
>@ “dir | sort >>logging.dat”

SE

GA

Co

Execute an MS-DOS command from the command line input mode:>@(Command input mode)
A:\>TIME(Executes various MS-DOS commands)
A:\>EXIT(Return with the EXIT command)>GO(Address Checker commands usable again.)

SEGA SATURN Address Checker Reference Manual15

< Command File Execution

nti
al

2.4
Format< <filename>

Function

Executes a command file.

Description

Executes the specified <filename> as a command file.

Command files line up commands and parameters the same way they are
when Address Checker commands are input by key.

When a log is obtained from the log file, it can be executed with either the
AUTO command or the < command.
>LOG ALOG(Starts getting log)

Co

Examplenfi

deNotes:• The following commands cannot be executed in command files.
<
AUTO_ALIASU_CMDU
Commands for macros(IF {, } ELSE {, WHILE{,}, BREAK)• Log files obtained with the LOG command can be run as command files. The difference
from AUTO commands is in whether the results of execution can be verified. See theexample.
• When control codes for window control (such as control Z) are found in the file data,
windows can be controlled.

SE

GA>TRC ALL>GO>_LOG........................
>< ALOG.LOG

16(Finishes getting log)
(Runs the command input recording file of the log file
as a command file)

ALIAS Define an Alias

nti
al

2.5
FormatALIASFunction

Defines aliases for specified command character strings.

Description

Defines the specified <character string> as <alias>. Thereafter, when thealias character string is entered as command input, the specified character
string is run instead.
When the parameters are omitted, the <ALIAS> prompt is displayed, so
entering the <alias> and <character string> can define the alias. See theexample.
Define GO command under alias “RUN”:

deExample[ <alias> <character string> ]>ALIAS RUN GO

SE

GA

Co

>ALIAS > ALIAS.SAV.................
>ALIAS < ALIAS.SAV

nfi

Save alias definition in a temporary file and read the file to redefine them:

SEGA SATURN Address Checker Reference Manual

17

?ALIAS Display an Alias

nti
al

2.6
Format?ALIAS

Function

Displays the character string defined under the alias.

Description

Displays the character string defined under the alias. When the alias isomitted, all defined aliases are displayed. When no aliases are defined,“alias not found” is displayed.

ExampleDisplay the character strings defined under CLEAR and RUN:

SE

GA

Co

nfi

>?ALIAS CLEAR RUN <CR>de[ <alias> … ]18

_ALIAS Delete an Alias

nti
al

2.7
Format_ALIAS

Function

Deletes the alias definitions.

Description

Deletes the alias definitions. When the alias is omitted, all defined character strings are deleted.

[ <alias> … ]ExampledeNote:• When the alias is omitted, aliases defined (in BMINIT.DAT) during startup are alsodeleted. To delete all aliases the user has defined, use the _ALIASU command.

Delete the already defined alias commands CLEAR and RUN:

SE

GA

Co

nfi

>_ALIAS CLEAR RUN <CR>

SEGA SATURN Address Checker Reference Manual

19

_ALIASU Delete User-Defined Alias

Format_ALIASU

Function

Deletes all user-defined alias definitions.

Description

Deletes all user-defined alias definitions.
Note:
This command is defined by the ALIAS command.

Delete the aliases defined by the user:deExample

nti
al

2.8

SE

GA

Co

nfi

>_ALIASU

20

AUTO Execute Auto Retest

FormatAUTO [ {/I|/V|/E} ] <filename>

Where

nti
al

2.9

I: Log file command execution (default value)
V: Verify execution results
E: Display nonmatches of execution results
Executes an automatic retest.

Description

Automatically re-runs a test after a first test is performed. Results can becompared.

deFunction<filename> specifies the name of the log file specified by the LOG com-

Co

nfi

mand. See the example. This command opens a file that adds the extension “.LOG” to the name of the specified log file. It reads the contents ofthe file and automatically executes it as an Address Checker command. It
can also automatically compare the results of execution to the contents of
the log file (the log file name plus the extension “.OUT”). The following
can be specified as options.
I: Execute only the command without verifying results. The results ofexecution are displayed (default value)
V: Display the results of execution while verifying. Also displays thelocations of verification errors.
E: Display only the locations of verification errors.

SE

GA

Notes:• The following commands cannot be executed in an AUTO command.
<
AUTO_ALIASU_CMDU
Commands for macros(IF {, } ELSE {, WHILE{,}, BREAK)SEGA SATURN Address Checker Reference Manual21

Record an executed command in the log file and automatically re-run thecommand:>LOG LOGSAV(Gets log. No extension added to file name.)........................
(Executes various commands.)>_LOG(Finishes getting log)
>AUTO LOGSAV(Automatically executes a re-test.)
Display the results of execution while verifying. When the results ofexecution do not match, the result for the nonmatching lines and the log
information are displayed.

ntialExample>AUTO/V LOGSAV

SE

GA

Co

nfi

>AUTO/E LOGA > ERRLOGde........................
<result>(Execution results where nonmatches occurred.)........................
<log file>(Log contents where nonmatches occurred.)........................
Save only the locations of nonmatches in a file.

22

nti
al

2.10 BELL Bell Sound
FormatBELL

FunctionSounds a bell noise.

Description

Sounds a bell noise.

ExampleIf the contents of register R0 is 0, sound a bell noise:

SE

GA

Co

nfi

de

>cmd r0bell?if { b*.r0 == 0
?bell
?}
?.
?macro name ? .
>SEGA SATURN Address Checker Reference Manual23FormatBBn DA/<address>

where
n: Break point number (0 to 3)

nti
al

2.11 BB Set Path Break Point

Sets a bus break point.

Description

Records the specified address as a bus break condition. Up to 4 bus breakpoints can be specified (0 to 3).

ExampleBreak when address 1000 is accessed:

SE

GA

Co

nfi

>BB0 DA/1000

deFunction

24

nti
al

2.12 ?BB Display Path Break Point
Format?BB [n]Function

Displays the bus break points.

Description

Displays the specified bus break point conditions. When n (break point
number) is not specified, all bus break conditions are displayed.

ExampleDisplay all bus break conditions:

SE

GA

Co

nfi

de

>?BB

SEGA SATURN Address Checker Reference Manual

25

nti
al

2.13 _BB Delete Path Break Point
Format_BB [n]Function

Deletes the bus break points.

Description

Deletes the specified bus break point conditions. When n (break point
number) is not specified, all bus break conditions are deleted.

ExampleDelete the first bus break point:

SE

GA

Co

nfi

de

>_BB1

26

FormatCAT <filename>

Function

Displays the file contents.

Description

Displays the contents of the specified file.

ExampleDisplay the contents of file FILE.DAT:

SE

GA

Co

nfi

de

>CAT FILE.DAT

nti
al

2.14 CAT Display File Contents

SEGA SATURN Address Checker Reference Manual27Formatnti
al2.15 CLS Clear Command Window Screen
CLS [ {1|2|3} ]where

1: Command window screen clear
2: Screen refresh (same as [CTRL-])
3: Command window screen clear and screen refresh(default)

Clears the command window and refreshes the Address Checker screen.

Description

Clears the command display window and moves the cursor to the beginning of the command window.

deFunction

Example

SE

GA

Co

nfi

>CLS

28

nti
al

2.16 ECHO Display Character String
ECHO [<character string> …]

Function

Displays a character string in the command window.

Description

Displays the specified <character string> in the command window.
Spaces can be used if surrounded by quotations marks (“). Use the characters ¥n to get a carriage return. When no character string is specified as theparameter, the suppression of the display specified with the _ECHO command is canceled.

ExampleDisplay a character string.

deFormat>ECHO “<THIS IS THE MESSAGE>¥n”

Cancel the suppression of displays in the command window.
>_ECHO

SE

GA

Co

>

nfi

( ECHO )(Nothing is displayed even when a command is entered.)(Cancels the suppression of display by input of an ECHO
command. The ECHO command itself is not displayed.)(Now it is in the normal echo back and display mode.)

SEGA SATURN Address Checker Reference Manual

29

nti
al

2.17 _ECHO Suppress Display
Format_ECHOFunction

Suppresses display in the command window.

Description Restrains echo back and display of command execution results in thecommand window. The display suppression is canceled by the ECHO
command.
ExampleSuppress display in the command window, then cancel.

( ECHO )(Nothing is displayed even when a command is entered.)(Cancels the suppression of display by input of an ECHO
command. The ECHO command itself is not displayed.)(Now it is in the normal echo back and display mode.)

SE

GA

Co

nfi

>

de

>_ECHO30

Format

FK <numeral> <character string>

where

nti
al

2.18 FK Define Function Keys

<numeral>: 1 to 20<character string>: Up to 15 characters

Sets the function keys.

Description

Defines a character string to the function key of the specified number.
<numeral> values 1 through 10 correspond to function keys F1 throughF10. <numeral> values 11 through 20 correspond to Shift F1 through Shift
F10.

de

FunctionSpaces can be used if surrounded by quotations marks (“). Use the characters ¥r to get a carriage return. The character string can be up to 15 characters.

ExampleThe FK command of BMINIT.DAT defines the initial settings of the function
keys. The contents of this file can be changed with an editor to set the function
keys as the user desires.

nfi

Note:

Define GO<CR> for F•1:

SE

GA

Co

>FK 1 “GO¥r”

SEGA SATURN Address Checker Reference Manual31Formatnti
al2.19 ?FK Display Function Key Definition Character String?FK [<numeral> … ]where<numeral>: 1 to 20

Displays the character strings defined for the function keys.

Description

Displays the character string defined for the specified function key.
<numeral> values 1 through 10 correspond to function keys F1 throughF10. <numeral> values 11 through 20 correspond to Shift F1 through Shift
F10. When no number is specified, character string for all function keys
are displayed.

ExampleDisplay the character string defined for F10:

SE

GA

Co

nfi

>?FK 10
FK10 “GO¥r”

deFunction

32

nti
al

2.20 _FK Delete Function Key Definition_FK <numeral> [ … ]Formatwhere<numeral>: 1 to 20

Deletes function key settings.

Description

Deletes the function key definition for the specified function key.
<numeral> values 1 through 10 correspond to function keys F1 throughF10. <numeral> values 11 through 20 correspond to Shift F1 through Shift
F10.

ExampleMake F1 undefined:deFunction

SE

GA

Co

nfi

>_FK 1

SEGA SATURN Address Checker Reference Manual33FormatGO

Function

Executes programs.

Description

Clears resets and executes programs.

ExampleExecute:

SE

GA

Co

nfi

de

>GO

nti
al

2.21 GO Execute Program

34

nti
al

2.22 HELP Display Command Syntax
HELP [ {<command|KEY|EXPR} ]Function

Displays the command syntax.

Description

When <command> is omitted, a list of commands from the manual is displayed and the cursor can be used to select one whose syntax to display.
When KEY is specified, an explanation of the control keys and the like forkey input is displayed. When EXPR is specified, an explanation of theexpression is displayed.

deFormatTo specify a command for a macro in <command name>, specify IF, WHILE or
BREAK. When <command> is specified, that command’s syntax is displayed.
The help window is used for the display, so the syntax can be viewed
while inputting the command.

Note:

Enclose the command file execution command “<“ in quotation marks (i.e.,
HELP “<“).

Display the GO command syntax:>HELP GOCo

Examplenfi

The command list is recorded in BM.HLP as text, so it may be freely
added to or changed.

Display a command selected from the command list:

SE

GA

>HELP

SEGA SATURN Address Checker Reference Manual

35

nti
al

2.23 LOG Start Log Acquisition
Format

LOG <filename>

Function

Records emulator commands and display results in a file.

Description

Saves key input and its display results as log information in a file (log file).
Do not place an extension on the file name. When the log is fetched, an
automatic re-test can be run using the AUTO command. See the example.

Record an executed command in the log file and automatically re-run the
test:>LOG LOGSAV(Gets log. No extension added to file name.)........................
(Executes various commands.)>_LOG(Finishes getting log)........................
>CAT LOGSAV(Displays the previous execution results.)........................
>AUTO LOGSAV(Automatically executes a re-test.)

SE

GA

Co

nfi

ExampleCommand input and execution results are recorded in a file <filename>.OUT.
Command input alone is recorded in a file <filename>.OUT.

de

Note

36

nti
al

2.24 ?LOG Display Log File Name
Format?LOG

Function

Displays the file being logged.

Description

If logging is currently in progress, the log file name is displayed. If not
currently logging, nothing is displayed.

Example........................

SE

GA

Co

nfi

>?LOG
LOG LOGSAV(Gets log.)(Executes various commands.)(Displays the log file name.)de>LOG LOGSAVSEGA SATURN Address Checker Reference Manual37Format_LOG

Function

Finishes getting the log.

Description

Finishes getting the log.

ExampleFinished getting the log:nti
al2.25 _LOG End Log Acquisition

SE

GA

Co

nfi

de

>_LOG

38

nti
al

2.26 MAN Manual Display
FormatMAN [<command name>]

Function

Displays the contents of the manual.

Description

Displays the contents of the manual about the specified command. When<command> is omitted, select an item with the cursor from the manual orcommand lists to display the manual contents.

deWhen KEY is specified, an explanation of the control keys and the like forkey input is displayed. When EXPR is specified, an explanation of theexpression is displayed. To specify a command for a macro in <command
name>, specify IF, WHILE or BREAK.

nfi

When <command> is specified, the manual section for that command isdisplayed. When MAN <command> | MORE is input, the manual is displayeda page at a time.
Searches for the specified command start with system commands andthen goes to user commands if the command is not found. The command
list is recorded in BM.HLP as text, so it may be freely added to or changed.

ExampleWhen the command “<“ is specified in command file execution, enclose it inquotation marks (i.e., MAN “<“).

Co

Note:

Display the MAP command manual:>MAN TDMP | MORE

Display after selecting from the command list:

SE

GA

>MAN

SEGA SATURN Address Checker Reference Manual

39

nti
al

2.27 MIDX Create Index File for Message Display
MIDX { MAN | ERR }MAN: System manual file
ERR: Error message file

Function

Creates an index file that is used to display messages.

Description

Creates an index file that is used to display messages. Select the following
message types using the parameters.
MAN: System manual file (file MAN.DOC)
ERR: Error message file (file ERR.H)

deFormat

The index file is needed by the RIDX command. (The RIDX command isrequired by the MAN, HELP and ERR commands.)
Example

SE

GA

Co

nfi

>MIDX MAN

40

nti
al

2.28 MORE MORE Format Display <Filter Command>
FormatMORE

FunctionControls output in page units.

Description

Does a MORE command display. First, 1 page worth of character string
input by a pipe are displayed. Next, command input is waited for andpipe output (display) continues according to the command entered fromthe keyboard.

[n] <CR>

Displays the next n lines. When n is not specified, displays 1line’s worth.

[n] S

Displays 1 page’s worth after skipping the next n lines.
When n is not specified, skips 1 page’s worth.

Q

Skips all lines and quits without displaying anything.

nfi

Examplede[n] <space> Displays the next n lines. When n is not specified, displays 1
page’s worth.

Display the trace buffer dump as a MORE display:

SE

GA

Co

>TDMP | MORE

SEGA SATURN Address Checker Reference Manual

41

nti
al

2.29 QUIT Quit Address Checker
FormatQUITFunction

Quits the Address Checker.

Description

Quits the Address Checker and returns to MS-DOS.

Example

SE

GA

Co

nfi

de

>QUIT
A>

42

nti
al

2.30 REM Comment Line
FormatREM [<character string>]

Function

A comment line.

Description

The line is handled as a comment and does nothing. This is convenient to
use in the command file for comments.
Note:

Do not use “;” in the character string.

de

Example

SE

GA

Co

nfi

>REM EXECUTE GO>GO>REM THIS IS COMMENT!

SEGA SATURN Address Checker Reference Manual

43

nti
al

2.31 RIDX Read Index File for Message Display
RIDX { MAN | ERR }MAN:
System manual file
ERR:
Error message file

FunctionReads the index files that are used to display messages.

Description

Reads the index files that are used to display messages. Select the following message types using the parameters.
MAN:
System manual file (file MAN.DOC)
ERR:
Error message file (file ERR.H)

deFormatIndex file reading is required by the MAN, HELP and ERR commands. This
command is also required when the user is adding expansion commands.
Example

SE

GA

Co

nfi

>RIDX MAN

44

nti
al

2.32 SET Set Address Checker Operating Environment
SET <environment type>/<mode> …
<environment type>/<mode>
BM/ {ALL|SH2M|SH2S|SCU}
TRG/ {BRK|CNT}
DSP/ {NRM|SPD}(for DOS/V)

Function

Sets the operating environment of the Address Checker.

Description

Sets the operating environment of the Address Checker.

ExampleThe following can be specified for <environment type>:BM
Bus master
TRG
Break when trigger is detected
DSP
Display speed mode (for DOS/V)
The following can be specified for <mode>:(1) BMALL
All (SH2M, SH2S, SCU)
SH2M SH2 (master)SH2S
SH2 (slave)
SCU
SCU(2) TRG
BRK
Break
CNT
Don’t break(3) DPS
NRM
Standard display mode
SPD
Fast display mode (rewrites entire screen when command ends)
The emulator operating environment information saved in the file can beread and the same status operating environment set. See the example.
Break upon trigger detection with an SH2 (master) as bus master:

GA

Co

nfi

de

FormatSE>SET BM/SH2M TRG/BRK

SEGA SATURN Address Checker Reference Manual

45

nti
al

2.33 ?SET Display Address Checker Operating Environment
Format?SET

Function

Displays the status of the Address Checker’s operating environment.

Description

Displays the status of the Address Checker’s current operating environment.

>?SET
SET BM/ALL TRG/CNTdeExampleThe emulator operating environment information saved in the file can beread and the same status operating environment set. See the example.
Display current Address Checker operating environment:

SE

GA

Co

nfi

Save the Address Checker operating environment once to a file, then readthe saved operating environment and set control with the same conditions:>?SET> SET.SAV(Save current operating environment to file).................
(Execute various commands.)> < SET.SAV(Read the previously saved operating environment
from file and set the operating environment)46

Format

STOP

Function

Aborts the program.

Description

Stops an executing program.

ExampleStop program execution:

SE

GA

Co

nfi

de

>STOP
BREAK STOP!
PC =00001000 SR=00000000:———**—

nti
al2.34 STOP Stop

SEGA SATURN Address Checker Reference Manual47Formatnti
al2.35 TDMP Display Trace Data
TDMP[<first frame number>[<last frame number>]]
Function

Displays the trace information.

Description

Displays the trace information fetched from trace memory.

deFrame numbers are given in bus cycle units. The last bus cycle becomesframe 1 and the oldest frame has the largest number. The command displays the contents of trace memory from the <first frame number> to the<last frame number>. When <first frame number> and <last frame
number> are both omitted, the entire contents of the trace memory aredisplayed.

nfi

When searching large amount of trace contents, it is connected to first
output the trace contents to a file, then display them with the VIEW command or use the editor with the @ command. See the usage example.
The display format is shown below.

Co+— Frame number| +— “+” displayed when trigger detected| |+— Address/bus width| ||+— Data| |||+— Access space
| |
|
|
|
+— Bus master
| |
|
|
|
|
+— BS signal
| |
|
|
|
|
|
+— CPU status
| |
|
|
|
|
|
|
+— DMA ack signal
| |
|
|
|
|
|
|
|
+— SDRAM command cycle
f-no
addr
data cs bm
bs stdack sdram
000010EB/16 0124

CS0 SH2M

GA

00012+WRSE• Access space
CS0 CS0 area
CS1 CS1 area
CS2 CS2 area
CS3 CS3 area
• Bus masterSH2M SH2 (master)SH2S
SH2 (slave)
SCU
SCU

48

Example

Do a MORE display of all trace contents:>TDMP | MORE

ntial

• CPU status
Displays SH operating status
RD
Data readWR
Data write• DMA ack signal
DACK0
DACK0
DACK1
DACK1

de

Display the last 12 frames from the final trace:

SE

GA

Co

nfi

>TDMP 1 12

SEGA SATURN Address Checker Reference Manual

49

nti
al

2.36 TRC Set Trace Conditions(1) TRC ALL <trace control>(2) TRC SMP <trace control>(3) TRC TRG <trace control>

FormatFormat of <trace control>: FUL/ {CNT|STP} END/ {CNT|BRK}
Sets the trace conditions.

Description

Sets the specified conditions as trace conditions. When the trace get conditions specified by <trigger condition> are reached during program execution, the trace get starts according to <trace control>.
(1)

For expression (1)TRC ALL <trace control>deFunction(2)

nfi

When ALL is specified as the first parameter, the get of the trace information
starts simultaneously with program execution.
For expression (2)TRC SMP <trace control>

When SMP is specified as the first parameter, trace information is gotten only
for trigger detections.
For expression (3)

Co

(3)

TRC TRG <trace control>

When TRG is specified as the first parameter, the get of the trace information
starts simultaneously with program execution and continues until a trigger
is detected.
(4)
Explanation of <trace control>
Trace gets are controlled according to <trace control> as described below.
FUL/ {CNT|STP}

GA

Specifies processing when the trace buffer becomes full.
CNT (default value): Continues the trace get. The trace buffer is usedcyclically and the oldest trace information is erased.
STP: Stops the trace get.

SE

END/ {CNT|BRK}

Specifies processing when the trace get is stopped.
CNT: Continues without breaking the execution of the user program.
BRK (default value): Breaks execution of the user program.

Trace conditions can be temporarily saved to a file and then read later fromthe file to reset the same conditions. See the example.
Note:

50

When this command is used, the current measured values of the 2 (hardware)bus counters are cleared to 0 (even when an error occurs during setting).

Always get the trace. Break the program when the trace buffer becomes
full.

nti
al

Example>TRC ALL FUL/STP END/BRK

Always get the trace. Cycle the trace information gets when the buffer
becomes full and continue the program.
>TRC ALL FUL/CNT

SE

GA

Co

nfi

de

Temporarily save trace conditions to a file, then read the conditions fromthe file and set them again:>?TRC >TRACEX.SAV(Saves the current trace conditions to a file.).......................
(Execute various emulation commands.)><TRACEX.SAV(Reads the trace conditions from the file andsets them again.)

SEGA SATURN Address Checker Reference Manual

51

nti
al

2.37 ?TRC Display Trace Conditions?TRC

Function

Displays the trace conditions.

Description

Displays the current trace conditions. Trace conditions can be saved to a
file and reset later.

ExampleTemporarily save trace conditions to a file, then read the conditions fromthe file and set them again:>?TRC >TRACEX.SAV(Saves the current trace conditions to a file.).......................
(Execute various emulation commands.)><TRACEX.SAV(Reads the trace conditions from the file andsets them again.)

SE

GA

Co

nfi

de

Format

52

nti
al

2.38 _TRC Delete Trace Conditions
Format_TRC

Function

Deletes the trace conditions.

Description

Renders the currently set trace conditions invalid.

ExampleDelete the currently set trace conditions:

SE

GA

Co

nfi

de

>_TRC

SEGA SATURN Address Checker Reference Manual53Set Trigger Detection Conditionnti
al2.39 TSET
FormatTSET

Function

Sets trigger detection condition.

Description

Sets trigger detection condition according to the TRGMAP.DAT file contents.

Update the TRGMAP.DAT file and reset the trigger detection condition.

SE

GA

Co

nfi

ExampledeThis is used to reset the trigger detection condition after updating the
TRGMAP.DAT file.

54

nti
al

2.40 VRAM Store Display Contents to a File
VRAM [<filename>]

Function

Saves the contents of the current display to a file.

Description

Reads the contents of the currently displayed VRAM and saves them to a
file. When PRN is specified as the file name, a hard copy goes to the printer.
(Starting from MS-DOS V3.3, no hard copy can be made unless
DEVICE=PRINT.SYS in CONFIG.SYS.) When the file name is omitted, thefile is named VRAM.TAG.

ExampleSaves the contents of the current display to a file called HCOPY:deFormat

SE

GA

Co

nfi

>VRAM HCOPYSEGA SATURN Address Checker Reference Manual

55

nti
al

3. Detailed Contents of TRGMAP.DAT

Among the System Program files, TRGMAP.DAT is the file that defines the address
maps which dictate the Sega Saturn System trigger condition. The file contents are as
follows:;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;
;
;
;

00
SMPC Register
FF
FF
FF
FF
FF
FF
FF
FF

00100080
00101000
00180000

A
A
F

END

00W FFFF FF
00R FF
00R FF
00R FF
00R FF
00R FF
FF FF

03

04

00W FFFF FF
00R FF
00R FF
00R FF
00R FF
FE FF
FF FF

05

06

00W FFFF FF
00R FF
00R FF
00R FF
00R FF
FF FF
80
FF

07

08

00W FFFF FF
00R FF
00R FF
00R FF
00R FF
FF FF
80
FF

09

0A 0B

00W FFFF FF
00R FF
00R FF
00R FF
00R FFFF FF
80W FFThe following addresses are defined through 7FFFFFF.

SE

•
•
•

56

02

GA

000
010
020
030
040
050
060
070

01

Co

nfi

de

;
Address Checker Trigger Definition File;
Condition
F:
Free;
ConditionA:
Access prohibited;
Condition
R:
Read Only;
ConditionW:
Write Only;
ConditionL:
See List;;
The condition settings are in 4K-bytes. For detailed settings,;
specify L, then refer to the List.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; Address
Condition
Bus Width
00000000F
1600080000
A
00100000
L
L2;
Set unused bits to 1. (When all bits are unused, write is prohibited.);R denotes Read Only; W denotes Write Only
0C 0D

00W FFFF FF
00R FF
00R FF
00R FF
00R FFFF FF
80W FF

0E

00W FFFF FF
00R FF
00R FF
00R FF
00R FFFF FF
FEW FF

0F

FF
00W
00R
00R
00R
00R
FF
FEW

“;” denotes comments.
“address” denotes the starting address.

ntialDescription“Condition” denotes the trigger detection condition; “F” denotes Free
Access; “A” denotes Access prohibited; “R” denotes Read Only; “W”
denotes Write Only; “L” denotes See List. In the List, conditions can be
specified in single bytes (this is normally in 4 bytes.)de“Bus Width” denotes the effective bus width. When abbreviated, theprevious setting will be enabled. The List allows the selection of unused
bits, Read Only, and Write Only. All unused bit addresses prohibit Write.
The List starts with the L row or the L2 row and ends with the END row.

SE

GA

Co

nfi

When the List starts with the L2 row, for addresses where unused bits andused bits coexist, the unused bit “1” Write is prohibited.
There are Lists for 8 bits, 16 bits, and 32 bits.

SEGA SATURN Address Checker Reference Manual57

Error Messages

nti
al

4.

Error messages are displayed in Japanese, but error messages that require annotationand how to deal with them are described below.
• The contents of the configuration file are illegal.

See section 2.6, “Setting the Configuration,” and correct the contents of the file.
• Hardware is not connected.

SE

GA

Co

nfi

de

Check to see if the power switch to the Address Checker is on. Also check to see if
the interface board is connected to the host personal computer. Finally, check that
BANK is correct.

58

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

59

60

GA

SE
nti
al

de

nfi

Co

nti
al

Addendum: Register Names
SMPC (System Management & Peripheral Control)

Saturn system reset management; Control Pad and other peripheral devices interface
management. Each has a backup battery and real-time clock.
SCSP (Saturn Custom Sound Processor)

Sound source LSI for game, which integrates PCM sound source and DSP for sound.
VDPI (Video Display Processor 1)

de

LSI for drawing sprites and polygons. The VRAM and frame buffer are connected anddata is thus transferred. Also, data is sent to VDP2 when requested.
VDP2 (Video Display Processor 2)

Manages scroll planes and includes priority functions.
SCU (System Control Unit)

SE

GA

Co

nfi

Includes CPU I/F, A-Bus I/F, and B-Bus I/F Controllers.
Includes DMA controller, interrupt controller, and DSP.

SEGA SATURN Address Checker Reference Manual

61

62

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

63

64

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

65

66

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

67

68

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

69

70

GA

SE
nti
al

de

nfi

Co

nti
al
de

nfi

W
W

SE

GA

Co

W

SEGA SATURN Address Checker Reference Manual

71

72

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

73

74

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

75

76

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

77

78

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual

79

80

GA

SE
nti
al

de

nfi

Co

nti
al
de
nfi
Co
GA
SE
SEGA SATURN Address Checker Reference Manual81