github.com/wfjm.w11
1
0
Fork 0
mirror of https://github.com/wfjm/w11.git synced 2026-03-28 19:12:17 +00:00
Code Issues Releases Wiki Activity

docu updates; add INSTALL_simh.md [skip ci]

Browse Source
This commit is contained in:
wfjm
2022-04-23 08:20:07 +02:00
parent 4001ddd695
commit 401807c3b4
21 changed files with 168 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
doc/ECO-026-div.md
View File

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

2
doc/ECO-028-ps_init.md
View File

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

29
doc/INSTALL_simh.md Normal file
View File

@@ -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`

29
doc/README_known_issues.md
View File

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

20
doc/w11a_os_guide.md
View File

@@ -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
### <a id="simh">simh simulator setup</a>
### <a id="simh">SimH simulator setup</a>
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.
### <a id="oskits-dec">DEC operating systems</a>
@@ -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 ( `<kit>.simh` )
- Feel free to explore them with the SimH simulator.
The boot scripts for SimH are included ( `<kit>.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.

2
tools/README.md
View File

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

12
tools/oskit/211bsd_rk/README.md
View File

@@ -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 <opt> @211bsd_rk_boot.tcl
where <opt> 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 `<ENTER>` in the `xterm` window to connnect to backend server.
The boot dialog in the console `xterm` window will look like

12
tools/oskit/211bsd_rl/README.md
View File

@@ -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 <opt> @211bsd_rl_boot.tcl
where <opt> 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 `<ENTER>` in the `xterm` window to connnect to backend server.
The boot dialog in the console `xterm` window will look like

2
tools/oskit/211bsd_rp/CHANGELOG.md
View File

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

12
tools/oskit/211bsd_rp/README.md
View File

@@ -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 <opt> @211bsd_rp_boot.tcl
where <opt> 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 `<ENTER>` in the `xterm` window to connect to backend server.
The boot dialog in the console `xterm` window will look like

7
tools/oskit/211bsd_rpeth/README.md
View File

@@ -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 <opt> @211bsd_rpeth_boot.tcl

12
tools/oskit/211bsd_rpmin/README.md
View File

@@ -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 <opt> @211bsd_rpmin_boot.tcl
where <opt> 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 `<ENTER>` in the `xterm` window to connnect to backend server.
System with as low as 512 kB memory can be used, like in example below.

7
tools/oskit/211bsd_tm/README.md
View File

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

11
tools/oskit/rsx11m-31_rk/README.md
View File

@@ -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 <opt> @rsx11m-31_rk_boot.tcl
```
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the `xterm` window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return:
```

11
tools/oskit/rsx11m-40_rk/README.md
View File

@@ -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 <opt> @rsx11m-40_rk_boot.tcl
```
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the `xterm` window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return:
```

12
tools/oskit/rsx11mp-30_rp/README.md
View File

@@ -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 <opt> @rsx11mp-30_rp_boot.tcl
```
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the `xterm` window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return:
```

11
tools/oskit/rt11-40_rk/README.md
View File

@@ -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 <opt> @rt11-40_rk_boot.tcl
```
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the xterm window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return:
```

11
tools/oskit/rt11-53_rl/README.md
View File

@@ -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 <opt> @rt11-53_rl_boot.tcl
```
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the `xterm` window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return:
```

7
tools/oskit/u5ed_rk/README.md
View File

@@ -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 <opt> @u5ed_rk_boot.tcl

7
tools/oskit/u7ed_rp/README.md
View File

@@ -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 <opt> @u7ed_rp_boot.tcl

11
tools/oskit/xxdp_rl/README.md
View File

@@ -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 <opt> @xxdp22_rl_boot.tcl
ti_w11 <opt> @xxdp25_rl_boot.tcl
@@ -46,7 +49,7 @@ Download, unpack and copy the disk images (*.dsk), e.g.
where `<opt>` is the proper option set for the board.
- Hit `<ENTER>` in the `xterm` window to connect to simh or backend server.
- Hit `<ENTER>` 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 `{<CR>}` denoting a carriage return.
```