From a8b6b09a59d20de5cd30306b71cd4adcca925f62 Mon Sep 17 00:00:00 2001
From: Anachronaut <anachronautics@gmail.com>
Date: Fri, 4 Sep 2026 13:00:18 -0400
Subject: [PATCH] SoundPatch: design a sound where it can be heard, then
 convert it

The bang was guessed at directly in bytes and came out as a low gurgle,
which is what guessing at bytes gets you: a cutoff of 40 looks small and
is 57 Hz, so the filter sweep ended almost shut. Voyager's sound device
is soundThing's voice engine with the editor taken off, so a patch
designed in soundThing - where there is a screen, a keyboard and a pair
of ears - makes the same sound here. What differs is only how it arrives.

SoundPatch converts one into the other. Every parameter the device takes
is a documented function of a natural value and all of them invert: times
are squared into four seconds, cutoff and rate are exponential, depths
and detune are centred on 128. It writes a table of a count and that many
parameter and value pairs, and playPatch hands it to the device - so
every sound after this costs a table and a call rather than forty lines
of its own.

Two things the conversion has to say out loud. soundThing has no field
for the level routing, because there it is always the amplitude envelope,
so the table says so explicitly - a channel keeps its patch between notes
and a leftover from a previous one would otherwise be carried in. And a
field the tool does not recognise STOPS it: a patch format that has moved
on would otherwise produce a table that quietly means something else.

THE BUILD DOES NOT DEPEND ON IT. soundThing lives in its own repository
and is not needed to build anything here; the tables are checked in and
the tool is for when a sound is being changed.

Lander's crash now plays Kick808 as a stand-in until a bang is designed
for it, and the difference is the point: the hand-guessed patch wandered
between 1600 and 8200 for eight tenths of a second, and this decays
3492, 2743, 2037, 1515, 1040, 614, 87, nothing.

The docs check caught the tool count in two manuals, which is what it is
for.
---
 Programs/CosmOS/Apps/Lander.asm     | 114 +++++---------
 Programs/Sounds/boom.asm            |  55 +++++++
 README.md                           |  34 ++++-
 SoundPatch                          | Bin 0 -> 24824 bytes
 Source/Patch/SoundPatch.c           | 226 ++++++++++++++++++++++++++++
 SplitBit Test Manual.md             |   8 +-
 Tests/expected/cosmosCrossDisk.out  |   2 +-
 Tests/expected/cosmosDrives.out     |   2 +-
 Tests/expected/cosmosFault.out      |   2 +-
 Tests/expected/cosmosFlip.out       |   2 +-
 Tests/expected/cosmosGrid.out       |   2 +-
 Tests/expected/cosmosMonitor.out    |   2 +-
 Tests/expected/cosmosMonitorRun.out |   2 +-
 Tests/expected/cosmosRun.out        |   2 +-
 Tests/expected/cosmosSlowDisk.out   |   2 +-
 Tests/expected/cosmosSprite.out     |   2 +-
 Tests/makedisks.sh                  |   3 +-
 makefile                            |  26 +++-
 18 files changed, 385 insertions(+), 101 deletions(-)
 create mode 100644 Programs/Sounds/boom.asm
 create mode 100755 SoundPatch
 create mode 100644 Source/Patch/SoundPatch.c

diff --git a/Programs/CosmOS/Apps/Lander.asm b/Programs/CosmOS/Apps/Lander.asm
index c3c8938..aba3f79 100644
--- a/Programs/CosmOS/Apps/Lander.asm
+++ b/Programs/CosmOS/Apps/Lander.asm
@@ -2661,10 +2661,18 @@ hideSprite:
 
 ; ---- The bang, set up once and played in two writes ----
 ;
-; A patch is twenty odd writes and a note is two, which is the whole point of the selector and
+; A patch is forty odd writes and a note is two, which is the whole point of the selector and
 ; value registers - so the instrument is built at startup like the tiles are, and a crash only
 ; has to say "this channel, this note".
 ;
+; ---- And the numbers came out of soundThing ----
+;
+; The first version of this was guessed at in bytes, and a byte is not seconds or hertz: a
+; cutoff of 40 looked small and is 57 Hz, which made the bang a low gurgle. Voyager's sound
+; device is soundThing's voice engine with the editor taken off, so a patch designed there -
+; where it can be HEARD - means the same thing here. SoundPatch converts one into the table
+; below. Change the sound in soundThing and convert it again; do not edit the numbers.
+;
 ; ---- Channel three, counting down ----
 ;
 ; Effects take the top channel and work downwards, so music, if it ever arrives, can take
@@ -2673,87 +2681,31 @@ hideSprite:
 putBoom:
   INIA 0x03
   OUTA 0x41                 ; Channel three. Every parameter write below lands on it.
+  SETD.0 BoomPatch
+  CALL playPatch
+  RET
 
-  ; ---- Noise, which is what an explosion is ----
-  ;
-  ; Every other waveform here has a pitch, and a pitched bang is a note. Writing a port leaves
-  ; A alone, so the three that selected the channel would select parameter three; the wave is
-  ; parameter nought and has to be said.
-  RSTA
+; ---- A whole patch, out of a table ----
+;
+; DP0 names a count and then that many parameter and value pairs. Every sound after this one
+; costs a table and a call rather than forty lines of its own.
+playPatch:
+  LDA.0
+  SETD.1 PatchLeft
+  STA.1
+  INCD.0
+playPatchOne:
+  LDA.0
   OUTA 0x42
-  INIA 0d5                  ; Noise.
-  OUTA 0x43
-  INIA 0x01                 ; Oscillator nought, gain.
-  OUTA 0x42
-  INIA 0xFF
-  OUTA 0x43
-
-  ; ---- Instant, then a long way down ----
-  ;
-  ; No attack at all, because a bang that fades in is not a bang. A sustain of nothing does NOT
-  ; end the note - a voice holding at nothing is what a held key is - so the gate still has to
-  ; be dropped afterwards, which the explosion does once its pieces have gone.
-  INIA 0x20                 ; Amplitude envelope, attack.
-  OUTA 0x42
-  RSTA
-  OUTA 0x43
-  INIA 0x21                 ; ---- Decay: about half a second ----
-  OUTA 0x42                 ;
-                            ; A byte is not seconds. It is squared and scaled to four of them,
-                            ; so 200 is two and a half - which over the eight tenths of a
-                            ; second the pieces are in the air is not a bang fading, it is the
-                            ; first third of one, and it read as a flat wash of noise.
-  INIA 0d90
-  OUTA 0x43
-  INIA 0x22                 ; Sustain: nothing.
-  OUTA 0x42
-  RSTA
-  OUTA 0x43
-  INIA 0x23                 ; Release.
-  OUTA 0x42
-  INIA 0d40
-  OUTA 0x43
-
-  ; ---- And a filter closing, which is what makes it a boom and not a hiss ----
-  ;
-  ; Noise on its own is a cymbal. The modulation envelope shuts the low pass over the same
-  ; moment the level falls, so the bright part is only at the front of it.
-  INIA 0x40                 ; Filter, on.
-  OUTA 0x42
-  INIA 0x01
-  OUTA 0x43
-  INIA 0x41                 ; Type: low pass.
-  OUTA 0x42
-  RSTA
-  OUTA 0x43
-  INIA 0x42                 ; Cutoff, low, which is where it ends up.
-  OUTA 0x42
-  INIA 0d40
-  OUTA 0x43
-  INIA 0x43                 ; A little resonance, so the sweep can be heard.
-  OUTA 0x42
-  INIA 0d120
-  OUTA 0x43
-  INIA 0x44                 ; What opens it: the modulation envelope.
-  OUTA 0x42
-  INIA 0d2
-  OUTA 0x43
-  INIA 0x45                 ; And how far above where it sits.
-  OUTA 0x42
-  INIA 0d200
-  OUTA 0x43
-  INIA 0x30                 ; That envelope: open at once,
-  OUTA 0x42
-  RSTA
-  OUTA 0x43
-  INIA 0x31                 ; shut over about a third of a second,
-  OUTA 0x42
-  INIA 0d90
-  OUTA 0x43
-  INIA 0x32                 ; and stay shut.
-  OUTA 0x42
-  RSTA
+  INCD.0
+  LDA.0
   OUTA 0x43
