Настройка расширенного джойстика в EdgeTX (Configure Advanced Joystick with EdgeTX)

Общие рекомендации

  1. Сначала попробуйте классический режим (Classic). Обработка ввода с джойстика прошла через множество разных реализаций. Например, в Windows есть 6 разных API для джойстиков — и у каждого свои особенности.
  2. Режим интерфейса Gamepad (Геймпад) обычно подходит лучше всего.
  3. Чтобы упростить переключение между режимами Advanced (Расширенный) и Classic (Классический), используйте каналы 1–8 для осей и каналы 9–32 для кнопок.
  4. После изменения конфигурации джойстика обычно нужно отключить и снова подключить USB-кабель. Иначе система может продолжать использовать старое описание джойстика при чтении новых данных.
Расширенный режим джойстика недоступен на аппаратурах с чёрно-белым экраном и объёмом флеш-памяти менее 1 МБ, так как эта функция не помещается в доступный объём памяти.

Аналоговые оси

  1. Большинство современных приложений используют USB HID ID для определения назначения оси.
  2. Устаревшие приложения часто используют порядок, в котором были настроены оси.
  3. Некоторые приложения используют обратный порядок настройки осей.
  4. Дублирующиеся оси поддерживаются редко. Некоторые API поддерживают две оси Slider.
  5. Инвертированные оси. Многие приложения ожидают, что левая и правая оси Y направлены в противоположную сторону. Направление можно изменить, задав Weight −100% или в расширенной конфигурации джойстика.
  6. Windows поддерживает типы «axis» и «sim», однако их одновременное использование поддерживается не всегда.
  7. Linux сопоставляет следующие входы одной и той же оси и использует значение входа с наименьшим номером канала:
    • sim Thr + axis Slider → ABS_THROTTLE
    • sim Rud + axis Dial → ABS_RUDDER
    • axis Wheel + sim Steer → ABS_WHEEL
  8. Android трактует sim Acc и sim Brk как половинные оси (half axis). Выходные значения каналов EdgeTX [−100%, 0% и +100%] Android интерпретирует как [0%, 50% и 100%]. Если ваш физический орган управления — один аналоговый стик, рассмотрите такую конфигурацию:
    • sim Acc = вход (ось 1: Offset −50%, Func «x>0»), смешанный с весом (Weight 200%)
    • sim Brk = вход (ось 1: Offset −50%, Func «x<0»), смешанный с весом (Weight −200%)

Типовое сопоставление осей

КаналAndroidBetaflightDualsenseEdgeTX ClassicEdgeTX до 2.9
CH1axis Xaxis Xaxis Xaxis Xaxis X
CH2axis Yaxis Yaxis Yaxis Yaxis Y
CH3axis Zaxis Zaxis Zaxis Zaxis Z
CH4axis rotZaxis rotXaxis rotZaxis rotXaxis rotX
CH5sim Brkaxis rotZaxis rotXaxis rotYaxis rotY
CH6sim Accaxis rotYaxis rotYaxis rotZaxis rotZ
CH7axis Slideraxis Slideraxis Slider
CH8sim Dpadaxis Dialsim Dpadaxis Dialaxis Slider

Похожие раскладки:

Другой контроллерИспользовать раскладку
OpenTXEdgeTX до 2.9
Orqa FPV.CtrlEdgeTX до 2.9
StadiaAndroid
XBoxAndroid

sim Dpad

sim Dpad эмулирует крестик управления (directional pad / D-pad), также известный как hat switch или переключатель точки обзора (point of view switch). Большинство приложений распознают все 8 направлений и «центр». Некоторые приложения распознают только 4 основных направления и «центр» (например, «северо-восток» трактуется как «север»).

Направлениеотдо
Север−100.0%−88.1%
Северо-восток−88.0%−76.4%
Восток−76.3%−64.6%
Юго-восток−64.6%−52.9%
Юг−52.8%−41.2%
Юго-запад−41.1%−29.5%
Запад−29.4%−17.8%
Северо-запад−17.7%−6.1%
Центр−6.0%5.7%
Север5.8%17.4%
Северо-восток17.5%29.1%
Восток29.2%40.8%
Юго-восток40.9%52.5%
Юг52.6%64.3%
Юго-запад64.4%76.0%
Запад76.1%87.7%
Северо-запад87.8%100.0%

