- added support for Vivado

- added support for Nexys4 and Basys3 boards
- added RL11 disk support
- lots of documentation updated

tools/oskit/211bsd_rl/.cvsignore

@@ -0,0 +1,5 @@
+*.dat
+*.dsk
+*.log
+*license.txt
+*license.pdf

tools/oskit/211bsd_rl/211bsd_rl_boot.scmd

@@ -0,0 +1,16 @@
+; $Id: 211bsd_rl_boot.scmd 633 2015-01-11 22:58:48Z mueller $
+;
+; Setup file for 211bsd RL02 based system
+;
+; Usage:
+;
+; pdp11 211bsd_rl_boot.scmd
+;
+do ../../simh/setup_w11a_max.scmd
+set tto 7b
+set dlo0 7b
+;
+att rl0 211bsd_rl_root.dsk
+att rl1 211bsd_rl_usr.dsk
+;
+boo rl0

tools/oskit/211bsd_rl/211bsd_rl_boot.tcl

@@ -0,0 +1,26 @@
+# $Id: 211bsd_rl_boot.tcl 633 2015-01-11 22:58:48Z mueller $
+#
+# Setup file for 211bsd RL02 based system
+#
+# Usage:
+#   
+# console_starter -d DL0 &
+# console_starter -d DL1 &
+# ti_w11 -xxx @211bsd_rl_boot.tcl        ( -xxx depends on sim or fpga connect)
+#
+
+# setup w11 cpu
+puts [rlw]
+
+# setup tt,lp (211bsd uses parity -> use 7 bit mode)
+rw11::setup_tt "cpu0" {to7bit 1}
+rw11::setup_lp 
+
+# mount disks
+cpu0rla0 att 211bsd_rl_root.dsk
+cpu0rla1 att 211bsd_rl_usr.dsk
+
+# and boot
+rw11::cpumon
+rw11::cpucons
+cpu0 boot rla0

tools/oskit/211bsd_rl/README_211bsd_rlset.txt

