WIP: 0x36, 0x37

radio/36.md

@@ -1,18 +1,21 @@
 # `0x36` Radio EQ
 
-Radio `0x68` → GT `0x3b` (Radio/HiFi optioned)  
-Radio `0x68` → DSP `0x6a` (Top HiFi/DSP optioned)  
-Radio `0x68` → Broadcast`0xff`
+Radio `0x68` → GT `0x3b`  
+<!--Radio `0x68` → DSP `0x6a` (DSP only)-->
+<!--Radio `0x68` → Broadcast`0xff` (DSP only)-->
 
-- Update GT EQ interface
-- Set DSP
+*BMBT only.*
 
-### Related Commands
+![Tone](36/treble.jpg)
 
-- `0x37`
-- `0x46`
+The radio uses this command to update the **Tone** (EQ) display as the properties are adjusted.
 
-### Example Frames
+### Related
+
+- `0x37` [Radio Tone/Select](37.md)
+- `0x46` Radio UI (pending)
+
+### Examples
 
     68 04 3B 36 40 21
     68 04 3B 36 44 25
@@ -40,55 +43,51 @@ Radio `0x68` → Broadcast`0xff`
 
 ### Sign `0b0001_0000`
 
-    SIGN_POSITIVE = 0b0000_0000 # Front, Left
-    SIGN_NEGATIVE = 0b0001_0000 # Rear, Right
+    SIGN_POSITIVE = 0b0000_0000     # Front, Left
+    SIGN_NEGATIVE = 0b0001_0000     # Rear, Right
 
 ### Magnitude `0b0000_1111`
 