Идентификаторы осей (Axis IDs)

EdgeTXHID nameUSB HID ID
axis XX0x00010030
axis YY0x00010031
axis ZZ0x00010032
axis rotXRx0x00010033
axis rotYRy0x00010034
axis rotZRz0x00010035
axis SliderSlider0x00010036
axis DialDial0x00010037
axis WheelWheel0x00010038
sim AilAileron0x000200B0
sim EleElevator0x000200B8
sim RudRudder0x000200BA
sim ThrThrottle0x000200BB
sim AccAccelerator0x000200C4
sim BrkBrake0x000200C5
sim SteerSteering0x000200C8
sim DpadHat switch0x00010039

Кнопки

  1. Кнопки идентифицируются по их USB HID ID.
  2. Назначение конкретного ID кнопки не стандартизировано.
  3. Дублирующиеся кнопки (например, кнопка 1, кнопка 1) не поддерживаются. Используется кнопка с большим номером канала.
  4. Кнопки как оси. Некоторым приложениям нужна аналоговая информация о кнопке. Используйте микс, чтобы передать цифровое состояние кнопки на аналоговую ось.
  5. Фантомные кнопки (Ghost buttons). Для джойстиков и геймпадов автоматически создаётся необходимое минимальное количество кнопок. Аналогично, если настроена только кнопка 15, недостающие кнопки 0–14 создаются автоматически. У этих кнопок нет входа, и они всегда выключены.
  6. Android обычно поддерживает кнопки 0–14 с тем же сопоставлением, что и Linux. Поддержка кнопок, выделенных жирным, обязательна для всех Android-устройств.
  7. Windows обычно поддерживает кнопки 0–9 с тем же сопоставлением, что и Xbox.
EdgeTXAndroid / LinuxDualsenseWindows / XBoxUSB HID ID
button 0BTN_A - 304squareA0x00090001
button 1BTN_B - 305crossB0x00090002
button 2BTN_C - 305circleX0x00090003
button 3BTN_X - 307triangleY0x00090004
button 4BTN_Y - 308L1left bumper0x00090005
button 5BTN_Z - 309R1right bumper0x00090006
button 6BTN_TL - 310L2back0x00090007
button 7BTN_TR - 311R2start0x00090008
button 8BTN_TL2 - 312createleft stick0x00090009
button 9BTN_TR2 - 313optionsright stick0x0009000A
button 10BTN_SELECT - 314L3left trigger0x0009000B
button 11BTN_START - 315R3right trigger0x0009000C
button 12BTN_MODE - 316homeguide0x0009000D
button 13BTN_THUMBL - 317touchpad0x0009000E
button 14BTN_THUMBR - 318mute0x0009000F
button 150x00090010
button 16BTN_TRIGGER_HAPPY1 - 7040x00090011
button 17BTN_TRIGGER_HAPPY2 - 7050x00090012
button 18BTN_TRIGGER_HAPPY3 - 7060x00090013
button 19BTN_TRIGGER_HAPPY4 - 7080x00090014
button 20BTN_TRIGGER_HAPPY5 - 7090x00090015
button 21BTN_TRIGGER_HAPPY6 - 7100x00090016
button 22BTN_TRIGGER_HAPPY7 - 7110x00090017
button 23BTN_TRIGGER_HAPPY8 - 7120x00090018
button 24BTN_TRIGGER_HAPPY9 - 7130x00090019
button 25BTN_TRIGGER_HAPPY10 - 7140x0009001A
button 26BTN_TRIGGER_HAPPY11 - 7150x0009001B
button 27BTN_TRIGGER_HAPPY12 - 7160x0009001C
button 28BTN_TRIGGER_HAPPY13 - 7170x0009001D
button 29BTN_TRIGGER_HAPPY14 - 7180x0009001E
button 30BTN_TRIGGER_HAPPY15 - 7190x0009001F
button 31BTN_TRIGGER_HAPPY16 - 7200x00090020