Устранение неполадок

Сначала симптомы, под ними — решения. В большинстве случаев страница «Поддержка», а точнее ее вкладка «Проверки состояния», уже показывает, что не так, — загляните туда, прежде чем проходить этот список вручную. Если здесь ничего не помогло, экспортируйте пакет поддержки в разделе «Поддержка» на вкладке Диагностика и отправьте отзыв.

Автоматическая предполетная проверка устройства

При запуске FFB-Bridge незаметно проверяет бэкенд устройств в Windows, Linux и macOS. В Linux дополнительно проверяются доступ на чтение и запись к поддерживаемому узлу событий и то, охватывает ли установленное правило udev все текущие права доступа к устройствам. При результате «ПРЕДУПР.» или «ОШИБКА» открывается окно с перечнем всех проблем и кнопками «Проверить и исправить» и «Пока закрыть».

• Если все проверки пройдены, ничего не открывается.
• При запуске симулятор и сеть не проверяются; закрытый симулятор — это нормально, и его состояние учитывается уже во время работы.
• Пока окно открыто, автоактивация ожидает. Проверьте и исправьте проблему или закройте окно, если устройство отключено намеренно; после закрытия автоактивация может продолжиться, только если выполнены остальные ее условия.

Windows 11 SmartScreen или Smart App Control блокирует запуск

Установщик для Windows подписан сертификатом издателя Rohsam, но у совсем новых подписанных файлов все еще может быть низкая репутация в SmartScreen или Smart App Control. Если Windows показывает предупреждение, убедитесь, что файл скачан с сайта ffb-bridge.com, сверьте опубликованный хеш (если он доступен) и убедитесь, что издатель — Rohsam Inc. или RohsamInc.

Окна SmartScreen обычно можно развернуть ссылкой Подробнее после того как вы проверили издателя. Smart App Control в некоторых системах Windows 11 может работать строже и блокировать новую сборку, пока ее репутация не улучшится. Собственное руководство Microsoft:

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

Если вместо запроса Windows о репутации файла вы видите, что антивирус поместил его в карантин, отправьте сведения о помеченном образце по адресу support·ffb-bridge.com — мы разберемся.

Джойстик совсем не двигается

Активирован ли джойстик?

Приборный индикатор «АКТИВАЦИЯ» в верхней строке состояния должен показывать АКТИВИРОВАН (янтарный градиент). Если он показывает ДЕАКТИВИРОВАН (серый значок, теплая рамка), нажмите на него и подтвердите. Если он показывает НЕИСПРАВНОСТЬ (красный), см. раздел «Джойстик работал и внезапно перестал» ниже — только что пропало одно из условий.

Обнаружено ли устройство?

Проверьте сообщение об устройстве или готовности под центральной кнопкой «Активировать», затем раздел «Оборудование → Устройство». Если ожидаемое устройство недоступно:

• Отключите и снова подключите джойстик; FFB-Bridge обнаружит его заново за секунду-две.
• Текущие идентификаторы: SideWinder FFB2 045e:001b; Logitech G940 046d:c287 и псевдоним в Windows 046d:c2a8; Force 3D Pro 046d:c286; WingMan Force 3D 046d:c283; MOZA AB9 346e:1000; AB6 346e:1002; AY90 346e:1003; AY210 346e:1001; Brunner FFB-G 25bb:00d2 и 25bb:0120, CLS MZ в режиме DirectX 25bb:0121; Brunner FFB-H 25bb:00ca (Brunner выделяет отдельный идентификатор продукта для каждой рукояти и режима USB; сообщите идентификатор рукояти не из списка, чтобы его добавили); PicoWinder cafe:4004; Adapt-FFB-Joy 03eb:204e.
• Linux Более старое правило получает статус «ПРЕДУПР.», если в нем нет какого-либо текущего права доступа к устройству, например строк TTY для MOZA или доступа hidraw, который используют Logitech G940 и базы Brunner, либо если из-за имени файла оно применяется слишком поздно для доступа из сеанса рабочего стола, как прежнее 99-ffb-bridge.rules. Используйте «Исправить…», даже если файл уже существует: приложение установит полное сгенерированное правило как 71-ffb-bridge.rules и удалит прежний файл. После успешного исправления правило действует, и приложение рекомендует перезапуск. «Перезапустить сейчас» заново открывает джойстик с новыми правами доступа и отменяет любой резервный режим, выбранный при запуске; вариант «Перезапущу позже» безопасен, если сначала нужно продолжить работу.
• Windows Закройте все другие приложения, которые захватывают обратную связь по усилию, — самодельные тестеры и некоторые утилиты диагностики джойстиков удерживают монопольный доступ.