-Property|Intervals|Min|Max|Zero
-:-------|:--------|:--|:--|:---
-Bass|13|`0x1c`|`0x0c`|`0x10 # negative zero`
-Treble|13|`0x1c`|`0x0c`|`0x10 # negative zero`
-Fader|21|`0x1f`|`0x0f`|`0x10 # negative zero`
-Balance|21|`0x0f`|`0x1f`|`0x00 # positive zero`
+Each property has a fixed number of intervals. *Treble* and *Bass* have 13 intervals (±6), while *Fader* and *Balance* have 21 intervals (±10). However, the step number does not necessarily equal the binary value. i.e. the sixth step is not encoded as `0x6`. The binary representation for each step is summarised in [Use Cases](#use-cases).
 
-    # 4-bit integer
-    # 0b0001 = 1
-    # 0b0010 = 2
-    # [...]
-    # 0b1110 = 14
-    # 0b1111 = 15
+<!--Property|Step Encoding (neutral to max)
+:-------|:-----------------------------
+Bass / Treble|`10 02 04 06 08 0a 0c`
+Fader|`10 01 02 03 04 05 08 0a 0c 0e 0f`
+Balance|`00 11 12 13 14 15 18 1a 1c 1e 1f`-->
 
-## Use Cases
+Note: to make things more confusing, the encoding is not consistent with DSP. A number of steps have a different binary value, including neutral (zero), which may switch between negative and positive.
 
-Each EQ property has a fixed number of intervals. Treble and Bass have 13 intervals (±6), while Fader and Balance have 21 intervals (±10). Note, the interval step doesn't correlate with the magnitude. For example, Bass `+6` is `0xc`, not `0x6`.
-
-![Select Radio](36/neutral.jpg)
+## Use Cases
 
-    10 10 10 00
+### Tone
 
-![Select Radio](36/min.jpg)
+The table below summarises the binary representation of each step for the respective properties.
 
-    BAL +MAX
-    FADER -MIN
-    TRE -MIN
-    BASS -MIN
-    1c 1C 1F 1F
+Property|Min. / Rear / Right|Neutral|Max. / Front / Left
+:-------|-----:|-----|:----
+Balance|`0f 0e 0c 0a 08 05 04 03 02 01`|`00`|`11 12 13 14 15 18 1a 1c 1e 1f`
+Fader|`1f 1e 1c 1a 18 15 14 13 12 11`|`10`|`01 02 03 04 05 08 0a 0c 0e 0f`
+Treble|`1c 1a 18 16 14 12`|`10`|`02 04 06 08 0a 0c`
+Bass|`1c 1a 18 16 14 12`|`10`|`02 04 06 08 0a 0c`
 
-![Select Radio](36/max.jpg)
+    # Treble Example
 
-    BAL -MIN
-    FADER +MAX
-    TRE +MAX
-    BASS +MAX
-    0c 0C 0F 0F
+    # Minimum
+    PROPERTY_TREBLE & SIGN_NEGATIVE & 0x0c => 0xdc
+
+    # Neutral
+    PROPERTY_TREBLE & SIGN_NEGATIVE & 0x00 => 0xd0
 
-### Radio EQ update
+    # Maximum
+    PROPERTY_TREBLE & SIGN_POSITIVE & 0x0c => 0xcc
 
 #### Balance
+
+![Balance Adjustment](36/balance.jpg)
 
-    # Left to Right
-    68 04 3B 36 4F 2E   # +10
+    # BALANCE
+    68 04 3B 36 4F 2E   # +10 LEFT
     68 04 3B 36 4E 2F   # +9
     68 04 3B 36 4C 2D   # +8
     68 04 3B 36 4A 2B   # +7
@@ -108,11 +107,13 @@ Each EQ property has a fixed number of intervals. Treble and Bass have 13 interv
     68 04 3B 36 5A 3B   # -7
     68 04 3B 36 5C 3D   # -8
     68 04 3B 36 5E 3F   # -9
-    68 04 3B 36 5F 3E   # -10
+    68 04 3B 36 5F 3E   # -10 RIGHT
 
 #### Fader
+
+![Fader Adjustment](36/fader.jpg)
 
-    # Rear to Front
+    # FADER
     68 04 3B 36 81 E0   # -10 REAR
     68 04 3B 36 82 E3   # -9
     68 04 3B 36 83 E2   # -8
@@ -137,9 +138,11 @@ Each EQ property has a fixed number of intervals. Treble and Bass have 13 interv
 
 
 #### Treble
+
+![Treble Adjustment](36/treble.jpg)
 
-    # Min to Max
-    68 04 3B 36 DC BD   # -6
+    # TREBLE    
+    68 04 3B 36 DC BD   # -6 MIN
     68 04 3B 36 DA BB   # -5
     68 04 3B 36 D8 B9   # -4
     68 04 3B 36 D6 B7   # -3
@@ -151,12 +154,14 @@ Each EQ property has a fixed number of intervals. Treble and Bass have 13 interv
     68 04 3B 36 C6 A7   # +3
     68 04 3B 36 C8 A9   # +4
     68 04 3B 36 CA AB   # +5
-    68 04 3B 36 CC AD   # +6
+    68 04 3B 36 CC AD   # +6 MAX
 
 #### Bass
+
+![Bass Adjustment](36/bass.jpg)
 
-    # Min to Max
-    68 04 3B 36 7C 1D   # -6
+    # Bass: Min to Max
+    68 04 3B 36 7C 1D   # -6 MIN
     68 04 3B 36 7A 1B   # -5
     68 04 3B 36 78 19   # -4
     68 04 3B 36 76 17   # -3
@@ -168,4 +173,4 @@ Each EQ property has a fixed number of intervals. Treble and Bass have 13 interv
     68 04 3B 36 66 07   # +3
     68 04 3B 36 68 09   # +4
     68 04 3B 36 6A 0B   # +5
-    68 04 3B 36 6C 0D   # +6
+    68 04 3B 36 6C 0D   # +6 MAX

radio/37.md

@@ -184,12 +184,12 @@ The radio specifies the value of each Tone property when requesting the Tone dis
 
     FUNCTION_TONE_SET 0x80
 
-![Select Radio](36/neutral.jpg)
+![Select Radio](37/neutral.jpg)
 
     # FUNCTION_TONE_SET & 0x10 => 0x90
     68 07 3B 37 90 10 10 00 F3
 
-![Select Radio](36/min.jpg)
+![Select Radio](37/min.jpg)
 
     # Bass    MIN
     # Treble  MIN
@@ -199,7 +199,7 @@ The radio specifies the value of each Tone property when requesting the Tone dis
     # FUNCTION_TONE_SET & 0x1c => 0x9c
     68 07 3B 37 9C 1C 1F 1F E3
 
-![Select Radio](36/max.jpg)
+![Select Radio](37/max.jpg)
 
     # FUNCTION_TONE_SET & 0x0c => 0x8c
     68 07 3B 37 8C 0C 0F 0F E3