Установка FFB-Bridge

FFB-Bridge поставляется в виде автономного установщика для Windows, AppImage для Linux и DMG для macOS (Apple Silicon). Все три варианта включают среду выполнения .NET 10. Для поддерживаемых USB-джойстиков с обратной связью по усилию в современных Windows, Linux и macOS скачивать драйвер не нужно.

Прежде чем начать

Вам понадобится:

Поддерживаемое оборудование включает MOZA AB6, AB9, AY90, AY210; Microsoft SideWinder Force Feedback 2; Logitech G940, Force 3D Pro и WingMan Force 3D; поддерживаемые устройства Brunner в режиме DirectX; а также отдельные адаптеры SideWinder Force Feedback Pro. Возможности и подтверждения физическими тестами зависят от конкретной модели и платформы. Прежде чем рассчитывать на определенную функцию, сверьтесь с руководством по оборудованию. Для подходящих джойстиков не из списка требуется включение экспериментального режима. страница оборудования.
Поддерживаемый симулятор: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 или X-Plane 12. DCS, Prepar3D и более ранние версии Flight Simulator не поддерживаются. В macOS поддерживается только X-Plane — MSFS подключается только в Windows и Linux.
Одна из систем:
- Windows 11.
- Любой современный дистрибутив Linux с evdev — то есть практически любой популярный настольный дистрибутив.
- macOS на Apple Silicon (M1 или новее) с X-Plane и поддерживаемым устройством. Компьютеры Mac с процессорами Intel не поддерживаются. Сведения о проверке конкретных моделей и ограничениях см. в руководстве по оборудованию.

Автоматические обновления

Приложение, установленное в Windows или в Linux из пакета AppImage, после вашего подтверждения может скачать, проверить и установить обновление, а затем перезапуститься. macOS проверяет обновления автоматически и открывает подписанную загрузку.

Windows Установщик

Скачивание

После того как вы зарегистрируетесь на главной странице, мы отправим вам письмо со ссылкой для скачивания с токеном. Нажмите ссылку на установщик для Windows, чтобы сохранить ffb-bridge-setup-1.6.0-x64.exe (54 MB)

Запуск установщика

Дважды щелкните установщик. Откроется мастер Inno Setup; кроме того, для совершенно новых подписанных сборок Windows может показать предупреждение SmartScreen о репутации:

Проверка издателя. Установщик для Windows подписан сертификатом издателя Rohsam. Прежде чем продолжить, убедитесь, что Windows показывает Rohsam Inc. или RohsamInc в качестве издателя.
Предупреждение SmartScreen о репутации. Новые подписанные сборки могут помечаться как нераспознанные, пока у этого конкретного файла не накопится история загрузок. Если источник — ffb-bridge.com, хеш совпадает, а издатель — Rohsam, нажмите Подробнее, затем Выполнить в любом случае.
Язык установщика. Установщик сначала запрашивает язык и предварительно выбирает язык интерфейса Windows. Каждый экран установщика доступен на всех шестнадцати языках интерфейса приложения, включая канадский французский. Лицензия и уведомления о сторонних компонентах остаются на языке оригинала.
Мастер установки Inno Setup. Нажимайте Далее на обеих страницах. Папка установки по умолчанию: %LOCALAPPDATA%\Programs\ffb-bridge — установка для текущего пользователя, права администратора не требуются.

Windows 11 Smart App Control и новые подписанные сборки

Если у вас Windows 11 и функция Smart App Control (SAC) включена в активном режиме, Windows все равно может заблокировать совершенно новую подписанную сборку, пока та не наберет репутацию. Подпись кода подтверждает подлинность издателя Rohsam, но не гарантирует, что у каждого нового хеша файла с первого дня будет репутация в SmartScreen или SAC.

В собственном руководстве Microsoft описано поведение Smart App Control и где просмотреть его параметры (Параметры → Конфиденциальность и защита → Безопасность Windows → Управление приложениями/браузером → Параметры интеллектуального управления приложениями):

Microsoft: часто задаваемые вопросы о Smart App Control

Если SAC полностью блокирует новую сборку на вашем компьютере, подождите, пока сборка наберет репутацию, или используйте другое устройство с Windows, на котором вы сможете проверить подпись Rohsam и принять осознанное решение.

Запуск

Ярлык с именем FFB-Bridge появится в группе программ FFB-Bridge в меню «Пуск». Можно также напрямую запустить %LOCALAPPDATA%\Programs\ffb-bridge\FfbBridge.Desktop.exe.

Внимание: антивирусы

Некоторые антивирусы помечают новые исполняемые файлы или файлы с низкой репутацией. Если ваш антивирус сразу помещает установщик в карантин (а не просто предупреждает), отправьте помеченный образец по адресу support·ffb-bridge.com (replace the · with an @) so we can investigate.

Удаление

Откройте Приложения и возможности в параметрах Windows, найдите FFB-Bridge, затем выберите Удалить. Ваши профили и параметры в папке %APPDATA%\ffb-bridge остаются на месте, и после переустановки они снова будут подхвачены; если хотите начать с чистого листа, удалите эту папку вручную.

Linux AppImage

Скачивание

Та же процедура регистрации, что и для Windows: нажмите ссылку для Linux в письме, и вы получите AppImage с номером версии, например FfbBridge-1.6.0-x86_64.AppImage.

Сделайте файл исполняемым и установите

