PiDP-8/I Software

Hex Artifact Content
Log In

Artifact e823003cf5bacb3f476ae29faaf5acce89e9b730:

Wiki page [OS Compatibility] by tangent 2019-05-11 14:06:24.
0000: 44 20 32 30 31 39 2d 30 35 2d 31 31 54 31 34 3a  D 2019-05-11T14:
0010: 30 36 3a 32 34 2e 37 38 33 0a 4c 20 4f 53 5c 73  06:24.783.L OS\s
0020: 43 6f 6d 70 61 74 69 62 69 6c 69 74 79 0a 4e 20  Compatibility.N 
0030: 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 6e 0a  text/x-markdown.
0040: 50 20 36 33 39 33 31 64 62 63 38 61 33 30 31 65  P 63931dbc8a301e
0050: 39 62 33 61 31 38 39 34 35 31 37 66 39 65 32 32  9b3a1894517f9e22
0060: 66 61 34 64 34 31 62 64 32 36 0a 55 20 74 61 6e  fa4d41bd26.U tan
0070: 67 65 6e 74 0a 57 20 35 35 31 30 0a 23 20 54 68  gent.W 5510.# Th
0080: 65 20 53 69 74 75 61 74 69 6f 6e 0d 0a 0d 0a 41  e Situation....A
0090: 6c 74 68 6f 75 67 68 20 74 68 65 20 63 6f 72 65  lthough the core
00a0: 20 73 6f 66 74 77 61 72 65 20 75 6e 64 65 72 6c   software underl
00b0: 79 69 6e 67 20 74 68 65 20 50 69 44 50 2d 38 2f  ying the PiDP-8/
00c0: 49 20 73 6f 66 74 77 61 72 65 20 64 69 73 74 72  I software distr
00d0: 69 62 75 74 69 6f 6e 20 69 73 20 62 72 6f 61 64  ibution is broad
00e0: 6c 79 20 70 6f 72 74 61 62 6c 65 2c 20 74 68 65  ly portable, the
00f0: 20 64 6f 6d 69 6e 61 6e 63 65 20 6f 66 20 52 61   dominance of Ra
0100: 73 70 62 69 61 6e 20 69 6e 20 74 68 65 20 52 61  spbian in the Ra
0110: 73 70 62 65 72 72 79 20 50 69 20 73 70 61 63 65  spberry Pi space
0120: 20 6d 65 61 6e 73 20 69 74 20 67 65 74 73 20 74   means it gets t
0130: 68 65 20 6d 6f 73 74 20 61 74 74 65 6e 74 69 6f  he most attentio
0140: 6e 20 77 68 65 6e 20 69 74 20 63 6f 6d 65 73 20  n when it comes 
0150: 74 6f 20 74 65 73 74 69 6e 67 20 61 6e 64 20 64  to testing and d
0160: 65 76 65 6c 6f 70 6d 65 6e 74 2e 20 54 68 69 73  evelopment. This
0170: 20 61 72 74 69 63 6c 65 20 64 6f 63 75 6d 65 6e   article documen
0180: 74 73 20 77 68 61 74 20 69 74 20 6b 6e 6f 77 6e  ts what it known
0190: 20 74 6f 20 77 6f 72 6b 2c 20 77 68 65 72 65 2c   to work, where,
01a0: 20 74 6f 64 61 79 2e 0d 0a 0d 0a 49 66 20 79 6f   today.....If yo
01b0: 75 20 6e 65 65 64 20 74 68 65 20 73 6f 66 74 77  u need the softw
01c0: 61 72 65 20 74 6f 20 77 6f 72 6b 20 6f 6e 20 73  are to work on s
01d0: 6f 6d 65 20 70 6c 61 74 66 6f 72 6d 20 77 68 65  ome platform whe
01e0: 72 65 20 69 74 20 63 75 72 72 65 6e 74 6c 79 20  re it currently 
01f0: 64 6f 65 73 6e 27 74 2c 20 5b 77 65 20 61 63 63  doesn't, [we acc
0200: 65 70 74 20 70 61 74 63 68 65 73 21 5d 28 2f 64  ept patches!](/d
0210: 6f 63 2f 74 72 75 6e 6b 2f 48 41 43 4b 45 52 53  oc/trunk/HACKERS
0220: 2e 6d 64 29 20 59 6f 75 20 63 61 6e 20 61 6c 73  .md) You can als
0230: 6f 20 73 65 6e 64 20 70 72 6f 62 6c 65 6d 20 72  o send problem r
0240: 65 70 6f 72 74 73 20 5b 74 6f 20 6f 75 72 20 64  eports [to our d
0250: 65 76 65 6c 6f 70 6d 65 6e 74 20 66 6f 72 75 6d  evelopment forum
0260: 5d 28 2f 66 6f 72 75 6d 29 2c 20 66 69 6c 65 20  ](/forum), file 
0270: 61 20 5b 62 75 67 20 72 65 70 6f 72 74 5d 28 2f  a [bug report](/
0280: 62 75 67 73 29 2c 20 6f 72 20 5b 64 69 73 63 75  bugs), or [discu
0290: 73 73 20 69 74 20 6f 6e 20 74 68 65 20 75 73 65  ss it on the use
02a0: 72 73 27 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74  rs' mailing list
02b0: 5d 28 68 74 74 70 73 3a 2f 2f 67 72 6f 75 70 73  ](https://groups
02c0: 2e 67 6f 6f 67 6c 65 2e 63 6f 6d 2f 66 6f 72 75  .google.com/foru
02d0: 6d 2f 23 21 66 6f 72 75 6d 2f 70 69 64 70 2d 38  m/#!forum/pidp-8
02e0: 29 2e 0d 0a 0d 0a 0d 0a 23 20 52 61 73 70 62 69  ).......# Raspbi
02f0: 61 6e 2c 20 44 65 62 69 61 6e 2c 20 55 62 75 6e  an, Debian, Ubun
0300: 74 75 0d 0a 0d 0a 54 68 65 20 63 75 72 72 65 6e  tu....The curren
0310: 74 20 73 74 61 62 6c 65 20 72 65 6c 65 61 73 65  t stable release
0320: 20 6f 66 20 74 68 65 20 50 69 44 50 2d 38 2f 49   of the PiDP-8/I
0330: 20 73 6f 66 74 77 61 72 65 20 64 69 73 74 72 69   software distri
0340: 62 75 74 69 6f 6e 20 77 61 73 20 62 75 69 6c 74  bution was built
0350: 20 66 6f 72 20 61 6e 64 20 74 65 73 74 65 64 20   for and tested 
0360: 77 69 74 68 20 74 68 65 20 5b 52 61 73 70 62 69  with the [Raspbi
0370: 61 6e 20 53 74 72 65 74 63 68 20 4c 69 74 65 5d  an Stretch Lite]
0380: 28 68 74 74 70 73 3a 2f 2f 77 77 77 2e 72 61 73  (https://www.ras
0390: 70 62 65 72 72 79 70 69 2e 6f 72 67 2f 62 6c 6f  pberrypi.org/blo
03a0: 67 2f 72 61 73 70 62 69 61 6e 2d 73 74 72 65 74  g/raspbian-stret
03b0: 63 68 2f 29 20 64 69 73 74 72 69 62 75 74 69 6f  ch/) distributio
03c0: 6e 2e 20 50 72 69 6f 72 20 72 65 6c 65 61 73 65  n. Prior release
03d0: 73 20 77 65 72 65 20 62 75 69 6c 74 20 61 74 6f  s were built ato
03e0: 70 20 74 68 65 20 5b 52 61 73 70 62 69 61 6e 20  p the [Raspbian 
03f0: 4a 65 73 73 69 65 20 4c 69 74 65 5d 28 68 74 74  Jessie Lite](htt
0400: 70 73 3a 2f 2f 77 77 77 2e 72 61 73 70 62 65 72  ps://www.raspber
0410: 72 79 70 69 2e 6f 72 67 2f 62 6c 6f 67 2f 72 61  rypi.org/blog/ra
0420: 73 70 62 69 61 6e 2d 6a 65 73 73 69 65 2d 69 73  spbian-jessie-is
0430: 2d 68 65 72 65 2f 29 20 64 69 73 74 72 69 62 75  -here/) distribu
0440: 74 69 6f 6e 3b 20 63 75 72 72 65 6e 74 20 73 6f  tion; current so
0450: 66 74 77 61 72 65 20 73 68 6f 75 6c 64 20 73 74  ftware should st
0460: 69 6c 6c 20 77 6f 72 6b 20 6f 6e 20 4a 65 73 73  ill work on Jess
0470: 69 65 2c 20 74 68 6f 75 67 68 20 77 65 20 6e 6f  ie, though we no
0480: 20 6c 6f 6e 67 65 72 20 74 65 73 74 20 74 68 61   longer test tha
0490: 74 2c 20 68 61 76 69 6e 67 20 75 70 67 72 61 64  t, having upgrad
04a0: 65 64 20 61 6c 6c 20 6f 66 20 6f 75 72 20 64 65  ed all of our de
04b0: 76 65 6c 6f 70 6d 65 6e 74 20 73 79 73 74 65 6d  velopment system
04c0: 73 20 74 6f 20 53 74 72 65 74 63 68 2e 0d 0a 0d  s to Stretch....
04d0: 0a 52 61 73 70 62 69 61 6e 2d 62 61 73 65 64 20  .Raspbian-based 
04e0: 4f 53 65 73 20 6c 69 6b 65 20 5b 70 69 70 61 4f  OSes like [pipaO
04f0: 53 5d 28 68 74 74 70 3a 2f 2f 70 69 70 61 6f 73  S](http://pipaos
0500: 2e 6d 69 74 61 6b 6f 2e 65 75 2f 29 20 73 68 6f  .mitako.eu/) sho
0510: 75 6c 64 20 61 6c 73 6f 20 77 6f 72 6b 2c 20 62  uld also work, b
0520: 75 74 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74  ut this is not t
0530: 65 73 74 65 64 20 62 79 20 74 68 65 20 70 72 6f  ested by the pro
0540: 6a 65 63 74 27 73 20 63 75 72 72 65 6e 74 20 64  ject's current d
0550: 65 76 65 6c 6f 70 65 72 73 2e 0d 0a 0d 0a 54 68  evelopers.....Th
0560: 65 20 70 72 6f 6a 65 63 74 27 73 20 70 72 69 6d  e project's prim
0570: 61 72 79 20 6d 61 69 6e 74 61 69 6e 65 72 20 6f  ary maintainer o
0580: 63 63 61 73 69 6f 6e 61 6c 6c 79 20 62 75 69 6c  ccasionally buil
0590: 64 73 20 74 68 65 20 73 6f 66 74 77 61 72 65 20  ds the software 
05a0: 6f 6e 20 44 65 62 69 61 6e 20 61 6e 64 20 55 62  on Debian and Ub
05b0: 75 6e 74 75 20 73 79 73 74 65 6d 73 20 61 73 20  untu systems as 
05c0: 77 65 6c 6c 2c 20 77 68 69 63 68 20 77 6f 72 6b  well, which work
05d0: 73 20 66 69 6e 65 2c 20 73 69 6e 63 65 20 52 61  s fine, since Ra
05e0: 73 70 62 69 61 6e 20 61 6e 64 20 55 62 75 6e 74  spbian and Ubunt
05f0: 75 20 61 72 65 20 62 6f 74 68 20 64 65 72 69 76  u are both deriv
0600: 61 74 69 76 65 73 20 6f 66 20 44 65 62 69 61 6e  atives of Debian
0610: 2e 20 4f 6e 20 73 75 63 68 20 73 79 73 74 65 6d  . On such system
0620: 73 2c 20 74 68 65 20 73 6f 66 74 77 61 72 65 20  s, the software 
0630: 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 64  is designed to d
0640: 65 74 65 63 74 20 74 68 65 20 61 62 73 65 6e 63  etect the absenc
0650: 65 20 6f 66 20 74 68 65 20 50 69 44 50 2d 38 2f  e of the PiDP-8/
0660: 49 20 66 72 6f 6e 74 20 70 61 6e 65 6c 20 68 61  I front panel ha
0670: 72 64 77 61 72 65 20 61 6e 64 20 77 6f 72 6b 20  rdware and work 
0680: 77 69 74 68 6f 75 74 20 69 74 2e 0d 0a 0d 0a 42  without it.....B
0690: 65 63 61 75 73 65 20 6f 66 20 74 68 61 74 20 73  ecause of that s
06a0: 75 63 63 65 73 73 2c 20 77 65 20 65 78 70 65 63  uccess, we expec
06b0: 74 20 69 74 20 77 69 6c 6c 20 72 75 6e 20 6f 6e  t it will run on
06c0: 20 61 6e 79 20 6f 74 68 65 72 20 44 65 62 69 61   any other Debia
06d0: 6e 20 64 65 72 69 76 61 74 69 76 65 2c 20 74 6f  n derivative, to
06e0: 6f 2e 0d 0a 0d 0a 54 68 65 20 63 6f 6e 66 69 67  o.....The config
06f0: 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 20 61  uration script a
0700: 6e 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  nd documentation
0710: 20 61 64 76 69 63 65 20 6f 6e 20 69 6e 73 74 61   advice on insta
0720: 6c 6c 69 6e 67 20 74 68 69 72 64 2d 70 61 72 74  lling third-part
0730: 79 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 69  y dependencies i
0740: 73 20 67 69 76 65 6e 20 69 6e 20 74 65 72 6d 73  s given in terms
0750: 20 6f 66 20 44 65 62 69 61 6e 20 74 79 70 65 20   of Debian type 
0760: 4f 53 65 73 2e 20 54 68 61 74 20 6d 61 6b 65 73  OSes. That makes
0770: 20 75 73 69 6e 67 20 74 68 65 20 50 69 44 50 2d   using the PiDP-
0780: 38 2f 49 20 73 6f 66 74 77 61 72 65 20 64 69 73  8/I software dis
0790: 74 72 69 62 75 74 69 6f 6e 20 6f 6e 20 74 68 69  tribution on thi
07a0: 73 20 63 6c 61 73 73 20 6f 66 20 4f 53 65 73 20  s class of OSes 
07b0: 74 68 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68  the most straigh
07c0: 74 66 6f 72 77 61 72 64 2e 0d 0a 0d 0a 0d 0a 23  tforward.......#
07d0: 20 4e 6f 6e 2d 44 65 62 69 61 6e 20 4c 69 6e 75   Non-Debian Linu
07e0: 78 65 73 0d 0a 0d 0a 54 68 65 72 65 20 61 72 65  xes....There are
07f0: 20 6e 6f 6e 2d 44 65 62 69 61 6e 20 74 79 70 65   non-Debian type
0800: 20 4c 69 6e 75 78 20 62 61 73 65 64 20 4f 53 65   Linux based OSe
0810: 73 20 66 6f 72 20 74 68 65 20 52 61 73 70 62 65  s for the Raspbe
0820: 72 72 79 20 50 69 20 73 75 63 68 20 61 73 20 5b  rry Pi such as [
0830: 6f 70 65 6e 53 75 53 45 20 66 6f 72 20 74 68 65  openSuSE for the
0840: 20 50 69 20 33 5d 28 68 74 74 70 73 3a 2f 2f 65   Pi 3](https://e
0850: 6e 2e 6f 70 65 6e 73 75 73 65 2e 6f 72 67 2f 48  n.opensuse.org/H
0860: 43 4c 3a 52 61 73 70 62 65 72 72 79 5f 50 69 33  CL:Raspberry_Pi3
0870: 29 20 61 6e 64 20 5b 43 65 6e 74 4f 53 20 66 6f  ) and [CentOS fo
0880: 72 20 74 68 65 20 50 69 20 33 5d 28 68 74 74 70  r the Pi 3](http
0890: 73 3a 2f 2f 77 69 6b 69 2e 63 65 6e 74 6f 73 2e  s://wiki.centos.
08a0: 6f 72 67 2f 53 70 65 63 69 61 6c 49 6e 74 65 72  org/SpecialInter
08b0: 65 73 74 47 72 6f 75 70 2f 41 6c 74 41 72 63 68  estGroup/AltArch
08c0: 2f 41 72 6d 33 32 2f 52 61 73 70 62 65 72 72 79  /Arm32/Raspberry
08d0: 50 69 33 29 2e 20 53 69 6e 63 65 20 74 68 65 20  Pi3). Since the 
08e0: 70 72 69 6d 61 72 79 20 64 65 76 65 6c 6f 70 65  primary develope
08f0: 72 73 20 6f 6e 20 74 68 69 73 20 70 72 6f 6a 65  rs on this proje
0900: 63 74 20 68 61 76 65 6e 27 74 20 74 72 69 65 64  ct haven't tried
0910: 20 61 6e 79 20 6f 66 20 74 68 65 73 65 20 50 69   any of these Pi
0920: 20 4c 69 6e 75 78 20 64 69 73 74 72 6f 73 2c 20   Linux distros, 
0930: 61 6e 64 20 6e 6f 20 6f 6e 65 20 68 61 73 20 72  and no one has r
0940: 65 70 6f 72 74 65 64 20 6f 6e 20 74 68 65 69 72  eported on their
0950: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6d 61 6b   attempts to mak
0960: 65 20 69 74 20 77 6f 72 6b 2c 20 77 65 20 63 61  e it work, we ca
0970: 6e 20 6f 6e 6c 79 20 73 70 65 63 75 6c 61 74 65  n only speculate
0980: 20 6f 6e 20 74 68 65 20 77 6f 72 6b 61 72 6f 75   on the workarou
0990: 6e 64 73 20 72 65 71 75 69 72 65 64 2c 20 69 66  nds required, if
09a0: 20 61 6e 79 2e 0d 0a 0d 0a 0d 0a 23 20 6d 61 63   any.......# mac
09b0: 4f 53 0d 0a 0d 0a 54 68 69 73 20 70 72 6f 6a 65  OS....This proje
09c0: 63 74 27 73 20 63 75 72 72 65 6e 74 20 70 72 69  ct's current pri
09d0: 6d 61 72 79 20 6d 61 69 6e 74 61 69 6e 65 72 73  mary maintainers
09e0: 20 75 73 65 20 6d 61 63 4f 53 20 61 74 20 68 6f   use macOS at ho
09f0: 6d 65 2c 20 73 6f 20 74 68 65 20 50 69 44 50 2d  me, so the PiDP-
0a00: 38 2f 49 20 73 6f 66 74 77 61 72 65 20 69 73 20  8/I software is 
0a10: 66 72 65 71 75 65 6e 74 6c 79 20 62 75 69 6c 74  frequently built
0a20: 20 61 6e 64 20 74 65 73 74 65 64 20 6f 6e 20 6d   and tested on m
0a30: 61 63 4f 53 20 77 68 69 6c 65 20 77 65 20 61 72  acOS while we ar
0a40: 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 66 65 61  e working on fea
0a50: 74 75 72 65 73 20 74 68 61 74 20 64 6f 20 6e 6f  tures that do no
0a60: 74 20 72 65 71 75 69 72 65 20 74 68 65 20 50 69  t require the Pi
0a70: 44 50 2d 38 2f 49 20 66 72 6f 6e 74 20 70 61 6e  DP-8/I front pan
0a80: 65 6c 20 68 61 72 64 77 61 72 65 2e 0d 0a 0d 0a  el hardware.....
0a90: 57 68 79 3f 20 42 65 63 61 75 73 65 20 69 74 20  Why? Because it 
0aa0: 62 75 69 6c 64 73 20 33 2d 31 32 20 74 69 6d 65  builds 3-12 time
0ab0: 73 20 66 61 73 74 65 72 20 74 68 61 6e 20 6f 6e  s faster than on
0ac0: 20 61 20 50 69 20 33 2c 20 64 65 70 65 6e 64 69   a Pi 3, dependi
0ad0: 6e 67 20 6f 6e 20 77 68 61 74 20 68 61 73 20 74  ng on what has t
0ae0: 6f 20 62 65 20 62 75 69 6c 74 21 0d 0a 0d 0a 54  o be built!....T
0af0: 68 65 20 74 68 69 72 64 20 70 61 72 74 79 20 64  he third party d
0b00: 65 70 65 6e 64 65 6e 63 79 20 61 64 76 69 63 65  ependency advice
0b10: 20 67 69 76 65 6e 20 62 79 20 74 68 65 20 63 6f   given by the co
0b20: 6e 66 69 67 75 72 65 20 73 63 72 69 70 74 20 61  nfigure script a
0b30: 6e 64 20 69 6e 20 74 68 65 20 64 6f 63 75 6d 65  nd in the docume
0b40: 6e 74 61 74 69 6f 6e 20 6e 65 65 64 73 20 74 6f  ntation needs to
0b50: 20 62 65 20 61 64 6a 75 73 74 65 64 2e 20 57 65   be adjusted. We
0b60: 20 72 65 63 6f 6d 6d 65 6e 64 20 67 65 74 74 69   recommend getti
0b70: 6e 67 20 73 75 63 68 20 74 68 69 6e 67 73 20 66  ng such things f
0b80: 72 6f 6d 20 5b 48 6f 6d 65 62 72 65 77 5d 28 68  rom [Homebrew](h
0b90: 74 74 70 73 3a 2f 2f 62 72 65 77 2e 73 68 2f 29  ttps://brew.sh/)
0ba0: 2e 0d 0a 0d 0a 0d 0a 23 20 46 72 65 65 42 53 44  .......# FreeBSD
0bb0: 0d 0a 0d 0a 42 65 63 61 75 73 65 20 6f 66 20 6f  ....Because of o
0bc0: 75 72 20 72 65 67 75 6c 61 72 20 74 65 73 74 69  ur regular testi
0bd0: 6e 67 20 6f 6e 20 6d 61 63 4f 53 2c 20 74 68 65  ng on macOS, the
0be0: 20 70 6f 72 74 20 74 6f 20 46 72 65 65 42 53 44   port to FreeBSD
0bf0: 20 77 61 73 20 73 74 72 61 69 67 68 74 66 6f 72   was straightfor
0c00: 77 61 72 64 2e 20 4f 6e 20 74 68 65 20 46 72 65  ward. On the Fre
0c10: 65 42 53 44 20 31 31 2e 32 20 73 79 73 74 65 6d  eBSD 11.2 system
0c20: 20 77 65 20 64 69 64 20 74 68 65 20 77 6f 72 6b   we did the work
0c30: 20 6f 6e 2c 20 77 65 20 68 61 64 20 74 6f 20 69   on, we had to i
0c40: 6e 73 74 61 6c 6c 20 74 68 65 20 66 6f 6c 6c 6f  nstall the follo
0c50: 77 69 6e 67 20 6e 6f 6e 2d 63 6f 72 65 20 70 61  wing non-core pa
0c60: 63 6b 61 67 65 73 3a 0d 0a 0d 0a 20 20 20 20 24  ckages:....    $
0c70: 20 73 75 64 6f 20 70 6b 67 20 69 6e 73 74 61 6c   sudo pkg instal
0c80: 6c 20 63 6f 72 65 75 74 69 6c 73 20 67 6d 61 6b  l coreutils gmak
0c90: 65 20 70 65 72 6c 35 20 70 79 74 68 6f 6e 20 70  e perl5 python p
0ca0: 79 32 37 2d 70 69 70 0d 0a 0d 0a 41 76 6f 69 64  y27-pip....Avoid
0cb0: 20 74 68 65 20 74 65 6d 70 74 61 74 69 6f 6e 20   the temptation 
0cc0: 74 6f 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 60  to install the `
0cd0: 70 79 74 68 6f 6e 33 60 20 70 61 63 6b 61 67 65  python3` package
0ce0: 20 69 6e 73 74 65 61 64 3a 20 74 68 69 73 20 70   instead: this p
0cf0: 61 63 6b 61 67 65 20 66 6f 6c 6c 6f 77 73 20 74  ackage follows t
0d00: 68 65 20 50 79 74 68 6f 6e 20 70 72 6f 6a 65 63  he Python projec
0d10: 74 27 73 20 72 65 63 6f 6d 6d 65 6e 64 61 74 69  t's recommendati
0d20: 6f 6e 20 74 6f 20 69 6e 73 74 61 6c 6c 20 74 68  on to install th
0d30: 65 20 69 6e 74 65 72 70 72 65 74 65 72 20 6f 6e  e interpreter on
0d40: 6c 79 20 61 73 20 22 60 70 79 74 68 6f 6e 33 60  ly as "`python3`
0d50: 22 20 74 6f 20 61 76 6f 69 64 20 63 6f 6e 66 6c  " to avoid confl
0d60: 69 63 74 73 20 77 69 74 68 20 50 79 74 68 6f 6e  icts with Python
0d70: 20 32 2e 20 57 65 20 74 72 79 20 74 6f 20 77 72   2. We try to wr
0d80: 69 74 65 20 6f 75 72 20 50 79 74 68 6f 6e 20 73  ite our Python s
0d90: 63 72 69 70 74 73 20 74 6f 20 77 6f 72 6b 20 6f  cripts to work o
0da0: 6e 20 62 6f 74 68 20 76 65 72 73 69 6f 6e 73 2c  n both versions,
0db0: 20 62 75 74 20 75 6e 74 69 6c 20 77 65 20 5b 63   but until we [c
0dc0: 75 74 20 6f 76 65 72 20 74 6f 20 72 65 71 75 69  ut over to requi
0dd0: 72 69 6e 67 20 50 79 74 68 6f 6e 20 33 20 6f 6e  ring Python 3 on
0de0: 6c 79 5d 28 2f 74 6b 74 76 69 65 77 3f 6e 61 6d  ly](/tktview?nam
0df0: 65 3d 32 36 32 38 33 62 39 62 33 30 29 2c 20 77  e=26283b9b30), w
0e00: 65 20 63 61 6e 27 74 20 63 68 61 6e 67 65 20 6f  e can't change o
0e10: 75 72 20 73 63 72 69 70 74 20 73 68 65 62 61 6e  ur script sheban
0e20: 67 20 6c 69 6e 65 73 20 74 6f 20 77 6f 72 6b 20  g lines to work 
0e30: 77 69 74 68 20 74 68 69 73 20 70 61 63 6b 61 67  with this packag
0e40: 65 2e 0d 0a 0d 0a 49 74 20 69 73 20 65 78 70 65  e.....It is expe
0e50: 63 74 65 64 20 74 68 61 74 20 74 68 65 20 63 6f  cted that the co
0e60: 64 65 20 74 68 61 74 20 64 72 69 76 65 73 20 74  de that drives t
0e70: 68 65 20 50 69 44 50 2d 38 2f 49 20 66 72 6f 6e  he PiDP-8/I fron
0e80: 74 20 70 61 6e 65 6c 20 68 61 72 64 77 61 72 65  t panel hardware
0e90: 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 6f   will not work o
0ea0: 6e 20 5b 46 72 65 65 42 53 44 20 66 6f 72 20 74  n [FreeBSD for t
0eb0: 68 65 20 52 61 73 70 62 65 72 72 79 20 50 69 5d  he Raspberry Pi]
0ec0: 28 68 74 74 70 73 3a 2f 2f 77 69 6b 69 2e 66 72  (https://wiki.fr
0ed0: 65 65 62 73 64 2e 6f 72 67 2f 46 72 65 65 42 53  eebsd.org/FreeBS
0ee0: 44 2f 61 72 6d 2f 52 61 73 70 62 65 72 72 79 25  D/arm/Raspberry%
0ef0: 32 30 50 69 29 2e 20 57 65 20 68 61 76 65 20 61  20Pi). We have a
0f00: 6e 20 5b 6f 70 65 6e 20 66 65 61 74 75 72 65 20  n [open feature 
0f10: 74 69 63 6b 65 74 5d 28 2f 74 6b 74 76 69 65 77  ticket](/tktview
0f20: 3f 6e 61 6d 65 3d 38 35 36 32 32 35 38 35 38 65  ?name=856225858e
0f30: 29 20 66 6f 72 20 74 68 61 74 2c 20 69 66 20 79  ) for that, if y
0f40: 6f 75 20 77 61 6e 74 20 74 6f 20 77 6f 72 6b 20  ou want to work 
0f50: 6f 6e 20 69 74 2e 0d 0a 0d 0a 0d 0a 23 20 57 69  on it.......# Wi
0f60: 6e 64 6f 77 73 0d 0a 0d 0a 54 68 65 20 50 69 44  ndows....The PiD
0f70: 50 2d 38 2f 49 20 73 6f 66 74 77 61 72 65 27 73  P-8/I software's
0f80: 20 62 75 69 6c 64 20 73 79 73 74 65 6d 20 72 65   build system re
0f90: 71 75 69 72 65 73 20 61 20 50 4f 53 49 58 20 74  quires a POSIX t
0fa0: 79 70 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 2e  ype environment.
0fb0: 20 54 68 61 74 20 67 69 76 65 73 20 79 6f 75 20   That gives you 
0fc0: 74 77 6f 20 6d 61 6a 6f 72 20 63 68 6f 69 63 65  two major choice
0fd0: 73 20 66 6f 72 20 62 75 69 6c 64 69 6e 67 20 74  s for building t
0fe0: 68 65 20 73 69 6d 75 6c 61 74 6f 72 20 6f 6e 20  he simulator on 
0ff0: 57 69 6e 64 6f 77 73 2e 0d 0a 0d 0a 0d 0a 23 23  Windows.......##
1000: 20 43 79 67 77 69 6e 0d 0a 0d 0a 54 68 69 73 20   Cygwin....This 
1010: 77 6f 72 6b 73 2c 20 61 6e 64 20 61 70 70 65 61  works, and appea
1020: 72 73 20 74 6f 20 77 6f 72 6b 20 2a 77 65 6c 6c  rs to work *well
1030: 2a 20 62 65 73 69 64 65 73 2e 0d 0a 0d 0a 59 6f  * besides.....Yo
1040: 75 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 69  u will have to i
1050: 6e 73 74 61 6c 6c 20 74 68 65 20 60 6c 69 62 6e  nstall the `libn
1060: 63 75 72 73 65 73 2d 64 65 76 65 6c 60 20 61 6e  curses-devel` an
1070: 64 20 60 70 79 74 68 6f 6e 32 2d 70 69 70 60 20  d `python2-pip` 
1080: 70 61 63 6b 61 67 65 73 20 61 73 20 77 65 6c 6c  packages as well
1090: 20 61 73 20 73 74 61 6e 64 61 72 64 20 55 6e 69   as standard Uni
10a0: 78 20 62 75 69 6c 64 20 74 6f 6f 6c 73 3a 20 47  x build tools: G
10b0: 43 43 2c 20 47 4e 55 20 4d 61 6b 65 2c 20 65 74  CC, GNU Make, et
10c0: 63 2e 20 48 61 76 69 6e 67 20 64 6f 6e 65 20 61  c. Having done a
10d0: 6c 6c 20 74 68 61 74 2c 20 74 68 65 20 73 6f 66  ll that, the sof
10e0: 74 77 61 72 65 20 77 69 6c 6c 20 62 75 69 6c 64  tware will build
10f0: 20 61 6e 64 20 72 75 6e 2e 0d 0a 0d 0a 49 20 6d   and run.....I m
1100: 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 74 65 73  ost recently tes
1110: 74 65 64 20 74 68 69 73 20 6f 6e 20 36 34 2d 62  ted this on 64-b
1120: 69 74 20 57 69 6e 64 6f 77 73 20 31 30 20 72 75  it Windows 10 ru
1130: 6e 6e 69 6e 67 20 43 79 67 77 69 6e 20 32 2e 39  nning Cygwin 2.9
1140: 2e 30 2e 0d 0a 0d 0a 0d 0a 23 23 20 57 69 6e 64  .0.......## Wind
1150: 6f 77 73 20 53 75 62 73 79 73 74 65 6d 20 66 6f  ows Subsystem fo
1160: 72 20 4c 69 6e 75 78 0d 0a 0d 0a 59 6f 75 27 64  r Linux....You'd
1170: 20 74 68 69 6e 6b 20 74 68 69 73 20 77 6f 75 6c   think this woul
1180: 64 20 77 6f 72 6b 20 62 65 63 61 75 73 65 20 74  d work because t
1190: 68 65 20 64 65 66 61 75 6c 74 20 4c 69 6e 75 78  he default Linux
11a0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
11b0: 66 6f 72 20 57 69 6e 64 6f 77 73 20 31 30 27 73  for Windows 10's
11c0: 20 57 53 4c 20 66 65 61 74 75 72 65 20 69 73 20   WSL feature is 
11d0: 55 62 75 6e 74 75 2c 20 61 6e 64 20 74 68 69 73  Ubuntu, and this
11e0: 20 73 6f 66 74 77 61 72 65 20 69 73 20 6b 6e 6f   software is kno
11f0: 77 6e 20 74 6f 20 62 75 69 6c 64 20 61 6e 64 20  wn to build and 
1200: 72 75 6e 20 75 6e 64 65 72 20 55 62 75 6e 74 75  run under Ubuntu
1210: 20 65 61 73 69 6c 79 2c 20 73 69 6e 63 65 20 69   easily, since i
1220: 74 27 73 20 63 6c 6f 73 65 6c 79 20 72 65 6c 61  t's closely rela
1230: 74 65 64 20 74 6f 20 52 61 73 70 62 69 61 6e 2e  ted to Raspbian.
1240: 20 41 6c 61 73 2c 20 69 74 20 75 74 74 65 72 6c   Alas, it utterl
1250: 79 20 66 61 69 6c 65 64 20 74 68 65 20 6c 61 73  y failed the las
1260: 74 20 74 69 6d 65 20 77 65 20 74 72 69 65 64 20  t time we tried 
1270: 69 74 2e 0d 0a 0d 0a 54 68 65 20 70 72 69 6d 61  it.....The prima
1280: 72 79 20 70 72 6f 62 6c 65 6d 20 69 73 20 74 68  ry problem is th
1290: 61 74 20 57 53 4c 27 73 20 74 65 72 6d 69 6e 61  at WSL's termina
12a0: 6c 20 68 61 6e 64 6c 69 6e 67 20 77 61 73 20 5b  l handling was [
12b0: 65 78 74 72 65 6d 65 6c 79 20 77 65 61 6b 5d 28  extremely weak](
12c0: 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63  https://github.c
12d0: 6f 6d 2f 4d 69 63 72 6f 73 6f 66 74 2f 57 53 4c  om/Microsoft/WSL
12e0: 2f 69 73 73 75 65 73 2f 31 30 30 31 29 20 61 74  /issues/1001) at
12f0: 20 74 68 65 20 74 69 6d 65 2c 20 61 6e 64 20 68   the time, and h
1300: 61 73 20 62 65 65 6e 20 73 6f 20 73 69 6e 63 65  as been so since
1310: 20 74 68 65 20 73 74 61 72 74 2e 20 54 68 69 73   the start. This
1320: 20 62 72 65 61 6b 73 20 61 20 62 72 6f 61 64 20   breaks a broad 
1330: 73 77 61 74 68 20 6f 66 20 73 6f 66 74 77 61 72  swath of softwar
1340: 65 20 61 6e 64 20 69 73 20 74 68 75 73 20 77 65  e and is thus we
1350: 6c 6c 20 6b 6e 6f 77 6e 20 61 73 20 61 20 6d 61  ll known as a ma
1360: 6a 6f 72 20 77 65 61 6b 6e 65 73 73 20 6f 66 20  jor weakness of 
1370: 57 53 4c 2e 20 4d 69 63 72 6f 73 6f 66 74 20 69  WSL. Microsoft i
1380: 73 20 61 77 61 72 65 20 6f 66 20 74 68 69 73 20  s aware of this 
1390: 61 6e 64 20 69 73 20 73 6c 6f 77 6c 79 20 69 6d  and is slowly im
13a0: 70 72 6f 76 69 6e 67 20 69 74 2c 20 73 6f 20 69  proving it, so i
13b0: 74 27 73 20 70 6f 73 73 69 62 6c 65 20 74 68 61  t's possible tha
13c0: 74 20 74 68 65 79 27 76 65 20 66 69 78 65 64 20  t they've fixed 
13d0: 61 6c 6c 20 6f 66 20 74 68 65 20 70 72 6f 62 6c  all of the probl
13e0: 65 6d 73 20 73 69 6e 63 65 20 6f 75 72 20 74 65  ems since our te
13f0: 73 74 73 20 77 65 72 65 20 64 6f 6e 65 2e 0d 0a  sts were done...
1400: 0d 0a 49 66 20 69 74 20 69 73 6e 27 74 20 77 6f  ..If it isn't wo
1410: 72 6b 69 6e 67 20 79 65 74 2c 20 74 68 65 20 63  rking yet, the c
1420: 68 61 6e 67 65 73 20 61 6e 6e 6f 75 6e 63 65 64  hanges announced
1430: 20 66 6f 72 20 5b 57 53 4c 20 32 5d 28 68 74 74   for [WSL 2](htt
1440: 70 73 3a 2f 2f 64 65 76 62 6c 6f 67 73 2e 6d 69  ps://devblogs.mi
1450: 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 63 6f 6d 6d  crosoft.com/comm
1460: 61 6e 64 6c 69 6e 65 2f 61 6e 6e 6f 75 6e 63 69  andline/announci
1470: 6e 67 2d 77 73 6c 2d 32 2f 29 20 61 6e 64 20 5b  ng-wsl-2/) and [
1480: 74 68 65 20 57 69 6e 64 6f 77 73 20 63 6f 6e 73  the Windows cons
1490: 6f 6c 65 5d 28 68 74 74 70 73 3a 2f 2f 67 69 74  ole](https://git
14a0: 68 75 62 2e 63 6f 6d 2f 6d 69 63 72 6f 73 6f 66  hub.com/microsof
14b0: 74 2f 54 65 72 6d 69 6e 61 6c 29 20 6d 69 67 68  t/Terminal) migh
14c0: 74 20 66 69 6e 61 6c 6c 79 20 63 6c 65 61 72 20  t finally clear 
14d0: 61 6c 6c 20 6f 66 20 74 68 61 74 20 75 70 20 77  all of that up w
14e0: 68 65 6e 20 69 74 27 73 20 72 65 6c 65 61 73 65  hen it's release
14f0: 64 2e 20 28 49 6e 73 69 64 65 72 20 62 75 69 6c  d. (Insider buil
1500: 64 73 20 61 72 65 20 73 74 69 6c 6c 20 20 61 20  ds are still  a 
1510: 63 6f 75 70 6c 65 20 6f 66 20 6d 6f 6e 74 68 73  couple of months
1520: 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 20 61   in the future a
1530: 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 74 68  t the time of th
1540: 69 73 20 77 72 69 74 69 6e 67 2c 20 61 6e 64 20  is writing, and 
1550: 61 20 73 74 61 62 6c 65 20 72 65 6c 65 61 73 65  a stable release
1560: 20 69 73 20 73 74 69 6c 6c 20 66 75 72 74 68 65   is still furthe
1570: 72 20 69 6e 20 74 68 65 20 66 75 74 75 72 65 2e  r in the future.
1580: 29 0d 0a 0d 0a 4d 65 61 6e 77 68 69 6c 65 2c 20  )....Meanwhile, 
1590: 43 79 67 77 69 6e 20 6f 72 20 61 20 4c 69 6e 75  Cygwin or a Linu
15a0: 78 20 56 4d 20 75 6e 64 65 72 20 48 79 70 65 72  x VM under Hyper
15b0: 56 20 61 72 65 20 62 65 74 74 65 72 20 6f 70 74  V are better opt
15c0: 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 70 75 72  ions for the pur
15d0: 70 6f 73 65 73 20 6f 66 20 72 75 6e 6e 69 6e 67  poses of running
15e0: 20 74 68 65 20 50 69 44 50 2d 38 2f 49 20 73 6f   the PiDP-8/I so
15f0: 66 74 77 61 72 65 20 6f 6e 20 57 69 6e 64 6f 77  ftware on Window
1600: 73 2e 0a 5a 20 39 35 35 34 64 37 30 64 62 66 63  s..Z 9554d70dbfc
1610: 37 30 31 31 32 38 39 63 37 37 34 39 37 39 64 61  7011289c774979da
1620: 36 63 32 39 30 0a                                6c290.