+  INCD.0
+  SETD.1 PatchLeft
+  LDA.1
+  DECA
+  STA.1
+  BNA playPatchOne
   RET
 
 ; Two writes, which is what a note is meant to cost.
@@ -3948,6 +3900,8 @@ CopyLeft:
   0x00
 HideSlot:
   0x00
+PatchLeft:
+  0x00
 
 ; What a flame is being asked to be, before it is written out.
 FlameSlot:
@@ -4132,3 +4086,5 @@ LanderArtAt:
   #Reserve 0d2
 
 #Include math.asm
+
+#Include boom.asm
diff --git a/Programs/Sounds/boom.asm b/Programs/Sounds/boom.asm
new file mode 100644
index 0000000..c6bd568
--- /dev/null
+++ b/Programs/Sounds/boom.asm
@@ -0,0 +1,55 @@
+; BoomPatch, converted from External/soundThing/patches/Drums/Kick808.json by SoundPatch.
+; Designed in soundThing, where it can be heard. Do not edit the numbers
+; here: change the patch and convert it again.
+
+#Data
+
+BoomPatch:
+  0d47                      ; how many pairs follow
+  0x50 0x01                 ; the level is the amplitude envelope
+  0x00 0d0                ; oscillator 0, waveform
+  0x01 0d255              ; gain
+  0x02 0d128              ; duty
+  0x03 0d128              ; detune, in cents
+  0x04 0d127              ; octave
+  0x05 0d1                ; on
+  0x06 0d0                ; what moves its width
+  0x07 0d128              ; and how far
+  0x08 0d2                ; what moves its pitch
+  0x09 0d197              ; and how far
+  0x0A 0d0                ; what moves its gain
+  0x0B 0d128              ; and how far
+  0x10 0d5                ; oscillator 1, waveform
+  0x11 0d146              ; gain
+  0x12 0d128              ; duty
+  0x13 0d128              ; detune, in cents
+  0x14 0d128              ; octave
+  0x15 0d1                ; on
+  0x16 0d0                ; what moves its width
+  0x17 0d128              ; and how far
+  0x18 0d0                ; what moves its pitch
+  0x19 0d128              ; and how far
+  0x1A 0d0                ; what moves its gain
+  0x1B 0d128              ; and how far
+  0x20 0d4                ; amplitude envelope, attack
+  0x21 0d79               ; decay
+  0x22 0d0                ; sustain
+  0x23 0d31               ; release
+  0x30 0d4                ; modulation envelope, attack
+  0x31 0d35               ; decay
+  0x32 0d0                ; sustain
+  0x33 0d13               ; release
+  0x40 0d1                ; filter, on
+  0x41 0d0                ; type: 0 low, 1 high, 2 band
+  0x42 0d92               ; cutoff, in hertz
+  0x43 0d10               ; resonance
+  0x44 0d0                ; what moves the cutoff
+  0x45 0d128              ; and how far, in hertz
+  0x46 0d0                ; what moves the resonance
+  0x47 0d128              ; and how far
+  0x60 0d0                ; LFO 0, on
+  0x61 0d0                ; waveform
+  0x62 0d127              ; rate, in hertz
+  0x70 0d0                ; LFO 1, on
+  0x71 0d0                ; waveform
+  0x72 0d127              ; rate, in hertz
diff --git a/README.md b/README.md
index 9d3a2a6..20b2630 100644
--- a/README.md
+++ b/README.md
@@ -24,8 +24,10 @@ wrote Asm.sbx: program 7533, data 4099, labels 555
 | [`Source/Assembler`](Source/Assembler) | The assembler that runs on a host |
 | [`Source/DiskTool`](Source/DiskTool) | SplitDisk, which reads and writes SplitBit's filesystem |
 | [`Source/Linter`](Source/Linter) | SplitLint, which points out needlessly long assembly forms |
+| [`Source/Patch`](Source/Patch) | SoundPatch, which turns a soundThing patch into a table the sound device takes |
 | [`Programs/Examples`](Programs/Examples) | Programs to read: hello, a calculator, Fibonacci, a prime sieve, Life, the colours |
 | [`Programs/Libraries`](Programs/Libraries) | Code included by name rather than linked, since there is no linker |
+| [`Programs/Sounds`](Programs/Sounds) | Patch tables, converted from soundThing and checked in so the build never needs it |
 | [`Programs/Loader`](Programs/Loader) | The standalone loader CosmOS grew out of |
 | [`Programs/CosmOS`](Programs/CosmOS) | The operating system, its applications, and the native assembler |
 | [`Programs/testPrograms`](Programs/testPrograms) | What the test suite drives |
@@ -114,7 +116,7 @@ Manual.
 
 ## Getting Started:
 
-Clone it and build the four tools. You need gcc and make, or similar:
+Clone it and build the five tools. You need gcc and make, or similar:
 
 ```
 git clone https://github.com/RealBusinessAccount/SplitBit-Emulator.git
@@ -304,6 +306,32 @@ this is what turns such a count into a list of routine names.
 
 Without `-o` the output takes the source file's name, in the directory you called the assembler from, with the extension the format asks for: `.bin` for a boot image and `.sbx` for a loadable program. Included files are looked for beside the file that includes them, and then along the directories given with `-I`.
 
+## Making A Patch: SoundPatch
+
+```
+./SoundPatch <patch.json> <label> [output.asm]
+```
+
+The sound device is soundThing's voice engine with the editor taken off, so a patch designed
+in soundThing makes the same sound here. What differs is how it arrives: soundThing writes
+seconds and hertz, and the device takes bytes through a selector. SoundPatch converts one into
+the other and writes a table a program can hand to the device.
+
+A byte is not a number of seconds, and that is the whole reason this exists. Times are squared
+into four seconds, because the difference between five and fifty milliseconds is the character
+of a percussive sound and the difference between three and four seconds is nothing anybody can
+hear. Cutoff and LFO rate are exponential, because hearing is logarithmic. Depths and detune
+are centred on 128, so half of nothing is no change. The first sound written for a game here
+was guessed at directly in bytes: a cutoff of 40 looks small and is 57 Hz, and the bang came
+out as a low gurgle.
+
+A field the tool does not recognise stops it rather than being skipped, because a patch format
+that has moved on would otherwise produce a table that quietly means something else.
+
+**The build does not depend on it.** soundThing lives in its own repository and is not
+required to build anything here: the tables it produces are checked into `Programs/Sounds`,
+and the tool is for when a sound is being changed.
+
 ## Checking Assembly: SplitLint
 
 ```
@@ -611,7 +639,7 @@ $(BUILD)/%.bin: %.asm
 make test
 ```
 
-Builds the four tools, checks they build clean under strict ISO C, and runs nine scripts.
+Builds the five tools, checks they build clean under strict ISO C, and runs nine scripts.
 `Tests/run.sh` assembles and runs every program in `Programs/` and compares the results
 against recorded output; six more ask the questions a recorded file cannot answer. Between
 them they check the two assemblers against each other byte for byte, the two SBFS
@@ -630,7 +658,7 @@ correct.
 make sanitize
 ```
 
-Rebuilds all four tools with the address and undefined behaviour sanitizers and runs the
+Rebuilds all five tools with the address and undefined behaviour sanitizers and runs the
 whole suite under them. It catches reads and writes past the end of an array, use after
 free, leaks, and undefined arithmetic, takes about twice as long, and puts the ordinary
 binaries back when it finishes.
