[DRAFT] Feature: Midi Follow Mode with Midi Feedback and Midi Learning View

[seangoodvibes]

Midi Follow Mode with Midi Feedback and Midi Learning View

Description:

Master midi follow mode whereby after enabling the mode, you set a master midi follow channel for synth clips, kit clips, and for parameters and all midi (notes + cc’s) received on the channel relevant for the active context will be directed to control the active view (e.g. arranger view, song view, audio clip view, instrument clip view).

• For example, Midi Notes received on the Synth Channel will send notes to the active Synth clip. Midi CC's received on the Param Channel will send cc's to control the params of the active view.

Comes with a midi feedback mode to send updated parameter values on the midi follow channel for learned midi cc's. Feedback is sent whenever you change context on the deluge and whenever parameter values for the active context are changed.

Comes with a midi learning view to make learning and managing your midi cc's to the deluge's parameters a breeze.

Simple summary: Set your channel(s), set your Midi Controller(s) to the same channel(s), set a root note for your kits, learn your Midi CC's once and play and control the deluge instruments and parameters with ease!

No more re-learning your Midi controllers every time you start a new song, add new clips or change instrument presets.

• Note: Your existing midi learnings will remain untouched and can be used together with the master midi follow mode.

**Turn Follow Mode On, Set Master Midi Follow Channel(s) and Learn Devices, Set Kit Root Note, Enable/Disable Pop-ups and Enable/Disable Midi Feedback **

To turn configure the various Midi Follow Mode settings, enter the settings menu and go to the sub menu for Midi -> Midi-Follow

• In the Midi-Follow > Follow submenu, set this feature to Enabled or Disabled
• In the Midi-Follow > Channel submenu, set the channel between 1 and 16 for Synths, Kits and Params.
  • For each midi follow channel type (Synth, Kit, Midi), you can use the learn button to learn a device to that channel type and set the channel. E.g. for a synth, hold learn and press a key on your midi controller to learn the device and set the channel. That channel type will be restricted to that device and channel combination if you have input differentiation enabled.
• In the Midi-Follow > Kit Root Note submenu, set the root note for kits between 1 and 127 in order to map Midi Notes received to Kit rows. The root note corresponds to the bottom row in a Kit.
• In the Midi-Follow > Display Param submenu, enable or disable param pop-ups
• In the Midi-Follow > Feedback > Feedback submenu, enable or disable midi follow feedback
• In the Midi-Follow > Feedback > Automation Feedback submenu, enabled or disable midi follow feedback for automated parameters and set the rate at which feedback for automated parameters is sent
• In the Midi-Follow > Feedback > Filter Responses submenu, enable or disable filtering of responses received within 1 second of sending a midi feedback value update.

Notes:

For notes, the functionality is simple: notes received on the master midi channel will play the instrument in the active clip (e.g. a synth, or all kit rows).

• Note 1: You can play a synth or kit clip without entering the clip from arranger or song view. Simply press and hold the clip in arranger or song view to preview the clip (as you would to change the parameters of that clip with the gold encoders) and then send notes from your midi controller.

• Note 2: For Kit's, the bottom Kit row is mapped by default to the root note C1 (note # 36). All kit rows above are mapped to note's incrementally (e.g. 36, 37, 38, etc.). This kit root note # is configurable (from 0 to 127) through the Kit Root Note submenu.

CC's:

For CC's, you need to learn your midi CC's to the parameters you want to control. You do this by entering a Midi Learning View accessible from the Song View by pressing Learn + Midi. You also exit this view by pressing Learn + Midi.

In the Midi Learning View, the shortcut pads for all the Parameters that can be controlled on the deluge are illuminated. By default, no CC's are learned and all shortcut pads are illuminated dimly.

In order to learn a Midi CC to a Parameter, press and hold on the shortcut pad for the parameter and send a Midi CC with your controller (e.g. turn knob, move fader up/down). The shortcut pad will now be illuminated white indicating that that parameter has been learned. The display will also indicate the midi CC that the parameter has been learned to.

A parameter can only be learned to one midi CC. Conversely, a midi CC can be learned to multiple parameters.

You can get an overview of what parameters a midi CC has been mapped to by holding the Midi button and turning Midi CC on your controller. The parameter shortcuts mapped to that midi CC will be illuminated green.

After you have finished learning your Midi CC's, simply exit Midi Learning View (with Learn + Midi) and your midi CC's will now control the parameters you have learned. The parameters are controlled only in the current context.

• So if you learn filter for example, while in song view it will only control the song’s filter. If you enter a specific synth clip, it will only control that synths filter, if you are in a kit clip it will either control the entire kit or a specific row in that clip (depending on whether you have affect entire enabled or not)
• In other words it checks what context you’re in and controls the parameters of that context.

Note: You can control the parameters of a synth or kit clip without entering the clip from arranger or song view. Simply press and hold the clip in arranger or song view to preview the clip (as you would to change the parameters of that clip with the gold encoders) and then send midi cc's from your midi controller.

Unlearn Parameters

You can unlearn all parameters by pressing down on the Horizontal encoder (<>) and pressing the back button

You can unlearn a single parameter by pressing down on Learn and then pressing on a parameter shortcut pad

Save your Midi CC mappings

You can save your Midi CC mappings for Midi Follow Mode while in Midi Learning View by pressing the save button. Likewise, pressing the load button will load your saved Midi CC mappings.

