diff --git a/doc/ECO-026-div.md b/doc/ECO-026-div.md index 32af6972..043ee56f 100644 --- a/doc/ECO-026-div.md +++ b/doc/ECO-026-div.md @@ -87,7 +87,7 @@ algorithms need special rules and checks for this. - the J11 never updates registers in case of overflow. A case like 0,177777 / 177777 were w11a now updates regs is known from J11 diagnostics to not update in J11. -- simh always preserves the destination registers in case of overflow. +- SimH always preserves the destination registers in case of overflow. **The pdp11 processor handbook considers the destination registers as** **undefined in case of division overflow, so the w11a behavior is OK.** @@ -101,7 +101,7 @@ algorithms need special rules and checks for this. but in cases different from w11a 11/44 --> regs updated under some conditions J11 --> regs never updated - simh --> regs never updated + SimH --> regs never updated ``` - that can lead to spurious failures in original DEC diagnostics when they test the complete response diff --git a/doc/ECO-028-ps_init.md b/doc/ECO-028-ps_init.md index e64a01c0..9cc44bc4 100644 --- a/doc/ECO-028-ps_init.md +++ b/doc/ECO-028-ps_init.md @@ -17,7 +17,7 @@ See the full story in the exhaustive commit message for [simh commit f0d41f1](https://github.com/simh/simh/commit/f0d41f15d792b9abc31e8530ee275453c7440a8c). ### Fixes -`PS` now initialized with `000000` to stay in line with the real 11/70 and simh. +`PS` now initialized with `000000` to stay in line with the real 11/70 and SimH. ### Side effects Hopefully none. All `ibus` devices come up with interrupts disabled, so there diff --git a/doc/INSTALL_simh.md b/doc/INSTALL_simh.md new file mode 100644 index 00000000..c1a8501b --- /dev/null +++ b/doc/INSTALL_simh.md @@ -0,0 +1,29 @@ +# Installation of the SimH pdp11 simulator + +The w11 project uses the pdp11 simulator from the +[SimH](https://en.wikipedia.org/wiki/SIMH) project. The project was started +by Bob Supnik under [simh.trailing-edge.com](http://simh.trailing-edge.com). +This site contains the "classic" version of SimH, the 3.X stream, with v3.11-1 +as the last release. Since about 2014 the project is continued by a team led by +Mark Pizzolato as GitHub project [simh/simh](https://github.com/simh/simh). +The new, functionally much enhanced, version is called V4.*. However, the +team decided not to provide releases anymore, just a stream of commits, +more than 4200 as of April 2022. + +Debian and Ubuntu offer `simh` packages, but with the obsolete version V3.8.1, +released in February 2009. The main obstacle to the inclusion of newer +versions is, according to the Debian maintainer, the unclear license situation. + +The only practical way to obtain the pdp11 simulator is by installation from +sources. The GitHub repository contains also the classical versions, nicely +marked with tags. + +The `scmd` scripts provided in the w11 project were originally developed for +SimH 3.8, and worked for SimH 3.9 and later releases. The SimH 4.* development +over time became incompatible with the `scmd` scripts used for w11 verification. +See issue [#30](https://github.com/wfjm/w11/issues/30) for details. + +The bottom line at the moment: +- install SimH from [simh/simh](https://github.com/simh/simh) +- checkout `v3.11-1` + diff --git a/doc/README_known_issues.md b/doc/README_known_issues.md index 55597070..dede0af9 100644 --- a/doc/README_known_issues.md +++ b/doc/README_known_issues.md @@ -2,6 +2,33 @@ The case id indicates the release when the issue was first recognized. +### V0.79 {[issue #30](https://github.com/wfjm/w11/issues/30)} -- SimH scmd files fail on current 4.* version; only 3.* supported + +The SimH scmd scripts were originally developed for SimH 3.8, and worked for +SimH 3.9 and later releases. The SimH 4.* development team decided not to +provide releases anymore, and over time this version became incompatible with +the scmd scripts used for w11. That is most pronounced for the RT11 V4.3 oskit. +A simple +``` + cd $RETROBASE/tools/oskit/rt11-53_rl + console_starter -s -d DL0 & + pdp11 rt11-53_rl_boot.scmd +``` +works fine for SimH V3.9, V3.10 and V3.11-1, but fails +- for pdp11-4.0-beta1 with core dump +- for pdp11-2016-12-26-5ced037b with signal SIGSEGV in pdp11_xu +- for pdp11-2019-07-28-2f707ffc with signal SIGSEGV in pdp11_xu +- for pdp11-2020-03-26-261abfc3 with signal SIGSEGV in pdp11_xu +- for pdp11-2021-08-22-64b12234 with signal SIGSEGV in pdp11_xu +- for pdp11-2022-04-17-d3f1ee09 with with errors like + - Device auto configuration is now disabled + - Command not allowed (for set rha enabled) + - container incompatible with the RL device + +Bottom line: +- the provided scmd scripts work only with SimH V3.9, V3.10 or V3.11-1 +- an update to the SimH V4.* has low priority + ### V0.79 {[issue #29](https://github.com/wfjm/w11/issues/29)} -- migrate from Travis to GitHub actions Travis is now defunct and has been removed in [6b8c063](https://github.com/wfjm/w11/commit/6b8c063). @@ -13,7 +40,7 @@ Some simple RK11 drivers, especially in test codes, don't poll for completion of a write protect command. Due to the emulated I/O this can cause errors. One example is the boot sequence of RK based XXDP, as seen for example for -the `dzzza` disk. On simh the disk is immediately switched to write protect +the `dzzza` disk. On SimH the disk is immediately switched to write protect mode, on w11 it is not. The pertinent part of the code is ``` 000214 B003: mov #000017,@#rk.cs ; #rk.fwl+rk.go; func=write_lock diff --git a/doc/w11a_os_guide.md b/doc/w11a_os_guide.md index a854448a..d5f40d80 100644 --- a/doc/w11a_os_guide.md +++ b/doc/w11a_os_guide.md @@ -5,7 +5,7 @@ - [I/O emulation setup](#user-content-io-emu) - [FPGA Board setup](#user-content-fpga-setup) - [Rlink and Backend Server setup](#user-content-rlink) -- [simh simulator setup](#user-content-simh) +- [SimH simulator setup](#user-content-simh) - [oskits](#user-content-oskits) - [Unix systems](#user-content-oskits-unix) - [DEC operating systems](#user-content-oskits-dec) @@ -195,13 +195,14 @@ All examples below use the same basic setup 0 -> DISPREG 1 -> DR emulation -### simh simulator setup +### SimH simulator setup Sometimes it is good to compare the w11a behavior with the PDP-11 software -emulator from the simh project (see https://github.com/simh/simh). +emulator from the SimH project. See [INSTALL_simh](INSTALL_simh.md) for +installation instructions and supported versions. Under `$RETROBASE/tools/simh` two setup files are provided which configure -simh to reflect the w11a setup as close as possible: +SimH to reflect the w11a setup as close as possible: - `setup_w11a_min.scmd` Very close to the current w11a state when it runs on an s3board - processor: 11/70, no FPP, 1 Mbyte @@ -222,7 +223,7 @@ All examples below use the same basic setup console_starter -s -d DL0 & console_starter -s -d DL1 & - **Note**: the -s ensures that the port numbers used by simh are taken! + **Note**: the -s ensures that the port numbers used by SimH are taken! - start the simulator @@ -262,7 +263,8 @@ Several oskits are provided: | [211bsd_rpmin](../tools/oskit/211bsd_rpmin) | 2.11BSD system | RP06 | _full system; tuned for small memory (min 512 kB, better 640 kB)_ | | [211bsd_rpeth](../tools/oskit/211bsd_rpeth) | 2.11BSD system | RP06 | _full system; with DEUNA Ethernet_ | -For further details consult the `README.md` file in the oskit directory. +For further details consult the [README.md](../tools/oskit/README.md) file +in the oskit directory. ### DEC operating systems @@ -277,7 +279,7 @@ to cover some older versions of DEC operating systems, for example - RSX-11M PLUS V3.0 or prior on a simulator. It is commonly assumed that the license terms cover the -usage of the PDP11 simulator from the 'simh' suite. Usage of the e11 +usage of the PDP11 simulator from the 'SimH' suite. Usage of the e11 simulator is not covered according to the author of e11. > **THIS LICENSE DOES NOT COVER THE USAGE OF THESE HISTORIC DEC** @@ -287,8 +289,8 @@ simulator is not covered according to the author of e11. Some oskits are provided with systems sysgen'ed to run on a configuration like the w11a. -- Feel free to explore them with the simh simulator. - The boot scripts for simh are included ( `.simh` ) +- Feel free to explore them with the SimH simulator. + The boot scripts for SimH are included ( `.simh` ) - In case you happen to have a valid license feel free to try them out the w11a and let the author know whether is works as it should. diff --git a/tools/README.md b/tools/README.md index ddb0a987..8fe9b438 100644 --- a/tools/README.md +++ b/tools/README.md @@ -12,7 +12,7 @@ This directory tree contains **many tools** and is organized in | [man](man) | man pages | | [mcode](mcode) | miscellaneous codes | | [oskit](oskit) | support files for OS disk/tape image kits | -| [simh](simh) | configuration files for `simh pdp11` | +| [simh](simh) | configuration files for `SimH pdp11` | | [src](src) | C++ sources for rlink backend | | [sys](sys) | udev rules for USB device handling | | [tbench](tbench) | w11 test bench | diff --git a/tools/oskit/211bsd_rk/README.md b/tools/oskit/211bsd_rk/README.md index 82a798d6..ecc14c97 100644 --- a/tools/oskit/211bsd_rk/README.md +++ b/tools/oskit/211bsd_rk/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms For history see [CHANGELOG.md](CHANGELOG.md). @@ -28,13 +29,18 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_rk_boot.tcl example: ti_w11 @211bsd_rk_boot.tcl where is the proper option set for the board. ``` + or use for verification the SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) + ``` + pdp11 211bsd_rk_boot.scmd + ``` - Hit `` in the `xterm` window to connnect to backend server. The boot dialog in the console `xterm` window will look like diff --git a/tools/oskit/211bsd_rl/README.md b/tools/oskit/211bsd_rl/README.md index 788a0e9e..ded55ddc 100644 --- a/tools/oskit/211bsd_rl/README.md +++ b/tools/oskit/211bsd_rl/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms For history see [CHANGELOG.md](CHANGELOG.md). @@ -28,13 +29,18 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_rl_boot.tcl example: ti_w11 @211bsd_rl_boot.tcl where is the proper option set for the board. ``` + or use for verification the SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) + ``` + pdp11 211bsd_rl_boot.scmd + ``` - Hit `` in the `xterm` window to connnect to backend server. The boot dialog in the console `xterm` window will look like diff --git a/tools/oskit/211bsd_rp/CHANGELOG.md b/tools/oskit/211bsd_rp/CHANGELOG.md index f97eb76d..6e122784 100644 --- a/tools/oskit/211bsd_rp/CHANGELOG.md +++ b/tools/oskit/211bsd_rp/CHANGELOG.md @@ -88,7 +88,7 @@ Setup 211bsd system from tape distribution kit obtained from [TUHS](https://www.tuhs.org/). - get tape distribution kit from [UnixArchive/Distributions/UCB/2.11BSD](https://www.tuhs.org/Archive/Distributions/UCB/2.11BSD/) - get patches from [UnixArchive/Distributions/UCB/2.11BSD/Patches](https://www.tuhs.org/Archive/Distributions/UCB/2.11BSD/Patches/) -- setup initial system using `simh` +- setup initial system using `SimH` - load tape distribution kit (is version 431) - install all patches: 432,...,444 - `FPSIM` didn't work. Fixed with [patch #445](https://wfjm.github.io/blogs/211bsd/2007-01-03-patch-445.html). diff --git a/tools/oskit/211bsd_rp/README.md b/tools/oskit/211bsd_rp/README.md index 8baa4834..82dd3f7f 100644 --- a/tools/oskit/211bsd_rp/README.md +++ b/tools/oskit/211bsd_rp/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms For history see [CHANGELOG.md](CHANGELOG.md). @@ -32,13 +33,18 @@ and [211bsd_rpmin](../211bsd_rpmin/README.md) for a minimal memory system. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_rp_boot.tcl example: ti_w11 @211bsd_rp_boot.tcl where is the proper option set for the board. ``` + or use for verification the SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) + ``` + pdp11 211bsd_rp_boot.scmd + ``` - Hit `` in the `xterm` window to connect to backend server. The boot dialog in the console `xterm` window will look like diff --git a/tools/oskit/211bsd_rpeth/README.md b/tools/oskit/211bsd_rpeth/README.md index 755990d1..be07a49b 100644 --- a/tools/oskit/211bsd_rpeth/README.md +++ b/tools/oskit/211bsd_rpeth/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms ### System properties and intended usage This system is build with Ethernet based networking via a DEUNA network @@ -32,8 +33,8 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage - Setup Ethernet environment, see [211bsd_ethernet.md](../doc/211bsd_ethernet.md) -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_rpeth_boot.tcl example: ti_w11 @211bsd_rpeth_boot.tcl diff --git a/tools/oskit/211bsd_rpmin/README.md b/tools/oskit/211bsd_rpmin/README.md index 6e478adf..35397c62 100644 --- a/tools/oskit/211bsd_rpmin/README.md +++ b/tools/oskit/211bsd_rpmin/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms ### System properties and intended usage This system is created for usage on systems with limited memory. The @@ -35,13 +36,18 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_rpmin_boot.tcl example: ti_w11 @211bsd_rpmin_boot.tcl where is the proper option set for the board. ``` + or use for verification the SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) + ``` + pdp11 211bsd_rpmin_boot.scmd + ``` - Hit `` in the `xterm` window to connnect to backend server. System with as low as 512 kB memory can be used, like in example below. diff --git a/tools/oskit/211bsd_tm/README.md b/tools/oskit/211bsd_tm/README.md index 429d2712..2162c1e6 100644 --- a/tools/oskit/211bsd_tm/README.md +++ b/tools/oskit/211bsd_tm/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms ### Installation @@ -32,8 +33,8 @@ Download, unpack and copy the tape images (*.tap), e.g. create_disk --typ=rm05 --bad 211bsd_rm05.dsk ``` -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: 211bsd_tm_rp06_boot.tcl or 211bsd_tm_rm05_boot.tcl diff --git a/tools/oskit/rsx11m-31_rk/README.md b/tools/oskit/rsx11m-31_rk/README.md index 1ef72aef..5b448c9c 100644 --- a/tools/oskit/rsx11m-31_rk/README.md +++ b/tools/oskit/rsx11m-31_rk/README.md @@ -6,7 +6,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read README_license.txt which is included in the oskit !!** @@ -22,19 +23,21 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk imge in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) ``` pdp11 rsx11m-31_rk_boot.scmd ``` - or **ONLY IF YOU HAVE A VALID LICENSE** on w11a + or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @rsx11m-31_rk_boot.tcl ``` where `` is the proper option set for the board. -- Hit `` in the `xterm` window to connect to simh or backend server. +- Hit `` in the `xterm` window to connect to SimH or backend server. The boot dialog in the console `xterm` window will look like (required input is in `{..}`, with `{}` denoting a carriage return: ``` diff --git a/tools/oskit/rsx11m-40_rk/README.md b/tools/oskit/rsx11m-40_rk/README.md index 08188ebe..8196d65d 100644 --- a/tools/oskit/rsx11m-40_rk/README.md +++ b/tools/oskit/rsx11m-40_rk/README.md @@ -4,7 +4,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read README_license.txt which is included in the oskit !!** @@ -20,19 +21,21 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk image in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) ``` pdp11 rsx11m-40_rk_boot.scmd ``` - or **ONLY IF YOU HAVE A VALID LICENSE** on w11a + or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @rsx11m-40_rk_boot.tcl ``` where `` is the proper option set for the board. -- Hit `` in the `xterm` window to connect to simh or backend server. +- Hit `` in the `xterm` window to connect to SimH or backend server. The boot dialog in the console `xterm` window will look like (required input is in `{..}`, with `{}` denoting a carriage return: ``` diff --git a/tools/oskit/rsx11mp-30_rp/README.md b/tools/oskit/rsx11mp-30_rp/README.md index a732da53..0bdd644c 100644 --- a/tools/oskit/rsx11mp-30_rp/README.md +++ b/tools/oskit/rsx11mp-30_rp/README.md @@ -6,7 +6,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read README_license.txt which is included in the oskit !!** @@ -22,19 +23,22 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk image in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) + ``` pdp11 rsx11mp-30_rp_boot.scmd ``` - or **ONLY IF YOU HAVE A VALID LICENSE** on w11a + or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @rsx11mp-30_rp_boot.tcl ``` where `` is the proper option set for the board. -- Hit `` in the `xterm` window to connect to simh or backend server. +- Hit `` in the `xterm` window to connect to SimH or backend server. The boot dialog in the console xterm window will look like (required input is in `{..}`, with `{}` denoting a carriage return: ``` diff --git a/tools/oskit/rt11-40_rk/README.md b/tools/oskit/rt11-40_rk/README.md index 4c7be00c..fae2c746 100644 --- a/tools/oskit/rt11-40_rk/README.md +++ b/tools/oskit/rt11-40_rk/README.md @@ -6,7 +6,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read README_license.txt which is included in the oskit !!** @@ -22,19 +23,21 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk image in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) ``` pdp11 rt11-40_rk_boot.scmd ``` - or **ONLY IF YOU HAVE A VALID LICENSE** on w11a + or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @rt11-40_rk_boot.tcl ``` where `` is the proper option set for the board. -- Hit `` in the xterm window to connect to simh or backend server. +- Hit `` in the xterm window to connect to SimH or backend server. The boot dialog in the console `xterm` window will look like (required input is in `{..}`, with `{}` denoting a carriage return: ``` diff --git a/tools/oskit/rt11-53_rl/README.md b/tools/oskit/rt11-53_rl/README.md index d2825588..72d1664d 100644 --- a/tools/oskit/rt11-53_rl/README.md +++ b/tools/oskit/rt11-53_rl/README.md @@ -6,7 +6,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read README_license.txt which is included in the oskit !!** @@ -22,19 +23,21 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk image in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) ``` pdp11 rt11-53_rl_boot.scmd ``` - or **ONLY IF YOU HAVE A VALID LICENSE** on w11a + or **ONLY IF YOU HAVE A VALID LICENSE** on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @rt11-53_rl_boot.tcl ``` where `` is the proper option set for the board. -- Hit `` in the `xterm` window to connect to simh or backend server. +- Hit `` in the `xterm` window to connect to SimH or backend server. The boot dialog in the console `xterm` window will look like (required input is in `{..}`, with `{}` denoting a carriage return: ``` diff --git a/tools/oskit/u5ed_rk/README.md b/tools/oskit/u5ed_rk/README.md index 05182991..82e8bb56 100644 --- a/tools/oskit/u5ed_rk/README.md +++ b/tools/oskit/u5ed_rk/README.md @@ -5,7 +5,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms ### Installation A disk set is available from @@ -20,8 +21,8 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: uv5_rk_boot.tcl example: ti_w11 @u5ed_rk_boot.tcl diff --git a/tools/oskit/u7ed_rp/README.md b/tools/oskit/u7ed_rp/README.md index 09dba0c1..3bfc4fe8 100644 --- a/tools/oskit/u7ed_rp/README.md +++ b/tools/oskit/u7ed_rp/README.md @@ -23,7 +23,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms ### Installation A disk set is available from @@ -38,8 +39,8 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start backend server and boot system - (see section Rlink in [w11a_os_guide.md](../../../doc/w11a_os_guide.md)) +- Start backend server and boot system (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` boot script: u7ed_rp_boot.tcl example: ti_w11 @u7ed_rp_boot.tcl diff --git a/tools/oskit/xxdp_rl/README.md b/tools/oskit/xxdp_rl/README.md index 225d839c..422b22c8 100644 --- a/tools/oskit/xxdp_rl/README.md +++ b/tools/oskit/xxdp_rl/README.md @@ -6,7 +6,8 @@ See notes in [w11a_os_guide.md](../../../doc/w11a_os_guide.md) on 1. I/O emulation setup 2. FPGA Board setup 3. Rlink and Backend Server setup - 4. Legal terms + 4. SimH simulator setup + 5. Legal terms **Also read [README_license.md](README_license.md) !!** @@ -32,13 +33,15 @@ Download, unpack and copy the disk images (*.dsk), e.g. ### Usage -- Start disk in simulator +- Start disk imge in SimH simulator (see section SimH in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-simh)) ``` pdp11 xxdp22_rl_boot.scmd pdp11 xxdp25_rl_boot.scmd ``` - or on w11a + or on w11a (see section Rlink in + [w11a_os_guide](../../../doc/w11a_os_guide.md#user-content-rlink)) ``` ti_w11 @xxdp22_rl_boot.tcl ti_w11 @xxdp25_rl_boot.tcl @@ -46,7 +49,7 @@ Download, unpack and copy the disk images (*.dsk), e.g. where `` is the proper option set for the board. -- Hit `` in the `xterm` window to connect to simh or backend server. +- Hit `` in the `xterm` window to connect to SimH or backend server. The boot dialog in the console `xterm` window will look like (required input is in `{..}`, with `{}` denoting a carriage return. ```