German Version English Version French Version

MIDIbox Plus Tutorial

MIDIbox is built, the power supply is switched on, the MIDI cable is connected - and now? This lesson shows you, how to operate with the Box.

For a first test you should get a MIDI monitor with MIDI Thru function for the PC to look for the incoming MIDI signals. Most MIDI monitors provide the possibility to forward MIDI data to another MIDI device like your soundcard or software synthesizer. I recommend the MIDI-OX tool from Jamie O'Connell and Jerry Jorgenrud which is really great!

No# Description


Menu Exec/Right/Left: Navigation through the menus


Snapshot/Special Function Button: Press it shortly to recall the last settings, press it long to save the current pot settings.
In some submenus, this button offers special functions:
In MIDI Learn Menu: set Button Mode
In Merger menu: switch between MIDI and MIDIbox-to-COM interface
In SysEx Menu: Send SysEx Dump


LC Display: for the visualization of pot values and for the configuration.


Pots: Knobs, Pots... take your favourite name for these things. ;-)
Note that Faders can also be used.


MIDI Trigger Buttons: to trigger MIDI events like Note On/Off, Controller, Program Change... free assignable via MIDI Learn or SysEx Dump


MIDI-IN LED: flashes when MIDI events are received through the MIDI IN port. Optional - the second half of the 74HC00 has to be used to drive this LED.


Init Value LED: is lit when the last turned pot is on the same position like the saved value. In Snap mode, this LED is lit when the value is "snapped" (see description below).


MIDI-OUT LED: flashes when MIDI events are sent through the MIDI OUT port.


MIDI-IN Port: For receiving MIDI events. Has to be connected with the OUT port of another MIDI device, e.g. for the MIDI Learn and Snap function.


MIDI-OUT Port: For sending MIDI events. Has to be connected with the IN port of another MIDI device.


Bank Switches: four switches to select one of 16 banks (binary coding).


Power Supply: input for a wall adapter.

After switching on the box the MIDI monitor should show the controller messages like this: bC 1P XX (C=channel, P=pot 0-7, XX=value). The green LED should flush. If not: check the circuit, the cable, your Wintendo installation. If this doesnt help, curse Wintendo and your soundcard!
A Debug HowTo can be found here.

The Banks concept

Sixteen Knobs are available, but this is not enough for modifing complex sounds. For instance the AWE soundcard provides over 32 soundparameters. Normaly you don't need to change it at the same time. So you can spread it on some banks and just switch between the parameters by changing the bank. MIDIbox provides sixteen full customizable banks. The bank setups can be saved and exchanged via SysEx Dumps.

Menu Handling

The menu handling is quite simple. The menu page is selected by the Menu-Left/Right Button, and with the Menu-Exec Button the submenu can be invoked and leaved.
Below an introduction of the different submenus:


Display Submenu

In this submenu five different display modes are selectable by the Menu-Left/Right buttons:

Display Mode0

The normal mode. At the left upper corner the selected bank is displayed. The N stands for "normal pot behaviour" (see below). The circles at the right upper corner are for the MIDI buttons. They will be filled on a pushed button. At the lower line, a bar for every pot is displayed.

Display Mode1

In Hex mode, the last two sent Pot MIDI events will be displayed.

Display Mode2

In Dec mode, the number of the turned pot and the sent value will be displayed.

Display Mode3

A mix between normal and hex mode.

Display Mode4

A mix between normal and dec mode.

Display Mode5

In MTC mode, the received MIDI Time Code will be displayed.

MIDI Learn

MIDI Learn Submenu

The MIDI Learn function allows to customize the pots and buttons for your own needs. How does it work: plug a MIDI cable from the MIDI IN port of the MIDIbox to the MIDI Out port of your keyboard or PC. Enter the MIDI Learn Mode. Now, the box waits for a message from MIDI IN:

MIDI Learn 0

Send a controller to the MIDIbox (just use your Synth or MIDI-OX for this). The MIDIbox regogninzes all MIDI events and displays the last received one:

MIDI Learn 1

If you want to assign the event to a pot, just turn it "total right" and to "total left". If a button should learn the event, just push the button.

"Learn Single" means, that the controller will be learned from one Pot or Button, only. But sometimes, it is usefull to assign all pots or buttons with the same controller but for different channels. MIDIbox offers a special function for this, just select it with the menu buttons:

