Files
GivouandClaude Opus 5.5 63b3c17fb7 DJ Brake: use the offset measured on a real DSP 204
Measured: limiter threshold minus output meter is about 26 dB when the limiter
starts (25.1 to 27.7, one DSP 204, one output, one piece of music), and the meter
is after the output gain. So the distance is right before the first hit.
The limiter flag also stayed on after raising a threshold, which would have
taught a false value: only limiters starting by themselves teach now.
The measuring tool no longer draws conclusions the data doesn't carry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 21:54:29 +01:00

12 KiB
Raw Permalink Blame History

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.

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.
  • 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 → / ← – / [time lock][4 bytes][device lock] Lock state, see Device lock
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)
2D → / ← [0][code 4] / [0][result] Unlock with the lock code, result 1 = unlocked, 0 = wrong code
2F → [code 4] Set a new lock code
11 → – Sent after setting a lock code (meaning not fully known)
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 and after the output gain (one DSP 204: -6 dB gain moved it by -6.3 dB against the input).
  • The level is far below the limiter threshold's scale. One DSP 204 (V0104P), one output, one piece of music: when the limiter starts, threshold minus the loudest level read is 26 dB (25.1 to 27.7 in five rounds, the same with -6 dB gain). How much of that is a fixed offset and how much are peaks between the readings is not separated. Whether the level is before or after the limiter is open: 6 dB below the start of limiting it fell only 0.9 dB against the input.
  • 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. The bit does not simply follow the level: it stayed on for 4 s, in two of six cases also after the threshold had been raised to +20 dB, and went off within 0.2 s in others. Why is not known.

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)
3C PEQ bypass [ch][0/1] – all PEQ bands of the channel bypassed
49 GEQ bypass (inputs) [ch][0/1]
39 Test signal [source][freq] – source 0 = analog inputs, 1 = pink noise, 2 = white noise, 3 = sine; freq = index 0–30 of the 1/3-octave frequencies 20 Hz…20 kHz (as the GEQ)
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.

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.

Device lock

The DSP can be protected with a 4-character code (digits and upper-case letters, e.g. A1BA, sent as ASCII).

  • During connect, the answer to 2C reports the lock state: byte 5 ≠ 0 means the device is locked. Byte 0 and bytes 1–4 belong to a separate time-based lock that this app does not use.
  • A locked device waits for 2D [00][code] before the rest of the initialisation (22, 14, preset names, dump). The answer 2D [00][01] means unlocked, 2D [00][00] wrong code.
  • 2F [code] stores a new code; the control software sends 11 afterwards. The device asks for the new code from the next connection on. A command to remove the lock is not known.

Status: derived from the behaviour of the control software and implemented against the simulator; not yet verified on a real device.

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
      u16[nIn + nOut] unknown
      u16 test signal source, u16 test signal frequency index (see command 39)
      u16 unknown
      u16 PEQ bypass bit mask inputs, u16 PEQ bypass bit mask outputs (command 3C)
      u16 GEQ bypass bit mask inputs (command 49)

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.

FIR DSP 408 (unverified)

Derived from the behaviour of its control software, not yet seen on a device. Same frames; device info starts with FIR408. The memory image has 1573 bytes (32 chunks) and its own layout:

Offset Content
0x010 + 138·n Input: name 8, gate 4×u16, 3 dynamic EQs of 16 bytes, 8 PEQ bands of 6 bytes, compressor (ratio, attack, release, knee, threshold, EQ frequency as u16, 2 bytes), FIR taps u16, FIR bypass u16, gain, polarity, delay, link
0x238 + 108·n Output: name 8, matrix u16, mix 4×u16, u16, HP frequency u16, LP frequency u16, HP slope, LP slope, HP bypass, LP bypass (bytes), FIR type, window (bytes), low Hz, high Hz, taps index (u16), 9 PEQ bands, limiter (ratio, attack, release, knee, threshold), gain, polarity, delay, link
0x598 Mute masks: inputs u16, outputs u16
0x59C Bypassed PEQ bands, u16 bit mask per channel (inputs, then outputs)
0x5B4 FIR name per channel, 8 characters each

No GEQ on this model, no master bypass commands. Slope index without the "bypass" entry (0 = BW -6). Changed commands:

Cmd Payload
0x31 / 0x32 [ch][u16 freq][slope][1 = bypass]
0x30 [ch] ratio, attack, release, knee, threshold, EQ frequency as u16, [EQ type][EQ bypass] (inputs)
0x3F [ch] ratio, attack, release, knee, threshold as u16
0x4B [ch][type][window][u16 low Hz][u16 high Hz][u16 taps index], outputs. Type: bypass, low, high, band, external. Window: rectangle, Bartlett, Hanning, Hamming, Blackman, sine, sinc, Nuttall, Kaiser, Blackman-Nuttall, Blackman-Harris. Taps = 256 + 32·index
0x4E [ch][packet][u16 total] + up to 12 floats, most significant byte first
0x4F [ch][1 = bypass], inputs
0x5B [ch] + 8 characters of FIR name

At most 2048 coefficients per input, 1024 per output, 4096 over all channels.