BB84.MPX1

BB84.MPX1 Roadmap

Delivery plan for the clean-room Lexicon MPX 1 SysEx editor. Requirement IDs refer to the specification.

Release target 1.0: Windows x64, Native AOT, full SysEx coverage, simulator-verified. Hardware validation is optional.

Overview

# Milestone Depends on Status
M0 Repository scaffold & CI — Done
M1 Core protocol codec M0 Done
M2 Transport & session M1 Done
M3 Simulator & replay M1, M2 Done
M4 Learning & parameter database M2, M3 Done
M5 Application shell & parameter editing M4 Done
M6 Programs, librarian & files M4, M5 Done
M7 Full spec coverage: dumps & front panel M5, M6 Done
M8 Hardware validation (optional) M4+ Done (V1.00)
M9 Release 1.0 M7 (M8 if hardware is available) Done
P1 Linux support (post-1.0) M9 Planned
P1.1 Linux groundwork & CI M9 Planned
P1.2 ALSA sequencer transport P1.1 Planned
P1.3 Linux publish & AppImage P1.1 Planned
P1.4 Flatpak P1.2, P1.3 Planned
P1.5 Linux validation & release P1.2, P1.3, P1.4 Planned
P2 macOS support (post-1.0) P1 Planned
P2.1 CoreMIDI transport & macOS CI P1 Planned
P2.2 macOS publish & app bundle P2.1 Planned
P2.3 Code signing & notarization (last) P2.2 Planned

M8 ran on a V1.00 unit; its recordings are replayed in tests (tests/data/hardware/v100). V1.10 hardware has not been tested.

M9 is complete except for its exit criteria that need the maintainer: pushing the v1.0.1 tag (which runs the release workflow; GitHub refuses the v1.0.0 tag name) and checking the zip on a clean Windows machine.


M0 — Repository scaffold & CI

Goal: An empty, buildable solution that enforces the constraints from day one.

Scope

Exit criteria

M1 — Core protocol codec

Goal: Byte-exact encode/decode of every MPX 1 message.

Scope

Exit criteria

M2 — Transport & session

Goal: Reliable request/response over real MIDI ports on Windows.

Scope

Exit criteria

M3 — Simulator & replay

Goal: A fake MPX 1 that makes every protocol path testable without hardware.

Scope

Exit criteria

M4 — Learning & parameter database

Goal: Learn a device once, cache it, and resolve every parameter by name and address.

Scope

Exit criteria

M5 — Application shell & parameter editing

Goal: A usable AOT desktop app that edits live parameters.

Scope

Exit criteria

M6 — Programs, librarian & files

Goal: Move programs in and out of the device and to disk.

Scope

Exit criteria

M7 — Full spec coverage: dumps & front panel

Goal: Every remaining documented feature.

Scope

Exit criteria

M8 — Hardware validation (optional)

Goal: Confirm behavior against a real MPX 1 and close the gaps the document leaves open.

Scope

Exit criteria

Result (V1.00, built Nov 21 1996, via a USB Uno interface)

Not done (moved out of M8)

M9 — Release 1.0

Goal: A downloadable, documented release.

Scope

Exit criteria

P1 — Linux support (post-1.0)

Goal: Run on Linux x64 with real MIDI ports, shipped as an AppImage and a Flatpak.

Linux comes before macOS because the maintainer can test it in a Linux VM. P1.2 and P1.3 depend only on P1.1 and can run in parallel.

P1.1 — Linux groundwork & CI

Issue #40.

Goal: The solution builds and its tests pass on Linux, using the simulator as the only transport.

Scope

Exit criteria

P1.2 — ALSA sequencer transport

Issue #41.

Goal: Real MIDI ports on Linux.

Scope

Exit criteria

P1.3 — Linux publish & AppImage

Issue #42.

Goal: A downloadable Linux build.

Scope

Exit criteria

P1.4 — Flatpak

Issue #43.

Goal: A sandboxed Linux package.

Scope

Flathub submission is out of scope; it can follow once the bundle works.

Exit criteria

P1.5 — Linux validation & release

Issue #44.

Goal: Linux verified end to end and released.

Scope

Exit criteria

P2 — macOS support (post-1.0)

Goal: Run on macOS. Starts after P1.

P2.1 — CoreMIDI transport & macOS CI

Scope

P2.2 — macOS publish & app bundle

Scope

P2.3 — Code signing & notarization (last)

Scope

Exit criteria (P2)


Open research items

# Item Needed by Approach
R1 Verify flattened tables in the *.md extraction against the original Lexicon PDFs, kept outside the repository (Program Dump, Setup, Current Choices, LEDs, Appendix A/B) M1, M7 Manual check against the original PDF. Record fixes in spec section 9.
R2 Display-unit string tables (for example, eq_mode_strings) are not published M4 Use Parameter Display (02) online. Capture strings from hardware in M8 for offline use.
R3 Full control tree and descriptions for V1.00 and V1.10 M3, M8 V1.00 captured in M8 (tests/data/hardware/v100/learn.jsonl). V1.10 still open.
R4 paramall.bin layout (MPX1EDIT cache) Optional Analyze the file format only (no code reuse) to offer an import path, if worthwhile.
R5 Real timing (response latency, BUSY duration, safe inter-frame gap) M8 Measured on V1.00 in M8 (see M8 result). No inter-frame gap needed over USB Uno.
R6 Compact Program Dump (1C) contents — Out of scope (development-only). Pass through raw.