Skip to content

Latest commit

 

History

History
345 lines (220 loc) · 12.4 KB

Docs.md

File metadata and controls

345 lines (220 loc) · 12.4 KB

OMX-27 Documentation

Concepts

OMX-27 is a MIDI Keyboard and Sequencer. Both USBMIDI (in/out) and hardware MIDI out (via 1.8" TRS jack) are supported. Various "modes" can be accessed with the encoder and specific functions, parameters or sub-modes can be accessed with the encoder or key-presses/key-combinations.

Sequencer modes have 8 patterns (tracks). Sequencer modes currently send MIDI clock and transport control (start/stop) by default.

CV pitch output is limited to about 4.3 octaves.

USBMIDI should be plug-and-play with any USBMIDI compatible host. iPad works great with the camera connection kit. Hardware MIDI TRS output jack is switchable between Type-A and Type-B.

Layout

omx27_layout3

Top left key = AUX Key.

Potentiometers are mapped by default to CCs 21, 22, 23, 24 and 7 (volume). These can be changed in the firmware. Hopefully this will be configurable from a device menu or a web-MIDI interface in future.

Encoder

Long press encoder to enable mode change. Turn to change modes, short-press to enter mode.

Within the modes a short press on the encoder will select a parameter to edit.

Key Switches

In MIDI modes the key switches work as a normal MIDI keyboard.

In sequencer modes the switches are broken into groups - Function Keys, Pattern Keys and Step Keys.

"Black keys" (sharp/flat keyboard keys)

The first 2 black keys are Function Keys (FUNC)

  • F1
  • F2

The next 8 are Pattern Keys and they select the active sequence pattern (P1-P8).

Hold a key (long press) to access parameters for that pattern. This is "Pattern Params".

"White keys" (bottom row)

Sequencer Step Keys - These are your sequencer step on/off keys.

Hold a key (long press) to access parameters for that step. This is "Note Select / Step Parameters". F1 + Step Key is also a quick shortcut.

Modes

Long-press the encoder to enter Mode Select. Short-press to enter that mode.

While in Mode Select (before you short-press), you can save the state of the sequencer and settings to memory by hitting the AUX key.

MI - MIDI

MIDI Keyboard.

Quick Keys - Hold AUX

  • first 2 "white keys" are octave up/down
  • first 2 "black keys" cycle through the selected parameter on the display

Parameters:

  • OCT: current Octave

  • CH: active MIDI Channel

  • RR: RoundRobin MIDI Channel distribution

  • RROF: RR offset value

  • PGM: MIDI program change

  • BNK: MIDI bank select

  • PBNK: Potentiometer bank select (CC assignments are still hard coded)

  • THRU: when "On" incoming USBMIDI will be passed to TRS MIDI Out.

  • MCRO: MIDI Macro Mode Select (default is OFF)

  • M-CH: MIDI Macro Mode Channel

MIDI Macro Modes

M8 Macro Mode

From MI Mode, be sure M8 is selected from the MCRO parameter and then double click the AUX button to enter Macro Mode.

M-CH should be set to the same value as the Control Map Channel in the M8 MIDI settings screen. Default is set to channel 10.

Double click the AUX button again to exit Macro Mode.

The bottom row of keys correspond to mutes (orange) and solos (red). The top "black keys" are as follows:

Orange - release all mutes  
Lime - go to mixer screen  
Cyan - snapshot load/paste *   
Magenta - snapshot save/enter selection mode *  
Red - release all solos  
Yellow - waveform display  
Blue - play

omx27_m8_macro_mode

When M8 is selected from the MCRO parameter - potentiometers will send on the M-CH MIDI channel in both regular keyboard mode and in the macro mode. However, notes played on keys will send on the currently selected CH MIDI channel.

* Notes:

  • M8 must be on the Mixer view for snapshots.
  • Snapshot Load uses the M8 key combo [SHIFT]+[OPTION]. On any view with a grid (song, chain, phrase, table, etc.) this key enters selection mode.
  • Snapshot Save uses the M8 key combo [SHIFT]+[EDIT]. On any view with a grid this key pastes the copied contents from selection mode.

S1 - Sequencer 1

Step sequencer - One pattern active at a time.

Keys/Commands:

  • AUX is Start/Stop
  • Start/Stop sends MIDI transport control, and MIDI clock when running
  • Pattern Key: Selects playing pattern
  • F1 + AUX: Reset sequences to first/last step
  • F2 + AUX: Reverse pattern direction
  • F1 + Pattern Key: Enter Step Record (transport must be stopped)
  • F2 + Pattern Key: Mute that pattern
  • F1 + Step Key: Enter Note Select / Step Parameters
  • Long press a Step Key: Enter Note Select / Step Parameters
  • Long press a Pattern Key: Enter Pattern Parameters
  • AUX-key exits sub-modes
  • Hold F1 + F2: first 4 "white keys" select "page" of the current pattern (depending on pattern length)

Parameters:
(see below)

S2 - Sequencer 2

Step sequencer - All patterns active.

Keys/Commands:

  • AUX is Start/Stop
  • Start/Stop sends MIDI transport control, and MIDI clock when running
  • Pattern Key: Selects active pattern
  • Encoder changes "page" for sequence parameters (with no parameter highlighted)
  • Short-press encoder to highlight active parameter to edit
  • F1 + AUX: Reset sequences to first/last step
  • F2 + AUX: Reverse pattern direction
  • F1 + Pattern Key: Enter Step Record
  • F2 + Pattern Key: Mute that pattern
  • F1 + Step Key: Enter Note Select / Step Parameters
  • Long press a Step Key: Enter Note Select / Step Parameters
  • Long press a Pattern Key: Enter Pattern Parameters
  • AUX-key exits sub-modes
  • Hold F1 + F2: first 4 "white keys" select "page" of the current pattern (depending on pattern length)

Parameters:

  • PTN: selected pattern

  • TRSP: transpose (by semitones)

  • SWNG: swing

  • BPM: tempo

  • SOLO: set the current pattern to MIDI Solo

  • LEN: pattern length

  • RATE: default note length (1/64th to whole note)

  • CV: enable to send CV from this pattern

In the sequencer modes, the default setup is a GM Drum Map with each pattern on a consecutive midi channel. So that's notes 36, 38, 37, 39, 42, 46, 49, 51 on channels 1-8.

OM - Organelle Mother

Pretty much the same as MI, but with the following tweaks for Organelle Mother on norns/fates/raspberry-pi.

  • AUX key sends CC 25 (127 on press, 0 on release)
  • Encoder turn sends CC 28 (127 on CW, 0 on CCW)

Screensaver

After a default timeout (3 minutes), the display will be blanked and in MI Mode a "screensaver" animation will show on the LEDs. The rightmost pot (#5) can be turned to adjust the color. Touching any keys or any of the other pots will exit the screensaver.

In S1/S2 the screen will blank, but there is no LED animation.

Sub-Modes

AUX-key exits sub-modes

Note Select / Step Parameters

Long press a step key to enter this mode. Here you can change the note values (note number, velocity, note length and octave), set CC parameter-lock values with the knobs, and set step parameters (step events, step probability, trig conditions).

While in Note Select, the rightmost and leftmost keys will blink (orange or blue)- these 2 keys will shift the current octave up or down.

Press AUX to exit Note Select.

Parameters:

Page 1:

  • NOTE: midi note number
  • OCT: octave
  • VEL: note velocity
  • LEN: note length in steps (1-16)

Page 2:

  • TYPE: step event type (see below)
  • PROB: percentage of the step triggering
  • COND: trig conditions (see below)

Page 3: (set CC parameter-locks)

  • L-1: pot 1 p-lock value for this step
  • L-2: pot 2 p-lock value for this step
  • L-3: pot 3 p-lock value for this step
  • L-4: pot 4 p-lock value for this step

Touching any potentiometer while in Note Select will set that p-lock value.

To reset/erase a p-lock - Highlight the parameter and turn the encoder to the left.

Step Events (TYPE): "-" mute "+" play "1" reset to first step ">>" set parttern direction forward "<<" set parttern direction reverse "#?" jump to random step number "?" set random event (of any of the previous events) for that one step

Trig conditions - A/B Ratios (COND): Play that step on the A cycle of B total cycles (or bars) of the pattern. Default is 1:1 (every time). First number - play step on that cycle thru the pattern Second number - resets the counter after that pattern cycle.

So 1:4 would play on the first cycle, not play on the next three and then reset (after the 4th cycle). 3:8 would play only the 3rd cycle and reset after the 8th.

Step Record

(SH-101-ish style note entry)

Holding F1 + a Pattern Key will enter Step Record Mode.

Enter notes from the keyboard and the sequence step will automatically advance to the next step. Change knob 1-4 positions to set a CC parameter lock for that step. Knob #5 (far right) will enter a velocity value for that step (there is no visual feedback when entering values from the knobs.

If you want to skip steps while entering notes, use the encoder button to select the STEP parameter and rotate to the step you want to change/update. While a step is selected, you can also record plocks/velocity for that step with the knobs without changing the note value.

There are two pages of parameters in Step Record. First is the current octave (OCT), step number (STEP), note-value (NOTE), and pattern number (PTN). Second shows the step event parameters TYPE, PROB and COND as described above.

Press AUX to exit Step Record.

Keys/Commands:

  • Potentiometers 1-4 set a CC parameter lock
  • Potentiometers 5 sets a step velocity
  • AUX exit this sub-mode

Pattern Parameters

Long press Pattern Key to enter Pattern Params Mode.

Turning the encoder will show different pages of parameters.

A short-press on the encoder will select the active parameter for editing. Press the encoder repeatedly until nothing is selected to change pages.

Press AUX to exit Pattern Parameters.

Parameters:

Page 1:

  • PTN: selected pattern
  • LEN: pattern length
  • ROT: rotation
  • CH: midi channel

Page 2 (see Sequence Reset Automation below):

  • START: steart
  • END: end
  • FREQ: frequency
  • PROB: probability

Page 3:

  • RATE: default note length (1/64th to whole note)
  • SOLO: MIDI solo

Keys/Commands:

  • Step Keys set pattern length
  • F1 + pattern copies pattern
  • F2 + pattern pastes pattern (to other pattern slot)
  • F1 + F2 + pattern clears the pattern back to GM drum map default (and clears all plocks)

(you can paste multiple times - paste buffer should stay the same until you copy again)

MIDI solo: Set a pattern to MIDI solo and you can play the keyboard while that pattern is selected.

Note - once in MIDI solo, you will only be able to change the active pattern by using the encoder knob.

Pattern Parameters: Sequence Reset Automation

This is located on the second page of pattern parameters

The goal of this "Sequence Reset Automation" feature was developed in the spirit of classic sequencers that can generate more complex sequences from simpler ones by setting any step in a given sequence to trigger a "reset" based on some constraint (i.e., number of cycles, probability, random).

Note - This behavior is a pattern-based solution. You can also execute step-based resets in Step Parameters.

Settings:

  • START (Currently 0 - PatternLength-1): Use this to set the start step in current pattern to reset to for beginning a new cycle.

  • END (Currently 0 - PatternLength-1): Use this to set the last step in current sequence to end/reset pattern cycles. This in essence is the step that will be used to trigger resets.

  • FREQ of trigger reset (i.e., every X sequence cycle iterations)

  • PROB of triggering reset (percentage)

NOTE: Setting STEP = 0 and PROB = 1 dictates random trigger steps which can lead to interesting results by jumping to random position/step.

MIDI Switch for the mini TRS jack connection

A hardware switch on the device will let you swap between Type-A and Type-B for the hardware MIDI TRS jack.

Products That Use Type-A mini TRS Jack Connections

  • ADDAC System products
  • Arturia BeatStep (not to be confused with the BeatStep Pro)
  • Dirtywave M8
  • IK Multimedia products
  • inMusic (Akai) products
  • Korg products
  • Line 6 products
  • little Bits w5 MIDI module
  • Make Noise 0-Coast

Products That Use Type-B mini TRS Jack Connections

  • Arturia BeatStep Pro
  • Novation products
  • Polyend products
  • 1010music Original Series 1 modules, Series 2 modules, Blackbox, MX4 and Euroshield

See https://1010music.com/stereo-minijacks-midi-connections-compatibility-guide for more information