MIDI Notes and MIDI Control Change Messages (CC) are part of the MIDI standard that can be used to control console features such as front panel keys, faders, screen soft keys, and comment macros.
To enable MIDI note and controller message input for the console:
Connect the output end of a third party MIDI device to the "MIDI In" port on the back of the console. If you are using an external USB MIDI device such as a USB keyboard or an external USB MIDI Widget to receive MIDI then connect the external USB MIDI device to one of the USB ports on your console. Please note that only generic "USB MIDI Class" devices are supported. Any USB MIDI devices that require proprietary drivers may work with Hog 4 PC as long as the specific driver is installed on the Windows machine but these types of USB devices that require specific drivers will not work with Hog 4 OS consoles.
Open the Network window. [Setup → Network]
Select a console from the list of devices in the network window and then press the Settings button.
Select the MIDI Configuration tab of the Console Settings Window.
Map a MIDI device to one of the listed indexes by pressing the blue plus button located to the far right of the index, then select a MIDI device from the device drop down menu and press . (On Hog 4, Hog 4-18, and Full Boar 4 consoles the built-in MIDI device will be listed as "LTCMIDI".)
Press the
config button located to the right of the device mapping to open the
MIDI Options window.In the MIDI Options window enable the Notes In option. This enables both MIDI Note and Controller Change message input.
Use the drop down menu to assign a MIDI Map to the index. If no MIDI Maps are available then use the MIDI Map Editor described in MIDI Map Editor to create a MIDI Map. Click OK.
![[Tip]](../images/tip.png) | Tip |
|---|---|
MIDI device index mappings are stored on the console while MIDI Options are stored in the show file. |
The MIDI Map Editor Window allows operators to create custom mappings of MIDI Note and Controller input messages to Hog 4 OS functions such as keystrokes, faders, encoders, and comment macros.
To open the MIDI Map Editor Window press the key on the front panel, then press the button on the setup toolbar, and press the button from the menu.
Each entry in the MIDI Map table represents a MIDI input signal and a resulting Hog activity. For example MIDI Note 1 on channel 1 could be assigned to trigger a GM1 comment macro. Please refer to the sections below for details on how to create, rename, edit, and delete MIDI maps as well as information regarding how the different modes utilized for MIDI Controller messages.
To create a new MIDI Map:
Open the MIDI Map Editor Window (press the key on the front panel, then press the button on the setup toolbar, and then press the button from the menu.)
Use the current map drop down menu to select the option.
To rename a MIDI Map:
Open the MIDI Map Editor Window (press the key on the front panel, then press the button on the setup toolbar, and then press the button from the menu.)
Use the current map drop down menu to select the MIDI map you wish to rename.
Press the button located to the right of the current map drop down menu.
Type in the desired name of the MIDI Map and press to confirm.
To delete a MIDI Map:
Open the MIDI Map Editor Window (press the key on the front panel, then press the button on the setup toolbar, and then press the button from the menu.)
Use the current map drop down menu to select the MIDI map you wish to delete
Press the button located to the right of the current map drop down menu
Press to confirm.
Learn Mode provides a quick and easy method for buidling a MIDI Map by simply wiggling physical controls on a MIDI Device and then pressing/moving a Hog 4 feature such as a front panel key, encoder, or fader.
To activate Learn Mode in the MIDI Map Editor simply enable the Learn button at the top of the window.
When Learn Mode is activated all front panel events are captured into the Hog Function field for the currently selected row. Please note that fader movements still affect output when Learn Mode is activated. To help you to identify that this is occuring the command line background will turn grey and flash “!!! MIDI Map Learn mode Enabled !!!” in red text while Learn mode is turned on.
In practice here is how Learn mode works:
Operator sends a MIDI message to console which automatically selects or creates a MIDI entry in the table.
Operator presses a Hog front panel key (wiggles a Hog Encoder or moves a Hog Fader ).
The MIDI mapping table assign the Hog action to the selected table row.
Here are some other important things to know about Learn mode:
Hog 4 front panel key presses assign the Hog Function of the current row to the Hog 4 front panel Key. Multiple front panel key presses replace the action with the current Hog 4 key.
Even without a MIDI device present, operators can manually select a row or create a new one, then press a Hog 4 front panel key to associate it with the new entry.
Users can exit Learn mode without a touch screen by using a mouse / trackball
Editing MIDI Maps manually is a straight forward process.
To add a new entry to the map simply press the "add" button at the top of the mapping table and use the pop up wizard to create the desired type and range of MIDI table entries.
To remove one or more entries from the map simply click and drag to highlight the entries in the table and then press the remove button.
To edit existing entries in the mapping table simply double click on the attribute.
Since control messages are sent is a variety of ways based on the MIDI device, the following modes can be assigned to a MIDI Controller entry. These modes cannot be automatically detected by Hog 4 OS, therefore 7-bit Relative Mode is used by default for all controller type entries in the mapping table until the operator assigns the entry to the most appropriate mode.
7-bit Relative
7-bit Absolute
7-bit Binary
14-bit Relative
14-bit Absolute
14-bit Binary
Features of Relative Mode:
When mapped to a Hog wheel the first value change of a controller will be ignored as we cannot determine delta until two values are provided
Repeated value of 0 is treated as a negative delta
Repeated value of 127 is treated as a positive delta
This mode is recommended for mapping MIDI knobs to Hog wheels and encoders
Features of Absolute Mode:
Maps the MIDI value directly to the value of the Hog function with some scaling
This mode is recommended when mapping MIDI faders to Hog faders or when mapping MIDI knobs to Hog faders
Features of Binary Mode:
Maps MIDI controller value of 127 to a key press and a value of 0 to a key up.
This mode is recommended when mapping MIDI controllers to Hog keys
7-bit vs 14-bit:
14-bit messages are two standard 7-bit MIDI CC messages combined to form a single 14 MIDI CC data point and are always sent as a pair as Course byte , Fine byte. Hog 4 OS cannot detect this based on input from the MIDI controller and therefore you will have to manually configure mappings for 14-bit vs 7-bit based on your knowledge of the MIDI controller product you are using.
MIDI hardware devices and MIDI Maps are associated with MIDI Indexes, therefore they have a relationship to one another through the index.
To assign an existing MIDI Map to an index via the network window:
Open the Console Settings window for the Node/Index you wish to configure
Select the MIDI Configuration tab
Click on the config button for the index your wish to assign a map to.
In the MIDI Configuration window use the drop down menu to assign a MIDI Map to the MIDI index. Click to confirm.
To assign a MIDI Map to an index via the MIDI Map Editor window:
Open the MIDI Map Editor window and select a MIDI Map in the current map menu
Press the Assign to Device button at the bottom of the MIDI Map Editor Window.
Click on one or more of the devices listed in the pop up menu to assign the current map to the index associated with the device.