simh-testsetgenerator/Ibm1130/readme1130.txt
Bob Supnik 2c2dd5ea33 Notes For V2.10-0
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.

1. New Features

1.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.

1.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.

1.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.

1.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.

1.5 PDP-1

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

1.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.

1.7 IBM 1620

- The IBM 1620 simulator has been released.

1.8 AltairZ80

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

1.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.

1.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.

1.11 Simulated DECtapes

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

2. Release Notes

2.1 Bugs Fixed

- 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.

2.2 HP 2100 Debugging

- The HP 2100 CPU nows runs all of the CPU diagnostics.
- The peripherals run most of the peripheral diagnostics.  There
  is still a problem in overlapped seek operation on the disks.
  See the file hp2100_diag.txt for details.

3. In Progress

These simulators are not finished and are available in a separate
Zip archive distribution.

- Interdata 16b/32b: coded, partially tested.  See the file
  id_diag.txt for details.
- SDS 940: coded, partially tested.
2011-04-15 08:33:49 -07:00

184 lines
No EOL
6.5 KiB
Text

Here's the 1130 simulator as it stands now.
Status: 13Sep2002
* Added support for 1403 printer. It's MUCH faster
even in emulation. Not important for general use,
but it will help the CGI version a lot.
Status: 16Aug2002
* Disk Monitor System R2V12 is available including the
Macro Assembler, Fortran Compiler and System Library.
* There was a bug in the multiply instruction. This has
been fixed, and now the single precision trig functions
work correctly.
* The card punch does not yet work correctly.
* The card reader, punch and disk don't compute their device
status word until an XIO requests it; this is probably bad
as the "examine" command will show the wrong value. Doesn't
affect functioning of emulated software, though.
* Documentation is a work in progress, see ibm1130.doc
in ibm1130software.zip. We hope to have it finished in
October. This is a Word document. Will distribute as a
PDF when it's finished.
* Thanks to Oscar E Wyss (www.cosecans.ch) for
the DMS V12 source code listings and one card
programs, to Douglas W. Jones for the DMS V10, 11 and
12 microfiche (which will end up scanned on IBM1130.org).
* Thanks to Robert Alan Byer for adding the 1130
to the simh makefiles & testing the builds on several
platforms.
* For updated information about the 1130 and for
future 1130 OS and application software developments,
check www.ibm1130.org periodically. Sign up for the
mailing list to get updates as they occur!
* Cross-assembler has been updated to handle card image input
correctly. The DMS sources seems to mix up @ and '
as a leading symbol in labels, I have to find out why
this is.
BUILD NOTES: if you download this simulator directly from
IBM1130.org, the makefile, source, and binaries are all in
the main directory. If you use the version from Bob Supnik's
SIMH distribution, the makefile is in the main simh
directory, and the SCP files used are Bob's. For a
Windows build, use the .mak file in the IBM1130 directory,
as this incorporates the GUI.
Make the utilities in the utils directory if you want
to actually build and load DMS from scratch. Move the
executables to a common directory in your search path
Brian Knittel
brian@ibm1130.org
--------------------------------------------------------------------------
Some sample things to run:
(it's best to hit CHECK RESET or type "reset" between program runs!)
* Run a Fortran Program
ibm1130
do job roots
do job csort
* List the monitor system disk's contents
ibm1130
do job list
* Look into the files "job", "roots.job" and "csort.job" and "list.job"
to see the actual input files
* When the jobs have run (stop at 2A with 1000 in the
accumulator), detach the printer (det prt) and look at
the output file: for.lst or asm.lst. The supplied "job"
script displays the print output automatically on Windows
builds.
--------------------------------------------------------------------------
Contents:
There are several programs:
ibm1130 the simulator
asm1130 cross assembler
bindump dumps contents of relocatable format object decks (xxx.bin)
checkdisk validates DMS disk format
diskview dumps contents of DMS disk directory
mkboot creates IPL and Core Image Format Decks from .bin
viewdeck displays contents of Hollerith-format binary decks
Files in the software (sw) directory:
actual 1130 software:
dms.dsk disk image file containing Disk Monitor System
zdcip.asm disk cartridge initialization program
zcrdumpc.asm a cold-start-mode one card memory dump program
dmsboot.asm source code for the DMS cold start loader
contributed software:
onecard/* one-card programs from Oscar Wyss
--------------------------------------------------------------------------
Status of the simulator:
* There is a reasonably fun console GUI available for Windows builds,
as well as support for the 2250 graphical display.
* The card reader emulator now supports deck files with literal cards and
breakpoints. The command "attach cr @filename" tells the simulator to
read data from the files named in the specified file. Input lines are of
the following form:
filename a -- input file to be read as ascii text
filename b -- input file to be read as binary card images
!xyz... -- literal text xyz..., treated as a card
!break -- halts the simulator
#comment -- remarks
* The do command may have arguments after the filename. These may be
interpolated in the script and in card reader deck files with %1, %2, etc
--------------------------------------------------------------------------
sample usage
--------------------------------------------------------------------------
ibm1130
starts SIMH-based simulator.
Optional command line arguments: -q quiet mode, -g no GUI
Enhancements:
* Windows builds display a console window
* CPU activity log
the command "attach cpu file.log" will make the simulator
write a detailed log of CPU and IO activity, good for
debugging. Turn off with "detach cpu".
* DO command [arg1 arg2...]
reads file 'filename' for SIMH commands. Lets you write
simh command files to be run from the prompt rather
than just the command line. In the do command file, %1 will
be replaced by the first command line argument, etc. This
applies to the script run from the ibm1130 command line too.
* DELETE filename
deletes the named file
* VIEW filename
displays the named file with "notepad." (Windows only).
--------------------------------------------------------------------------
asm1130 -l program.asm
compiles source file, creates simulator load
file (program.out) and listing file (program.lst)
The cross assembler wants files either in strict column
layout matching the IBM spec, or, if tabs are present in the
source file,
label<tab>opcode<tab>flags<tab>operand
The output file is in the format used by the 1130 simulator's
load command.
--------------------------------------------------------------------------
Note: the DMS disk is built with the Windows batch file "mkdms.bat".
Subnote: DMS cannot be built with the 1130's native assembler.
--------------------------------------------------------------------------
check www.ibm1130.org for updates...