simh-testsetgenerator/3B2/README.md
Seth Morabito 9d849283a4 3B2: Interrupt Refactor and DEMON ROM
- This change introduces a full refactor of the interrupt subsystem
  for the system board (SBD) and the I/O bus (CIO). Interrupt decode
  should now be significantly faster, and not require an expensive
  calculation on every step.

- The TIMER device has been split into Rev 2 and Rev 3
  implementations.

- The optional 3B2/400 Debug Monitor ROMs can now be booted by passing
  the "DEMON" argument to the 3B2/400 simulator BOOT command. Any
  of the following will cause the Debug Monitor ROM to be booted
  instead of the standard 3B2/400 ROM:

     sim> BOOT DEMON
     sim> BOOT CPU DEMON
     sim> BOOT DEMON CPU
2021-08-24 06:35:49 -07:00

129 lines
3.8 KiB
Markdown

AT&T 3B2 Simulator
==================
This module contains the source for two simulators:
1. A simulator for the AT&T 3B2 Model 400 computer (Rev. 2)
2. A simulator for the AT&T 3B2 Model 600 computer (Rev. 3)
The 3B2/400 simulator is complete, usable, and robust. The 3B2/600 simulator
is not yet usable, however. It is under active development.
Full documentation for the 3B2 simulator is available here:
- https://loomcom.com/3b2/emulator.html
Devices
-------
The following devices are simulated. The SIMH names for the simulated
devices are given in parentheses:
- 3B2 Model 400 System Board with 1MB, 2MB, or 4MB RAM (CSR, NVRAM)
- WE32100 CPU (CPU)
- WE32101 MMU (MMU)
- PD8253 Interval Timer (TIMER)
- AM9517 DMA controller (DMAC)
- SCN2681A Integrated DUART (IU)
- TMS2793 Integrated Floppy Controller (IFLOPPY)
- uPD7261A Integrated MFM Fixed Disk Controller (IDISK)
- Non-Volatile Memory (NVRAM)
- MM58174A Time Of Day Clock (TOD)
- CM195A Ethernet Network Interface (NI)
- CM195B 4-port Serial MUX (PORTS)
- CM195H Cartridge Tape Controller (CTC)
Usage
-----
To boot the 3B2 simulator into firmware mode, simply type:
sim> BOOT
You will be greeted with the message:
FW ERROR 1-01: NVRAM SANITY FAILURE
DEFAULT VALUES ASSUMED
IF REPEATED, CHECK THE BATTERY
FW ERROR 1-02: DISK SANITY FAILURE
EXECUTION HALTED
SYSTEM FAILURE: CONSULT YOUR SYSTEM ADMINISTRATION UTILITIES GUIDE
NVRAM and Time of Day can be saved between boots by attaching both
devices to files.
sim> ATTACH NVRAM <nvram-file>
sim> ATTACH TOD <tod-file>
If you have no operating system installed on the hard drive, on
subsequent boots you will instead see the message
SELF-CHECK
FW ERROR 1-02: DISK SANITY FAILURE
EXECUTION HALTED
SYSTEM FAILURE: CONSULT YOUR SYSTEM ADMINISTRATION UTILITIES GUIDE
Once you see the `SYSTEM FAILURE` message, this is actually an
invisible prompt. To access firmware mode, type the default 3B2
firmware password `mcp`, then press Enter or carriage return.
You should then be prompted with:
Enter name of program to execute [ ]:
Here, you may type a question mark (?) and press Enter to see a list
of available firmware programs.
Booting UNIX SVR3
-----------------
UNIX SVR3 is the only operating system available for the 3B2. To boot
UNIX, attach the first disk image from the 3B2 "Essential Utilities"
distribution.
sim> ATTACH IFLOPPY <floppy-image>
sim> BOOT
Once you reach the `SYSTEM FAILURE` message, type `mcp` to enter
firmware mode. When prompted for the name of a program to boot, enter
`unix`, and confirm the boot device is `FD5` by pressing Enter or
carriage return.
Enter name of program to execute [ ]: unix
Possible load devices are:
Option Number Slot Name
---------------------------------------
0 0 FD5
Enter Load Device Option Number [0 (FD5)]:
Installing SVR3
---------------
To install SVR3 to the first hard disk, first, attach a new image
to the IDISK0 device:
sim> ATTACH IDISK0 <hd-image>
Then, boot the file `idtools` from the "3B2 Maintenance Utilities -
Issue 4.0" floppy diskette.
From `idtools`, select the `formhard` option and low-level format
integrated disk 0. Parameters for the default 72MB hard disk are:
Drive Id: 5
Number cylinders: 925
Number tracks/cyl: 9
Number sectors/track: 18
Number bytes/sector: 512
After low-level formatting integrated disk 0, boot the file `unix`
from the first diskette of the 3B2 "Essential Utilities" distribution,
and follow the prompts.