2c2dd5ea33
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.
181 lines
8.3 KiB
Text
181 lines
8.3 KiB
Text
This file contains information about the XQ/SIM_ETHER package.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
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. This method is somewhat inefficient and will be looked at in
|
|
future versions. 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 hub(repeater) or a direct lan (thickwire/thinwire) segment.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Windows notes:
|
|
1. The Windows-specific code uses the WinPCAP 3.0 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. See the
|
|
WinPCAP documentation for a static load workaround if needed.
|
|
|
|
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.
|
|
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
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)
|
|
|
|
I have NOT tested the following, but have reports that the following work:
|
|
1. Operation with the PDP-11 emulator (RSX)
|
|
2. Remote booting of NetBSD (via >>> B XQA0)
|
|
|
|
I have tested the following, and they do NOT work correctly:
|
|
1. VMS NI Clustering (LAVC)
|
|
2. Remote VAX booting (>>>B XQA0) into a VMScluster;
|
|
the remote boot works, but VMS BUGCHECKs when joining the cluster
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Things planned for future releases:
|
|
1. Loopback packet processing
|
|
2. Full MOP implementation
|
|
3. Identity broadcast, which should occur every 8-10 minutes
|
|
4. Full support for network boot (>> B XQA0)
|
|
5. VMS NI Cluster (LAVC) support
|
|
6. More efficient Sim_Ether module implementation for windows
|
|
7. PDP-11 bootstrap
|
|
8. DESQA support (if someone can get me the user manuals)
|
|
9. 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 the ethernet timing clock interval.
|
|
6. Feedback on operation with other VAX OS's.
|
|
7. Feedback on operation of PDP-11 OS's.
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Please send all patches, questions, feedback, clarifications, and help to:
|
|
dhittner AT northropgrumman DOT com
|
|
|
|
NOTE: I _have_ corrected my email address!! Sorry about the confusion!
|
|
|
|
Thanks, and Enjoy!!
|
|
Dave
|