Skip to content

Encoder technical details

Each encoder detected on the controller is added as a pair of virtual buttons. To avoid conflict with standard game controller buttons, which are in the range from 1 to 128, the virtual encoder buttons are mapped to the range of 1000-1319.

This number is based on the ID of the encoder, assigned automatically in ascending order from 0 to 31, and the direction the encoder is turned in.

For example, for increasing the third encoder on a device (e.g. turning En1 on a STECS Standard clockwise), the button ID would look like this:

DigitMeaningDetailsExample
1PrefixAlways 11
2Encoder ID 1st digit10s place0
3Encoder ID 2nd digit1s place2
4Direction0: Decrease, 5: Increase5

The encoder would thus be treated as “Button 1025”.

The mapping between physical movement of the knob and increase/decrease directions is determined by the hardware.