UB-Xa Editor Manual - updated regularly

 Introduction

The Mac versions have been tested on Catalina 10.15 but users of later Macs report it runs as a standalone app on M1 and later. The plugins do not run on Silicon. PC versions have been built on Windows 7 and tested on Windows 10. Special thanks to RomanKubiak who developed CTRLR. The editor is free and without warranty. I accept no liability for loss or damage. However, MIDI messages are unlikely your damage your synth and you can always do a firmware reset if you have problems.

SETUP

The UB-Xa uses NPRN and SysEx messages to communicate with the editor. NPRNs need to be enabled on the UB-Xa. 

Enable NPRN for USB connection


  • Press SHIFT + ASSIGNABLE PRESET 1 to load the USB-MIDI menu. 
  • Scroll to Local Ctrl and enable [X] ProgChangeRx, ProgChangeTx, NPRNTx and NPRNRx. 
  • Then select the USB Ctrl menu enable USB NPRN-Tx and NRPN-Rx.
  • If you are using MIDI Din use the DIN CTRL Menu


To make things simple the editor uses Channel 1 for the Upper Voice and Channel 2 for the Lower Voice. This is the default setting. Use the USB-MIDI menu to check Chan In and Out is set correctly.
The first time you load the editor you need to set the MIDI ports. Use the MIDI menu to select UB-Xa for Input on ALL Channels and Output on Channel 1. You may need to click  Refresh Devices in the MIDI menu. Quit and reload the editor if there is no communication as this should also refresh the MIDI ports. You can check MIDI is working by moving a knob on the UBXa.  The corresponding knob should move on the editor.

GETTING STARTED



Turn on the UB-Xa then load the editor and from the Menu select MIDI as shown above. NOTE: the INPUT Channel is set to ALL (0) this has to be set like this for Split/Double patch changes to work correctly If the MIDI setup is correct clicking PATCH REFRESH / START EDITOR  should load all 512 Patch Names into the editor. Just click on a bank to check. This command simply requests all the patch names from the UB-Xa and is actually the same command used in the Librarian option in the SynthTribe app.

To RENAME a patch write the new name in the Current Patch box and press WRITE. To save the patch remember to press WRITE on the UBXa which will save your new name. You must also WRITE any edits on the UBXa or your changes will be lost.

ATROPHY

Some Atrophy parameters have been moved to the Upper Patch screen as they are now saved with the patch. The new firmware also lets you store the Atrophy settings with the patch. Click on LOCATION and choose PATCH if you want to save with the Patch. Atrophy Lock must be off to save any changes. This also applies to PAN. I would recommend turning LOCK back on when you leave the page.

The factory values for all the Atrophy presets are stored in the editor so you can always compare your settings and return to the factory value if you wish. You can link the UB-Xa profile to the factory preset. To rename a profile click in the name and press return. Lock must be off to many any changes.

SYSEX

When you load a patch/send Sysex Data is transferred to/from the UBXa You can monitor when SysEx transmission is taking place as the 4 LEDs on the Assignable Preset Recall section will light up sequentially. You can SAVE a single Patch or a Bank of 128 Patches or the the Current Program from the UB-Xa and all 36 Split/Double sets. You must choose a folder to save your files. If you try and save to the root folder you will get an error. Please wait for a Bank Save or Load to finish. The Progress Bar and Packet count can be used to monitor progress.

SYSEX FILES


PatchThe current upper patch for use in a performance.

CurrentThis is an entire program; everything needed to save and restore he current the whole state of the UB-Xa for use in a performance. It includes the two patches with sequences and the performance panel settings stored in a split/double combination.

Split Double - Saves the data for 36 Split program settings and then 36 double program settings. Preceding each split double data are 4 bytes. (0) Upper Bank number, (1) Upper Patch number, (2) Lower Bank number, (3) Lower Patch number

Bank - saves the current bank. Simply change banks to save a different one. At present it is not possible to load a bank into a different bank. So for example you can't load Bank A into Bank B. I will address this in a later update.

Behringer SysEx Manual

Just a word about the SysEx info that Behringer have released. Not to put too fine a point on it but it is the worst Sysex documentation I have seen. So much is omitted and I have had to reverse engineer many messages and decipher the addresses. By far the worst example is the data address for the Performance LFO mods. This is actually found at the end of one long Sysex message that is padded with 7Fs except for the last byte! I couldn't resist posting this for any programmers who are interested in this stuff:

F0 00 20 32 00 01 21 7F 74 07 02 05 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 7F 03 7F 7F 08 00 63 00 0F 1D F7

The data in question is highlighted in green. That is 8 bytes of packed data and once its unpacked the last byte is where you find the Performance LFO Mods.

Most of the data for a patch is stored in the first 2 messages and there is lots of free space there! 

Sysex Transmission Speed



You can choose how fast data is requested or sent to the UB-Xa using the Data Speed option. Fast is the original speed and should be fine for Intel Macs and Windows 10 but if you suspect issues then slow it down.