@@ -0,0 +1,125 @@
+# $Id: README_211bsd_rlset.txt 633 2015-01-11 22:58:48Z mueller $
+
+Notes on oskit: 2.11BSD system on RL02 volumes
+
+  Table of content:
+
+    1.  General remarks
+    2.  Installation
+    3.  Usage
+
+1. General remarks ---------------------------------------------------
+
+   See notes on
+
+     1.  I/O emulation setup
+     2.  FPGA Board setup
+     3.  Rlink and Backend Server setup
+     4.  Legal terms
+
+   in $RETROBASE/doc/w11a_os_guide.txt
+
+2. Installation ------------------------------------------------------
+
+   - A disk set is available from
+       http://www.retro11.de/data/oc_w11/oskits/211bsd_rlset.tgz
+     Download, unpack and copy the disk images (*.dsk), e.g.
+
+       cd $RETROBASE/tools/oskit/211bsd_rl/
+       wget http://www.retro11.de/data/oc_w11/oskits/211bsd_rlset.tgz
+       tar -xzf 211bsd_rlset.tgz
+
+3. Usage -------------------------------------------------------------
+
+   - Start backend server and boot system (see section 3 in w11a_os_guide.txt)
+       boot script:  211bsd_rl_boot.tcl
+       example:      ti_w11 -u @211bsd_rl_boot.tcl
+
+   - Hit <ENTER> in the xterm window to connnect to backend server.
+     The boot dialog in the console xterm window will look like
+     (required input is in {..}, with {<CR>} denoting a carriage return:
+
+       70Boot from rl(0,0,0) at 0174400
+       : {<CR>}
+       : rl(0,0,0)unix
+       Boot: bootdev=03400 bootcsr=0174400
+
+       2.11 BSD UNIX #1: Thu Jan 1 22:05:02 PST 2009
+           root@curly.2bsd.com:/usr/src/sys/RETRONFPRL
+
+       phys mem  = 3932160
+       avail mem = 3577344
+       user mem  = 307200
+
+       January  1 22:44:48 init: configure system
+
+       dz ? csr 160100 vector 310 skipped:  No CSR.
+       lp 0 csr 177514 vector 200 attached
+       rk ? csr 177400 vector 220 didn't interrupt.
+       rl 0 csr 174400 vector 160 attached
+       tm ? csr 172520 vector 224 skipped:  No CSR.
+       xp ? csr 176700 vector 254 skipped:  No CSR.
+       cn 1 csr 176500 vector 300 attached
+       erase, kill ^U, intr ^C
+
+     In first '#' prompt the system is in single-user mode. Just enter a ^D 
+     to continue the system startup to multi-user mode:
+
+       #^D
+      
+       Fast boot ... skipping disk checks
+       checking quotas: done.
+       Assuming non-networking system ...
+       preserving editor files
+       clearing /tmp
+       standard daemons: update cron accounting.
+       January  1 22:46:13 acctd[51]: open(/usr/adm/acct,O_WRONLY|O_APPEND): 2
+       starting lpd
+       starting local daemons:Thu Jan  1 22:46:13 PST 2009
+       January  1 22:46:13 init: kernel security level changed from 0 to 1
+       January  1 22:46:15 getty: /dev/tty01: Device not configured
+       January  1 22:46:15 getty: /dev/tty00: Device not configured
+       January  1 22:46:15 getty: /dev/tty02: Device not configured
+       January  1 22:46:15 getty: /dev/tty03: Device not configured
+
+       2.11 BSD UNIX (curly.2bsd.com) (console)
+       
+       login: 
+
+     The login prompt is sometimes mangled with the 'Device not configured'
+     system messages, if its not visible just hit <ENTER> to get a fresh one.
+
+       login: {root}
+       erase, kill ^U, intr ^C
+
+     Now the system is in multi-user mode, daemons runnng. You can explore
+     the system, e.g. with a 'pstat -T' or a 'mount' command. The second
+     xterm can be activated too, it will connect to a second emulated DL11.
+     At the end is important to shutdown properly with a 'halt':
+
+       # {pstat -T}
+         7/186 files
+        40/208 inodes
+        11/150 processes
+         6/ 46 texts active,  31 used
+         2/135 swapmap entries,  420 kB used, 2139 kB free, 2133 kB max
+        34/150 coremap entries, 2906 kB free, 2818 kB max
+         1/ 10  ub_map entries,   10    free,   10    max
+       # {mount}
+       /dev/rl0a on /
+       /dev/rl1h on /usr
+       # {halt}
+       syncing disks... done
+       halting
+
+     While the system was running the server process display the
+       cpumon> 
+     prompt. When the w11 has halted after 211bsd shutdown a message like
+
+       CPU down attention
+       Processor registers and status:
+         PS: 030350 cm,pm=k,u s,p,t=0,7,0 NZVC=1000  rust: 01 HALTed
+         R0: 177560  R1: 161322  R2: 053770  R3: 000010
+         R4: 003400  R5: 147510  SP: 147466  PC: 000014
+ 
+     will be visible. Now the server process can be stopped with ^D.

tools/oskit/rt11-53_rl/.cvsignore

@@ -0,0 +1,4 @@
+*.dat
+*.dsk
+*.log
+*license.txt

tools/oskit/rt11-53_rl/README_rt11-53_rlset.txt

@@ -0,0 +1,70 @@
+# $Id:  $
+
+Notes on oskit: RT-11 V5.3 system on a RL02 volume
+
+  Table of content:
+
+    1.  General remarks
+    2.  Installation
+    3.  Usage
+
+1. General remarks ---------------------------------------------------
+
+   See notes, especially on legal terms, in $RETROBASE/doc/w11a_os_guide.txt
+
+   Also read README_license.txt which is included in the oskit !!
+
+2. Installation ------------------------------------------------------
+
+   - A disk set is available from
+       http://www.retro11.de/data/oc_w11/oskits/rt11-53_rlset.tgz
+     Download, unpack and copy the disk images (*.dsk), e.g.
+
+       cd $RETROBASE/tools/oskit/rt11-53_rl
+       wget http://www.retro11.de/data/oc_w11/oskits/rt11-53_rlset.tgz
+       tar -xzf rt11-53_rlset.tgz
+
+3. Usage -------------------------------------------------------------
+
+   - Start them in simulator
+       pdp11 rt11-53_rl_boot.scmd
+     or ONLY IF YOU HAVE A VALID LICENSE on w11a
+       ti_w11 -u @rt11-53_rl_boot.tcl
+
+   - 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:
+
+    RT-11FB  V05.03  
+
+    .TYPE V5USER.TXT
+
+                                  RT-11 V5.3
+
+           Installation of RT-11 Version 5.3 is complete and you are now
+        executing from the working volume    (provided you have used the
+        automatic installation procedure). DIGITAL recommends you verify
+        the correct  operation  of  your  system's  software  using  the
+        verification procedure.  To do this, enter the command:
+
+                                 IND VERIFY
+
+            Note that VERIFY should be performed  only after the distri-
+        bution media have been backed up.  This was accomplished as part
+        of automatic installation on  all  RL02,  RX02,  TK50, and  RX50
+        based systems,   including the  MicroPDP-11 and the Professional
+        300.  If you have not completed automatic installation, you must
+        perform a manual backup before using VERIFY.  Note also,  VERIFY
+        is NOT supported on RX01 diskettes,    DECtape I or II,   or the
+        Professional 325.
+
+        DIGITAL also  recommends  you  read  the  file V5NOTE.TXT, which
+        contains information  formalized too late to be included  in the
+        Release Notes.  V5NOTE.TXT can be TYPED or PRINTED.
+       
+        .
+
+     Now you are at the RT-11 prompt and can exercise the system.
+
+     There is no 'halt' or 'shutdown' command, just terminate the 
+     simulator or backend server session.

tools/oskit/rt11-53_rl/rt11-53_rl_boot.scmd

@@ -0,0 +1,16 @@
+; $ Id:  $
+;
+; Setup file for RT-11 V5.3 RL02 based system
+;
+; Usage:
+;
+; pdp11 rt11-53_rl_boot.scmd
+;
+do ../../simh/setup_w11a_max.scmd
+;
+att rl0 RT11_V5.3_SYSTEM.dsk
+;
+set rl debug
+set cons debug=rlboot_simh.log
+;
+boo rl0

tools/oskit/rt11-53_rl/rt11-53_rl_boot.tcl

@@ -0,0 +1,25 @@
+# $ Id:  $
+#
+# Setup file for RT-11 V5.3 RL02 based system
+#
+# Usage:
+#   
+# console_starter -d DL0 &
+# ti_w11 -xxx @rt11-53_rl_boot.tcl     ( -xxx depends on sim or fpga connect)
+#
+
+# setup w11 cpu
+puts [rlw]
+
+# setup tt,lp,pp (single console; enable rx rate limiter on old DEC OS)
+rw11::setup_tt "cpu0" {ndl 1 dlrlim 5}
+rw11::setup_lp 
+rw11::setup_pp
+
+# mount disks
+cpu0rla0 att RT11_V5.3_SYSTEM.dsk
+
+# and boot
+rw11::cpumon
+rw11::cpucons
+cpu0 boot rla0

tools/oskit/xxdp_rl/.cvsignore

@@ -0,0 +1,4 @@
+*.gz
+*.dat
+*.dsk
+*.log

tools/oskit/xxdp_rl/README_license.txt

@@ -0,0 +1,9 @@
+Unlike most other PDP-11 software xxdp was not sold to Mentec.
+By now, ownership of xxdp software is in the hands of HP.
+
+PDP-11 customers were not required to sign a license agreement for xxdp,
+the software was provided with the system or brought to the customer site 
+by a Field Service representative.
+
+Bottom line is that there is certainly a copyright on the xxdp software,
+but as it seems not a license.

tools/oskit/xxdp_rl/README_xxdp_rlset.txt

@@ -0,0 +1,85 @@
+# $Id: README_xxdp_rlset.txt 652 2015-02-28 12:18:08Z mueller $
+
+Notes on oskit: XXDP V2.2 and V2.5 system on RL02 volumes
+
+  Table of content:
+
+    1.  General remarks
+    2.  Installation
+    3.  Usage
+
+1. General remarks ---------------------------------------------------
+
+   See notes, especially on legal terms, in README_license.txt !!
+
+2. Installation ------------------------------------------------------
+
+   - A disk images for XXDP V2.2 and V2.5 are available from bitsavers
+       http://bitsavers.trailing-edge.com/bits/DEC/pdp11/discimages/rl02
+         xxdp22.rl02.gz
+         xxdp25.rl02.gz
+     Download, unpack and copy the disk images (*.dsk), e.g.
+
+       cd $RETROBASE/tools/oskit/xxdp_rl
+
+       disk_path=http://bitsavers.trailing-edge.com/bits/DEC/pdp11/discimages
+       wget $disk_path/rl02/xxdp22.rl02.gz
+       wget $disk_path/rl02/xxdp25.rl02.gz
+
+       gunzip -c xxdp22.rl02.gz > xxdp22.dsk
+       gunzip -c xxdp25.rl02.gz > xxdp25.dsk
+
+3. Usage -------------------------------------------------------------
+
+   - Start them in simulator
+       pdp11 xxdp22_rl_boot.scmd
+       pdp11 xxdp25_rl_boot.scmd
+
+     or on w11a
+       ti_w11 <opt> @xxdp22_rl_boot.tcl
+       ti_w11 <opt> @xxdp25_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.
+     The boot dialog in the console xterm window will look like
+     (required input is in {..}, with {<CR>} denoting a carriage return.
+
+     XXDP V2.2 boot dialog:
+
+       CHMDLD0 XXDP+ DL MONITOR
+       BOOTED VIA UNIT 0
+       28K UNIBUS SYSTEM
+
+       ENTER DATE (DD-MMM-YY): {10-jan-85}
+
+       RESTART ADDR: 152010
+       THIS IS XXDP+.  TYPE "H" OR "H/L" FOR HELP.
+
+       .
+
+     XXDP V2.5 boot dialog:
+
+       BOOTING UP XXDP-XM EXTENDED MONITOR
+
+       XXDP-XM EXTENDED MONITOR - XXDP V2.5
+       REVISION: F0
+       BOOTED FROM DL0
+       124KW OF MEMORY
+       UNIBUS SYSTEM
+
+       RESTART ADDRESS: 152000
+       TYPE "H" FOR HELP !
+
+       .
+
+     Now you are at the XXDP prompt '.' and can exercise the system:
+     
+       . {H}
+         --> will print help
+       . {D}
+         --> will list the files
+       . {R EKBAD0}
+         --> will run the 'PDP 11/70 cpu diagnostic part 1'
+
+     There is no 'halt' or 'shutdown' command, just terminate the 
+     simulator or backend server session.

tools/oskit/xxdp_rl/xxdp22_rl_boot.scmd

@@ -0,0 +1,13 @@
+; $Id: xxdp22_rl_boot.scmd 633 2015-01-11 22:58:48Z mueller $
+;
+; Setup file for XXDP V2.2 RL02 based system
+;
+; Usage:
+;
+; pdp11 xxdp22_rl_boot.scmd
+;
+do ../../simh/setup_w11a_max.scmd
+;
+att rl0 xxdp22.dsk
+;
+boo rl0

tools/oskit/xxdp_rl/xxdp22_rl_boot.tcl

@@ -0,0 +1,25 @@
+# $Id: xxdp22_rl_boot.tcl 654 2015-03-01 18:45:38Z mueller $
+#
+# Setup file for XXDP V2.2 RL02 based system
+#
+# Usage:
+#   
+# console_starter -d DL0 &
+# ti_w11 -xxx @xxdp22_rl_boot.tcl     ( -xxx depends on sim or fpga connect)
+#
+
+# setup w11 cpu
+puts [rlw]
+
+# setup tt,lp,pp (single console; enable rx rate limiter on old DEC OS)
+rw11::setup_tt "cpu0" {ndl 1 dlrlim 5 to7bit 1}
+rw11::setup_lp 
+rw11::setup_pp
+
+# mount disks
+cpu0rla0 att xxdp22.dsk
+
+# and boot
+rw11::cpumon
+rw11::cpucons
+cpu0 boot rla0

tools/oskit/xxdp_rl/xxdp25_rl_boot.scmd

@@ -0,0 +1,13 @@
+; $Id: xxdp25_rl_boot.scmd 633 2015-01-11 22:58:48Z mueller $
+;
+; Setup file for XXDP V2.5 RL02 based system
+;
+; Usage:
+;
+; pdp11 xxdp25_rl_boot.scmd
+;
+do ../../simh/setup_w11a_max.scmd
+;
+att rl0 xxdp25.dsk
+;
+boo rl0

tools/oskit/xxdp_rl/xxdp25_rl_boot.tcl

@@ -0,0 +1,25 @@
+# $Id: xxdp25_rl_boot.tcl 654 2015-03-01 18:45:38Z mueller $
+#
+# Setup file for XXDP V2.5 RL02 based system
+#
+# Usage:
+#   
+# console_starter -d DL0 &
+# ti_w11 -xxx @xxdp25_rl_boot.tcl     ( -xxx depends on sim or fpga connect)
+#
+
+# setup w11 cpu
+puts [rlw]
+
+# setup tt,lp,pp (single console; enable rx rate limiter on old DEC OS)
+rw11::setup_tt "cpu0" {ndl 1 dlrlim 5 to7bit 1}
+rw11::setup_lp 
+rw11::setup_pp
+
+# mount disks
+cpu0rla0 att xxdp25.dsk
+
+# and boot
+rw11::cpumon
+rw11::cpucons
+cpu0 boot rla0