Access the Bluetooth connection screen from the menu button in the top right hand corner to connect (or confirm connected state) of MIDI devices. The app will automatically re-connect to any previously connected devices that are active and available on startup.
The main screen will list any defined/active patches. Use the Edit or Delete icon to modify or delete any given patch. Once a patch is defined and the App is running, it will be active and apply the translation.
To create a new patch, tap the Add Patch button on the main screen.
Patch creation entails selecting the type of MIDI inbound code to listen for (either CC or PC) and the code (0 to 127). Tapping the footswitch or invoking the MIDI message from the connected device or Midi emitting App will auto populate the type and code. After defining the source of MIDI message, define the target SysEx message to generate by selecting the following options:
Device: Select the device from the list, this will make up the first part of the SysEx message.
Function: Select the function from the list, this will make up the second part of the SysEx message.
Source Value: Select either Specific Value or Received Value. When Specific Value is selected, you will will provide the value to be sent (0 to 127) as a static value each time the patch is invoked. When Received Value is selected, the value from the received inbound MIDI message will be used (with or without value conversion). Note that PC messages can only send a specific value since PC codes don't have a value. Also, Tap Tempo does not use Specific or Received values, it simply invokes the patch based on the interval of the received messags.
Received Value: If the Source Value is set to Received Value, the received value will of the inbound message will be shown in real time, invoke the inbound MIDI message (press your pedal footswitch for example) and the received value will be shown (with or without value conversion).
Value Conversion: If the Source Value is set to Received Value, the Value Conversion can be set to either None (no value conversion applied), Toggle (the received value will be converted on the basis of 0 becomes OFF and any value greater than 0 becomes ON), or Minimum/Maximum (the received value will be clamped between a set minimum and maxium). The Minimum/Maximum can be used for any context but is especially useful with expression pedals.
User defined devices and functions can be added using the Add User Device and Add User Function at the bottom of the screen. User defined devices and function need to be created with a name and a value in Hex (two digit comma separated values). Note that a Device Name starting with the literal "Boss" will cause the patch to append a checksum and closure to the generated SysEx message.
The configuration of patches can be saved to a Backup file in a user selected folder location. Patches can be restored from previously created backups. Restoring from a backup will replace the entire set of defined patches.