Чтобы Linux запускал AppImage, у файла должен быть установлен бит исполнения. После этого AppImage приложения FFB-Bridge может сам установиться в пользовательские каталоги рабочего стола XDG:

chmod +x 'FfbBridge-1.6.0-x86_64.AppImage' && ./'FfbBridge-1.6.0-x86_64.AppImage' --install

Флаг --install копирует AppImage в ~/Applications, создает файл .desktop (ярлык запуска), устанавливает встроенный значок и обновляет кэши рабочего стола, если доступны соответствующие вспомогательные утилиты. После этого пункт FFB-Bridge должен появиться в меню приложений рядом с другими приложениями с графическим интерфейсом.

Пункт FFB-Bridge в меню запуска приложений KDE Plasma после установки — Рисунок 1. Установленный пункт меню в KDE Plasma. GNOME, Xfce и другие XDG-совместимые среды подхватывают его после шага AppImage --install.

Правило udev (рекомендуется)

В Linux нужны права доступа к выбранному узлу /dev/input/event*, а также к TTY-каналу политики прошивки, который используют поддерживаемые базы MOZA, и к интерфейсам hidraw, которые используют Logitech G940 и базы Brunner. В разделе «Поддержка → Проверки состояния» можно просмотреть эталонное правило для поддерживаемых устройств и установить его через запрос polkit. Если подходящий джойстик не из списка включен и подключен, при установке добавляется строка для его ввода.

# /etc/udev/rules.d/71-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
# Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
# G940 signed 10-bit stick axes; preserve other calibration fields.
ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"

Существующее правило может быть устаревшим

Более старое правило получает статус «ПРЕДУПР.», если в нем нет какого-либо текущего права доступа к устройству, например строк TTY для MOZA или доступа hidraw, который используют Logitech G940 и базы Brunner, либо если из-за имени файла оно применяется слишком поздно для доступа из сеанса рабочего стола, как прежнее 99-ffb-bridge.rules. Используйте «Исправить…», даже если файл уже существует: приложение установит полное сгенерированное правило как 71-ffb-bridge.rules и удалит прежний файл.

После успешного исправления правило действует, и приложение рекомендует перезапуск. «Перезапустить сейчас» заново открывает джойстик с новыми правами доступа и отменяет любой резервный режим, выбранный при запуске; вариант «Перезапущу позже» безопасен, если сначала нужно продолжить работу.

Рисунок 2. Окно исправления в Linux показывает эталонное правило для ввода поддерживаемых устройств и TTY MOZA, прежде чем запросить разрешение. Подключенный и включенный джойстик не из списка добавляется при установке.

Рисунок 3. После успешного исправления правило действует, и приложение рекомендует перезапуск. «Перезапустить сейчас» заново открывает джойстик с новыми правами доступа и отменяет любой резервный режим, выбранный при запуске; вариант «Перезапущу позже» безопасен, если сначала нужно продолжить работу.

NixOS

NixOS берет правила udev из системной конфигурации и игнорирует файлы, размещенные непосредственно в /etc/udev/rules.d. Добавьте аналогичные правила в свой файл configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="hidraw", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
  # Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
  SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
  # G940 signed 10-bit stick axes; preserve other calibration fields.
  ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"
'';

Затем выполните sudo nixos-rebuild switch и переподключите джойстик.

Удаление

Запустите установленный AppImage с флагом --uninstall — это удалит ярлык запуска и значки; затем удалите AppImage из ~/Applications (если он вам больше не нужен). Профили и параметры в папке ~/.config/ffb-bridge сохраняются для последующей переустановки.

DMG для macOS (Apple Silicon)

Сборка для macOS подключается к X-Plane. Она работает на Apple Silicon (M1 или новее) и подключается к X-Plane 12 с поддерживаемым оборудованием с обратной связью по усилию. Точный перечень поддерживаемых устройств и функций см. в руководстве по оборудованию. Сборка поставляется как подписанный и нотаризованный образ .dmg, поэтому Gatekeeper пропускает его без обходного приема с пунктом «Открыть» в контекстном меню.

Скачивание и установка

Используйте ту же процедуру регистрации, что и для других платформ: нажмите ссылку для macOS в письме, чтобы скачать DMG с номером версии, например FfbBridge-1.6.0-arm64.dmg. Затем:

Дважды щелкните DMG, чтобы подключить образ. Откроется окно, в котором показаны FFB-Bridge (приложение) и Applications (ярлык).
Перетащите FFB-Bridge на ярлык Applications для установки.
Извлеките DMG, затем запустите FFB-Bridge из Launchpad или папки «Программы» (Applications).

Поскольку сборка нотаризована с Developer ID компании Rohsam Inc., при первом запуске macOS проверяет ее по сети и открывает в обычном режиме. Если при первом запуске ваш Mac не подключен к сети, подключитесь к интернету, чтобы Gatekeeper мог завершить проверку.

Удаление

Перетащите FFB-Bridge из Applications в Корзину. Профили и параметры в папке ~/.config/ffb-bridge остаются на месте для последующей переустановки; чтобы начать с чистого листа, удалите эту папку вручную.

Проверка установки

Запустите FFB-Bridge. Подтвердите правила безопасности, пройдите проверки при запуске, а затем — приветственное знакомство с приложением (описано в следующем разделе). Если приложение вообще не запускается или аварийно завершается при запуске, сразу переходите к разделу Устранение неполадок.