Joystick Mapping Information for Game Developers
General
EdgeTX can output joystick / gamepad information via USB HID with ID (VID_1209&PID_4F54 / 1209:4F54).
EdgeTX performs configurable input processing including dead bands, mixing, and non-linear scaling.
A wide variety of controllers run EdgeTX. By default all devices output the same "Classic Joystick" report format with 8 analog axis and 24 digital buttons.
Buttons are digital (0 = off, 1 = on).
Analog axis have 11 bit resoultion.
Linux: evdev
Linux's evdev API uses open (fcntl.h) with /dev/input/event[...] and read (unistd.h) to read input_event (linux/joystick.h).
identity
EVIOCGID : device_id.vendor is 4617 / 0x1209
EVIOCGID : device_id.product is 20308 / 0x4F54
input labels
CH1
ABS_X
EV_ABS 0
CH2
ABS_Y
EV_ABS 1
CH3
ABS_Z
EV_ABS 2
CH4
ABS_RX
EV_ABS 3
CH5
ABS_RY
EV_ABS 4
CH6
ABS_RZ
EV_ABS 5
CH7
ABS_THROTTLE
EV_ABS 6
CH8
ABS_RUDDER
EV_ABS 7
CH9
BTN_SOUTH
EV_KEY 304 / 0x130
CH10
BTN_EAST
EV_KEY 305 / 0x131
CH11
BTN_C
EV_KEY 306 / 0x132
CH12
BTN_NORTH
EV_KEY 307 / 0x133
CH13
BTN_WEST
EV_KEY 308 / 0x134
CH14
BTN_Z
EV_KEY 309 / 0x135
CH15
BTN_TL
EV_KEY 310 / 0x136
CH16
BTN_TR
EV_KEY 311 / 0x137
CH17
BTN_TL2
EV_KEY 312 / 0x138
CH18
BTN_TR2
EV_KEY 313 / 0x139
CH19
BTN_SELECT
EV_KEY 314 / 0x13A
CH20
BTN_START
EV_KEY 315 / 0x13B
CH21
BTN_MODE
EV_KEY 316 / 0x13C
CH22
BTN_THUMBL
EV_KEY 317 / 0x13D
CH23
BTN_THUMBR
EV_KEY 318 / 0x13E
CH24
(no name)
EV_KEY 319 / 0x13F
CH25
BTN_TRIGGER_HAPPY1
EV_KEY 704 / 0x2C0
CH26
BTN_TRIGGER_HAPPY2
EV_KEY 705 / 0x2C1
CH27
BTN_TRIGGER_HAPPY3
EV_KEY 706 / 0x2C2
CH28
BTN_TRIGGER_HAPPY4
EV_KEY 707 / 0x2C3
CH29
BTN_TRIGGER_HAPPY5
EV_KEY 708 / 0x2C4
CH30
BTN_TRIGGER_HAPPY6
EV_KEY 709 / 0x2C5
CH31
BTN_TRIGGER_HAPPY7
EV_KEY 710 / 0x2C6
CH32
BTN_TRIGGER_HAPPY8
EV_KEY 711 / 0x2C7
Linux: joystick
Linux's joystick API uses open (fcntl.h) with /dev/input/js and read (unistd.h) to read js_event (linux/joystick.h).
identity
JSIOCGNAME is "EdgeTX [...] Joystick" or "OpenTX [...] Joystick". The middle part ("[...]") is device specific.
input labels
CH1
JS_EVENT_AXIS 0
CH2
JS_EVENT_AXIS 1
[...]
[...]
CH8
JS_EVENT_AXIS 7
CH9
JS_EVENT_BUTTON 0
CH10
JS_EVENT_BUTTON 1
[...]
[...]
CH32
JS_EVENT_BUTTON 23
Windows: DirectInput
Windows's DirectInput uses IDirectInputDevice8::GetDeviceState to read DIJOYSTATE (dinput.h). DIJOYSTATE2 (c_dfDIJoystick2) outputs the same information.
identity
DIDEVICEINSTANCE.guidProduct starts with "4F541209-". The trailing part of the GUID is device specific.
input labels
CH1
lX
CH2
lY
CH3
lZ
CH4
lRx
CH5
lRy
CH6
lRz
CH7
rglSlider[1]
CH8
rglSlider[0]
CH9
rgbButtons[0]
CH10
rgbButtons[1]
[...]
[...]
CH32
rgbButtons[23]
Windows: Multimedia
Windows' Multimedia API uses joyGetPosEx to read JOYINFOEX (joystickapi.h). The older joyGetPos / JOYINFO only support CH1-CH3 and CH9-CH32 with the same mapping as the newer JOYINFOEX.
identity
JOYCAPS.wMid is 4617 / 0x1209
JOYCAPS.wPid is 20308 / 0x4F54
input labels
CH1
dwXpos
CH2
dwYpos
CH3
dwZpos
CH4
dwVpos
CH5
(not available)
CH6
dwRpos
CH7
dwUpos
CH8
(not available)
CH9
dwButtons & 0x000001
CH10
dwButtons & 0x000002
CH11
dwButtons & 0x000004
[...]
[...]
CH32
dwButtons & 0x800000
Windows: Raw Input
Windows' Raw Input API uses GetRawInputData (WinUser.h), HidP_GetUsageValue and HidP_GetUsages (hidpi.h).
identity
RID_DEVICE_INFO_HID.dwVendorId is 4617 / 0x1209
RID_DEVICE_INFO_HID.dwProductId is 20308 / 0x4F54
input labels
CH1
HidP_GetValueCaps [7]
0x01
0x30
CH2
HidP_GetValueCaps [6]
0x01
0x31
CH3
HidP_GetValueCaps [5]
0x01
0x32
CH4
HidP_GetValueCaps [4]
0x01
0x33
CH5
HidP_GetValueCaps [3]
0x01
0x34
CH6
HidP_GetValueCaps [2]
0x01
0x35
CH7
HidP_GetValueCaps [1]
0x01
0x36
CH8
HidP_GetValueCaps [0]
0x01
0x37
CH9
HidP_GetButtonCaps [0]
0x09
0x01
CH10
HidP_GetButtonCaps [0]
0x09
0x02
[...]
[...]
[...]
[...]
CH32
HidP_GetButtonCaps [0]
0x09
0x18
Windows: Windows.Gaming.Input
Windows' RawGameController uses winrt::Windows::Gaming::Input::RawGameController (winrt/Windows.Gaming.Input.h).
identity
RawGameController::HardwareVendorId is 4617 / 0x1209
RawGameController::HardwareProductId is 20308 / 0x4F54
input labels
CH1
axisArray[0]
CH2
axisArray[1]
[...]
[...]
CH8
axisArray[7]
CH9
buttonArray[0]
CH10
buttonArray[1]
[...]
[...]
CH32
buttonArray[23]
Last updated