Страница «Поддержка»

Страница «Поддержка» — единое место для документации, проверок состояния, диагностики, журналов и экспорта пакета поддержки. Конфигурация физического устройства теперь находится на странице «Оборудование».

Рисунок 1. На вкладке «Поддержка → Проверки состояния» для каждой проверки отображается одна строка со статусом УСПЕХ / ИНФО / ПРЕДУПР. / ОШИБКА и действием, если доступно исправление. Первой открывается вкладка «Ресурсы».

Панель вкладок

Страница «Поддержка» открывается на вкладке Ресурсы со ссылками на онлайн-документацию и PDF-руководство из комплекта. Две другие вкладки доступны в один щелчок:

Ресурсы (открывается первой) — официальная документация и руководство в PDF. Приветствие можно показать снова в разделе «Параметры → Общие».
Проверки состояния — повседневный инструмент диагностики (устройство, правило udev в Linux, доступность симулятора, состояние среды выполнения). Нажмите Запустить проверки для опроса состояния.
Диагностика — метрики среды выполнения, журнал событий с поиском и экспорт пакета поддержки одним щелчком. Подробное описание — на странице «Диагностика» в документации.

Выбор устройства, калибровка направлений, проверенное воспроизведение эффектов, ограничения силы и назначения органов управления находятся в разделе Оборудование.

Вкладка «Проверки состояния»

Вкладка «Проверки состояния» — то, что нужно большинству тестировщиков, когда что-то идет не так. Нажмите Запустить проверки для опроса состояния FFB-Bridge. Строки обновляются независимо, поэтому медленная проверка симулятора не задерживает появление результатов по устройству или среде выполнения.

УСПЕХ означает, что FFB-Bridge проверил эту часть настройки.
ИНФО означает, что все в порядке, но в строке есть полезный контекст. Например, то, что X-Plane не принимает подключения, ожидаемо, когда вы летаете в MSFS или используете режим имитации.
ПРЕДУПР. означает, что настройку можно продолжить, но есть что исправить или о чем сообщить.
ОШИБКА означает, что FFB-Bridge обнаружил блокирующую проблему. Если вкладке «Проверки состояния» известно безопасное исправление, в строке появляется кнопка действия.
ГОТОВО и ИДЕТ ПРОВЕРКА — нейтральные состояния, используемые до и во время проверки.

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

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

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

Рисунок 2. В разделе «Поддержка → Проверки состояния» видны «УСПЕХ» для поддерживаемого узла событий, «ПРЕДУПР.» для устаревшего правила udev с кнопкой «Исправить…» и «ОШИБКА» для физического устройства.

Оборудование

Прежние элементы управления оборудованием со страницы «Поддержка» теперь вынесены в отдельный раздел. Используйте Flight Check для изолированной проверки эффектов, а страницу «Оборудование» — для постоянных параметров физического устройства. Открыть руководство по оборудованию.

Как устроены проверки

Каждая строка проверки состоит из четырех частей:

Статус — УСПЕХ (зеленый), ИНФО (синий), ПРЕДУПР. (желтый), ОШИБКА (красный), ГОТОВО / ИДЕТ ПРОВЕРКА (нейтральный) или Н/Д, если строка неприменима на этой платформе.
Заголовок — что проверяется.
Подробности — однострочная сводка найденного. Наведите указатель (или коснитесь на сенсорном экране), чтобы увидеть все подробности.
Кнопка действия — появляется, только когда есть что предпринять. Примеры: Установить локальную запись, Использовать порт 5111, Исправить….

Проверки

Устройство FFB-джойстика

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

Linux Правило udev

Раздел «Проверки состояния» проверяет, что файл /etc/udev/rules.d/71-ffb-bridge.rules охватывает все текущие строки ввода поддерживаемых устройств, права доступа к TTY для MOZA и доступ к hidraw, который используют Logitech G940 и базы Brunner. Кнопка «Исправить…» показывает эталонное правило для предварительного просмотра, устанавливает его через pkexec, удаляет прежний файл 99-ffb-bridge.rules, перезагружает udev и инициирует события для устройств ввода, TTY и hidraw. Подключенный джойстик не из списка, для которого вы включили разрешение, добавляется в правило во время установки.

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

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

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

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

Исключение для NixOS