Подключен ли симулятор?

Проверьте индикатор SIM в верхней строке состояния и опознанное воздушное судно после загрузки полета. Если симулятор не подключен, см. руководство по настройке MSFS или руководство по настройке X-Plane — в зависимости от вашего симулятора. А пока страница Имитация симулятора позволит убедиться, что остальная часть конвейера работает.

MSFS подключается, но усилия ощущаются неправильно

Если джойстик двигается, но усилия ощущаются неправильно, обычно проблема в несоответствии профиля или типа воздушного судна:

• Начните с входящего в комплект профиля для вашего воздушного судна. Автоматическое сопоставление выбирает его, когда симулятор сообщает, какое воздушное судно загружено, а на странице «Настройка» видно, какой профиль будет использоваться; если подходящего нет, возьмите ближайший профиль того же класса. Чаще всего «неправильные» ощущения возникают из-за профиля, настроенного для другого класса воздушных судов.
• Проверьте параметр Система управления в разделе «Настройка → Настройка воздушного судна → Воздушное судно». Тяжелый реактивный самолет в режиме Механическая, как и легкий самолет АОН в режиме Электродистанционная, будет ощущаться неправильно даже при в остальном удачных значениях усиления — выберите режим, соответствующий воздушному судну («Механическая», «Гидравлическая» или «Электродистанционная»).
• Проверьте панель «Активность джойстика» на странице «Панель». Она отделяет базовую пружину от динамических каналов, таких как нагрузка по осям, гул двигателя, качение по земле, турбулентность и механические разовые эффекты. Если неожиданные для вас эффекты отображаются как активные, значит, симулятор передает телеметрию, которая их вызывает.
• Сторонние воздушные суда иногда не реализуют стандартные SimVar. FFB-Bridge это допускает (отсутствующие переменные по умолчанию равны нулю), но из-за этого некоторые эффекты не срабатывают. Это известное ограничение, которое нам непросто обойти в FFB-Bridge, — сообщите нам о конкретном воздушном судне, чтобы мы могли его изучить.

Значок в трее не появляется (Linux)

Некоторые среды рабочего стола по умолчанию не содержат хоста системного трея — самый заметный пример GNOME Wayland. Когда FFB-Bridge это обнаруживает, он показывает в верхней части окна баннер, поясняющий, что закрытие окна сразу завершит приложение (а не скроет его незаметно), и кнопка закрытия ведет себя соответственно. В GNOME установите расширение AppIndicator Support, чтобы вернуть значок в трее; в KDE, Xfce, Cinnamon, MATE и Budgie трей работает сразу.

Проверка состояния показывает, что MSFS доступен, но данные не поступают

FFB-Bridge подключается (TCP-приветствие принимается), но поток данных не запускается. В MSFS 2024 это обычно означает, что подписка на SimVar не удается, потому что внутренний сервер SimConnect еще запускается. Дождитесь, пока MSFS после заставки перейдет в главное меню, и повторите попытку.

X-Plane обнаружен, но данные не поступают

Если X-Plane ненадолго появляется, а затем снова отображается «симулятор не запущен», запустите проверки состояния и изучите журнал на вкладке «Диагностика». FFB-Bridge нужны свежие достоверные полетные данные; ответ, содержащий только идентификацию, не подтверждает, что полет идет. Проверьте:

• Разрешите в брандмауэре локальный обмен данными для X-Plane и FFB-Bridge, не отключая сам брандмауэр.
• Разрешите исходящий трафик UDP 49000 для процесса FFB-Bridge.