MIDI Learn 2

It is also possible to add the controller value automatically. This is favorable, if all pots or buttons should be quickly assigned to unique numbers:

MIDI Learn 3

A special feature is implemented for the buttons: the behaviour of every button can be specified with the Snapshot Button before a event will be assigned to it:

MIDI Learn 4

Send learned value when button pressed, send zero when button released.

MIDI Learn 5

Send learned value only when button pressed, don't send a zero value when button released.

MIDI Learn 6

Send learned value with the first keypress, send zero value with the second keypress.

Beside of controller events, Note On/Off, Program Change, PitchBender, ... can be learned:

MIDI Learn 7 MIDI Learn 8 MIDI Learn 9


Save and Restore of Bank Setups via SysEx Dump

See the SysEx HowTo for further informations. Note that some functions like Min/Max values for the pots can only be configured via SysEx.


Normal, Snapper and Relative Mode

(Ideas to this modes were originated by Frank and Kieran. The Descriptions are partly quoted from the Access Virus Synthesizer Manual. Copyright 2001 by Access Music GmbH. See the MIDIbox Forum for further details)

PotMode 0

Normal Mode: the parameter jumps directly and absolutely to the value determined by the current position of the knob.

PotMode 1

Snap Mode: When you adjust a knob in Snap Mode, the original setting determines the value until the point where the movement of the knob passes beyond this position. In other words, the parameter does not jump to the value as in Normal Mode. However, keep in mind that your adjustments have no effect on the parameter until the knob "snaps" on at the position equivalent to the original parameter. In SNAP mode, an right arrow symbol appears instead of the parameter bar. It indicates in which direction the knob must be turned to exceed the current parameter value. Arrow Left implies the value is lower. The parameter bar appears when the value is "snapped".

PotMode 2

Relative Mode: When you adjust a knob in Relative Mode, the parameter is affected immediately but not absolutely. In other words, the parameter change from the original value to the new value now reflects precisely the amount you adjusted the given knob. ie if the knob value is +30, and when you switch over, the value is now +50, the knob continues on as if it were at the parameter-set +50 position, so when you turn the knob (even though the knob physically is at +30) the next parameter value will be +51 (even though the knob is at +31). Obvoiusly, the downside is that in an unfavorable configuration - the worst case scenario being a maximum parameter value and a knob position at the minimum value - you do not have the full control range of the knob at your disposal. To counteract this situation, you have to turn the knob in the opposite direction to adjust the physical knob position so that it is equivalent to the actual parameter value (ie. turn the knob up to maximum, which will sync it with the maximum parameter value).

PotMode 3

Parallax Mode: The name is cool, isn't it? ;-) A description regarding this mode can be found here


MIDI Merger

The MIDI merger allows you ie. to plug the MIDIbox and a keyboard to a computer w/o a second MIDI In interface. Just plug the MIDI Out of your keyboard to the MIDI In of MIDIbox and the MIDI Out of the MIDIbox to the MIDI In of your computer. But please note that for the Snapper and Relative Mode, you must connect the MIDI In of the MIDIbox with MIDI Out of your computer, otherwise this modes will not work correctly. Also, in this case, you should make sure that the MIDI merger is switched off to avoid feedback loops.

Merger Display

In this mode, you are also able to enable the MIDIbox-to-COM option with the Snapshot Button (4). Find more informations on the MIDIbox-to-COM Interface Page!

Controlling MIDI units with NRPN or SysEx controllers

Older versions of MIDIbox Plus offered the possibility to control AWE/SBLive, XG and GM synthesizer directly. The conversion of the poti values to NRPN and SysEx controllers was handled internaly. These routines allocated a lot of program memory and made it impossible to add new features (note that RAM-Extensions are not available for PICs... ;-)
But with the MIDI Mapping function of MIDI-OX everything changed. The MIDI Mapper allows to translate any controller values to any MIDI events. With the help of this powerfull tool, everyone is able to control synthesizers and soundcards which were not provided by me, and for me it opened the possibility to use the free memory for functions that are hard to find on commercial controllers. :)

FAQ, Tips & Tricks

Please find the collected knowledge in the MIDIbox Wiki and at the MIDIbox Forum.

Last update: 2017-06-24

Copyright 1998-2017, Thorsten Klose. All rights reserved.