From 1a96beb6d97ab9a7be930aa3997450aa3b1cb8ac Mon Sep 17 00:00:00 2001 From: alphonsom Date: Tue, 11 Aug 2026 13:46:53 +0100 Subject: [PATCH] Document the MCU cable's port name on all three platforms macOS is now verified too: Reaper driving the surface through the dongle's MCU cable with no host software running. That completes the set, and the three naming schemes differ enough to be worth a table. ALSA and CoreMIDI both read the per-cable jack strings, but compose them differently; WinMM ignores them entirely and names cables by position, so on Windows there is nothing called "Command8 MCU" to look for and the cable is identified only by being the fourth port. Anyone configuring a DAW hits this immediately, and looking for a name that does not exist on your platform is a confusing way to start. Co-Authored-By: Claude Opus 5 --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 7894e47..f586ce0 100644 --- a/README.md +++ b/README.md @@ -211,12 +211,19 @@ Mackie Control endpoint, so none of the above is needed — no engine process, n loopback pair, no OSC. Point the DAW's Mackie Control support straight at it, input and output, and leave the surface's own port disabled. -The cable is named `Command8 MCU` on Linux and macOS. On Windows, WinMM names -cables positionally and ignores the jack strings, so it appears as -`MIDIIN4 (Command|8 Bridge)` / `MIDIOUT4 (Command|8 Bridge)` — the fourth port. +Where to find the cable, verified on hardware on all three: -Verified on hardware 2026-08-11: Reaper driving a Command|8 through the dongle -on Windows with no host software running. +| OS | Port name | +|----|-----------| +| Linux (ALSA) | `Command\|8 Bridge Command8 MCU` | +| macOS (CoreMIDI) | `command8-cpp - Command\|8 Bridge - Command8 MCU` | +| Windows (WinMM) | `MIDIIN4 (Command\|8 Bridge)` / `MIDIOUT4 (…)` | + +ALSA and CoreMIDI read the per-cable jack strings; WinMM ignores them and names +cables positionally, so on Windows it is simply **the fourth port**. + +Verified 2026-08-11: Reaper driving a Command|8 through the dongle on Windows +and on macOS, with no host software running on either. The translation is the same `src/mcu/c8_mcu.c` this repo unit-tests on the desktop; the firmware compiles that file directly rather than a copy.