Subsystem Search

This page is read from MIDI Instrument Definitions, a Python library used in the author's other projects, in which every number is traced to a document its maker published. Its source is on GitHub.

Teenage engineering OP-XY MIDI implementation

The MIDI implementation of the teenage engineering OP-XY: what it answers to, and the 11 controls it offers, on firmware 1.1.15.

At a glance

Firmware
This page describes firmware 1.1.15.
MIDI channel
Any one of 1 to 16.
Parts
Track, 16 of them: each on a MIDI channel of its own, taking notes and controls.
Voices
24, shared by the parts that play notes.
Note range
Not recorded.
Velocity
Sent and received.
Aftertouch
Answered, of a kind its documents do not say.
Pitch bend
How far it bends is not recorded, and the range can be changed.
Program change
Sent.
MIDI clock
Sent and received.
Start and stop
Received.
Control change
11 controls, in the tables below.
NRPN
Not recorded.
System exclusive
Not recorded.

Controls

In the order the definition gives them, by part and group. Under each control is the name a program calls it by, once pymidiinstrumentdefs.load("teenage_engineering/op_xy") has loaded them.

Track

Control CC Values
Track Volume
track_volume
7 0-127
Track Mute
track_mute
9 0-127
Track Pan
track_pan
10 0-127

On the base MIDI channel

Control CC Values
Tempo
tempo
80 0-127
Groove
groove
81 0-127
Delay Scene
delay_scene
82 0-127
Previous Scene
previous_scene
83 0-127
Next Scene
next_scene
84 0-127
Scene
scene
85 0-127
Project
project
86 0-127
EQ
eq
90 0-127

Where these facts come from

Source documents

How they were read

The full guide v.1.1.15, in both the editions the maker publishes: the printable PDF of 135 pages, cited by page, and the website of 25 sections, cited by the section number each page prints for itself. The release notes and the product page carry facts neither guide edition does.

EVERY CONTROLLER NUMBER BELOW COMES FROM ONE PAGE, section 23 on printed page 122, which introduces itself as the whole of the published map: "sometimes you want to control OP-XY with an external controller. OP-XY has almost all of its controls pre-mapped as midi CCs" (p. 122). It is the only table of controller numbers in all 135 pages, and the website's edition of that same section is the only other place any of them is printed.

THE TWO EDITIONS OF ONE GUIDE DISAGREE IN FOUR PLACES, and only the first changes a number. Section 23's fourth row reads "track parameters" (guide p. 122) at CC "12-47" in the printable guide and at CC "46" on the website, so no control for it is written. Its seventh row is "delay scene" in the printable guide and "scene (delayed switch)" (midi_cc_table) on the website, both at CC 82; the release notes settle what it does - "add midi command for setting delayed scene" (os_updates, 1.1.0) - so the printable guide's shorter name is used below and the other is recorded here. The printable guide's specifications say "midi over bluetooth le" (p. 3) where the website says "bluetooth LE midi" (hardware_overview), and its section 1 says "midi over bluetooth ble" (p. 1), contradicting itself. And the website's section 10 states the voice pool and the per-track channel outright where the printable guide states neither anywhere in its 135 pages.

THE PRINTABLE GUIDE NUMBERS ITS PAGES IN TWO RUNS, and its source records both. What to add to a printed page number to reach the page of the file is 4 up to printed page 52 and 5 from printed page 53 on, because file page 57 is an unnumbered overflow of section 14.6. When this definition was written a source could hold one offset only, so it cited nothing below printed page 53, and the facts that live only in the earlier run are cited from the website sections and the product page instead, which have no pages at all. A citation of the earlier pages now turns to the right page. The guide's own index is no help: it is right through section 14 and then falls behind the pages themselves by one, two, three and finally five, putting section 23 on page 117 where that page prints 122.

THE PRINTABLE GUIDE ALSO CARRIES AN INVISIBLE SECOND TEXT LAYER, added by the maker's PDF tooling, which extracts alongside the real text and misreads it - "Ito" for "lfo", "ep1ano" for "epiano", "84" for "8.4". Everything read from that document was taken from the visible layer alone and read again from the rendered page as an image, by two readers working separately and by different methods, who agreed on all twelve rows of the table and on every dash in it.

SIXTEEN TRACKS, EACH ON A CHANNEL THE PLAYER SETS: "the midi settings page in project settings allows you to set the midi channel on each of the 16 tracks" (project), which the product page states as "midi channels selectable per track" (product_page) and the table's own channel column shows as 1-16. Eight of the sixteen are instrument tracks and eight are auxiliary - "8 individually sequenceable instrument tracks" (product_page) - and the four track controls below reach any of them, so they are one part rather than two.

THREE WAYS IN, which is why no transport is called the MIDI one: "3.5 mm midi in" (hardware_overview), "usb type-c audio/midi host & device" (hardware_overview) and "bluetooth LE midi" (hardware_overview). The multi-out jack is the way out, and only when set to it - "you can choose between: midi cv/gate sync8 sync16 sync24 audio" (p. 87). A DIN synthesiser needs "a type a trs to midi cable" (p. 111), which is the only statement of the wiring anywhere.

NOT RECORDED, each for its own reason.

SYSTEM EXCLUSIVE and NRPN: neither word appears on any of the 135 pages or on any section page, searched for as sysex, system exclusive, exclusive, NRPN and RPN. The only mention in any document here is a release note, "avoid crash on certain sysex messages" (os_updates, 1.0.29), which says the messages arrive and are parsed, not that any of them is implemented - and that is the difference from the OP-1, whose release notes describe an identity reply that actually answers.

THE NOTE RANGE: never stated. The built-in keyboard is "a two octave keyboard" (p. 6) with octave buttons, which is the panel and not what arrives.

RECEIVING A PROGRAM CHANGE: the words never appear; what is described is this instrument sending one.

AFTERTOUCH'S KIND: it is received and routable, quoted against voice below, and recorded as received, but the guide never says whether it is channel or polyphonic.

THE BEND RANGE IN SEMITONES: settable, but no range and no default is printed.

THE PRESET COUNT: there are preset folders and "thousands of projects" (guide p. 6), and no count addressable by program change.

WHERE THE SEARCH DOES NOT REACH, said plainly. It covers both editions of the guide, the OS updates page and the product page. It does not cover the maker's support site, which this maker's OP-1 established answers 403 to anything fetched here, so if a MIDI note is published there it has not been read.