2bcd1e7c4c
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.
187 lines
8.7 KiB
Text
187 lines
8.7 KiB
Text
This file contains information about the XQ/SIM_ETHER package.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
16-Jan-03 Release:
|
|
1. Added VMScluster support (thanks to Mark Pizzolato)
|
|
2. Verified VAX remote boot functionality (>>>B XQA0)
|
|
3. Added major performance enhancements (thanks to Mark Pizzolato again)
|
|
4. Changed _DEBUG tracers to XQ_DEBUG and ETH_DEBUG
|
|
5. Added local packet processing
|
|
6. Added system id broadcast
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
GOLD Changes: (08-Nov-02)
|
|
1. Added USE_NETWORK conditional to Sim_Ether
|
|
2. Fixed behaviour of SHOW XQ ETH if no devices exist
|
|
3. Added OpenBSD support to Sim_Ether (courtesy of Federico Schwindt)
|
|
4. Added ethX detection simplification (from Megan Gentry)
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
BETA 5 Changes: (23-Oct-02)
|
|
1. Added all_multicast and promiscuous mode support
|
|
2. Finished DEQNA emulation
|
|
3. Verified LAT functionality
|
|
4. Added NXM (Non-eXistant Memory) protection (suggested by Robert Supnik)
|
|
5. Added NetBSD support to Sim_Ether (courtesy of Jason Thorpe)
|
|
6. Fixed write buffer overflow bug (discovered by Jason Thorpe)
|
|
7. Fixed unattached device behavior (discovered by Patrick Caulfield)
|
|
8. Extensive rewrite of this README
|
|
9. Debugged sanity timer
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
BETA 4 Changes: (16-Oct-02)
|
|
1. Added stub support for all_multicast and promiscuous modes
|
|
2. Integrated with SIMH v2.10-0b1
|
|
3. Added VAX network bootstrap support
|
|
4. Added SET/SHOW XQ TYPE and SANITY commands
|
|
5. Added stub support for DEQNA mode
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
BETA 3 Changes: (10-Oct-02)
|
|
1. Fixed off-by-one bug in setup address processing
|
|
2. Added rejection of multicast addresses to SET XQ MAC
|
|
3. Added linux support to Sim_Ether (courtesy of Patrick Caulfield)
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
BETA 2 Changes: (08-Oct-02)
|
|
1. Integrated with SIMH v2.10-0p4
|
|
2. Added floating vectors; this also fixes pdp11 emulation problem
|
|
3. Cleaned up codebase; 100% of packet driver code moved to Sim_Ether
|
|
4. Verified TCP/IP functionality
|
|
5. Added Copyrights
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
BETA 1 Changes: (03-Oct-02)
|
|
1. Moved most of packet driver functionality from XQ to Sim_Ether
|
|
2. Verified DECNET functionality
|
|
3. Added SET/SHOW MAC command
|
|
4. Added SHOW ETH command
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
The XQ emulator is a host-independant software emulation of Digital's
|
|
DELQA (M7516) and DEQNA (M7504) Q-bus ethernet cards for the SIMH emulator.
|
|
|
|
See the last section of this document for XQ usage instructions.
|
|
|
|
The XQ emulator uses the Sim_Ether module to execute host-specific ethernet
|
|
packet reads and writes, since all operating systems talk to real ethernet
|
|
cards/controllers differently. The host-dependant Sim_Ether module currently
|
|
supports Windows, Linux, and NetBSD.
|
|
|
|
Currently, the Sim_Ether module sets the selected ethernet card into
|
|
promiscuous mode to gather all packets, then filters out the packets that it
|
|
doesn't want. In Windows, Packets having the same source MAC address as the
|
|
controller are ignored for WinPCAP compatibility (see Windows notes below).
|
|
|
|
If your ethernet card is plugged into a switch, the promiscuous mode setting
|
|
should not cause much of a problem, since the switch will still filter out
|
|
most of the undesirable traffic. You will only see "excessive" traffic if you
|
|
are on a direct or hub(repeater) segment.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Windows notes:
|
|
1. The Windows-specific code uses the WinPCAP 3.0 (or 2.3) package from
|
|
http://winpcap.polito.it. This package for windows simulates the libpcap
|
|
package that is freely available for unix systems.
|
|
2. You must *install* WinPCAP.
|
|
3. Note that WinPCAP DOES NOT support dual CPU environments.
|
|
4. WinPCAP loops packet writes back into the read queue. This causes problems
|
|
since the XQ controller is not expecting to read it's own packet. A fix
|
|
to the packet read filter was added to reject packets from the current MAC,
|
|
but this defeats DECNET's duplicate node number detection scheme. A more
|
|
correct fix for WinPCAP will be explored as time allows.
|
|
5. The first time the WinPCAP driver is used, it will be dynamically loaded,
|
|
and the user must be an Administrator on the machine to do so. If you need
|
|
to run as an unprivileged user, you must set the service to autostart. See
|
|
the WinPCAP documentation for details on the static load workaround.
|
|
|
|
Building on Windows:
|
|
1. Install WinPCAP 3.0.
|
|
2. Get the required .h files (bittypes.h, devioctl.h, ip6_misc.h, packet32.h,
|
|
pcap.h, pcap-stdinc.h) from the WinPCAP 3.0 developer's kit
|
|
3. Get the required .lib files (packet.lib, wpcap.lib) from the WinPCAP 3.0
|
|
developer's kit. If you're using Borland C++, use COFF2OMF to convert
|
|
the .lib files into a format that can be used by the compiler.
|
|
4. Define USE_NETWORK if you want the network functionality.
|
|
5. Build it!
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Linux, NetBSD, and OpenBSD notes:
|
|
|
|
1. You must run SIMH(scp) as root so that the ethernet card can be set into
|
|
promiscuous mode by the driver. Alternative suggestions will be welcomed.
|
|
|
|
Building on Linux, NetBSD, and OpenBSD:
|
|
1. Define USE_NETWORK if you want the network functionality.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
THE XQ/SIM_ETHER modules have been successfully tested on a Windows 2000 host,
|
|
emulating an OpenVMS 7.2 VAX system with DECNET Phase IV, MultiNet 4.4a, and
|
|
LAT 5.3.
|
|
|
|
Regression test criteria:
|
|
1. VAX shows device correctly (passed)
|
|
2. VMS boots successfully with new device emulation (passed)
|
|
3. VMS initializes device correctly (passed)
|
|
4. DECNET loads successfully (passed)
|
|
5. DECNET line stays up (passed)
|
|
6. SET HOST x.y:: works from SIMH to real DECNET machine (passed)
|
|
7. SET HOST x.y:: works from real DECNET machine to SIMH (passed)
|
|
8. DECNET copy works from SIMH to real DECNET machine (passed)
|
|
9. DECNET copy works from real DECNET machine to SIMH (passed)
|
|
10. MultiNet TCP/IP loads successfully (passed)
|
|
11. Multinet TCP/IP initializes device successfully (passed)
|
|
12. SET HOST/TELNET x.y.z.w works from SIMH to real VAX IP machine (passed)
|
|
13. SET HOST/TELNET x.y.z.w works from real VAX IP machine to SIMH (passed)
|
|
14. FTP GET from a real VAX IP machine (passed)
|
|
15. LAT loads sucessfully (passed)
|
|
16. SET HOST/LAT <nodename> works from SIMH to real VAX LAT machine (passed)
|
|
17. SET HOST/LAT <nodename> works from real VAX LAT machine to SIMH (passed)
|
|
18. SIMH node joins VMSCluster (passed)
|
|
19. SIMH node mounts other VMSCluster disks (passed)
|
|
20. SIMH node MSCP serves disks to other nodes (passed)
|
|
21. SIMH node remote boots into VMScluster (>>>B XQAO) (passed)
|
|
|
|
The following are known to NOT work:
|
|
1. PDP-11 using RSTS/E v10.1 (fails to enable device - needs bootrom support)
|
|
|
|
I have reports that the following work:
|
|
1. PDP-11 using RSX
|
|
2. VAX remote booting of NetBSD (via >>> B XQA0)
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Things planned for future releases:
|
|
1. Full MOP implementation
|
|
2. PDP-11 bootstrap/bootrom
|
|
3. DESQA support (if someone can get me the user manuals)
|
|
4. DETQA support [DELQA-Turbo] (I have the manual)
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Things which I need help with:
|
|
1. Porting Sim_Ether packet driver to other platforms, especially VMS.
|
|
2. Information about Remote MOP processing
|
|
3. PDP-11 bootstrap code.
|
|
4. VAX hardware diagnotics image file and docs, to test XQ thoroughly.
|
|
5. Feedback on operation with other VAX OS's.
|
|
6. Feedback on operation with PDP-11 OS's.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Please send all patches, questions, feedback, clarifications, and help to:
|
|
dhittner AT northropgrumman DOT com
|
|
|
|
Thanks, and Enjoy!!
|
|
Dave
|