simh-testsetgenerator/Interdata/id_doc.txt
Bob Supnik 2bcd1e7c4c Notes For V2.10-2
1. New Features in 2.10-2

The build procedures have changed.  There is only one UNIX makefile.
To compile without Ethernet support, simply type

	gmake {target|all}

To compile with Ethernet support, type

	gmake USE_NETWORK=1 {target|all}

The Mingw batch files require Mingw release 2 and invoke the Unix
makefile.  There are still separate batch files for compilation
with or without Ethernet support.

1.1 SCP and Libraries

- The EVAL command will evaluate a symbolic type-in and display
  it in numeric form.
- The ! command (with no arguments) will launch the host operating
  system command shell.  The ! command (with an argument) executes
  the argument as a host operating system command.  (Code from
  Mark Pizzolato)
- Telnet sessions now recognize BREAK.  How a BREAK is transmitted
  dependent on the particular Telnet client.  (Code from Mark
  Pizzolato)
- The sockets library includes code for active connections as
  well as listening connections.
- The RESTORE command will restore saved memory size, if the
  simulator supports dynamic memory resizing.

1.2 PDP-1

- The PDP-1 supports the Type 24 serial drum (based on recently
  discovered documents).

1.3 18b PDP's

- The PDP-4 supports the Type 24 serial drum (based on recently
  discovered documents).

1.4 PDP-11

- The PDP-11 implements a stub DEUNA/DELUA (XU).  The real XU
  module will be included in a later release.

1.5 PDP-10

- The PDP-10 implements a stub DEUNA/DELUA (XU).  The real XU
  module will be included in a later release.

1.6 HP 2100

- The IOP microinstruction set is supported for the 21MX as well
  as the 2100.
- The HP2100 supports the Access Interprocessor Link (IPL).

1.7 VAX

- If the VAX console is attached to a Telnet session, BREAK is
  interpreted as console halt.
- The SET/SHOW HISTORY commands enable and display a history of
  the most recently executed instructions.  (Code from Mark
  Pizzolato)

1.8 Terminals Multiplexors

- BREAK detection was added to the HP, DEC, and Interdata terminal
  multiplexors.

1.9 Interdata 16b and 32b

- First release.  UNIX is not yet working.

1.10 SDS 940

- First release.

2. Bugs Fixed in 2.10-2

- PDP-11 console must default to 7b for early UNIX compatibility.
- PDP-11/VAX TMSCP emulator was using the wrong packet length for
  read/write end packets.
- Telnet IAC+IAC processing was fixed, both for input and output
  (found by Mark Pizzolato).
- PDP-11/VAX Ethernet setting flag bits wrong for chained
  descriptors (found by Mark Pizzolato).

3. New Features in 2.10 vs prior releases

3.1 SCP and Libraries

- The VT emulation package has been replaced by the capability
  to remote the console to a Telnet session.  Telnet clients
  typically have more complete and robust VT100 emulation.
- Simulated devices may now have statically allocated buffers,
  in addition to dynamically allocated buffers or disk-based
  data stores.
- The DO command now takes substitutable arguments (max 9).
  In command files, %n represents substitutable argument n.
- The initial command line is now interpreted as the command
  name and substitutable arguments for a DO command.  This is
  backward compatible to prior versions.
- The initial command line parses switches.  -Q is interpreted
  as quiet mode; informational messages are suppressed.
- The HELP command now takes an optional argument.  HELP <cmd>
  types help on the specified command.
- Hooks have been added for implementing GUI-based consoles,
  as well as simulator-specific command extensions.  A few
  internal data structures and definitions have changed.
- Two new routines (tmxr_open_master, tmxr_close_master) have
  been added to sim_tmxr.c.  The calling sequence for
  sim_accept_conn has been changed in sim_sock.c.
- The calling sequence for the VM boot routine has been modified
  to add an additional parameter.
- SAVE now saves, and GET now restores, controller and unit flags.
- Library sim_ether.c has been added for Ethernet support.

3.2 VAX

- Non-volatile RAM (NVR) can behave either like a memory or like
  a disk-based peripheral.  If unattached, it behaves like memory
  and is saved and restored by SAVE and RESTORE, respectively.
  If attached, its contents are loaded from disk by ATTACH and
  written back to disk at DETACH and EXIT.
- SHOW <device> VECTOR displays the device's interrupt vector.
  A few devices allow the vector to be changed with SET
  <device> VECTOR=nnn.
- SHOW CPU IOSPACE displays the I/O space address map.
- The TK50 (TMSCP tape) has been added.
- The DEQNA/DELQA (Qbus Ethernet controllers) have been added.
- Autoconfiguration support has been added.
- The paper tape reader has been removed from vax_stddev.c and
  now references a common implementation file, dec_pt.h.
- Examine and deposit switches now work on all devices, not just
  the CPU.