The save button will blink red whenever there are unsaved changes (as compared to the previous loaded defaults from MIDIFollow.XML

Midi CC mappings for Midi Follow Mode are saved to the root of your SD card in an XML file called MIDIFollow.XML

Within MIDIFollow.XML, all Parameters that can mapped to a Midi CC are listed. The Midi CC value is enclosed between a Parameter XML tag - e.g. <lpfFrequency>49</lpfFrequency> indicates that Midi CC is mapped to the LPF Frequency parameter. Conversely when a value of 255 is entered (e.g. <hpfFrequency>255</hpfFrequency>) it indicates that no Midi CC value has been learned to that parameter as part of Midi Learning View.

You can manually edit the MIDIFollow.XML to enter your Midi CC mappings to each Parameter.

The defaults from MIDIFollow.XML are loaded automatically when you start the Deluge so you can begin controlling the deluge with your MIDI controller right away without any need to enter a menu or Midi Learning View.

Display Parameter Names and Values on Screen

Note: Midi pop-up's can be disabled in the Midi Follow Display Param submenu.

For learned Midi CC's, I have added a pop-up on the display whenever Midi CC's are received to indicate the name of the parameter that is being controlled by that Midi CC and the current value being set for that parameter.

Note: if the Midi CC being received for a Parameter that cannot be controlled in the current context (e.g. trying to control Attack while in Song View), the pop-up message will say "Can't Control: <Parameter Name".

Re-cap of functionality

1. Added new Midi submenu for Midi-Follow where you can:

• Enable or Disable Midi Follow Mode
• Set the Midi Follow Channel for Synth Notes and Learn Device
• Set the Midi Follow Channel for Kit Notes and Learn Device
• Set the Midi Follow Channel for Param CC's and Learn Device
• Set the Midi Follow Root Note for Kits
• Enable or Disable Midi Follow Param Pop-up's
• Enable or Disable Midi Follow Feedback
• Enable or Disable Midi Follow Feedback for Automated Parameters and set the Midi Feedback Update Rate
• Enable or Disable Midi Follow Feedback Filtering of Midi CC responses received within 1 second of sending feedback

2. Added new Midi Learning View accessible with Learn + Midi from Song View where you can learn Midi CC's to control Parameters on the deluge
3. When Midi Follow Mode is enabled, a Midi Follow Channel has been set, and you have learned your Midi CC's, your external controller's Notes and Midi CC's will be automatically directed to control the Notes of the Active Instrument (e.g. Synth, Kit, Midi, CV) or the Parameters of the Active View (e.g. Song View, Arranger View, Audio Clip View, Instrument Clip View).
   • For each midi follow channel type (Synth, Kit, Midi), you can use the learn button to learn a device to that channel type and set the channel. E.g. for a synth, hold learn and press a key on your midi controller to learn the device and set the channel. That channel type will be restricted to that device and channel combination if you have input differentiation enabled.
4. By default, the root note for kit's is C1 for the bottom kit row but this can be configured in the Midi Follow menu.
5. Pop-up's are shown on the display for learned Midi CC's to show the name of the parameter being controlled and value being set for the parameter. This can be disabled in the menu.
6. Midi feedback is sent for learned CC's when the active context changes or you change the value of a learned parameter on the deluge (e.g. using mod encoders or select encoder if you're int he menu). Midi feedback can be disabled in the menu.
7. Midi feedback for automated parameters can also be sent and can be enabled or disabled in the midi feedback sub menu. When enabled, you choose between 3 speeds at which to send feedback for automated parameters: Low (500 ms), Medium (150 ms), High (40 ms). Sending automated parameter feedback can be taxing on the deluge midi output system, so depending on the amount of automation you do, you may want to adjust the speed (e.g. slow it down) to not affect the performance of the Deluge.
8. Midi feedback can cause an undesirable result with certain applications when the application responds back to the Deluge after the Deluge has sent it an updated value (Loopy Pro and Drambo on iPad are known to do this). This can cause lag in the deluge and potential feedback loops. To handle this, a toggable filter was added which ignores messages received for the same ccNumber within 1 second of sending a midi feedback update. If the application receiving the midi feedback update does not send responses back to the Deluge, then this setting should be set to Disabled in the Midi Feedback Filter Responses sub menu.

Midi Learning View shortcuts

• In Song View, Midi + Learn to enter Midi Learning View

In Midi Learning View:

• Midi + Learn to exit Midi Learning View

• Press down on Select Encoder to enter the Midi-Follow settings menu to enable/disable Midi Follow Mode and/or set the Master Follow Channel. This menu is also accessible as a Midi submenu through the regular Shift + Select Encoder settings menu.

• Press down on a parameter shortcut pad to see the name on the parameter and its learning status. On OLED you will see the parameter name, whether it has been learned and to which MIDI CC it has been learned to.

• Press down on a parameter shortcut pad and send Midi CC to learn Midi CC to that parameter. Note: Midi CC must be received on the Master Follow Channel in order to be learned. If it is not on the Master Follow Channel, a pop-up message will indicate an error that it cannot be learned and tell you what channel it is on.

• Hold Midi + send CC's from learned control to see the parameters that CC has been learned to highlighted green

• <> + back to clear all learned Midi CC's from parameters

• Learn + parameter shortcut pad to unlearn Midi CC from that specific parameter

• Load to load saved defaults from MIDIFollow.XML

• Save to save defaults to MIDIFollow.XML