synthesizerstereoeffectmidimidi-hostcvclockedworkshop-computer

29 XHT Card

By Adrian Vos

XHT Card is a synthesised deep-note-style gesture rather than a bundled sample. Main sets the note position and one-shot destination. The momentary down switch resets the note and launches a one-shot from the start toward the current destination. CV2 also participates in destination control. P2 can clock stepped movement through the note. X controls delay and Y controls reverb. CV1 input transposes pitch. CV Out 1 mirrors note position unless CV1 is patched, in which case CV Out 1 becomes pitch. CV Out 2 always mirrors note position. P1 gates the note when patched and leaves the note sustained when unpatched. The separate MIDI build adds MIDI note input, CC1/mod-wheel destination control, sustain pedal on CC64, and MIDI note output of the current chord. MIDI clock is ignored.

DownloadXHTCardMidi.uf2 DownloadXHTCard.uf2

SHA256:

Panel

Controls

Main knob

Position / Destination
Manually scrubs the note and sets the one-shot destination.

X knob

Delay
Controls delay amount/time character.

Y knob

Reverb
Controls reverb amount.

Switch

Octave Up: Raises the note by one octave.

Normal Octave: Normal pitch range.

Reset / One-Shot: Momentary reset that launches the note from the start toward the current destination.

Inputs

Outputs

Audio 1

Ext Audio Left
Mixed into the left output before effects.

Audio 2

Ext Audio Right
Mixed into the right output before effects.

CV 1

Pitch Transpose
Transposes the current note position. When patched, CV Out 1 reports pitch instead of position.

CV 2

Position / Destination
Controls note position and the one-shot destination; scaled so 0-5V controller sources cover the full travel.

Pulse 1

Gate
Gates the audio when patched. In the MIDI build, also gates MIDI output when patched.

Pulse 2

Ext Clock
Clocks stepped movement through the note and overrides the one-shot while clocked.

Audio 1

Left Out
Left channel with delay and reverb.

Audio 2

Right Out
Right channel with delay and reverb.

CV 1

Position / Pitch
Mirrors note position unless CV1 is patched, then outputs pitch.

CV 2

Position
Mirrors the current note-position state.

Pulse 1

Note Gate
Mirrors the current note gate; with P1 patched it follows P1.

Pulse 2

Clock Mirror
Mirrors the P2 input pulse.

README

XHT Card

This folder now contains the main and MIDI firmware builds, plus rollback-safe fallback UF2s, for the Music Thing Modular Workshop Computer.

uf2/XHTCard.uf2 — current main build
uf2/XHTCard_fallback.uf2 — last accepted rollback-safe build
uf2/XHTCardMidi.uf2 — current tested MIDI build
uf2/XHTCardMidi_fallback.uf2 — last accepted MIDI rollback-safe build

If you just want the current recommended build, flash uf2/XHTCard.uf2.

Short Control Summary

Main — note position / one-shot destination
X — delay
Y — reverb
switch up — octave up
switch middle — normal octave
momentary switch down — reset / one-shot from start to destination
CV1 in — pitch transpose
CV2 in — position/destination control
P1 in — gate when patched; sustained note when unpatched
P2 in — external stepped clock
Audio 1/2 — stereo output with effects
CV Out 1 — position, or pitch when CV1 is patched
CV Out 2 — position
Pulse Out 1 — note gate
Pulse Out 2 — mirror of P2

MIDI build additions:

MIDI note input transposes pitch and gates sound
sustain pedal is CC64
mod wheel / CC1 controls note destination
MIDI out sends the current chord notes
MIDI clock is ignored
LED 5 shows USB role when not clocking from P2: solid = USB host/controller mode, slow blink = USB device/DAW mode

Quick Guide

README_main.md — current recommended build
README_fallback.md — rollback-safe build
README_midi.md — tested MIDI build
README_midi_fallback.md — MIDI rollback-safe build

Notes

The sound is a synthesised deep-note-style gesture, not a bundled sample.
The project runs at 192 MHz.
The build uses the current authoritative ComputerCard.h from the Workshop Computer tree.
The synthesis idea was inspired by Tod E. Kurt's GPL-3.0 derpnote2, so this project remains GPL-3.0.
In the MIDI build, P1 only gates MIDI out when P1 is physically patched. Unpatched P1 leaves MIDI out always open.
In the MIDI build, note-on/note-off and sustain pedal (CC64) now control whether the sound stays open when playing from a keyboard.
In current active builds, CV Out 1 mirrors note position unless CV1 is patched, when it becomes pitch; CV Out 2 always mirrors note position.
In current active builds, analog CV2 is scaled so 0-5V controller/mod-wheel sources can cover the full note-position travel.
Pulse Out 1 mirrors note gate behavior and Pulse Out 2 mirrors the P2 input pulse.

Verify your download

Confirm the file you downloaded really is that new firmware.

macOS / Linux (Terminal)

shasum -a 256 firmware.uf2

Linux also has sha256sum firmware.uf2.

Windows (PowerShell)

Get-FileHash firmware.uf2 -Algorithm SHA256

Compare the result to the SHA256 on the website — it should match exactly.