Вкладка «Проверки состояния» распознает NixOS (по наличию /etc/NIXOS) и заменяет строку правила udev указанием добавить правило в configuration.nix вместо этого. См. раздел «Установка» — там приведен нужный фрагмент.

WindowsLinux Конфигурация SimConnect для MSFS

SimConnect — это канал подключения MSFS, поэтому данная проверка выполняется в Windows и Linux. Она ищет принадлежащий MSFS файл SimConnect.xml в расположении, соответствующем платформе, разбирает его и сравнивает все включенные записи IPv4 с портом, который использует FFB-Bridge. Возможны три результата:

Найдена подходящая запись. Зеленый — делать ничего не нужно.
Запись с другим портом. Желтый — предлагает кнопку Использовать порт :X для перехода на этот порт.
Нет пригодной записи (или файл не удается разобрать). Красный — предлагает кнопку Исправить… для открытия диалога установки (см. ниже).

Linux использует непривилегированный порт

MSFS поставляется со стандартной записью SimConnect на порту 500. В Windows привязка к нему проходит без проблем, и FFB-Bridge использует эту запись. В Proton под Linux процесс в пользовательском пространстве имен не может привязываться к портам ниже 1024, поэтому FFB-Bridge устанавливает и использует параллельную запись на непривилегированном порту (по умолчанию 5111), к которому MSFS в Proton действительно может привязаться, — именно поэтому исправление для Linux и действие Использовать порт указывают на этот порт с большим номером.

Доступность MSFS

Проверяет настроенный TCP-порт. Отправляет настоящий пакет SimConnect OPEN и анализирует заголовок ответа, чтобы отличить прослушивание порта самим MSFS от прослушивания порта другим процессом.

Доступность X-Plane

Подключение к X-Plane доступно в Windows, Linux и macOS на Apple Silicon. Эта проверка отправляет RREF-запрос на 127.0.0.1:49000 и недолго ожидает dataref в ответ. Как тайм-аут, так и ошибка Winsock WSAECONNRESET (возникает при получении ICMP-сообщения «порт недоступен») интерпретируются как «не запущен».

Состояние среды выполнения

Сводит воедино текущее состояние устройства, источника данных, телеметрии и исключений. УСПЕХ означает, что устройство открыто и конвейер получает реальные данные симулятора или данные режима «Имитация симулятора»; ИНФО означает, что устройство открыто без реальных данных симулятора, что ожидаемо, пока симулятор закрыт; ОШИБКА означает, что устройство не открыто.

Отчет о сбое

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

Диалог «Исправить…»

Исправить… — эти кнопки не применяют изменения напрямую: они открывают диалог, который точно показывает, что и где будет изменено, а также (в Linux) что вас попросят подтвердить в запросе аутентификации.

Диалог всегда только добавляет: существующие записи никогда не перезаписываются. Если целевой файл не удается разобрать, диалог сообщает, что сначала будет создана резервная копия с отметкой времени. «Отмена» — всегда безопасный вариант.

Поведение pkexec в Linux

Действия, которые записывают в системные пути (правила udev, все, что находится в /etc), выполняются через pkexec. Вы увидите обычный запрос polkit вашего дистрибутива — тот же, что появляется для gparted или графического менеджера пакетов. Коды выхода, которые интерпретирует вкладка «Проверки состояния»:

Код выхода	Значение	Результат в «Проверках состояния»
`0`	Успех	Зеленая отметка; строка проверяется заново.
`126`	Пользователь закрыл запрос аутентификации	Желтый «Отменено» — повторите попытку, когда будете готовы.
`127`	Нет агента polkit / ошибка аутентификации	Красный «Ошибка аутентификации.»

Совет

Запускать FFB-Bridge в минимальном окружении (Linux без графической оболочки, sway без агента polkit) можно — просто вам будут недоступны привилегированные исправления на странице «Поддержка». Установите нужные файлы вручную или запустите агент polkit до запуска FFB-Bridge.

Когда все проверки зеленые

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

Если установлены MSFS 2020 и 2024 или несколько копий симулятора, перед исправлением проверьте каждую указанную целевую конфигурацию. Исправление изменяет конфигурацию выбранного симулятора; после этого перезапустите этот симулятор. Раздел «Параметры → Сеанс» определяет, какой симулятор FFB-Bridge выберет при следующем запуске.