Artifact
37b9507f98f462ada123d83c4eddb5d2ba1ce848:
Wiki page
[Incandescent Thought] by
tangent
2017-12-10 17:14:40.
0000: 44 20 32 30 31 37 2d 31 32 2d 31 30 54 31 37 3a D 2017-12-10T17:
0010: 31 34 3a 34 30 2e 30 35 36 0a 4c 20 49 6e 63 61 14:40.056.L Inca
0020: 6e 64 65 73 63 65 6e 74 5c 73 54 68 6f 75 67 68 ndescent\sThough
0030: 74 0a 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 t.N text/x-markd
0040: 6f 77 6e 0a 50 20 63 34 66 66 64 62 31 32 38 34 own.P c4ffdb1284
0050: 37 38 63 63 31 37 61 62 66 63 63 63 33 31 35 35 78cc17abfccc3155
0060: 62 33 39 61 62 38 30 66 35 36 66 31 63 34 0a 55 b39ab80f56f1c4.U
0070: 20 74 61 6e 67 65 6e 74 0a 57 20 35 32 33 30 0a tangent.W 5230.
0080: 23 20 54 68 65 20 53 69 74 75 61 74 69 6f 6e 0d # The Situation.
0090: 0a 0d 0a 49 6e 20 46 65 62 72 75 61 72 79 20 32 ...In February 2
00a0: 30 31 36 2c 20 4e 6f 72 6d 61 6e 20 44 61 76 69 016, Norman Davi
00b0: 65 20 72 65 6c 65 61 73 65 64 20 61 20 70 72 6f e released a pro
00c0: 67 72 61 6d 20 68 65 20 63 61 6c 6c 65 64 20 5b gram he called [
00d0: 44 65 65 70 65 72 20 54 68 6f 75 67 68 74 5d 28 Deeper Thought](
00e0: 68 74 74 70 73 3a 2f 2f 67 72 6f 75 70 73 2e 67 https://groups.g
00f0: 6f 6f 67 6c 65 2e 63 6f 6d 2f 66 6f 72 75 6d 2f oogle.com/forum/
0100: 23 21 6d 73 67 2f 70 69 64 70 2d 38 2f 74 62 63 #!msg/pidp-8/tbc
0110: 69 56 4e 6f 5a 4a 62 77 2f 41 4d 6a 79 77 52 4b iVNoZJbw/AMjywRK
0120: 4c 41 77 41 4a 29 20 61 66 74 65 72 20 61 6e 20 LAwAJ) after an
0130: 65 61 72 6c 69 65 72 20 70 72 6f 67 72 61 6d 20 earlier program
0140: 62 79 20 53 74 65 76 65 20 47 69 62 73 6f 6e 20 by Steve Gibson
0150: 63 61 6c 6c 65 64 20 5b 44 65 65 70 20 54 68 6f called [Deep Tho
0160: 75 67 68 74 5d 28 68 74 74 70 73 3a 2f 2f 77 77 ught](https://ww
0170: 77 2e 67 72 63 2e 63 6f 6d 2f 70 64 70 2d 38 2f w.grc.com/pdp-8/
0180: 64 65 65 70 74 68 6f 75 67 68 74 2d 73 62 63 2e deepthought-sbc.
0190: 68 74 6d 29 2e 20 54 68 65 20 6d 6f 73 74 20 69 htm). The most i
01a0: 6d 70 6f 72 74 61 6e 74 20 64 69 66 66 65 72 65 mportant differe
01b0: 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 nce between thes
01c0: 65 20 74 77 6f 20 70 72 6f 67 72 61 6d 73 20 66 e two programs f
01d0: 6f 72 20 6f 75 72 20 70 75 72 70 6f 73 65 73 20 or our purposes
01e0: 68 65 72 65 20 69 73 20 74 68 61 74 20 69 6e 73 here is that ins
01f0: 74 65 61 64 20 6f 66 20 72 75 6e 6e 69 6e 67 20 tead of running
0200: 61 73 20 50 44 50 2d 38 20 63 6f 64 65 20 77 69 as PDP-8 code wi
0210: 74 68 69 6e 20 74 68 65 20 73 69 6d 75 6c 61 74 thin the simulat
0220: 6f 72 2c 20 61 73 20 47 69 62 73 6f 6e 27 73 20 or, as Gibson's
0230: 70 72 6f 67 72 61 6d 20 64 6f 65 73 2c 20 44 61 program does, Da
0240: 76 69 65 27 73 20 44 65 65 70 65 72 20 54 68 6f vie's Deeper Tho
0250: 75 67 68 74 20 72 75 6e 73 20 61 73 20 61 20 6e ught runs as a n
0260: 61 74 69 76 65 20 70 72 6f 67 72 61 6d 20 6f 6e ative program on
0270: 20 74 68 65 20 52 61 73 70 62 65 72 72 79 20 50 the Raspberry P
0280: 69 2c 20 75 73 69 6e 67 20 61 20 76 65 72 73 69 i, using a versi
0290: 6f 6e 20 6f 66 20 4f 73 63 61 72 20 56 65 72 6d on of Oscar Verm
02a0: 65 75 6c 65 6e 27 73 20 6f 72 69 67 69 6e 61 6c eulen's original
02b0: 20 60 67 70 69 6f 2e 63 60 20 6d 6f 64 75 6c 65 `gpio.c` module
02c0: 20 74 6f 20 6d 61 6e 69 70 75 6c 61 74 65 20 74 to manipulate t
02d0: 68 65 20 4c 45 44 73 20 6f 6e 20 74 68 65 20 50 he LEDs on the P
02e0: 69 44 50 2d 38 2f 49 27 73 20 66 72 6f 6e 74 20 iDP-8/I's front
02f0: 70 61 6e 65 6c 20 61 6e 64 20 72 65 61 64 20 69 panel and read i
0300: 74 73 20 73 77 69 74 63 68 65 73 2e 0d 0a 0d 0a ts switches.....
0310: 44 61 76 69 65 27 73 20 70 72 6f 67 72 61 6d 20 Davie's program
0320: 68 61 73 20 62 65 65 6e 20 5b 66 6f 72 6b 65 64 has been [forked
0330: 20 73 65 76 65 72 61 6c 20 74 69 6d 65 73 5d 28 several times](
0340: 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63 https://github.c
0350: 6f 6d 2f 74 69 6d 64 61 77 67 2f 44 65 65 70 65 om/timdawg/Deepe
0360: 72 2d 54 6f 75 67 68 74 2d 32 2f 6e 65 74 77 6f r-Tought-2/netwo
0370: 72 6b 29 2c 20 62 75 74 20 74 68 69 73 20 6d 6f rk), but this mo
0380: 64 65 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 20 de of operation
0390: 72 65 6d 61 69 6e 73 20 69 6e 20 61 6c 6c 20 6f remains in all o
03a0: 66 20 74 68 65 20 76 65 72 73 69 6f 6e 73 20 49 f the versions I
03b0: 27 76 65 20 74 72 69 65 64 2e 0d 0a 0d 0a 57 68 've tried.....Wh
03c0: 65 6e 20 49 61 6e 20 53 63 68 6f 66 69 65 6c 64 en Ian Schofield
03d0: 20 63 72 65 61 74 65 64 20 74 68 65 20 5b 69 6e created the [in
03e0: 63 61 6e 64 65 73 63 65 6e 74 20 6c 61 6d 70 20 candescent lamp
03f0: 73 69 6d 75 6c 61 74 6f 72 5d 28 2f 77 69 6b 69 simulator](/wiki
0400: 3f 6e 61 6d 65 3d 49 6e 63 61 6e 64 65 73 63 65 ?name=Incandesce
0410: 6e 74 2b 4c 61 6d 70 2b 53 69 6d 75 6c 61 74 6f nt+Lamp+Simulato
0420: 72 29 20 28 49 4c 53 29 20 66 6f 72 20 74 68 65 r) (ILS) for the
0430: 20 50 69 44 50 2d 38 2f 49 2c 20 68 65 20 63 68 PiDP-8/I, he ch
0440: 61 6e 67 65 64 20 74 68 65 20 65 78 74 65 72 6e anged the extern
0450: 61 6c 20 69 6e 74 65 72 66 61 63 65 20 69 6e 20 al interface in
0460: 61 20 63 6f 75 70 6c 65 20 6f 66 20 77 61 79 73 a couple of ways
0470: 20 77 68 69 63 68 20 70 72 65 76 65 6e 74 65 64 which prevented
0480: 20 69 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 75 it from being u
0490: 73 65 64 20 77 69 74 68 20 61 6e 79 20 6f 66 20 sed with any of
04a0: 74 68 65 73 65 20 76 65 72 73 69 6f 6e 73 20 6f these versions o
04b0: 66 20 44 65 65 70 65 72 20 54 68 6f 75 67 68 74 f Deeper Thought
04c0: 2e 0d 0a 0d 0a 57 68 65 6e 20 49 20 72 65 77 72 .....When I rewr
04d0: 6f 74 65 20 74 68 65 20 49 4c 53 2c 20 6f 6e 65 ote the ILS, one
04e0: 20 6f 66 20 74 68 65 20 74 68 69 6e 67 73 20 49 of the things I
04f0: 20 64 69 64 20 77 61 73 20 61 64 64 20 61 20 63 did was add a c
0500: 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 69 6e 74 ompatibility int
0510: 65 72 66 61 63 65 20 66 6f 72 20 70 72 6f 67 72 erface for progr
0520: 61 6d 73 20 6c 69 6b 65 20 44 65 65 70 65 72 20 ams like Deeper
0530: 54 68 6f 75 67 68 74 20 77 68 69 63 68 20 72 65 Thought which re
0540: 6d 61 69 6e 20 64 65 70 65 6e 64 65 6e 74 20 6f main dependent o
0550: 6e 20 74 68 65 20 6f 6c 64 20 60 67 70 69 6f 2e n the old `gpio.
0560: 63 60 20 6d 6f 64 75 6c 65 20 69 6e 74 65 72 66 c` module interf
0570: 61 63 65 2e 20 54 68 69 73 20 61 72 74 69 63 6c ace. This articl
0580: 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 e describes the
0590: 73 74 65 70 73 20 79 6f 75 20 6d 75 73 74 20 74 steps you must t
05a0: 61 6b 65 20 74 6f 20 62 75 69 6c 64 20 61 20 76 ake to build a v
05b0: 65 72 73 69 6f 6e 20 6f 66 20 44 65 65 70 65 72 ersion of Deeper
05c0: 20 54 68 6f 75 67 68 74 20 61 67 61 69 6e 73 74 Thought against
05d0: 20 6f 75 72 20 6e 65 77 20 49 4c 53 2e 0d 0a 0d our new ILS....
05e0: 0a 0d 0a 23 20 4d 6f 64 69 66 79 69 6e 67 20 60 ...# Modifying `
05f0: 64 65 65 70 65 72 2e 63 60 0d 0a 0d 0a 54 68 65 deeper.c`....The
0600: 20 66 69 72 73 74 20 74 68 69 6e 67 20 79 6f 75 first thing you
0610: 20 68 61 76 65 20 74 6f 20 64 6f 20 74 6f 20 62 have to do to b
0620: 75 69 6c 64 20 61 6e 79 20 76 65 72 73 69 6f 6e uild any version
0630: 20 6f 66 20 44 65 65 70 65 72 20 54 68 6f 75 67 of Deeper Thoug
0640: 68 74 20 61 67 61 69 6e 73 74 20 74 68 65 20 63 ht against the c
0650: 75 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 20 6f urrent version o
0660: 66 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 73 f the PiDP-8/I s
0670: 6f 66 74 77 61 72 65 20 69 73 20 63 6f 70 79 20 oftware is copy
0680: 69 74 73 20 60 64 65 65 70 65 72 2e 63 60 20 66 its `deeper.c` f
0690: 69 6c 65 20 69 6e 74 6f 20 74 68 65 20 50 69 44 ile into the PiD
06a0: 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 27 73 P-8/I software's
06b0: 20 60 73 72 63 60 20 73 75 62 64 69 72 65 63 74 `src` subdirect
06c0: 6f 72 79 3a 0d 0a 0d 0a 20 20 20 20 24 20 63 64 ory:.... $ cd
06d0: 20 7e 2f 70 69 64 70 38 69 20 20 20 20 20 20 20 ~/pidp8i
06e0: 20 20 20 20 20 20 20 20 20 20 20 e2 87 a0 20 6f ⇠o
06f0: 72 20 77 68 65 72 65 76 65 72 20 74 68 65 20 50 r wherever the P
0700: 69 44 50 2d 38 2f 49 20 73 6f 75 72 63 65 20 63 iDP-8/I source c
0710: 6f 64 65 20 69 73 0d 0a 20 20 20 20 24 20 63 70 ode is.. $ cp
0720: 20 2f 70 61 74 68 2f 74 6f 2f 64 65 65 70 65 72 /path/to/deeper
0730: 2f 74 68 6f 75 67 68 74 2f 64 65 65 70 65 72 2e /thought/deeper.
0740: 63 20 73 72 63 0d 0a 0d 0a 55 73 65 20 79 6f 75 c src....Use you
0750: 72 20 66 61 76 6f 72 69 74 65 20 4c 69 6e 75 78 r favorite Linux
0760: 20 74 65 78 74 20 65 64 69 74 6f 72 20 74 6f 20 text editor to
0770: 6d 61 6b 65 20 61 20 66 65 77 20 61 64 6a 75 73 make a few adjus
0780: 74 6d 65 6e 74 73 20 74 6f 20 60 73 72 63 2f 64 tments to `src/d
0790: 65 65 70 65 72 2e 63 60 20 74 6f 20 67 65 74 20 eeper.c` to get
07a0: 69 74 20 74 6f 20 62 75 69 6c 64 3a 0d 0a 0d 0a it to build:....
07b0: 31 2e 20 41 64 64 20 74 68 65 20 66 6f 6c 6c 6f 1. Add the follo
07c0: 77 69 6e 67 20 6c 69 6e 65 20 62 65 74 77 65 65 wing line betwee
07d0: 6e 20 74 68 65 20 62 69 67 20 62 6c 6f 63 6b 20 n the big block
07e0: 63 6f 6d 6d 65 6e 74 20 61 74 20 74 68 65 20 74 comment at the t
07f0: 6f 70 20 6f 66 20 74 68 65 20 66 69 6c 65 20 61 op of the file a
0800: 6e 64 20 74 68 65 20 60 23 69 6e 63 6c 75 64 65 nd the `#include
0810: 60 20 6c 69 6e 65 73 20 66 6f 6c 6c 6f 77 69 6e ` lines followin
0820: 67 20 69 74 2c 20 61 74 20 6c 69 6e 65 20 31 35 g it, at line 15
0830: 36 20 6f 72 20 73 6f 3a 0d 0a 0d 0a 20 20 20 20 6 or so:....
0840: 20 20 20 20 23 69 6e 63 6c 75 64 65 20 22 67 70 #include "gp
0850: 69 6f 2d 63 6f 6d 6d 6f 6e 2e 68 22 0d 0a 0d 0a io-common.h"....
0860: 32 2e 20 52 65 6d 6f 76 65 20 74 68 65 73 65 20 2. Remove these
0870: 6c 69 6e 65 73 2c 20 66 6f 75 6e 64 20 75 70 20 lines, found up
0880: 61 6d 6f 6e 67 20 74 68 65 20 60 23 69 6e 63 6c among the `#incl
0890: 75 64 65 60 20 6c 69 6e 65 73 3a 0d 0a 0d 0a 20 ude` lines:....
08a0: 20 20 20 20 20 20 20 65 78 74 65 72 6e 20 76 6f extern vo
08b0: 69 64 20 2a 62 6c 69 6e 6b 28 76 6f 69 64 20 2a id *blink(void *
08c0: 70 74 72 29 3b 20 2f 2f 20 74 68 65 20 72 65 61 ptr); // the rea
08d0: 6c 2d 74 69 6d 65 20 6d 75 6c 74 69 70 6c 65 78 l-time multiplex
08e0: 69 6e 67 20 70 72 6f 63 65 73 73 20 74 6f 20 73 ing process to s
08f0: 74 61 72 74 20 75 70 0d 0a 20 20 20 20 20 20 20 tart up..
0900: 20 65 78 74 65 72 6e 20 75 69 6e 74 33 32 20 6c extern uint32 l
0910: 65 64 73 74 61 74 75 73 5b 38 5d 3b 20 20 20 20 edstatus[8];
0920: 20 2f 2f 20 62 69 74 66 69 65 6c 64 73 3a 20 38 // bitfields: 8
0930: 20 6c 65 64 72 6f 77 73 20 6f 66 20 75 70 20 74 ledrows of up t
0940: 6f 20 31 32 20 4c 45 44 73 0d 0a 20 20 20 20 20 o 12 LEDs..
0950: 20 20 20 65 78 74 65 72 6e 20 75 69 6e 74 33 32 extern uint32
0960: 20 73 77 69 74 63 68 73 74 61 74 75 73 5b 33 5d switchstatus[3]
0970: 3b 20 20 2f 2f 20 62 69 74 66 69 65 6c 64 73 3a ; // bitfields:
0980: 20 33 20 72 6f 77 73 20 6f 66 20 75 70 20 74 6f 3 rows of up to
0990: 20 31 32 20 73 77 69 74 63 68 65 73 0d 0a 0d 0a 12 switches....
09a0: 33 2e 20 52 65 70 6c 61 63 65 20 74 68 65 20 62 3. Replace the b
09b0: 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 62 65 67 lock of code beg
09c0: 69 6e 6e 69 6e 67 20 77 69 74 68 20 74 68 65 20 inning with the
09d0: 60 70 74 68 72 65 61 64 5f 63 72 65 61 74 65 28 `pthread_create(
09e0: 29 60 20 63 61 6c 6c 20 61 6e 64 20 65 6e 64 69 )` call and endi
09f0: 6e 67 20 77 69 74 68 20 60 73 6c 65 65 70 28 32 ng with `sleep(2
0a00: 29 60 20 e2 80 94 20 69 6e 63 6c 75 73 69 76 65 )` — inclusive
0a10: 20 e2 80 94 20 77 69 74 68 20 74 68 65 20 66 6f — with the fo
0a20: 6c 6c 6f 77 69 6e 67 3a 0d 0a 0d 0a 20 20 20 20 llowing:....
0a30: 20 20 20 20 70 69 64 70 38 69 5f 73 69 6d 70 6c pidp8i_simpl
0a40: 65 5f 67 70 69 6f 5f 6d 6f 64 65 20 3d 20 31 3b e_gpio_mode = 1;
0a50: 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28 73 74 .. if (st
0a60: 61 72 74 5f 70 69 64 70 38 69 5f 67 70 69 6f 5f art_pidp8i_gpio_
0a70: 74 68 72 65 61 64 20 28 22 44 65 65 70 65 72 20 thread ("Deeper
0a80: 54 68 6f 75 67 68 74 20 32 22 29 20 21 3d 20 30 Thought 2") != 0
0a90: 29 20 65 78 69 74 20 28 45 58 49 54 5f 46 41 49 ) exit (EXIT_FAI
0aa0: 4c 55 52 45 29 3b 0d 0a 0d 0a 57 69 74 68 20 74 LURE);....With t
0ab0: 68 61 74 20 64 6f 6e 65 2c 20 79 6f 75 20 6d 75 hat done, you mu
0ac0: 73 74 20 72 65 63 6f 6e 66 69 67 75 72 65 20 74 st reconfigure t
0ad0: 68 65 20 73 6f 66 74 77 61 72 65 20 74 6f 20 67 he software to g
0ae0: 65 74 20 69 74 20 74 6f 20 72 65 63 6f 67 6e 69 et it to recogni
0af0: 7a 65 20 74 68 61 74 20 60 64 65 65 70 65 72 2e ze that `deeper.
0b00: 63 60 20 68 61 73 20 62 65 65 6e 20 61 64 64 65 c` has been adde
0b10: 64 20 74 6f 20 74 68 65 20 60 73 72 63 60 20 73 d to the `src` s
0b20: 75 62 64 69 72 65 63 74 6f 72 79 2e 20 49 66 20 ubdirectory. If
0b30: 79 6f 75 27 72 65 20 68 61 70 70 79 20 77 69 74 you're happy wit
0b40: 68 20 79 6f 75 72 20 63 75 72 72 65 6e 74 20 63 h your current c
0b50: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 74 68 onfiguration, th
0b60: 69 73 20 77 69 6c 6c 20 64 6f 20 74 68 65 20 74 is will do the t
0b70: 72 69 63 6b 3a 0d 0a 0d 0a 20 20 20 20 24 20 6d rick:.... $ m
0b80: 61 6b 65 20 72 65 63 6f 6e 66 69 67 0d 0a 0d 0a ake reconfig....
0b90: 4f 74 68 65 72 77 69 73 65 2c 20 72 65 2d 72 65 Otherwise, re-re
0ba0: 61 64 20 60 52 45 41 44 4d 45 2e 6d 64 60 20 61 ad `README.md` a
0bb0: 6e 64 20 72 75 6e 20 60 63 6f 6e 66 69 67 75 72 nd run `configur
0bc0: 65 60 20 6d 61 6e 75 61 6c 6c 79 3a 0d 0a 0d 0a e` manually:....
0bd0: 20 20 20 20 24 20 2e 2f 63 6f 6e 66 69 67 75 72 $ ./configur
0be0: 65 20 2d 2d 77 69 74 68 2d 79 6f 75 72 2d 6e 65 e --with-your-ne
0bf0: 77 2d 6f 70 74 69 6f 6e 2d 73 65 74 0d 0a 0d 0a w-option-set....
0c00: 45 69 74 68 65 72 20 77 61 79 2c 20 61 6d 6f 6e Either way, amon
0c10: 67 20 74 68 65 20 6c 69 6e 65 73 20 69 6e 20 74 g the lines in t
0c20: 68 65 20 60 63 6f 6e 66 69 67 75 72 65 60 20 73 he `configure` s
0c30: 63 72 69 70 74 20 6f 75 74 70 75 74 20 73 68 6f cript output sho
0c40: 75 6c 64 20 62 65 20 74 68 69 73 20 6f 6e 65 3a uld be this one:
0c50: 0d 0a 0d 0a 20 20 20 20 46 6f 75 6e 64 20 44 65 .... Found De
0c60: 65 70 65 72 20 54 68 6f 75 67 68 74 3b 20 62 75 eper Thought; bu
0c70: 69 6c 64 69 6e 67 20 69 74 20 61 67 61 69 6e 73 ilding it agains
0c80: 74 20 49 4c 53 20 47 50 49 4f 20 6d 6f 64 75 6c t ILS GPIO modul
0c90: 65 0d 0a 0d 0a 49 66 20 79 6f 75 20 72 65 63 6f e....If you reco
0ca0: 6e 66 69 67 75 72 65 20 69 74 20 6f 6e 20 61 20 nfigure it on a
0cb0: 6d 75 6c 74 69 2d 63 6f 72 65 20 50 69 20 73 75 multi-core Pi su
0cc0: 63 68 20 61 73 20 74 68 65 20 50 69 20 32 20 6f ch as the Pi 2 o
0cd0: 72 20 50 69 20 33 2c 20 69 74 20 77 69 6c 6c 20 r Pi 3, it will
0ce0: 62 75 69 6c 64 20 61 67 61 69 6e 73 74 20 74 68 build against th
0cf0: 65 20 49 4c 53 3b 20 6f 74 68 65 72 77 69 73 65 e ILS; otherwise
0d00: 2c 20 69 74 20 77 69 6c 6c 20 62 75 69 6c 64 20 , it will build
0d10: 61 67 61 69 6e 73 74 20 74 68 65 20 4e 4c 53 2c against the NLS,
0d20: 20 77 68 69 63 68 20 6d 61 79 20 6c 6f 6f 6b 20 which may look
0d30: 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65 72 65 slightly differe
0d40: 6e 74 20 66 72 6f 6d 20 74 68 65 20 61 70 70 65 nt from the appe
0d50: 61 72 61 6e 63 65 20 79 6f 75 20 67 65 74 20 66 arance you get f
0d60: 72 6f 6d 20 74 68 65 20 6f 6c 64 20 60 67 70 69 rom the old `gpi
0d70: 6f 2e 63 60 20 6d 6f 64 75 6c 65 2c 20 62 75 74 o.c` module, but
0d80: 20 69 74 20 70 72 6f 62 61 62 6c 79 20 69 73 6e it probably isn
0d90: 27 74 20 77 6f 72 74 68 20 63 6f 6e 74 69 6e 75 't worth continu
0da0: 69 6e 67 20 75 6e 6c 65 73 73 20 79 6f 75 27 72 ing unless you'r
0db0: 65 20 73 69 6d 70 6c 79 20 63 75 72 69 6f 75 73 e simply curious
0dc0: 2e 0d 0a 0d 0a 4e 6f 77 20 79 6f 75 20 63 61 6e .....Now you can
0dd0: 20 74 72 79 20 73 61 79 69 6e 67 20 60 6d 61 6b try saying `mak
0de0: 65 60 2e 20 49 66 20 74 68 65 20 73 6f 66 74 77 e`. If the softw
0df0: 61 72 65 20 62 75 69 6c 64 73 2c 20 79 6f 75 20 are builds, you
0e00: 63 61 6e 20 6e 6f 77 20 72 75 6e 20 69 74 20 61 can now run it a
0e10: 73 20 60 73 75 64 6f 20 62 69 6e 2f 64 65 65 70 s `sudo bin/deep
0e20: 65 72 60 2e 0d 0a 0d 0a 49 66 20 79 6f 75 20 77 er`.....If you w
0e30: 61 6e 74 20 74 6f 20 69 6e 73 74 61 6c 6c 20 69 ant to install i
0e40: 74 2c 20 49 20 72 65 63 6f 6d 6d 65 6e 64 20 74 t, I recommend t
0e50: 68 61 74 20 79 6f 75 20 62 75 69 6c 64 20 61 6e hat you build an
0e60: 64 20 69 6e 73 74 61 6c 6c 20 44 65 65 70 65 72 d install Deeper
0e70: 20 54 68 6f 75 67 68 74 20 69 6e 20 74 68 65 20 Thought in the
0e80: 6e 6f 72 6d 61 6c 20 77 61 79 2c 20 74 68 65 6e normal way, then
0e90: 20 63 6f 70 79 20 74 68 65 20 60 62 69 6e 2f 64 copy the `bin/d
0ea0: 65 65 70 65 72 60 20 65 78 65 63 75 74 61 62 6c eeper` executabl
0eb0: 65 20 79 6f 75 20 62 75 69 6c 74 20 61 62 6f 76 e you built abov
0ec0: 65 20 6f 76 65 72 20 74 68 65 20 74 6f 70 20 6f e over the top o
0ed0: 66 20 74 68 65 20 6e 6f 72 6d 61 6c 20 6f 6e 65 f the normal one
0ee0: 2e 20 54 68 69 73 20 6c 65 74 73 20 79 6f 75 20 . This lets you
0ef0: 6c 65 76 65 72 61 67 65 20 74 68 65 20 72 65 73 leverage the res
0f00: 74 20 6f 66 20 74 68 65 20 69 6e 73 74 61 6c 6c t of the install
0f10: 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 73 68 ation process sh
0f20: 69 70 70 65 64 20 77 69 74 68 20 44 65 65 70 65 ipped with Deepe
0f30: 72 20 54 68 6f 75 67 68 74 2c 20 73 75 63 68 20 r Thought, such
0f40: 61 73 20 69 6e 73 74 61 6c 6c 69 6e 67 20 74 68 as installing th
0f50: 65 20 60 64 65 65 70 65 72 60 20 73 79 73 74 65 e `deeper` syste
0f60: 6d 20 73 65 72 76 69 63 65 2e 0d 0a 0d 0a 0d 0a m service.......
0f70: 23 20 44 69 73 61 62 6c 69 6e 67 20 74 68 65 20 # Disabling the
0f80: 50 69 44 50 2d 38 2f 49 20 53 69 6d 75 6c 61 74 PiDP-8/I Simulat
0f90: 6f 72 0d 0a 0d 0a 49 66 20 79 6f 75 20 77 61 6e or....If you wan
0fa0: 74 20 44 65 65 70 65 72 20 54 68 6f 75 67 68 74 t Deeper Thought
0fb0: 20 74 6f 20 72 75 6e 20 62 79 20 64 65 66 61 75 to run by defau
0fc0: 6c 74 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 lt instead of th
0fd0: 65 20 50 69 44 50 2d 38 2f 49 20 73 69 6d 75 6c e PiDP-8/I simul
0fe0: 61 74 6f 72 2c 20 73 61 79 3a 0d 0a 0d 0a 20 20 ator, say:....
0ff0: 20 20 24 20 73 75 64 6f 20 73 79 73 74 65 6d 63 $ sudo systemc
1000: 74 6c 20 73 74 6f 70 20 70 69 64 70 38 69 0d 0a tl stop pidp8i..
1010: 20 20 20 20 24 20 73 75 64 6f 20 73 79 73 74 65 $ sudo syste
1020: 6d 63 74 6c 20 64 69 73 61 62 6c 65 20 70 69 64 mctl disable pid
1030: 70 38 69 0d 0a 0d 0a 54 68 65 20 44 65 65 70 65 p8i....The Deepe
1040: 72 20 54 68 6f 75 67 68 74 20 69 6e 73 74 61 6c r Thought instal
1050: 6c 65 72 20 73 63 72 69 70 74 20 77 69 6c 6c 20 ler script will
1060: 6d 61 72 6b 20 69 74 73 20 73 65 72 76 69 63 65 mark its service
1070: 20 74 6f 20 73 74 61 72 74 20 62 79 20 64 65 66 to start by def
1080: 61 75 6c 74 2e 20 49 66 20 79 6f 75 20 64 6f 6e ault. If you don
1090: 27 74 20 67 69 76 65 20 74 68 6f 73 65 20 74 77 't give those tw
10a0: 6f 20 63 6f 6d 6d 61 6e 64 73 2c 20 44 65 65 70 o commands, Deep
10b0: 65 72 20 54 68 6f 75 67 68 74 20 77 69 6c 6c 20 er Thought will
10c0: 63 72 61 73 68 20 6f 6e 20 62 6f 6f 74 20 62 65 crash on boot be
10d0: 63 61 75 73 65 20 69 74 20 63 61 6e 27 74 20 67 cause it can't g
10e0: 72 61 62 20 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 rab control over
10f0: 20 74 68 65 20 47 50 49 4f 20 6c 69 6e 65 73 20 the GPIO lines
1100: 67 6f 69 6e 67 20 74 6f 20 74 68 65 20 50 69 44 going to the PiD
1110: 50 2d 38 2f 49 20 66 72 6f 6e 74 20 70 61 6e 65 P-8/I front pane
1120: 6c 20 77 68 69 6c 65 20 74 68 65 20 50 69 44 50 l while the PiDP
1130: 2d 38 2f 49 20 73 69 6d 75 6c 61 74 6f 72 20 69 -8/I simulator i
1140: 73 20 72 75 6e 6e 69 6e 67 2e 0d 0a 0d 0a 0d 0a s running.......
1150: 23 20 52 65 76 65 72 74 69 6e 67 20 74 6f 20 42 # Reverting to B
1160: 6f 6f 74 20 77 69 74 68 20 74 68 65 20 50 69 44 oot with the PiD
1170: 50 2d 38 2f 49 20 53 69 6d 75 6c 61 74 6f 72 0d P-8/I Simulator.
1180: 0a 0d 0a 54 6f 20 72 65 76 65 72 74 20 74 68 65 ...To revert the
1190: 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 69 6e changes made in
11a0: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 65 the previous se
11b0: 63 74 69 6f 6e 20 61 6e 64 20 6d 61 72 6b 20 44 ction and mark D
11c0: 65 65 70 65 72 20 54 68 6f 75 67 68 74 20 74 6f eeper Thought to
11d0: 20 6e 6f 74 20 73 74 61 72 74 20 6f 6e 20 62 6f not start on bo
11e0: 6f 74 2c 20 73 61 79 3a 0d 0a 0d 0a 20 20 20 20 ot, say:....
11f0: 24 20 73 75 64 6f 20 73 79 73 74 65 6d 63 74 6c $ sudo systemctl
1200: 20 73 74 6f 70 20 64 65 65 70 65 72 0d 0a 20 20 stop deeper..
1210: 20 20 24 20 73 75 64 6f 20 73 79 73 74 65 6d 63 $ sudo systemc
1220: 74 6c 20 64 69 73 61 62 6c 65 20 64 65 65 70 65 tl disable deepe
1230: 72 0d 0a 20 20 20 20 24 20 73 75 64 6f 20 73 79 r.. $ sudo sy
1240: 73 74 65 6d 63 74 6c 20 65 6e 61 62 6c 65 20 70 stemctl enable p
1250: 69 64 70 38 69 0d 0a 20 20 20 20 24 20 73 75 64 idp8i.. $ sud
1260: 6f 20 73 79 73 74 65 6d 63 74 6c 20 73 74 61 72 o systemctl star
1270: 74 20 70 69 64 70 38 69 0d 0a 0d 0a 0d 0a 23 20 t pidp8i......#
1280: 57 68 79 20 4e 6f 74 20 4d 61 6b 65 20 54 68 69 Why Not Make Thi
1290: 73 20 45 61 73 79 3f 0d 0a 0d 0a 59 6f 75 20 6d s Easy?....You m
12a0: 69 67 68 74 20 62 65 20 77 6f 6e 64 65 72 69 6e ight be wonderin
12b0: 67 20 77 68 79 20 49 20 64 65 73 63 72 69 62 65 g why I describe
12c0: 20 68 6f 77 20 74 6f 20 6d 6f 64 69 66 79 20 60 how to modify `
12d0: 64 65 65 70 65 72 2e 63 60 20 74 6f 20 62 75 69 deeper.c` to bui
12e0: 6c 64 20 61 67 61 69 6e 73 74 20 74 68 65 20 50 ld against the P
12f0: 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 iDP-8/I software
1300: 20 69 6e 73 74 65 61 64 20 6f 66 20 6a 75 73 74 instead of just
1310: 20 69 6e 74 65 67 72 61 74 69 6e 67 20 69 74 20 integrating it
1320: 61 6e 64 20 73 68 69 70 70 69 6e 67 20 69 74 20 and shipping it
1330: 61 6c 6f 6e 67 20 77 69 74 68 20 69 74 2e 20 49 along with it. I
1340: 74 27 73 20 62 65 63 61 75 73 65 20 74 68 69 73 t's because this
1350: 20 73 6f 66 74 77 61 72 65 20 69 73 20 6e 6f 74 software is not
1360: 20 6c 69 63 65 6e 73 65 64 20 75 6e 64 65 72 20 licensed under
1370: 61 6e 79 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 any open source
1380: 6c 69 63 65 6e 73 65 2c 20 61 6e 64 20 61 74 74 license, and att
1390: 65 6d 70 74 73 20 74 6f 20 67 65 74 20 74 68 65 empts to get the
13a0: 20 61 75 74 68 6f 72 73 20 74 6f 20 73 6f 20 6c authors to so l
13b0: 69 63 65 6e 73 65 20 69 74 20 68 61 76 65 20 62 icense it have b
13c0: 65 65 6e 20 69 67 6e 6f 72 65 64 2e 20 54 68 65 een ignored. The
13d0: 72 65 66 6f 72 65 2c 20 49 20 63 61 6e 6e 6f 74 refore, I cannot
13e0: 20 72 65 2d 64 69 73 74 72 69 62 75 74 65 20 74 re-distribute t
13f0: 68 69 73 20 73 6f 66 74 77 61 72 65 2c 20 65 76 his software, ev
1400: 65 6e 20 74 68 6f 75 67 68 20 69 74 20 69 73 20 en though it is
1410: 66 72 65 65 6c 79 2d 61 76 61 69 6c 61 62 6c 65 freely-available
1420: 20 6f 6e 20 74 68 65 20 49 6e 74 65 72 6e 65 74 on the Internet
1430: 2e 0d 0a 0d 0a 0d 0a 23 23 20 4c 69 63 65 6e 73 .......## Licens
1440: 65 0d 0a 0d 0a 43 6f 70 79 72 69 67 68 74 20 c2 e....Copyright Â
1450: a9 20 32 30 31 37 20 62 79 20 57 61 72 72 65 6e © 2017 by Warren
1460: 20 59 6f 75 6e 67 2e 20 54 68 69 73 20 64 6f 63 Young. This doc
1470: 75 6d 65 6e 74 20 69 73 20 6c 69 63 65 6e 73 65 ument is license
1480: 64 20 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d d under the term
1490: 73 20 6f 66 20 5b 74 68 65 20 53 49 4d 48 20 6c s of [the SIMH l
14a0: 69 63 65 6e 73 65 5d 5b 73 6c 5d 2e 0d 0a 0d 0a icense][sl].....
14b0: 5b 73 6c 5d 3a 20 68 74 74 70 73 3a 2f 2f 74 61 [sl]: https://ta
14c0: 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 70 69 ngentsoft.com/pi
14d0: 64 70 38 69 2f 64 6f 63 2f 74 72 75 6e 6b 2f 53 dp8i/doc/trunk/S
14e0: 49 4d 48 2d 4c 49 43 45 4e 53 45 2e 6d 64 0a 5a IMH-LICENSE.md.Z
14f0: 20 38 39 35 30 35 30 65 63 62 30 62 33 64 61 33 895050ecb0b3da3
1500: 39 32 31 66 63 66 34 35 65 31 39 33 34 38 35 34 921fcf45e1934854
1510: 34 0a 4.