0000: 44 20 32 30 31 37 2d 31 32 2d 32 33 54 30 34 3a D 2017-12-23T04:
0010: 32 37 3a 32 33 2e 38 38 34 0a 4c 20 48 6f 6d 65 27:23.884.L Home
0020: 0a 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f .N text/x-markdo
0030: 77 6e 0a 50 20 35 36 34 37 38 39 35 36 64 34 63 wn.P 56478956d4c
0040: 38 63 31 38 39 66 61 63 66 37 65 65 31 62 62 62 8c189facf7ee1bbb
0050: 61 30 33 38 30 32 64 62 65 36 66 37 64 0a 55 20 a03802dbe6f7d.U
0060: 74 61 6e 67 65 6e 74 0a 57 20 31 33 37 32 30 0a tangent.W 13720.
0070: 23 20 57 68 61 74 20 49 74 20 49 73 0d 0a 0d 0a # What It Is....
0080: 54 68 69 73 20 72 65 70 6f 73 69 74 6f 72 79 20 This repository
0090: 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 5b is the current [
00a0: 6f 66 66 69 63 69 61 6c 5d 28 68 74 74 70 73 3a official](https:
00b0: 2f 2f 67 72 6f 75 70 73 2e 67 6f 6f 67 6c 65 2e //groups.google.
00c0: 63 6f 6d 2f 64 2f 6d 73 67 2f 70 69 64 70 2d 38 com/d/msg/pidp-8
00d0: 2f 56 58 74 39 31 34 61 41 74 74 67 2f 45 36 45 /VXt914aAttg/E6E
00e0: 43 47 30 4b 4c 43 41 41 4a 29 20 50 69 44 50 2d CG0KLCAAJ) PiDP-
00f0: 38 2f 49 20 73 6f 66 74 77 61 72 65 20 64 65 76 8/I software dev
0100: 65 6c 6f 70 6d 65 6e 74 20 6e 65 78 75 73 2e 20 elopment nexus.
0110: 48 65 72 65 20 77 65 20 63 6f 6e 74 69 6e 75 65 Here we continue
0120: 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 6f 66 20 development of
0130: 74 68 65 20 73 6f 66 74 77 61 72 65 20 66 72 6f the software fro
0140: 6d 20 74 68 65 20 6c 61 73 74 20 73 74 61 62 6c m the last stabl
0150: 65 20 76 65 72 73 69 6f 6e 20 70 75 62 6c 69 73 e version publis
0160: 68 65 64 20 6f 6e 20 74 68 65 20 5b 70 72 6f 6a hed on the [proj
0170: 65 63 74 20 73 69 74 65 5d 28 68 74 74 70 3a 2f ect site](http:/
0180: 2f 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2e 77 69 /obsolescence.wi
0190: 78 73 69 74 65 2e 63 6f 6d 2f 6f 62 73 6f 6c 65 xsite.com/obsole
01a0: 73 63 65 6e 63 65 2f 70 69 64 70 2d 38 2d 64 65 scence/pidp-8-de
01b0: 74 61 69 6c 73 29 2e 20 54 68 69 73 20 73 6f 66 tails). This sof
01c0: 74 77 61 72 65 20 64 69 66 66 65 72 73 20 69 6e tware differs in
01d0: 20 5b 73 65 76 65 72 61 6c 20 6d 61 6a 6f 72 20 [several major
01e0: 77 61 79 73 5d 28 2f 77 69 6b 69 3f 6e 61 6d 65 ways](/wiki?name
01f0: 3d 4d 61 6a 6f 72 2b 44 69 66 66 65 72 65 6e 63 =Major+Differenc
0200: 65 73 29 20 66 72 6f 6d 20 74 68 61 74 20 70 72 es) from that pr
0210: 69 6f 72 20 73 74 61 62 6c 65 20 72 65 6c 65 61 ior stable relea
0220: 73 65 2e 0d 0a 0d 0a 54 68 65 20 72 65 6c 65 61 se.....The relea
0230: 73 65 20 76 65 72 73 69 6f 6e 73 20 61 76 61 69 se versions avai
0240: 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 69 73 20 lable from this
0250: 73 69 74 65 20 61 72 65 20 22 73 74 61 62 6c 65 site are "stable
0260: 22 20 69 6e 20 74 68 65 20 73 65 6e 73 65 20 74 " in the sense t
0270: 68 61 74 20 74 68 65 79 20 72 65 70 72 65 73 65 hat they represe
0280: 6e 74 20 61 20 63 6f 68 65 72 65 6e 74 20 6e 65 nt a coherent ne
0290: 77 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 w version of the
02a0: 20 73 6f 66 74 77 61 72 65 20 61 6e 64 20 74 68 software and th
02b0: 65 79 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 ey are no longer
02c0: 20 63 68 61 6e 67 69 6e 67 20 69 6e 20 6d 61 6a changing in maj
02d0: 6f 72 20 77 61 79 73 2c 20 61 73 20 74 68 65 79 or ways, as they
02e0: 20 64 69 64 20 69 6e 20 74 68 65 20 66 69 72 73 did in the firs
02f0: 74 20 6d 6f 6e 74 68 73 20 6f 66 20 64 65 76 65 t months of deve
0300: 6c 6f 70 6d 65 6e 74 2e 0d 0a 0d 0a 0d 0a 23 20 lopment.......#
0310: 3c 61 20 6e 61 6d 65 3d 22 73 72 63 22 3e 3c 2f <a name="src"></
0320: 61 3e 47 65 74 74 69 6e 67 20 53 74 61 72 74 65 a>Getting Starte
0330: 64 3a 20 53 6f 75 72 63 65 20 43 6f 64 65 0d 0a d: Source Code..
0340: 0d 0a 54 68 65 20 65 66 66 69 63 69 65 6e 74 20 ..The efficient
0350: 6d 65 74 68 6f 64 20 74 6f 20 67 65 74 20 73 74 method to get st
0360: 61 72 74 65 64 20 69 73 20 74 6f 20 69 6e 73 74 arted is to inst
0370: 61 6c 6c 20 74 68 69 73 20 73 6f 66 74 77 61 72 all this softwar
0380: 65 20 69 6e 74 6f 20 61 6e 20 65 78 69 73 74 69 e into an existi
0390: 6e 67 20 5b 52 61 73 70 62 69 61 6e 5d 28 68 74 ng [Raspbian](ht
03a0: 74 70 73 3a 2f 2f 77 77 77 2e 72 61 73 70 62 65 tps://www.raspbe
03b0: 72 72 79 70 69 2e 6f 72 67 2f 64 6f 77 6e 6c 6f rrypi.org/downlo
03c0: 61 64 73 2f 72 61 73 70 62 69 61 6e 2f 29 20 69 ads/raspbian/) i
03d0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 6f 6e 20 74 nstallation on t
03e0: 68 65 20 50 69 20 77 68 69 63 68 20 79 6f 75 20 he Pi which you
03f0: 61 72 65 20 75 73 69 6e 67 20 77 69 74 68 20 74 are using with t
0400: 68 65 20 50 69 44 50 2d 38 2f 49 20 62 6f 61 72 he PiDP-8/I boar
0410: 64 2e 20 49 74 20 61 6c 73 6f 20 77 6f 72 6b 73 d. It also works
0420: 20 77 69 74 68 20 5b 73 6f 6d 65 20 6f 74 68 65 with [some othe
0430: 72 20 4f 53 65 73 5d 28 68 74 74 70 73 3a 2f 2f r OSes](https://
0440: 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f tangentsoft.com/
0450: 70 69 64 70 38 69 2f 77 69 6b 69 3f 6e 61 6d 65 pidp8i/wiki?name
0460: 3d 4f 53 2b 43 6f 6d 70 61 74 69 62 69 6c 69 74 =OS+Compatibilit
0470: 79 29 2e 0d 0a 0d 0a 59 6f 75 20 63 61 6e 20 64 y).....You can d
0480: 6f 77 6e 6c 6f 61 64 20 74 68 65 20 6c 61 74 65 ownload the late
0490: 73 74 20 72 65 6c 65 61 73 65 20 e2 80 94 20 63 st release — c
04a0: 75 74 20 6f 6e 20 32 30 31 37 2e 31 32 2e 32 32 ut on 2017.12.22
04b0: 20 e2 80 94 20 61 73 20 5b 61 20 5a 69 70 20 61 — as [a Zip a
04c0: 72 63 68 69 76 65 5d 28 2f 7a 69 70 2f 70 69 64 rchive](/zip/pid
04d0: 70 38 69 2d 76 32 30 31 37 31 32 32 32 2e 7a 69 p8i-v20171222.zi
04e0: 70 3f 75 75 69 64 3d 72 65 6c 65 61 73 65 29 20 p?uuid=release)
04f0: 6f 72 20 5b 61 20 74 61 72 62 61 6c 6c 5d 28 2f or [a tarball](/
0500: 74 61 72 62 61 6c 6c 2f 70 69 64 70 38 69 2d 76 tarball/pidp8i-v
0510: 32 30 31 37 31 32 32 32 2e 74 61 72 2e 67 7a 3f 20171222.tar.gz?
0520: 75 75 69 64 3d 72 65 6c 65 61 73 65 29 2e 20 28 uuid=release). (
0530: 41 62 6f 75 74 20 2a 2a 35 20 4d 42 2a 2a 20 65 About **5 MB** e
0540: 61 63 68 2e 29 0d 0a 0d 0a 49 66 20 79 6f 75 20 ach.)....If you
0550: 77 61 6e 74 20 74 68 65 20 62 6c 65 65 64 69 6e want the bleedin
0560: 67 20 65 64 67 65 20 76 65 72 73 69 6f 6e 2c 20 g edge version,
0570: 79 6f 75 20 63 61 6e 20 65 69 74 68 65 72 20 63 you can either c
0580: 68 65 63 6b 20 69 74 20 6f 75 74 20 66 72 6f 6d heck it out from
0590: 20 74 68 65 20 46 6f 73 73 69 6c 20 73 6f 75 72 the Fossil sour
05a0: 63 65 20 63 6f 64 65 20 72 65 70 6f 73 69 74 6f ce code reposito
05b0: 72 79 20 70 6f 77 65 72 69 6e 67 20 74 68 69 73 ry powering this
05c0: 20 77 65 62 20 73 69 74 65 20 62 79 20 66 6f 6c web site by fol
05d0: 6c 6f 77 69 6e 67 20 74 68 65 20 69 6e 73 74 72 lowing the instr
05e0: 75 63 74 69 6f 6e 73 20 69 6e 20 5b 74 68 65 20 uctions in [the
05f0: 68 61 63 6b 65 72 73 27 20 67 75 69 64 65 5d 28 hackers' guide](
0600: 2f 64 6f 63 2f 74 72 75 6e 6b 2f 48 41 43 4b 45 /doc/trunk/HACKE
0610: 52 53 2e 6d 64 29 20 6f 72 20 79 6f 75 20 63 61 RS.md) or you ca
0620: 6e 20 73 69 6d 70 6c 79 20 64 6f 77 6e 6c 6f 61 n simply downloa
0630: 64 20 74 68 65 20 74 69 70 20 6f 66 20 74 72 75 d the tip of tru
0640: 6e 6b 20 61 73 20 5b 61 20 5a 69 70 20 61 72 63 nk as [a Zip arc
0650: 68 69 76 65 5d 28 2f 7a 69 70 2f 70 69 64 70 38 hive](/zip/pidp8
0660: 69 2d 74 72 75 6e 6b 3f 75 75 69 64 3d 74 72 75 i-trunk?uuid=tru
0670: 6e 6b 29 20 6f 72 20 5b 61 20 74 61 72 62 61 6c nk) or [a tarbal
0680: 6c 5d 28 2f 74 61 72 62 61 6c 6c 2f 70 69 64 70 l](/tarball/pidp
0690: 38 69 2d 74 72 75 6e 6b 2e 74 61 72 2e 67 7a 3f 8i-trunk.tar.gz?
06a0: 75 75 69 64 3d 74 72 75 6e 6b 29 2e 0d 0a 0d 0a uuid=trunk).....
06b0: 53 65 65 20 5b 74 68 65 20 60 52 45 41 44 4d 45 See [the `README
06c0: 2e 6d 64 60 20 66 69 6c 65 5d 28 2f 64 6f 63 2f .md` file](/doc/
06d0: 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 29 trunk/README.md)
06e0: 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d for more inform
06f0: 61 74 69 6f 6e 20 6f 6e 20 68 6f 77 20 74 6f 20 ation on how to
0700: 69 6e 73 74 61 6c 6c 20 74 68 69 73 20 69 6e 74 install this int
0710: 6f 20 79 6f 75 72 20 65 78 69 73 74 69 6e 67 20 o your existing
0720: 52 61 73 70 62 65 72 72 79 20 50 69 20 4f 53 2e Raspberry Pi OS.
0730: 0d 0a 0d 0a 0d 0a 23 20 3c 61 20 6e 61 6d 65 3d ......# <a name=
0740: 22 62 6f 73 69 22 3e 3c 2f 61 3e 47 65 74 74 69 "bosi"></a>Getti
0750: 6e 67 20 53 74 61 72 74 65 64 3a 20 42 69 6e 61 ng Started: Bina
0760: 72 79 20 4f 53 20 49 6d 61 67 65 73 0d 0a 0d 0a ry OS Images....
0770: 54 68 6f 73 65 20 77 69 74 68 20 70 6c 65 6e 74 Those with plent
0780: 79 20 6f 66 20 49 6e 74 65 72 6e 65 74 20 62 61 y of Internet ba
0790: 6e 64 77 69 64 74 68 20 61 6e 64 20 61 20 6d 69 ndwidth and a mi
07a0: 63 72 6f 20 53 44 20 63 61 72 64 20 74 68 65 79 cro SD card they
07b0: 20 64 6f 6e 27 74 20 6d 69 6e 64 20 6f 76 65 72 don't mind over
07c0: 77 72 69 74 69 6e 67 20 6d 61 79 20 70 72 65 66 writing may pref
07d0: 65 72 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 20 74 er to download t
07e0: 68 65 20 73 6f 66 74 77 61 72 65 20 68 6f 73 74 he software host
07f0: 65 64 20 68 65 72 65 20 69 6e 20 62 69 6e 61 72 ed here in binar
0800: 79 20 4f 53 20 69 6d 61 67 65 20 66 6f 72 6d 2e y OS image form.
0810: 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 76 There are two v
0820: 65 72 73 69 6f 6e 73 2c 20 65 61 63 68 20 62 61 ersions, each ba
0830: 73 65 64 20 6f 6e 20 52 61 73 70 62 69 61 6e 20 sed on Raspbian
0840: 53 74 72 65 74 63 68 20 4c 69 74 65 20 61 6e 64 Stretch Lite and
0850: 20 65 61 63 68 20 72 6f 75 67 68 6c 79 20 2a 2a each roughly **
0860: 35 30 30 20 4d 42 2a 2a 3a 0d 0a 0d 0a 31 2e 20 500 MB**:....1.
0870: 5b 4d 75 6c 74 69 2d 63 6f 72 65 20 76 65 72 73 [Multi-core vers
0880: 69 6f 6e 5d 28 68 74 74 70 73 3a 2f 2f 74 61 6e ion](https://tan
0890: 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 64 6c 2f gentsoft.com/dl/
08a0: 70 69 64 70 38 69 2d 32 30 31 37 2e 31 32 2e 32 pidp8i-2017.12.2
08b0: 32 2d 69 6c 73 2d 73 74 72 65 74 63 68 2d 6c 69 2-ils-stretch-li
08c0: 74 65 2e 69 6d 67 2e 7a 69 70 29 2c 20 76 32 30 te.img.zip), v20
08d0: 31 37 2e 31 32 2e 32 32 20 e2 80 94 20 54 68 69 17.12.22 — Thi
08e0: 73 20 4f 53 20 69 6d 61 67 65 20 69 73 20 62 75 s OS image is bu
08f0: 69 6c 74 20 77 69 74 68 20 74 68 65 20 5b 69 6e ilt with the [in
0900: 63 61 6e 64 65 73 63 65 6e 74 20 6c 61 6d 70 20 candescent lamp
0910: 73 69 6d 75 6c 61 74 6f 72 5d 28 77 69 6b 69 3f simulator](wiki?
0920: 6e 61 6d 65 3d 49 6e 63 61 6e 64 65 73 63 65 6e name=Incandescen
0930: 74 2b 4c 61 6d 70 2b 53 69 6d 75 6c 61 74 6f 72 t+Lamp+Simulator
0940: 29 20 77 68 69 63 68 20 6f 6e 6c 79 20 77 6f 72 ) which only wor
0950: 6b 73 20 70 72 6f 70 65 72 6c 79 20 6f 6e 20 74 ks properly on t
0960: 68 65 20 6d 75 6c 74 69 2d 63 6f 72 65 20 52 61 he multi-core Ra
0970: 73 70 62 65 72 72 79 20 50 69 20 32 20 61 6e 64 spberry Pi 2 and
0980: 20 33 20 62 6f 61 72 64 73 2e 20 28 41 6c 6c 20 3 boards. (All
0990: 6d 6f 64 65 6c 73 2e 29 0d 0a 0d 0a 20 20 20 20 models.)....
09a0: 49 74 20 74 61 6b 65 73 20 61 62 6f 75 74 20 6f It takes about o
09b0: 6e 65 20 61 6e 64 20 61 20 68 61 6c 66 20 6f 66 ne and a half of
09c0: 20 74 68 65 20 66 6f 75 72 20 61 76 61 69 6c 61 the four availa
09d0: 62 6c 65 20 43 50 55 20 63 6f 72 65 73 20 6f 6e ble CPU cores on
09e0: 20 61 20 50 69 20 32 20 6f 72 20 50 69 20 33 20 a Pi 2 or Pi 3
09f0: 77 68 69 6c 65 20 72 75 6e 6e 69 6e 67 20 61 62 while running ab
0a00: 6f 75 74 20 2a 32 34 26 74 69 6d 65 73 3b 2a 20 out *24×*
0a10: 66 61 73 74 65 72 20 74 68 61 6e 20 61 20 72 65 faster than a re
0a20: 61 6c 20 50 44 50 2d 38 2f 49 2e 0d 0a 0d 0a 32 al PDP-8/I.....2
0a30: 2e 20 5b 53 69 6e 67 6c 65 2d 63 6f 72 65 20 76 . [Single-core v
0a40: 65 72 73 69 6f 6e 5d 28 68 74 74 70 73 3a 2f 2f ersion](https://
0a50: 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f tangentsoft.com/
0a60: 64 6c 2f 70 69 64 70 38 69 2d 32 30 31 37 2e 31 dl/pidp8i-2017.1
0a70: 32 2e 32 32 2d 6e 6c 73 2d 73 74 72 65 74 63 68 2.22-nls-stretch
0a80: 2d 6c 69 74 65 2e 69 6d 67 2e 7a 69 70 29 2c 20 -lite.img.zip),
0a90: 76 32 30 31 37 2e 31 32 2e 32 32 20 e2 80 94 20 v2017.12.22 —
0aa0: 46 6f 72 20 74 68 6f 73 65 20 72 75 6e 6e 69 6e For those runnin
0ab0: 67 20 6f 6e 20 52 61 73 70 62 65 72 72 79 20 50 g on Raspberry P
0ac0: 69 20 4d 6f 64 65 6c 20 41 2b 20 61 6e 64 20 42 i Model A+ and B
0ad0: 2b 20 62 6f 61 72 64 73 20 6f 72 20 74 68 65 20 + boards or the
0ae0: 50 69 20 5a 65 72 6f 2c 20 74 68 69 73 20 61 6c Pi Zero, this al
0af0: 74 65 72 6e 61 74 69 76 65 20 64 6f 77 6e 6c 6f ternative downlo
0b00: 61 64 20 64 69 73 61 62 6c 65 73 20 74 68 65 20 ad disables the
0b10: 49 4c 53 20 66 65 61 74 75 72 65 2e 20 49 74 20 ILS feature. It
0b20: 61 6c 73 6f 20 73 6c 6f 77 73 20 74 68 65 20 73 also slows the s
0b30: 69 6d 75 6c 61 74 6f 72 20 64 6f 77 6e 20 73 6f imulator down so
0b40: 20 69 74 20 75 73 65 73 20 6f 6e 6c 79 20 61 62 it uses only ab
0b50: 6f 75 74 20 68 61 6c 66 20 74 68 65 20 61 76 61 out half the ava
0b60: 69 6c 61 62 6c 65 20 43 50 55 20 70 6f 77 65 72 ilable CPU power
0b70: 20 74 6f 20 6c 65 61 76 65 20 73 6f 6d 65 20 68 to leave some h
0b80: 6f 73 74 20 43 50 55 20 70 6f 77 65 72 20 66 6f ost CPU power fo
0b90: 72 20 62 61 63 6b 67 72 6f 75 6e 64 20 74 61 73 r background tas
0ba0: 6b 73 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 ks. This allows
0bb0: 69 74 20 74 6f 20 72 75 6e 20 50 44 50 2d 38 20 it to run PDP-8
0bc0: 73 6f 66 74 77 61 72 65 20 72 6f 75 67 68 6c 79 software roughly
0bd0: 20 2a 33 26 74 69 6d 65 73 3b 2a 20 61 73 20 66 *3×* as f
0be0: 61 73 74 20 61 73 20 61 20 72 65 61 6c 20 50 44 ast as a real PD
0bf0: 50 2d 38 2f 49 2c 20 64 65 70 65 6e 64 69 6e 67 P-8/I, depending
0c00: 20 6f 6e 20 74 68 65 20 73 70 65 65 64 20 6f 66 on the speed of
0c10: 20 74 68 65 20 50 69 20 79 6f 75 20 72 75 6e 20 the Pi you run
0c20: 69 74 20 6f 6e 2e 0d 0a 0d 0a 20 20 20 20 54 68 it on..... Th
0c30: 69 73 20 69 6d 61 67 65 20 77 69 6c 6c 20 61 6c is image will al
0c40: 73 6f 20 72 75 6e 20 6f 6e 20 61 20 6d 75 6c 74 so run on a mult
0c50: 69 2d 63 6f 72 65 20 50 69 2e 20 49 74 20 77 69 i-core Pi. It wi
0c60: 6c 6c 20 72 75 6e 20 50 44 50 2d 38 20 73 6f 66 ll run PDP-8 sof
0c70: 74 77 61 72 65 20 73 6c 6f 77 65 72 20 74 68 61 tware slower tha
0c80: 6e 20 74 68 65 20 49 4c 53 20 76 65 72 73 69 6f n the ILS versio
0c90: 6e 2c 20 73 69 6e 63 65 20 69 74 20 77 69 6c 6c n, since it will
0ca0: 20 61 6c 73 6f 20 62 65 20 61 66 66 65 63 74 65 also be affecte
0cb0: 64 20 62 79 20 74 68 65 20 69 6e 74 65 6e 74 69 d by the intenti
0cc0: 6f 6e 61 6c 20 35 30 25 20 43 50 55 20 75 73 61 onal 50% CPU usa
0cd0: 67 65 20 6c 69 6d 69 74 2c 20 62 75 74 20 62 65 ge limit, but be
0ce0: 63 61 75 73 65 20 65 61 63 68 20 6f 6e 65 20 6f cause each one o
0cf0: 66 20 74 68 6f 73 65 20 63 6f 72 65 73 20 61 72 f those cores ar
0d00: 65 20 66 61 73 74 65 72 20 74 68 61 6e 20 61 20 e faster than a
0d10: 73 69 6e 67 6c 65 2d 63 6f 72 65 20 50 69 20 61 single-core Pi a
0d20: 6e 64 20 74 68 65 20 6f 74 68 65 72 20 63 6f 72 nd the other cor
0d30: 65 73 20 63 61 6e 20 74 61 6b 65 20 74 68 65 20 es can take the
0d40: 6c 6f 61 64 20 6f 66 20 62 61 63 6b 67 72 6f 75 load of backgrou
0d50: 6e 64 20 74 61 73 6b 73 2c 20 69 74 20 73 74 69 nd tasks, it sti
0d60: 6c 6c 20 6d 61 6e 61 67 65 73 20 74 6f 20 72 75 ll manages to ru
0d70: 6e 20 50 44 50 2d 38 20 73 6f 66 74 77 61 72 65 n PDP-8 software
0d80: 20 72 6f 75 67 68 6c 79 20 2a 31 30 26 74 69 6d roughly *10&tim
0d90: 65 73 3b 2a 20 66 61 73 74 65 72 20 74 68 61 6e es;* faster than
0da0: 20 61 20 72 65 61 6c 20 50 44 50 2d 38 2f 49 2e a real PDP-8/I.
0db0: 0d 0a 0d 0a 53 65 65 20 74 68 65 20 5b 69 6e 73 ....See the [ins
0dc0: 74 61 6c 6c 61 74 69 6f 6e 20 69 6e 73 74 72 75 tallation instru
0dd0: 63 74 69 6f 6e 73 5d 28 2f 64 6f 63 2f 74 72 75 ctions](/doc/tru
0de0: 6e 6b 2f 64 6f 63 2f 4f 53 2d 69 6d 61 67 65 73 nk/doc/OS-images
0df0: 2e 6d 64 29 20 66 6f 72 20 6d 6f 72 65 20 69 6e .md) for more in
0e00: 66 6f 72 6d 61 74 69 6f 6e 2e 0d 0a 0d 0a 54 68 formation.....Th
0e10: 65 20 62 69 6e 61 72 79 20 4f 53 20 72 65 6c 65 e binary OS rele
0e20: 61 73 65 73 20 61 72 65 20 6e 6f 74 20 61 6c 77 ases are not alw
0e30: 61 79 73 20 75 70 64 61 74 65 64 20 77 68 65 6e ays updated when
0e40: 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 the source code
0e50: 20 72 65 6c 65 61 73 65 73 20 61 72 65 20 63 75 releases are cu
0e60: 74 2c 20 73 69 6e 63 65 20 69 74 20 69 73 20 61 t, since it is a
0e70: 20 66 61 69 72 20 61 6d 6f 75 6e 74 20 6f 66 20 fair amount of
0e80: 77 6f 72 6b 20 74 6f 20 64 6f 20 74 68 6f 73 65 work to do those
0e90: 20 62 69 6e 61 72 79 20 72 65 6c 65 61 73 65 73 binary releases
0ea0: 2e 20 41 64 64 72 65 73 73 69 6e 67 20 74 68 61 . Addressing tha
0eb0: 74 20 69 73 20 74 68 65 20 74 6f 70 69 63 20 6f t is the topic o
0ec0: 66 20 74 68 65 20 6e 65 78 74 20 73 65 63 74 69 f the next secti
0ed0: 6f 6e 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e on.......## <a n
0ee0: 61 6d 65 3d 22 75 70 64 61 74 69 6e 67 22 3e 3c ame="updating"><
0ef0: 2f 61 3e 55 70 64 61 74 69 6e 67 20 74 68 65 20 /a>Updating the
0f00: 42 69 6e 61 72 79 20 4f 53 20 52 65 6c 65 61 73 Binary OS Releas
0f10: 65 0d 0a 0d 0a 41 73 20 73 68 69 70 70 65 64 2c e....As shipped,
0f20: 20 74 68 65 20 62 69 6e 61 72 79 20 4f 53 20 69 the binary OS i
0f30: 6d 61 67 65 73 20 61 62 6f 76 65 20 61 6c 73 6f mages above also
0f40: 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 50 69 44 contain the PiD
0f50: 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 20 73 P-8/I software s
0f60: 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 46 ource code and F
0f70: 6f 73 73 69 6c 2c 20 74 68 65 20 74 6f 6f 6c 20 ossil, the tool
0f80: 74 68 61 74 20 6c 65 74 73 20 79 6f 75 20 64 6f that lets you do
0f90: 77 6e 6c 6f 61 64 20 75 70 64 61 74 65 64 20 73 wnload updated s
0fa0: 6f 75 72 63 65 20 63 6f 64 65 20 61 73 20 69 74 ource code as it
0fb0: 20 62 65 63 6f 6d 65 73 20 61 76 61 69 6c 61 62 becomes availab
0fc0: 6c 65 2e 20 55 70 64 61 74 69 6e 67 20 74 68 65 le. Updating the
0fd0: 20 73 6f 66 74 77 61 72 65 20 69 73 20 74 68 65 software is the
0fe0: 72 65 66 6f 72 65 20 6d 75 63 68 20 73 69 6d 70 refore much simp
0ff0: 6c 65 72 20 74 68 61 6e 20 64 6f 77 6e 6c 6f 61 ler than downloa
1000: 64 69 6e 67 20 74 68 65 20 77 68 6f 6c 65 20 4f ding the whole O
1010: 53 20 61 6c 6c 20 6f 76 65 72 20 61 67 61 69 6e S all over again
1020: 20 61 6e 64 20 6f 76 65 72 77 72 69 74 69 6e 67 and overwriting
1030: 20 79 6f 75 72 20 70 65 72 66 65 63 74 6c 79 20 your perfectly
1040: 67 6f 6f 64 20 53 44 20 63 61 72 64 3a 0d 0a 0d good SD card:...
1050: 0a 20 20 20 20 24 20 63 64 20 7e 2f 70 69 64 70 . $ cd ~/pidp
1060: 38 69 0d 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 8i.. $ fossil
1070: 20 75 70 64 61 74 65 0d 0a 20 20 20 20 24 20 6d update.. $ m
1080: 61 6b 65 20 26 26 20 73 75 64 6f 20 6d 61 6b 65 ake && sudo make
1090: 20 69 6e 73 74 61 6c 6c 0d 0a 20 20 20 20 24 20 install.. $
10a0: 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 72 sudo systemctl r
10b0: 65 73 74 61 72 74 20 70 69 64 70 38 69 0d 0a 20 estart pidp8i..
10c0: 20 20 20 24 20 70 69 64 70 38 69 0d 0a 0d 0a 54 $ pidp8i....T
10d0: 68 61 74 20 73 68 6f 75 6c 64 20 70 75 74 20 79 hat should put y
10e0: 6f 75 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 ou back into the
10f0: 20 50 69 44 50 2d 38 2f 49 20 73 69 6d 75 6c 61 PiDP-8/I simula
1100: 74 6f 72 20 77 69 74 68 20 74 68 65 20 6e 65 77 tor with the new
1110: 20 63 6f 64 65 20 72 75 6e 6e 69 6e 67 2e 0d 0a code running...
1120: 0d 0a 49 20 73 61 79 20 22 73 68 6f 75 6c 64 22 ..I say "should"
1130: 20 62 65 63 61 75 73 65 20 74 68 65 20 61 62 6f because the abo
1140: 76 65 20 70 72 6f 63 65 73 73 20 69 73 6e 27 74 ve process isn't
1150: 20 66 6f 6f 6c 70 72 6f 6f 66 2e 20 54 68 65 72 foolproof. Ther
1160: 65 20 61 72 65 20 6d 61 6e 79 20 73 69 74 75 61 e are many situa
1170: 74 69 6f 6e 73 20 77 68 65 72 65 20 79 6f 75 27 tions where you'
1180: 6c 6c 20 6e 65 65 64 20 74 6f 20 64 69 67 20 64 ll need to dig d
1190: 65 65 70 65 72 20 69 6e 74 6f 20 74 68 65 20 70 eeper into the p
11a0: 72 6f 63 65 73 73 3a 0d 0a 0d 0a 2a 20 20 20 74 rocess:....* t
11b0: 68 65 20 60 6d 61 6b 65 60 20 70 72 6f 63 65 73 he `make` proces
11c0: 73 20 66 61 69 6c 65 64 20 62 65 63 61 75 73 65 s failed because
11d0: 20 6f 66 20 74 68 65 20 63 68 61 6e 67 65 73 20 of the changes
11e0: 6d 61 64 65 20 74 6f 20 74 68 65 20 73 6f 75 72 made to the sour
11f0: 63 65 20 63 6f 64 65 20 73 69 6e 63 65 20 74 68 ce code since th
1200: 65 20 76 65 72 73 69 6f 6e 20 79 6f 75 20 68 61 e version you ha
1210: 76 65 20 6c 6f 63 61 6c 6c 79 0d 0a 0d 0a 2a 20 ve locally....*
1220: 20 20 79 6f 75 20 77 61 6e 74 20 74 68 65 20 62 you want the b
1230: 69 6e 61 72 79 20 4f 53 20 6d 65 64 69 61 20 72 inary OS media r
1240: 65 70 6c 61 63 65 64 20 61 73 20 77 65 6c 6c 20 eplaced as well
1250: 61 73 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 as the PiDP-8/I
1260: 73 6f 66 74 77 61 72 65 0d 0a 0d 0a 2a 20 20 20 software....*
1270: 79 6f 75 20 77 61 6e 74 20 75 70 64 61 74 65 64 you want updated
1280: 20 73 69 6d 75 6c 61 74 6f 72 20 63 6f 6e 66 69 simulator confi
1290: 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 20 66 guration files f
12a0: 6f 72 20 74 68 65 20 73 61 6d 65 20 72 65 61 73 or the same reas
12b0: 6f 6e 0d 0a 0d 0a 2a 20 20 20 74 68 65 20 70 72 on....* the pr
12c0: 69 6f 72 20 73 6f 66 74 77 61 72 65 20 63 6f 6e ior software con
12d0: 66 69 67 75 72 61 74 69 6f 6e 20 77 61 73 6e 27 figuration wasn'
12e0: 74 20 65 78 61 63 74 6c 79 20 77 68 61 74 20 79 t exactly what y
12f0: 6f 75 20 77 61 6e 74 65 64 0d 0a 0d 0a 41 6c 6c ou wanted....All
1300: 20 6f 66 20 74 68 6f 73 65 20 73 69 74 75 61 74 of those situat
1310: 69 6f 6e 73 20 61 6e 64 20 6d 6f 72 65 20 61 72 ions and more ar
1320: 65 20 63 6f 76 65 72 65 64 20 69 6e 20 5b 74 68 e covered in [th
1330: 65 20 60 52 45 41 44 4d 45 2e 6d 64 60 20 66 69 e `README.md` fi
1340: 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 le](/doc/trunk/R
1350: 45 41 44 4d 45 2e 6d 64 29 2e 0d 0a 0d 0a 0d 0a EADME.md).......
1360: 23 23 20 3c 61 20 69 64 3d 22 6f 73 38 22 3e 3c ## <a id="os8"><
1370: 2f 61 3e 4f 53 2f 38 20 52 4b 30 35 20 4d 65 64 /a>OS/8 RK05 Med
1380: 69 61 0d 0a 0d 0a 46 6f 72 20 74 68 65 20 62 65 ia....For the be
1390: 6e 65 66 69 74 20 6f 66 20 74 68 6f 73 65 20 6e nefit of those n
13a0: 6f 74 20 72 75 6e 6e 69 6e 67 20 61 20 72 65 63 ot running a rec
13b0: 65 6e 74 20 76 65 72 73 69 6f 6e 20 6f 66 20 6f ent version of o
13c0: 75 72 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 ur PiDP-8/I soft
13d0: 77 61 72 65 2c 20 77 65 20 68 61 76 65 20 70 72 ware, we have pr
13e0: 6f 76 69 64 65 64 20 73 6e 61 70 73 68 6f 74 73 ovided snapshots
13f0: 20 6f 66 20 74 68 65 20 4f 53 2f 38 20 52 4b 30 of the OS/8 RK0
1400: 35 20 6d 65 64 69 61 20 69 6d 61 67 65 73 20 70 5 media images p
1410: 72 6f 64 75 63 65 64 20 62 79 20 6f 75 72 20 60 roduced by our `
1420: 6d 6b 6f 73 38 60 20 74 6f 6f 6c 2c 20 77 68 69 mkos8` tool, whi
1430: 63 68 20 62 75 69 6c 64 73 20 63 6c 65 61 6e 20 ch builds clean
1440: 4f 53 2f 38 20 52 4b 30 35 20 64 69 73 6b 20 69 OS/8 RK05 disk i
1450: 6d 61 67 65 73 20 66 72 6f 6d 20 70 72 69 73 74 mages from prist
1460: 69 6e 65 2c 20 63 75 72 61 74 65 64 20 73 6f 75 ine, curated sou
1470: 72 63 65 73 3a 0d 0a 0d 0a 7c 20 42 61 73 65 20 rces:....| Base
1480: 4e 61 6d 65 20 7c 20 43 6f 6e 74 65 6e 74 73 0d Name | Contents.
1490: 0a 7c 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 7c 20 .| ---------- |
14a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 7c 20 5b 60 62 ---------..| [`b
14b0: 69 6e 60 5d 28 2f 75 76 2f 6f 73 38 76 33 64 2d in`](/uv/os8v3d-
14c0: 62 69 6e 2e 72 6b 30 35 29 20 7c 20 62 6f 6f 74 bin.rk05) | boot
14d0: 61 62 6c 65 20 4f 53 2f 38 20 56 33 44 20 77 69 able OS/8 V3D wi
14e0: 74 68 20 61 6c 6c 20 6f 66 20 74 68 65 20 5b 60 th all of the [`
14f0: 2d 2d 64 69 73 61 62 6c 65 2d 6f 73 38 2d 2a 60 --disable-os8-*`
1500: 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 41 ](/doc/trunk/REA
1510: 44 4d 45 2e 6d 64 23 64 69 73 61 62 6c 65 2d 6f DME.md#disable-o
1520: 73 38 29 20 6f 70 74 69 6f 6e 73 20 6c 65 66 74 s8) options left
1530: 20 75 6e 73 65 74 0d 0a 7c 20 5b 60 70 61 74 63 unset..| [`patc
1540: 68 65 64 60 5d 28 2f 75 76 2f 6f 73 38 76 33 64 hed`](/uv/os8v3d
1550: 2d 70 61 74 63 68 65 64 2e 72 6b 30 35 29 20 7c -patched.rk05) |
1560: 20 74 68 65 20 60 62 69 6e 60 20 64 69 73 6b 20 the `bin` disk
1570: 77 69 74 68 20 74 68 65 20 5b 64 65 66 61 75 6c with the [defaul
1580: 74 20 73 65 74 20 6f 66 20 70 61 74 63 68 65 73 t set of patches
1590: 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 ](/doc/trunk/doc
15a0: 2f 6f 73 38 2d 70 61 74 63 68 69 6e 67 2e 6d 64 /os8-patching.md
15b0: 29 20 61 70 70 6c 69 65 64 0d 0a 7c 20 5b 60 73 ) applied..| [`s
15c0: 72 63 60 5d 28 2f 75 76 2f 6f 73 38 76 33 64 2d rc`](/uv/os8v3d-
15d0: 73 72 63 2e 72 6b 30 35 29 20 7c 20 6e 6f 6e 2d src.rk05) | non-
15e0: 62 6f 6f 74 61 62 6c 65 20 64 69 73 6b 20 63 6f bootable disk co
15f0: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 6f 6e ntaining the con
1600: 74 65 6e 74 73 20 6f 66 20 61 6c 6c 20 74 65 6e tents of all ten
1610: 20 4f 53 2f 38 20 56 33 44 20 73 6f 75 72 63 65 OS/8 V3D source
1620: 20 74 61 70 65 73 0d 0a 0d 0a 54 68 65 73 65 20 tapes....These
1630: 77 65 72 65 20 6c 61 73 74 20 75 70 64 61 74 65 were last update
1640: 64 20 6f 6e 20 32 30 31 37 2e 31 32 2e 32 32 20 d on 2017.12.22
1650: 69 6e 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 in conjunction w
1660: 69 74 68 20 5b 74 68 65 20 72 65 6c 65 61 73 65 ith [the release
1670: 20 6d 61 64 65 20 61 74 20 74 68 65 20 73 61 6d made at the sam
1680: 65 20 74 69 6d 65 5d 28 2f 64 6f 63 2f 74 72 75 e time](/doc/tru
1690: 6e 6b 2f 43 68 61 6e 67 65 4c 6f 67 2e 6d 64 23 nk/ChangeLog.md#
16a0: 32 30 31 37 31 32 32 32 29 2e 20 54 68 65 73 65 20171222). These
16b0: 20 61 72 65 20 74 68 65 72 65 66 6f 72 65 20 63 are therefore c
16c0: 6f 6e 73 69 64 65 72 65 64 20 74 6f 20 62 65 20 onsidered to be
16d0: 73 74 61 62 6c 65 20 73 6f 66 74 77 61 72 65 2e stable software.
16e0: 20 49 66 20 79 6f 75 20 66 69 6e 64 20 61 6e 79 If you find any
16f0: 20 62 75 67 73 20 6f 72 20 63 6f 6e 63 65 69 76 bugs or conceiv
1700: 65 20 73 6f 6d 65 20 66 65 61 74 75 72 65 20 72 e some feature r
1710: 65 71 75 65 73 74 73 2c 20 5b 70 6c 65 61 73 65 equests, [please
1720: 20 66 69 6c 65 20 61 20 74 69 63 6b 65 74 5d 28 file a ticket](
1730: 68 74 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 https://tangents
1740: 6f 66 74 2e 63 6f 6d 2f 70 69 64 70 38 69 2f 74 oft.com/pidp8i/t
1750: 6b 74 6e 65 77 29 2e 20 57 65 20 68 61 76 65 20 ktnew). We have
1760: 6e 6f 74 20 28 79 65 74 29 20 61 62 61 6e 64 6f not (yet) abando
1770: 6e 65 64 20 77 6f 72 6b 20 6f 6e 20 74 68 69 73 ned work on this
1780: 21 0d 0a 0d 0a 54 68 65 73 65 20 64 69 73 6b 20 !....These disk
1790: 69 6d 61 67 65 20 73 68 6f 75 6c 64 20 77 6f 72 image should wor
17a0: 6b 20 75 6e 64 65 72 20 53 49 4d 48 20 6f 6e 20 k under SIMH on
17b0: 61 6e 79 20 70 6c 61 74 66 6f 72 6d 2c 20 61 6e any platform, an
17c0: 64 20 63 6f 75 6c 64 20 70 6f 74 65 6e 74 69 61 d could potentia
17d0: 6c 6c 79 20 65 76 65 6e 20 62 65 20 77 72 69 74 lly even be writ
17e0: 74 65 6e 20 62 61 63 6b 20 74 6f 20 72 65 61 6c ten back to real
17f0: 20 52 4b 30 35 20 64 69 73 6b 20 70 61 63 6b 73 RK05 disk packs
1800: 20 61 6e 64 20 72 75 6e 20 6f 6e 20 61 63 74 75 and run on actu
1810: 61 6c 20 50 44 50 2d 38 20 68 61 72 64 77 61 72 al PDP-8 hardwar
1820: 65 21 20 4c 65 74 20 75 73 20 6b 6e 6f 77 20 68 e! Let us know h
1830: 6f 77 20 79 6f 75 27 72 65 20 75 73 69 6e 67 20 ow you're using
1840: 74 68 65 73 65 20 66 69 6c 65 73 20 6f 6e 20 74 these files on t
1850: 68 65 20 5b 50 69 44 50 2d 38 2f 49 20 6d 61 69 he [PiDP-8/I mai
1860: 6c 69 6e 67 20 6c 69 73 74 5d 28 67 72 6f 75 70 ling list](group
1870: 73 2e 67 6f 6f 67 6c 65 2e 63 6f 6d 2f 66 6f 72 s.google.com/for
1880: 75 6d 2f 23 21 66 6f 72 75 6d 2f 70 69 64 70 2d um/#!forum/pidp-
1890: 38 29 3b 20 77 65 27 72 65 20 63 75 72 69 6f 75 8); we're curiou
18a0: 73 20 68 6f 77 20 66 61 72 20 74 68 65 73 65 20 s how far these
18b0: 73 70 72 65 61 64 2e 0d 0a 0d 0a 49 66 20 79 6f spread.....If yo
18c0: 75 20 77 61 6e 74 20 61 20 76 65 72 73 69 6f 6e u want a version
18d0: 20 6f 66 20 74 68 65 20 60 62 69 6e 60 20 64 69 of the `bin` di
18e0: 73 6b 20 69 6d 61 67 65 20 77 69 74 68 20 61 6e sk image with an
18f0: 79 20 6f 66 20 74 68 65 20 6f 70 74 69 6f 6e 61 y of the optiona
1900: 6c 20 5b 60 2d 2d 65 6e 61 62 6c 65 2d 6f 73 38 l [`--enable-os8
1910: 2d 2a 60 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f -*`](/doc/trunk/
1920: 52 45 41 44 4d 45 2e 6d 64 23 65 6e 61 62 6c 65 README.md#enable
1930: 2d 6f 73 38 29 20 6f 70 74 69 6f 6e 73 20 73 65 -os8) options se
1940: 74 20 6f 72 20 77 69 74 68 20 73 6f 6d 65 20 6f t or with some o
1950: 66 20 74 68 65 20 64 65 66 61 75 6c 74 2d 65 6e f the default-en
1960: 61 62 6c 65 64 20 66 65 61 74 75 72 65 73 20 73 abled features s
1970: 74 72 69 70 70 65 64 20 6f 75 74 2c 20 79 6f 75 tripped out, you
1980: 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 64 6f will have to do
1990: 77 6e 6c 6f 61 64 20 74 68 69 73 20 73 6f 66 74 wnload this soft
19a0: 77 61 72 65 2c 20 63 6f 6e 66 69 67 75 72 65 20 ware, configure
19b0: 69 74 20 61 73 20 73 75 69 74 73 20 79 6f 75 72 it as suits your
19c0: 20 6e 65 65 64 73 2c 20 61 6e 64 20 62 75 69 6c needs, and buil
19d0: 64 20 69 74 20 79 6f 75 72 73 65 6c 66 2e 20 54 d it yourself. T
19e0: 68 65 20 73 6f 66 74 77 61 72 65 20 63 75 72 72 he software curr
19f0: 65 6e 74 6c 79 20 62 75 69 6c 64 73 20 6f 6e 20 ently builds on
1a00: 5b 73 65 76 65 72 61 6c 20 64 69 66 66 65 72 65 [several differe
1a10: 6e 74 20 70 6c 61 74 66 6f 72 6d 73 5d 28 2f 77 nt platforms](/w
1a20: 69 6b 69 3f 6e 61 6d 65 3d 4f 53 2b 43 6f 6d 70 iki?name=OS+Comp
1a30: 61 74 69 62 69 6c 69 74 79 29 2c 20 6e 6f 74 20 atibility), not
1a40: 6a 75 73 74 20 74 68 65 20 52 61 73 70 62 65 72 just the Raspber
1a50: 72 79 20 50 69 2e 0d 0a 0d 0a 0d 0a 23 20 3c 61 ry Pi.......# <a
1a60: 20 6e 61 6d 65 3d 22 6c 65 61 72 6e 69 6e 67 22 name="learning"
1a70: 3e 3c 2f 61 3e 4c 65 61 72 6e 69 6e 67 20 4d 6f ></a>Learning Mo
1a80: 72 65 0d 0a 0d 0a 23 23 23 20 3c 61 20 6e 61 6d re....### <a nam
1a90: 65 3d 22 75 70 73 74 72 65 61 6d 22 3e 3c 2f 61 e="upstream"></a
1aa0: 3e 4f 66 66 69 63 69 61 6c 20 50 72 6f 6a 65 63 >Official Projec
1ab0: 74 20 52 65 73 6f 75 72 63 65 73 0d 0a 0d 0a 4d t Resources....M
1ac0: 75 63 68 20 6f 66 20 74 68 65 20 69 6e 66 6f 72 uch of the infor
1ad0: 6d 61 74 69 6f 6e 20 6f 6e 20 4f 73 63 61 72 20 mation on Oscar
1ae0: 56 65 72 6d 65 75 6c 65 6e 27 73 20 5b 50 69 44 Vermeulen's [PiD
1af0: 50 2d 38 2f 49 20 70 72 6f 6a 65 63 74 20 73 69 P-8/I project si
1b00: 74 65 5d 28 68 74 74 70 3a 2f 2f 6f 62 73 6f 6c te](http://obsol
1b10: 65 73 63 65 6e 63 65 2e 77 69 78 73 69 74 65 2e escence.wixsite.
1b20: 63 6f 6d 2f 6f 62 73 6f 6c 65 73 63 65 6e 63 65 com/obsolescence
1b30: 2f 70 69 64 70 2d 38 29 20 73 74 69 6c 6c 20 61 /pidp-8) still a
1b40: 70 70 6c 69 65 73 20 74 6f 20 74 68 69 73 20 64 pplies to this d
1b50: 69 73 74 72 69 62 75 74 69 6f 6e 20 6f 66 20 74 istribution of t
1b60: 68 65 20 73 6f 66 74 77 61 72 65 20 66 6f 72 20 he software for
1b70: 74 68 65 20 50 69 44 50 2d 38 2f 49 2e 0d 0a 0d the PiDP-8/I....
1b80: 0a 54 68 65 20 5b 6d 61 69 6e 20 64 69 66 66 65 .The [main diffe
1b90: 72 65 6e 63 65 73 5d 28 2f 77 69 6b 69 3f 6e 61 rences](/wiki?na
1ba0: 6d 65 3d 4d 61 6a 6f 72 2b 44 69 66 66 65 72 65 me=Major+Differe
1bb0: 6e 63 65 73 29 20 6c 61 72 67 65 6c 79 20 62 6f nces) largely bo
1bc0: 69 6c 20 64 6f 77 6e 20 74 6f 20 66 69 6c 65 20 il down to file
1bd0: 6e 61 6d 65 20 63 68 61 6e 67 65 73 2e 20 46 6f name changes. Fo
1be0: 72 20 65 78 61 6d 70 6c 65 2c 20 69 6e 20 4f 73 r example, in Os
1bf0: 63 61 72 27 73 20 61 72 74 69 63 6c 65 20 22 5b car's article "[
1c00: 48 6f 77 20 74 6f 20 75 73 65 20 74 68 65 20 50 How to use the P
1c10: 69 44 50 2d 38 2f 49 5d 28 68 74 74 70 3a 2f 2f iDP-8/I](http://
1c20: 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2e 77 69 78 obsolescence.wix
1c30: 73 69 74 65 2e 63 6f 6d 2f 6f 62 73 6f 6c 65 73 site.com/obsoles
1c40: 63 65 6e 63 65 2f 68 6f 77 2d 74 6f 2d 75 73 65 cence/how-to-use
1c50: 2d 74 68 65 2d 70 69 64 70 2d 38 29 2c 22 20 74 -the-pidp-8)," t
1c60: 68 65 20 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e he only differen
1c70: 63 65 20 49 20 73 65 65 20 69 6e 20 61 20 71 75 ce I see in a qu
1c80: 69 63 6b 20 73 6b 69 6d 20 69 73 20 74 68 61 74 ick skim is that
1c90: 20 79 6f 75 20 6e 6f 77 20 68 61 76 65 20 74 6f you now have to
1ca0: 20 74 79 70 65 20 60 70 64 70 38 69 60 20 61 74 type `pdp8i` at
1cb0: 20 74 68 65 20 52 61 73 70 62 69 61 6e 20 63 6f the Raspbian co
1cc0: 6d 6d 61 6e 64 20 6c 69 6e 65 20 74 6f 20 61 74 mmand line to at
1cd0: 74 61 63 68 20 79 6f 75 72 20 74 65 72 6d 69 6e tach your termin
1ce0: 61 6c 20 74 6f 20 74 68 65 20 50 69 44 50 2d 38 al to the PiDP-8
1cf0: 2f 49 20 73 69 6d 75 6c 61 74 6f 72 20 72 61 74 /I simulator rat
1d00: 68 65 72 20 74 68 61 6e 20 60 70 64 70 2e 73 68 her than `pdp.sh
1d10: 60 2e 0d 0a 0d 0a 59 6f 75 20 61 72 65 20 61 6c `.....You are al
1d20: 73 6f 20 77 65 6c 63 6f 6d 65 20 74 6f 20 64 69 so welcome to di
1d30: 73 63 75 73 73 20 74 68 69 73 20 76 65 72 73 69 scuss this versi
1d40: 6f 6e 20 6f 66 20 74 68 65 20 50 69 44 50 2d 38 on of the PiDP-8
1d50: 2f 49 20 73 6f 66 74 77 61 72 65 20 6f 6e 20 5b /I software on [
1d60: 74 68 65 20 50 69 44 50 2d 38 2f 49 20 6d 61 69 the PiDP-8/I mai
1d70: 6c 69 6e 67 20 6c 69 73 74 5d 28 67 72 6f 75 70 ling list](group
1d80: 73 2e 67 6f 6f 67 6c 65 2e 63 6f 6d 2f 66 6f 72 s.google.com/for
1d90: 75 6d 2f 23 21 66 6f 72 75 6d 2f 70 69 64 70 2d um/#!forum/pidp-
1da0: 38 29 2c 20 68 6f 73 74 65 64 20 62 79 20 47 6f 8), hosted by Go
1db0: 6f 67 6c 65 20 47 72 6f 75 70 73 2e 20 54 68 6f ogle Groups. Tho
1dc0: 73 65 20 61 63 74 69 76 65 20 69 6e 20 69 74 73 se active in its
1dd0: 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 70 61 72 development par
1de0: 74 69 63 69 70 61 74 65 20 74 68 65 72 65 20 61 ticipate there a
1df0: 6e 64 20 75 73 75 61 6c 6c 79 20 72 65 61 63 74 nd usually react
1e00: 20 74 6f 20 70 6f 73 74 73 20 61 62 6f 75 74 20 to posts about
1e10: 74 68 69 73 20 73 6f 66 74 77 61 72 65 20 71 75 this software qu
1e20: 69 63 6b 6c 79 2e 0d 0a 0d 0a 0d 0a 23 23 23 20 ickly.......###
1e30: 3c 61 20 6e 61 6d 65 3d 22 70 64 6f 63 22 3e 3c <a name="pdoc"><
1e40: 2f 61 3e 50 72 6f 6a 65 63 74 20 44 6f 63 75 6d /a>Project Docum
1e50: 65 6e 74 61 74 69 6f 6e 0d 0a 0d 0a 54 68 69 73 entation....This
1e60: 20 73 6f 66 74 77 61 72 65 20 70 72 6f 6a 65 63 software projec
1e70: 74 20 68 61 73 20 69 74 73 20 6f 77 6e 20 64 6f t has its own do
1e80: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 cumentation and
1e90: 74 75 74 6f 72 69 61 6c 73 2c 20 77 68 69 63 68 tutorials, which
1ea0: 20 49 27 76 65 20 63 6f 6c 6c 65 63 74 65 64 20 I've collected
1eb0: 68 65 72 65 20 66 6f 72 20 63 6f 6e 76 65 6e 69 here for conveni
1ec0: 65 6e 63 65 3a 0d 0a 0d 0a 2a 20 20 20 5b 54 68 ence:....* [Th
1ed0: 65 20 74 6f 70 2d 6c 65 76 65 6c 20 52 45 41 44 e top-level READ
1ee0: 4d 45 20 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 ME file](/doc/tr
1ef0: 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 29 20 74 unk/README.md) t
1f00: 65 6c 6c 73 20 68 6f 77 20 74 6f 20 63 6f 6e 66 ells how to conf
1f10: 69 67 75 72 65 2c 20 62 75 69 6c 64 2c 20 61 6e igure, build, an
1f20: 64 20 73 74 61 72 74 20 75 73 69 6e 67 20 74 68 d start using th
1f30: 65 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 e PiDP-8/I softw
1f40: 61 72 65 2e 20 49 74 20 69 73 20 6e 6f 74 20 6d are. It is not m
1f50: 65 61 6e 74 20 74 6f 20 72 65 70 6c 61 63 65 20 eant to replace
1f60: 74 68 65 20 6f 74 68 65 72 20 72 65 73 6f 75 72 the other resour
1f70: 63 65 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 6f ces available, o
1f80: 6e 6c 79 20 74 6f 20 67 69 76 65 20 61 20 66 61 nly to give a fa
1f90: 73 74 2d 74 72 61 63 6b 20 67 75 69 64 65 20 74 st-track guide t
1fa0: 6f 20 73 6f 6d 65 6f 6e 65 20 67 65 74 74 69 6e o someone gettin
1fb0: 67 20 73 74 61 72 74 65 64 2e 20 54 68 65 20 70 g started. The p
1fc0: 72 69 6d 61 72 79 20 62 69 74 20 6f 66 20 75 6e rimary bit of un
1fd0: 69 71 75 65 20 69 6e 66 6f 20 69 74 20 70 72 65 ique info it pre
1fe0: 73 65 6e 74 73 20 69 73 20 64 6f 63 75 6d 65 6e sents is documen
1ff0: 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 60 63 tation of the `c
2000: 6f 6e 66 69 67 75 72 65 60 20 73 63 72 69 70 74 onfigure` script
2010: 20 66 6c 61 67 73 2e 0d 0a 0d 0a 2a 20 20 20 4f flags.....* O
2020: 6e 65 20 6f 66 20 74 68 6f 73 65 20 60 63 6f 6e ne of those `con
2030: 66 69 67 75 72 65 60 20 73 63 72 69 70 74 20 66 figure` script f
2040: 6c 61 67 73 20 69 73 20 63 6f 6d 70 6c 69 63 61 lags is complica
2050: 74 65 64 20 65 6e 6f 75 67 68 20 74 6f 20 64 65 ted enough to de
2060: 73 65 72 76 65 20 69 74 73 20 6f 77 6e 20 64 6f serve its own do
2070: 63 75 6d 65 6e 74 2c 20 5b 60 2d 2d 74 68 72 6f cument, [`--thro
2080: 74 74 6c 65 60 5d 28 2f 64 6f 63 2f 74 72 75 6e ttle`](/doc/trun
2090: 6b 2f 52 45 41 44 4d 45 2d 74 68 72 6f 74 74 6c k/README-throttl
20a0: 65 2e 6d 64 29 2e 0d 0a 0d 0a 2a 20 20 20 54 68 e.md).....* Th
20b0: 65 20 5b 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 e [installation
20c0: 69 6e 73 74 72 75 63 74 69 6f 6e 73 5d 28 2f 64 instructions](/d
20d0: 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f 4f 53 2d oc/trunk/doc/OS-
20e0: 69 6d 61 67 65 73 2e 6d 64 29 20 65 78 70 6c 61 images.md) expla
20f0: 69 6e 20 68 6f 77 20 74 6f 20 69 6e 73 74 61 6c in how to instal
2100: 6c 20 74 68 65 20 5b 62 69 6e 61 72 79 20 4f 53 l the [binary OS
2110: 20 69 6d 61 67 65 73 5d 28 23 62 6f 73 69 29 20 images](#bosi)
2120: 74 6f 20 61 6e 20 53 44 20 63 61 72 64 20 61 6e to an SD card an
2130: 64 20 67 65 74 20 73 74 61 72 74 65 64 20 77 69 d get started wi
2140: 74 68 20 69 74 2e 0d 0a 0d 0a 2a 20 20 20 57 68 th it.....* Wh
2150: 69 6c 65 20 62 75 69 6c 64 69 6e 67 20 79 6f 75 ile building you
2160: 72 20 50 69 44 50 2d 38 2f 49 2c 20 79 6f 75 20 r PiDP-8/I, you
2170: 6d 61 79 20 72 75 6e 20 69 6e 74 6f 20 73 6f 6d may run into som
2180: 65 20 74 72 6f 75 62 6c 65 20 77 68 69 63 68 20 e trouble which
2190: 63 61 6e 20 62 65 20 64 69 61 67 6e 6f 73 65 64 can be diagnosed
21a0: 20 62 79 20 74 68 65 20 60 70 69 64 70 38 69 2d by the `pidp8i-
21b0: 74 65 73 74 60 20 70 72 6f 67 72 61 6d 20 73 68 test` program sh
21c0: 69 70 70 65 64 20 77 69 74 68 20 74 68 65 20 73 ipped with the s
21d0: 6f 66 74 77 61 72 65 20 64 69 73 74 72 69 62 75 oftware distribu
21e0: 74 69 6f 6e 20 61 6e 64 20 5b 64 6f 63 75 6d 65 tion and [docume
21f0: 6e 74 65 64 20 68 65 72 65 5d 28 2f 64 6f 63 2f nted here](/doc/
2200: 74 72 75 6e 6b 2f 64 6f 63 2f 70 69 64 70 38 69 trunk/doc/pidp8i
2210: 2d 74 65 73 74 2e 6d 64 29 2e 0d 0a 0d 0a 2a 20 -test.md).....*
2220: 20 20 5b 54 68 65 20 70 72 6f 6a 65 63 74 20 77 [The project w
2230: 69 6b 69 5d 28 2f 77 63 6f 6e 74 65 6e 74 29 20 iki](/wcontent)
2240: 63 6f 6e 74 61 69 6e 73 20 73 65 76 65 72 61 6c contains several
2250: 20 74 75 74 6f 72 69 61 6c 73 2c 20 64 65 73 69 tutorials, desi
2260: 67 6e 20 64 6f 63 75 6d 65 6e 74 73 2c 20 65 74 gn documents, et
2270: 63 2e 0d 0a 0d 0a 2a 20 20 20 54 68 65 20 70 72 c.....* The pr
2280: 6f 6a 65 63 74 20 73 68 69 70 73 20 5b 73 65 76 oject ships [sev
2290: 65 72 61 6c 20 65 78 61 6d 70 6c 65 20 70 72 6f eral example pro
22a0: 67 72 61 6d 73 5d 28 2f 66 69 6c 65 2f 65 78 61 grams](/file/exa
22b0: 6d 70 6c 65 73 29 20 66 6f 72 20 74 68 6f 73 65 mples) for those
22c0: 20 77 68 6f 20 77 61 6e 74 20 74 6f 20 6c 65 61 who want to lea
22d0: 72 6e 20 74 6f 20 70 72 6f 67 72 61 6d 20 74 68 rn to program th
22e0: 65 20 50 44 50 2d 38 2e 20 54 68 69 73 20 69 73 e PDP-8. This is
22f0: 20 6e 6f 74 20 6d 65 61 6e 74 20 74 6f 20 62 65 not meant to be
2300: 20 61 20 63 6f 6d 70 72 65 68 65 6e 73 69 76 65 a comprehensive
2310: 20 74 75 74 6f 72 69 61 6c 2c 20 62 75 74 20 6d tutorial, but m
2320: 6f 72 65 20 74 6f 20 68 65 6c 70 20 79 6f 75 20 ore to help you
2330: 62 72 69 64 67 65 20 74 68 65 20 67 61 70 20 69 bridge the gap i
2340: 6e 20 6d 61 74 65 72 69 61 6c 20 6d 65 61 6e 74 n material meant
2350: 20 66 6f 72 20 61 20 72 65 61 6c 20 50 44 50 2d for a real PDP-
2360: 38 2c 20 77 68 69 63 68 20 77 6f 6e 27 74 20 74 8, which won't t
2370: 61 6c 6b 20 61 62 6f 75 74 20 74 68 65 20 73 75 alk about the su
2380: 70 65 72 69 6f 72 20 6d 65 74 68 6f 64 73 20 77 perior methods w
2390: 65 20 68 61 76 65 20 66 6f 72 20 70 72 6f 67 72 e have for progr
23a0: 61 6d 20 69 6e 70 75 74 20 6e 6f 77 3a 20 53 49 am input now: SI
23b0: 4d 48 20 62 6f 6f 74 20 73 63 72 69 70 74 73 2c MH boot scripts,
23c0: 20 63 6f 70 79 2d 70 61 73 74 65 20 76 69 61 20 copy-paste via
23d0: 53 53 48 2c 20 65 74 63 2e 0d 0a 0d 0a 2a 20 20 SSH, etc.....*
23e0: 20 20 57 65 20 73 68 69 70 20 61 20 50 79 74 68 We ship a Pyth
23f0: 6f 6e 20 63 6c 61 73 73 20 63 61 6c 6c 65 64 20 on class called
2400: 60 73 69 6d 68 60 20 66 6f 72 20 63 6f 6e 74 72 `simh` for contr
2410: 6f 6c 6c 69 6e 67 20 53 49 4d 48 20 61 6e 64 20 olling SIMH and
2420: 4f 53 2f 38 20 72 75 6e 6e 69 6e 67 20 75 6e 64 OS/8 running und
2430: 65 72 20 53 49 4d 48 20 66 72 6f 6d 20 74 68 65 er SIMH from the
2440: 20 68 6f 73 74 20 73 79 73 74 65 6d 2e 20 53 65 host system. Se
2450: 65 20 5b 69 74 73 20 74 75 74 6f 72 69 61 6c 5d e [its tutorial]
2460: 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f (/doc/trunk/doc/
2470: 63 6c 61 73 73 2d 73 69 6d 68 2e 6d 64 29 2e 0d class-simh.md)..
2480: 0a 0d 0a 2a 20 20 20 54 68 65 72 65 20 69 73 20 ...* There is
2490: 5b 61 20 74 75 74 6f 72 69 61 6c 20 66 6f 72 20 [a tutorial for
24a0: 74 68 65 20 44 43 50 20 64 69 73 61 73 73 65 6d the DCP disassem
24b0: 62 6c 65 72 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b bler](/doc/trunk
24c0: 2f 64 6f 63 2f 64 63 70 5f 77 75 2e 6d 64 29 20 /doc/dcp_wu.md)
24d0: 69 6e 73 74 61 6c 6c 65 64 20 6f 6e 20 74 68 65 installed on the
24e0: 20 4f 53 2f 38 20 64 69 73 6b 20 70 61 63 6b 73 OS/8 disk packs
24f0: 20 62 79 20 64 65 66 61 75 6c 74 2e 0d 0a 0d 0a by default.....
2500: 2a 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 * The default
2510: 4f 53 2f 38 20 62 6f 6f 74 20 64 69 73 6b 20 69 OS/8 boot disk i
2520: 6e 20 74 68 65 20 64 69 73 74 72 69 62 75 74 69 n the distributi
2530: 6f 6e 20 68 61 73 20 5b 6d 61 6e 79 20 70 61 74 on has [many pat
2540: 63 68 65 73 20 61 70 70 6c 69 65 64 5d 28 2f 64 ches applied](/d
2550: 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f 6f 73 38 oc/trunk/doc/os8
2560: 2d 70 61 74 63 68 69 6e 67 2e 6d 64 29 2c 20 77 -patching.md), w
2570: 68 69 63 68 20 61 72 65 20 64 65 73 63 72 69 62 hich are describ
2580: 65 64 20 69 6e 20 74 68 65 20 6c 69 6e 6b 65 64 ed in the linked
2590: 20 64 6f 63 75 6d 65 6e 74 2c 20 61 6c 6f 6e 67 document, along
25a0: 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f with informatio
25b0: 6e 20 61 62 6f 75 74 20 74 68 65 20 44 45 43 20 n about the DEC
25c0: 70 61 74 63 68 65 73 20 77 65 20 68 61 76 65 20 patches we have
25d0: 63 68 6f 73 65 6e 20 2a 6e 6f 74 2a 20 74 6f 20 chosen *not* to
25e0: 61 70 70 6c 79 2e 0d 0a 0d 0a 2a 20 20 20 54 68 apply.....* Th
25f0: 65 72 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 ere are several
2600: 64 6f 63 75 6d 65 6e 74 73 20 61 62 6f 75 74 20 documents about
2610: 74 68 65 20 55 2f 57 20 46 4f 43 41 4c 20 56 34 the U/W FOCAL V4
2620: 45 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 69 E distribution i
2630: 6e 63 6c 75 64 65 64 20 6f 6e 20 74 68 65 20 73 ncluded on the s
2640: 74 61 6e 64 61 72 64 20 4f 53 2f 38 20 62 6f 6f tandard OS/8 boo
2650: 74 20 64 69 73 6b 2c 20 77 68 69 63 68 20 79 6f t disk, which yo
2660: 75 20 63 61 6e 20 66 69 6e 64 20 62 79 20 73 74 u can find by st
2670: 61 72 74 69 6e 67 20 77 69 74 68 20 6f 75 72 20 arting with our
2680: 5b 55 2f 57 20 46 4f 43 41 4c 20 6d 61 6e 75 61 [U/W FOCAL manua
2690: 6c 20 73 75 70 70 6c 65 6d 65 6e 74 5d 28 2f 64 l supplement](/d
26a0: 6f 63 2f 74 72 75 6e 6b 2f 64 6f 63 2f 75 77 66 oc/trunk/doc/uwf
26b0: 6f 63 61 6c 2d 6d 61 6e 75 61 6c 2d 73 75 70 70 ocal-manual-supp
26c0: 2e 6d 64 29 2e 0d 0a 0d 0a 2a 20 20 20 49 66 20 .md).....* If
26d0: 79 6f 75 20 77 61 6e 74 20 74 6f 20 6b 6e 6f 77 you want to know
26e0: 20 77 68 61 74 20 68 61 73 20 63 68 61 6e 67 65 what has change
26f0: 64 20 69 6e 20 74 68 65 20 73 6f 66 74 77 61 72 d in the softwar
2700: 65 20 73 69 6e 63 65 20 4f 73 63 61 72 20 56 65 e since Oscar Ve
2710: 72 6d 65 75 6c 65 6e 27 73 20 6c 61 73 74 20 72 rmeulen's last r
2720: 65 6c 65 61 73 65 20 6f 6e 20 32 30 31 35 2e 31 elease on 2015.1
2730: 32 2e 31 35 2c 20 73 65 65 20 5b 74 68 65 20 43 2.15, see [the C
2740: 68 61 6e 67 65 4c 6f 67 5d 28 2f 64 6f 63 2f 74 hangeLog](/doc/t
2750: 72 75 6e 6b 2f 43 68 61 6e 67 65 4c 6f 67 2e 6d runk/ChangeLog.m
2760: 64 29 2e 0d 0a 0d 0a 2a 20 20 20 20 49 66 20 79 d).....* If y
2770: 6f 75 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f ou would like to
2780: 20 68 65 6c 70 20 63 6f 6e 74 72 69 62 75 74 65 help contribute
2790: 20 74 6f 20 74 68 65 20 64 65 76 65 6c 6f 70 6d to the developm
27a0: 65 6e 74 20 6f 66 20 74 68 65 20 50 69 44 50 2d ent of the PiDP-
27b0: 38 2f 49 20 73 6f 66 74 77 61 72 65 20 70 72 6f 8/I software pro
27c0: 6a 65 63 74 2c 20 73 65 65 20 22 5b 48 61 63 6b ject, see "[Hack
27d0: 69 6e 67 20 6f 6e 20 74 68 65 20 50 69 44 50 2d ing on the PiDP-
27e0: 38 2f 49 20 53 6f 66 74 77 61 72 65 5d 28 2f 64 8/I Software](/d
27f0: 6f 63 2f 74 72 75 6e 6b 2f 48 41 43 4b 45 52 53 oc/trunk/HACKERS
2800: 2e 6d 64 29 22 2e 0d 0a 0d 0a 2a 20 20 20 54 68 .md)".....* Th
2810: 65 20 4b 69 43 61 64 20 5b 50 69 44 50 2d 38 2f e KiCad [PiDP-8/
2820: 49 20 66 72 6f 6e 74 20 70 61 6e 65 6c 20 73 63 I front panel sc
2830: 68 65 6d 61 74 69 63 5d 28 2f 64 6f 63 2f 74 72 hematic](/doc/tr
2840: 75 6e 6b 2f 68 61 72 64 77 61 72 65 2f 70 64 70 unk/hardware/pdp
2850: 38 69 2f 73 63 68 65 6d 61 74 69 63 2e 70 64 66 8i/schematic.pdf
2860: 29 20 77 61 73 20 63 6f 6e 76 65 72 74 65 64 20 ) was converted
2870: 74 6f 20 50 44 46 20 62 79 20 54 6f 6e 79 20 48 to PDF by Tony H
2880: 69 6c 6c 2e 20 28 34 30 30 20 6b 42 29 0d 0a 0d ill. (400 kB)...
2890: 0a 2a 20 20 20 41 72 65 20 79 6f 75 20 77 6f 6e .* Are you won
28a0: 64 65 72 69 6e 67 20 77 68 6f 20 62 72 6f 75 67 dering who broug
28b0: 68 74 20 61 6c 6c 20 6f 66 20 74 68 69 73 20 73 ht all of this s
28c0: 6f 66 74 77 61 72 65 2c 20 68 61 72 64 77 61 72 oftware, hardwar
28d0: 65 2c 20 61 6e 64 20 64 6f 63 75 6d 65 6e 74 61 e, and documenta
28e0: 74 69 6f 6e 20 74 6f 20 79 6f 75 3f 20 54 68 61 tion to you? Tha
28f0: 74 20 69 73 20 73 75 6d 6d 61 72 69 7a 65 64 20 t is summarized
2900: 69 6e 20 74 68 65 20 70 72 6f 6a 65 63 74 27 73 in the project's
2910: 20 5b 61 75 74 68 6f 72 73 20 66 69 6c 65 5d 28 [authors file](
2920: 2f 64 6f 63 2f 74 72 75 6e 6b 2f 41 55 54 48 4f /doc/trunk/AUTHO
2930: 52 53 2e 6d 64 29 2e 20 54 68 6f 73 65 20 70 69 RS.md). Those pi
2940: 65 63 65 73 20 61 72 65 20 69 6e 63 6c 75 64 65 eces are include
2950: 64 20 77 69 74 68 20 74 68 65 20 70 72 6f 6a 65 d with the proje
2960: 63 74 20 75 6e 64 65 72 20 5b 61 20 76 61 72 69 ct under [a vari
2970: 65 74 79 20 6f 66 20 6c 69 63 65 6e 73 65 73 5d ety of licenses]
2980: 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 43 4f 50 59 (/doc/trunk/COPY
2990: 49 4e 47 2e 6d 64 29 2e 0d 0a 0d 0a 0d 0a 23 23 ING.md).......##
29a0: 23 20 3c 61 20 6e 61 6d 65 3d 22 73 64 6f 63 22 # <a name="sdoc"
29b0: 3e 3c 2f 61 3e 53 49 4d 48 20 44 6f 63 75 6d 65 ></a>SIMH Docume
29c0: 6e 74 61 74 69 6f 6e 0d 0a 0d 0a 54 68 65 20 50 ntation....The P
29d0: 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 iDP-8/I software
29e0: 20 70 72 6f 6a 65 63 74 20 69 73 20 62 61 73 65 project is base
29f0: 64 20 6f 6e 20 5b 74 68 65 20 61 63 74 69 76 65 d on [the active
2a00: 6c 79 2d 64 65 76 65 6c 6f 70 65 64 20 76 65 72 ly-developed ver
2a10: 73 69 6f 6e 20 6f 66 20 53 49 4d 48 5d 28 68 74 sion of SIMH](ht
2a20: 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d tps://github.com
2a30: 2f 73 69 6d 68 2f 73 69 6d 68 29 2e 20 28 41 73 /simh/simh). (As
2a40: 20 6f 70 70 6f 73 65 64 20 74 6f 20 74 68 65 20 opposed to the
2a50: 5b 6f 6c 64 20 66 72 6f 7a 65 6e 20 53 49 4d 48 [old frozen SIMH
2a60: 20 33 2e 39 20 76 65 72 73 69 6f 6e 5d 28 68 74 3.9 version](ht
2a70: 74 70 3a 2f 2f 73 69 6d 68 2e 74 72 61 69 6c 69 tp://simh.traili
2a80: 6e 67 2d 65 64 67 65 2e 63 6f 6d 2f 29 20 77 68 ng-edge.com/) wh
2a90: 69 63 68 20 73 74 69 6c 6c 20 63 6f 6d 65 73 20 ich still comes
2aa0: 75 70 20 68 69 67 68 20 69 6e 20 73 65 61 72 63 up high in searc
2ab0: 68 20 72 65 73 75 6c 74 73 2e 29 20 54 68 61 74 h results.) That
2ac0: 20 70 72 6f 6a 65 63 74 20 68 61 73 20 69 74 73 project has its
2ad0: 20 6f 77 6e 20 64 6f 63 75 6d 65 6e 74 61 74 69 own documentati
2ae0: 6f 6e 2c 20 62 75 74 20 66 6f 72 20 63 6f 6e 76 on, but for conv
2af0: 65 6e 69 65 6e 63 65 20 49 27 76 65 20 70 72 6f enience I've pro
2b00: 76 69 64 65 64 20 50 44 46 20 76 65 72 73 69 6f vided PDF versio
2b10: 6e 73 20 6f 66 20 74 68 65 20 72 65 6c 65 76 61 ns of the releva
2b20: 6e 74 20 73 75 62 73 65 74 20 68 65 72 65 3a 0d nt subset here:.
2b30: 0a 0d 0a 2a 20 20 20 5b 53 49 4d 48 20 4d 61 69 ...* [SIMH Mai
2b40: 6e 20 4d 61 6e 75 61 6c 5d 28 2f 75 76 2f 64 6f n Manual](/uv/do
2b50: 63 2f 73 69 6d 68 2f 6d 61 69 6e 2e 70 64 66 29 c/simh/main.pdf)
2b60: 20 e2 80 94 20 49 66 20 79 6f 75 27 72 65 20 67 — If you're g
2b70: 6f 69 6e 67 20 74 6f 20 72 65 61 64 20 6f 72 20 oing to read or
2b80: 6d 6f 64 69 66 79 20 60 62 6f 6f 74 2f 2a 2e 73 modify `boot/*.s
2b90: 63 72 69 70 74 60 2c 20 6f 72 20 79 6f 75 20 77 cript`, or you w
2ba0: 61 6e 74 20 74 6f 20 67 69 76 65 20 63 6f 6d 6d ant to give comm
2bb0: 61 6e 64 73 20 61 74 20 74 68 65 20 60 73 69 6d ands at the `sim
2bc0: 3e 60 20 70 72 6f 6d 70 74 20 79 6f 75 20 67 65 >` prompt you ge
2bd0: 74 20 62 79 20 70 72 65 73 73 69 6e 67 20 43 74 t by pressing Ct
2be0: 72 6c 2d 45 20 66 72 6f 6d 20 77 69 74 68 69 6e rl-E from within
2bf0: 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 73 69 the PiDP-8/I si
2c00: 6d 75 6c 61 74 6f 72 2c 20 79 6f 75 20 6e 65 65 mulator, you nee
2c10: 64 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 6d d to read this m
2c20: 61 6e 75 61 6c 2e 0d 0a 0d 0a 2a 20 20 20 5b 50 anual.....* [P
2c30: 44 50 2d 38 20 53 69 6d 75 6c 61 74 6f 72 20 4d DP-8 Simulator M
2c40: 61 6e 75 61 6c 5d 28 2f 75 76 2f 64 6f 63 2f 73 anual](/uv/doc/s
2c50: 69 6d 68 2f 70 64 70 38 2e 70 64 66 29 20 e2 80 imh/pdp8.pdf) â€
2c60: 94 20 54 68 69 73 20 61 64 64 65 6e 64 75 6d 20 ” This addendum
2c70: 74 6f 20 74 68 65 20 6d 61 69 6e 20 53 49 4d 48 to the main SIMH
2c80: 20 6d 61 6e 75 61 6c 20 63 6f 76 65 72 73 20 74 manual covers t
2c90: 68 65 20 64 65 74 61 69 6c 73 20 73 70 65 63 69 he details speci
2ca0: 66 69 63 20 74 6f 20 74 68 65 20 50 44 50 2d 38 fic to the PDP-8
2cb0: 20 73 69 6d 75 6c 61 74 6f 72 2e 20 28 54 68 65 simulator. (The
2cc0: 20 6d 61 69 6e 20 6d 61 6e 75 61 6c 20 63 6f 76 main manual cov
2cd0: 65 72 73 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 ers functionalit
2ce0: 79 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 y common to all
2cf0: 6f 66 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72 of the simulator
2d00: 73 20 62 75 6e 64 6c 65 64 20 77 69 74 68 20 53 s bundled with S
2d10: 49 4d 48 2e 29 0d 0a 0d 0a 2a 20 20 20 5b 53 49 IMH.)....* [SI
2d20: 4d 48 20 46 41 51 5d 28 2f 75 76 2f 64 6f 63 2f MH FAQ](/uv/doc/
2d30: 73 69 6d 68 2f 66 61 71 2e 70 64 66 29 20 e2 80 simh/faq.pdf) â€
2d40: 94 20 46 72 65 71 75 65 6e 74 6c 79 2d 61 73 6b ” Frequently-ask
2d50: 65 64 20 71 75 65 73 74 69 6f 6e 73 20 61 62 6f ed questions abo
2d60: 75 74 20 53 49 4d 48 2e 20 28 57 69 74 68 20 61 ut SIMH. (With a
2d70: 6e 73 77 65 72 73 21 29 0d 0a 0d 0a 0d 0a 23 23 nswers!)......##
2d80: 23 20 3c 61 20 6e 61 6d 65 3d 22 72 64 6f 63 22 # <a name="rdoc"
2d90: 3e 3c 2f 61 3e 52 61 72 65 20 50 44 50 2d 38 20 ></a>Rare PDP-8
2da0: 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0d 0a 0d Documentation...
2db0: 0a 57 68 69 6c 65 20 6d 6f 73 74 20 6f 66 20 74 .While most of t
2dc0: 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 he information a
2dd0: 62 6f 75 74 20 74 68 65 20 50 44 50 2d 38 20 69 bout the PDP-8 i
2de0: 73 20 77 69 64 65 6c 79 20 61 76 61 69 6c 61 62 s widely availab
2df0: 6c 65 20 6f 6e 20 74 68 65 20 49 6e 74 65 72 6e le on the Intern
2e00: 65 74 20 61 6e 64 20 6d 61 79 20 74 68 75 73 20 et and may thus
2e10: 62 65 20 65 61 73 69 6c 79 20 66 6f 75 6e 64 20 be easily found
2e20: 5b 62 79 20 47 6f 6f 67 6c 69 6e 67 5d 28 68 74 [by Googling](ht
2e30: 74 70 73 3a 2f 2f 77 77 77 2e 67 6f 6f 67 6c 65 tps://www.google
2e40: 2e 63 6f 6d 2f 73 65 61 72 63 68 3f 71 3d 70 64 .com/search?q=pd
2e50: 70 2d 38 29 2c 20 77 65 20 68 61 76 65 20 61 20 p-8), we have a
2e60: 73 6d 61 6c 6c 20 6e 75 6d 62 65 72 20 6f 66 20 small number of
2e70: 64 6f 63 75 6d 65 6e 74 73 20 68 65 72 65 20 74 documents here t
2e80: 68 61 74 20 61 72 65 20 6e 6f 74 20 73 6f 20 65 hat are not so e
2e90: 61 73 79 20 74 6f 20 63 6f 6d 65 20 62 79 2c 20 asy to come by,
2ea0: 70 6c 75 73 20 73 6f 6d 65 20 6c 69 6e 6b 73 20 plus some links
2eb0: 74 68 61 74 20 64 6f 6e 27 74 20 73 65 65 6d 20 that don't seem
2ec0: 74 6f 20 63 6f 6d 65 20 75 70 20 61 73 20 68 69 to come up as hi
2ed0: 67 68 20 69 6e 20 47 6f 6f 67 6c 65 20 73 65 61 gh in Google sea
2ee0: 72 63 68 65 73 20 61 73 20 74 68 65 79 20 6f 75 rches as they ou
2ef0: 67 68 74 20 74 6f 3a 0d 0a 0d 0a 2a 20 20 20 44 ght to:....* D
2f00: 45 43 27 73 20 31 39 36 39 20 65 64 69 74 69 6f EC's 1969 editio
2f10: 6e 20 5b 53 79 73 74 65 6d 20 55 73 65 72 27 73 n [System User's
2f20: 20 47 75 69 64 65 5d 28 2f 75 76 2f 64 6f 63 2f Guide](/uv/doc/
2f30: 70 64 70 38 69 2d 73 75 67 2e 70 64 66 29 20 66 pdp8i-sug.pdf) f
2f40: 6f 72 20 74 68 65 20 50 44 50 2d 38 20 66 61 6d or the PDP-8 fam
2f50: 69 6c 79 20 63 6f 6d 70 75 74 65 72 73 2c 20 74 ily computers, t
2f60: 68 65 20 70 69 6e 6e 61 63 6c 65 20 6f 66 20 77 he pinnacle of w
2f70: 68 69 63 68 20 77 61 73 20 74 68 65 20 50 44 50 hich was the PDP
2f80: 2d 38 2f 49 20 61 74 20 74 68 61 74 20 74 69 6d -8/I at that tim
2f90: 65 2e 20 44 45 43 20 70 75 62 6c 69 73 68 65 64 e. DEC published
2fa0: 20 6d 61 6e 79 20 65 64 69 74 69 6f 6e 73 20 6f many editions o
2fb0: 66 20 74 68 69 73 20 67 75 69 64 65 2c 20 61 6e f this guide, an
2fc0: 64 20 74 68 65 20 6e 65 77 65 72 20 76 65 72 73 d the newer vers
2fd0: 69 6f 6e 73 20 63 6f 6d 65 20 75 70 20 66 61 72 ions come up far
2fe0: 20 6d 6f 72 65 20 66 72 65 71 75 65 6e 74 6c 79 more frequently
2ff0: 20 69 6e 20 77 65 62 20 73 65 61 72 63 68 65 73 in web searches
3000: 2c 20 62 75 74 20 74 68 65 79 27 72 65 20 6f 66 , but they're of
3010: 74 65 6e 20 6e 6f 74 20 4f 43 52 27 64 20 28 77 ten not OCR'd (w
3020: 68 65 72 65 61 73 20 74 68 69 73 20 76 65 72 73 hereas this vers
3030: 69 6f 6e 20 69 73 29 20 61 6e 64 20 74 68 65 79 ion is) and they
3040: 20 74 65 6e 64 20 74 6f 20 66 6f 63 75 73 20 6f tend to focus o
3050: 6e 20 74 68 65 20 6e 65 77 65 72 20 50 44 50 2d n the newer PDP-
3060: 38 20 6d 6f 64 65 6c 73 20 77 68 69 63 68 20 64 8 models which d
3070: 6f 6e 27 74 20 61 70 70 6c 79 20 65 6e 74 69 72 on't apply entir
3080: 65 6c 79 20 74 6f 20 74 68 65 20 50 44 50 2d 38 ely to the PDP-8
3090: 2f 49 2e 0d 0a 0d 0a 2a 20 20 20 44 45 43 27 73 /I.....* DEC's
30a0: 20 31 39 37 33 20 5b 53 6d 61 6c 6c 20 43 6f 6d 1973 [Small Com
30b0: 70 75 74 65 72 20 48 61 6e 64 62 6f 6f 6b 5d 28 puter Handbook](
30c0: 68 74 74 70 73 3a 2f 2f 61 72 63 68 69 76 65 2e https://archive.
30d0: 6f 72 67 2f 64 65 74 61 69 6c 73 2f 62 69 74 73 org/details/bits
30e0: 61 76 65 72 73 5f 64 65 63 70 64 70 38 68 61 6e avers_decpdp8han
30f0: 48 61 6e 64 62 6f 6f 6b 31 39 37 33 5f 37 39 36 Handbook1973_796
3100: 37 31 37 31 31 29 2c 20 62 65 63 61 75 73 65 20 71711), because
3110: 77 68 65 6e 20 64 65 61 6c 69 6e 67 20 77 69 74 when dealing wit
3120: 68 20 53 49 4d 48 2c 20 79 6f 75 20 61 63 74 75 h SIMH, you actu
3130: 61 6c 6c 79 20 2a 77 61 6e 74 2a 20 64 6f 63 75 ally *want* docu
3140: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
3150: 20 6e 65 77 65 72 20 6d 6f 64 65 6c 73 20 6f 66 newer models of
3160: 20 50 44 50 2d 38 2c 20 73 69 6e 63 65 20 53 49 PDP-8, since SI
3170: 4d 48 20 73 69 6d 75 6c 61 74 65 73 20 61 20 66 MH simulates a f
3180: 61 69 72 6c 79 20 74 72 69 63 6b 65 64 2d 6f 75 airly tricked-ou
3190: 74 20 6c 61 74 65 2d 6d 6f 64 65 6c 20 50 44 50 t late-model PDP
31a0: 2d 38 3b 20 74 68 65 72 65 20 69 73 20 6e 6f 20 -8; there is no
31b0: 65 61 73 79 20 77 61 79 20 74 6f 20 72 65 73 74 easy way to rest
31c0: 72 69 63 74 20 53 49 4d 48 20 74 6f 20 73 75 70 rict SIMH to sup
31d0: 70 6f 72 74 20 6f 6e 6c 79 20 74 68 65 20 66 65 port only the fe
31e0: 61 74 75 72 65 73 20 74 68 61 74 20 65 78 69 73 atures that exis
31f0: 74 65 64 20 61 74 20 74 68 65 20 74 69 6d 65 20 ted at the time
3200: 6f 66 20 74 68 65 20 50 44 50 2d 38 2f 49 2e 20 of the PDP-8/I.
3210: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 53 49 4d For example, SIM
3220: 48 27 73 20 50 44 50 2d 38 20 73 69 6d 75 6c 61 H's PDP-8 simula
3230: 74 6f 72 20 77 69 6c 6c 20 70 72 6f 63 65 73 73 tor will process
3240: 20 5b 6d 6f 64 65 20 42 20 45 41 45 20 69 6e 73 [mode B EAE ins
3250: 74 72 75 63 74 69 6f 6e 73 5d 28 68 74 74 70 3a tructions](http:
3260: 2f 2f 68 6f 6d 65 70 61 67 65 2e 64 69 76 6d 73 //homepage.divms
3270: 2e 75 69 6f 77 61 2e 65 64 75 2f 7e 6a 6f 6e 65 .uiowa.edu/~jone
3280: 73 2f 70 64 70 38 2f 72 65 66 63 61 72 64 2f 37 s/pdp8/refcard/7
3290: 34 2e 68 74 6d 6c 29 20 69 6e 74 72 6f 64 75 63 4.html) introduc
32a0: 65 64 20 69 6e 20 74 68 65 20 50 44 50 2d 38 2f ed in the PDP-8/
32b0: 65 2c 20 77 65 6c 6c 20 61 66 74 65 72 20 74 68 e, well after th
32c0: 65 20 50 44 50 2d 38 2f 49 20 63 61 6d 65 20 6f e PDP-8/I came o
32d0: 75 74 20 77 69 74 68 20 69 74 73 20 6c 65 73 73 ut with its less
32e0: 20 66 75 6e 63 74 69 6f 6e 61 6c 20 45 41 45 20 functional EAE
32f0: 6f 70 74 69 6f 6e 2e 0d 0a 0d 0a 20 20 20 20 59 option..... Y
3300: 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 73 ou may want to s
3310: 70 6c 69 74 20 74 68 65 20 64 69 66 66 65 72 65 plit the differe
3320: 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 nce between thes
3330: 65 20 74 77 6f 20 64 6f 63 75 6d 65 6e 74 73 20 e two documents
3340: 61 6e 64 20 74 72 79 20 74 6f 20 66 69 6e 64 20 and try to find
3350: 61 20 31 39 36 38 20 65 64 69 74 69 6f 6e 20 6f a 1968 edition o
3360: 66 20 74 68 65 20 53 6d 61 6c 6c 20 43 6f 6d 70 f the Small Comp
3370: 75 74 65 72 20 48 61 6e 64 62 6f 6f 6b 2e 20 54 uter Handbook. T
3380: 68 65 20 63 6c 6f 73 65 73 74 20 49 27 6d 20 61 he closest I'm a
3390: 77 61 72 65 20 6f 66 20 6f 6e 6c 69 6e 65 20 69 ware of online i
33a0: 73 20 74 68 65 20 5b 31 39 36 37 20 65 64 69 74 s the [1967 edit
33b0: 69 6f 6e 5d 28 68 74 74 70 3a 2f 2f 62 69 74 73 ion](http://bits
33c0: 61 76 65 72 73 2e 6f 72 67 2f 70 64 66 2f 64 65 avers.org/pdf/de
33d0: 63 2f 70 64 70 38 2f 68 61 6e 64 62 6f 6f 6b 73 c/pdp8/handbooks
33e0: 2f 53 6d 61 6c 6c 43 6f 6d 70 75 74 65 72 48 61 /SmallComputerHa
33f0: 6e 64 62 6f 6f 6b 5f 36 37 2d 36 38 2e 70 64 66 ndbook_67-68.pdf
3400: 29 20 77 68 69 63 68 20 6d 65 6e 74 69 6f 6e 73 ) which mentions
3410: 20 74 68 65 20 50 44 50 2d 38 2f 49 20 69 6e 73 the PDP-8/I ins
3420: 69 64 65 2c 20 62 75 74 20 73 68 6f 77 73 20 74 ide, but shows t
3430: 68 65 20 6f 72 69 67 69 6e 61 6c 20 50 44 50 2d he original PDP-
3440: 38 20 22 53 74 72 61 69 67 68 74 20 45 69 67 68 8 "Straight Eigh
3450: 74 22 20 61 6e 64 20 61 20 50 44 50 2d 38 2f 53 t" and a PDP-8/S
3460: 20 6f 6e 20 74 68 65 20 63 6f 76 65 72 2e 20 49 on the cover. I
3470: 20 61 73 73 75 6d 65 20 69 74 20 77 61 73 20 77 assume it was w
3480: 72 69 74 74 65 6e 20 77 68 69 6c 65 20 74 68 65 ritten while the
3490: 20 50 44 50 2d 38 2f 49 20 64 65 73 69 67 6e 20 PDP-8/I design
34a0: 77 61 73 20 62 65 69 6e 67 20 66 69 6e 61 6c 69 was being finali
34b0: 7a 65 64 2c 20 73 6f 20 69 74 20 6d 61 79 20 62 zed, so it may b
34c0: 65 20 66 61 69 72 6c 79 20 61 63 63 75 72 61 74 e fairly accurat
34d0: 65 2c 20 61 6e 64 20 69 74 20 6d 61 79 20 62 65 e, and it may be
34e0: 20 66 75 6c 6c 20 6f 66 20 62 75 67 73 3b 20 49 full of bugs; I
34f0: 20 63 6f 75 6c 64 6e 27 74 20 73 61 79 2e 20 49 couldn't say. I
3500: 20 68 61 70 70 65 6e 20 74 6f 20 68 61 76 65 20 happen to have
3510: 68 65 72 65 20 61 20 70 61 70 65 72 20 63 6f 70 here a paper cop
3520: 79 20 6f 66 20 74 68 65 20 31 39 36 38 20 65 64 y of the 1968 ed
3530: 69 74 69 6f 6e 2c 20 77 68 69 63 68 20 79 6f 75 ition, which you
3540: 20 63 61 6e 20 74 65 6c 6c 20 66 72 6f 6d 20 74 can tell from t
3550: 68 65 20 31 39 36 37 20 65 64 69 74 69 6f 6e 20 he 1967 edition
3560: 62 79 20 74 68 65 20 5b 79 65 6c 6c 6f 77 2d 67 by the [yellow-g
3570: 72 65 65 6e 20 74 68 65 6d 65 64 20 63 6f 76 65 reen themed cove
3580: 72 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 64 6f r](/doc/trunk/do
3590: 63 2f 64 65 63 2d 73 63 68 2d 70 64 70 38 69 2d c/dec-sch-pdp8i-
35a0: 31 39 36 38 2e 6a 70 67 29 20 28 4a 50 45 47 2c 1968.jpg) (JPEG,
35b0: 20 34 37 33 26 6e 62 73 70 3b 6b 42 29 20 73 68 473 kB) sh
35c0: 6f 77 69 6e 67 20 74 68 65 20 73 74 61 6e 64 61 owing the standa
35d0: 72 64 20 72 61 63 6b 2d 6d 6f 75 6e 74 65 64 20 rd rack-mounted
35e0: 61 6e 64 20 72 61 72 65 20 63 6f 6e 73 6f 6c 65 and rare console
35f0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
3600: 50 44 50 2d 38 2f 49 2e 0a 5a 20 64 63 62 62 31 PDP-8/I..Z dcbb1
3610: 66 38 31 39 39 33 35 61 34 38 66 37 62 38 30 36 f819935a48f7b806
3620: 61 36 36 61 32 32 36 61 32 33 34 0a a66a226a234.