Windows Обновление с версии 1.5.3 внутри приложения завершается ошибкой «The system cannot find the path specified»

Механизм обновления версии 1.5.3 мог удалить папку загрузки, пока установщик еще ее использовал. Версия 1.6.0 запускает скачанный установщик напрямую и удаляет устаревшие папки загрузки при следующем запуске; это исправление действует для обновлений, выполняемых версией 1.6.0 и более поздними. Если обновление с 1.5.3 не удается, скачайте и запустите установщик 1.6.0 со страницы загрузки; ваши профили и параметры сохранятся.

Windows Сбой вскоре после активации или взлета

Ранние сборки для Windows в аппаратном режиме создавали большую постоянную таблицу эффектов DirectInput — по одному физическому эффекту на каждый логический эффект симулятора. На некоторых стеках Sidewinder FFB2 / Windows pid.dll такая схема вызовов могла вызывать сбой во время полета — часто рядом с отметками CreateEffect, SetPeriodic, а также нативного ACCESS_VIOLATION в диагностическом следе. Это не проблема MSFS и не признак того, что прошивка вашего джойстика неисправна.

Windows Усилия исчезают после паузы в MSFS или длительного подтормаживания

Текущие сборки целенаправленно устраняют этот класс ошибок. Пауза MSFS и Active Pause теперь сразу подавляют динамические эффекты, а на джойстике сохраняется нейтральная пружина по умолчанию. При возобновлении параметры пружины загружаются заново до повторного запуска эффектов, поэтому центрирование восстанавливается и по тангажу, и по крену.

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

Если после переподключения вывод усилия становится неполным, деактивируйте джойстик, изучите вкладку «Диагностика» и, если будет предложено, запустите проверку аппаратных эффектов в разделе «Оборудование → Эффекты». Доступный способ воспроизведения и путь восстановления зависят от конкретного устройства. Перед изменением параметров совместимости экспортируйте пакет поддержки, затем запустите Проверить оборудование…, затем задайте для параметра «Воспроизведение эффектов» значение Программно в случае, если проверка не пройдена или FFB-Bridge предложит такое восстановление при следующем запуске. Также отправьте, пожалуйста, пакет поддержки, чтобы мы могли изучить оставшийся стек драйверов.

Linux Нет усилий после деактивации и повторной активации

В версии 1.4.1 повторная активация в том же сеансе Linux не срабатывала ни на одном устройстве: при деактивации приложение не освобождало слоты эффектов обратной связи по усилию, поэтому пул ядра для устройства исчерпывался и все последующие попытки активации завершались ошибкой до перезапуска приложения. В версии 1.4.2 это исправлено; если у вас 1.4.1, обновитесь или в качестве обходного пути перезапустите приложение. Кроме того, в 1.4.2 штатный выход больше не отображается как сбой при следующем запуске.

Усилия пропадают, когда работает другая программа с обратной связью по усилию

Некоторые программы, например SteamVR, при запуске сбрасывают все найденные устройства с обратной связью по усилию, что стирает эффекты, загруженные FFB-Bridge. Начиная с версии 1.4.2 в активированном состоянии FFB-Bridge раз в секунду проверяет, что его эффекты все еще существуют на устройстве, и автоматически создает их заново, если другая программа сбросила устройство, так что усилия возвращаются сами. Если устройство сбрасывается снова и снова, число попыток пересоздания ограничено, после чего FFB-Bridge фиксирует состояние и показывает сообщение с объяснением произошедшего; закройте конфликтующую программу, затем деактивируйте и снова активируйте джойстик.

Эффекты продолжают работать ~30 секунд после выхода

Более ранняя проблема Win11 + драйвера FFB2. На этой связке очистка отдельных эффектов при выходе из FFB-Bridge блокировала каждый вызов на все время воспроизведения эффекта прошивкой — поэтому эффекты тряски или бафтинга, игравшие в полете, после закрытия FFB-Bridge дорабатывали свой естественный таймер (~32 секунды), и джойстик продолжал слышно работать на рабочем столе, хотя им не управляло ни одно приложение. Текущие сборки при завершении полностью пропускают обработку отдельных эффектов и используют две команды уровня устройства (остановка всех эффектов + сброс таблицы эффектов прошивки), которые выполняются мгновенно. То же исправление действует и при нативном сбое через Vectored Exception Handler. Если вы видите это в текущей сборке, отправьте, пожалуйста, отзыв.

