Using HX3 with MIDI controllers: Unterschied zwischen den Versionen

Aus KeyboardPartner Wiki
Zur Navigation springenZur Suche springen
 
(176 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
==MIDI Control==
==MIDI Control==


HX3 expander accepts MIDI key on/off events (default: channel 1 to upper manual, 2 to lower manual, channel 3 to bass pedals) as well as various MIDI CCs with selectable compatibility sets. There is a slight influence to key click noise be MIDI dynamics. SysEx data is always ignored. Both MIDI jacks act as MIDI inputs with equal priority, so that you may connect two separate MIDI keyboards or controllers at the same time.
HX3 accepts MIDI key on/off events (default: channel 1 to upper manual, 2 to lower manual, channel 3 to bass pedals) as well as various MIDI CCs with selectable compatibility sets. MIDI dynamics slightly affect key click noise. SysEx data other than its own are always ignored. Both MIDI jacks act as MIDI inputs with equal priority (default). The second MIDI jack may be jumpered as MIDI Out. (Details for HX3 mk4 see '''[[http://wiki.keyboardpartner.de/index.php?title=HX3_mk3/mk4_additional_info#HX3_mk4_Changes HX3 mk4_Changes]]''', for HX35 see '''[[http://wiki.keyboardpartner.de/index.php?title=HX3.5_Installation_Manual#MIDI_Configuration MIDI Configuration]]''').
HX3 expander may be remote-controlled via given MIDI CC set, but some settings are available via menu system only. If a valid MIDI CC command is received (despite expression/volume changes) for current MIDI CC set, MenuPanel will briefly show the changed parameter.  
 
You may connect two MIDI keyboards or controllers at the same time. Connecting a third MIDI device requires a MIDI Merge Interface. All HX3 functions that are relevant for the organ player may be remote-controlled by MIDI commands.


==General==
==General==


Please connect MIDI out of your MIDI controller/keyboard to one of the two HX3 MIDI inputs. As MIDI being a one-way interface, HX3 cannot determine the setting of any MIDI controller value until you touch/use it once. As default, all HX3 controllers are OFF. Do not use any controller button or drawbar unless HX3 is ready to accept its data (drawbar preset displayed). It is a good idea to power up HX3 before your MIDI master keyboard or master controller.  
Connect MIDI Out of your MIDI controller/keyboard to one of the two HX3 MIDI inputs. Since MIDI is a one-way interface, HX3 cannot determine the setting of any MIDI controller value until you touch/use it once. By default all HX3 controllers are OFF. Do not use any controller button or drawbar unless HX3 is ready to accept data (drawbar/preset menu displayed). It is a good idea to power up HX3 before your MIDI master keyboard or master controller.


MIDI CC #7 controls the rotary amp volume which only affects the rotary or rotary amp simulation, not plain organ output. MIDI CC #11 controls swell pedal/expression if no expression pedal connected to HX3.
MIDI CC #7 (default, CC number variable) controls master volume. MIDI CC #11 (default, CC number variable) controls swell pedal/expression if no expression pedal connected to HX3. If you use your HX3-attached swell pedal, any MIDI expression message will be overwritten. If the attached swell pedal is not actuated, MIDI expression messages are accepted.  
If you use your HX3-attached swell pedal, any MIDI expression message will be overwritten. Otherwise, by not touching the attached swell pedal, MIDI expression messages are accepted.  


Note: Some MIDI controllers as well as organ keyboards (like Hammond XK and SK series) allow 2nd and 3rd harmonic percussion ON at the same time. HX3 implementation regards "2nd ON" as "Percussion ON" tab in this case.
==HX3.4==
See Menu Panel section to select the desired MIDI CC set. Factory default is Native Instruments B4, which provides the most versatile command set.


MenuDisplay and HX3 Remote allow setup of MIDI Channel as well as MIDI CC set. Step down to MIDI menu section to alter settings. Press Encoder knob for 2 seconds to save to power-up defaults.
Some MIDI controllers as well as organ keyboards (like Hammond XK and SK series) allow 2nd and 3rd harmonic percussion ON at the same time. In this case HX3 implementation regards "2nd ON" as "Percussion ON" tab.  


* MIDI Channel <1> - sets MIDI base send/receive channel 1 to 10 (upper manual, lower manual is on +1, pedals on +2).  
Refer to section 3.2.4 Group Commons in the user manual to select the desired MIDI CC set. Factory default is Native Instruments B4.
* MIDI Option <RcvSendMerge> - sets MIDI routing behaviour to  
 
MenuDisplay and HX3 Remote (HX3.4) or HX35 Editor (HX3.5 only) allow setup of MIDI Channel as well as MIDI CC set. Step down to MIDI menu section to alter settings. On the Menu Panel, press encoder knob for 2 seconds to save to power-up defaults.
 
* '''MIDI Channel''' - sets MIDI base send/receive channel 1 to 10 (upper manual, lower manual is on +1, pedals on +2).  
 
* '''MIDI Option''' - sets MIDI routing behaviour to  
** 'ReceiveThru' (MIDI OUT is THRU),  
** 'ReceiveThru' (MIDI OUT is THRU),  
** 'ReceiveSend' (MIDI received, only own MIDI key events to MIDI OUT),  
** 'ReceiveSend' (MIDI received, only own MIDI key events to MIDI OUT),  
** 'RcvSendMerge'(MIDI received, own MIDI key events and incoming MIDI events merged to MIDI OUT) and  
** 'RcvSendMerge'(MIDI received, own MIDI key events and incoming MIDI events merged to MIDI OUT) and  
** 'RcvSndMgNoCC' (as before, but MIDI CC commands discarded). On expander module, only valid setting is 'ReceiveThru'.  
** 'RcvSndMgNoCC' (as before, but MIDI CC commands discarded). On expander module, only valid setting is 'ReceiveThru'.  
* MIDI CC Set <NI B4> - sets recognized MIDI CC set to  
 
* '''MIDI CC Set''' - sets recognized MIDI CC set to  
** 'NI B4' Native Instruments B4 (default),  
** 'NI B4' Native Instruments B4 (default),  
** 'Voce' MIDI drawbars,  
** 'Voce' MIDI drawbars,  
** 'Hamichord' (or 'KeyB Duo' on special request),  
** 'Hamichord' (or 'Mojo', same hardware),
** 'Hammond XK',
** 'Hammond SK' (Note: Hammond changed MIDI CC set between XK and SK series, please try out which one fits),
** 'KeyB Duo',
** 'Custom'
 
===HX3.4 Generated MIDI Events===
 
HX3.4 (mk2/3/4 board) transmits local keyboard ON/OFF events on MIDI base channel (upper), MIDI base channel +1 (lower) and MIDI base channel +2 (pedal). It sends MIDI CCs of user controls (drawbars, tabs) according to NI B4 implementation (independently of selected CC set). From firmware 3.82 and up, HX3 will not send own MIDI CCs on MIDI OUT when '''MIDI Option = 3''' (RcvSndMgNoCC). MIDI Option = 3 is now default on all firmwares except HX3 Expander (which has to accept MIDI CCs). This change has been made since MIDI CCs sended by HX3 may disturb MIDI workstations/arrangers. Note: If send/receive of MIDI CCs is enabled (Option = 1 or 2), HX3 will transmit its own CCs.
 
HX3 will transmit swell pedal on CC #11 (0x0B) as well as rotary run/stop on CC #68 (0x44) and fast/stop on CC #01.
 
===Program Change on HX3.4===
 
HX3 mk4 will accept MIDI Program Change Commands in some MIDI CC sets. In NI B4 mode, MIDI program changes 12..23 on '''upper''' manual channel will set '''lower''' manual voice according to common NI B4 hardware controllers. In Hammond CC modes, program 11 is the "live" preset (inverse "B" key) and will recall voice 0.
 
==HX3.5==
 
HX3.5 supports MIDI over USB through its USB port connected to a USB host, typically a PC. The USB connection is also suitable for controlling HX3.5 by the HX35 Editor application, firmware updates via MIDI SysEx, and DSP updates via DFU data transfer. '''Important:''' MIDI IN2 and MIDI IN over USB must not be used simultaneously.
 
'''(HX3.5 and later)''' The new CC Set Editor allows a very extensive adaptation to the controlling device; the CC Sets known from HX3.4 have been taken over and partly supplemented. They can be changed at will (exception: NI B4 and Hamichord due to some special features in vibrato, percussion and presets). Important: The extended scan driver available in HX3.5 accepts the MIDI CCs for the sustain and sostenuto pedal. However, some devices use CCs #64 and #66 for other functions (NI B4, Hamichord). When CCs #64 or #66 are used in a CC Set, the Sustain and Sostenuto functions in scan drivers (MIDI receive as well as directly connected keyboards) are disabled, so that the assigned controller does not result in "hanging" notes. The new CC-Set "HX3.5/KBP native" (firmware #5.6xx or higher) is the most comprehensive CC-Set available, it allows remote control of all relevant HX3.5 parameters.
 
The menu panel and HX35 Editor allow you to set the MIDI channel and select the MIDI CC set. In the menu, press and hold the knob for two seconds to save the setting as the start default value.
 
* '''MIDI Channel''' - sets MIDI base send/receive channel 1 to 10 (upper manual, lower manual is on +1, pedals on +2).
 
* '''MIDI Option''' - sets MIDI routing behaviour to
** 'Local Tx' (MIDI OUT sends own keyboard data),
** 'Inp 1 Thru' (MIDI IN1 routed to MIDI OUT and MIDI OUT over USB),
** 'Inp 2 Thru' (MIDI IN2 routed to MIDI OUT) and
** 'USB InThru' (MIDI IN over USB routed to MIDI OUT).
 
* '''MIDI CC Set''' - sets recognized MIDI CC set to
** 'NI B4' Native Instruments B4 (default),  
** 'Hammond XK',  
** 'Hammond XK',  
** 'Hammond SK' (Note: Hammond changed MIDI CC set between XK and SK series, so try out which will fit),
** 'Hammond SK' (Note: Hammond changed MIDI CC set between XK and SK series, please try out which one fits),
** 'KeyB Duo' or
** 'Versatile' Boehm, Sempra,
** 'Custom' (controllers to be set by HX3 Remote)  
** 'Nord C1/C2'
** 'Voce' MIDI drawbars,  
** 'KeyB Duo',
** 'Hamichord' (or 'Mojo', same hardware),
** 'HX3.5/KBP' for TouchOSC, but can also be used for freely configurable master keyboards,
** 'Custom A' (to be set and renamed by HX3 MIDI CC Set Editor) ex factory occupied by Nord C2D CC set,
** 'Custom B' (to be set and renamed by HX3 MIDI CC Set Editor)
 
Further CC sets are available and can easily transfered to the HX3.5. Supported instruments include Hammond XB2, Hammond XB3, Nord electro 4, Viscount Legend and more.
 
===HX3.5 Generated MIDI Events===
 
HX3.5 is transmitting local keyboard ON/OFF events on MIDI base channel (upper), MIDI base channel +1 (lower) and MIDI base channel +2 (pedal). It sends MIDI CCs of user controls (drawbars, tabs) according to selected CC set. MIDI IN1, IN2 and MIDI over USB are always accepted.
 
For OEM only: Independent from MIDI option selected, HX3 will always send a 3.3V TTL level MIDI signal on PL16 pin 8 for controlling Ventilator/Minivent DSP board with synced stop/slow/fast. Pin 34 of Vent DSP board is MIDI TTL input. Also wire digital ground (PL16 pin 10). Ventilator DSP accepts MIDI CC #21 values 0 (stop), 1 (slow), 2 (fast) on channel 1.
 
With TouchOSC it is possible to create a preset by remote control; otherwise the memory function of the menu panel must be used.
 
===Program Change on HX3.5===
 
In general, HX3.5 (firmware 5.3 and up) will handle '''MIDI Program Change Commands''' (valid numbers range from 0 to 15). Numbers will be handled as "Set Drawbar Voice" for upper, lower and pedal MIDI channel separately, i.e. it resembles the "inverse" preset keys found on Hammond console organs. Drawbar Voice changes will not affect Tab settings (Percussion, Vibrato etc) in any way. Use the Common Presets for this.
 
However, not all HX3.5 MIDI CC sets are handling MIDI program changes in the same way: In NI B4 mode, MIDI program changes 12..23 on '''upper''' manual channel will set '''lower''' manual voice complying with common NI B4 hardware controllers. In Hammond CC modes, program 11 is the "live" preset (inverse "B" key) and will recall voice 0. In Nord C1/C2 CC mode, program 126/127 are "live" presets (inverse "A#" and "B" key) and will recall voice 0.
 
===Bank Select on HX3.5===
 
HX3.5 will handle '''MIDI Bank Select Commands''' as "Set Overall Preset" (valid numbers range from 0 to 15 or 0 to 99 from FW #5.516 on) per default. Overall Presets include all Tab settings and additional pots (volume, reverb amount etc) as well as the drawbar settings. Note that some MIDI keyboards will send a MIDI Bank Select command separately, others will issue a MIDI Bank Select only with a MIDI Program Change. In the latter case, the issued MIDI Program Change command will override the voice setting.
 
Early HX3.5 boards switched Common Presets with a bank select command (20 hex or 32 dec.). This caused incompatibilities with unusual MIDI implementations of the controlling keyboard (e.g. Mojo). Starting with firmware #5.526, the CC command for switching the Common Presets can be set using the menu. Please note: Common Presets '''cannot''' be switched using MIDI Program Changes, which are reserved for the above Drawbar settings.
 
'''Up to HX3.5 FW #5.4xx:''': Common Presets 0..15 are selected in all CC Sets by Bank Select messages (MSB, CC #00), with all three channels valid.
 
'''HX3.5 FW #5.500 to #5.515:''' These firmwares contained a bug that prevented Common Preset switching.
'''Starting with HX3.5 FW #5.516:''' Common Presets 0..99 are selected in all CC Sets by bank select commands (LSB, CC #32 decimal), where all three channels are valid.
 
'''Starting with HX3.5 FW #5.526:''' Common Presets 0..99 are selected in all CC Sets by a CC command (default: #32 dec. = Bank Select LSB) that can be set in the menu, where all three channels are valid.


==MIDI CC Sets==
==MIDI CC Sets==


HX3 has 6 pre-configured MIDI CC sets plus one fully customizable set, selectable by Menu or by HX3 Remote application. Factory default is the Native Instruments B4 set, supported by many MIDI controllers. All values based decimal!
HX3 provides several pre-configured MIDI CC sets plus one fully customizable set (two custom CC sets on HX3.5), selectable by MenuPanel, by HX3 Remote or HX35 Editor application, respectively. Factory default is the '''Native Instruments B4''' set, supported by many MIDI controllers. If MIDI CC output is enabled, HX3.4 will '''send''' CCs always according to NI B4 set. HX3 does '''not''' support weird SysEx encodings found on some Roland, Oberheim and Viscount models. '''All values based decimal!'''


UNDER CONSTRUCTION!
A very comprehensive '''Versatile Böhm/Keyswerk Sempra''' MIDI CC set is available on HX3.5 mainboards.
 
Starting with firmware version 5.61x, the HX3.5 "MIDI CC Editor" window can be used to fetch, modify and write back CC sets from the HX3.5. Due to some special features, some functions are fixed for CC Set "#0 NI B4" and "#7 Hamichord" (e.g. the vibrato setting for the NI B4, where a NI B4 controller sends two values). With these sets, some CC settings previously handled in the firmware cannot be changed, all others can.
 
===#0 NI B4 d3c===
 
The Doepfer d3c drawbar controller is a very nice and rugged piece of gear, so we recommend it for use with our HX3 board. It does support foot controllers and foot switches. The Keyswerk/Böhm db4 is also compatible with NI B4 CC set.
 
Upper, lower and bass drawbars work as usual. It is a good idea to set all to zero before switching on as this is a “known state” for HX3. Also the Percussion and Vibrato buttons work as described in d3c manual. There is a small drawback, anyway: Default HX3 Vibrato setting is V1 (but upper/lower vibrato OFF), while the V1 LED will not light up when powering up the d3c (there is no “V0” on a real Hammond!). So pressing the V1 button will not change the sound – just turn its LED on.
 
The BRIGHTNESS knob controls AO28 tone parameter of the HX3. There is no key click simulated by HX3 (it is just there), so there is no key click adjustment button. The KEY CLICK knob controls the bass sustain instead. 
 
Do not use the HARMONIC CONTENT knob as it sends the PERCUSSION button’s controller number like a continuous controller. What for? No idea. This is definitely of no use.
 
Preset buttons may be used, but in a restricted way. First, HX3 has 15 presets per manual, not 127 like NI B4. When selecting BANK 1, all 12 available preset buttons work on upper manual. When selecting BANK 2, all 12 preset buttons work on lower manual. Doepfer d3c resends the program change message when changing the bank, which may be annoying. Therefore, proceeds as follows: Choose bank 2, lower preset first, then bank 1, upper preset. BTW: Bank buttons do not send bank select messages, they just add an offset to the preset buttons. Blame Doepfer for that.
 
Doepfer d3c preset 1 is the HX3 “Live” (preset 0) position. It will be saved temporarily (until HX3 is switched off) when a preset sound (2 to 12) is selected. If you return to preset 1 “Live”, your last drawbar/button setting will be recalled. Please note: HX3 tracks drawbar and button changes even when in preset position 2 to 12, so it keeps itself updated all the time.
 
NI B4 set accepts program changes for upper manual MIDI channel, range 0..11 = upper presets and 12..23 = lower presets.


===NI B4 d3c===


{| border="1" cellpadding="8" cellspacing="0"
{| border="1" cellpadding="8" cellspacing="0"
Zeile 47: Zeile 138:
|-
|-
|1
|1
|001
|1
|Switch
|Switch
|Rotary Slow/Fast
|Rotary Slow/Fast
|Modulation Wheel
|Modulation Wheel
|-
|1
|7
|Slider
|Master Volume
|was "122 Amp volume" on older firmwares
|-
|1
|11
|Slider
|Swell Pedal
|
|-
|-
|1
|1
Zeile 71: Zeile 174:
|-
|-
|1
|1
|031
|31
|Switch
|Switch
|Vibr Upper ON
|Vibr Upper ON
Zeile 104: Zeile 207:
|Switch
|Switch
|Percussion SOFT
|Percussion SOFT
|
|inverted!
|-
|-
|1
|1
Zeile 110: Zeile 213:
|Switch
|Switch
|Percussion FAST
|Percussion FAST
|
|inverted!
|-
|-
|1
|1
Zeile 120: Zeile 223:
|1
|1
|73
|73
|CC
|Fixed
|Vibr Mix
|Vibr Mix
|Chorus if < 96
|Chorus if < 96
Zeile 126: Zeile 229:
|1
|1
|74
|74
|CC
|Fixed
|Vibr Amount
|Vibr Amount
|Threshold 0 for V1, 56 for V2, 88 for V3
|0..55 = V1, 56..87 = V2, 88..127 = V3
|-
|-
|1
|1
|75
|75
|Slider
|Slider
|Bass Sustain
|Bass Pedal Sustain
|"Key Click" on B4
|"Key Click" on B4
|-
|-
Zeile 139: Zeile 242:
|76
|76
|Slider
|Slider
|Amp 122 Volume
|Tube Amp Gain
|"Tube Amp Drive" on B4
|"Tube Amp Drive" on B4
|-
|-
Zeile 156: Zeile 259:
|1
|1
|84
|84
|Slider
|Fixed
|Reverb
|Reverb
|< 24 OFF, > 23 Rev 1, > 48 Rev 2, > 63 Rev 3
|0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
|-
|-
|2
|2
Zeile 173: Zeile 276:
|}
|}


===Using HX3 with Voce MIDI Drawbars===
<br>
 
===#0 NI B4D===
 
'''From HX3.5 Firmware #5.621'''


Using your HX3 board with Voce MIDI Drawbars is straightforward, as the Voce module supports only one MIDI channel (i.e. upper manual). Please note that Voce MIDI Drawbars does not send drawbar data unless you press the “Drawbar/Save” button, so it’s LED lits up.
The '''Drawbar-Controller B4D''' (only one drawbar set, made by Böhm for Native Instruments) sends mostly the same CCs as the Doepfer d3c, but the most important difference is the assignment of the drawbars: All Drawbars are sent on CC 12..20, but with different channel identifiers. It also sends tab CCs (percussion, vibrato knob) with very own values. We have adapted the NI B4 set especially for this controller, it can be used alternatively to the NI B4 set for Doepfer d3c (factory setting). For the D4B, upload the set ''boehm_b4d.csv'' using the HX3.5 Editor window "MIDI CC Editor": 
You may change the Voce MIDI Drawbars send channel (back rotary HEX switch) at any time to lower (2) and bass channel (3), although this is somewhat inconvenient. Have your technician install a toggle switch on the back side so channels may be changed easily.  


===Using HX3 with Doepfer d3c or other NI B4 drawbar controller===
*Use "Open CSV Table..." to load the file ''boehm_b4d.csv'' in the ''user'' directory
*With "Actions -> Upload this CC set to HX3.5 as... ->#0 (NI B4, send only)" to HX3.5


The Doepfer d3c drawbar controller is a very nice and rugged piece of gear, so we recommend it for use with our HX3 board. It has support for foot controllers and foot switches. The Keyswerk/Böhm db4 is also compatible with NI B4 CC set.
To return to the Doepfer d3c set, upload the ''nib4_send.csv'' set using the HX3.5 "MIDI CC Editor" window:  
Upper, lower and bass drawbars work as usual. It is a good idea to set all to zero before switching on as this is a “known state” for HX3. Also the Percussion and Vibrato buttons work as described in d3c manual. There is a small drawback, anyway: Default HX3 Vibrato setting is V1 (but upper/lower vibrato OFF), while the V1 LED will not light when powering up the d3c (there is no “V0” on a real Hammond!). So pressing the V1 button will not change the sound – just it’s LED turns on.


The “Brightness” knob controls AO28 “tone” parameter in HX3. There is no key click emulation in HX3 (it is just there!), so you may not adjust key click (a real Hammond does not have key click adjustment, either). The “Key Click” knob controls the bass sustain instead. You may argue “a real Hammond does not have a bass pedal sustain, too”. Right, but many aftermarket kits are installed, so this is OK (for me). Do not use the “Harmonic content” knob as it sends the “Percussion” button’s controller number like a continuous controller. Why that? No idea. This is definitely of no use.  
*Load file with "Open CSV Table...
Preset buttons may be used, but in a restricted way. First, HX3 yields 15 presets per manual, not 127 like NI B4. When selecting “Bank 1”, all 12 available preset buttons work on upper manual. When selecting “Bank 2”, all 12 preset buttons work on lower manual. Doepfer d3c resends the program change message when changing the bank, which may be annoying. Choose bank 2, lower preset first, then bank 1, upper preset. BTW: Bank buttons do not send bank select messages, they just add an offset to the preset buttons. Blame Doepfer for that.
*With "Actions -> Upload this CC set to HX3.5 as... ->#0 (NI B4, send only)" to HX3.5
Doepfer d3c preset 1 is the HX3 “Live” (preset 0) position. It will be saved temporarily (until HX3 switched off) when switching to a preset sound (2 to 12). If you return to preset 1 “Live”, your last drawbar/button setting will be recalled. Please note: HX3 tracks drawbar and button changes even when in preset position 2 to 12, so it keeps itself updated all the time.
There is no way to save an upper or lower preset/program remotely; you have to use the MenuPanel’s Save function, see below.


===Using HX3 with Hammond XK/SK series===
The D4B sends all set MIDI values when powered on, so you should first power up HX3.5 and then the D4B. For the pedal, the Drawbar sequence 16, 16H, 8, 8H, Release (Sustain) applies to the first 5 Drawbars on the D4B. The "Bank" button is a little ambiguous: it does not send a bank select message, but only moves the MIDI program changes ("preset" numbers) up.
 
<br>
 
===#1 Hammond XK===


HX3 supports most of Hammond XK MIDI controller functions. For convenience, some controllers have been relocated to other HX3 functions:
HX3 supports most of Hammond XK MIDI controller functions. For convenience, some controllers have been relocated to other HX3 functions:


* XK Overdrive knob controls HX3 Rotary tube Amp Volume
* XK Overdrive knob controls HX3 Rotary Tube Amp Volume
* XK Reverb button controls HX3 lower manual Vibrato On
* XK Reverb button controls HX3 lower manual Vibrato On
* XK Tube On button controls HX3 Reverb
* XK Tube On button controls HX3 Reverb


==Settings==
Hammond uses NRPN controllers instead of standard controllers. Drawbars are encoded through a weird grid scheme using only 3 CC#s, see XK manual for details.
 
Hammond XK set accepts program changes for upper manual and lower manual MIDI channel, range 0..15. Hammond Preset 11 will be converted to HX3 preset 0 (live).
 
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''Function'''
|'''Remarks'''
|-
|1,2,3
|6
|Value
|NRPN data entry
|
|-
|1,2,3
|7
|Slider
|Master Volume
|
|-
|1,2,3
|11
|Slider
|Swell Pedal
|
|-
|1,2,3
|80
|Fixed
|Upper drawbars
|According to Hammond encoding, see XK user manual
|-
|1,2,3
|81
|Fixed
|Lower drawbars
|According to Hammond encoding, see XK user manual
|-
|1,2,3
|82
|Fixed
|Pedal drawbars
|According to Hammond encoding, see XK user manual
|-
|1,2,3
|95
|Don't Care
|Save Upper
|If received, saves upper drawbars and setup to current preset#
|-
|1,2,3
|96
|Don't Care
|Save Lower
|If received, saves lower drawbars and setup to current preset#
|-
|1,2,3
|98
|Value
|LSB of NRPN controller#
|
|-
|1,2,3
|99
|Value
|MSB of NRPN controller#
|
|}
 
 
Hammond XK NRPN Encoding is as follows (NRPN represented as hexadecimal values):
 
{| border="1" cellpadding="8" cellspacing="0"
|'''NRPN #'''
|'''XK Function'''
|'''HX3 Function/Remarks'''
|-
|00,0A
|EQ Bass Gain
|Swell Trim (!)
|-
|02,0A
|EQ Treble Gain
|TONE pot (!)
|-
|02,09
|Vib Upper ON
|(same)
|-
|17,09
|Vib Lower ON
|(same)
|-
|04,0A
|Reverb ON
|Vib Lower ON (!)
|-
|03,09
|Vib Knob
|0=V1, 1=V2, 2=V3, 3=C1, 4=C2, 5=C3
|-
|00,09
|Leslie Run
|(same)
|-
|01,09
|Leslie Fast
|(same)
|-
|05,09
|Overdrive
|Tube Amp Gain
|-
|00,08
|Perc ON
|(same)
|-
|01,08
|Perc THIRD
|(same)
|-
|02,08
|Perc FAST
|(same)
|-
|03,08
|Perc SOFT
|(same)
|-
|09,09
|Tube ON
|Reverb ON (!)
|-
|07,02
|User Switch
|Audio Config A/B (!)
|-
|01,07
|Manual Bass
|Key Split ON (!)
|-
|00,07
|Split
|Key Split ON
|}
<br>
 
===#2 Hammond SK===
 
Hammond SK does not use the weird drawbar encoding scheme of the XK, instead standard CCs whith same numbers as NI B4 CCs for upper/lower manual and bass pedal 16'/8'. For other controllers, knobs and buttons, the SK uses a similar NRPN scheme as found on XK. Some NRPNs differ, though (see table).
 
The Hammond SK set accepts program changes for upper manual and lower manual MIDI channel, range 0..15. Hammond Preset 11 will be converted to HX3 preset 0 (live).
 
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''Function'''
|'''Remarks'''
|-
|1,2,3
|6
|Value
|NRPN data entry
|
|-
|1,2,3
|7
|Slider
|Master Volume
|
|-
|1,2,3
|11
|Slider
|Swell Pedal
|
|-
|1,2,3
|12..20
|Slider
|Upper Drawbars
|similar to NI B4 scheme
|-
|1,2,3
|21..29
|Slider
|Lower Drawbars
|similar to NI B4 scheme
|-
|1,2,3
|33
|Slider
|Bass DB 16
|similar to NI B4 scheme
|-
|1,2,3
|34
|Slider
|Bass DB 8
|similar to NI B4 scheme
|-
|1,2,3
|98
|Value
|LSB of NRPN controller#
|
|-
|1,2,3
|99
|Value
|MSB of NRPN controller#
|
|}
 
 
Hammond SK NRPN Encoding is as follows (NRPN represented as hexadecimal values):<br>
 
{| border="1" cellpadding="8" cellspacing="0"
|'''NRPN #'''
|'''XK Function'''
|'''HX3 Function/Remarks'''
|-
|00,0A
|EQ Bass Gain
|Swell Trim (!)
|-
|02,0A
|EQ Treble Gain
|TONE pot (!)
|-
|02,09
|Vib Upper ON
|(same)
|-
|03,09
|Vib Lower ON
|(same)
|-
|04,0A
|Reverb ON
|Vib Lower ON (!)
|-
|03,09
|Vib Knob
|0=V1, 1=V2, 2=V3, 3=C1, 4=C2, 5=C3
|-
|07,09
|Leslie Stop
|(inverted Run!)
|-
|01,09
|Leslie Fast
|(same)
|-
|00,30
|Overdrive ON
|ignored (!)
|-
|02,30
|Overdrive
|Tube Amp Gain
|-
|00,08
|Perc ON
|(same)
|-
|01,08
|Perc THIRD
|(same)
|-
|02,08
|Perc FAST
|(same)
|-
|03,08
|Perc SOFT
|(same)
|-
|02,22
|Sustain ON
|Bass Sustain ON (!)
|-
|09,09
|Tube ON
|Reverb ON (!)
|-
|07,02
|User Switch
|Audio Config A/B (!)
|-
|00,07
|Manual Bass
|Key Split ON (!)
|}
<br>
 
===#3 Versatile MIDI CC Set===
 
'''(Only available on HX3.5)'''
 
Versatile set supports MIDI channels for upper manual, lower manual and bass pedal.
 
'''[https://updates.keyboardpartner.de/Files/Manuals%20%28Anleitungen%29/MIDI_Versatile_CCs_5528.pdf HX3.5 Versatile MIDI CC Set documentation, printable PDF file]'''<br>
 
<br>
 
===#4 Nord C1/C2 MIDI CC Set===
 
'''(Only available on HX3.5)'''
 
Nord C1/C2 set supports MIDI channels for upper manual, lower manual and bass pedal.
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''Function'''
|'''Remarks'''
|-
|1
|4
|Slider
|Swell Pedal
|
|-
|1
|111
|Slider
|Tube Amp Gain
|
|-
|1
|113
|Slider
|Hi Equ
|HX3 Tone Pot
|-
|1
|102
|Slider
|Reverb Amount
|
|-
|1
|96
|Switch
|Reverb Type
|0 = Off, 1 = Rev I, 2 = Rev II, 3 = Rev I+II
|-
|1
|97
|Switch
|Reverb On/Off
|
|-
|1
|16..24
|Slider
|Upper Drawbars
|
|-
|2
|16..24
|Slider
|Lower Drawbars
|
|-
|3
|16..17
|Slider
|Pedal Drawbars
|
|-
|3
|18
|Slider
|Pedal Pluck
|
|-
|3
|19
|Slider
|Pedal Release
|Sustain length
|-
|1
|87
|Switch
|Percussion ON
|
|-
|1
|27
|Switch
|Percussion FAST
|
|-
|1
|28
|Switch
|Percussion SOFT
|inverted!
|-
|1
|95
|Switch
|Percussion THIRD
|
|-
|1
|91
|Slider
|Amp 122 Volume
|"Tube Amp Drive" on KeyB
|-
|1
|85
|Switch
|Vibrato Upper ON
|
|-
|2
|85
|Switch
|Vibr Lower ON
|
|-
|1
|84
|Fixed
|Vibrato Knob
|18 = V1, 79 = C1, 36 = V2, 100 = C2, 58 = V3, 122 = C3 
|-
|}
 
<br>
 
===#5 Voce Drawbars===
 
Using your HX3 board with Voce MIDI Drawbars is straightforward, as the Voce module sends on one MIDI channel only (i.e. upper manual). Please note that Voce MIDI Drawbars does not send drawbar data unless you press the “Drawbar/Save” button, so that its LED lights up. You may change the Voce MIDI Drawbars send channel (back rotary HEX switch) at any time to lower (2) and bass channel (3), although this is somewhat inconvenient. In case of your technician has installed a toggle switch on the back side, channels can be changed easily.
 
Voce CC set accepts program changes for upper and lower manual on separate MIDI channels, range 0..15.
 
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''HX3 Function'''
|'''Remarks'''
|-
|1
|7
|Slider
|Master Volume
|
|-
|1
|11
|Slider
|Swell Pedal
|
|-
|1
|12..20
|Slider
|Upper Drawbars
|
|-
|1
|21..29
|Slider
|Lower Drawbars
|
|-
|1, 2
|68
|Switch
|Rotary Slow/Fast
|
|-
|1, 2
|70
|Switch
|Percussion SOFT
|
|-
|1, 2
|71
|Switch
|Percussion FAST
|
|-
|1, 2
|72
|Switch
|Percussion THIRD
|
|-
|1, 2
|73
|Switch
|Percussion ON
|
|-
|1, 2
|87, 89
|Slider
|Tone
|"Treble" on Voce
|-
|1, 2
|88
|Slider
|Swell Trim Cap
|"Bass" on Voce
|-
|1, 2
|90
|Slider
|Reverb
|"Hum" on Voce, 0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
|-
|1, 2
|91
|Slider
|Amp 122 Volume
|"Distortion" on Voce, same as CC #7
|-
|1, 2
|92
|Switch
|Rotary Stop/Run
|
|-
|1, 2
|93
|Fixed
|Vibrato Knob
|0..23 = V1, 24..42 = V2, 43..64 = V3, 65..90 = C1, 91..110 = C2, 111..127 = C3
|-
|1
|95
|Switch
|Vibr Upper ON
|
|-
|2
|12..20
|Slider
|Lower Drawbars
|Same as 21..29 on Channel 1
|-
|2
|95
|Switch
|Vibr Lower ON
|
|-
|3
|12
|Slider
|Bass DB 16
|
|-
|3
|13
|Slider
|Bass DB 5 1/3
|
|-
|3
|14
|Slider
|Bass DB 8
|
|-
|3
|15
|Slider
|Bass Pedal Sustain
|
|-
|}
 
<br>
 
===#6 KeyB Duo===
 
Italian KeyB/Diversi controller set supports three MIDI channels.
 
KeyB set accepts program changes for upper and lower manual on separate MIDI channels, range 0..15.
 
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''Function'''
|'''Remarks'''
|-
|1
|7
|Slider
|Master Volume
|
 
|-
|1
|9
|Fixed
|Reverb 0..3
|0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
 
|-
|1
|11
|Slider
|Swell Pedal
|
|-
|1
|12..20
|Slider
|Upper Drawbars
|
|-
|1
|21..29
|Slider
|Lower Drawbars
|
|-
|1
|68
|Fixed
|Rotary Slow/Fast
|0 = SLOW, 64 = STOP, 127 = FAST
 
|-
|1
|70
|Switch
|Percussion FAST
|
|-
|1
|71
|Switch
|Percussion SOFT
|
|-
|1
|72
|Switch
|Percussion THIRD
|
|-
|1
|73
|Switch
|Percussion ON
|
|-
|1
|79
|Switch
|Split ON
|"String Bass" on KeyB
|-
|1
|89
|Slider
|Percussion Level
|"Key Click" on KeyB
|-
|1
|90
|Fixed
|Leakage
|"Crosstalk" on KeyB, scaled to 0..3
|-
|1
|91
|Slider
|Amp 122 Volume
|"Tube Amp Drive" on KeyB
|-
|1
|95
|Switch
|Vibrato Upper ON
|
|-
|1
|93
|Fixed
|Vibrato Knob
|18 = V1, 79 = C1, 36 = V2, 100 = C2, 58 = V3, 122 = C3 
|-
|1
|103
|Slider
|Swell Trim Cap
|"Bass Equ" on KeyB
|-
|1
|104
|Slider
|Tone
|"Treble Equ" on KeyB
|-
|1
|105
|Slider
|Pedal Sustain
|
|-
|1
|106
|Switch
|Audio Config A/B
|"Volume Soft" on KeyB
|-
|2
|12..20
|Slider
|Lower Drawbars
|Same as 21..29 on Channel 1
|-
|2
|95
|Switch
|Vibr Lower ON
|
|-
|3
|12
|Slider
|Bass DB 16
|
|-
|3
|13
|Slider
|Bass DB 8
|
|-
|}
 
<br>
 
===#7 Hamichord/Mojo===
 
Italian Hamichord/Mojo controller set supports only base MIDI channel. Key ON/OFF data of channel 2 (lower) and 3 (pedals) will be accepted, though.
 
Hamichord/Mojo CC set will not accept Program Change messages since Hamichord/Mojo always sends a "snapshot" of all MIDI CCs when changing a preset.
 
 
{| border="1" cellpadding="8" cellspacing="0"
|'''Channel'''
|'''CC#'''
|'''Type'''
|'''Function'''
|'''Remarks'''
|-
|1
|1
|Fixed
|Rotary Slow/Fast
|Modulation Wheel, 0..30 = SLOW, 31..94 = STOP, 95..127 = FAST
|-
|1
|7
|Slider
|Amp 122 Volume
|
|-
|1
|11
|Slider
|Swell Pedal
|
|-
|1
|12..20
|Slider
|Upper Drawbars
|
|-
|1
|21..29
|Slider
|Lower Drawbars
|
|-
|1
|30
|Slider
|Pedal DDB 16
|
|-
|1
|31
|Slider
|Pedal DDB 8
|
|-
|1
|32
|Fixed
|Vibr Knob
|0..21 = V1, 22..43 = C1, 44..65 = V2, 66..87 = C2, 88..109 = V3, 110..127 = C3
|-
|1
|34
|Slider
|Swell Pedal
|same as #11
|-
|1
|35
|Slider
|Amp 122 Volume 
|same as #7, "Tube Amp Drive" on Hamichord/Mojo
|-
|1
|38
|Slider
|Bass Pedal Sustain
|"Keyclick" on Hamichord/Mojo
|-
|1
|39
|Fixed
|Reverb
|0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
|-
|1
|42
|Switch
|Percussion ON
|
|-
|1
|43
|Switch
|Percussion SOFT
|inverted!
|-
|1
|44
|Switch
|Percussion FAST
|inverted!
|-
|1
|45
|Switch
|Percussion THIRD
|
|-
|1
|46
|Switch
|Vibr Upper ON
|
|-
|1
|47
|Switch
|Vibr Lower ON
|
|-
|1
|48
|Switch
|Rotary RUN
|
|-
|1
|47
|Switch
|Rotary SLOW/FAST
|
|-
|1
|54
|Switch
|Audio Config A/B
|"L/R out select" on Mojo
|-
|1
|91
|Fixed
|TG Leakage
|"Crosstalk" on Mojo
|-
|1
|92
|Fixed
|TG Cap Set
|"Keyclick length" on Mojo
|-
|1
|95
|Slider
|Swell Trim Cap
|"Percussion Volume" on Mojo
|}
 
<br>
 
===#8 HX3/KBP MIDI CC Set===


'''Obsolete - for older boards reference only.''' See [https://github.com/keyboardpartner/HX3/blob/master/DOCS_PDF/HX3%20MIDI%20expander%20module.pdf?raw=true HX3 Expander user manual] and [[HX3 Remote/Update Application]] for newest information.
'''(Only available on HX3.5 and HX3.6)'''


HX3 may be remoted completely via MIDI. If '''no drawbars/pots/knobs/switches attached''' to HX3 board, make shure you have disabled all analog controller inputs with MenuPanel "ExpanderMode ON" entry, by ''HX3 Remote'' application or serial commands:
HX3/KBP set supports MIDI channels for upper manual, lower manual and bass pedal. This MIDI CC set has been designed for use with the TouchOSC app.


wen=1
'''Please note''': In addition to MIDI base channel, base channel+1, and base channel+2, the HX3/KBP set uses base channel+3 for specific TouchOSC commands. Avoid assigning base channel+3 to other instruments.  
521=255
(477=255 on FW #3.5 and up)


HX3 firmware supports Native Instrument B4 (0), Voce MIDI Drawbars (1), Hamichord (2), Hammond XK (3), Hammond SK (4) and italian KeyB (5) MIDI CC sets. Default is NI B4 (supported by Doepfer d3c drawbar controller and Böhm/Keyswerk d4b controller). MIDI CC set may be changed by menu on XB-2 retrofit kit, by MenuPanel "MIDI CC" entry or serial commands:
'''[http://updates.keyboardpartner.de/Files/Manuals%20%28Anleitungen%29/MIDI_Touchpad_CCs_560x.pdf HX3.5/KBP MIDI CC Set documentation, printable PDF file]'''<br>


wen=1
'''[http://updates.keyboardpartner.de/Files/Manuals%20%28Anleitungen%29/MIDI_KBP_CCset.pdf HX3.6/KBP MIDI CC Set documentation, printable PDF file]'''<br>
531=X
(435=X on FW #3.5 and up)


with X = the number shown in MIDI CC list above. The MIDI CC sets will only support those controller functions that HX3's sound engine offers; in some cases, controllers are remapped/renamed for convenience. For example, "key click" on Doepfer d3c is remapped to pedal sustain on HX3.
<br>


HX3 accepts and sends key on/off events on three consecutive MIDI channels 1 (upper), 2 (lower) and 3 (pedals). HX3 does not send own controller messages, only key on/off events. Default base channel 1 may be changed by MenuPanel "MIDI Channel" entry or serial commands:
===#9, #10 MIDI Custom CC===


wen=1
HX3.4 FW #3.6x and up provides a "custom MIDI CC" set, which may be altered to your needs by using ''HX3 Remote'' application (HX3.4 only). By factory default, it is set to accept Nord C2 MIDI data (also compatible with Ocean Beach DB-1 controller). See wiki page '''[[HX3_Remote_Application#Editing_MIDI_Custom_CCs]]''' on how to create a custom CC set and store it to HX3. Please note that currently the custom MIDI CC set only accepts controller commands on upper manual MIDI channel (1 on factory default).
511=X
(433=X on FW #3.5 and up)


with X = desired MIDI channel minus one: 511=5 yields upper on 6, lower on 7 and pedals on 8.
<br>


For serial command description, see [[HX3 Board Installation#Connecting Serial USB cable]], [https://github.com/heise/HOAX/blob/master/DOCS_PDF/HOAX3_Syntax.pdf?raw=true HX3 serial syntax table] and [[Inbetriebnahme der Bausatz-Platine]] (sorry, german only) for details.
From HX3 Fimware 5.61 on, in principle all CC Sets can be changed. With this firmware HX3 also sends the set CCs. For editing, use the built-in CC Set Editor in the ''HX3 Manager''.
HX3 provides two custom MIDI CC sets at positions 9 and 10, which are pre-assigned with Nord C2D and Viscount Legend from firmware version 5.833 and 6.032 respectively. These can be overwritten with your own CC sets.
<br>


MIDI implementation tables can be found in [https://github.com/heise/HOAX our Github Repository], see folder DOCS_PDF.
==Additional Info==


'''Important note:''' Firmware #3.6x and FPGA #20072014 or newer provide a '''secondary MIDI input''' (merged with other) and also sends MIDI CCs from all local controllers (drawbars/buttons/switches). FW #3.6x also has a "custom MIDI CC" set which may be altered to your needs by using ''HX3 Remote'' application. By factory default, it is set to accept Nord C2 MIDI data (also compatible with Ocean Beach DB-1 controller).
HX3 mk4 only: Firmware #3.6x and FPGA #20072014 or newer provide a '''secondary MIDI input''' (merged with other) and also send MIDI CCs according to NI B4 from all local controllers (drawbars/buttons/switches).

Aktuelle Version vom 3. November 2023, 16:15 Uhr

MIDI Control

HX3 accepts MIDI key on/off events (default: channel 1 to upper manual, 2 to lower manual, channel 3 to bass pedals) as well as various MIDI CCs with selectable compatibility sets. MIDI dynamics slightly affect key click noise. SysEx data other than its own are always ignored. Both MIDI jacks act as MIDI inputs with equal priority (default). The second MIDI jack may be jumpered as MIDI Out. (Details for HX3 mk4 see [HX3 mk4_Changes], for HX35 see [MIDI Configuration]).

You may connect two MIDI keyboards or controllers at the same time. Connecting a third MIDI device requires a MIDI Merge Interface. All HX3 functions that are relevant for the organ player may be remote-controlled by MIDI commands.

General

Connect MIDI Out of your MIDI controller/keyboard to one of the two HX3 MIDI inputs. Since MIDI is a one-way interface, HX3 cannot determine the setting of any MIDI controller value until you touch/use it once. By default all HX3 controllers are OFF. Do not use any controller button or drawbar unless HX3 is ready to accept data (drawbar/preset menu displayed). It is a good idea to power up HX3 before your MIDI master keyboard or master controller.

MIDI CC #7 (default, CC number variable) controls master volume. MIDI CC #11 (default, CC number variable) controls swell pedal/expression if no expression pedal connected to HX3. If you use your HX3-attached swell pedal, any MIDI expression message will be overwritten. If the attached swell pedal is not actuated, MIDI expression messages are accepted.

HX3.4

Some MIDI controllers as well as organ keyboards (like Hammond XK and SK series) allow 2nd and 3rd harmonic percussion ON at the same time. In this case HX3 implementation regards "2nd ON" as "Percussion ON" tab.

Refer to section 3.2.4 Group Commons in the user manual to select the desired MIDI CC set. Factory default is Native Instruments B4.

MenuDisplay and HX3 Remote (HX3.4) or HX35 Editor (HX3.5 only) allow setup of MIDI Channel as well as MIDI CC set. Step down to MIDI menu section to alter settings. On the Menu Panel, press encoder knob for 2 seconds to save to power-up defaults.

  • MIDI Channel - sets MIDI base send/receive channel 1 to 10 (upper manual, lower manual is on +1, pedals on +2).
  • MIDI Option - sets MIDI routing behaviour to
    • 'ReceiveThru' (MIDI OUT is THRU),
    • 'ReceiveSend' (MIDI received, only own MIDI key events to MIDI OUT),
    • 'RcvSendMerge'(MIDI received, own MIDI key events and incoming MIDI events merged to MIDI OUT) and
    • 'RcvSndMgNoCC' (as before, but MIDI CC commands discarded). On expander module, only valid setting is 'ReceiveThru'.
  • MIDI CC Set - sets recognized MIDI CC set to
    • 'NI B4' Native Instruments B4 (default),
    • 'Voce' MIDI drawbars,
    • 'Hamichord' (or 'Mojo', same hardware),
    • 'Hammond XK',
    • 'Hammond SK' (Note: Hammond changed MIDI CC set between XK and SK series, please try out which one fits),
    • 'KeyB Duo',
    • 'Custom'

HX3.4 Generated MIDI Events

HX3.4 (mk2/3/4 board) transmits local keyboard ON/OFF events on MIDI base channel (upper), MIDI base channel +1 (lower) and MIDI base channel +2 (pedal). It sends MIDI CCs of user controls (drawbars, tabs) according to NI B4 implementation (independently of selected CC set). From firmware 3.82 and up, HX3 will not send own MIDI CCs on MIDI OUT when MIDI Option = 3 (RcvSndMgNoCC). MIDI Option = 3 is now default on all firmwares except HX3 Expander (which has to accept MIDI CCs). This change has been made since MIDI CCs sended by HX3 may disturb MIDI workstations/arrangers. Note: If send/receive of MIDI CCs is enabled (Option = 1 or 2), HX3 will transmit its own CCs.

HX3 will transmit swell pedal on CC #11 (0x0B) as well as rotary run/stop on CC #68 (0x44) and fast/stop on CC #01.

Program Change on HX3.4

HX3 mk4 will accept MIDI Program Change Commands in some MIDI CC sets. In NI B4 mode, MIDI program changes 12..23 on upper manual channel will set lower manual voice according to common NI B4 hardware controllers. In Hammond CC modes, program 11 is the "live" preset (inverse "B" key) and will recall voice 0.

HX3.5

HX3.5 supports MIDI over USB through its USB port connected to a USB host, typically a PC. The USB connection is also suitable for controlling HX3.5 by the HX35 Editor application, firmware updates via MIDI SysEx, and DSP updates via DFU data transfer. Important: MIDI IN2 and MIDI IN over USB must not be used simultaneously.

(HX3.5 and later) The new CC Set Editor allows a very extensive adaptation to the controlling device; the CC Sets known from HX3.4 have been taken over and partly supplemented. They can be changed at will (exception: NI B4 and Hamichord due to some special features in vibrato, percussion and presets). Important: The extended scan driver available in HX3.5 accepts the MIDI CCs for the sustain and sostenuto pedal. However, some devices use CCs #64 and #66 for other functions (NI B4, Hamichord). When CCs #64 or #66 are used in a CC Set, the Sustain and Sostenuto functions in scan drivers (MIDI receive as well as directly connected keyboards) are disabled, so that the assigned controller does not result in "hanging" notes. The new CC-Set "HX3.5/KBP native" (firmware #5.6xx or higher) is the most comprehensive CC-Set available, it allows remote control of all relevant HX3.5 parameters.

The menu panel and HX35 Editor allow you to set the MIDI channel and select the MIDI CC set. In the menu, press and hold the knob for two seconds to save the setting as the start default value.

  • MIDI Channel - sets MIDI base send/receive channel 1 to 10 (upper manual, lower manual is on +1, pedals on +2).
  • MIDI Option - sets MIDI routing behaviour to
    • 'Local Tx' (MIDI OUT sends own keyboard data),
    • 'Inp 1 Thru' (MIDI IN1 routed to MIDI OUT and MIDI OUT over USB),
    • 'Inp 2 Thru' (MIDI IN2 routed to MIDI OUT) and
    • 'USB InThru' (MIDI IN over USB routed to MIDI OUT).
  • MIDI CC Set - sets recognized MIDI CC set to
    • 'NI B4' Native Instruments B4 (default),
    • 'Hammond XK',
    • 'Hammond SK' (Note: Hammond changed MIDI CC set between XK and SK series, please try out which one fits),
    • 'Versatile' Boehm, Sempra,
    • 'Nord C1/C2'
    • 'Voce' MIDI drawbars,
    • 'KeyB Duo',
    • 'Hamichord' (or 'Mojo', same hardware),
    • 'HX3.5/KBP' for TouchOSC, but can also be used for freely configurable master keyboards,
    • 'Custom A' (to be set and renamed by HX3 MIDI CC Set Editor) ex factory occupied by Nord C2D CC set,
    • 'Custom B' (to be set and renamed by HX3 MIDI CC Set Editor)

Further CC sets are available and can easily transfered to the HX3.5. Supported instruments include Hammond XB2, Hammond XB3, Nord electro 4, Viscount Legend and more.

HX3.5 Generated MIDI Events

HX3.5 is transmitting local keyboard ON/OFF events on MIDI base channel (upper), MIDI base channel +1 (lower) and MIDI base channel +2 (pedal). It sends MIDI CCs of user controls (drawbars, tabs) according to selected CC set. MIDI IN1, IN2 and MIDI over USB are always accepted.

For OEM only: Independent from MIDI option selected, HX3 will always send a 3.3V TTL level MIDI signal on PL16 pin 8 for controlling Ventilator/Minivent DSP board with synced stop/slow/fast. Pin 34 of Vent DSP board is MIDI TTL input. Also wire digital ground (PL16 pin 10). Ventilator DSP accepts MIDI CC #21 values 0 (stop), 1 (slow), 2 (fast) on channel 1.

With TouchOSC it is possible to create a preset by remote control; otherwise the memory function of the menu panel must be used.

Program Change on HX3.5

In general, HX3.5 (firmware 5.3 and up) will handle MIDI Program Change Commands (valid numbers range from 0 to 15). Numbers will be handled as "Set Drawbar Voice" for upper, lower and pedal MIDI channel separately, i.e. it resembles the "inverse" preset keys found on Hammond console organs. Drawbar Voice changes will not affect Tab settings (Percussion, Vibrato etc) in any way. Use the Common Presets for this.

However, not all HX3.5 MIDI CC sets are handling MIDI program changes in the same way: In NI B4 mode, MIDI program changes 12..23 on upper manual channel will set lower manual voice complying with common NI B4 hardware controllers. In Hammond CC modes, program 11 is the "live" preset (inverse "B" key) and will recall voice 0. In Nord C1/C2 CC mode, program 126/127 are "live" presets (inverse "A#" and "B" key) and will recall voice 0.

Bank Select on HX3.5

HX3.5 will handle MIDI Bank Select Commands as "Set Overall Preset" (valid numbers range from 0 to 15 or 0 to 99 from FW #5.516 on) per default. Overall Presets include all Tab settings and additional pots (volume, reverb amount etc) as well as the drawbar settings. Note that some MIDI keyboards will send a MIDI Bank Select command separately, others will issue a MIDI Bank Select only with a MIDI Program Change. In the latter case, the issued MIDI Program Change command will override the voice setting.

Early HX3.5 boards switched Common Presets with a bank select command (20 hex or 32 dec.). This caused incompatibilities with unusual MIDI implementations of the controlling keyboard (e.g. Mojo). Starting with firmware #5.526, the CC command for switching the Common Presets can be set using the menu. Please note: Common Presets cannot be switched using MIDI Program Changes, which are reserved for the above Drawbar settings.

Up to HX3.5 FW #5.4xx:: Common Presets 0..15 are selected in all CC Sets by Bank Select messages (MSB, CC #00), with all three channels valid.

HX3.5 FW #5.500 to #5.515: These firmwares contained a bug that prevented Common Preset switching.

Starting with HX3.5 FW #5.516: Common Presets 0..99 are selected in all CC Sets by bank select commands (LSB, CC #32 decimal), where all three channels are valid.

Starting with HX3.5 FW #5.526: Common Presets 0..99 are selected in all CC Sets by a CC command (default: #32 dec. = Bank Select LSB) that can be set in the menu, where all three channels are valid.

MIDI CC Sets

HX3 provides several pre-configured MIDI CC sets plus one fully customizable set (two custom CC sets on HX3.5), selectable by MenuPanel, by HX3 Remote or HX35 Editor application, respectively. Factory default is the Native Instruments B4 set, supported by many MIDI controllers. If MIDI CC output is enabled, HX3.4 will send CCs always according to NI B4 set. HX3 does not support weird SysEx encodings found on some Roland, Oberheim and Viscount models. All values based decimal!

A very comprehensive Versatile Böhm/Keyswerk Sempra MIDI CC set is available on HX3.5 mainboards.

Starting with firmware version 5.61x, the HX3.5 "MIDI CC Editor" window can be used to fetch, modify and write back CC sets from the HX3.5. Due to some special features, some functions are fixed for CC Set "#0 NI B4" and "#7 Hamichord" (e.g. the vibrato setting for the NI B4, where a NI B4 controller sends two values). With these sets, some CC settings previously handled in the firmware cannot be changed, all others can.

#0 NI B4 d3c

The Doepfer d3c drawbar controller is a very nice and rugged piece of gear, so we recommend it for use with our HX3 board. It does support foot controllers and foot switches. The Keyswerk/Böhm db4 is also compatible with NI B4 CC set.

Upper, lower and bass drawbars work as usual. It is a good idea to set all to zero before switching on as this is a “known state” for HX3. Also the Percussion and Vibrato buttons work as described in d3c manual. There is a small drawback, anyway: Default HX3 Vibrato setting is V1 (but upper/lower vibrato OFF), while the V1 LED will not light up when powering up the d3c (there is no “V0” on a real Hammond!). So pressing the V1 button will not change the sound – just turn its LED on.

The BRIGHTNESS knob controls AO28 tone parameter of the HX3. There is no key click simulated by HX3 (it is just there), so there is no key click adjustment button. The KEY CLICK knob controls the bass sustain instead.

Do not use the HARMONIC CONTENT knob as it sends the PERCUSSION button’s controller number like a continuous controller. What for? No idea. This is definitely of no use.

Preset buttons may be used, but in a restricted way. First, HX3 has 15 presets per manual, not 127 like NI B4. When selecting BANK 1, all 12 available preset buttons work on upper manual. When selecting BANK 2, all 12 preset buttons work on lower manual. Doepfer d3c resends the program change message when changing the bank, which may be annoying. Therefore, proceeds as follows: Choose bank 2, lower preset first, then bank 1, upper preset. BTW: Bank buttons do not send bank select messages, they just add an offset to the preset buttons. Blame Doepfer for that.

Doepfer d3c preset 1 is the HX3 “Live” (preset 0) position. It will be saved temporarily (until HX3 is switched off) when a preset sound (2 to 12) is selected. If you return to preset 1 “Live”, your last drawbar/button setting will be recalled. Please note: HX3 tracks drawbar and button changes even when in preset position 2 to 12, so it keeps itself updated all the time.

NI B4 set accepts program changes for upper manual MIDI channel, range 0..11 = upper presets and 12..23 = lower presets.


Channel CC# Type Function Remarks
1 1 Switch Rotary Slow/Fast Modulation Wheel
1 7 Slider Master Volume was "122 Amp volume" on older firmwares
1 11 Slider Swell Pedal
1 12..20 Slider Upper Drawbars
1 21..29 Slider Lower Drawbars
1 30 Switch Vibr Lower ON
1 31 Switch Vibr Upper ON
1 33 Slider Bass DB 16
1 34 Slider Bass DB 8
1 66 Switch Percussion ON
1 68 Switch Rotary RUN "Rotary On/Off" on B4
1 70 Switch Percussion SOFT inverted!
1 71 Switch Percussion FAST inverted!
1 72 Switch Percussion THIRD
1 73 Fixed Vibr Mix Chorus if < 96
1 74 Fixed Vibr Amount 0..55 = V1, 56..87 = V2, 88..127 = V3
1 75 Slider Bass Pedal Sustain "Key Click" on B4
1 76 Slider Tube Amp Gain "Tube Amp Drive" on B4
1 78 Slider Swell Trim Cap "Tube Amp Body" on B4
1 79 Slider Tone "Tube Amp Brightness" on B4
1 84 Fixed Reverb 0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
2 12..20 Slider Lower Drawbars Same as 21..29 on Channel 1
2 30, 31 Switch Vibr Lower ON Same as 30 on Channel 1


#0 NI B4D

From HX3.5 Firmware #5.621

The Drawbar-Controller B4D (only one drawbar set, made by Böhm for Native Instruments) sends mostly the same CCs as the Doepfer d3c, but the most important difference is the assignment of the drawbars: All Drawbars are sent on CC 12..20, but with different channel identifiers. It also sends tab CCs (percussion, vibrato knob) with very own values. We have adapted the NI B4 set especially for this controller, it can be used alternatively to the NI B4 set for Doepfer d3c (factory setting). For the D4B, upload the set boehm_b4d.csv using the HX3.5 Editor window "MIDI CC Editor":

  • Use "Open CSV Table..." to load the file boehm_b4d.csv in the user directory
  • With "Actions -> Upload this CC set to HX3.5 as... ->#0 (NI B4, send only)" to HX3.5

To return to the Doepfer d3c set, upload the nib4_send.csv set using the HX3.5 "MIDI CC Editor" window:

  • Load file with "Open CSV Table...
  • With "Actions -> Upload this CC set to HX3.5 as... ->#0 (NI B4, send only)" to HX3.5

The D4B sends all set MIDI values when powered on, so you should first power up HX3.5 and then the D4B. For the pedal, the Drawbar sequence 16, 16H, 8, 8H, Release (Sustain) applies to the first 5 Drawbars on the D4B. The "Bank" button is a little ambiguous: it does not send a bank select message, but only moves the MIDI program changes ("preset" numbers) up.


#1 Hammond XK

HX3 supports most of Hammond XK MIDI controller functions. For convenience, some controllers have been relocated to other HX3 functions:

  • XK Overdrive knob controls HX3 Rotary Tube Amp Volume
  • XK Reverb button controls HX3 lower manual Vibrato On
  • XK Tube On button controls HX3 Reverb

Hammond uses NRPN controllers instead of standard controllers. Drawbars are encoded through a weird grid scheme using only 3 CC#s, see XK manual for details.

Hammond XK set accepts program changes for upper manual and lower manual MIDI channel, range 0..15. Hammond Preset 11 will be converted to HX3 preset 0 (live).


Channel CC# Type Function Remarks
1,2,3 6 Value NRPN data entry
1,2,3 7 Slider Master Volume
1,2,3 11 Slider Swell Pedal
1,2,3 80 Fixed Upper drawbars According to Hammond encoding, see XK user manual
1,2,3 81 Fixed Lower drawbars According to Hammond encoding, see XK user manual
1,2,3 82 Fixed Pedal drawbars According to Hammond encoding, see XK user manual
1,2,3 95 Don't Care Save Upper If received, saves upper drawbars and setup to current preset#
1,2,3 96 Don't Care Save Lower If received, saves lower drawbars and setup to current preset#
1,2,3 98 Value LSB of NRPN controller#
1,2,3 99 Value MSB of NRPN controller#


Hammond XK NRPN Encoding is as follows (NRPN represented as hexadecimal values):

NRPN # XK Function HX3 Function/Remarks
00,0A EQ Bass Gain Swell Trim (!)
02,0A EQ Treble Gain TONE pot (!)
02,09 Vib Upper ON (same)
17,09 Vib Lower ON (same)
04,0A Reverb ON Vib Lower ON (!)
03,09 Vib Knob 0=V1, 1=V2, 2=V3, 3=C1, 4=C2, 5=C3
00,09 Leslie Run (same)
01,09 Leslie Fast (same)
05,09 Overdrive Tube Amp Gain
00,08 Perc ON (same)
01,08 Perc THIRD (same)
02,08 Perc FAST (same)
03,08 Perc SOFT (same)
09,09 Tube ON Reverb ON (!)
07,02 User Switch Audio Config A/B (!)
01,07 Manual Bass Key Split ON (!)
00,07 Split Key Split ON


#2 Hammond SK

Hammond SK does not use the weird drawbar encoding scheme of the XK, instead standard CCs whith same numbers as NI B4 CCs for upper/lower manual and bass pedal 16'/8'. For other controllers, knobs and buttons, the SK uses a similar NRPN scheme as found on XK. Some NRPNs differ, though (see table).

The Hammond SK set accepts program changes for upper manual and lower manual MIDI channel, range 0..15. Hammond Preset 11 will be converted to HX3 preset 0 (live).


Channel CC# Type Function Remarks
1,2,3 6 Value NRPN data entry
1,2,3 7 Slider Master Volume
1,2,3 11 Slider Swell Pedal
1,2,3 12..20 Slider Upper Drawbars similar to NI B4 scheme
1,2,3 21..29 Slider Lower Drawbars similar to NI B4 scheme
1,2,3 33 Slider Bass DB 16 similar to NI B4 scheme
1,2,3 34 Slider Bass DB 8 similar to NI B4 scheme
1,2,3 98 Value LSB of NRPN controller#
1,2,3 99 Value MSB of NRPN controller#


Hammond SK NRPN Encoding is as follows (NRPN represented as hexadecimal values):

NRPN # XK Function HX3 Function/Remarks
00,0A EQ Bass Gain Swell Trim (!)
02,0A EQ Treble Gain TONE pot (!)
02,09 Vib Upper ON (same)
03,09 Vib Lower ON (same)
04,0A Reverb ON Vib Lower ON (!)
03,09 Vib Knob 0=V1, 1=V2, 2=V3, 3=C1, 4=C2, 5=C3
07,09 Leslie Stop (inverted Run!)
01,09 Leslie Fast (same)
00,30 Overdrive ON ignored (!)
02,30 Overdrive Tube Amp Gain
00,08 Perc ON (same)
01,08 Perc THIRD (same)
02,08 Perc FAST (same)
03,08 Perc SOFT (same)
02,22 Sustain ON Bass Sustain ON (!)
09,09 Tube ON Reverb ON (!)
07,02 User Switch Audio Config A/B (!)
00,07 Manual Bass Key Split ON (!)


#3 Versatile MIDI CC Set

(Only available on HX3.5)

Versatile set supports MIDI channels for upper manual, lower manual and bass pedal.

HX3.5 Versatile MIDI CC Set documentation, printable PDF file


#4 Nord C1/C2 MIDI CC Set

(Only available on HX3.5)

Nord C1/C2 set supports MIDI channels for upper manual, lower manual and bass pedal.

Channel CC# Type Function Remarks
1 4 Slider Swell Pedal
1 111 Slider Tube Amp Gain
1 113 Slider Hi Equ HX3 Tone Pot
1 102 Slider Reverb Amount
1 96 Switch Reverb Type 0 = Off, 1 = Rev I, 2 = Rev II, 3 = Rev I+II
1 97 Switch Reverb On/Off
1 16..24 Slider Upper Drawbars
2 16..24 Slider Lower Drawbars
3 16..17 Slider Pedal Drawbars
3 18 Slider Pedal Pluck
3 19 Slider Pedal Release Sustain length
1 87 Switch Percussion ON
1 27 Switch Percussion FAST
1 28 Switch Percussion SOFT inverted!
1 95 Switch Percussion THIRD
1 91 Slider Amp 122 Volume "Tube Amp Drive" on KeyB
1 85 Switch Vibrato Upper ON
2 85 Switch Vibr Lower ON
1 84 Fixed Vibrato Knob 18 = V1, 79 = C1, 36 = V2, 100 = C2, 58 = V3, 122 = C3


#5 Voce Drawbars

Using your HX3 board with Voce MIDI Drawbars is straightforward, as the Voce module sends on one MIDI channel only (i.e. upper manual). Please note that Voce MIDI Drawbars does not send drawbar data unless you press the “Drawbar/Save” button, so that its LED lights up. You may change the Voce MIDI Drawbars send channel (back rotary HEX switch) at any time to lower (2) and bass channel (3), although this is somewhat inconvenient. In case of your technician has installed a toggle switch on the back side, channels can be changed easily.

Voce CC set accepts program changes for upper and lower manual on separate MIDI channels, range 0..15.


Channel CC# Type HX3 Function Remarks
1 7 Slider Master Volume
1 11 Slider Swell Pedal
1 12..20 Slider Upper Drawbars
1 21..29 Slider Lower Drawbars
1, 2 68 Switch Rotary Slow/Fast
1, 2 70 Switch Percussion SOFT
1, 2 71 Switch Percussion FAST
1, 2 72 Switch Percussion THIRD
1, 2 73 Switch Percussion ON
1, 2 87, 89 Slider Tone "Treble" on Voce
1, 2 88 Slider Swell Trim Cap "Bass" on Voce
1, 2 90 Slider Reverb "Hum" on Voce, 0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
1, 2 91 Slider Amp 122 Volume "Distortion" on Voce, same as CC #7
1, 2 92 Switch Rotary Stop/Run
1, 2 93 Fixed Vibrato Knob 0..23 = V1, 24..42 = V2, 43..64 = V3, 65..90 = C1, 91..110 = C2, 111..127 = C3
1 95 Switch Vibr Upper ON
2 12..20 Slider Lower Drawbars Same as 21..29 on Channel 1
2 95 Switch Vibr Lower ON
3 12 Slider Bass DB 16
3 13 Slider Bass DB 5 1/3
3 14 Slider Bass DB 8
3 15 Slider Bass Pedal Sustain


#6 KeyB Duo

Italian KeyB/Diversi controller set supports three MIDI channels.

KeyB set accepts program changes for upper and lower manual on separate MIDI channels, range 0..15.


Channel CC# Type Function Remarks
1 7 Slider Master Volume
1 9 Fixed Reverb 0..3 0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
1 11 Slider Swell Pedal
1 12..20 Slider Upper Drawbars
1 21..29 Slider Lower Drawbars
1 68 Fixed Rotary Slow/Fast 0 = SLOW, 64 = STOP, 127 = FAST
1 70 Switch Percussion FAST
1 71 Switch Percussion SOFT
1 72 Switch Percussion THIRD
1 73 Switch Percussion ON
1 79 Switch Split ON "String Bass" on KeyB
1 89 Slider Percussion Level "Key Click" on KeyB
1 90 Fixed Leakage "Crosstalk" on KeyB, scaled to 0..3
1 91 Slider Amp 122 Volume "Tube Amp Drive" on KeyB
1 95 Switch Vibrato Upper ON
1 93 Fixed Vibrato Knob 18 = V1, 79 = C1, 36 = V2, 100 = C2, 58 = V3, 122 = C3
1 103 Slider Swell Trim Cap "Bass Equ" on KeyB
1 104 Slider Tone "Treble Equ" on KeyB
1 105 Slider Pedal Sustain
1 106 Switch Audio Config A/B "Volume Soft" on KeyB
2 12..20 Slider Lower Drawbars Same as 21..29 on Channel 1
2 95 Switch Vibr Lower ON
3 12 Slider Bass DB 16
3 13 Slider Bass DB 8


#7 Hamichord/Mojo

Italian Hamichord/Mojo controller set supports only base MIDI channel. Key ON/OFF data of channel 2 (lower) and 3 (pedals) will be accepted, though.

Hamichord/Mojo CC set will not accept Program Change messages since Hamichord/Mojo always sends a "snapshot" of all MIDI CCs when changing a preset.


Channel CC# Type Function Remarks
1 1 Fixed Rotary Slow/Fast Modulation Wheel, 0..30 = SLOW, 31..94 = STOP, 95..127 = FAST
1 7 Slider Amp 122 Volume
1 11 Slider Swell Pedal
1 12..20 Slider Upper Drawbars
1 21..29 Slider Lower Drawbars
1 30 Slider Pedal DDB 16
1 31 Slider Pedal DDB 8
1 32 Fixed Vibr Knob 0..21 = V1, 22..43 = C1, 44..65 = V2, 66..87 = C2, 88..109 = V3, 110..127 = C3
1 34 Slider Swell Pedal same as #11
1 35 Slider Amp 122 Volume same as #7, "Tube Amp Drive" on Hamichord/Mojo
1 38 Slider Bass Pedal Sustain "Keyclick" on Hamichord/Mojo
1 39 Fixed Reverb 0..23 = OFF, 24..47 = Rev 1, 48..63 = Rev 2, 64..127 = Rev 3
1 42 Switch Percussion ON
1 43 Switch Percussion SOFT inverted!
1 44 Switch Percussion FAST inverted!
1 45 Switch Percussion THIRD
1 46 Switch Vibr Upper ON
1 47 Switch Vibr Lower ON
1 48 Switch Rotary RUN
1 47 Switch Rotary SLOW/FAST
1 54 Switch Audio Config A/B "L/R out select" on Mojo
1 91 Fixed TG Leakage "Crosstalk" on Mojo
1 92 Fixed TG Cap Set "Keyclick length" on Mojo
1 95 Slider Swell Trim Cap "Percussion Volume" on Mojo


#8 HX3/KBP MIDI CC Set

(Only available on HX3.5 and HX3.6)

HX3/KBP set supports MIDI channels for upper manual, lower manual and bass pedal. This MIDI CC set has been designed for use with the TouchOSC app.

Please note: In addition to MIDI base channel, base channel+1, and base channel+2, the HX3/KBP set uses base channel+3 for specific TouchOSC commands. Avoid assigning base channel+3 to other instruments.

HX3.5/KBP MIDI CC Set documentation, printable PDF file

HX3.6/KBP MIDI CC Set documentation, printable PDF file


#9, #10 MIDI Custom CC

HX3.4 FW #3.6x and up provides a "custom MIDI CC" set, which may be altered to your needs by using HX3 Remote application (HX3.4 only). By factory default, it is set to accept Nord C2 MIDI data (also compatible with Ocean Beach DB-1 controller). See wiki page HX3_Remote_Application#Editing_MIDI_Custom_CCs on how to create a custom CC set and store it to HX3. Please note that currently the custom MIDI CC set only accepts controller commands on upper manual MIDI channel (1 on factory default).


From HX3 Fimware 5.61 on, in principle all CC Sets can be changed. With this firmware HX3 also sends the set CCs. For editing, use the built-in CC Set Editor in the HX3 Manager.

HX3 provides two custom MIDI CC sets at positions 9 and 10, which are pre-assigned with Nord C2D and Viscount Legend from firmware version 5.833 and 6.032 respectively. These can be overwritten with your own CC sets.

Additional Info

HX3 mk4 only: Firmware #3.6x and FPGA #20072014 or newer provide a secondary MIDI input (merged with other) and also send MIDI CCs according to NI B4 from all local controllers (drawbars/buttons/switches).