- Device address conflicts are not detected until simulation starts.

3.3 PDP-11

- SHOW <device> VECTOR displays the device's interrupt vector.
  Most devices allow the vector to be changed with SET
  <device> VECTOR=nnn.
- SHOW CPU IOSPACE displays the I/O space address map.
- The TK50 (TMSCP tape), RK611/RK06/RK07 (cartridge disk),
  RX211 (double density floppy), and KW11P programmable clock
  have been added.
- The DEQNA/DELQA (Qbus Ethernet controllers) have been added.
- Autoconfiguration support has been added.
- The paper tape reader has been removed from pdp11_stddev.c and
  now references a common implementation file, dec_pt.h.
- Device bootstraps now use the actual CSR specified by the
  SET ADDRESS command, rather than just the default CSR.  Note
  that PDP-11 operating systems may NOT support booting with
  non-standard addresses.
- Specifying more than 256KB of memory, or changing the bus
  configuration, causes all peripherals that are not compatible
  with the current bus configuration to be disabled.
- Device address conflicts are not detected until simulation starts.

3.4 PDP-10

- SHOW <device> VECTOR displays the device's interrupt vector.
  A few devices allow the vector to be changed with SET
  <device> VECTOR=nnn.
- SHOW CPU IOSPACE displays the I/O space address map.
- The RX211 (double density floppy) has been added; it is off
  by default.
- The paper tape now references a common implementation file,
  dec_pt.h.
- Device address conflicts are not detected until simulation starts.

3.5 PDP-1

- DECtape (then known as MicroTape) support has been added.
- The line printer and DECtape can be disabled and enabled.

3.6 PDP-8

- The RX28 (double density floppy) has been added as an option to
  the existing RX8E controller.
- SHOW <device> DEVNO displays the device's device number.  Most
  devices allow the device number to be changed with SET <device>
  DEVNO=nnn.
- Device number conflicts are not detected until simulation starts.

3.7 IBM 1620

- The IBM 1620 simulator has been released.

3.8 AltairZ80

- A hard drive has been added for increased storage.
- Several bugs have been fixed.

3.9 HP 2100

- The 12845A has been added and made the default line printer (LPT).
  The 12653A has been renamed LPS and is off by default.  It also
  supports the diagnostic functions needed to run the DCPC and DMS
  diagnostics.
- The 12557A/13210A disk defaults to the 13210A (7900/7901).
- The 12559A magtape is off by default.
- New CPU options (EAU/NOEAU) enable/disable the extended arithmetic
  instructions for the 2116.  These instructions are standard on
  the 2100 and 21MX.
- New CPU options (MPR/NOMPR) enable/disable memory protect for the
  2100 and 21MX.
- New CPU options (DMS/NODMS) enable/disable the dynamic mapping
  instructions for the 21MX.
- The 12539 timebase generator autocalibrates.

3.10 Simulated Magtapes

- Simulated magtapes recognize end of file and the marker
  0xFFFFFFFF as end of medium.  Only the TMSCP tape simulator
  can generate an end of medium marker.
- The error handling in simulated magtapes was overhauled to be
  consistent through all simulators.

3.11 Simulated DECtapes

- Added support for RT11 image file format (256 x 16b) to DECtapes.

4. Bugs Fixed in 2.10 vs prior releases

- TS11/TSV05 was not simulating the XS0_MOT bit, causing failures
  under VMS.  In addition, two of the CTL options were coded
  interchanged.
- IBM 1401 tape was not setting a word mark under group mark for
  load mode reads.  This caused the diagnostics to crash.
- SCP bugs in ssh_break and set_logon were fixed (found by Dave
  Hittner).
- Numerous bugs in the HP 2100 extended arithmetic, floating point,
  21MX, DMS, and IOP instructions were fixed.  Bugs were also fixed
  in the memory protect and DMS functions.  The moving head disks
  (DP, DQ) were revised to simulate the hardware more accurately.
  Missing functions in DQ (address skip, read address) were added.
- PDP-10 tape wouldn't boot, and then wouldn't read (reported by
  Michael Thompson and Harris Newman, respectively)
- PDP-1 typewriter is half duplex, with only one shift state for
  both input and output (found by Derek Peschel)

5. General Notes

WARNING: V2.10 has reorganized and renamed some of the definition
files for the PDP-10, PDP-11, and VAX.  Be sure to delete all
previous source files before you unpack the Zip archive, or
unpack it into a new directory structure.

WARNING: V2.10 has a new, more comprehensive save file format.
Restoring save files from previous releases will cause 'invalid
register' errors and loss of CPU option flags, device enable/
disable flags, unit online/offline flags, and unit writelock
flags.

WARNING: If you are using Visual Studio .NET through the IDE,
be sure to turn off the /Wp64 flag in the project settings, or
dozens of spurious errors will be generated.

