The script implements a DX7 programmer using 8 CC controls in total – one for setting the bank of parameters, and the rest for modifying the parameters in the bank themselves.

The suggested layout is to use 4 by 2 knobs, where the top left knob is for the bank selection.

You can override the CC IDs used for the controls by editing /etc/pimidipy.conf and setting the following variables:

DX7_BANK_CONTROL_0=30
DX7_BANK_CONTROL_1=31
DX7_BANK_CONTROL_2=32
DX7_BANK_CONTROL_…=…
DX7_BANK_CONTROL_7=37

The 0 control is the one for selecting the bank.

By default, DX7 Device ID 1 is used, you may override this by setting the DX7_DEVICE_ID environment variable in /etc/pimidipy.conf. Use values 0-15 for device IDs 1-16.

You may also map CC controls to DX7 parameters directly by setting the following variables in /etc/pimidipy.conf:

DX7_PARAM_n=ch:cc_id

# or

DX7_PARAM_n=cc_id # Channel 1 is assumed, equivalent to 0:cc_id
where n is the DX7 parameter ID (see the Parameters table), ch is the MIDI channel number to listen to (use numbers between 0-15 for channels 1-16), and cc_id is the CC ID to listen to.

It’s also possible to provide more than one CC ID for a parameter by separating them with a comma.