Windows Сбой при выходе с кодом 0x80131506

Более ранняя проблема. На части установок FFB-Bridge аварийно завершался с окном отчетов об ошибках Windows, в котором указывались coreclr.dll и код исключения 0x80131506 в момент нажатия «Выход» или закрытия окна. Первопричина: при завершении работы поток интерфейса и цикл управления среды выполнения одновременно обращались к DirectInput, и в итоге маршалер COM замечал это и завершал процесс. В текущих сборках весь доступ к DirectInput сериализуется через единую блокировку на границе устройства, поэтому два потока больше никогда не конкурируют за маршалер. Если вы видите 0x80131506 при выходе в текущей сборке, отправьте, пожалуйста, отзыв.

Сбой при запуске

Восстановление при следующем запуске: если предыдущий запуск завершился сбоем, при следующем старте FFB-Bridge показывает диалог отчета о сбое с трассировкой стека, кнопкой «Копировать» и кнопкой Открыть форму обратной связи для отправки отчета. Нажмите «Копировать», затем «Открыть форму обратной связи»: страница обратной связи откроется в браузере, и там можно вставить журнал и приложить пакет поддержки.

Если приложение аварийно завершается до появления диалога, понадобится сам файл журнала сбоев:

• Windows %LOCALAPPDATA%\ffb-bridge\crashes\
• Linux ~/.local/share/ffb-bridge/crashes/

Приложите самый свежий файл .log к отзыву.

Предупреждения «FFB-Bridge не успевает»

Вкладка «Диагностика» предупреждает, когда частота цикла управления падает. Причины, которые нам встречались:

• Другой процесс на том же ядре создает всплески нагрузки на процессор — вкладка браузера, компиляция.
• В Linux регулятор cpufreq снижает частоту процессора. Переключитесь на performance или schedutil.
• Работа в виртуальной среде, которая не выделяет гостевой системе стабильные кванты времени по 20 ms.

Подключено несколько поддерживаемых джойстиков

Если подключено несколько поддерживаемых джойстиков, окно выбора устройства позволяет указать, каким из них управляет FFB-Bridge, и этот выбор сохраняется между перезапусками. Снова открыть его можно на странице Оборудование — . Смена выбранного устройства требует перезапуска.

Моего джойстика с обратной связью по усилию нет среди поддерживаемых

Устройства класса «джойстик» не из списка включаются экспериментально по вашему выбору с осторожными значениями по умолчанию 20%. Гоночные рули, геймпады и одноосевые устройства исключены; для определения характеристик неподдерживаемого оборудования используйте FFB Probe.

ffb-probe.com (вместо FFB-Bridge).

Все еще не получается?

Экспортируйте пакет поддержки в разделе «Поддержка» на вкладке Диагностика и отправьте отзыв. Пакет содержит журнал сеанса, журнал сбоев (если есть), результаты последней проверки состояния и сведения о системе — это ровно то, что нам нужно, чтобы воспроизвести проблему, не отправляя вам тестовые сборки.

Также можно выбрать «Сообщить о проблеме» на боковой панели приложения. После подтверждения эта функция сразу отправляет диагностический пакет, а в том же окне можно добавить описание и, по желанию, адрес электронной почты. Без адреса электронной почты служба поддержки не сможет ответить. Отправка отчета из приложения →

Библиотека воздушных судов не находит загруженное воздушное судно

Введите в поиск библиотеки воздушных судов распространенное название воздушного судна или код ICAO, затем выберите правильное семейство и версию для симулятора. Незнакомое название дополнения может не пройти автоматическое сопоставление, даже если воздушное судно есть в библиотеке. Ошибка подключения или доступа — это не то же самое, что «не найдено»; ранее полученные справочные материалы могут оставаться доступными офлайн. Просмотр справочных материалов не меняет активный профиль усилий.