simh-testsetgenerator/3B2/README.md
Seth Morabito 9b62da6567 3B2-700 Initial Public Release
This commit introduces dozens of changes to make the 3B2-700 simulator
fully functional and ready for wider use. In addition to 3B2-700
availability, this commit includes a tremendous amount of refactoring
of the 3B2-400 and common code to make the project structure easier to
maintain and reason about.

One final important change: ROM files are no longer included in the
source code. 3B2 ROM images must be obtained separately and loaded
into the simulator before boot.

Changes:

- The 3b2 target has been aliased to 3b2-400
- The formerly named 3b2-600 project has become 3b2-700
- SCSI QIC tape support has been added to sim_scsi.c
- Header files have been reworked to reduce complexity of includes
- Common code has been consolidated
- Timer code has been unified
2022-09-15 14:15:28 -07:00

3.9 KiB

AT&T 3B2 Simulator

This module contains the source for two simulators:

  1. A simulator for the AT&T 3B2/400 computer (3b2 or 3B2.EXE)
  2. A simulator for the AT&T 3B2/700 computer (3b2-700 or 3B2-700.EXE)

The 3B2/400 simulator is complete, usable, and robust. The 3B2/700 simulator is under active development and is not yet considered stable.

Full documentation for the 3B2 simulator is available here:

3B2/400 Simulator 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 (TMR)
  • 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)

3B2/400 Simulator 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 on the 3B2/400

UNIX System V UNIX 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 on the 3B2/400

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.

More information about installing AT&T System V Release 3.2 UNIX is available on the web: