Documentation
MIDI, OSC and DMX
Ports
| USB | A USB MIDI device with two ports in each direction, on the USB C port at the back. |
| MIDI out 1, out 2 | 3.5 mm TRS jacks, type A, the wiring most current synths use. |
| MIDI in | 3.5 mm TRS jack. It accepts type A and type B. |
A control sends on port 0 or port 1. Port 0 goes out on the first USB port and MIDI out 1, port 1 on the second USB port and MIDI out 2, both at the same time.
Message types
| CC | Control change, 7 bit. |
| CC14 | 14 bit control change: the coarse value on the CC you set, the fine value on that CC plus 32. |
| RPN, NRPN | Registered and non-registered parameters, with their MSB and LSB. NRPN can send a 7 bit value. |
| Note | A note on while the value is above the minimum, with the velocity you set. |
| Program change | With an optional bank select, MSB and LSB. |
Port and channel
Set a port and channel for the whole project, for one page, or for a single control. The most specific setting wins: control, then page, then project.
Incoming MIDI
When KARL receives a message that matches a control (CC, CC14, RPN, NRPN, a note or a program change), the control moves to that value and the screen shows it. KARL does not send that value back out, so there is no loop with the other side.
Clock
A Clock control makes KARL the MIDI clock master, at 24 pulses per quarter note on both ports or the ones you choose. It can have a tempo knob, a start and stop key that blinks on every beat, and a tap tempo key. When KARL's clock is stopped and another device sends one, the tempo knob shows that tempo.
OSC
Any control can send OSC to an app on your computer. Set up the app once in the configurator's connections, then give the control an address. The value can be mapped onto another range, and sent as a float, an integer, a true or false, or the text the control shows.
It works both ways: when the app sends to the same address, the control follows. The app can also rename a control or change its colour, and it hears /karl/page with the page name when a page opens. It can open a page by sending /karl/page with a name, an id or a number.
To use KARL as a surface in Chataigne, with a fixed address for every knob and key, see Chataigne.
DMX
Controls can drive lights. KARL keeps the DMX universes and the configurator sends them on your computer's network, over Art-Net or sACN, at the rate you choose in its DMX settings. A control's range goes out as 0 to 255 on one channel, or as 16 bits over two channels.
Universes count from 0, as in Art-Net. sACN counts from 1, so KARL's universe 0 goes out as sACN universe 1.
Snapshots
A row of snapshot keys stores every value on a page: hold ALT and press a key to store, press it to recall. Recalling sets the controls, so their MIDI, OSC and DMX go out again. A fade time makes knobs glide to their stored values. Momentary keys are left out.
