[pups] Enhancement of SIMH-V2.5a

[Wolfgang Helbig]

Hi,

As the subject says, I enhanced the PDP-11 simulator from Robert
Supnik(V2.5a). Please tell me, if the README sounds interesting to
you. In that case, maybe we could arrange to put the tar ball on
one of minnie's disks.

Wolfgang

Here is the README:

MAR-13-01

This directory contains Robert Supnik's simulator controller V2.5a
together with the PDP-11 simulator. I modified the PDP-11 simulator.
The other simulators from the original V2.5a distribution are not
included in this directory.

The details:
Physical Addresses 
------------------
The deposit and examine commands treated physical addresses as 22
bit addresses, even if the CPU was set to 18 bit addresses. Thus,
the I/O page was addressed from 17760000 to 17777776.  I changed
this.  Now, if the CPU is set to 18 bit, the I/O page is addressed
from 760000 to 770000.

Three additional KL11 terminal devices:
---------------------------------------
KL11 File Input (KLI0, KLI1, KLI2):
The KL11 file input (KLIx) units read from an attached file. They 
implement the same registers as the KL11 terminal input (TTI).
(cf. 5.2.3 in simh_doc.txt)

KL11 File Output (KLO0, KLO1, KLO2)
The KL11 file output (KLOx) units append to an attached file.  They
implement the same registers as the KL11 terminal output unit (TTI).
(cf. 5.2.4 in simh_doc.txt)

The added program ASR supplies a (host)-terminal interface to
the KLI/O attached files.
ASR is invoked as
	asr kli klo .
It polls the host terminal (stdin) and appends the polled bytes
to the file kli. Furthermore it polls the file klo and copies
the polled bytes to the host terminal (stdout).

To quit asr, enter ^E.

To build asr, enter:
	cc asr.c scp_tty.c
	cp a.out asr

Building the pdp11-simulator:
The source code is in pdp11_kl.c. So the installation instructions in
simh_doc.txt apply.

Both asr and pdp11_kl.c is only tested on NetBSD 1.5. It hopefully
works on other UNIX-like host operating systems as well.

Example of who to to connect the file-I/O KL-devices and asr:
Start the simulator.
Attach the file kli to KLI0 and the file klo to KLO0.
Enter
	asr kli klo
from another host terminal.
Now, whatever you type, goes to KLI0, and whatever is written by
KLO0 is typed onto your terminal.

Device numbers of the terminal devices in PDP11-UNIX V6:
UNIT		major/minor number
TTI/TTO		0/0	(/dev/tty8, the console)
KLI0/KLO0	0/1
KLI1/KLO1	0/2
KLI2/KLO2	0/3

Synchronization of the line clock to the host clock:
---------------------------------------------------
"SYNC" is an add-on to the PDP-11 line clock device. It tries to
synchronize the Line-time Clock (CLK, cf. 5.2.6 in simh_doc.txt)
with the host time. It only works if the unsynchronized CLK runs
too fast. On every tick of CLK, the simulator then sleeps until a
total of 1/60 seconds elapsed from the last tick.

Synchronization slows down the simulator and reduces the load of
the CPU.  It is turned on automatically through activation of
the CLK device.  The clock device is activated through a RESET.
You can turn off synchronization by depositing '1' into the newly
added "SYNCH"-register of the CLK-unit. To turn on synchronizing,
deposit '0' into it. If synchronizing is active, the SYNCH-register
shows the host time (number of seconds elapsed since Jan 1 1970
UTC).

Have fun,

Wolfgang Helbig <helbig at ba-stuttgart.de>

Received: (from major at localhost)
	by minnie.cs.adfa.edu.au (8.9.3/8.9.3) id GAA49442
	for pups-liszt; Sat, 7 Apr 2001 06:55:26 +1000 (EST)
	(envelope-from owner-pups at minnie.cs.adfa.edu.au)