WARNING: Compiling Ethernet support under Windows requires
extra steps; see the Ethernet readme file.  Ethernet support is
currently available only for Windows, Linux, NetBSD, and OpenBSD.
2011-04-15 08:33:56 -07:00

960 lines
31 KiB
Text

To: Users
From: Bob Supnik
Subj: Interdata 16b/32b Simulator Usage
Date: 15-Jan-2003
COPYRIGHT NOTICE
The following copyright notice applies to both the SIMH source and binary:
Original code published in 1993-2002, written by Robert M Supnik
Copyright (c) 1993-2003, Robert M Supnik
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
ROBERT M SUPNIK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Except as contained in this notice, the name of Robert M Supnik shall not
be used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization from Robert M Supnik.
This memorandum documents the Interdata 16b and 32b simulators.
1. Simulator Files
sim/ sim_defs.h
sim_rev.h
sim_sock.h
sim_tmxr.h
scp.c
scp_tty.c
sim_sock.c
sim_tmxr.c
sim/interdata/ id_defs.h
id16_cpu.c [or id32_cpu.c]
id16_dboot.c [or id32_dboot.c]
id_dp.c
id_fd.c
id_fp.c
id_idc.c
id_io.c
id_lp.c
id_mt.c
id_pas.c
id_pt.c
id_tt.c
id_ttp.c
id_uvc.c
id16_sys.c [or id32_sys.c]
2. Interdata Features
The Interdata simulator includes simulators for a variety of 16b (I3, I4,
I5, 70, 80, 7/16, 8/16, 8/16E) and 32b (7/32, 8/32) models. This is by
no means a complete sampling of all the variations in the Interdata/Perkin-
Elmer family. The 32b family included options for special communications
instructions (7/32C, 8/32C), as well as a later extension for virtual
memory (3200 series).
The Interdata simulator is configured as follows:
device simulates
name(s)
CPU - 16b Interdata 3, 4, 5, 70, 80, 7/16, or 8/16 CPU with 64KB memory
Interdata 8/16E CPU with 256KB memory
CPU - 32b Interdata 7/32 or 8/32 CPU with 1MB memory
SELCH selector channel (1-4)
PT paper tape reader/punch
TT console terminal, Teletype interface
TTP console terminal, PASLA interface
LFC line frequency clock
PIC programmable interval clock
LPT line printer
FD floppy disk
DP 2.5MB/10MB cartridge disk
DM mass storage module (MSM)/intelligent (IDC) disk controller
MT magnetic tape
PAS programmable asynchronous line controller
PASL programmable asyhchronous lines, up to 32
The Interdata simulator implements two unique stop conditions:
- decode of an undefined instruction, and STOP_INST is set
- runaway carriage control tape in the line printer.
The LOAD command is used to load a carriage control tape for the line
printer. The DUMP command is used to dump a contiguous portion of
memory as a self-loading bootstrap paper tape. The syntax for the DUMP
command is:
DUMP <filename> lowaddr-highaddr
The low address must be greater than or equal to X'D0'.
Devices are assigned their default device numbers, as documented in the
Interdata literature. Device numbers can be changed by the command:
SET <device> DEVNO=num
Device number conflicts are not checked until simulation starts. If
there is a device number conflict, simulation stops immediately with
an error message.
Selector channel devices are assigned by default to selector channel 0.
Selector channel assignments can be changed by the command:
SET <dev> SELCH=num
Selector channel assignments cannot introduce conflicts.
Most devices can be disabled and enabled, with the commands:
SET <dev> DISABLED
SET <dev> ENABLED
All devices are enabled by default.
2.1 CPU (16b)
The CPU options include memory size and CPU type:
SET CPU I3 Interdata 3 (base instruction set)
SET CPU I4 Interdata 4 (base plus single precision
floating point)
SET CPU 716 Interdata 7/16 (extended instruction set)
(equivalent to Models 5, 70, and 80)
SET CPU 816 Interdata 8/16 (extended plus double
precision floating point)
SET CPU 816E Interdata 8/16E (extended plus double
precision plus expanded memory)
SET CPU 8K set memory size = 8KB
SET CPU 16K set memory size = 16KB
SET CPU 24K set memory size = 24KB
SET CPU 32K set memory size = 32KB
SET CPU 48K set memory size = 48KB
SET CPU 64K set memory size = 64KB
SET CPU 128K set memory size = 128KB (8/16E only)
SET CPU 256K set memory size = 256KB (8/16E only)
SET CPU CONSINT assert console interrupt (7/16, 8/16,
and 8/16E only)
If memory size is being reduced, and the memory being truncated contains
non-zero data, the simulator asks for confirmation. Data in the truncated
portion of memory is lost. Initial memory size is 64KB.
These switches are recognized when examining or depositing in CPU memory
(or any other byte oriented device):
-b examine/deposit bytes
-w examine/deposit halfwords (CPU default)
-f examine/deposit fullwords
-d data radix is decimal
-o data radix is octal
-h data radix is hexadecimal
-v interpret address as virtual
CPU registers include the visible state of the processor as well as the
control registers for the interrupt system.
name size comments
PC 16 program counter
R0..R15 16 general registers
FR0..F14 32 single precision floating point registers
D0H..D14H 32 double precision floating point registers,
high order
D0L..D14L 32 double precision floating point registers,
low order
PSW 16 processor status word
CC 4 condition codes, PSW<12:15>
SR 16 switch register
DR 32 display register low 16 bits
DRX 8 display register extension (x/16 only)
DRMOD 1 display mode
DRPOS 2 display pointer position
SRPOS 1 switch pointer position
IRQ[0:3] 32 interrupt requests
IEN[0:3] 32 interrupt enables
STOP_INST 1 stop on undefined instruction
STOP_WAIT 1 stop if wait state and no I/O events pending
PCQ[0:63] 16 PC prior to last branch or interrupt;
most recent PC change first
WRU 8 interrupt character
2.2 CPU (32b)
The CPU options include memory size and CPU type:
SET CPU 732 Interdata 7/32, single precision floating point
SET CPU DPFP Interdata 7/32, double precision floating point
SET CPU 832 Interdata 8/32 (double precision floating point)
SET CPU 64K set memory size = 64KB
SET CPU 128K set memory size = 128KB
SET CPU 256K set memory size = 256KB
SET CPU 512K set memory size = 512KB
SET CPU 1M set memory size = 1024KB
SET CPU CONSINT assert console interrupt
If memory size is being reduced, and the memory being truncated contains
non-zero data, the simulator asks for confirmation. Data in the truncated
portion of memory is lost. Initial memory size is 1024KB.
These switches are recognized when examining or depositing in CPU memory
(or any other byte oriented device):
-b examine/deposit bytes
-w examine/deposit halfwords
-f examine/deposit fullwords (CPU default)
-d data radix is decimal
-o data radix is octal
-h data radix is hexadecimal
-v interpret address as virtual
CPU registers include the visible state of the processor as well as the
control registers for the interrupt system.
name size comments
PC 20 program counter
R0..R15 32 active general register set
GREG[32] 32 general register sets, 16 x 2
FR0..FR14 32 single precision floating point registers
if double precision floating point; for
microcoded floating point, floating point
registers are kept in memory locations 00 - 1F
D0H..D14H 32 double precision floating point registers,
high order
D0L..D14L 32 double precision floating point registers,
low order
PSW 16 processor status word
CC 4 condition codes, PSW<12:15>
SR 16 switch register
DR 32 display register low 16 bits
DRX 8 display register extension (x/16 only)
DRMOD 1 display mode
DRPOS 2 display pointer position
SRPOS 1 switch pointer position
MACREG[0:15] 32 memory access controller segment registers
MACSTA 5 memory access controller interrupt status
IRQ[0:3] 32 interrupt requests
IEN[0:3] 32 interrupt enables
STOP_INST 1 stop on undefined instruction
STOP_WAIT 1 stop if wait state and no I/O events pending
PCQ[0:63] 20 PC prior to last branch or interrupt;
most recent PC change first
WRU 8 interrupt character
2.3 Selector Channel (SELCH)
An Interdata system can have 1 to 4 selector channels (SELCH0, SELCH1,
SELCH2, SELCH3). The default number of channels is 2. The number of
channels can be changed with the command:
SET SELCH CHANNELS=num
The selector channels implement these registers:
name size comments
SA[0:3] 20 start address, channels 0 to 3
EA[0:3] 20 end address, channels 0 to 3
CMD[0:3] 8 command, channels 0 to 3
DEV[0:3] 8 active device, channels 0 to 3
RDP[0:3] 2 read byte pointer, channels 0 to 3
WDC[0:3] 3 write data counter, channels 0 to 3
IREQ 4 interrupt requests; right to left,
channels 0 to 3
IENB 4 interrupt enables
2.4 Programmed I/O Devices
2.4.1 Paper Tape Reader/Punch (PT)
The paper tape reader and punch (PT units 0 and 1) read data from or
write data to disk files. The RPOS and PPOS registers specify the
number of the next data item to be read and written, respectively.
Thus, by changing RPOS or PPOS, the user can backspace or advance
these devices.
The paper tape reader supports the BOOT command. BOOT PTR copies the
so-called '50 loader' into memory and starts it running.
The paper tape controller implements these registers:
name size comments
RBUF 8 reader buffer
RPOS 32 reader position in the input file
RTIME 24 time from reader start to interrupt
RSTOP_IOE 1 reader stop on I/O error
PBUF 8 punch buffer
PPOS 32 punch position in the output file
PTIME 24 time from punch start to interrupt
PSTOP_IOE 1 punch stop on I/O error
IREQ 1 paper tape interrupt request
IENB 1 paper tape interrupt enable
IARM 1 paper tape interrupt armed
RD 1 paper tape read/write mode
RUN 1 paper tape running
SLEW 1 paper tape reader slew mode
EOF 1 paper tape reader end of file
Error handling is as follows:
type error STOP_IOE processed as
in,out not attached 1 report error and stop
0 out of tape
in end of file 1 report error and stop
0 out of tape
in,out OS I/O error x report error and stop
2.4.2 Console, Teletype Interface (TT)
The Teletype keyboard (TT0) reads from the console keyboard; the
Teletype printer (TT1) writes to the simulator console window.
The Teletype units (TT0, TT1) can be set to one of three modes:
KSR, 7B, or 8B. In KSR mode, lower case input and output characters
are automatically converted to upper case, and the high order bit is
forced to one on input. In 7B mode, input and output characters are
masked to 7 bits. In 8B mode, characters are not modified. Changing
the mode of either unit changes both. The default mode is KSR.
The Teletype has a BREAK key, which is not present on today's
keyboards. To simulate pressing the break key, stop the simulator
and use the command:
SET TT BREAK
Break status will be asserted, and will remain asserted for the
interval specified by KTIME.
The Teletype interface implements these registers:
name size comments
KBUF 8 input buffer
KPOS 32 number of characters input
KTIME 24 input polling interval
TBUF 8 output buffer
TPOS 32 number of characters output
TTIME 24 time from output start to interrupt
IREQ 1 interrupt request
IENB 1 interrupt enable
IARM 1 interrupt armed
RD 1 read/write mode
FDPX 1 half-duplex
CHP 1 input character pending
2.4.3 Console, PASLA Interface (TTP)
Later Interdata system connect the system console via the first
PASLA interface rather than the Teletype interface. The PASLA
console can be simulated with a Telnet session on the first PAS line.
Alternately, the PASLA console can be attached to the simulator
console window, using the TTP device in place of TT.
To switch the simulator console window to TTP, use the command:
SET TTP ENABLED or
SET TT DISABLED
Device TT is automatically disabled and device TTP is enabled.
To switch the simulator console window back to TT, use the command:
SET TT ENABLED or
SET TTP DISABLED
Device TTP is automatically disabled and device TT is enabled.
If TTP is enabled at its default device settings, the base address
for the PAS multiplexor must be changed:
SET PAS DEVNO=12
Otherwise, a device number conflict occurs.
The PASLA keyboard (TTP0) reads from the console keyboard; the
PALSA printer (TTP1) writes to the simulator console window.
The PASLA units (TTP0, TTP1) can be set to one of three modes:
UC, 7B, or 8B. In UC mode, lower case input and output characters
are automatically converted to upper case. In 7B mode, input and
output characters are masked to 7 bits. In 8B mode, characters
are not modified. Changing the mode of either unit changes both.
The default mode is UC.
To simulate pressing the break key, stop the simulator and use
the command:
SET TTP BREAK
Break status will be asserted, and will remain asserted for the
interval specified by KTIME.
The PASLA console interface implements these registers:
name size comments
KBUF 8 input buffer
KPOS 32 number of characters input
KTIME 24 input polling interval
KIREQ 1 input interrupt request
KIENB 1 input interrupt enabled
KARM 1 input interrupt armed
CHP 1 input character pending
TBUF 8 output buffer
TPOS 32 number of characters output
TTIME 24 time from output start to interrupt
TIREQ 1 output interrupt request
TIENB 1 output interrupt enable
TIARM 1 output interrupt armed
2.4.4 Line Printer (LPT)
The line printer (LPT) writes data to a disk file. The POS register
specifies the number of the next data item to be written. Thus,
by changing POS, the user can backspace or advance the printer.
In addition, the line printer can be programmed with a carriage control
tape. The LOAD command loads a new carriage control tape:
LOAD <file> load carriage control tape file
The format of a carriage control tape consists of multiple lines. Each
line contains an optional repeat count, enclosed in parentheses, optionally
followed by a series of column numbers separated by commas. Column numbers
must be between 0 and 7; column seven is by convention top of form. The
following are all legal carriage control specifications:
<blank line> no punch
(5) 5 lines with no punches
1,5,7 columns 1, 5, 7 punched
(10)2 10 lines with column 2 punched
0 column 0 punched
The default form is 1 line long, with all columns punched.
The line printer implements these registers:
name size comments
BUF 7 last data item processed
BPTR 8 line buffer pointer
LBUF[0:131] 7 line buffer
VFUP 8 vertical forms unit pointer
VFUL 8 vertical forms unit length
VFUT[0:131] 8 vertical forms unit table
IREQ 1 line printer interrupt request
IENB 1 line printer interrupt enable
IARM 1 line printer interrupt armed
POS 32 position in the output file
CTIME 24 character processing time
STIME 24 spacing operation time
STOP_IOE 1 stop on I/O error
Error handling is as follows:
error STOP_IOE processed as
not attached 1 report error and stop
0 out of paper
OS I/O error x report error and stop
2.4.5 Line Frequency Clock (LFC)
The line frequency clock (LFC) implements these registers:
name size comments
IREQ 1 clock interrupt request
IENB 1 clock interrupt enable
IARM 1 clock interrupt armed
TIME 24 clock frequency
TPS 8 ticks per second (120 or 100)
The real-time clock autocalibrates; the clock interval is adjusted up or
down so that the clock tracks actual elapsed time.
2.4.6 Programmable Interval Clock (PIC)
The programmable interval clock (PIC) implements these registers:
name size comments
BUF 16 output buffer
RIC 16 reset interval and rate
CIC 12 current interval
DECR 10 current decrement value
RDP 1 read byte select
OVF 1 interval overflow flag
IREQ 1 clock interrupt request
IENB 1 clock interrupt enable
IARM 1 clock interrupt armed
If the interval requested is longer than 1 msec, the programmable clock
auto-calibrates; if not, it simply counts instructions.
2.4.7 Floppy Disk Controller (FD)
Floppy disk options include the ability to make units write enabled or
write locked.
SET FDn LOCKED set unit n write locked
SET FDn WRITEENABLED set unit n write enabled
Units can also be set ONLINE or OFFLINE.
The floppy disk supports the BOOT command. BOOT FDn copies an autoload
sequence into memory and starts it running.
The floppy disk controller implements these registers:
name size comments
CMD 8 command
STA 8 status
BUF 8 buffer
LRN 16 logical record number
ESTA[0:5] 8 extended status bytes
DBUF[0:127] 8 transfer buffer
DBPTR 8 transfer buffer pointer
IREQ 1 interrupt request
IENB 1 interrupt enabled
IARM 1 interrupt armed
CTIME 24 command response time
STIME 24 seek time, per cylinder
XTIME 24 transfer time, per byte
STOP_IOE 1 stop on I/O error
Error handling is as follows:
error STOP_IOE processed as
not attached 1 report error and stop
0 disk not ready
Floppy disk data is buffered in memory; therefore, end of file and OS
I/O errors cannot occur.
2.4.8 Programmable Asynchronous Line Adapters (PAS, PASL)
The Programmable Asynchronous Line Adapters (PAS and PASL) represent,
indistinguishably, individual PASLA interfaces, two lines asynchronous
multiplexors, and 8 line asynchronous multiplexors, with a maximum
of 32 lines. All the lines are modelled as a terminal multiplexor, with
PAS as the multiplexor controller, and PASL as the indivdual lines. The
PASLAs perform input and output through Telnet sessions connected to a
user-specified port. The ATTACH command specifies the port to be used:
ATTACH PAS <port> set up listening port
where port is a decimal number between 1 and 65535 that is not being used
for other TCP/IP activities.
Each line (each unit of PASL) can be set to one of three modes: UC, 7B,
or 8B. In UC mode, lower case input and output characters are converted
automatically to upper case. In 7B mode, input and output characters are
masked to 7 bits. In 8B mode, characters are not modified. The default
mode is UC. Each line (each unit of PASL) can also be set for modem
control with the command SET PASLn DATASET. The defaults are UC mode
and DATASET disabled.
Once PAS is attached and the simulator is running, the terminals listen
for connections on the specified port. They assume that the incoming
connections are Telnet connections. The connections remain open until
disconnected either by the Telnet client, a SET PAS DISCONNECT command,
or a DETACH PAS command.
The SHOW PAS CONNECTIONS command displays the current connections to the
extra terminals. The SHOW PAS STATISTICS command displays statistics for
active connections. The SET PAS DISCONNECT=linenumber disconnects the
specified line.
The controller (PAS) implements these registers:
name size comments
STA[0:31] 8 status, lines 0 to 31
CMD[0:31] 16 command, lines 0 to 31
RBUF[0:31] 8 receive buffer, lines 0 to 31
XBUF[0:31] 8 transmit buffer, lines 0 to 31
RIREQ 32 receive interrupt requests;
right to left, lines 0 to 31
RIENB 32 receive interrupt enables
RARM[0:31] 1 receive interrupt armed
XIREQ 32 transmit interrupt requests;
right to left, lines 0 to 31
XIENB 32 transmit interrupt enables
XARM[0:31] 1 transmit interrupt armed
RCHP[0:31] 1 receiver character present, lines 0 to 31
The lines (PASL) implements these registers:
name size comments
TIME[0:31] 24 transmit time, lines 0 to 31
The additional terminals do not support save and restore. All open
connections are lost when the simulator shuts down or PAS is detached.
2.5 Cartridge Disk Controller (DP)
Cartridge disk options include the ability to make units write enabled or
write locked, and to select the type of drive:
SET DPn LOCKED set unit n write locked
SET DPn WRITEENABLED set unit n write enabled
SET DPn 2315 set unit n to 2315 (2.5MB)
SET DPn 5440 set unit n to 5440 (10MB)
Units can also be set ONLINE or OFFLINE.
The cartridge disk supports the BOOT command. To boot OS16/32, the hex
form of the operating system file's extension must be placed in locations
7E:7F. The disk bootstrap looks for a valid OS16/32 volume descriptor in
block 0, and uses that to locate the volume directory. It then searches
the directory for a filename of the form OS16xxxx.hhh or OS32xxxx.hhh,
where the xxxx is ignored and hhh is the ASCII form of the extension from
locations 7E:7F. The 32b bootstrap can also boot Wollongong UNIX; locations
7E:7F must be 0.
All drives have 256 8b bytes per sector. The other disk parameters are:
drive cylinders surfaces sectors
2315 203 2 24
5440 408 4 12
The cartridge disk controller implements these registers:
name size comments
CMD 3 current command
STA 8 controller status
BUF 8 controller buffer
HDSC 8 current head/sector select
CYL 8 current cylinder select
DBUF[0:255] 8 transfer buffer
DBPTR 16 transfer buffer point
DBLNT 16 transfer buffer length
FIRST 1 first DMA service flag
IREQ 5 interrupt requests; right-to-left,
controller, drives 0 to 3
IENB 5 interrupt enables
IARM[0:3] 1 interrupts armed, drives 0 to 3
STIME 24 seek latency, per cylinder
RTIME 24 rotational latency, per sector
WTIME 24 inter-word latency
Error handling is as follows:
error processed as
not attached disk not ready
end of file assume rest of disk is zero
OS I/O error report error and stop
2.6 Mass Storage Module/Intelligent Disk Controller (DM)
MSM/IDC disk controller options include the ability to make units
write enabled or write locked, and to select the type of drive:
SET DMn LOCKED set unit n write locked
SET DMn WRITEENABLED set unit n write enabled
SET DMn MSM80 set unit n to storage module, 80MB
(67MB formatted)
SET DMn MSM300 set unit n to storage module, 300MB
(262MB formatted)
SET DMn MCCD16 set unit n to medium capacity, 16MB
(13.5MB formatted)
SET DMn MCCD48 set unit n to medium capacity, 48MB
(40.5MB formatted)
SET DMn MCCD80 set unit n to medium capacity, 80MB
(67MB formatted)
SET DMn MSM330F set unit n to storage module, 330MB
(300MB formatted)
Note that the disk bootstraps can ONLY boot the MSM80 and MSM300.
Units can be set ONLINE or OFFLINE.
The MSM/IDC controller supports the BOOT command. To boot OS16/32, the hex
form of the operating system file's extension must be placed in locations
7E:7F. The disk bootstrap looks for a valid OS16/32 volume descriptor in
block 0, and uses that to locate the volume directory. It then searches
the directory for a filename of the form OS16xxxx.hhh or OS32xxxx.hhh,
where the xxxx is ignored and hhh is the ASCII form of the extension from
locations 7E:7F. The 32b bootstrap can also boot Wollongong UNIX; locations
7E:7F must be 0. Note that only the MSM80 and MSM300 drives can be boot-
strapped; the boot code does not recognize the other drives.
All drives have 256 8b bytes per sector. The other disk parameters are:
drive cylinders surfaces sectors
MSM80 823 5 64
MSM300 823 19 64
MCCD16 823 1 64
MCCD48 823 3 64
MCCD80 823 5 64
MSM300F 1024 16 64
The MSM/IDC disk controller implements these registers:
name size comments
STA 8 controller status
BUF 8 controller buffer
SEC 8 current sector select
DBUF[0:767] 8 transfer buffer
DBPTR 16 transfer buffer point
DBLNT 16 transfer buffer length
FIRST 1 first DMA service flag
IREQ 5 interrupt requests; right-to-left,
controller, drives 0 to 3
IENB 5 interrupt enables
SIREQ 5 saved interrupt requests
ICARM 1 controller interrupt armed
IDARM[0:3] 1 drive interrupts armed, drives 0 to 3
STIME 24 seek latency, per cylinder
RTIME 24 rotational latency, per sector
WTIME 24 inter-word latency
Error handling is as follows:
error processed as
not attached disk not ready
end of file assume rest of disk is zero
OS I/O error report error and stop
2.7 Magnetic Tape Controller (MT)
Magnetic tape options include the ability to make units write enabled or
or write locked.
SET MTn LOCKED set unit n write locked
SET MTn WRITEENABLED set unit n write enabled
Units can also be set ONLINE or OFFLINE.
The magnetic tape supports the BOOT command. BOOT MTn copies an autoload
sequence into memory and starts it running.
The magnetic tape controller implements these registers:
name size comments
CMD 8 command
STA 8 status
BUF 8 buffer
DBUF[0:65535] 8 transfer buffer
DBPTR 16 transfer buffer pointer
DBLNT 16 transfer buffer length
XFR 1 transfer in progress flag
FIRST 1 first DMA service flag
IREQ 4 interrupt requests; right to left,
drives 0 to 3
IENB 4 interrupt enables
IARM[0:3] 1 interrupts armed, drives 0 to 3
STOP_IOE 1 stop on I/O error
WTIME 1 word transfer time
RTIME 1 interrecord latency
UST[0:3] 8 unit status, drives 0 to 3
POS[0:3] 32 tape position, drives 0 to 3
Error handling is as follows:
error processed as
not attached tape not ready; if STOP_IOE, stop
end of file set error flag
OS I/O error set error flag; if STOP_IOE, stop
2.8 Symbolic Display and Input
The Interdata simulator implements symbolic display and input. Display is
controlled by command line switches:
-a display as ASCII character
-c display as two character string
-m display instruction mnemonics
Input parsing is controlled by the first character typed in or by command
line switches:
' or -a ASCII character
" or -c two character sixbit string
alphabetic instruction mnemonic
numeric octal number
2.7.1 16b Instruction Input
Instruction input uses standard Interdata assembler syntax. There are
seven instruction classes: short branch, extended short branch, short
immediate, register, register-register, memory, and register-memory.
Short branch instructions have the format
sbop mask,address
where the mask is a hex (decimal) number between 0 and F (15), and
the address is within +32 (forward branch) or -32 (backward branch)
of the current location.
Extended short branch instructions have the format
sbxop address
where the address is within +32 or -32 of the current location. For
extended short branches, the simulator chooses the forward or backward
direction automatically.
Short immediate instructions have the format
siop regnum,immed
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), and the immediate is a hex digit
between 0 and F.
Register instructions have the format
rop regnum
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15).
Register-register instructions have the format
rrop regnum,regnum
where the register numbers are hex (decimal) numbers, optionally
preceded by R, between 0 and F (15).
Memory instructions have the format
mop address{(index)}
where address is a hex number between 0 and 0xFFFF, and the index
register is a hex (decimal) number, optionally preceded by R,
between 1 and F (15).
Register-memory instructions have the format
rmop regnum,address{(index)}
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), the address is a hex number
between 0 and 0xFFFF, and the index register is a hex (decimal)
number, optionally preceded by R, between 1 and F (15).
2.7.2 32b Instruction Input
Instruction input uses standard Interdata assembler syntax. There are
nine instruction classes: short branch, extended short branch, short
immediate, 16b immediate, 32b immediate, register, register-register,
memory, and register-memory.
Short branch instructions have the format
sbop mask,address
where the mask is a hex (decimal) number between 0 and F (15), and
the address is within +32 (forward branch) or -32 (backward branch)
of the current location.
Extended short branch instructions have the format
sbxop address
where the address is within +32 or -32 of the current location. For
extended short branches, the simulator chooses the forward or backward
direction automatically.
Short immediate instructions have the format
siop regnum,immed
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), and the immediate is a hex digit
between 0 and F.
16b immediate instructins have the format
i16op regnum,immed16{(index)}
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), the immediate is a hex number
between 0 and 0xFFFF, and the index register is a hex (decimal)
number, optionally preceded by R, between 1 and F (15).
32b immediate instructions have the format
i32op regnum,immed32{(index)}
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), the immediate is a hex number
between 0 and 0xFFFFFFFF, and the index register is a hex (decimal)
number, optionally preceded by R, between 1 and F (15).
Register instructions have the format
rop regnum
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15).
Register-register instructions have the format
rrop regnum,regnum
where the register numbers are hex (decimal) numbers, optionally
preceded by R, between 0 and F (15).
Memory instructions have the format
mop address{(index)} or
mop address{(index1,index2)}
where address is a hex number between 0 and 0xFFFF, and the index
registers are hex (decimal) numbers, optionally preceded by R,
between 1 and F (15).
Register-memory instructions have the format
rmop regnum,address{(index)} or
rmop regnum,address{(index1,index2)}
where the register number is a hex (decimal) number, optionally
preceded by R, between 0 and F (15), the address is a hex number
between 0 and 0xFFFF, and the index registers are hex (decimal)
numbers, optionally preceded by R, between 1 and F (15).
For memory operands, the simulator automatically chooses the format
(RX1, RX2, RX3) that consumes the fewest bytes. If both RX1 and RX2
are feasible, the simulator chooses RX1.