first commit

docs/1970s/1970/caps-11/index.md

@@ -0,0 +1,36 @@
+---
+keywords: ["CAPS-11", "PDP-11", 1970s, 1970]
+image: ./caps-11.webp
+description: "! CAPS-11 was an operating system for the DEC PDP-11 computer. It is one of the earliest available operating system to be run on a PDP-11."
+sidebar_position: 2
+---
+
+import DocCardList from '@theme/DocCardList';
+
+# ! CAPS-11
+
+![! CAPS-11](./caps-11.webp)
+
+! CAPS-11 (**Ca**ssette **P**rogramming **S**ystem) was an operating system for the DEC PDP-11 computer. It is one of the earliest available operating system to be run on a PDP-11.
+
+<DocCardList />
+
+## Manuals
+
+You can download the ! CAPS-11 manual from here:
+
+- [! CAPS-11 User Guide](http://www.bitsavers.org/pdf/dec/pdp11/caps-11/DEC-11-OTUGA-A-D_CAPS-11_Users_Guide_Oct73.pdf)
+
+You may also be interested in the PDP-11 manuals. It was the computer on which ! CAPS-11 was supposed to run. You can download them from Bitsavers:
+
+- [PDP-11 Manuals](http://bitsavers.org/pdf/dec/pdp11/)
+
+## Related Pages
+
+- [VirtualHub Screenshots](https://screenshots.virtualhub.eu.org/1970s/1970/caps-11/)
+- [Wikipedia](https://en.wikipedia.org/wiki/PDP-11#Operating_systems)
+- [A third-party PDP-11 + CAPS-11 restoration bog post (with a YouTube video)](http://www.datormuseum.se/computers/digital-equipment-corporation/pdp-11-04.html)
+
+## Credits
+
+- The manuals were taken from [Bitsavers](http://bitsavers.org).

docs/1970s/1970/caps-11/simh/index.md

@@ -0,0 +1,132 @@
+---
+keywords: ["CAPS-11", "PDP-11", SIMH, 1970s, 1970]
+image: ./caps-11-SIMH-3.webp
+description: 'We can run ! CAPS-11 on the SIMH PDP-11 emulator. First, we need to download the ! CAPS-11 kit. You can download the kit needed to run it on the SIMH PDP-11 emulator from the "SIMH Legacy" website.'
+sidebar_position: 1
+sidebar_label: "! CAPS-11 on SIMH"
+---
+
+# How to install CAPS-11 on SIMH?
+
+![SIMH PDP-11 emulator with ! CAPS-11](./caps-11-SIMH-3.webp)
+
+We can run [! CAPS-11](/1970s/1970/caps-11) on the SIMH PDP-11 emulator. First, we need to download the ! CAPS-11 kit.
+
+## Downloads
+
+You can download the kit needed to run ! CAPS-11 on the SIMH PDP-11 emulator from the [“SIMH Legacy” website](http://simh.trailing-edge.com/):
+
+- [! CAPS-11 kit](http://simh.trailing-edge.com/kits/caps11_system.zip)
+
+## Using ! CAPS-11
+
+:::tip
+
+If you have not already installed SIMH PDP-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/simh-pdp11/) on Linux and Windows.
+
+:::
+
+Extract the kit you downloaded. Inside you will find two files. Create a folder somewhere to store the files for this VM, and move the file named `caps11.t60` into it.
+
+Now we will create a config file for our VM. Create a text file called `pdp11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 11/05
+set throttle 5%
+set cpu 32k
+set ptr disabled
+set ptp disabled
+set lpt disabled
+set dz disabled
+set rk disabled
+set rl disabled
+set hk disabled
+set rx disabled
+set rp disabled
+set rq disabled
+set tm disabled
+set tq disabled
+set ta enabled
+att ta0 caps11.t60
+d 1000 012700
+d 1002 177500
+d 1004 005010
+d 1006 010701
+d 1010 062701
+d 1012 000052
+d 1014 012702
+d 1016 000375
+d 1020 112103
+d 1022 112110
+d 1024 100413
+d 1026 130310
+d 1030 001776
+d 1032 105202
+d 1034 100772
+d 1036 116012
+d 1040 000002
+d 1042 120337
+d 1044 000000
+d 1046 001767
+d 1050 000000
+d 1052 000755
+d 1054 005710
+d 1056 100774
+d 1060 005007
+d 1062 017640
+d 1064 002415
+d 1066 112024
+d sr 0
+run 1000
+```
+
+![pdp11.ini](./caps-11-SIMH-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+pdp11
+```
+
+![pdp11](./caps-11-SIMH-2.webp)
+
+After the emulator starts, you can type `dir` followed by enter. It will list all the files available on the disk.
+
+![List of files in ! CAPS-11](./caps-11-SIMH-3.webp)
+
+That's it! We used ! CAPS-11. We can create a shell script to make it easy to launch the VM. Create a file called `caps-11.sh` with the following content:
+
+```bash
+#!/bin/bash
+pdp11
+```
+
+Now make the file executable:
+
+```bash
+chmod +x caps-11.sh
+```
+
+Now you can start the VM using the shell script. For example, on KDE you can right-click the file and choose `Run in Konsole` or on GNOME, where you can right-click the file and choose `Run as executable`. The VM will start.
+
+See the [manuals section](/1970s/1970/caps-11/#manuals) on the [main ! CAPS-11 page](/1970s/1970/caps-11) to learn how to use it.
+
+### Windows
+
+:::tip
+
+You should use Linux. If you don’t know how to install a Linux distro, see [our tutorials on how to install Kubuntu](https://setup.virtualhub.eu.org/tag/os/), a beginner-friendly distro.
+
+:::
+
+On Windows, you need to place the `PDP11.exe` file you downloaded in [this tutorial](https://setup.virtualhub.eu.org/simh-pdp11#windows) in the VM folder. Then you can follow the above tutorial as usual. The shell script will not work on Windows. You need to rename it to `caps-11.bat`. Then you can double-click the file to launch the VM, no need to make it executable.
+
+## Credits
+
+- The disk image and other files used above are from a kit available on [SimH “Classic” website](http://simh.trailing-edge.com/).
+
+## Video tutorial
+
+Do you want to follow the tutorial by watching a video? We will post a video on our [YouTube channel](https://www.youtube.com/@virtua1hub) soon.
+
+Archives of this tutorial are available on [Wayback Machine](https://web.archive.org/web/*/https://virtualhub.eu.org/1970s/1970/caps-11/simh/).