0000: 44 20 32 30 31 39 2d 31 31 2d 30 34 54 32 33 3a D 2019-11-04T23:
0010: 30 37 3a 33 33 2e 36 33 37 0a 4c 20 4d 61 6a 6f 07:33.637.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 63 37 61 63 32 64 62 65 63 39 33 36 65 .P c7ac2dbec936e
0050: 30 63 39 62 37 66 34 35 36 33 61 62 32 33 37 38 0c9b7f4563ab2378
0060: 36 34 32 64 62 37 62 39 35 39 61 0a 55 20 74 61 642db7b959a.U ta
0070: 6e 67 65 6e 74 0a 57 20 39 34 35 36 0a 23 20 4d ngent.W 9456.# 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 5b 61 version, but [a
01a0: 73 20 6f 66 20 4d 61 79 20 32 30 31 37 5d 5b 6f s of May 2017][o
01b0: 61 6e 6e 5d 2c 20 4f 73 63 61 72 20 6e 6f 77 20 ann], Oscar now
01c0: 63 6f 6e 73 69 64 65 72 73 20 74 68 65 20 63 75 considers the cu
01d0: 72 72 65 6e 74 20 73 74 61 62 6c 65 20 76 65 72 rrent stable ver
01e0: 73 69 6f 6e 20 74 6f 20 62 65 20 77 68 61 74 65 sion to be whate
01f0: 76 65 72 20 77 65 27 76 65 20 6d 6f 73 74 20 72 ver we've most r
0200: 65 63 65 6e 74 6c 79 20 5b 74 61 67 67 65 64 20 ecently [tagged
0210: 61 73 20 61 20 73 74 61 62 6c 65 20 72 65 6c 65 as a stable rele
0220: 61 73 65 5d 5b 72 65 6c 62 5d 2e 0d 0a 0d 0a 5b ase][relb].....[
0230: 6f 61 6e 6e 5d 3a 20 68 74 74 70 73 3a 2f 2f 67 oann]: https://g
0240: 72 6f 75 70 73 2e 67 6f 6f 67 6c 65 2e 63 6f 6d roups.google.com
0250: 2f 64 2f 6d 73 67 2f 70 69 64 70 2d 38 2f 56 58 /d/msg/pidp-8/VX
0260: 74 39 31 34 61 41 74 74 67 2f 45 36 45 43 47 30 t914aAttg/E6ECG0
0270: 4b 4c 43 41 41 4a 0d 0a 5b 72 65 6c 62 5d 3a 20 KLCAAJ..[relb]:
0280: 2f 74 69 6d 65 6c 69 6e 65 3f 72 3d 72 65 6c 65 /timeline?r=rele
0290: 61 73 65 0d 0a 0d 0a 59 6f 75 20 63 61 6e 20 63 ase....You can c
02a0: 6f 6e 73 69 64 65 72 20 74 68 65 20 72 65 73 74 onsider the rest
02b0: 20 6f 66 20 74 68 69 73 20 64 6f 63 75 6d 65 6e of this documen
02c0: 74 20 74 6f 20 62 65 20 61 20 6d 69 67 72 61 74 t to be a migrat
02d0: 69 6f 6e 20 67 75 69 64 65 20 66 6f 72 20 75 73 ion guide for us
02e0: 65 72 73 20 77 68 6f 20 61 72 65 20 63 6f 6d 69 ers who are comi
02f0: 6e 67 20 66 72 6f 6d 20 4f 73 63 61 72 27 73 20 ng from Oscar's
0300: 66 69 6e 61 6c 20 73 74 61 62 6c 65 20 72 65 6c final stable rel
0310: 65 61 73 65 2e 20 49 74 20 6d 61 79 20 61 6c 73 ease. It may als
0320: 6f 20 62 65 20 6f 66 20 75 73 65 20 77 68 69 6c o be of use whil
0330: 65 20 72 65 61 64 69 6e 67 20 74 68 72 6f 75 67 e reading throug
0340: 68 20 6f 6c 64 65 72 20 6d 65 73 73 61 67 65 73 h older messages
0350: 20 6f 6e 20 74 68 65 20 6d 61 69 6c 69 6e 67 20 on the mailing
0360: 6c 69 73 74 2c 20 73 69 6e 63 65 20 74 68 65 79 list, since they
0370: 20 6f 66 74 65 6e 20 67 69 76 65 20 69 6e 73 74 often give inst
0380: 72 75 63 74 69 6f 6e 73 20 74 68 61 74 20 64 6f ructions that do
0390: 6e 27 74 20 77 6f 72 6b 20 70 72 6f 70 65 72 6c n't work properl
03a0: 79 20 77 69 74 68 20 74 68 69 73 20 73 6f 66 74 y with this soft
03b0: 77 61 72 65 20 62 75 74 20 77 68 69 63 68 20 63 ware but which c
03c0: 61 6e 20 62 65 20 61 64 6a 75 73 74 65 64 20 74 an be adjusted t
03d0: 6f 20 77 6f 72 6b 2e 0d 0a 0d 0a 54 68 69 73 20 o work.....This
03e0: 64 6f 63 75 6d 65 6e 74 20 69 67 6e 6f 72 65 73 document ignores
03f0: 20 70 75 72 65 20 65 6e 68 61 6e 63 65 6d 65 6e pure enhancemen
0400: 74 73 2c 20 62 75 67 20 66 69 78 65 73 2c 20 61 ts, bug fixes, a
0410: 6e 64 20 6f 74 68 65 72 20 74 68 69 6e 67 73 20 nd other things
0420: 77 68 69 63 68 20 64 6f 20 6e 6f 74 20 63 68 61 which do not cha
0430: 6e 67 65 20 68 6f 77 20 74 68 65 20 75 73 65 72 nge how the user
0440: 20 69 6e 74 65 72 61 63 74 73 20 77 69 74 68 20 interacts with
0450: 74 68 65 20 73 6f 66 74 77 61 72 65 20 66 72 6f the software fro
0460: 6d 20 74 68 69 73 20 73 69 74 65 20 61 73 20 63 m this site as c
0470: 6f 6d 70 61 72 65 64 20 77 69 74 68 20 4f 73 63 ompared with Osc
0480: 61 72 27 73 20 70 72 69 6f 72 20 73 74 61 62 6c ar's prior stabl
0490: 65 20 76 65 72 73 69 6f 6e 2e 20 49 66 20 79 6f e version. If yo
04a0: 75 20 77 61 6e 74 20 61 20 64 65 74 61 69 6c 65 u want a detaile
04b0: 64 20 75 73 65 72 2d 66 6f 63 75 73 65 64 20 6c d user-focused l
04c0: 69 73 74 20 6f 66 20 63 68 61 6e 67 65 73 20 73 ist of changes s
04d0: 69 6e 63 65 20 74 68 61 74 20 76 65 72 73 69 6f ince that versio
04e0: 6e 2c 20 73 65 65 20 5b 74 68 65 20 43 68 61 6e n, see [the Chan
04f0: 67 65 4c 6f 67 5d 28 2f 64 6f 63 2f 74 72 75 6e geLog](/doc/trun
0500: 6b 2f 43 68 61 6e 67 65 4c 6f 67 2e 6d 64 29 2e k/ChangeLog.md).
0510: 20 46 6f 72 20 74 68 65 20 6c 6f 77 2d 6c 65 76 For the low-lev
0520: 65 6c 20 62 6c 6f 77 2d 62 79 2d 62 6c 6f 77 2c el blow-by-blow,
0530: 20 73 65 65 20 5b 74 68 65 20 70 72 6f 6a 65 63 see [the projec
0540: 74 20 74 69 6d 65 6c 69 6e 65 5d 28 2f 74 69 6d t timeline](/tim
0550: 65 6c 69 6e 65 29 2e 0d 0a 0d 0a 0d 0a 3c 61 20 eline).......<a
0560: 69 64 3d 22 62 75 69 6c 64 22 20 6e 61 6d 65 3d id="build" name=
0570: 22 69 6e 73 74 61 6c 6c 22 3e 3c 2f 61 3e 0d 0a "install"></a>..
0580: 23 23 20 42 75 69 6c 64 20 61 6e 64 20 49 6e 73 ## Build and Ins
0590: 74 61 6c 6c 61 74 69 6f 6e 0d 0a 0d 0a 55 6e 6c tallation....Unl
05a0: 69 6b 65 20 4f 73 63 61 72 27 73 20 66 69 6e 61 ike Oscar's fina
05b0: 6c 20 73 74 61 62 6c 65 20 72 65 6c 65 61 73 65 l stable release
05c0: 2c 20 74 68 69 73 20 73 6f 66 74 77 61 72 65 20 , this software
05d0: 68 61 73 20 61 20 73 74 72 61 69 67 68 74 66 6f has a straightfo
05e0: 72 77 61 72 64 20 62 75 69 6c 64 20 73 79 73 74 rward build syst
05f0: 65 6d 2c 20 74 79 70 69 63 61 6c 20 6f 66 20 6d em, typical of m
0600: 6f 73 74 20 4c 69 6e 75 78 20 73 6f 66 74 77 61 ost Linux softwa
0610: 72 65 2e 20 49 74 20 63 61 6e 20 62 65 20 61 73 re. It can be as
0620: 20 73 69 6d 70 6c 65 20 61 73 3a 0d 0a 0d 0a 20 simple as:....
0630: 20 20 20 20 24 20 2e 2f 63 6f 6e 66 69 67 75 72 $ ./configur
0640: 65 20 26 26 20 6d 61 6b 65 20 26 26 20 73 75 64 e && make && sud
0650: 6f 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0d 0a o make install..
0660: 0d 0a 59 6f 75 20 6e 6f 20 6c 6f 6e 67 65 72 20 ..You no longer
0670: 68 61 76 65 20 74 6f 20 62 75 69 6c 64 20 60 73 have to build `s
0680: 63 61 6e 73 77 69 74 63 68 60 20 6d 61 6e 75 61 canswitch` manua
0690: 6c 6c 79 2c 20 79 6f 75 20 64 6f 6e 27 74 20 68 lly, you don't h
06a0: 61 76 65 20 74 6f 20 5b 62 75 69 6c 64 20 69 74 ave to [build it
06b0: 20 69 6e 20 70 6c 61 63 65 5d 28 23 6d 75 6c 74 in place](#mult
06c0: 69 70 6c 65 29 20 77 69 74 68 69 6e 20 74 68 65 iple) within the
06d0: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 64 69 installation di
06e0: 72 65 63 74 6f 72 79 2c 20 79 6f 75 20 64 6f 6e rectory, you don
06f0: 27 74 20 68 61 76 65 20 74 6f 20 65 64 69 74 20 't have to edit
0700: 74 68 65 20 60 4d 61 6b 65 66 69 6c 65 60 20 6f the `Makefile` o
0710: 72 20 73 6f 75 72 63 65 20 63 6f 64 65 20 74 6f r source code to
0720: 20 63 68 61 6e 67 65 20 62 75 69 6c 64 20 6f 70 change build op
0730: 74 69 6f 6e 73 2c 20 74 68 65 72 65 20 69 73 20 tions, there is
0740: 6e 6f 20 73 65 70 61 72 61 74 65 20 69 6e 73 74 no separate inst
0750: 61 6c 6c 61 74 69 6f 6e 20 73 63 72 69 70 74 2e allation script.
0760: 0d 0a 0d 0a 46 6f 72 20 6d 6f 72 65 20 64 65 74 ....For more det
0770: 61 69 6c 73 20 6f 6e 20 74 68 65 20 62 75 69 6c ails on the buil
0780: 64 20 73 79 73 74 65 6d 20 6f 70 74 69 6f 6e 73 d system options
0790: 2c 20 73 65 65 20 5b 74 68 65 20 74 6f 70 2d 6c , see [the top-l
07a0: 65 76 65 6c 20 60 52 45 41 44 4d 45 2e 6d 64 60 evel `README.md`
07b0: 20 66 69 6c 65 5d 28 23 6f 70 74 69 6f 6e 73 29 file](#options)
07c0: 2e 0d 0a 0d 0a 0d 0a 3c 61 20 69 64 3d 22 70 61 .......<a id="pa
07d0: 74 68 73 22 3e 3c 2f 61 3e 0d 0a 23 23 20 50 61 ths"></a>..## Pa
07e0: 74 68 20 4e 61 6d 65 73 0d 0a 0d 0a 54 68 69 73 th Names....This
07f0: 20 73 6f 66 74 77 61 72 65 20 64 69 73 74 72 69 software distri
0800: 62 75 74 69 6f 6e 20 62 75 69 6c 64 73 20 61 6e bution builds an
0810: 64 20 69 6e 73 74 61 6c 6c 73 20 73 65 76 65 72 d installs sever
0820: 61 6c 20 66 69 6c 65 73 20 69 6e 20 64 69 66 66 al files in diff
0830: 65 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 73 20 erent locations
0840: 74 68 61 6e 20 74 68 65 20 70 72 69 6f 72 20 73 than the prior s
0850: 74 61 62 6c 65 20 76 65 72 73 69 6f 6e 2e 20 54 table version. T
0860: 68 65 20 6d 61 70 70 69 6e 67 20 69 73 3a 0d 0a he mapping is:..
0870: 0d 0a 50 72 69 6f 72 20 4e 61 6d 65 20 7c 20 57 ..Prior Name | W
0880: 68 61 74 20 49 74 20 49 73 20 7c 20 43 75 72 72 hat It Is | Curr
0890: 65 6e 74 20 4e 61 6d 65 0d 0a 2d 2d 2d 2d 2d 2d ent Name..------
08a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
08b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
08c0: 2d 0d 0a 60 70 64 70 2e 73 68 60 20 20 20 20 20 -..`pdp.sh`
08d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
08e0: 20 20 7c 20 73 63 72 69 70 74 20 74 6f 20 5b 72 | script to [r
08f0: 65 5d 65 6e 74 65 72 20 74 68 65 20 73 69 6d 75 e]enter the simu
0900: 6c 61 74 6f 72 20 66 72 6f 6d 20 74 68 65 20 63 lator from the c
0910: 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 20 20 20 20 ommand line
0920: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0930: 20 7c 20 60 70 69 64 70 38 69 60 0d 0a 60 70 69 | `pidp8i`..`pi
0940: 64 70 38 60 20 20 20 20 20 20 20 20 20 20 20 20 dp8`
0950: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 6d | m
0960: 6f 64 69 66 69 65 64 20 53 69 6d 48 20 73 69 6d odified SimH sim
0970: 75 6c 61 74 6f 72 20 66 6f 72 20 74 68 65 20 50 ulator for the P
0980: 69 44 50 2d 38 2f 49 20 70 61 6e 65 6c 20 20 20 iDP-8/I panel
0990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
09a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
09b0: 20 7c 20 60 70 69 64 70 38 69 2d 73 69 6d 60 0d | `pidp8i-sim`.
09c0: 0a 60 70 69 64 70 38 2d 74 65 73 74 60 20 20 20 .`pidp8-test`
09d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
09e0: 70 61 6e 65 6c 20 4c 45 44 20 61 6e 64 20 73 77 panel LED and sw
09f0: 69 74 63 68 20 74 65 73 74 20 70 72 6f 67 72 61 itch test progra
0a00: 6d 20 62 79 20 50 61 75 6c 20 52 2e 20 42 65 72 m by Paul R. Ber
0a10: 6e 61 72 64 2c 20 70 6f 73 74 65 64 20 74 6f 20 nard, posted to
0a20: 6d 61 69 6c 69 6e 67 20 6c 69 73 74 20 20 7c 20 mailing list |
0a30: 60 70 69 64 70 38 69 2d 74 65 73 74 60 0d 0a 60 `pidp8i-test`..`
0a40: 2f 65 74 63 2f 69 6e 69 74 2e 64 2f 70 69 64 70 /etc/init.d/pidp
0a50: 38 60 20 20 20 20 20 20 20 20 7c 20 69 6e 69 74 8` | init
0a60: 20 73 63 72 69 70 74 20 75 73 65 64 20 6f 6e 20 script used on
0a70: 62 6f 6f 74 20 74 6f 20 73 74 61 72 74 20 74 68 boot to start th
0a80: 65 20 73 6f 66 74 77 61 72 65 20 7c 20 60 7e 2f e software | `~/
0a90: 2e 6c 6f 63 61 6c 2f 73 68 61 72 65 2f 73 79 73 .local/share/sys
0aa0: 74 65 6d 64 2f 75 73 65 72 2f 70 69 64 70 38 69 temd/user/pidp8i
0ab0: 2e 73 65 72 76 69 63 65 60 0d 0a 60 2f 6f 70 74 .service`..`/opt
0ac0: 2f 70 69 64 70 38 60 20 20 20 20 20 20 20 20 20 /pidp8`
0ad0: 20 20 20 20 20 20 20 20 7c 20 64 65 66 61 75 6c | defaul
0ae0: 74 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 6c t installation l
0af0: 6f 63 61 74 69 6f 6e 20 28 61 2e 6b 2e 61 2e 20 ocation (a.k.a.
0b00: 24 70 72 65 66 69 78 29 20 20 20 20 20 20 20 20 $prefix)
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b30: 20 20 20 20 20 7c 20 60 2f 6f 70 74 2f 70 69 64 | `/opt/pid
0b40: 70 38 69 60 0d 0a 60 24 70 72 65 66 69 78 2f 62 p8i`..`$prefix/b
0b50: 69 6e 2f 73 63 61 6e 73 77 69 74 63 68 60 20 7c in/scanswitch` |
0b60: 20 68 65 6c 70 65 72 20 70 72 6f 67 72 61 6d 20 helper program
0b70: 66 6f 72 20 74 68 65 20 73 69 6d 75 6c 61 74 6f for the simulato
0b80: 72 20 73 74 61 72 74 75 70 20 73 63 72 69 70 74 r startup script
0b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0bb0: 7c 20 60 24 70 72 65 66 69 78 2f 6c 69 62 65 78 | `$prefix/libex
0bc0: 65 63 2f 73 63 61 6e 73 77 69 74 63 68 60 0d 0a ec/scanswitch`..
0bd0: 60 24 70 72 65 66 69 78 2f 62 6f 6f 74 73 63 72 `$prefix/bootscr
0be0: 69 70 74 73 60 20 20 7c 20 73 63 72 69 70 74 73 ipts` | scripts
0bf0: 20 74 68 61 74 20 74 65 6c 6c 20 74 68 65 20 73 that tell the s
0c00: 69 6d 75 6c 61 74 6f 72 20 68 6f 77 20 74 6f 20 imulator how to
0c10: 73 74 61 72 74 20 75 70 20 67 69 76 65 6e 20 64 start up given d
0c20: 69 66 66 65 72 65 6e 74 20 49 46 20 73 77 69 74 ifferent IF swit
0c30: 63 68 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 ch combinations
0c40: 7c 20 60 24 70 72 65 66 69 78 2f 73 68 61 72 65 | `$prefix/share
0c50: 2f 62 6f 6f 74 60 0d 0a 60 24 70 72 65 66 69 78 /boot`..`$prefix
0c60: 2f 69 6d 61 67 65 66 69 6c 65 73 60 20 20 20 20 /imagefiles`
0c70: 7c 20 62 69 6e 61 72 79 20 70 61 70 65 72 20 74 | binary paper t
0c80: 61 70 65 20 69 6d 61 67 65 73 2c 20 64 69 73 6b ape images, disk
0c90: 20 69 6d 61 67 65 73 2c 20 61 6e 64 20 73 75 63 images, and suc
0ca0: 68 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h
0cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0cc0: 20 7c 20 60 24 70 72 65 66 69 78 2f 73 68 61 72 | `$prefix/shar
0cd0: 65 2f 6d 65 64 69 61 60 0d 0a 0d 0a 49 20 61 64 e/media`....I ad
0ce0: 64 65 64 20 61 6e 20 60 69 60 20 74 6f 20 73 6f ded an `i` to so
0cf0: 6d 65 20 6f 66 20 74 68 65 73 65 20 6e 61 6d 65 me of these name
0d00: 73 20 66 6f 72 20 74 77 6f 20 72 65 61 73 6f 6e s for two reason
0d10: 73 3a 0d 0a 0d 0a 31 2e 20 20 49 74 20 77 61 73 s:....1. It was
0d20: 20 75 73 65 66 75 6c 20 64 75 72 69 6e 67 20 74 useful during t
0d30: 68 65 20 74 72 61 6e 73 69 74 69 6f 6e 20 70 65 he transition pe
0d40: 72 69 6f 64 20 73 6f 20 74 68 61 74 20 5b 62 6f riod so that [bo
0d50: 74 68 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 th versions of t
0d60: 68 65 20 73 6f 66 74 77 61 72 65 5d 28 23 72 75 he software](#ru
0d70: 6e 6e 69 6e 67 2d 62 6f 74 68 29 20 63 6f 75 6c nning-both) coul
0d80: 64 20 62 65 20 69 6e 73 74 61 6c 6c 65 64 20 6f d be installed o
0d90: 6e 20 74 68 65 20 73 61 6d 65 20 73 79 73 74 65 n the same syste
0da0: 6d 20 77 69 74 68 6f 75 74 20 63 6f 6e 66 6c 69 m without confli
0db0: 63 74 73 2e 0d 0a 0d 0a 32 2e 20 49 20 64 65 63 cts.....2. I dec
0dc0: 69 64 65 64 20 74 68 61 74 20 69 74 20 77 61 73 ided that it was
0dd0: 20 75 6e 6c 69 6b 65 6c 79 20 74 68 61 74 20 77 unlikely that w
0de0: 65 20 77 69 6c 6c 20 65 76 65 72 20 73 65 65 20 e will ever see
0df0: 61 20 66 6f 6c 6c 6f 77 2d 6f 6e 20 70 72 6f 6a a follow-on proj
0e00: 65 63 74 20 66 6f 72 20 61 20 64 69 66 66 65 72 ect for a differ
0e10: 65 6e 74 20 50 44 50 2d 38 20 66 72 6f 6e 74 20 ent PDP-8 front
0e20: 70 61 6e 65 6c 2c 20 73 69 6e 63 65 20 69 74 20 panel, since it
0e30: 61 70 70 65 61 72 73 20 4f 73 63 61 72 27 73 20 appears Oscar's
0e40: 67 6f 74 20 6f 74 68 65 72 20 70 72 6f 6a 65 63 got other projec
0e50: 74 73 20 73 74 61 63 6b 65 64 20 75 70 20 66 6f ts stacked up fo
0e60: 72 20 79 65 61 72 73 2e 20 49 66 20 68 65 20 65 r years. If he e
0e70: 76 65 72 20 6d 61 6b 65 73 20 69 74 20 62 61 63 ver makes it bac
0e80: 6b 20 61 6e 64 20 64 6f 65 73 2c 20 73 61 79 2c k and does, say,
0e90: 20 61 20 50 69 44 50 2d 38 2f 2a 2a 65 2a 2a 2c a PiDP-8/**e**,
0ea0: 20 77 65 20 6d 69 67 68 74 20 68 61 76 65 20 74 we might have t
0eb0: 6f 20 72 65 76 69 73 69 74 20 74 68 69 73 20 64 o revisit this d
0ec0: 65 63 69 73 69 6f 6e 2e 20 4d 65 61 6e 77 68 69 ecision. Meanwhi
0ed0: 6c 65 2c 20 74 68 65 20 70 72 6f 67 72 61 6d 73 le, the programs
0ee0: 20 69 6e 20 74 68 69 73 20 73 6f 66 74 77 61 72 in this softwar
0ef0: 65 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 74 e distribution t
0f00: 65 6e 64 20 74 6f 20 62 65 20 6e 61 6d 65 64 20 end to be named
0f10: 61 66 74 65 72 20 74 68 65 20 6f 6e 6c 79 20 68 after the only h
0f20: 61 72 64 77 61 72 65 20 74 68 65 79 20 61 72 65 ardware they are
0f30: 20 6b 6e 6f 77 6e 20 74 6f 20 77 6f 72 6b 20 77 known to work w
0f40: 69 74 68 2c 20 74 68 65 20 50 69 44 50 2d 38 2f ith, the PiDP-8/
0f50: 49 2e 0d 0a 0d 0a 54 68 65 20 66 69 6c 65 73 20 I.....The files
0f60: 6e 6f 77 20 75 6e 64 65 72 20 74 68 65 20 60 73 now under the `s
0f70: 68 61 72 65 60 20 73 75 62 64 69 72 65 63 74 6f hare` subdirecto
0f80: 72 79 20 77 65 72 65 20 6d 6f 76 65 64 20 74 6f ry were moved to
0f90: 20 63 6f 6e 66 6f 72 6d 20 74 6f 20 74 68 65 20 conform to the
0fa0: 4c 69 6e 75 78 20 46 69 6c 65 73 79 73 74 65 6d Linux Filesystem
0fb0: 20 48 69 65 72 61 72 63 68 79 20 53 74 61 6e 64 Hierarchy Stand
0fc0: 61 72 64 2c 20 73 6f 20 74 68 61 74 20 65 78 70 ard, so that exp
0fd0: 65 72 69 65 6e 63 65 64 20 4c 69 6e 75 78 20 75 erienced Linux u
0fe0: 73 65 72 73 20 77 6f 75 6c 64 20 62 65 20 6d 6f sers would be mo
0ff0: 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 67 75 65 re likely to gue
1000: 73 73 20 74 68 65 69 72 20 6c 6f 63 61 74 69 6f ss their locatio
1010: 6e 2e 0d 0a 0d 0a 54 68 65 20 72 65 61 73 6f 6e n.....The reason
1020: 20 66 6f 72 20 74 68 65 20 60 73 63 61 6e 73 77 for the `scansw
1030: 69 74 63 68 60 20 72 65 6c 6f 63 61 74 69 6f 6e itch` relocation
1040: 20 69 73 20 74 68 61 74 20 74 68 65 72 65 20 69 is that there i
1050: 73 20 6e 6f 20 72 65 61 73 6f 6e 20 66 6f 72 20 s no reason for
1060: 65 6e 64 20 75 73 65 72 73 20 74 6f 20 72 75 6e end users to run
1070: 20 69 74 20 64 69 72 65 63 74 6c 79 2c 20 73 6f it directly, so
1080: 20 69 74 27 73 20 62 65 74 74 65 72 20 6f 66 66 it's better off
1090: 20 6f 75 74 20 6f 66 20 74 68 65 20 75 73 65 72 out of the user
10a0: 27 73 20 60 50 41 54 48 60 2e 20 54 68 61 74 20 's `PATH`. That
10b0: 69 73 20 61 6c 73 6f 20 77 68 79 20 49 20 68 61 is also why I ha
10c0: 76 65 6e 27 74 20 62 6f 74 68 65 72 65 64 20 74 ven't bothered t
10d0: 6f 20 72 65 6e 61 6d 65 20 69 74 20 74 6f 20 73 o rename it to s
10e0: 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 60 70 omething like `p
10f0: 69 64 70 38 69 2d 73 63 61 6e 73 77 69 74 63 68 idp8i-scanswitch
1100: 60 2e 20 54 68 65 72 65 20 69 73 20 61 20 5b 70 `. There is a [p
1110: 6c 61 6e 5d 28 2f 74 6b 74 76 69 65 77 3f 6e 61 lan](/tktview?na
1120: 6d 65 3d 36 63 31 66 32 39 61 62 35 39 29 20 74 me=6c1f29ab59) t
1130: 6f 20 6d 65 72 67 65 20 74 68 69 73 20 70 72 6f o merge this pro
1140: 67 72 61 6d 20 77 69 74 68 20 60 70 69 64 70 38 gram with `pidp8
1150: 69 2d 74 65 73 74 60 2c 20 77 68 69 63 68 20 69 i-test`, which i
1160: 66 20 64 6f 6e 65 20 77 69 6c 6c 20 6d 65 61 6e f done will mean
1170: 20 60 73 63 61 6e 73 77 69 74 63 68 60 20 67 6f `scanswitch` go
1180: 65 73 20 61 77 61 79 2e 0d 0a 0d 0a 0d 0a 3c 61 es away.......<a
1190: 20 69 64 3d 22 73 65 72 76 69 63 65 22 3e 3c 2f id="service"></
11a0: 61 3e 0d 0a 23 23 20 54 68 65 20 50 69 44 50 2d a>..## The PiDP-
11b0: 38 2f 49 20 53 65 72 76 69 63 65 0d 0a 0d 0a 54 8/I Service....T
11c0: 68 65 20 77 61 79 20 79 6f 75 20 73 74 61 72 74 he way you start
11d0: 2c 20 73 74 6f 70 2c 20 72 65 73 74 61 72 74 2c , stop, restart,
11e0: 20 61 6e 64 20 71 75 65 72 79 20 74 68 65 20 62 and query the b
11f0: 61 63 6b 67 72 6f 75 6e 64 20 73 69 6d 75 6c 61 ackground simula
1200: 74 6f 72 20 73 65 72 76 69 63 65 20 68 61 73 20 tor service has
1210: 63 68 61 6e 67 65 64 2e 20 53 65 65 20 5b 74 68 changed. See [th
1220: 65 20 74 6f 70 2d 6c 65 76 65 6c 20 60 52 45 41 e top-level `REA
1230: 44 4d 45 2e 6d 64 60 20 66 69 6c 65 5d 28 2f 64 DME.md` file](/d
1240: 6f 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e oc/trunk/README.
1250: 6d 64 23 73 79 73 74 65 6d 64 29 20 66 6f 72 20 md#systemd) for
1260: 64 65 74 61 69 6c 73 2e 0d 0a 0d 0a 4f 6e 65 20 details.....One
1270: 64 65 74 61 69 6c 20 74 68 61 74 20 64 6f 63 20 detail that doc
1280: 64 6f 65 73 6e 27 74 20 63 6f 76 65 72 20 69 73 doesn't cover is
1290: 20 74 68 61 74 20 62 65 74 77 65 65 6e 20 74 68 that between th
12a0: 69 73 20 63 68 61 6e 67 65 20 61 6e 64 20 74 68 is change and th
12b0: 6f 73 65 20 64 6f 63 75 6d 65 6e 74 65 64 20 69 ose documented i
12c0: 6e 20 74 68 65 20 70 72 69 6f 72 20 73 65 63 74 n the prior sect
12d0: 69 6f 6e 2c 20 69 74 20 69 73 20 70 6f 73 73 69 ion, it is possi
12e0: 62 6c 65 20 74 6f 20 72 75 6e 20 62 6f 74 68 20 ble to run both
12f0: 74 68 65 20 63 75 72 72 65 6e 74 20 50 69 44 50 the current PiDP
1300: 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 20 66 72 -8/I software fr
1310: 6f 6d 20 74 68 69 73 20 77 65 62 20 73 69 74 65 om this web site
1320: 20 61 6c 6f 6e 67 73 69 64 65 20 4f 73 63 61 72 alongside Oscar
1330: 27 73 20 6c 61 73 74 20 73 74 61 62 6c 65 20 72 's last stable r
1340: 65 6c 65 61 73 65 2e 20 54 68 65 79 20 63 61 6e elease. They can
1350: 27 74 20 72 75 6e 20 73 69 6d 75 6c 74 61 6e 65 't run simultane
1360: 6f 75 73 6c 79 2c 20 73 69 6e 63 65 20 74 68 65 ously, since the
1370: 79 27 64 20 66 69 67 68 74 20 6f 76 65 72 20 74 y'd fight over t
1380: 68 65 20 66 72 6f 6e 74 20 70 61 6e 65 6c 20 47 he front panel G
1390: 50 49 4f 20 70 69 6e 73 2c 20 62 75 74 20 79 6f PIO pins, but yo
13a0: 75 20 63 61 6e 20 73 77 61 70 20 62 65 74 77 65 u can swap betwe
13b0: 65 6e 20 74 68 65 6d 20 61 74 20 77 69 6c 6c 2e en them at will.
13c0: 0d 0a 0d 0a 54 6f 20 72 75 6e 20 4f 73 63 61 72 ....To run Oscar
13d0: 27 73 20 66 69 6e 61 6c 20 73 74 61 62 6c 65 20 's final stable
13e0: 76 65 72 73 69 6f 6e 20 69 6e 73 74 65 61 64 20 version instead
13f0: 6f 66 20 74 68 69 73 20 73 6f 66 74 77 61 72 65 of this software
1400: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 2c 20 73 distribution, s
1410: 61 79 3a 0d 0a 0d 0a 20 20 20 20 24 20 70 69 64 ay:.... $ pid
1420: 70 38 69 20 73 74 6f 70 0d 0a 20 20 20 20 24 20 p8i stop.. $
1430: 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 sudo systemctl s
1440: 74 61 72 74 20 70 69 64 70 38 0d 0a 0d 0a 41 6e tart pidp8....An
1450: 64 20 74 68 65 6e 20 74 6f 20 73 77 69 74 63 68 d then to switch
1460: 20 62 61 63 6b 20 74 6f 20 74 68 69 73 20 76 65 back to this ve
1470: 72 73 69 6f 6e 3a 0d 0a 0d 0a 20 20 20 20 24 20 rsion:.... $
1480: 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 sudo systemctl s
1490: 74 6f 70 20 70 69 64 70 38 0d 0a 20 20 20 20 24 top pidp8.. $
14a0: 20 70 69 64 70 38 69 20 73 74 61 72 74 0d 0a 0d pidp8i start...
14b0: 0a 0d 0a 3c 61 20 69 64 3d 22 6d 75 6c 74 69 70 ...<a id="multip
14c0: 6c 65 22 3e 3c 2f 61 3e 0d 0a 23 23 20 4d 75 6c le"></a>..## Mul
14d0: 74 69 70 6c 65 20 49 6e 73 74 61 6c 6c 61 74 69 tiple Installati
14e0: 6f 6e 73 0d 0a 0d 0a 4f 73 63 61 72 27 73 20 66 ons....Oscar's f
14f0: 69 6e 61 6c 20 73 74 61 62 6c 65 20 76 65 72 73 inal stable vers
1500: 69 6f 6e 20 77 61 73 20 65 73 73 65 6e 74 69 61 ion was essentia
1510: 6c 6c 79 20 66 69 78 65 64 20 69 6e 20 70 6c 61 lly fixed in pla
1520: 63 65 20 69 6e 20 74 68 65 20 66 69 6c 65 73 79 ce in the filesy
1530: 73 74 65 6d 2e 20 49 74 73 20 73 6f 75 72 63 65 stem. Its source
1540: 20 63 6f 64 65 20 68 61 64 20 74 6f 20 62 65 20 code had to be
1550: 75 6e 70 61 63 6b 65 64 20 69 6e 74 6f 20 60 2f unpacked into `/
1560: 6f 70 74 2f 70 69 64 70 38 60 20 61 6e 64 20 72 opt/pidp8` and r
1570: 75 6e 20 66 72 6f 6d 20 74 68 65 72 65 20 74 6f un from there to
1580: 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 2e work correctly.
1590: 0d 0a 0d 0a 54 68 69 73 20 63 75 72 72 65 6e 74 ....This current
15a0: 20 73 6f 66 74 77 61 72 65 20 63 61 6e 20 62 65 software can be
15b0: 20 75 6e 70 61 63 6b 65 64 20 61 6e 79 77 68 65 unpacked anywhe
15c0: 72 65 20 69 6e 20 74 68 65 20 66 69 6c 65 73 79 re in the filesy
15d0: 73 74 65 6d 20 79 6f 75 20 68 61 76 65 20 73 75 stem you have su
15e0: 66 66 69 63 69 65 6e 74 20 61 63 63 65 73 73 20 fficient access
15f0: 70 65 72 6d 69 73 73 69 6f 6e 20 66 6f 72 2c 20 permission for,
1600: 79 6f 75 20 63 61 6e 20 62 75 69 6c 64 20 69 74 you can build it
1610: 20 69 6e 74 6f 20 61 20 73 65 63 6f 6e 64 20 64 into a second d
1620: 69 72 65 63 74 6f 72 79 20 73 65 70 61 72 61 74 irectory separat
1630: 65 20 66 72 6f 6d 20 74 68 65 20 73 6f 75 72 63 e from the sourc
1640: 65 20 64 69 72 65 63 74 6f 72 79 2c 20 61 6e 64 e directory, and
1650: 20 79 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c 6c you can install
1660: 20 69 74 20 74 6f 20 79 65 74 20 61 20 74 68 69 it to yet a thi
1670: 72 64 20 64 69 72 65 63 74 6f 72 79 2e 20 54 68 rd directory. Th
1680: 69 73 20 61 66 66 6f 72 64 73 20 63 6f 6e 73 69 is affords consi
1690: 64 65 72 61 62 6c 65 20 66 6c 65 78 69 62 69 6c derable flexibil
16a0: 69 74 79 20 69 6e 20 68 6f 77 20 79 6f 75 20 62 ity in how you b
16b0: 75 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c uild and install
16c0: 20 74 68 69 73 20 73 6f 66 74 77 61 72 65 2e 0d this software..
16d0: 0a 0d 0a 54 68 69 73 20 73 6f 66 74 77 61 72 65 ...This software
16e0: 20 61 6c 73 6f 20 64 6f 65 73 6e 27 74 20 6f 76 also doesn't ov
16f0: 65 72 77 72 69 74 65 20 79 6f 75 72 20 62 69 6e erwrite your bin
1700: 61 72 79 20 6d 65 64 69 61 20 6f 6e 20 72 65 2d ary media on re-
1710: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 3a 20 77 68 installation: wh
1720: 65 6e 65 76 65 72 20 77 65 20 73 68 69 70 20 61 enever we ship a
1730: 20 63 68 61 6e 67 65 20 74 6f 20 6f 6e 65 20 6f change to one o
1740: 66 20 74 68 65 20 70 61 70 65 72 20 74 61 70 65 f the paper tape
1750: 20 69 6d 61 67 65 73 2c 20 44 45 43 74 61 70 65 images, DECtape
1760: 20 69 6d 61 67 65 73 2c 20 52 4b 30 35 20 64 69 images, RK05 di
1770: 73 6b 20 69 6d 61 67 65 73 2c 20 65 74 63 2e 2c sk images, etc.,
1780: 20 75 70 67 72 61 64 69 6e 67 20 74 6f 20 74 68 upgrading to th
1790: 61 74 20 72 65 6c 65 61 73 65 20 6f 6e 6c 79 20 at release only
17a0: 67 65 74 73 20 79 6f 75 20 61 20 63 6f 70 79 20 gets you a copy
17b0: 6f 66 20 74 68 65 20 6e 65 77 20 6d 65 64 69 61 of the new media
17c0: 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 74 in the source t
17d0: 72 65 65 3b 20 74 68 6f 73 65 20 6e 65 77 20 76 ree; those new v
17e0: 65 72 73 69 6f 6e 73 20 64 6f 20 6e 6f 74 20 6f ersions do not o
17f0: 76 65 72 77 72 69 74 65 20 79 6f 75 72 20 6c 6f verwrite your lo
1800: 63 61 6c 20 63 6f 70 69 65 73 20 69 6e 20 74 68 cal copies in th
1810: 65 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 74 e installation t
1820: 72 65 65 2c 20 73 69 6e 63 65 20 74 68 65 79 20 ree, since they
1830: 6d 61 79 20 63 6f 6e 74 61 69 6e 20 6c 6f 63 61 may contain loca
1840: 6c 20 63 68 61 6e 67 65 73 2e 20 57 69 74 68 20 l changes. With
1850: 74 68 65 20 70 72 69 6f 72 20 73 74 61 62 6c 65 the prior stable
1860: 20 76 65 72 73 69 6f 6e 2c 20 73 69 6e 63 65 20 version, since
1870: 74 68 65 20 62 75 69 6c 64 20 61 6e 64 20 69 6e the build and in
1880: 73 74 61 6c 6c 61 74 69 6f 6e 20 6c 6f 63 61 74 stallation locat
1890: 69 6f 6e 73 20 77 65 72 65 20 74 68 65 20 73 61 ions were the sa
18a0: 6d 65 2c 20 75 70 67 72 61 64 69 6e 67 20 77 6f me, upgrading wo
18b0: 75 6c 64 20 61 6c 77 61 79 73 20 6f 76 65 72 77 uld always overw
18c0: 72 69 74 65 20 79 6f 75 72 20 6c 6f 63 61 6c 20 rite your local
18d0: 6d 65 64 69 61 20 69 6d 61 67 65 73 2e 20 53 65 media images. Se
18e0: 65 20 5b 4f 76 65 72 77 72 69 74 69 6e 67 20 74 e [Overwriting t
18f0: 68 65 20 4c 6f 63 61 6c 20 53 69 6d 75 6c 61 74 he Local Simulat
1900: 6f 72 20 53 65 74 75 70 5d 5b 6f 6c 73 73 5d 20 or Setup][olss]
1910: 66 6f 72 20 6d 6f 72 65 20 6f 6e 20 74 68 69 73 for more on this
1920: 20 74 6f 70 69 63 2e 0d 0a 0d 0a 5b 6f 6c 73 73 topic.....[olss
1930: 5d 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 ]: /doc/trunk/RE
1940: 41 44 4d 45 2e 6d 64 23 6f 76 65 72 77 72 69 74 ADME.md#overwrit
1950: 65 2d 73 65 74 75 70 0d 0a 0d 0a 0d 0a 3c 61 20 e-setup......<a
1960: 69 64 3d 22 69 6c 73 22 3e 3c 2f 61 3e 0d 0a 23 id="ils"></a>..#
1970: 23 20 49 6e 63 61 6e 64 65 73 63 65 6e 74 20 4c # Incandescent L
1980: 61 6d 70 20 53 69 6d 75 6c 61 74 6f 72 0d 0a 0d amp Simulator...
1990: 0a 57 68 65 6e 20 79 6f 75 20 62 75 69 6c 64 20 .When you build
19a0: 74 68 69 73 20 73 6f 66 74 77 61 72 65 20 6f 6e this software on
19b0: 20 61 20 6d 75 6c 74 69 2d 63 6f 72 65 20 50 69 a multi-core Pi
19c0: 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 , the default is
19d0: 20 74 6f 20 62 75 69 6c 64 20 74 68 65 20 50 69 to build the Pi
19e0: 44 50 2d 38 2f 49 20 73 69 6d 75 6c 61 74 6f 72 DP-8/I simulator
19f0: 20 77 69 74 68 20 74 68 65 20 5b 69 6e 63 61 6e with the [incan
1a00: 64 65 73 63 65 6e 74 20 6c 61 6d 70 20 73 69 6d descent lamp sim
1a10: 75 6c 61 74 6f 72 5d 5b 77 69 6c 73 5d 20 28 49 ulator][wils] (I
1a20: 4c 53 29 20 65 6e 61 62 6c 65 64 2c 20 61 73 20 LS) enabled, as
1a30: 6f 70 70 6f 73 65 64 20 74 6f 20 74 68 65 20 6f opposed to the o
1a40: 72 69 67 69 6e 61 6c 20 4c 45 44 20 64 72 69 76 riginal LED driv
1a50: 69 6e 67 20 63 6f 64 65 20 77 68 69 63 68 20 69 ing code which i
1a60: 73 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e 74 s more efficient
1a70: 20 62 75 74 20 6c 65 73 73 20 70 65 72 69 6f 64 but less period
1a80: 2d 61 63 63 75 72 61 74 65 20 69 6e 20 61 70 70 -accurate in app
1a90: 65 61 72 61 6e 63 65 2e 20 4f 6e 20 73 69 6e 67 earance. On sing
1aa0: 6c 65 2d 63 6f 72 65 20 50 69 73 2c 20 77 65 20 le-core Pis, we
1ab0: 62 75 69 6c 64 20 74 68 65 20 73 6f 66 74 77 61 build the softwa
1ac0: 72 65 20 74 6f 20 64 72 69 76 65 20 74 68 65 20 re to drive the
1ad0: 4c 45 44 73 20 69 6e 20 6d 75 63 68 20 74 68 65 LEDs in much the
1ae0: 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 same way as the
1af0: 20 70 72 69 6f 72 20 73 74 61 62 6c 65 20 76 65 prior stable ve
1b00: 72 73 69 6f 6e 20 64 6f 65 73 2c 20 62 65 63 61 rsion does, beca
1b10: 75 73 65 20 74 68 65 20 49 4c 53 20 74 61 6b 65 use the ILS take
1b20: 73 20 74 6f 6f 20 6d 75 63 68 20 43 50 55 20 74 s too much CPU t
1b30: 6f 20 72 75 6e 20 62 6f 74 68 20 69 74 20 61 6e o run both it an
1b40: 64 20 74 68 65 20 50 44 50 2d 38 20 73 69 6d 75 d the PDP-8 simu
1b50: 6c 61 74 6f 72 20 61 74 20 74 68 65 20 73 61 6d lator at the sam
1b60: 65 20 74 69 6d 65 20 6f 6e 20 61 20 73 69 6e 67 e time on a sing
1b70: 6c 65 20 37 30 30 20 4d 48 7a 20 41 52 4d 20 63 le 700 MHz ARM c
1b80: 6f 72 65 2e 20 59 6f 75 20 63 61 6e 20 66 6f 72 ore. You can for
1b90: 63 65 20 61 20 72 65 74 75 72 6e 20 74 6f 20 74 ce a return to t
1ba0: 68 65 20 6f 6c 64 20 65 66 66 69 63 69 65 6e 74 he old efficient
1bb0: 20 6d 65 74 68 6f 64 20 6f 6e 20 61 20 6d 75 6c method on a mul
1bc0: 74 69 2d 63 6f 72 65 20 50 69 20 62 79 20 63 6f ti-core Pi by co
1bd0: 6e 66 69 67 75 72 69 6e 67 20 74 68 65 20 73 6f nfiguring the so
1be0: 66 74 77 61 72 65 20 77 69 74 68 20 74 68 65 20 ftware with the
1bf0: 60 2d 2d 6e 6f 2d 6c 61 6d 70 2d 73 69 6d 75 6c `--no-lamp-simul
1c00: 61 74 6f 72 60 20 6f 70 74 69 6f 6e 2e 0d 0a 0d ator` option....
1c10: 0a 5b 77 69 6c 73 5d 3a 20 2f 77 69 6b 69 3f 6e .[wils]: /wiki?n
1c20: 61 6d 65 3d 49 6e 63 61 6e 64 65 73 63 65 6e 74 ame=Incandescent
1c30: 2b 4c 61 6d 70 2b 53 69 6d 75 6c 61 74 6f 72 0d +Lamp+Simulator.
1c40: 0a 0d 0a 0d 0a 3c 61 20 69 64 3d 22 6f 73 22 3e .....<a id="os">
1c50: 3c 2f 61 3e 0d 0a 23 23 20 52 75 6e 73 20 6f 6e </a>..## Runs on
1c60: 20 4d 6f 72 65 20 4f 53 65 73 0d 0a 0d 0a 54 68 More OSes....Th
1c70: 65 20 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 e PiDP-8/I softw
1c80: 61 72 65 20 6e 6f 77 20 62 75 69 6c 64 73 20 61 are now builds a
1c90: 6e 64 20 72 75 6e 73 20 6f 6e 20 6d 6f 72 65 20 nd runs on more
1ca0: 4f 53 20 74 79 70 65 73 20 74 68 61 6e 20 64 69 OS types than di
1cb0: 64 20 4f 73 63 61 72 27 73 20 6c 61 73 74 20 72 d Oscar's last r
1cc0: 65 6c 65 61 73 65 2c 20 77 68 69 63 68 20 77 61 elease, which wa
1cd0: 73 20 70 72 65 74 74 79 20 6d 75 63 68 20 74 69 s pretty much ti
1ce0: 65 64 20 74 6f 20 52 61 73 70 62 69 61 6e 20 61 ed to Raspbian a
1cf0: 6e 64 20 63 6c 6f 73 65 20 72 65 6c 61 74 69 76 nd close relativ
1d00: 65 73 20 6c 69 6b 65 20 70 69 70 61 4f 53 2e 20 es like pipaOS.
1d10: 46 75 6c 6c 20 64 65 74 61 69 6c 73 20 6f 6e 20 Full details on
1d20: 74 68 69 73 20 61 72 65 20 63 6f 76 65 72 65 64 this are covered
1d30: 20 5b 65 6c 73 65 77 68 65 72 65 5d 5b 77 6f 73 [elsewhere][wos
1d40: 63 5d 2e 0d 0a 0d 0a 5b 77 6f 73 63 5d 3a 20 2f c].....[wosc]: /
1d50: 77 69 6b 69 3f 6e 61 6d 65 3d 4f 53 2b 43 6f 6d wiki?name=OS+Com
1d60: 70 61 74 69 62 69 6c 69 74 79 29 2e 0d 0a 0d 0a patibility).....
1d70: 0d 0a 3c 61 20 69 64 3d 22 73 77 69 74 63 68 65 ..<a id="switche
1d80: 73 22 3e 3c 2f 61 3e 0d 0a 23 23 20 46 72 6f 6e s"></a>..## Fron
1d90: 74 20 50 61 6e 65 6c 20 53 77 69 74 63 68 20 43 t Panel Switch C
1da0: 6f 6d 62 6f 73 0d 0a 0d 0a 53 65 76 65 72 61 6c ombos....Several
1db0: 20 6f 66 20 74 68 65 20 50 69 44 50 2d 38 2f 49 of the PiDP-8/I
1dc0: 20 73 70 65 63 69 66 69 63 20 66 72 6f 6e 74 2d specific front-
1dd0: 70 61 6e 65 6c 20 73 77 69 74 63 68 20 63 6f 6d panel switch com
1de0: 62 6f 73 20 61 72 65 20 64 69 66 66 65 72 65 6e bos are differen
1df0: 74 3a 0d 0a 0d 0a 2a 20 20 20 60 53 69 6e 67 5f t:....* `Sing_
1e00: 53 74 65 70 60 20 2b 20 60 53 69 6e 67 5f 49 6e Step` + `Sing_In
1e10: 73 74 60 20 2b 20 60 53 74 61 72 74 60 20 6e 6f st` + `Start` no
1e20: 77 20 72 65 62 6f 6f 74 73 20 74 68 65 20 68 6f w reboots the ho
1e30: 73 74 20 50 69 2c 20 72 61 74 68 65 72 20 74 68 st Pi, rather th
1e40: 61 6e 20 70 6f 77 65 72 20 69 74 20 64 6f 77 6e an power it down
1e50: 2c 20 62 65 63 61 75 73 65 20 22 53 74 61 72 74 , because "Start
1e60: 22 20 6d 61 6b 65 73 20 6d 6f 72 65 20 73 65 6e " makes more sen
1e70: 73 65 20 61 73 20 61 20 6d 6e 65 6d 6f 6e 69 63 se as a mnemonic
1e80: 20 66 6f 72 20 22 72 65 73 74 61 72 74 2e 22 0d for "restart.".
1e90: 0a 0d 0a 2a 20 20 20 60 53 69 6e 67 5f 53 74 65 ...* `Sing_Ste
1ea0: 70 60 20 2b 20 60 53 69 6e 67 5f 49 6e 73 74 60 p` + `Sing_Inst`
1eb0: 20 2b 20 60 53 74 6f 70 60 20 6e 6f 77 20 70 6f + `Stop` now po
1ec0: 77 65 72 73 20 74 68 65 20 68 6f 73 74 20 50 69 wers the host Pi
1ed0: 20 64 6f 77 6e 2e 0d 0a 0d 0a 2a 20 20 20 60 53 down.....* `S
1ee0: 69 6e 67 5f 53 74 65 70 60 20 2b 20 60 53 69 6e ing_Step` + `Sin
1ef0: 67 5f 49 6e 73 74 60 20 2b 20 60 43 6f 6e 74 60 g_Inst` + `Cont`
1f00: 20 75 73 65 64 20 74 6f 20 72 65 62 6f 6f 74 20 used to reboot
1f10: 74 68 65 20 68 6f 73 74 20 50 69 2c 20 62 75 74 the host Pi, but
1f20: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 75 6e is currently un
1f30: 61 73 73 69 67 6e 65 64 2e 0d 0a 0d 0a 2a 20 20 assigned.....*
1f40: 20 60 53 69 6e 67 5f 53 74 65 70 60 20 2b 20 60 `Sing_Step` + `
1f50: 53 69 6e 67 5f 49 6e 73 74 60 20 2b 20 60 4c 6f Sing_Inst` + `Lo
1f60: 61 64 5f 41 64 64 60 20 75 73 65 64 20 74 6f 20 ad_Add` used to
1f70: 6d 6f 75 6e 74 20 74 68 65 20 55 53 42 20 73 74 mount the USB st
1f80: 69 63 6b 2c 20 62 75 74 20 74 68 61 74 20 69 73 ick, but that is
1f90: 20 75 6e 6e 65 63 65 73 73 61 72 79 2c 20 73 69 unnecessary, si
1fa0: 6e 63 65 20 74 68 65 20 73 6f 66 74 77 61 72 65 nce the software
1fb0: 20 6e 6f 77 20 75 73 65 73 20 52 61 73 70 62 69 now uses Raspbi
1fc0: 61 6e 27 73 20 55 53 42 20 61 75 74 6f 6d 6f 75 an's USB automou
1fd0: 6e 74 65 72 2e 0d 0a 0d 0a 2a 20 20 20 60 53 69 nter.....* `Si
1fe0: 6e 67 5f 53 74 65 70 60 20 2b 20 60 53 69 6e 67 ng_Step` + `Sing
1ff0: 5f 49 6e 73 74 60 20 2b 20 60 44 65 70 60 20 75 _Inst` + `Dep` u
2000: 73 65 64 20 74 6f 20 75 6e 6d 6f 75 6e 74 20 74 sed to unmount t
2010: 68 65 20 55 53 42 20 73 74 69 63 6b 2c 20 62 75 he USB stick, bu
2020: 74 20 74 68 61 74 20 69 73 20 75 6e 6e 65 63 65 t that is unnece
2030: 73 73 61 72 79 20 69 6e 20 74 68 69 73 20 69 6e ssary in this in
2040: 73 74 61 6e 63 65 20 73 69 6e 63 65 20 55 53 42 stance since USB
2050: 20 73 74 69 63 6b 73 20 61 72 65 20 70 72 69 6d sticks are prim
2060: 61 72 69 6c 79 20 75 73 65 64 20 74 6f 20 65 6d arily used to em
2070: 75 6c 61 74 65 20 70 61 70 65 72 20 74 61 70 65 ulate paper tape
2080: 73 2c 20 77 68 69 63 68 20 61 72 65 20 72 65 61 s, which are rea
2090: 64 2d 6f 6e 6c 79 20 6d 65 64 69 61 2e 20 59 6f d-only media. Yo
20a0: 75 20 64 6f 6e 27 74 20 68 61 76 65 20 74 6f 20 u don't have to
20b0: 75 6e 6d 6f 75 6e 74 20 74 68 65 20 73 74 69 63 unmount the stic
20c0: 6b 20 62 65 66 6f 72 65 20 75 6e 70 6c 75 67 67 k before unplugg
20d0: 69 6e 67 20 69 74 20 69 6e 20 6f 72 64 65 72 20 ing it in order
20e0: 74 6f 20 61 76 6f 69 64 20 66 69 6c 65 73 79 73 to avoid filesys
20f0: 74 65 6d 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 tem corruption i
2100: 6e 20 69 6e 73 74 61 6e 63 65 73 20 6c 69 6b 65 n instances like
2110: 20 74 68 69 73 2e 0d 0a 0d 0a 2a 20 20 20 60 53 this.....* `S
2120: 69 6e 67 5f 53 74 65 70 60 20 2b 20 60 44 46 3d ing_Step` + `DF=
2130: 37 60 20 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 7` changed from
2140: 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 60 2a looking for a `*
2150: 2e 72 6c 60 20 66 69 6c 65 20 74 6f 20 6d 6f 75 .rl` file to mou
2160: 6e 74 20 61 73 20 61 6e 20 52 4c 30 31 20 64 69 nt as an RL01 di
2170: 73 6b 20 70 61 63 6b 20 69 6d 61 67 65 20 74 6f sk pack image to
2180: 20 65 78 70 65 63 74 69 6e 67 20 61 6e 20 60 2a expecting an `*
2190: 2e 72 6b 60 20 66 69 6c 65 20 61 6e 64 20 6d 6f .rk` file and mo
21a0: 75 6e 74 69 6e 67 20 69 74 20 6f 6e 20 74 68 65 unting it on the
21b0: 20 73 65 63 6f 6e 64 20 60 52 4b 30 35 60 20 64 second `RK05` d
21c0: 69 73 6b 20 64 72 69 76 65 2e 20 54 68 65 20 52 isk drive. The R
21d0: 4c 20 73 65 72 69 65 73 20 64 72 69 76 65 73 20 L series drives
21e0: 70 6f 73 74 64 61 74 65 73 20 74 68 65 20 50 44 postdates the PD
21f0: 50 2d 38 2f 49 20 62 79 20 6d 61 6e 79 20 79 65 P-8/I by many ye
2200: 61 72 73 2c 20 61 6e 64 20 74 68 65 20 73 74 6f ars, and the sto
2210: 63 6b 20 4f 53 2f 38 20 63 6f 6e 66 69 67 75 72 ck OS/8 configur
2220: 61 74 69 6f 6e 20 73 68 69 70 73 20 61 73 20 61 ation ships as a
2230: 6e 20 52 4b 30 35 20 69 6d 61 67 65 20 74 68 61 n RK05 image tha
2240: 74 20 6d 6f 75 6e 74 73 20 6f 6e 20 74 68 65 20 t mounts on the
2250: 66 69 72 73 74 20 64 72 69 76 65 2c 20 73 6f 20 first drive, so
2260: 74 68 69 73 20 6e 65 77 20 6d 65 61 6e 69 6e 67 this new meaning
2270: 20 66 65 65 6c 73 20 6d 6f 72 65 20 61 70 70 72 feels more appr
2280: 6f 70 72 69 61 74 65 20 6f 6e 20 6d 61 6e 79 20 opriate on many
2290: 61 78 65 73 2e 20 54 68 65 20 6f 74 68 65 72 20 axes. The other
22a0: 60 44 46 60 20 73 65 74 74 69 6e 67 73 20 72 65 `DF` settings re
22b0: 74 61 69 6e 20 74 68 65 69 72 20 5b 73 74 6f 63 tain their [stoc
22c0: 6b 20 6d 65 61 6e 69 6e 67 73 5d 28 68 74 74 70 k meanings](http
22d0: 3a 2f 2f 6f 62 73 6f 6c 65 73 63 65 6e 63 65 2e ://obsolescence.
22e0: 77 69 78 73 69 74 65 2e 63 6f 6d 2f 6f 62 73 6f wixsite.com/obso
22f0: 6c 65 73 63 65 6e 63 65 2f 68 6f 77 2d 74 6f 2d lescence/how-to-
2300: 75 73 65 2d 74 68 65 2d 70 69 64 70 2d 38 29 2e use-the-pidp-8).
2310: 0d 0a 0d 0a 54 68 65 73 65 20 61 72 65 20 61 6c ....These are al
2320: 6c 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 3a 20 l combinations:
2330: 74 68 65 20 74 77 6f 20 6f 72 20 74 68 72 65 65 the two or three
2340: 20 73 77 69 74 63 68 65 73 20 69 6e 76 6f 6c 76 switches involv
2350: 65 64 20 61 6c 6c 20 68 61 76 65 20 74 6f 20 62 ed all have to b
2360: 65 20 63 6c 6f 73 65 64 20 61 74 20 74 68 65 20 e closed at the
2370: 73 61 6d 65 20 74 69 6d 65 20 66 6f 72 20 74 68 same time for th
2380: 65 20 61 63 74 69 6f 6e 20 74 6f 20 6f 63 63 75 e action to occu
2390: 72 2e 20 49 74 20 64 6f 65 73 6e 27 74 20 6d 61 r. It doesn't ma
23a0: 74 74 65 72 20 77 68 69 63 68 20 6f 72 64 65 72 tter which order
23b0: 20 79 6f 75 20 63 6c 6f 73 65 20 74 68 6f 73 65 you close those
23c0: 20 63 6f 6e 74 61 63 74 73 3a 20 74 68 65 20 73 contacts: the s
23d0: 6f 66 74 77 61 72 65 20 74 61 6b 65 73 20 61 63 oftware takes ac
23e0: 74 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 6c 61 tion when the la
23f0: 73 74 20 6f 6e 65 20 63 6c 6f 73 65 73 2e 20 49 st one closes. I
2400: 74 27 73 20 75 73 75 61 6c 6c 79 20 65 61 73 69 t's usually easi
2410: 65 73 74 20 74 6f 20 63 6c 6f 73 65 20 74 68 65 est to close the
2420: 20 73 69 6d 70 6c 65 20 74 6f 67 67 6c 65 73 20 simple toggles
2430: 66 69 72 73 74 2c 20 74 68 65 6e 20 63 6c 69 63 first, then clic
2440: 6b 20 74 68 65 20 6d 6f 6d 65 6e 74 61 72 79 20 k the momentary
2450: 60 53 69 6e 67 5f 53 74 65 70 60 20 61 6e 64 2f `Sing_Step` and/
2460: 6f 72 20 60 53 69 6e 67 5f 49 6e 73 74 60 20 6f or `Sing_Inst` o
2470: 6e 63 65 20 61 6e 64 20 72 65 6c 65 61 73 65 2e nce and release.
2480: 20 59 6f 75 20 63 61 6e 20 74 68 65 6e 20 66 6c You can then fl
2490: 69 70 20 74 68 65 20 6f 74 68 65 72 20 74 6f 67 ip the other tog
24a0: 67 6c 65 20 62 61 63 6b 20 74 6f 20 69 74 73 20 gle back to its
24b0: 70 72 69 6f 72 20 73 74 61 74 65 2c 20 69 66 20 prior state, if
24c0: 79 6f 75 20 6c 69 6b 65 2e 0d 0a 0d 0a 0d 0a 23 you like.......#
24d0: 23 20 4c 69 63 65 6e 73 65 0d 0a 0d 0a 43 6f 70 # License....Cop
24e0: 79 72 69 67 68 74 20 c2 a9 20 32 30 31 37 2d 32 yright © 2017-2
24f0: 30 31 39 20 62 79 20 57 61 72 72 65 6e 20 59 6f 019 by Warren Yo
2500: 75 6e 67 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 ung. This docume
2510: 6e 74 20 69 73 20 6c 69 63 65 6e 73 65 64 20 75 nt is licensed u
2520: 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 6f nder the terms o
2530: 66 20 5b 74 68 65 20 53 49 4d 48 20 6c 69 63 65 f [the SIMH lice
2540: 6e 73 65 5d 5b 73 6c 5d 2e 0d 0a 0d 0a 5b 73 6c nse][sl].....[sl
2550: 5d 3a 20 2f 64 6f 63 2f 74 72 75 6e 6b 2f 53 49 ]: /doc/trunk/SI
2560: 4d 48 2d 4c 49 43 45 4e 53 45 2e 6d 64 0a 5a 20 MH-LICENSE.md.Z
2570: 33 66 33 30 63 37 32 33 34 66 62 38 31 63 31 62 3f30c7234fb81c1b
2580: 34 62 35 61 35 61 33 66 35 39 33 35 62 32 63 32 4b5a5a3f5935b2c2
2590: 0a .