Artifact
482527ea033015c3e2e2098de6ac2eff32cab056:
Wiki page
[Major Differences] by
tangent
2018-02-22 13:35:02.
0000: 44 20 32 30 31 38 2d 30 32 2d 32 32 54 31 33 3a D 2018-02-22T13:
0010: 33 35 3a 30 32 2e 39 33 30 0a 4c 20 4d 61 6a 6f 35:02.930.L Majo
0020: 72 5c 73 44 69 66 66 65 72 65 6e 63 65 73 0a 4e r\sDifferences.N
0030: 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 6e text/x-markdown
0040: 0a 50 20 33 65 31 31 66 64 35 65 34 63 65 30 62 .P 3e11fd5e4ce0b
0050: 65 61 38 37 61 36 34 32 34 34 62 35 63 61 32 61 ea87a64244b5ca2a
0060: 64 35 66 39 61 66 30 33 30 65 33 0a 55 20 74 61 d5f9af030e3.U ta
0070: 6e 67 65 6e 74 0a 57 20 38 36 36 35 0a 23 20 4d ngent.W 8665.# M
0080: 61 6a 6f 72 20 44 69 66 66 65 72 65 6e 63 65 73 ajor Differences
0090: 20 42 65 74 77 65 65 6e 20 74 68 65 20 44 69 73 Between the Dis
00a0: 74 72 69 62 75 74 69 6f 6e 73 0d 0a 0d 0a 54 68 tributions....Th
00b0: 69 73 20 73 6f 66 74 77 61 72 65 20 62 65 67 61 is software bega
00c0: 6e 20 61 73 20 61 20 73 65 72 69 65 73 20 6f 66 n as a series of
00d0: 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 20 49 20 improvements I
00e0: 6d 61 64 65 20 74 6f 20 4f 73 63 61 72 20 56 65 made to Oscar Ve
00f0: 72 6d 65 75 6c 65 6e 27 73 20 32 30 31 35 2e 31 rmeulen's 2015.1
0100: 32 2e 31 35 20 73 6f 66 74 77 61 72 65 20 72 65 2.15 software re
0110: 6c 65 61 73 65 2e 20 46 6f 72 20 74 68 65 20 66 lease. For the f
0120: 69 72 73 74 20 73 65 76 65 72 61 6c 20 6d 6f 6e irst several mon
0130: 74 68 73 20 6f 66 20 74 68 69 73 20 73 6f 66 74 ths of this soft
0140: 77 61 72 65 20 64 69 73 74 72 69 62 75 74 69 6f ware distributio
0150: 6e 27 73 20 6c 69 66 65 74 69 6d 65 2c 20 69 74 n's lifetime, it
0160: 20 77 61 73 20 63 6f 6e 73 69 64 65 72 65 64 20 was considered
0170: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 20 74 an alternative t
0180: 6f 20 4f 73 63 61 72 27 73 20 73 74 61 62 6c 65 o Oscar's stable
0190: 20 76 65 72 73 69 6f 6e 2c 20 62 75 74 20 61 73 version, but as
01a0: 20 6f 66 20 4d 61 79 20 32 30 31 37 2c 20 4f 73 of May 2017, Os
01b0: 63 61 72 20 6e 6f 77 20 63 6f 6e 73 69 64 65 72 car now consider
01c0: 73 20 74 68 69 73 20 74 6f 20 62 65 20 74 68 65 s this to be the
01d0: 20 63 75 72 72 65 6e 74 20 73 74 61 62 6c 65 20 current stable
01e0: 76 65 72 73 69 6f 6e 2e 0d 0a 0d 0a 59 6f 75 20 version.....You
01f0: 63 61 6e 20 63 6f 6e 73 69 64 65 72 20 74 68 65 can consider the
0200: 20 72 65 73 74 20 6f 66 20 74 68 69 73 20 64 6f rest of this do
0210: 63 75 6d 65 6e 74 20 61 20 6d 69 67 72 61 74 69 cument a migrati
0220: 6f 6e 20 67 75 69 64 65 20 66 6f 72 20 75 73 65 on guide for use
0230: 72 73 20 77 68 6f 20 61 72 65 20 63 6f 6d 69 6e rs who are comin
0240: 67 20 66 72 6f 6d 20 4f 73 63 61 72 27 73 20 70 g from Oscar's p
0250: 72 69 6f 72 20 73 74 61 62 6c 65 20 72 65 6c 65 rior stable rele
0260: 61 73 65 2e 20 49 74 20 6d 61 79 20 61 6c 73 6f ase. It may also
0270: 20 62 65 20 6f 66 20 75 73 65 20 77 68 69 6c 65 be of use while
0280: 20 72 65 61 64 69 6e 67 20 74 68 72 6f 75 67 68 reading through
0290: 20 6f 6c 64 65 72 20 6d 65 73 73 61 67 65 73 20 older messages
02a0: 6f 6e 20 74 68 65 20 6d 61 69 6c 69 6e 67 20 6c on the mailing l
02b0: 69 73 74 2c 20 73 69 6e 63 65 20 74 68 65 79 20 ist, since they
02c0: 6f 66 74 65 6e 20 67 69 76 65 20 63 6f 6d 6d 61 often give comma
02d0: 6e 64 73 20 74 68 61 74 20 64 69 66 66 65 72 20 nds that differ
02e0: 75 6e 64 65 72 20 74 68 69 73 20 76 65 72 73 69 under this versi
02f0: 6f 6e 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 on of the softwa
0300: 72 65 2e 0d 0a 0d 0a 54 68 69 73 20 64 6f 63 75 re.....This docu
0310: 6d 65 6e 74 20 69 67 6e 6f 72 65 73 20 70 75 72 ment ignores pur
0320: 65 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 2c 20 e enhancements,
0330: 62 75 67 20 66 69 78 65 73 2c 20 61 6e 64 20 6f bug fixes, and o
0340: 74 68 65 72 20 74 68 69 6e 67 73 20 77 68 69 63 ther things whic
0350: 68 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 20 h do not change
0360: 68 6f 77 20 74 68 65 20 75 73 65 72 20 69 6e 74 how the user int
0370: 65 72 61 63 74 73 20 77 69 74 68 20 74 68 65 20 eracts with the
0380: 73 6f 66 74 77 61 72 65 20 66 72 6f 6d 20 74 68 software from th
0390: 69 73 20 73 69 74 65 20 61 73 20 63 6f 6d 70 61 is site as compa
03a0: 72 65 64 20 77 69 74 68 20 4f 73 63 61 72 27 73 red with Oscar's
03b0: 20 70 72 69 6f 72 20 73 74 61 62 6c 65 20 76 65 prior stable ve
03c0: 72 73 69 6f 6e 2e 20 49 66 20 79 6f 75 20 77 61 rsion. If you wa
03d0: 6e 74 20 61 20 64 65 74 61 69 6c 65 64 20 75 73 nt a detailed us
03e0: 65 72 2d 66 6f 63 75 73 65 64 20 6c 69 73 74 20 er-focused list
03f0: 6f 66 20 63 68 61 6e 67 65 73 20 73 69 6e 63 65 of changes since
0400: 20 74 68 61 74 20 76 65 72 73 69 6f 6e 2c 20 73 that version, s
0410: 65 65 20 5b 74 68 65 20 43 68 61 6e 67 65 4c 6f ee [the ChangeLo
0420: 67 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 43 68 g](/doc/trunk/Ch
0430: 61 6e 67 65 4c 6f 67 2e 6d 64 29 2e 20 46 6f 72 angeLog.md). For
0440: 20 74 68 65 20 6c 6f 77 2d 6c 65 76 65 6c 20 62 the low-level b
0450: 6c 6f 77 2d 62 79 2d 62 6c 6f 77 2c 20 73 65 65 low-by-blow, see
0460: 20 5b 74 68 65 20 70 72 6f 6a 65 63 74 20 74 69 [the project ti
0470: 6d 65 6c 69 6e 65 5d 28 2f 74 69 6d 65 6c 69 6e meline](/timelin
0480: 65 29 2e 0d 0a 0d 0a 0d 0a 3c 61 20 69 64 3d 22 e).......<a id="
0490: 62 75 69 6c 64 22 20 6e 61 6d 65 3d 22 69 6e 73 build" name="ins
04a0: 74 61 6c 6c 22 3e 3c 2f 61 3e 0d 0a 23 23 20 42 tall"></a>..## B
04b0: 75 69 6c 64 20 61 6e 64 20 49 6e 73 74 61 6c 6c uild and Install
04c0: 61 74 69 6f 6e 0d 0a 0d 0a 54 68 65 20 70 72 69 ation....The pri
04d0: 6f 72 20 73 74 61 62 6c 65 20 76 65 72 73 69 6f or stable versio
04e0: 6e 20 68 61 73 20 61 20 66 61 69 72 6c 79 20 69 n has a fairly i
04f0: 6e 76 6f 6c 76 65 64 20 6d 61 6e 75 61 6c 20 62 nvolved manual b
0500: 75 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c uild and install
0510: 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 2c 20 77 ation process, w
0520: 68 65 72 65 61 73 20 6d 79 20 76 65 72 73 69 6f hereas my versio
0530: 6e 20 69 6e 73 74 61 6c 6c 73 20 6c 69 6b 65 20 n installs like
0540: 61 6e 79 20 6f 74 68 65 72 20 4c 69 6e 75 78 20 any other Linux
0550: 73 6f 75 72 63 65 20 63 6f 64 65 20 72 65 6c 65 source code rele
0560: 61 73 65 3a 20 60 2e 2f 63 6f 6e 66 69 67 75 72 ase: `./configur
0570: 65 20 26 26 20 6d 61 6b 65 20 26 26 20 73 75 64 e && make && sud
0580: 6f 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 60 2e o make install`.
0590: 20 49 74 27 73 20 61 20 74 72 61 64 65 6f 66 66 It's a tradeoff
05a0: 3a 20 6d 79 20 76 65 72 73 69 6f 6e 20 69 73 20 : my version is
05b0: 6d 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 more complicated
05c0: 20 75 6e 64 65 72 20 74 68 65 20 68 6f 6f 64 20 under the hood
05d0: 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 65 20 6d in order to be m
05e0: 6f 72 65 20 61 75 74 6f 6d 61 74 69 63 2e 0d 0a ore automatic...
05f0: 0d 0a 54 68 69 73 20 6d 65 61 6e 73 20 61 6e 79 ..This means any
0600: 20 72 65 66 65 72 65 6e 63 65 73 20 79 6f 75 20 references you
0610: 66 69 6e 64 20 74 6f 20 60 63 64 20 73 63 61 6e find to `cd scan
0620: 73 77 69 74 63 68 20 3b 20 6d 61 6b 65 60 20 6f switch ; make` o
0630: 72 20 74 6f 20 60 73 75 64 6f 20 69 6e 73 74 61 r to `sudo insta
0640: 6c 6c 2f 70 69 64 70 38 2d 73 65 74 75 70 2d 64 ll/pidp8-setup-d
0650: 65 66 61 75 6c 74 2e 73 68 60 20 64 6f 20 6e 6f efault.sh` do no
0660: 74 20 61 70 70 6c 79 20 74 6f 20 74 68 69 73 20 t apply to this
0670: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 73 version of the s
0680: 6f 66 74 77 61 72 65 2e 0d 0a 0d 0a 0d 0a 3c 61 oftware.......<a
0690: 20 69 64 3d 22 70 61 74 68 73 22 3e 3c 2f 61 3e id="paths"></a>
06a0: 0d 0a 23 23 20 50 61 74 68 20 4e 61 6d 65 73 0d ..## Path Names.
06b0: 0a 0d 0a 54 68 69 73 20 73 6f 66 74 77 61 72 65 ...This software
06c0: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 62 75 distribution bu
06d0: 69 6c 64 73 20 61 6e 64 20 69 6e 73 74 61 6c 6c ilds and install
06e0: 73 20 73 65 76 65 72 61 6c 20 66 69 6c 65 73 20 s several files
06f0: 69 6e 20 64 69 66 66 65 72 65 6e 74 20 6c 6f 63 in different loc
0700: 61 74 69 6f 6e 73 20 74 68 61 6e 20 74 68 65 20 ations than the
0710: 70 72 69 6f 72 20 73 74 61 62 6c 65 20 76 65 72 prior stable ver
0720: 73 69 6f 6e 2e 20 54 68 65 20 6d 61 70 70 69 6e sion. The mappin
0730: 67 20 69 73 3a 0d 0a 0d 0a 50 72 69 6f 72 20 4e g is:....Prior N
0740: 61 6d 65 20 7c 20 57 68 61 74 20 49 74 20 49 73 ame | What It Is
0750: 20 7c 20 43 75 72 72 65 6e 74 20 4e 61 6d 65 0d | Current Name.
0760: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0770: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0780: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 60 70 64 70 2e 73 --------..`pdp.s
0790: 68 60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h`
07a0: 20 20 20 20 20 20 20 20 20 7c 20 73 63 72 69 70 | scrip
07b0: 74 20 74 6f 20 5b 72 65 5d 65 6e 74 65 72 20 74 t to [re]enter t
07c0: 68 65 20 73 69 6d 75 6c 61 74 6f 72 20 66 72 6f he simulator fro
07d0: 6d 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 m the command li
07e0: 6e 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ne
07f0: 20 20 20 20 20 20 20 20 7c 20 60 70 69 64 70 38 | `pidp8
0800: 69 60 0d 0a 60 70 69 64 70 38 60 20 20 20 20 20 i`..`pidp8`
0810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0820: 20 20 20 20 7c 20 6d 6f 64 69 66 69 65 64 20 53 | modified S
0830: 69 6d 48 20 73 69 6d 75 6c 61 74 6f 72 20 66 6f imH simulator fo
0840: 72 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 70 r the PiDP-8/I p
0850: 61 6e 65 6c 20 20 20 20 20 20 20 20 20 20 20 20 anel
0860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0870: 20 20 20 20 20 20 20 20 7c 20 60 70 69 64 70 38 | `pidp8
0880: 69 2d 73 69 6d 60 0d 0a 60 70 69 64 70 38 2d 74 i-sim`..`pidp8-t
0890: 65 73 74 60 20 20 20 20 20 20 20 20 20 20 20 20 est`
08a0: 20 20 20 20 20 7c 20 70 61 6e 65 6c 20 4c 45 44 | panel LED
08b0: 20 61 6e 64 20 73 77 69 74 63 68 20 74 65 73 74 and switch test
08c0: 20 70 72 6f 67 72 61 6d 20 62 79 20 50 61 75 6c program by Paul
08d0: 20 52 2e 20 42 65 72 6e 61 72 64 2c 20 70 6f 73 R. Bernard, pos
08e0: 74 65 64 20 74 6f 20 6d 61 69 6c 69 6e 67 20 6c ted to mailing l
08f0: 69 73 74 20 20 7c 20 60 70 69 64 70 38 69 2d 74 ist | `pidp8i-t
0900: 65 73 74 60 0d 0a 60 2f 65 74 63 2f 69 6e 69 74 est`..`/etc/init
0910: 2e 64 2f 70 69 64 70 38 60 20 20 20 20 20 20 20 .d/pidp8`
0920: 20 7c 20 69 6e 69 74 20 73 63 72 69 70 74 20 75 | init script u
0930: 73 65 64 20 6f 6e 20 62 6f 6f 74 20 74 6f 20 73 sed on boot to s
0940: 74 61 72 74 20 74 68 65 20 73 6f 66 74 77 61 72 tart the softwar
0950: 65 20 7c 20 60 7e 2f 2e 6c 6f 63 61 6c 2f 73 68 e | `~/.local/sh
0960: 61 72 65 2f 73 79 73 74 65 6d 64 2f 75 73 65 72 are/systemd/user
0970: 2f 70 69 64 70 38 69 2e 73 65 72 76 69 63 65 60 /pidp8i.service`
0980: 0d 0a 60 2f 6f 70 74 2f 70 69 64 70 38 60 20 20 ..`/opt/pidp8`
0990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
09a0: 20 64 65 66 61 75 6c 74 20 69 6e 73 74 61 6c 6c default install
09b0: 61 74 69 6f 6e 20 6c 6f 63 61 74 69 6f 6e 20 28 ation location (
09c0: 61 2e 6b 2e 61 2e 20 24 70 72 65 66 69 78 29 20 a.k.a. $prefix)
09d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
09e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
09f0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 60 2f | `/
0a00: 6f 70 74 2f 70 69 64 70 38 69 60 0d 0a 60 24 70 opt/pidp8i`..`$p
0a10: 72 65 66 69 78 2f 62 69 6e 2f 73 63 61 6e 73 77 refix/bin/scansw
0a20: 69 74 63 68 60 20 7c 20 68 65 6c 70 65 72 20 70 itch` | helper p
0a30: 72 6f 67 72 61 6d 20 66 6f 72 20 74 68 65 20 73 rogram for the s
0a40: 69 6d 75 6c 61 74 6f 72 20 73 74 61 72 74 75 70 imulator startup
0a50: 20 73 63 72 69 70 74 20 20 20 20 20 20 20 20 20 script
0a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0a70: 20 20 20 20 20 20 20 7c 20 60 24 70 72 65 66 69 | `$prefi
0a80: 78 2f 6c 69 62 65 78 65 63 2f 73 63 61 6e 73 77 x/libexec/scansw
0a90: 69 74 63 68 60 0d 0a 60 24 70 72 65 66 69 78 2f itch`..`$prefix/
0aa0: 62 6f 6f 74 73 63 72 69 70 74 73 60 20 20 7c 20 bootscripts` |
0ab0: 73 63 72 69 70 74 73 20 74 68 61 74 20 74 65 6c scripts that tel
0ac0: 6c 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72 20 l the simulator
0ad0: 68 6f 77 20 74 6f 20 73 74 61 72 74 20 75 70 20 how to start up
0ae0: 67 69 76 65 6e 20 64 69 66 66 65 72 65 6e 74 20 given different
0af0: 49 46 20 73 77 69 74 63 68 20 63 6f 6d 62 69 6e IF switch combin
0b00: 61 74 69 6f 6e 73 20 7c 20 60 24 70 72 65 66 69 ations | `$prefi
0b10: 78 2f 73 68 61 72 65 2f 62 6f 6f 74 60 0d 0a 60 x/share/boot`..`
0b20: 24 70 72 65 66 69 78 2f 69 6d 61 67 65 66 69 6c $prefix/imagefil
0b30: 65 73 60 20 20 20 20 7c 20 62 69 6e 61 72 79 20 es` | binary
0b40: 70 61 70 65 72 20 74 61 70 65 20 69 6d 61 67 65 paper tape image
0b50: 73 2c 20 64 69 73 6b 20 69 6d 61 67 65 73 2c 20 s, disk images,
0b60: 61 6e 64 20 73 75 63 68 20 20 20 20 20 20 20 20 and such
0b70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b80: 20 20 20 20 20 20 20 20 7c 20 60 24 70 72 65 66 | `$pref
0b90: 69 78 2f 73 68 61 72 65 2f 6d 65 64 69 61 60 0d ix/share/media`.
0ba0: 0a 0d 0a 49 20 61 64 64 65 64 20 61 6e 20 60 69 ...I added an `i
0bb0: 60 20 74 6f 20 73 6f 6d 65 20 6f 66 20 74 68 65 ` to some of the
0bc0: 73 65 20 6e 61 6d 65 73 20 66 6f 72 20 74 77 6f se names for two
0bd0: 20 72 65 61 73 6f 6e 73 3a 0d 0a 0d 0a 31 2e 20 reasons:....1.
0be0: 20 49 74 20 77 61 73 20 75 73 65 66 75 6c 20 64 It was useful d
0bf0: 75 72 69 6e 67 20 74 68 65 20 74 72 61 6e 73 69 uring the transi
0c00: 74 69 6f 6e 20 70 65 72 69 6f 64 20 73 6f 20 74 tion period so t
0c10: 68 61 74 20 5b 62 6f 74 68 20 76 65 72 73 69 6f hat [both versio
0c20: 6e 73 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 ns of the softwa
0c30: 72 65 5d 28 23 72 75 6e 6e 69 6e 67 2d 62 6f 74 re](#running-bot
0c40: 68 29 20 63 6f 75 6c 64 20 62 65 20 69 6e 73 74 h) could be inst
0c50: 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 73 61 6d alled on the sam
0c60: 65 20 73 79 73 74 65 6d 20 77 69 74 68 6f 75 74 e system without
0c70: 20 63 6f 6e 66 6c 69 63 74 73 2e 0d 0a 0d 0a 32 conflicts.....2
0c80: 2e 20 49 20 64 65 63 69 64 65 64 20 74 68 61 74 . I decided that
0c90: 20 69 74 20 77 61 73 20 75 6e 6c 69 6b 65 6c 79 it was unlikely
0ca0: 20 74 68 61 74 20 77 65 20 77 69 6c 6c 20 65 76 that we will ev
0cb0: 65 72 20 73 65 65 20 61 20 66 6f 6c 6c 6f 77 2d er see a follow-
0cc0: 6f 6e 20 70 72 6f 6a 65 63 74 20 66 6f 72 20 61 on project for a
0cd0: 20 64 69 66 66 65 72 65 6e 74 20 50 44 50 2d 38 different PDP-8
0ce0: 20 66 72 6f 6e 74 20 70 61 6e 65 6c 2c 20 6f 72 front panel, or
0cf0: 20 69 66 20 77 65 20 64 6f 2c 20 69 74 20 77 69 if we do, it wi
0d00: 6c 6c 20 62 65 20 64 69 66 66 65 72 65 6e 74 20 ll be different
0d10: 65 6e 6f 75 67 68 20 74 68 61 74 20 69 74 20 77 enough that it w
0d20: 6f 6e 27 74 20 75 73 65 20 74 68 69 73 20 73 6f on't use this so
0d30: 66 74 77 61 72 65 20 64 69 72 65 63 74 6c 79 2c ftware directly,
0d40: 20 73 6f 20 74 68 65 20 70 61 74 68 73 20 61 6e so the paths an
0d50: 64 20 70 72 6f 67 72 61 6d 20 6e 61 6d 65 73 20 d program names
0d60: 6d 69 67 68 74 20 61 73 20 77 65 6c 6c 20 62 65 might as well be
0d70: 20 6e 61 6d 65 64 20 61 66 74 65 72 20 74 68 65 named after the
0d80: 20 6f 6e 6c 79 20 68 61 72 64 77 61 72 65 20 69 only hardware i
0d90: 74 20 64 6f 65 73 20 77 6f 72 6b 20 77 69 74 68 t does work with
0da0: 2c 20 74 68 65 20 50 69 44 50 2d 38 2f 49 2e 0d , the PiDP-8/I..
0db0: 0a 0d 0a 54 68 65 20 66 69 6c 65 73 20 6e 6f 77 ...The files now
0dc0: 20 75 6e 64 65 72 20 74 68 65 20 60 73 68 61 72 under the `shar
0dd0: 65 60 20 73 75 62 64 69 72 65 63 74 6f 72 79 20 e` subdirectory
0de0: 77 65 72 65 20 6d 6f 76 65 64 20 74 6f 20 63 6f were moved to co
0df0: 6e 66 6f 72 6d 20 74 6f 20 74 68 65 20 4c 69 6e nform to the Lin
0e00: 75 78 20 46 69 6c 65 73 79 73 74 65 6d 20 48 69 ux Filesystem Hi
0e10: 65 72 61 72 63 68 79 20 53 74 61 6e 64 61 72 64 erarchy Standard
0e20: 2c 20 73 6f 20 74 68 61 74 20 65 78 70 65 72 69 , so that experi
0e30: 65 6e 63 65 64 20 4c 69 6e 75 78 20 75 73 65 72 enced Linux user
0e40: 73 20 77 6f 75 6c 64 20 62 65 20 6d 6f 72 65 20 s would be more
0e50: 6c 69 6b 65 6c 79 20 74 6f 20 67 75 65 73 73 20 likely to guess
0e60: 74 68 65 69 72 20 6c 6f 63 61 74 69 6f 6e 2e 0d their location..
0e70: 0a 0d 0a 54 68 65 20 72 65 61 73 6f 6e 20 66 6f ...The reason fo
0e80: 72 20 74 68 65 20 60 73 63 61 6e 73 77 69 74 63 r the `scanswitc
0e90: 68 60 20 72 65 6c 6f 63 61 74 69 6f 6e 20 69 73 h` relocation is
0ea0: 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 6e that there is n
0eb0: 6f 20 72 65 61 73 6f 6e 20 66 6f 72 20 65 6e 64 o reason for end
0ec0: 20 75 73 65 72 73 20 74 6f 20 72 75 6e 20 69 74 users to run it
0ed0: 20 64 69 72 65 63 74 6c 79 2c 20 73 6f 20 69 74 directly, so it
0ee0: 27 73 20 62 65 74 74 65 72 20 6f 66 66 20 6f 75 's better off ou
0ef0: 74 20 6f 66 20 74 68 65 20 75 73 65 72 27 73 20 t of the user's
0f00: 60 50 41 54 48 60 2e 20 54 68 61 74 20 69 73 20 `PATH`. That is
0f10: 61 6c 73 6f 20 77 68 79 20 49 20 68 61 76 65 6e also why I haven
0f20: 27 74 20 62 6f 74 68 65 72 65 64 20 74 6f 20 72 't bothered to r
0f30: 65 6e 61 6d 65 20 69 74 20 74 6f 20 73 6f 6d 65 ename it to some
0f40: 74 68 69 6e 67 20 6c 69 6b 65 20 60 70 69 64 70 thing like `pidp
0f50: 38 69 2d 73 63 61 6e 73 77 69 74 63 68 60 2e 20 8i-scanswitch`.
0f60: 54 68 65 72 65 20 69 73 20 61 20 5b 70 6c 61 6e There is a [plan
0f70: 5d 28 2f 74 6b 74 76 69 65 77 3f 6e 61 6d 65 3d ](/tktview?name=
0f80: 36 63 31 66 32 39 61 62 35 39 29 20 74 6f 20 6d 6c1f29ab59) to m
0f90: 65 72 67 65 20 74 68 69 73 20 70 72 6f 67 72 61 erge this progra
0fa0: 6d 20 77 69 74 68 20 60 70 69 64 70 38 69 2d 74 m with `pidp8i-t
0fb0: 65 73 74 60 2c 20 77 68 69 63 68 20 69 66 20 64 est`, which if d
0fc0: 6f 6e 65 20 77 69 6c 6c 20 6d 65 61 6e 20 60 73 one will mean `s
0fd0: 63 61 6e 73 77 69 74 63 68 60 20 67 6f 65 73 20 canswitch` goes
0fe0: 61 77 61 79 2e 0d 0a 0d 0a 0d 0a 3c 61 20 69 64 away.......<a id
0ff0: 3d 22 73 65 72 76 69 63 65 22 3e 3c 2f 61 3e 0d ="service"></a>.
1000: 0a 23 23 20 54 68 65 20 50 69 44 50 2d 38 2f 49 .## The PiDP-8/I
1010: 20 53 65 72 76 69 63 65 0d 0a 0d 0a 54 68 65 20 Service....The
1020: 77 61 79 20 79 6f 75 20 73 74 61 72 74 2c 20 73 way you start, s
1030: 74 6f 70 2c 20 72 65 73 74 61 72 74 2c 20 61 6e top, restart, an
1040: 64 20 71 75 65 72 79 20 74 68 65 20 62 61 63 6b d query the back
1050: 67 72 6f 75 6e 64 20 73 69 6d 75 6c 61 74 6f 72 ground simulator
1060: 20 73 65 72 76 69 63 65 20 68 61 73 20 63 68 61 service has cha
1070: 6e 67 65 64 2e 20 53 65 65 20 5b 74 68 65 20 74 nged. See [the t
1080: 6f 70 2d 6c 65 76 65 6c 20 60 52 45 41 44 4d 45 op-level `README
1090: 2e 6d 64 60 20 66 69 6c 65 5d 28 2f 64 6f 63 2f .md` file](/doc/
10a0: 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 23 trunk/README.md#
10b0: 73 79 73 74 65 6d 64 29 20 66 6f 72 20 64 65 74 systemd) for det
10c0: 61 69 6c 73 2e 0d 0a 0d 0a 0d 0a 3c 61 20 69 64 ails.......<a id
10d0: 3d 22 72 75 6e 6e 69 6e 67 2d 62 6f 74 68 22 3e ="running-both">
10e0: 3c 2f 61 3e 0d 0a 23 23 20 52 75 6e 6e 69 6e 67 </a>..## Running
10f0: 20 42 6f 74 68 20 56 65 72 73 69 6f 6e 73 20 53 Both Versions S
1100: 69 64 65 2d 62 79 2d 53 69 64 65 0d 0a 0d 0a 49 ide-by-Side....I
1110: 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f t is possible to
1120: 20 72 75 6e 20 62 6f 74 68 20 74 68 65 20 63 75 run both the cu
1130: 72 72 65 6e 74 20 50 69 44 50 2d 38 2f 49 20 73 rrent PiDP-8/I s
1140: 6f 66 74 77 61 72 65 20 66 72 6f 6d 20 74 68 69 oftware from thi
1150: 73 20 77 65 62 20 73 69 74 65 20 61 6c 6f 6e 67 s web site along
1160: 73 69 64 65 20 4f 73 63 61 72 27 73 20 6c 61 73 side Oscar's las
1170: 74 20 73 74 61 62 6c 65 20 72 65 6c 65 61 73 65 t stable release
1180: 2e 20 54 68 65 79 20 63 61 6e 27 74 20 72 75 6e . They can't run
1190: 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 2c simultaneously,
11a0: 20 73 69 6e 63 65 20 74 68 65 79 27 64 20 66 69 since they'd fi
11b0: 67 68 74 20 6f 76 65 72 20 74 68 65 20 66 72 6f ght over the fro
11c0: 6e 74 20 70 61 6e 65 6c 20 47 50 49 4f 20 70 69 nt panel GPIO pi
11d0: 6e 73 2c 20 62 75 74 20 79 6f 75 20 63 61 6e 20 ns, but you can
11e0: 73 77 61 70 20 62 65 74 77 65 65 6e 20 74 68 65 swap between the
11f0: 6d 20 61 74 20 77 69 6c 6c 2c 20 77 69 74 68 6f m at will, witho
1200: 75 74 20 65 69 74 68 65 72 20 69 6e 74 65 72 66 ut either interf
1210: 65 72 69 6e 67 20 77 69 74 68 20 74 68 65 20 6f ering with the o
1220: 74 68 65 72 2c 20 64 75 65 20 74 6f 20 74 68 65 ther, due to the
1230: 20 5b 66 69 6c 65 20 6e 61 6d 69 6e 67 5d 28 23 [file naming](#
1240: 70 61 74 68 73 29 20 61 6e 64 20 5b 73 65 72 76 paths) and [serv
1250: 69 63 65 5d 28 23 73 65 72 76 69 63 65 29 20 64 ice](#service) d
1260: 69 66 66 65 72 65 6e 63 65 73 20 6c 69 6e 65 64 ifferences lined
1270: 20 6f 75 74 20 61 62 6f 76 65 2e 0d 0a 0d 0a 54 out above.....T
1280: 6f 20 73 77 69 74 63 68 20 62 61 63 6b 20 66 72 o switch back fr
1290: 6f 6d 20 6d 79 20 76 65 72 73 69 6f 6e 20 74 6f om my version to
12a0: 20 74 68 65 20 70 72 69 6f 72 20 73 74 61 62 6c the prior stabl
12b0: 65 20 76 65 72 73 69 6f 6e 2c 20 73 61 79 3a 0d e version, say:.
12c0: 0a 0d 0a 20 20 20 20 24 20 73 79 73 74 65 6d 63 ... $ systemc
12d0: 74 6c 20 2d 2d 75 73 65 72 20 73 74 6f 70 20 70 tl --user stop p
12e0: 69 64 70 38 69 0d 0a 20 20 20 20 24 20 73 75 64 idp8i.. $ sud
12f0: 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 74 61 72 o systemctl star
1300: 74 20 70 69 64 70 38 0d 0a 0d 0a 41 6e 64 20 74 t pidp8....And t
1310: 68 65 6e 20 74 6f 20 73 77 69 74 63 68 20 62 61 hen to switch ba
1320: 63 6b 20 74 6f 20 6d 79 20 76 65 72 73 69 6f 6e ck to my version
1330: 3a 0d 0a 0d 0a 20 20 20 20 24 20 73 75 64 6f 20 :.... $ sudo
1340: 73 79 73 74 65 6d 63 74 6c 20 73 74 6f 70 20 70 systemctl stop p
1350: 69 64 70 38 0d 0a 20 20 20 20 24 20 73 79 73 74 idp8.. $ syst
1360: 65 6d 63 74 6c 20 2d 2d 75 73 65 72 20 73 74 61 emctl --user sta
1370: 72 74 20 70 69 64 70 38 69 0d 0a 0d 0a 0d 0a 3c rt pidp8i......<
1380: 61 20 69 64 3d 22 6d 75 6c 74 69 70 6c 65 22 3e a id="multiple">
1390: 3c 2f 61 3e 0d 0a 23 23 20 4d 75 6c 74 69 70 6c </a>..## Multipl
13a0: 65 20 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 73 0d e Installations.
13b0: 0a 0d 0a 54 68 65 20 70 72 69 6f 72 20 73 74 61 ...The prior sta
13c0: 62 6c 65 20 76 65 72 73 69 6f 6e 20 77 61 73 20 ble version was
13d0: 65 73 73 65 6e 74 69 61 6c 6c 79 20 66 69 78 65 essentially fixe
13e0: 64 20 69 6e 20 70 6c 61 63 65 20 69 6e 20 74 68 d in place in th
13f0: 65 20 66 69 6c 65 73 79 73 74 65 6d 2e 20 49 74 e filesystem. It
1400: 73 20 73 6f 75 72 63 65 20 63 6f 64 65 20 68 61 s source code ha
1410: 64 20 74 6f 20 62 65 20 75 6e 70 61 63 6b 65 64 d to be unpacked
1420: 20 69 6e 74 6f 20 60 2f 6f 70 74 2f 70 69 64 70 into `/opt/pidp
1430: 38 60 20 61 6e 64 20 72 75 6e 20 66 72 6f 6d 20 8` and run from
1440: 74 68 65 72 65 20 74 6f 20 77 6f 72 6b 20 63 6f there to work co
1450: 72 72 65 63 74 6c 79 2e 0d 0a 0d 0a 54 68 69 73 rrectly.....This
1460: 20 63 75 72 72 65 6e 74 20 73 6f 66 74 77 61 72 current softwar
1470: 65 20 63 61 6e 20 62 65 20 75 6e 70 61 63 6b 65 e can be unpacke
1480: 64 20 61 6e 79 77 68 65 72 65 20 69 6e 20 74 68 d anywhere in th
1490: 65 20 66 69 6c 65 73 79 73 74 65 6d 2c 20 79 6f e filesystem, yo
14a0: 75 20 63 61 6e 20 62 75 69 6c 64 20 69 74 20 69 u can build it i
14b0: 6e 74 6f 20 61 20 73 65 63 6f 6e 64 20 64 69 72 nto a second dir
14c0: 65 63 74 6f 72 79 20 73 65 70 61 72 61 74 65 20 ectory separate
14d0: 66 72 6f 6d 20 74 68 65 20 73 6f 75 72 63 65 20 from the source
14e0: 64 69 72 65 63 74 6f 72 79 2c 20 61 6e 64 20 79 directory, and y
14f0: 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c 6c 20 69 ou can install i
1500: 74 20 74 6f 20 79 65 74 20 61 20 74 68 69 72 64 t to yet a third
1510: 20 64 69 72 65 63 74 6f 72 79 2e 20 54 68 69 73 directory. This
1520: 20 61 66 66 6f 72 64 73 20 63 6f 6e 73 69 64 65 affords conside
1530: 72 61 62 6c 65 20 66 6c 65 78 69 62 69 6c 69 74 rable flexibilit
1540: 79 20 69 6e 20 68 6f 77 20 79 6f 75 20 62 75 69 y in how you bui
1550: 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 74 ld and install t
1560: 68 69 73 20 73 6f 66 74 77 61 72 65 2e 0d 0a 0d his software....
1570: 0a 54 68 69 73 20 73 6f 66 74 77 61 72 65 20 61 .This software a
1580: 6c 73 6f 20 64 6f 65 73 6e 27 74 20 6f 76 65 72 lso doesn't over
1590: 77 72 69 74 65 20 79 6f 75 72 20 62 69 6e 61 72 write your binar
15a0: 79 20 6d 65 64 69 61 20 6f 6e 20 72 65 2d 69 6e y media on re-in
15b0: 73 74 61 6c 6c 61 74 69 6f 6e 3a 20 77 68 65 6e stallation: when
15c0: 65 76 65 72 20 77 65 20 73 68 69 70 20 61 20 63 ever we ship a c
15d0: 68 61 6e 67 65 20 74 6f 20 6f 6e 65 20 6f 66 20 hange to one of
15e0: 74 68 65 20 70 61 70 65 72 20 74 61 70 65 20 69 the paper tape i
15f0: 6d 61 67 65 73 2c 20 44 45 43 74 61 70 65 20 69 mages, DECtape i
1600: 6d 61 67 65 73 2c 20 64 69 73 6b 20 69 6d 61 67 mages, disk imag
1610: 65 73 2c 20 65 74 63 2e 2c 20 75 70 67 72 61 64 es, etc., upgrad
1620: 69 6e 67 20 74 6f 20 74 68 61 74 20 72 65 6c 65 ing to that rele
1630: 61 73 65 20 6f 6e 6c 79 20 67 65 74 73 20 79 6f ase only gets yo
1640: 75 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 u a copy of the
1650: 6e 65 77 20 6d 65 64 69 61 20 69 6e 20 74 68 65 new media in the
1660: 20 73 6f 75 72 63 65 20 74 72 65 65 3b 20 74 68 source tree; th
1670: 6f 73 65 20 6e 65 77 20 76 65 72 73 69 6f 6e 73 ose new versions
1680: 20 64 6f 20 6e 6f 74 20 6f 76 65 72 77 72 69 74 do not overwrit
1690: 65 20 79 6f 75 72 20 6c 6f 63 61 6c 20 63 6f 70 e your local cop
16a0: 69 65 73 20 69 6e 20 74 68 65 20 69 6e 73 74 61 ies in the insta
16b0: 6c 6c 61 74 69 6f 6e 20 74 72 65 65 2c 20 73 69 llation tree, si
16c0: 6e 63 65 20 74 68 65 79 20 6d 61 79 20 63 6f 6e nce they may con
16d0: 74 61 69 6e 20 6c 6f 63 61 6c 20 63 68 61 6e 67 tain local chang
16e0: 65 73 2e 20 57 69 74 68 20 74 68 65 20 70 72 69 es. With the pri
16f0: 6f 72 20 73 74 61 62 6c 65 20 76 65 72 73 69 6f or stable versio
1700: 6e 2c 20 73 69 6e 63 65 20 74 68 65 20 62 75 69 n, since the bui
1710: 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 61 74 ld and installat
1720: 69 6f 6e 20 6c 6f 63 61 74 69 6f 6e 73 20 77 65 ion locations we
1730: 72 65 20 74 68 65 20 73 61 6d 65 2c 20 75 70 67 re the same, upg
1740: 72 61 64 69 6e 67 20 77 6f 75 6c 64 20 61 6c 77 rading would alw
1750: 61 79 73 20 6f 76 65 72 77 72 69 74 65 20 79 6f ays overwrite yo
1760: 75 72 20 6c 6f 63 61 6c 20 6d 65 64 69 61 20 69 ur local media i
1770: 6d 61 67 65 73 2e 20 53 65 65 20 74 68 65 20 22 mages. See the "
1780: 4f 76 65 72 77 72 69 74 69 6e 67 20 74 68 65 20 Overwriting the
1790: 4c 6f 63 61 6c 20 53 69 6d 75 6c 61 74 6f 72 20 Local Simulator
17a0: 53 65 74 75 70 22 20 73 65 63 74 69 6f 6e 20 6f Setup" section o
17b0: 66 20 5b 74 68 65 20 60 52 45 41 44 4d 45 2e 6d f [the `README.m
17c0: 64 60 20 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 d` file](/doc/tr
17d0: 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64 29 20 66 unk/README.md) f
17e0: 6f 72 20 6d 6f 72 65 20 6f 6e 20 74 68 69 73 20 or more on this
17f0: 74 6f 70 69 63 2e 0d 0a 0d 0a 0d 0a 3c 61 20 69 topic.......<a i
1800: 64 3d 22 69 6c 73 22 3e 3c 2f 61 3e 0d 0a 23 23 d="ils"></a>..##
1810: 20 49 6e 63 61 6e 64 65 73 63 65 6e 74 20 4c 61 Incandescent La
1820: 6d 70 20 53 69 6d 75 6c 61 74 6f 72 0d 0a 0d 0a mp Simulator....
1830: 57 68 65 6e 20 79 6f 75 20 62 75 69 6c 64 20 74 When you build t
1840: 68 69 73 20 73 6f 66 74 77 61 72 65 20 6f 6e 20 his software on
1850: 61 20 6d 75 6c 74 69 2d 63 6f 72 65 20 50 69 2c a multi-core Pi,
1860: 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 the default is
1870: 74 6f 20 62 75 69 6c 64 20 74 68 65 20 50 69 44 to build the PiD
1880: 50 2d 38 2f 49 20 73 69 6d 75 6c 61 74 6f 72 20 P-8/I simulator
1890: 77 69 74 68 20 74 68 65 20 5b 69 6e 63 61 6e 64 with the [incand
18a0: 65 73 63 65 6e 74 20 6c 61 6d 70 20 73 69 6d 75 escent lamp simu
18b0: 6c 61 74 6f 72 5d 28 2f 77 69 6b 69 3f 6e 61 6d lator](/wiki?nam
18c0: 65 3d 49 6e 63 61 6e 64 65 73 63 65 6e 74 2b 4c e=Incandescent+L
18d0: 61 6d 70 2b 53 69 6d 75 6c 61 74 6f 72 29 20 28 amp+Simulator) (
18e0: 49 4c 53 29 20 65 6e 61 62 6c 65 64 2c 20 61 73 ILS) enabled, as
18f0: 20 6f 70 70 6f 73 65 64 20 74 6f 20 74 68 65 20 opposed to the
1900: 6f 72 69 67 69 6e 61 6c 20 4c 45 44 20 64 72 69 original LED dri
1910: 76 69 6e 67 20 63 6f 64 65 20 77 68 69 63 68 20 ving code which
1920: 69 73 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e is more efficien
1930: 74 20 62 75 74 20 6c 65 73 73 20 70 65 72 69 6f t but less perio
1940: 64 2d 61 63 63 75 72 61 74 65 20 69 6e 20 61 70 d-accurate in ap
1950: 70 65 61 72 61 6e 63 65 2e 20 4f 6e 20 73 69 6e pearance. On sin
1960: 67 6c 65 2d 63 6f 72 65 20 50 69 73 2c 20 77 65 gle-core Pis, we
1970: 20 62 75 69 6c 64 20 74 68 65 20 73 6f 66 74 77 build the softw
1980: 61 72 65 20 74 6f 20 64 72 69 76 65 20 74 68 65 are to drive the
1990: 20 4c 45 44 73 20 69 6e 20 6d 75 63 68 20 74 68 LEDs in much th
19a0: 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 e same way as th
19b0: 65 20 70 72 69 6f 72 20 73 74 61 62 6c 65 20 76 e prior stable v
19c0: 65 72 73 69 6f 6e 20 64 6f 65 73 2c 20 62 65 63 ersion does, bec
19d0: 61 75 73 65 20 74 68 65 20 49 4c 53 20 74 61 6b ause the ILS tak
19e0: 65 73 20 74 6f 6f 20 6d 75 63 68 20 43 50 55 20 es too much CPU
19f0: 74 6f 20 72 75 6e 20 62 6f 74 68 20 69 74 20 61 to run both it a
1a00: 6e 64 20 74 68 65 20 50 44 50 2d 38 20 73 69 6d nd the PDP-8 sim
1a10: 75 6c 61 74 6f 72 20 61 74 20 74 68 65 20 73 61 ulator at the sa
1a20: 6d 65 20 74 69 6d 65 20 6f 6e 20 61 20 73 69 6e me time on a sin
1a30: 67 6c 65 20 37 30 30 20 4d 48 7a 20 41 52 4d 20 gle 700 MHz ARM
1a40: 63 6f 72 65 2e 20 59 6f 75 20 63 61 6e 20 66 6f core. You can fo
1a50: 72 63 65 20 61 20 72 65 74 75 72 6e 20 74 6f 20 rce a return to
1a60: 74 68 65 20 6f 6c 64 20 65 66 66 69 63 69 65 6e the old efficien
1a70: 74 20 6d 65 74 68 6f 64 20 6f 6e 20 61 20 6d 75 t method on a mu
1a80: 6c 74 69 2d 63 6f 72 65 20 50 69 20 62 79 20 63 lti-core Pi by c
1a90: 6f 6e 66 69 67 75 72 69 6e 67 20 74 68 65 20 73 onfiguring the s
1aa0: 6f 66 74 77 61 72 65 20 77 69 74 68 20 74 68 65 oftware with the
1ab0: 20 60 2d 2d 6e 6f 2d 6c 61 6d 70 2d 73 69 6d 75 `--no-lamp-simu
1ac0: 6c 61 74 6f 72 60 20 6f 70 74 69 6f 6e 2e 0d 0a lator` option...
1ad0: 0d 0a 0d 0a 3c 61 20 69 64 3d 22 6f 73 22 3e 3c ....<a id="os"><
1ae0: 2f 61 3e 0d 0a 23 23 20 52 75 6e 73 20 6f 6e 20 /a>..## Runs on
1af0: 4d 6f 72 65 20 4f 53 65 73 0d 0a 0d 0a 54 68 65 More OSes....The
1b00: 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 PiDP-8/I softwa
1b10: 72 65 20 6e 6f 77 20 62 75 69 6c 64 73 20 61 6e re now builds an
1b20: 64 20 72 75 6e 73 20 6f 6e 20 6d 6f 72 65 20 4f d runs on more O
1b30: 53 20 74 79 70 65 73 20 74 68 61 6e 20 64 69 64 S types than did
1b40: 20 4f 73 63 61 72 27 73 20 6c 61 73 74 20 72 65 Oscar's last re
1b50: 6c 65 61 73 65 2c 20 77 68 69 63 68 20 77 61 73 lease, which was
1b60: 20 70 72 65 74 74 79 20 6d 75 63 68 20 74 69 65 pretty much tie
1b70: 64 20 74 6f 20 52 61 73 70 62 69 61 6e 20 61 6e d to Raspbian an
1b80: 64 20 63 6c 6f 73 65 20 72 65 6c 61 74 69 76 65 d close relative
1b90: 73 20 6c 69 6b 65 20 70 69 70 61 4f 53 2e 20 46 s like pipaOS. F
1ba0: 75 6c 6c 20 64 65 74 61 69 6c 73 20 6f 6e 20 74 ull details on t
1bb0: 68 69 73 20 61 72 65 20 63 6f 76 65 72 65 64 20 his are covered
1bc0: 5b 65 6c 73 65 77 68 65 72 65 5d 28 68 74 74 70 [elsewhere](http
1bd0: 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 74 2e s://tangentsoft.
1be0: 63 6f 6d 2f 70 69 64 70 38 69 2f 77 69 6b 69 3f com/pidp8i/wiki?
1bf0: 6e 61 6d 65 3d 4f 53 2b 43 6f 6d 70 61 74 69 62 name=OS+Compatib
1c00: 69 6c 69 74 79 29 2e 0d 0a 0d 0a 0d 0a 23 23 20 ility).......##
1c10: 46 72 6f 6e 74 20 50 61 6e 65 6c 20 53 77 69 74 Front Panel Swit
1c20: 63 68 20 43 6f 6d 62 6f 73 0d 0a 0d 0a 53 65 76 ch Combos....Sev
1c30: 65 72 61 6c 20 6f 66 20 74 68 65 20 50 69 44 50 eral of the PiDP
1c40: 2d 38 2f 49 20 73 70 65 63 69 66 69 63 20 66 72 -8/I specific fr
1c50: 6f 6e 74 2d 70 61 6e 65 6c 20 73 77 69 74 63 68 ont-panel switch
1c60: 20 63 6f 6d 62 6f 73 20 61 72 65 20 64 69 66 66 combos are diff
1c70: 65 72 65 6e 74 3a 0d 0a 0d 0a 2a 20 20 20 60 53 erent:....* `S
1c80: 69 6e 67 5f 53 74 65 70 60 20 2b 20 60 53 69 6e ing_Step` + `Sin
1c90: 67 5f 49 6e 73 74 60 20 2b 20 60 53 74 61 72 74 g_Inst` + `Start
1ca0: 60 20 6e 6f 77 20 72 65 62 6f 6f 74 73 20 74 68 ` now reboots th
1cb0: 65 20 68 6f 73 74 20 50 69 2c 20 72 61 74 68 65 e host Pi, rathe
1cc0: 72 20 74 68 61 6e 20 70 6f 77 65 72 20 69 74 20 r than power it
1cd0: 64 6f 77 6e 2c 20 62 65 63 61 75 73 65 20 22 53 down, because "S
1ce0: 74 61 72 74 22 20 6d 61 6b 65 73 20 6d 6f 72 65 tart" makes more
1cf0: 20 73 65 6e 73 65 20 61 73 20 61 20 6d 6e 65 6d sense as a mnem
1d00: 6f 6e 69 63 20 66 6f 72 20 22 72 65 73 74 61 72 onic for "restar
1d10: 74 2e 22 0d 0a 0d 0a 2a 20 20 20 60 53 69 6e 67 t."....* `Sing
1d20: 5f 53 74 65 70 60 20 2b 20 60 53 69 6e 67 5f 49 _Step` + `Sing_I
1d30: 6e 73 74 60 20 2b 20 60 53 74 6f 70 60 20 6e 6f nst` + `Stop` no
1d40: 77 20 70 6f 77 65 72 73 20 74 68 65 20 68 6f 73 w powers the hos
1d50: 74 20 50 69 20 64 6f 77 6e 2e 0d 0a 0d 0a 2a 20 t Pi down.....*
1d60: 20 20 60 53 69 6e 67 5f 53 74 65 70 60 20 2b 20 `Sing_Step` +
1d70: 60 53 69 6e 67 5f 49 6e 73 74 60 20 2b 20 60 43 `Sing_Inst` + `C
1d80: 6f 6e 74 60 20 75 73 65 64 20 74 6f 20 72 65 62 ont` used to reb
1d90: 6f 6f 74 20 74 68 65 20 68 6f 73 74 20 50 69 2c oot the host Pi,
1da0: 20 62 75 74 20 69 73 20 63 75 72 72 65 6e 74 6c but is currentl
1db0: 79 20 75 6e 61 73 73 69 67 6e 65 64 2e 0d 0a 0d y unassigned....
1dc0: 0a 2a 20 20 20 60 53 69 6e 67 5f 53 74 65 70 60 .* `Sing_Step`
1dd0: 20 2b 20 60 53 69 6e 67 5f 49 6e 73 74 60 20 2b + `Sing_Inst` +
1de0: 20 60 4c 6f 61 64 5f 41 64 64 60 20 75 73 65 64 `Load_Add` used
1df0: 20 74 6f 20 6d 6f 75 6e 74 20 74 68 65 20 55 53 to mount the US
1e00: 42 20 73 74 69 63 6b 2c 20 62 75 74 20 74 68 61 B stick, but tha
1e10: 74 20 69 73 20 75 6e 6e 65 63 65 73 73 61 72 79 t is unnecessary
1e20: 2c 20 73 69 6e 63 65 20 74 68 65 20 73 6f 66 74 , since the soft
1e30: 77 61 72 65 20 6e 6f 77 20 75 73 65 73 20 52 61 ware now uses Ra
1e40: 73 70 62 69 61 6e 27 73 20 55 53 42 20 61 75 74 spbian's USB aut
1e50: 6f 6d 6f 75 6e 74 65 72 2e 0d 0a 0d 0a 2a 20 20 omounter.....*
1e60: 20 60 53 69 6e 67 5f 53 74 65 70 60 20 2b 20 60 `Sing_Step` + `
1e70: 53 69 6e 67 5f 49 6e 73 74 60 20 2b 20 60 44 65 Sing_Inst` + `De
1e80: 70 60 20 75 73 65 64 20 74 6f 20 75 6e 6d 6f 75 p` used to unmou
1e90: 6e 74 20 74 68 65 20 55 53 42 20 73 74 69 63 6b nt the USB stick
1ea0: 2c 20 62 75 74 20 74 68 61 74 20 69 73 20 75 6e , but that is un
1eb0: 6e 65 63 65 73 73 61 72 79 20 69 6e 20 74 68 69 necessary in thi
1ec0: 73 20 69 6e 73 74 61 6e 63 65 20 73 69 6e 63 65 s instance since
1ed0: 20 55 53 42 20 73 74 69 63 6b 73 20 61 72 65 20 USB sticks are
1ee0: 70 72 69 6d 61 72 69 6c 79 20 75 73 65 64 20 74 primarily used t
1ef0: 6f 20 65 6d 75 6c 61 74 65 20 70 61 70 65 72 20 o emulate paper
1f00: 74 61 70 65 73 2c 20 77 68 69 63 68 20 61 72 65 tapes, which are
1f10: 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 61 read-only media
1f20: 2e 20 59 6f 75 20 64 6f 6e 27 74 20 68 61 76 65 . You don't have
1f30: 20 74 6f 20 75 6e 6d 6f 75 6e 74 20 74 68 65 20 to unmount the
1f40: 73 74 69 63 6b 20 62 65 66 6f 72 65 20 75 6e 70 stick before unp
1f50: 6c 75 67 67 69 6e 67 20 69 74 20 69 6e 20 6f 72 lugging it in or
1f60: 64 65 72 20 74 6f 20 61 76 6f 69 64 20 66 69 6c der to avoid fil
1f70: 65 73 79 73 74 65 6d 20 63 6f 72 72 75 70 74 69 esystem corrupti
1f80: 6f 6e 20 69 6e 20 69 6e 73 74 61 6e 63 65 73 20 on in instances
1f90: 6c 69 6b 65 20 74 68 69 73 2e 0d 0a 0d 0a 2a 20 like this.....*
1fa0: 20 20 60 53 69 6e 67 5f 53 74 65 70 60 20 2b 20 `Sing_Step` +
1fb0: 60 44 46 3d 37 60 20 63 68 61 6e 67 65 64 20 66 `DF=7` changed f
1fc0: 72 6f 6d 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 rom looking for
1fd0: 61 20 60 2a 2e 72 6c 60 20 66 69 6c 65 20 74 6f a `*.rl` file to
1fe0: 20 6d 6f 75 6e 74 20 61 73 20 61 6e 20 52 4c 30 mount as an RL0
1ff0: 31 20 64 69 73 6b 20 70 61 63 6b 20 69 6d 61 67 1 disk pack imag
2000: 65 20 74 6f 20 65 78 70 65 63 74 69 6e 67 20 61 e to expecting a
2010: 6e 20 60 2a 2e 72 6b 60 20 66 69 6c 65 20 61 6e n `*.rk` file an
2020: 64 20 6d 6f 75 6e 74 69 6e 67 20 69 74 20 6f 6e d mounting it on
2030: 20 74 68 65 20 73 65 63 6f 6e 64 20 60 52 4b 30 the second `RK0
2040: 35 60 20 64 69 73 6b 20 64 72 69 76 65 2e 20 54 5` disk drive. T
2050: 68 65 20 52 4c 20 73 65 72 69 65 73 20 64 72 69 he RL series dri
2060: 76 65 73 20 70 6f 73 74 64 61 74 65 73 20 74 68 ves postdates th
2070: 65 20 50 44 50 2d 38 2f 49 20 62 79 20 6d 61 6e e PDP-8/I by man
2080: 79 20 79 65 61 72 73 2c 20 61 6e 64 20 74 68 65 y years, and the
2090: 20 73 74 6f 63 6b 20 4f 53 2f 38 20 63 6f 6e 66 stock OS/8 conf
20a0: 69 67 75 72 61 74 69 6f 6e 20 73 68 69 70 73 20 iguration ships
20b0: 61 73 20 61 6e 20 52 4b 30 35 20 69 6d 61 67 65 as an RK05 image
20c0: 20 74 68 61 74 20 6d 6f 75 6e 74 73 20 6f 6e 20 that mounts on
20d0: 74 68 65 20 66 69 72 73 74 20 64 72 69 76 65 2c the first drive,
20e0: 20 73 6f 20 74 68 69 73 20 6e 65 77 20 6d 65 61 so this new mea
20f0: 6e 69 6e 67 20 66 65 65 6c 73 20 6d 6f 72 65 20 ning feels more
2100: 61 70 70 72 6f 70 72 69 61 74 65 20 6f 6e 20 6d appropriate on m
2110: 61 6e 79 20 61 78 65 73 2e 20 54 68 65 20 6f 74 any axes. The ot
2120: 68 65 72 20 60 44 46 60 20 73 65 74 74 69 6e 67 her `DF` setting
2130: 73 20 72 65 74 61 69 6e 20 74 68 65 69 72 20 5b s retain their [
2140: 73 74 6f 63 6b 20 6d 65 61 6e 69 6e 67 73 5d 28 stock meanings](
2150: 68 74 74 70 3a 2f 2f 6f 62 73 6f 6c 65 73 63 65 http://obsolesce
2160: 6e 63 65 2e 77 69 78 73 69 74 65 2e 63 6f 6d 2f nce.wixsite.com/
2170: 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2f 68 6f 77 obsolescence/how
2180: 2d 74 6f 2d 75 73 65 2d 74 68 65 2d 70 69 64 70 -to-use-the-pidp
2190: 2d 38 29 2e 0d 0a 0d 0a 0d 0a 23 23 20 4c 69 63 -8).......## Lic
21a0: 65 6e 73 65 0d 0a 0d 0a 43 6f 70 79 72 69 67 68 ense....Copyrigh
21b0: 74 20 c2 a9 20 32 30 31 37 2d 32 30 31 38 20 62 t © 2017-2018 b
21c0: 79 20 57 61 72 72 65 6e 20 59 6f 75 6e 67 2e 20 y Warren Young.
21d0: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 This document is
21e0: 20 6c 69 63 65 6e 73 65 64 20 75 6e 64 65 72 20 licensed under
21f0: 74 68 65 20 74 65 72 6d 73 20 6f 66 20 5b 74 68 the terms of [th
2200: 65 20 53 49 4d 48 20 6c 69 63 65 6e 73 65 5d 5b e SIMH license][
2210: 73 6c 5d 2e 0d 0a 0d 0a 5b 73 6c 5d 3a 20 68 74 sl].....[sl]: ht
2220: 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 tps://tangentsof
2230: 74 2e 63 6f 6d 2f 70 69 64 70 38 69 2f 64 6f 63 t.com/pidp8i/doc
2240: 2f 74 72 75 6e 6b 2f 53 49 4d 48 2d 4c 49 43 45 /trunk/SIMH-LICE
2250: 4e 53 45 2e 6d 64 0a 5a 20 39 61 34 65 31 66 35 NSE.md.Z 9a4e1f5
2260: 36 66 37 31 30 62 62 30 32 61 65 31 61 66 62 61 6f710bb02ae1afba
2270: 37 64 63 61 33 64 64 64 37 0a 7dca3ddd7.