diff --git a/SoundPatch b/SoundPatch
new file mode 100755
index 0000000000000000000000000000000000000000..9a864e0f235a44473c941d6298d64da05033b834
GIT binary patch
literal 24824
zcmb<-^>JfjWMqH=W(GS35Klo3BH{p{7=A=R84L^z4h$9yd<+f@3JmfLYzzzxEMPH+
zJWM@|7GQ>m!)Oi&mjNUU(pLgvFfcHn(=t$XFdF10kPwIl=>xH`VGbdPD2!$hfbc>3
zSV2q$5W&E}fJR%gL&RY;vOchV1`v4$G`a%nAsCIU4-_^6ZV-LwGy@kz+yP3%^f56o
zfWtJv7b1^NGk_F;q@Xm^dT<<o+!+83Pjp%Zq=$il0Y-z=f`mXc2y0k?cnl2aG@5rA
z(Cv$W>O-f|f*0&QkPX34OH#<OF953VhZ)Ee1_pH61|rM=qd|6ngaV(Iq=4c9#3lwq
zlM6!-)IRihgYiFbLQI3vp!5Y20og0UzyMC)?tY;RH){Pv1lIPpr3Kz{_}}??&dGg#
zGxT#Zlgv!?b5eA3GV@9+bSo^(bj?ikiu3i1!1_RL0GS7NH)A6M1ET;FNDP{^88l>j
zWG<$j%eDN}4a*)Nt5NU_1_lP0dSnTZxv;oF7B9x39+Z5snR5V#`WPJI$8m^*k~uc>
z!*HlSi$h!%DN7^!D;J0QE*#=IILryep}v`cfkBW#nn57|Vk<0vY-C_yP=W}dkgK5T
z9njP>#CwML#;2qfrKV>Vm!uYj_&Vq0=cR@uCgr3u#K))S=I6y1mn0UI#K%LFVpW(^
zlwX>c!jO}n&QM%fRKk#!o?24O5D(IsoE@K>ksY6wn3=<nmS2#X#}FT%S)8A2WE@{y
zoSc}K#!y_6l3!ZF5FejbP?VWhk_J-G5FekDnUoANpr|B1H!(90q%5_lh#@{cxgs$>
zEi*4MC$lP*AuTy4zc`g4t)R4|n4!3&C^@%)Aty5_7nG{aK&)g4%iYJ*$vNIg&&ZMi
z&eSu7vyJsk;A{lT*a9wSYyt{SP~peIz{<ePz{bGLz|O!7&Ns~9(g`FA;e%8%GB7b*
zVPF6kub{H5bK*2M1_pM97f`WMsZ34=23Cg8AjJ#}42%q{4ELaNAfXaTkUR&&f2f#9
zW+pGFgyv?1n7IRN9t(pgln*hF8EhUX&u#(BGchQDG9JhbP=;b)0J{`qK7%@#WRO4;
zKLD+N70|>l8$r}Npou?(ihH1m|A2~Tpou>;hL}@;Ce8#EpMWMV2o;}!CN2gQ-+?Bs
z1QkDkCT<KBe}E=#0Tq9NCT<TE=WvI(7nZ+@q4j_Onz%Pqy#bnd3{>0#O}r2)9)Tv_
z02NO_6YqhFH=v2ng^G8eiEo06uRs%rnZE%|{2)~Q1vK$XQ1KgR;?JPsKhVTs<}-Mp
zhTB)DdIdCbW^le@V9-Dlmx79WpozoMPXL;@3RHaonm8=|RG^7N@-qX&3^Z|A`dNS`
zZVxs80Gc=~{hUA(_lBx}fhG=1KOfM<!=dU0JW<09mVPAA#517kEzrba;qQPZUJg~C
zfF=%0KN)D^9Z>ZhXyP#QC!mQ>hpOLzCJswKJJ7^eK-J$s6Nj1q08M;5R6T<iYWN(5
zigTceKY)sBpo!a<Li8J;iNA%a4?q+5gsP7~6aNEMUx6kb0af3CCe95NUw|eq2^C*~
zCT<E9KY=C=bN>Z2aVMzy4`|{r_y0f>4}_|h@P>p3tbBvHUja=#0jk~sO*{`O?tvy=
z2^G&k6K{oz7odqRgo;l<6JHM%pMfTR04lx%P23q;J|936zX(<T08RWcRQv^+_)n-f
zhYxD_a6-)&KoggTiW{Jbn?S`a(8PVA;t^=#u=JmRCY}IQ-+(5b0~PN;6EA~`uRs%j
z53QFspozCY)n7mp?}LipKog$}75{-Iz7i_V0BT?(wKq0H#TC%RVeZjD6F&%5?|~)`
za}NhvI~K-2;17u}P#*@`^Z^T;KoSSF;=qCo3=9{L#JORD3=9l6ki_|r#2+Au3nGcb
z+TozSKB)Z#lY+IkLE^~$jSQ$cpzc4k>kQUXfFus;(}4vU7#J#$#6f1k#2b*rL4Jmb
zcOZ#_?0|_+KoW=Ld63);ByngL6C}*A07)D+WB`&_fh5iY5`f|jNaDOuF%Y!_Nt_=f
zFp5V*U^E0qLtr!nMnhmU1V%$(Gz3ONU^E0qLtr!nMnnjF=9l~B(fo$Pqnq`hJ_CbC
z>wyxc{}()(k8m6Y`~SbGkv;>%e^nEG1_pk42L_P(43NyrNB{r-Pn!VdgF5&xFCqA#
zj{VC+2tKG|{c;n659(0AT!i3*I?^vEA^4yU^vfm$AJlPvS%lz&I?OMV5PVQa`DGA-
z59%Plbb|B$tA5jCU`XSacVPg#|G#P;8b1w<ABV;dL*x6Q@!in)c4&MvG`=1hUk!~f
zhr)LZcMNk3bqw+B{1O`M(fG!Kg@K{7MnxvYqnkxlgMop;qq9XtgN1>?@Ido_rg~M6
zZoYk>DA)@kJi2Wo^cWaCdPPO~7#Lpk{Qv*|<#%QV2A}RS4v%g(0gqnOCP4-UpU&?d
zoh~W@FQWhd{|{nuc(fiUmG<bimC^&regvE7(JR`?$H4G%I}-zgPwyI)4-5<pJM|bq
zHXFY6>3sirwMTb|3WrDU9u*BH28Mm0)e0V+H7W`(p8Wg&-=n)mMZu%>0DsF9MvxYd
zULO?$kKQRND;PlzH1z^GF#6yB|II&`O1Js+veqjzFc@C)?L6+;Z2&S8q^>hWMZ>4l
zMMdGo!hiq&`*gdgD0GLYXtW;SZ<PialYHwFzkrL1fk*ab4aephaUM4Q_IC^n436C{
z;yfO`yw`;p7(9|$8a)_K*!_RNAAZvCz%EewP2<-)$Uo}<zw4ow`$0jPeOTj@Bfmfh
zy8wvtVVC&CA9Lsvf6S>*{E@8dgc%rKXL~@@#JR9bym0yV|364(3P`2~Dg)BZuW{-V
zzhH=p#wY&x6QB6wPVs9Td~xjW|Nme${DLkj3LpzyKo-QgsA#-c_4ogOevK1gUnqc#
zbQES__{1M~@U`kEegR%<ko!Rv^G6>1<j4=Q{1bn~!Pgw0_#;^5gc%rK7%?+2bh^y3
zINmY`6h9!(y-fZ0|Ns9(p3Mg|nt$o>x2^%jMz85>9#FXN0f+yKpuhkBgW|>tB6k;A
z&I~Fi2a@ZyW!C{G3Bv>bkNWhsfVF${iXP-)U;w9*7wUii|9|-j<j3wB6^<7x{`~*n
z`nJTxr<Zjf9|J@4U&c~)5Sy2Q!K2%Dmo@`K=S#3g!vh|@qHB2=7+yU6^Z)-#Z%`_^
zZFs=3xu%tYp@ixGVUPa@Jeq&#mA-ARQITOTvGwe(QIYWIHQfZ#v+&RV|DK)4LFrc8
zv)e~S!lT<ZRvY9)(J4Hj^ai%$MHk3uP{8<f+sc8YyM0syd^<mYWqmsTd-RGnftCC8
zs{T`8V0aPv=l_47&VL@gwv#~C{Q3>!o&|AV!@2K4+&jNP>D)&}z^C&+*gFs5p(6O_
z|NmZZMkISqf$cH8{o)(kkeeVwrvLu`-?6zymVu!}&5?hbj|zuxw~vYf*hrUd7a0qW
zUeV8Rb9aKQY(C85*?dI9qw)6+1_p-GgFcqFj#>;1CHy{}|6i#8{{R0q>t0Yw@aTpV
z6)7Itkg}tM^@Rk;fW{->V&z42tYeI0tYe&G{9#ymZ}`@;^J1Jw=Od5iCm#YrTn!Hx
zp7iLoP5k};|9{bHO$LT9X?pzfEudO~!K2r9rzR-OSvP?w%O5489^I^QAa?7463+h*
z_~jcw3J*hRk6znOkYulE6Nu9M=h6AW<KR1ckApv$Js6L9T>Mue;?d2j3zBR-P{Q&5
z0i+y<=?B$64YswKAWv(DdNkW|ftVhhPfK__x^2}o85myt{Q3X?i<JNW{~u!w)ns5`
zj6KXR&w#A|W%>XA{{vrq{0S=g4jCTsXuVXy@6q@RH0QqqMDY6^iaHFbJHT}%ymkcn
zWE78vz-S1JhQMeDjE2By2#kin&<X+2`pD4Y#Pn1v1=V5&n}WoW<P5#6;`}^21)H42
zq|_Wch3Nd!l7i9_y~N_&ST3%R(xSX#g+zs7&`Q&gjLf`r1+XTC%)F9(g+zrC(27-s
zwEQB4l8jV{DutBPvdrXED}_Xb<owdS5*?6Ko<d1RVhLAnVqT>}L1Iy2ZfZ$tkwRi#
zib7dpPHCz_L1Jc6v7UklNCadO*f9zv`3eO&iIo9hXL2zFgB$_oSSchY=H=y=C={h8
zrYNWub1^6=sTvxYN5?6}Dk)egsOF?G<R*ev*2b6R=alBA!gvLlCCM31sd*_uiFxU%
zC?={FD`X^s{F;`Tnv<eXl95@gkdmKTtN^knJ1@T+6lSQ7P)$)N%>zm0DS$Pp7V9V!
z=YuqWL#jNnSfRWqv!o<7PmhbC9K|-M`$5vFU=LU;fOIG4=ar=vm87O9q!s1of+8uY
zQUT#_JuU`o1((#~%=Em}6ot$@NQi^uMMt4LBef`1A+rP&HVR3p3K^-1MJaj;E?@^K
zq^4w+fMP-+uQWF)wWt_m5=euULUINuEWmP*xCKQ5)FB|_64Mhi^Ypm57?fQSOA@)b
z7*va`xEK@^3{q5ejZ9Lk6*BV66`(PjSyZf$mY<W8Uk+ALVQQdYP+?%GfDWv|*5#y@
zrRFGP7K1s7xdl0yC8a5;3aNQzsX6%tsSqPn4U8hdb{VIjngR+jE{6Q#WP|wf#In@1
z{GwbCFEb}6u_V7p!9Yg=S=b;R<PDGlgZPxvl1k^w<eXFn5DO}nT2h*q%8&x4bU<O7
zoSIis43W%FE=ep)g|HKoOEO{X-29ZF{L+%lymSMG@{Gh1h1~qI)MACql46DO%#@N0
zh>qO+6qnS3k_-a|P{@KpD=o1IE(JBf5ZwT9QiZDm8(;|MLNytoYeM)DW~mWKk0I6&
zGDHm_LwE=oB85<Xak61NBvc?KA;Q8i9uXFX@yKBT)&z5b0Yo1{9_$UU286G`T)3}L
z^cyiG<`%f-mBlBPlq4o+gLr5OMMnW41yY!jnw(e(QU~G`mll_RR<c74DN4;rO)O4j
z$jwgy$wD>e=BJeAB$j06=fP7S+)$`Wh@nsp%upy7W@uVwPDyGJELb2s9fkZn1_(30
zq_QBD0Yq3S7%1fAm+L4PDr97)XXq#xDI_K4rNGoBmzLzGr7=J#aAM3zEh?#kNf)IS
z=jSEnC8xp!5Mhg)AV38v#0VsH;2=j%h**vHg(qxu12OC_N-g$<CUAzFw0r}Y?|t0-
zL3uDg4<ZWBi(oZHi6yBFAOgwuoV0v+iUMgi1cw}06j`%jJV+k{1KZpG|Bc`L|L^nW
z|NnwF|NnQr`TzgnoB#j+z4;I7#WOHG$cJuAOK@P6X0`_H6#@-4YrOpbzkq>(;l<1U
z|3Uj^e!Tque**&p!-`k`|36@0V9<E~|37H^o8X84|4%@xchDXm5R<Vgh=H*}fKi%<
zonrzc0|Q7Lv?=GryZ`^eOZZ*b!OPG<`>sGsRX4o&{~xq>hJjDOjZeahpSzr+fx%wN
zQp;Ecyj=vOAGC+Y<K_SVV2vP47$D}BfcDuz-3Ao~+t&jc-hBW6zamJ`kxw9=j|05y
zdkF&r!-1Fo|JQ)V+uisC`k9>gB>I@0_!N3socJ_)SY7xG+SnZVESlNf`95$khqLfm
zIP)1e@@Y8nDLC;-IPnQM@qxzLp?my5`-VV6^`L!CObiSMK*oZG_CeM%H9+{FF(wcn
zBnNUoh!0W^5(B9P4M~I8qj)p~MnhmU1V%$(Gz3ONU^E0qLtr!nMnhmU1V%$(fI|Sf
zA04*;9Jb#am#ZE^_p!nDnS=U!n0-6}2iSgL*#2^m8W5f}69iV;r-8vcd)Pi<*uHX5
zpAppOM6v(CBnR03VAy_gP=6EDmq$^@z`y|87Yy4+4l)bmMs#(s{lKvO<Jims>4EJ7
zhV2^%ElmTN36ewL2llZ2gRuSL&~7wB36urf_Y2!64qD2FVcvmB4lwgz`@=y?+@MCF
zP_TWzuzlg6y>uAnF$loTgY5?g_0>@ff^wKagBA=746uFRpuKjWc!NqqDMb9j_J4!+
z*n!mHieK2iZ(#<|=?hR}U=&jP!uETE#znBj2`qkL`@BWLXE?wNLeQ}Ih3)SaLr9^p
zVDSsv*Da3CeGG{Bh3)5-KrscufyFOuAGahn^N`{fwtrg+VFU^b7Qe84+tS#~LyBM6
zer?d$4Ja?67{(yr0Nb|>+oug0L&ByGw%-}HKN~by1&Uu(^FG+a_Bq4$Wh+C^!a-Fh
z-~ij-4BL+lI-3KVy|8`RuzlEuILw2&54QgrR4n0hA8g+>=r{yy_QKo;-*1g0UBUKU
z!}eJ_qIwk0gYCD5?XPx%j;TQum_WuQJ1#rG_F2RBRXZ~<fEH0glrb<ctaE=@C9>|l
zJ#2q9Y(KRNTm>ovwyzqtkJ=SmdU4qA0NYOu+dmCGh6B|w1_lP$K5E#$Y0$9~$mI*n
zeX#NhwqH5{NBF_^O~dv{Ct}zL5rFMahV73|f`%Wge1WJkae(bhhV6?6jq747?_v9+
zVf&#AAqHTOFneM9po<9D3$qJ!<_yR%7$0<|42TckqYKKA3=9mgy}3HjdKXkafYiax
znF8f+5Fb{5z{&;Kc`=}|W@P!V|NiHL_!FRs8WuMlPzJ0FJph%5)g#(ahl1)0kbYQs
z1}aZMd>DpmV+ermBZlQM4yb-mISo<^suw{tsQd)c44{gG0d(>Xn8#26RRHtX1W?7t
zz`y{d7-06xL6pPK%lZ8u;y*^{5jy{%{0C5v{fF{l?)m`bZ-L7Hg!1E|=2Dx2o!5qL
zt^qW@9iVgolum%s1yH&HN>6~&3!wA{D187*Ux3o+_K?em?b~;EcD7Q`2u&)@D=Ael
zG}SZGGtf0OD+TinHK8JSECD407KV?I`4%K~pm=3u5Mh9w69;oXsQ$;M9wg7iz{kJ|
z%@?4031plWxEv8@fSrqE08K}ravYmEcHr`pk0Ag&83Qr_f<Xl?$ovL0@nEQWSo;^E
znt>q`Y_Bwf2lTuHkUv3krC@O}`1wsBF%X^uH3xRS6G#k%SAf-vGQjdTNDPE=xgT_H
z8Y6=cg9`MVJ&;-$#^&FvVDlvy(9<EL{1Jqon+G%FBUrs8JU_$4*%=wIo*$>eh&VbC
zrWQmyFk(Lk?IT#d6axb^+(2qUI2ecdc{s!y!RKp9F$kcU(}6?%Y>+q;KLe~>1=$J0
z3qj%_1{&UjL;M^L@w+(0-$UJr?%zK+)blf84^KHJ1_nVUDF#@+ggI9mBn~>w4AfwP
z)<qyWD<;r+WYP=)XyNk}Y%d=J>^x6ca<_-7hn<%JG6RIYnLzQ*$FKmJ;lOi;3=9kb
zU~!NNRGb8I4-;m*<l#`?fy2LxaH!wRg#8@7b0GChTo{3O1>_zEX$IJNAF%p`Avn3H
z#85AvAwE7aDKow#F&$~~jb1WCa!z7yfm3A(XkAc2L1tchF+*}uNpVSOTAE%m1L9o1
z_>$cCWYEccpkwt?^5fHU@{<yC;!{fUi;CkDODh<X^K%PwQcF@(^b8o{<FTj!otc*z
zpIB6sSQ($1S5j2TkOo@)6rWO>n_CGweGkEl&&<m#K~WkX?-u0f>l*Ls=K?wi&?VB(
z(bv<NAwJ&SFErlO11js`62uVi?&I&|=o9bn<`(Q45+CB|<l`ETd7PgE>=Zs@69#-o
z5JC<IgsV2vGeti?5H4qI!H@$!hY&6TR-KxXSds`mClFO8Ei*3@<B&qQ5);Uwf^a^_
zu$=sK1m6;J%ppPm>^6{XkYfv>#}T5*qn@Z3pHiG3pOKiC0y=Hc(?7nrBqcL1zO*<s
zg&{sQFNGmKKB>4EY8?0!#5B+mifBfL_&UQP2Kfv{xGK=$hTt&9dUhk|z(%-IkS9@3
zSVWZqB@F0Ej3^Qedc~EwC5cH4dc`G05IO_K%F8cF)l1JS)k`YP%t_JBOkvQ=%qvMP
zDqsMMW+WD8FzBUJ<`q}wLg<nrh)h{(QE_H|9ttPEh(WI?H760I0m>@KDFK<7S;C-K
zkW-?Uo)2XdrzSJ#m84dbFzA6}TCXS{6gdofsTuK*q@R&egy1pg!5vyqlwXiqR8k2Q
za&+?41!Y`4knbVc0%9bL4KfzwD!rn7un!V*Gm{zgK%xwKNyWtsddc~@xv6=ebrh(j
z80kDvyByT?fVDGmowo}!88kixV}oeWra4d>0;V6=`Ntr&APiCqqG1?xEYr9D|MOw`
zVeNew4XqyF=kCJGL8t+s_7AA757Q6p55VXXPzyob1`rdbAJ#4h9h(R03&8Zl`WG-7
z)}Me{2R>68#s<-#Y6{d=hv|p4&tWvIo`QuNOdX7lWnf?cwf$jySo<GFPXJj0?dyWn
zz}ycNX2^loogg`o7_2`6qhb9KnEf#QF#nf9^@IBHApNlZ4UC5Mhd}y4eL8ggpiNMq
zaD{eD5cL?S;mg3l07_qAbD;#t94He^RfF4Ypp!_!Tm}WGJ{S#NV+4@`ld$nU7~O`Z
z{{d7#jE1QLYX+TL3T42=`_c4&fa-_Qp!HKwEno_!4@QI5St0u$*4}{8U7&;q)(IhC
z`XD?8hIwfA!`gW;8rH9dsYee#(Ap@F{jm5)KiB&QJYpawz~T?WV_;YVwI8M**Ll=1
z_2~BRLep<y4p9lCK^qhyA`lYY{v*)7G|YZn=XOJMLp#eb4g&+jbu|63ei@90Mkibc
zy8E9pFff45V*`}|AVskL42(v1FN_bPLH!QU`C~Bsu<;BS4O0g)8-!te82uL-elY#8
z{veEo^$S6IK^WaXT#S&s1Je)dFTrTopc^b1!t8~mL(uurp!5UR4;>GIjf;TNH^^QX
zhUtgV!i=D^h9T#KgVlfvL=Xc?!|VYGfiO%Thz-J$&;byb{jhdCtbYV6|3PX&7~TJJ
zQ2Wu<!Sut*Uyxo92Kg18hNV4_I1F1r-M;~vU_j$HpfMqs`(foLC)ROX28I_Q5R;yx
e84j}_A`9wkB844Hkb!~Wd^m)oj-~;P%K!j|;#ced

literal 0
HcmV?d00001

diff --git a/Source/Patch/SoundPatch.c b/Source/Patch/SoundPatch.c
new file mode 100644
index 0000000..f2ece02
--- /dev/null
+++ b/Source/Patch/SoundPatch.c
@@ -0,0 +1,226 @@
+// SoundPatch.c
+// Turns a soundThing patch into a table the sound device can be handed.
+//
+// ---- Why this exists ----
+//
+// soundThing is where a patch gets DESIGNED, because it has a screen, a keyboard and a pair
+// of ears attached to it. Voyager's sound device is the same voice engine with the editor
+// taken off, so the sound a patch makes is the same sound - but its settings arrive as bytes
+// through a selector, and a byte is not seconds or hertz.
+//
+// The first sound written for a game here was guessed at in bytes: a cutoff of 40 looked
+// small and is 57 Hz, so the bang came out as a low gurgle. That is what this is for. Design
+// it where it can be heard, convert it, and the numbers stop being a matter of opinion.
+//
+// ---- What a byte means ----
+//
+// Every parameter the device takes is a documented function of a natural value, and all of
+// them invert. Times are SQUARED into four seconds, because the difference between five and
+// fifty milliseconds is the whole character of a percussive sound and the difference between
+// three and four seconds is nothing anybody can hear. Cutoff and LFO rate are EXPONENTIAL,
+// because pitch is logarithmic and so is where a filter sounds like it is. Depths and detune
+// are CENTRED on 128, so half of nothing is no change and either side of it is a direction.
+//
+// Written by Anachronaut
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <math.h>
+
+// How a natural value becomes a byte. The inverse of soundParameter in sound.c, and the
+// reason that file and this one have to be read together if either changes.
+typedef enum {
+    AS_DIRECT,      // already a byte: a waveform, a routing, a filter type
+    AS_BOOL,        // nought or one
+    AS_RANGE,       // linear from low to high
+    AS_SQUARED,     // times, so that the short end has the resolution
+    AS_EXPONENTIAL, // cutoff and rate, because hearing is logarithmic
+    AS_SIGNED,      // centred on 128, reaching `high` either way
+    AS_OCTAVE       // a small signed number, offset by 128
+} Shape;
+
+typedef struct {
+    const char *field;      // what soundThing calls it
+    unsigned char parameter; // what the device calls it
+    Shape shape;
+    double low, high;
+    const char *note;
+} Mapping;
+
+// ---- The whole of the correspondence ----
+//
+// Oscillator one is oscillator nought's parameters plus 0x10, and the modulation envelope is
+// the amplitude one plus 0x10, which is why the parameter numbers are laid out the way they
+// are. Written out in full anyway: a table that has to be understood before it can be read is
+// worse than a long one.
+static const Mapping mappings[] = {
+    { "osc0_waveform",        0x00, AS_DIRECT,      0, 0,       "oscillator 0, waveform" },
+    { "osc0_gain",            0x01, AS_RANGE,       0, 4.0,     "gain" },
+    { "osc0_dutyCycle",       0x02, AS_RANGE,       0.05, 0.95, "duty" },
+    { "osc0_detune",          0x03, AS_SIGNED,      0, 1200,    "detune, in cents" },
+    { "osc0_octave",          0x04, AS_OCTAVE,      0, 0,       "octave" },
+    { "osc0_active",          0x05, AS_BOOL,        0, 0,       "on" },
+    { "osc0_modRouting0",     0x06, AS_DIRECT,      0, 0,       "what moves its width" },
+    { "osc0_modDepth0",       0x07, AS_SIGNED,      0, 0.5,     "and how far" },
+    { "osc0_modRouting1",     0x08, AS_DIRECT,      0, 0,       "what moves its pitch" },
+    { "osc0_modDepth1",       0x09, AS_SIGNED,      0, 1200,    "and how far" },
+    { "osc0_modRouting2",     0x0A, AS_DIRECT,      0, 0,       "what moves its gain" },
+    { "osc0_modDepth2",       0x0B, AS_SIGNED,      0, 4.0,     "and how far" },
+
+    { "osc1_waveform",        0x10, AS_DIRECT,      0, 0,       "oscillator 1, waveform" },
+    { "osc1_gain",            0x11, AS_RANGE,       0, 4.0,     "gain" },
+    { "osc1_dutyCycle",       0x12, AS_RANGE,       0.05, 0.95, "duty" },
+    { "osc1_detune",          0x13, AS_SIGNED,      0, 1200,    "detune, in cents" },
+    { "osc1_octave",          0x14, AS_OCTAVE,      0, 0,       "octave" },
+    { "osc1_active",          0x15, AS_BOOL,        0, 0,       "on" },
+    { "osc1_modRouting0",     0x16, AS_DIRECT,      0, 0,       "what moves its width" },
+    { "osc1_modDepth0",       0x17, AS_SIGNED,      0, 0.5,     "and how far" },
+    { "osc1_modRouting1",     0x18, AS_DIRECT,      0, 0,       "what moves its pitch" },
+    { "osc1_modDepth1",       0x19, AS_SIGNED,      0, 1200,    "and how far" },
+    { "osc1_modRouting2",     0x1A, AS_DIRECT,      0, 0,       "what moves its gain" },
+    { "osc1_modDepth2",       0x1B, AS_SIGNED,      0, 4.0,     "and how far" },
+
+    { "ampEnv_attack",        0x20, AS_SQUARED,     0, 4.0,     "amplitude envelope, attack" },
+    { "ampEnv_decay",         0x21, AS_SQUARED,     0, 4.0,     "decay" },
+    { "ampEnv_sustain",       0x22, AS_RANGE,       0, 1.0,     "sustain" },
+    { "ampEnv_release",       0x23, AS_SQUARED,     0, 4.0,     "release" },
+
+    { "modEnv_attack",        0x30, AS_SQUARED,     0, 4.0,     "modulation envelope, attack" },
+    { "modEnv_decay",         0x31, AS_SQUARED,     0, 4.0,     "decay" },
+    { "modEnv_sustain",       0x32, AS_RANGE,       0, 1.0,     "sustain" },
+    { "modEnv_release",       0x33, AS_SQUARED,     0, 4.0,     "release" },
+
+    { "filter_active",        0x40, AS_BOOL,        0, 0,       "filter, on" },
+    { "filter_type",          0x41, AS_DIRECT,      0, 0,       "type: 0 low, 1 high, 2 band" },
+    { "filter_cutoff",        0x42, AS_EXPONENTIAL, 20.0, 20000.0, "cutoff, in hertz" },
+    { "filter_resonance",     0x43, AS_RANGE,       0, 0.99,    "resonance" },
+    { "filter_modRouting",    0x44, AS_DIRECT,      0, 0,       "what moves the cutoff" },
+    { "filter_modDepth",      0x45, AS_SIGNED,      0, 8000.0,  "and how far, in hertz" },
+    { "filter_resModRouting", 0x46, AS_DIRECT,      0, 0,       "what moves the resonance" },
+    { "filter_resModDepth",   0x47, AS_SIGNED,      0, 0.99,    "and how far" },
+
+    { "lfo0_active",          0x60, AS_BOOL,        0, 0,       "LFO 0, on" },
+    { "lfo0_waveform",        0x61, AS_DIRECT,      0, 0,       "waveform" },
+    { "lfo0_rate",            0x62, AS_EXPONENTIAL, 0.05, 20.0, "rate, in hertz" },
+    { "lfo1_active",          0x70, AS_BOOL,        0, 0,       "LFO 1, on" },
+    { "lfo1_waveform",        0x71, AS_DIRECT,      0, 0,       "waveform" },
+    { "lfo1_rate",            0x72, AS_EXPONENTIAL, 0.05, 20.0, "rate, in hertz" },
+};
+#define MAPPING_COUNT ((int)(sizeof(mappings) / sizeof(mappings[0])))
+
+// ---- What soundThing has and the device does not ----
+//
+// Named rather than ignored, so a field that is simply new shows up as unknown and a field
+// that is deliberately dropped does not. Master volume is the editor's own output level and
+// the device has one of its own; pitch bend has no wheel to come from.
+static const char *ignored[] = { "master_volume", "master_pitchBendRange" };
+#define IGNORED_COUNT ((int)(sizeof(ignored) / sizeof(ignored[0])))
+
+static int clampByte(double raw) {
+    long v = lround(raw);
+    if (v < 0) return 0;
+    if (v > 255) return 255;
+    return (int)v;
+}
+
+static int toByte(const Mapping *m, double value) {
+    switch (m->shape) {
+        case AS_DIRECT:  return clampByte(value);
+        case AS_BOOL:    return value != 0.0 ? 1 : 0;
+        case AS_RANGE:   return clampByte(255.0 * (value - m->low) / (m->high - m->low));
+        // The inverse of part*part*high, so the root comes back out.
+        case AS_SQUARED: return clampByte(255.0 * sqrt(value / m->high));
+        // And of low * (high/low)^part.
+        case AS_EXPONENTIAL:
+            if (value < m->low) value = m->low;
+            return clampByte(255.0 * log(value / m->low) / log(m->high / m->low));
+        case AS_SIGNED:  return clampByte(128.0 + 128.0 * value / m->high);
+        case AS_OCTAVE:  return clampByte(128.0 + value);
+    }
+    return 0;
+}
+
+int main(int argc, char **argv) {
+    if (argc < 3) {
+        fprintf(stderr,
+            "Usage: %s <patch.json> <label> [output.asm]\n\n"
+            "Turns a soundThing patch into a table for the sound device: a count, then that\n"
+            "many parameter and value pairs. Hand the label to playPatch.\n", argv[0]);
+        return 2;
+    }
+    const char *path = argv[1];
+    const char *label = argv[2];
+
+    FILE *in = fopen(path, "r");
+    if (!in) { fprintf(stderr, "SoundPatch: cannot read %s\n", path); return 1; }
+
+    int values[MAPPING_COUNT];
+    int seen[MAPPING_COUNT];
+    memset(seen, 0, sizeof(seen));
+
+    char line[512];
+    int unknown = 0;
+    while (fgets(line, sizeof(line), in)) {
+        char field[128];
+        double value;
+        // Every line of one of these is `"name": number`, with or without a trailing comma.
+        if (sscanf(line, " \"%127[^\"]\" : %lf", field, &value) != 2) continue;
+        int found = 0;
+        for (int i = 0; i < MAPPING_COUNT; i++) {
+            if (strcmp(field, mappings[i].field) == 0) {
+                values[i] = toByte(&mappings[i], value);
+                seen[i] = 1;
+                found = 1;
+                break;
+            }
+        }
+        if (found) continue;
+        for (int i = 0; i < IGNORED_COUNT; i++) {
+            if (strcmp(field, ignored[i]) == 0) { found = 1; break; }
+        }
+        if (!found) {
+            fprintf(stderr, "SoundPatch: %s has a field this does not know: %s\n", path, field);
+            unknown++;
+        }
+    }
+    fclose(in);
+
+    // A field this does not know is a patch format that has moved on, and writing a table
+    // that quietly leaves it out would make a sound nobody could account for.
+    if (unknown) {
+        fprintf(stderr, "SoundPatch: %d unknown field%s, so nothing was written.\n",
+                unknown, unknown == 1 ? "" : "s");
+        return 1;
+    }
+
+    int count = 0;
+    for (int i = 0; i < MAPPING_COUNT; i++) if (seen[i]) count++;
+    // The level routing is soundThing's one blind spot: it has no field for it because there
+    // it is always the amplitude envelope. Said out loud here so a channel that was left set
+    // some other way by a previous patch does not carry it into this one.
+    count++;
+
+    FILE *out = stdout;
+    if (argc > 3) {
+        out = fopen(argv[3], "w");
+        if (!out) { fprintf(stderr, "SoundPatch: cannot write %s\n", argv[3]); return 1; }
+    }
+
+    fprintf(out, "; %s, converted from %s by SoundPatch.\n", label, path);
+    fprintf(out, "; Designed in soundThing, where it can be heard. Do not edit the numbers\n");
+    fprintf(out, "; here: change the patch and convert it again.\n\n");
+    // Data, and no base: a table of bytes belongs wherever the program including it has got
+    // to, the way every other included table does.
+    fprintf(out, "#Data\n\n");
+    fprintf(out, "%s:\n", label);
+    fprintf(out, "  0d%-24d; how many pairs follow\n", count);
+    fprintf(out, "  0x50 0x01                 ; the level is the amplitude envelope\n");
+    for (int i = 0; i < MAPPING_COUNT; i++) {
+        if (!seen[i]) continue;
+        fprintf(out, "  0x%02X 0d%-3d              ; %s\n",
+                mappings[i].parameter, values[i], mappings[i].note);
+    }
+    if (out != stdout) fclose(out);
+    return 0;
+}
diff --git a/SplitBit Test Manual.md b/SplitBit Test Manual.md
index 094034c..e0633b1 100644
--- a/SplitBit Test Manual.md	
+++ b/SplitBit Test Manual.md	
@@ -37,7 +37,7 @@ Everything in between is somewhere on that line.
 make test
 ```
 
-Builds the four tools - and Voyager, where Raylib is installed - checks they compile under
+Builds the five tools - and Voyager, where Raylib is installed - checks they compile under
 strict ISO C, and runs the scripts in order. Takes a few seconds. Everything must pass; there are no expected failures at the
 level of the suite, only tests that record an expected failure of the assembler.
 
@@ -45,7 +45,7 @@ level of the suite, only tests that record an expected failure of the assembler.
 make sanitize
 ```
 
-The same suite with the four tools rebuilt under AddressSanitizer and
+The same suite with the five tools rebuilt under AddressSanitizer and
 UndefinedBehaviorSanitizer. See [The Sanitizer Run](#the-sanitizer-run).
 
 Individual scripts can be run on their own, from anywhere:
@@ -540,7 +540,7 @@ which stops the markers outliving the code they were about.
 make sanitize
 ```
 
-Rebuilds all four tools with `-fsanitize=address,undefined` and runs **the whole suite**
+Rebuilds all five tools with `-fsanitize=address,undefined` and runs **the whole suite**
 under them. What it reliably catches is invalid access: reads and writes off the end of an
 array, use after free, leaks, and arithmetic the standard does not define.
 
@@ -552,7 +552,7 @@ deliberate `calloc`. The machine's Program and Data memories are static arrays,
 sanitizers neither fill nor bound-check - which is the same fact, seen from a
 different side, as the overrun blind spot below.
 
-It runs everything because it used to not. It built all four tools sanitized and then ran
+It runs everything because it used to not. It built all five tools sanitized and then ran
 only `run.sh` and `terminal.sh`, so SplitDisk was compiled with the sanitizers and never
 exercised, and `native.sh` - which drives the assembler and the emulator harder than
 anything else here - was skipped entirely. Those are exactly where block arithmetic on disk
diff --git a/Tests/expected/cosmosCrossDisk.out b/Tests/expected/cosmosCrossDisk.out
index d48d18c..3a2dc11 100644
--- a/Tests/expected/cosmosCrossDisk.out
+++ b/Tests/expected/cosmosCrossDisk.out
@@ -25,7 +25,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosDrives.out b/Tests/expected/cosmosDrives.out
index 39b58f8..e28a67e 100644
--- a/Tests/expected/cosmosDrives.out
+++ b/Tests/expected/cosmosDrives.out
@@ -15,7 +15,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosFault.out b/Tests/expected/cosmosFault.out
index 3a8f43a..9f939f4 100644
--- a/Tests/expected/cosmosFault.out
+++ b/Tests/expected/cosmosFault.out
@@ -32,7 +32,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosFlip.out b/Tests/expected/cosmosFlip.out
index c42347d..c9438aa 100644
--- a/Tests/expected/cosmosFlip.out
+++ b/Tests/expected/cosmosFlip.out
@@ -22,7 +22,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosGrid.out b/Tests/expected/cosmosGrid.out
index 299f54b..08e4f9d 100644
--- a/Tests/expected/cosmosGrid.out
+++ b/Tests/expected/cosmosGrid.out
@@ -22,7 +22,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosMonitor.out b/Tests/expected/cosmosMonitor.out
index 1ea065d..844abe3 100644
--- a/Tests/expected/cosmosMonitor.out
+++ b/Tests/expected/cosmosMonitor.out
@@ -108,7 +108,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosMonitorRun.out b/Tests/expected/cosmosMonitorRun.out
index 1f48725..8bec3e5 100644
--- a/Tests/expected/cosmosMonitorRun.out
+++ b/Tests/expected/cosmosMonitorRun.out
@@ -27,7 +27,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosRun.out b/Tests/expected/cosmosRun.out
index d6c133a..b2c61be 100644
--- a/Tests/expected/cosmosRun.out
+++ b/Tests/expected/cosmosRun.out
@@ -15,7 +15,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosSlowDisk.out b/Tests/expected/cosmosSlowDisk.out
index 566141e..e85df47 100644
--- a/Tests/expected/cosmosSlowDisk.out
+++ b/Tests/expected/cosmosSlowDisk.out
@@ -13,7 +13,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/expected/cosmosSprite.out b/Tests/expected/cosmosSprite.out
index 92bb7af..79b5c74 100644
--- a/Tests/expected/cosmosSprite.out
+++ b/Tests/expected/cosmosSprite.out
@@ -22,7 +22,7 @@ Mode.sbx                48
 Flip.sbx                173
 Sprite.sbx              442
 Depth.sbx               672
-Lander.sbx              8388
+Lander.sbx              8412
 Pad.sbx                 264
 Crash.sbx               632
 vars.script             50
diff --git a/Tests/makedisks.sh b/Tests/makedisks.sh
index 881e2a5..14319af 100755
--- a/Tests/makedisks.sh
+++ b/Tests/makedisks.sh
@@ -146,7 +146,8 @@ for i in 1 2 3 4 5 6 7 8; do "$TOOL" put "$DISKS/sbfs.img" "filler$i.txt" >/dev/
 "$TOOL" put "$DISKS/cosmos.img" "$WORK/Depth.sbx" >/dev/null
 # Lander.sbx is Lunar Porter, and the biggest program on the disk. It takes the screen, the
 # mode and the map, so it is also the one that says a program can have all three back.
-"$ROOT/Assembler" -I "$ROOT/Programs/Libraries" -I "$ROOT/Programs/CosmOS/Source" \
+"$ROOT/Assembler" -I "$ROOT/Programs/Sounds" -I "$ROOT/Programs/Libraries" \
+    -I "$ROOT/Programs/CosmOS/Source" \
     "$ROOT/Programs/CosmOS/Apps/Lander.asm" -o "$WORK/Lander.sbx" >/dev/null
 "$TOOL" put "$DISKS/cosmos.img" "$WORK/Lander.sbx" >/dev/null
 # Pad.sbx says what the controllers are doing, which is the only way to tell a pad nobody
diff --git a/makefile b/makefile
index 22305ed..5dbbfe1 100644
--- a/makefile
+++ b/makefile
@@ -49,6 +49,7 @@ SRC_DIR_EMU = Source/Emulator
 SRC_DIR_ASM = Source/Assembler
 SRC_DIR_DSK = Source/DiskTool
 SRC_DIR_LINT = Source/Linter
+SRC_DIR_PATCH = Source/Patch
 OBJ_DIR = Object
 
 # Source files
@@ -63,12 +64,14 @@ VOY_SRCS = voyager.c $(MACHINE_SRCS)
 ASM_SRCS = Assembler.c assembly.c firstPass.c Assm-util.c secondPass.c
 DSK_SRCS = SplitDisk.c
 LINT_SRCS = Linter.c
+PATCH_SRCS = SoundPatch.c
 
 EMU_OBJS = $(EMU_SRCS:%.c=$(OBJ_DIR)/%.o)
 VOY_OBJS = $(VOY_SRCS:%.c=$(OBJ_DIR)/%.o)
 ASM_OBJS = $(ASM_SRCS:%.c=$(OBJ_DIR)/%.o)
 DSK_OBJS = $(DSK_SRCS:%.c=$(OBJ_DIR)/%.o)
 LINT_OBJS = $(LINT_SRCS:%.c=$(OBJ_DIR)/%.o) $(OBJ_DIR)/assembly.o
+PATCH_OBJS = $(PATCH_SRCS:%.c=$(OBJ_DIR)/%.o)
 
 # Output binary names
 EMU_TARGET = SplitBit
@@ -76,6 +79,7 @@ VOY_TARGET = Voyager
 ASM_TARGET = Assembler
 DSK_TARGET = SplitDisk
 LINT_TARGET = SplitLint
+PATCH_TARGET = SoundPatch
 
 # ---- Whether this machine can build Voyager ----
 #
@@ -147,7 +151,7 @@ DISKTOOL = ./$(DSK_TARGET)
 
 # Libraries are included by bare name, so the assembler is told where to find them. CosmOS
 # owns the filesystem library and the service names, so it is a place to look too.
-INCLUDES = -I $(PROG_DIR)/Libraries -I $(PROG_DIR)/CosmOS/Source
+INCLUDES = -I $(PROG_DIR)/Sounds -I $(PROG_DIR)/Libraries -I $(PROG_DIR)/CosmOS/Source
 
 # The programs worth building. Every one lives in a directory that says what kind it is:
 # Examples/ is what you read to learn, Loader/ is the standalone loader CosmOS grew out of,
@@ -208,7 +212,7 @@ SCRATCH_BLOCKS = 2048
 # linter, the whole test suite - has to build on a machine with no graphics library at all,
 # because a project about a small understandable CPU should not need OpenGL to run its
 # tests. Where Raylib is missing, 'make' says so once and builds everything else.
-TOOLS = $(EMU_TARGET) $(ASM_TARGET) $(DSK_TARGET) $(LINT_TARGET)
+TOOLS = $(EMU_TARGET) $(ASM_TARGET) $(DSK_TARGET) $(LINT_TARGET) $(PATCH_TARGET)
 
 # ---- What 'make' builds ----
 #
@@ -291,6 +295,20 @@ $(DSK_TARGET): $(DSK_OBJS)
 $(LINT_TARGET): $(LINT_OBJS)
 	$(CC) $(CFLAGS) -o $(LINT_TARGET) $(LINT_OBJS)
 
+# ---- SoundPatch, which needs the maths library and nothing else ----
+#
+# It converts a soundThing patch into a table of bytes for the sound device. Nothing in the
+# build depends on it, and that is deliberate: soundThing lives in another repository and the
+# tables it produces are CHECKED IN, so this tree builds on a machine that has never heard of
+# it. The tool is here for when a sound is being changed.
+$(PATCH_TARGET): $(PATCH_OBJS)
+	$(CC) $(CFLAGS) -o $(PATCH_TARGET) $(PATCH_OBJS) -lm
+
+# Compile patch tool source files to object files
+$(OBJ_DIR)/%.o: $(SRC_DIR_PATCH)/%.c
+	@mkdir -p $(OBJ_DIR)
+	$(CC) $(CFLAGS) $(POSIXFLAGS) $(DEPFLAGS) -c $< -o $@
+
 $(OBJ_DIR)/Linter.o: $(SRC_DIR_LINT)/Linter.c
 	@mkdir -p $(OBJ_DIR)
 	$(CC) $(CFLAGS) $(POSIXFLAGS) $(DEPFLAGS) -c $< -o $@
@@ -311,7 +329,7 @@ $(OBJ_DIR)/%.o: $(SRC_DIR_ASM)/%.c
 # disagreed with everything else about how big the struct was, and smashed its stack on every
 # run. A clean build hid it, which is why 'make sanitize' would never have found it either.
 # Tests/voyager.sh did, by failing all 115 tests that start the machine.
--include $(EMU_OBJS:.o=.d) $(VOY_OBJS:.o=.d) $(ASM_OBJS:.o=.d) $(DSK_OBJS:.o=.d) $(LINT_OBJS:.o=.d)
+-include $(EMU_OBJS:.o=.d) $(VOY_OBJS:.o=.d) $(ASM_OBJS:.o=.d) $(DSK_OBJS:.o=.d) $(LINT_OBJS:.o=.d) $(PATCH_OBJS:.o=.d)
 
 # ---- The strict build the README promises ----
 #
@@ -425,7 +443,7 @@ clean:
 	rm -rf Tests/build
 	rm -rf $(PROG_BUILD)
 	rm -f $(SRC_DIR_EMU)/rom.c
-	rm -f $(EMU_TARGET) $(ASM_TARGET) $(DSK_TARGET) $(LINT_TARGET) $(VOY_TARGET)
+	rm -f $(EMU_TARGET) $(ASM_TARGET) $(DSK_TARGET) $(LINT_TARGET) $(VOY_TARGET) $(PATCH_TARGET)
 
 # Install compiled binaries
 install: $(EMU_TARGET) $(ASM_TARGET) $(DSK_TARGET) $(LINT_TARGET)