- Python stdlib server with SSE live updates, PIN login, remote access - Vanilla JS web UI (English/German): mixer, channel, routing, links, limiter calculator - Preset file export/import with undo, settings backup, lock for the desktop app - Network (TCP 9761) and USB HID transport (Windows, macOS, Linux) - Desktop app via pywebview, Raspberry Pi SD card writer, simulator and protocol tests - README with import guide for Claude Code, CLAUDE.md, protocol documentation Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
164 lines
7.4 KiB
Markdown
164 lines
7.4 KiB
Markdown
# t.racks DSP 204 / DSP 408 – control protocol
|
||
|
||
Documented for interoperability by observing the communication between the devices and their control software
|
||
and by testing on real devices. Both models speak the same protocol; only the number of channels and the size
|
||
of the memory image differ. Implementation: [`dsp/protocol.py`](dsp/protocol.py).
|
||
|
||
Status: the network transport and all commands below are implemented and tested against the simulator; links,
|
||
the limiter status bits and USB were verified on a real DSP 204 (firmware V0104P). Points marked *assumed* are
|
||
not verified yet.
|
||
|
||
## Transport
|
||
|
||
* **Network:** TCP, port **9761**. Factory default IP `192.168.1.101`.
|
||
* **USB:** HID class device, no driver needed, **VID 0x0168 / PID 0x0821** (both models). See [USB](#usb-hid).
|
||
* Request/response: send one command and wait for its answer before sending the next.
|
||
* The DSP accepts only **one** connection at a time.
|
||
|
||
## Frame
|
||
|
||
```
|
||
10 02 SRC DST LEN CMD PAYLOAD… 10 03 CHK
|
||
```
|
||
|
||
| Field | Meaning |
|
||
|-------|---------|
|
||
| SRC/DST | PC→DSP: `00 01`, DSP→PC: `01 00` (`01` = device ID) |
|
||
| LEN | `1 + len(PAYLOAD)` (includes CMD) |
|
||
| CHK | XOR from `02` to `03`, i.e. `0x01 ^ SRC ^ DST ^ LEN ^ CMD ^ PAYLOAD…` |
|
||
|
||
There is **no byte stuffing** – a payload may contain `10 03`, so always parse by LEN.
|
||
All 16-bit words are little endian.
|
||
|
||
## Read / system commands
|
||
|
||
| CMD | Direction | Payload | Meaning |
|
||
|-----|-----------|---------|---------|
|
||
| `10` | → | – | Handshake |
|
||
| `13` | → / ← | – / ASCII | Device info, answer starts with `DSP204` or `DSP408` |
|
||
| `2C` | → / ← | – / `[?][count]` | Number of presets (payload meaning partly *assumed*) |
|
||
| `22`, `14` | → | – | Init queries (sent during connect, content unknown) |
|
||
| `29` | → / ← | `[idx]` / `[idx][name…]` | Preset name (idx 0-based) |
|
||
| `20` | → | `[idx+1]` | Recall preset |
|
||
| `26` | → | `name[14]` | Set name for the next store |
|
||
| `21` | → | `[idx+1]` | Store current state into preset |
|
||
| `27` | → | `[chunk]` | Request config chunk |
|
||
| `24` | ← | `[chunk][50 bytes]` | Config chunk; 204: chunks 0…14, 408: 0…28 |
|
||
| `12` | → | – | Status (sent after the dump) |
|
||
| `40` | → / ← | – / meters | Read levels (also serves as keepalive) |
|
||
|
||
### Meter answer
|
||
|
||
12 entries × 3 bytes `b0 b1 b2`, followed by 2 status bytes.
|
||
|
||
* Level = float32 from the bytes `00 b2 b0 b1` (little endian) → linear, dB = 20·log10.
|
||
* Positions: 0–3 = In A–D, 4–11 = Out 1–8. The 204 uses 0, 1 and 4–7.
|
||
* The level is measured before mute.
|
||
* **Limiter active**: the status bytes are a bit mask of the outputs (bit 0 = Out 1). Measured on a DSP 204:
|
||
`00 03` while Out 1+2 limit, `00 0C` for Out 3+4. That Out 5–8 of the 408 continue in the same 16-bit value
|
||
is *assumed*.
|
||
|
||
## Channel numbers
|
||
|
||
| Device | Inputs | Outputs |
|
||
|--------|--------|---------|
|
||
| DSP 204 | In A=0, In B=1 | Out 1–4 = 2–5 |
|
||
| DSP 408 | In A–D = 0–3 | Out 1–8 = 4–11 |
|
||
|
||
## Set commands
|
||
|
||
| CMD | Parameter | Payload |
|
||
|-----|-----------|---------|
|
||
| `34` | Gain | `[ch][u16 gain]` |
|
||
| `35` | Mute | `[ch][0/1]` |
|
||
| `36` | Polarity | `[ch][0/1]` |
|
||
| `38` | Delay | `[ch][u16 delay]` |
|
||
| `32` | High pass (low cut) | `[ch][u16 freq][slope]` |
|
||
| `31` | Low pass (high cut) | `[ch][u16 freq][slope]` |
|
||
| `33` | PEQ band | `[ch][band][u16 gain][u16 freq][q][type][bypass]` |
|
||
| `48` | GEQ band (inputs) | `[ch][band 0–30][u16 gain]` |
|
||
| `3E` | Gate (inputs) | `[ch][attack][release][hold][threshold]` (u16 each) |
|
||
| `30` | Compressor (outputs) | `[ch][ratio][attack][release][knee][threshold]` |
|
||
| `3F` | Limiter (outputs) | `[ch][attack][release][knee][threshold]` |
|
||
| `3A` | Routing matrix (outputs) | `[ch][bit mask of inputs]` |
|
||
| `41` | Mix level (outputs) | `[ch][input][u16 level]` |
|
||
| `3D` | Channel name | `[ch][name 8]` (printable ASCII) |
|
||
| `3B` | Link | `[ch][u16 link mask]` (see [Channel links](#channel-links)) |
|
||
| `15` | Delay unit | `[unit]` (display only) |
|
||
|
||
The format of the acknowledgement the DSP sends after a set command is not fully understood yet.
|
||
|
||
## Value encoding
|
||
|
||
| Parameter | Raw | Conversion |
|
||
|-----------|-----|------------|
|
||
| Gain / mix level | 0–400 (mix 0–280) | `r<80: r/2−60 dB`, else `(r−280)/10 dB` → −60…+12 dB |
|
||
| Frequency (PEQ, HP, LP) | 0–300 | `1000 · 2^((r−170)/30)` Hz → 19.7 Hz…20.16 kHz (1/30 octave) |
|
||
| PEQ/GEQ gain | 0–240 | `(r−120)/10` dB → ±12 dB |
|
||
| Q | 0–100 | table 0.4…128 (see `protocol.py`) |
|
||
| PEQ type | 0–8 | Peak, Low shelf, High shelf, HPF −6, HPF −12, LPF −6, LPF −12, Allpass 1, Allpass 2 |
|
||
| Slope | 0–20 | 0 = bypass, 1–20 = BW−6, BL−6, BW−12, BL−12, LK−12, … LK−48 |
|
||
| Delay | 0–65280 | `r/96` ms (max 680 ms) |
|
||
| Threshold (gate/comp/limit) | 0–220 | `(r−180)/2` dB (gate max 0 dB, comp/limit max +20 dB) |
|
||
| Attack | 0–998 | `r+1` ms |
|
||
| Release | 9–2999 | `r+1` ms |
|
||
| Hold | 9–998 | `r+1` ms |
|
||
| Ratio | 0–15 | 1.0, 1.1, 1.3, 1.5, 1.7, 2.0, 2.5, 3.0, 3.5, 4.0, 5.0, 6.0, 8.0, 10, 20, Limit |
|
||
| Knee | 0–12 | dB |
|
||
|
||
The absolute output level that corresponds to 0 dB limiter threshold is not published; the app assumes 0 dBu.
|
||
|
||
## Channel links
|
||
|
||
Measured on a DSP 204 (firmware V0104P). Every channel has a u16 mask (bit = channel index within the inputs
|
||
or within the outputs):
|
||
|
||
| Channel | Mask |
|
||
|---------|------|
|
||
| not linked | its own bit only (Out 3 = `04`) |
|
||
| first channel of a group | bits of all members (Out 3+4 = `0C`) |
|
||
| further members | `00` |
|
||
|
||
* Set with `3B [ch][mask]` – for every channel of the group (first channel first).
|
||
* When a group is formed, the DSP copies the settings of the first channel to the others.
|
||
* The DSP itself applies every change on a member to the whole group (gain, delay, polarity, HP/LP, PEQ, GEQ,
|
||
gate, compressor, limiter, mute) – but **not** channel name, routing matrix and mix levels.
|
||
* A member with mask `00` that is not part of a group ignores changes: when unlinking, give every channel its own
|
||
bit again.
|
||
|
||
## Config dump = memory image
|
||
|
||
Chunk `n` carries bytes `n·50 … n·50+49` of the device memory image.
|
||
|
||
```
|
||
0x00 u8[2] ?
|
||
0x02 char[14] preset name
|
||
0x10 Input[nIn] 140 bytes each
|
||
+0 name[8]
|
||
+8 gate: attack, release, hold, threshold (4×u16)
|
||
+16 geq[31] u16
|
||
+78 peq[8] {u16 gain, u16 freq, u8 q, u8 type}
|
||
+126 u16 hp_freq, u16 lp_freq, u8 hp_slope, u8 lp_slope
|
||
+132 u16 gain, u16 polarity, u16 delay, u16 link mask
|
||
Output[nOut] 96 + 2·nIn bytes each
|
||
+0 name[8]
|
||
+8 u16 matrix bit mask
|
||
+10 u16 mix[nIn]
|
||
… u16 hp_freq, u16 lp_freq, u8 hp_slope, u8 lp_slope
|
||
… peq[9] {u16 gain, u16 freq, u8 q, u8 type}
|
||
… comp: ratio, attack, release, knee, threshold (5×u16)
|
||
… limit: attack, release, knee, threshold (4×u16)
|
||
… u16 gain, u16 polarity, u16 delay, u16 link mask
|
||
u16 input mute bit mask, u16 output mute bit mask, then unknown fields
|
||
```
|
||
|
||
Total size: DSP 204 = 724 bytes (15 chunks), DSP 408 = 1448 bytes (29 chunks).
|
||
Where the PEQ bypass flag is stored in the image is not known yet.
|
||
|
||
## USB (HID)
|
||
|
||
* Both models: **VID 0x0168, PID 0x0821**, HID class, no driver.
|
||
* Send: report ID `00` + one complete frame (`10 02 … 10 03 CHK`), zero-padded to the output report length.
|
||
* Receive: every input report holds exactly one frame starting at byte 0, length = `LEN + 8`, then padding.
|
||
* The frames are identical to TCP; the longest (config chunk, 50 data bytes) is 60 bytes and fits a 64-byte report.
|