Tłumaczenie automatyczne. Ta witryna i aplikacja FFB-Bridge są tłumaczone automatycznie — przepraszamy za ewentualne błędy. Poprawki do tłumaczenia aplikacji wysyłaj za pomocą jej wbudowanego narzędzia „Zgłoś tłumaczenie” oraz poprawki do tej witryny przez stronę opinii.
Dokumentacja bieżącej wersji FFB-Bridge 1.6.0 Coś jest nieaktualne? Daj nam znać przez formularz opinii.

Strona „Wsparcie”

Strona „Wsparcie” to jedno miejsce na dokumentację, kontrole stanu, diagnostykę, dzienniki i eksport pakietu diagnostycznego. Konfiguracja fizycznego urządzenia znajduje się teraz na stronie „Sprzęt”.

W sekcji Wsparcie → Kontrole stanu każdy test ma jeden wiersz ze statusem ZALICZONO / INFO / OSTRZ. / NIE ZALICZONO oraz akcją, gdy dostępna jest naprawa. Karta „Zasoby” otwiera się jako pierwsza. W sekcji Wsparcie → Kontrole stanu każdy test ma jeden wiersz ze statusem ZALICZONO / INFO / OSTRZ. / NIE ZALICZONO oraz akcją, gdy dostępna jest naprawa. Karta „Zasoby” otwiera się jako pierwsza.
Rysunek 1. W sekcji Wsparcie → Kontrole stanu każdy test ma jeden wiersz ze statusem ZALICZONO / INFO / OSTRZ. / NIE ZALICZONO oraz akcją, gdy dostępna jest naprawa. Karta „Zasoby” otwiera się jako pierwsza.

Pasek kart

Strona „Wsparcie” otwiera się na karcie Zasoby z linkami do dokumentacji online i dołączonej instrukcji PDF. Pozostałe dwie karty są o jedno kliknięcie dalej:

  • Zasoby (karta początkowa) — oficjalna dokumentacja i instrukcja PDF. Wprowadzenie powitalne możesz ponownie wyświetlić w sekcji Ustawienia → Ogólne.
  • Kontrole stanu — codzienne narzędzie diagnozy (urządzenie, reguła udev w systemie Linux, osiągalność symulatora, stan środowiska działania). Kliknij Uruchom kontrole — rozpocznie to sprawdzanie.
  • Diagnostyka — metryki środowiska działania, przeszukiwalny dziennik zdarzeń i eksport pakietu diagnostycznego jednym kliknięciem. Opisano ją osobno na stronie Diagnostyka w dokumentacji.

Wybór urządzenia, kalibracja kierunków, zweryfikowane renderowanie, limity siły i przypisania elementów sterujących znajdują się na stronie Sprzęt.

Karta „Kontrole stanu”

Karta „Kontrole stanu” to narzędzie, którego potrzebuje większość testerów, gdy coś wygląda nie tak. Kliknij Uruchom kontrole — rozpocznie to sprawdzanie stanu mostu. Wiersze aktualizują się niezależnie, więc powolny test symulatora nie blokuje wyświetlenia wyniku urządzenia ani środowiska działania.

  • ZALICZONO oznacza, że most zweryfikował tę część konfiguracji.
  • INFO oznacza, że wszystko jest w porządku, ale wiersz zawiera przydatny kontekst. Na przykład to, że X-Plane nie nasłuchuje, jest oczekiwane, gdy latasz w MSFS lub korzystasz z trybu testowego.
  • OSTRZ. oznacza, że konfigurację można kontynuować, ale coś warto naprawić lub zgłosić.
  • NIE ZALICZONO oznacza, że most wykrył problem blokujący. Gdy karta „Kontrole stanu” zna bezpieczną naprawę, wiersz zawiera przycisk akcji.
  • GOTOWE i SPRAWDZANIE to stany neutralne używane przed uruchomieniem kontroli i w jej trakcie.

Automatyczna kontrola wstępna urządzenia

Przy uruchomieniu FFB-Bridge po cichu sprawdza mechanizm urządzenia w systemach Windows, Linux i macOS. W systemie Linux sprawdza także dostęp do odczytu i zapisu obsługiwanego węzła zdarzeń oraz to, czy zainstalowana reguła udev obejmuje wszystkie aktualne uprawnienia urządzeń. Wynik OSTRZ. lub NIE ZALICZONO otwiera okno dialogowe z nazwą każdego problemu oraz przyciskami „Przejrzyj i napraw teraz” i „Odrzuć na razie”.

  • Jeśli wszystkie kontrole zostaną zaliczone, nic się nie otwiera.
  • Przy uruchomieniu aplikacja nie sprawdza symulatora ani sieci; zamknięty symulator to normalna sytuacja, którą obsługuje się dopiero w trakcie działania.
  • Gdy okno dialogowe jest otwarte, automatyczne uzbrajanie czeka. Przejrzyj i napraw problem albo odrzuć komunikat, jeśli urządzenie jest celowo odłączone; po odrzuceniu automatyczne uzbrajanie może być kontynuowane tylko wtedy, gdy spełnione są jego pozostałe warunki wstępne.
Sekcja Wsparcie → Kontrole stanu pokazuje wynik ZALICZONO dla obsługiwanego węzła zdarzeń, OSTRZ. dla nieaktualnej reguły udev z przyciskiem „Napraw…” oraz NIE ZALICZONO dla fizycznego urządzenia. Sekcja Wsparcie → Kontrole stanu pokazuje wynik ZALICZONO dla obsługiwanego węzła zdarzeń, OSTRZ. dla nieaktualnej reguły udev z przyciskiem „Napraw…” oraz NIE ZALICZONO dla fizycznego urządzenia.
Rysunek 2. Sekcja Wsparcie → Kontrole stanu pokazuje wynik ZALICZONO dla obsługiwanego węzła zdarzeń, OSTRZ. dla nieaktualnej reguły udev z przyciskiem „Napraw…” oraz NIE ZALICZONO dla fizycznego urządzenia.

Sprzęt

Dawne ustawienia sprzętu ze strony „Wsparcie” mają teraz osobny obszar. Do odizolowanych testów efektów używaj funkcji „Lot testowy”, a do trwałych ustawień fizycznego urządzenia — strony „Sprzęt”. Otwórz przewodnik po sprzęcie.

Sprzęt → Kalibracja — sprawdź kierunek pochylenia i przechylenia, polaryzację sił oraz ewentualnie potrzebną zamianę osi. Sprzęt → Kalibracja — sprawdź kierunek pochylenia i przechylenia, polaryzację sił oraz ewentualnie potrzebną zamianę osi.
Rysunek 3. Sprzęt → Kalibracja — sprawdź kierunek pochylenia i przechylenia, polaryzację sił oraz ewentualnie potrzebną zamianę osi.

Układ kontroli

Każdy wiersz kontroli składa się z czterech części:

  • Status — ZALICZONO (zielony), INFO (niebieski), OSTRZ. (bursztynowy), NIE ZALICZONO (czerwony), GOTOWE / SPRAWDZANIE (neutralny) lub N/D, gdy wiersz nie dotyczy tej platformy.
  • Tytuł — co jest sprawdzane.
  • Szczegóły — jednowierszowe podsumowanie wyniku. Najedź kursorem (lub dotknij na ekranie dotykowym), aby zobaczyć pełne szczegóły.
  • Przycisk akcji — pojawia się tylko wtedy, gdy można coś zrobić. Przykłady: Zainstaluj wpis lokalny, Użyj portu 5111, Napraw….

Kontrole

Urządzenie joysticka FFB

Potwierdza, że obsługiwany joystick force feedback jest widoczny dla systemu operacyjnego i że most może go otworzyć na wyłączność. Kontrola kończy się niepowodzeniem, jeśli nie ma żadnego obsługiwanego VID/PID lub jeśli uchwyt jest zajęty przez inny proces.

Linux Reguła udev

Kontrole stanu sprawdzają, czy /etc/udev/rules.d/71-ffb-bridge.rules obejmuje każdy aktualny wiersz wejścia obsługiwanych urządzeń, uprawnienia TTY dla MOZA oraz dostęp hidraw używany przez Logitech G940 i bazy Brunner. „Napraw…” wyświetla podgląd kanonicznej, wyselekcjonowanej reguły, instaluje ją przez pkexec, usuwa dawną regułę 99-ffb-bridge.rules, przeładowuje udev i wyzwala zdarzenia dla urządzeń wejściowych, TTY i hidraw. Podłączony joystick spoza listy, dopuszczony przez ciebie do obsługi, jest dopisywany podczas instalacji.

Starsza reguła jest zgłaszana jako OSTRZ., gdy brakuje w niej aktualnego uprawnienia urządzenia, np. wierszy TTY dla MOZA lub dostępu hidraw używanego przez Logitech G940 i bazy Brunner, albo gdy jej nazwa pliku sprawia, że jest stosowana zbyt późno, by zapewnić dostęp w sesji pulpitu, jak w przypadku dawnego pliku 99-ffb-bridge.rules. Użyj opcji „Napraw…”, nawet jeśli plik już istnieje; aplikacja instaluje pełną wygenerowaną regułę jako 71-ffb-bridge.rules i usuwa dawny plik.

Po udanej naprawie reguła jest aktywna, a aplikacja zaleca ponowne uruchomienie. „Uruchom ponownie teraz” otwiera joystick ponownie z nowymi uprawnieniami i porzuca wszelkie rozwiązania zapasowe użyte przy uruchomieniu; wybór „Uruchomię ponownie później” jest bezpieczny, gdy najpierw musisz kontynuować pracę.

Okno dialogowe naprawy w systemie Linux pokazuje podgląd kanonicznej reguły wejścia obsługiwanych urządzeń i TTY dla MOZA, zanim poprosi o uprawnienia. Podłączony, dopuszczony joystick spoza listy jest dopisywany podczas instalacji. Okno dialogowe naprawy w systemie Linux pokazuje podgląd kanonicznej reguły wejścia obsługiwanych urządzeń i TTY dla MOZA, zanim poprosi o uprawnienia. Podłączony, dopuszczony joystick spoza listy jest dopisywany podczas instalacji.
Rysunek 4. Okno dialogowe naprawy w systemie Linux pokazuje podgląd kanonicznej reguły wejścia obsługiwanych urządzeń i TTY dla MOZA, zanim poprosi o uprawnienia. Podłączony, dopuszczony joystick spoza listy jest dopisywany podczas instalacji.
Po udanej naprawie reguła jest aktywna, a aplikacja zaleca ponowne uruchomienie. „Uruchom ponownie teraz” otwiera joystick ponownie z nowymi uprawnieniami i porzuca wszelkie rozwiązania zapasowe użyte przy uruchomieniu; wybór „Uruchomię ponownie później” jest bezpieczny, gdy najpierw musisz kontynuować pracę. Po udanej naprawie reguła jest aktywna, a aplikacja zaleca ponowne uruchomienie. „Uruchom ponownie teraz” otwiera joystick ponownie z nowymi uprawnieniami i porzuca wszelkie rozwiązania zapasowe użyte przy uruchomieniu; wybór „Uruchomię ponownie później” jest bezpieczny, gdy najpierw musisz kontynuować pracę.
Rysunek 5. Po udanej naprawie reguła jest aktywna, a aplikacja zaleca ponowne uruchomienie. „Uruchom ponownie teraz” otwiera joystick ponownie z nowymi uprawnieniami i porzuca wszelkie rozwiązania zapasowe użyte przy uruchomieniu; wybór „Uruchomię ponownie później” jest bezpieczny, gdy najpierw musisz kontynuować pracę.
Wyjątek dla NixOS

Karta „Kontrole stanu” wykrywa system NixOS (sprawdzając obecność /etc/NIXOS) i zastępuje wiersz reguły udev instrukcją, by zamiast tego dodać regułę do pliku configuration.nix systemu NixOS. Zobacz stronę Instalacja — tam znajdziesz odpowiedni fragment kodu.

WindowsLinux Konfiguracja MSFS SimConnect

SimConnect służy do połączenia z MSFS, więc ta kontrola działa w systemach Windows i Linux. Szuka pliku SimConnect.xml używanego przez MSFS w lokalizacji właściwej dla platformy, analizuje go i porównuje wszystkie włączone wpisy IPv4 z portem używanym przez most. Możliwe są trzy wyniki:

  • Znaleziono pasujący wpis. Zielony — nic nie trzeba robić.
  • Wpis z innym portem. Bursztynowy — dostępny jest przycisk Użyj portu :X do przełączenia na ten port.
  • Brak użytecznego wpisu (lub pliku nie da się przetworzyć). Czerwony — dostępny jest przycisk Napraw… otwierający okno instalacji (zobacz niżej).
W systemie Linux używany jest port nieuprzywilejowany

MSFS dostarcza domyślny wpis SimConnect na porcie 500. W systemie Windows powiązanie tego portu działa bez problemu i most z niego korzysta. W warstwie Proton w systemie Linux proces w przestrzeni nazw użytkownika nie może powiązać portów poniżej 1024, dlatego most instaluje i wykorzystuje równoległy wpis na porcie nieuprzywilejowanym (domyślnie 5111), który MSFS działający w warstwie Proton faktycznie może powiązać — właśnie dlatego poprawka dla systemu Linux i akcja Użyj portu wskazują na ten wyższy port.

Osiągalność MSFS

Sprawdza skonfigurowany port TCP. Wysyła prawdziwy pakiet SimConnect OPEN i analizuje nagłówek odpowiedzi, dzięki czemu potrafi odróżnić stan MSFS nasłuchuje od nasłuchuje coś innego.

Osiągalność X-Plane

Połączenie z X-Plane jest dostępne w systemach Windows, Linux i macOS na Apple Silicon. Ta kontrola wysyła zapytanie RREF na adres 127.0.0.1:49000 i krótko czeka na odpowiedź w postaci datarefu. Zarówno przekroczenie limitu czasu, jak i błąd Winsock WSAECONNRESET (zgłaszany po dostarczeniu komunikatu ICMP port-unreachable) są traktowane jako „nie działa”.

Stan środowiska działania

Podsumowuje bieżący stan urządzenia, źródła danych, telemetrii i wyjątków. ZALICZONO oznacza, że urządzenie jest otwarte, a potok zasilają dane z symulatora na żywo lub z symulatora testowego; INFO oznacza, że urządzenie jest otwarte bez danych z symulatora na żywo, co jest oczekiwane, gdy symulator jest zamknięty; NIE ZALICZONO oznacza, że urządzenie nie jest otwarte.

Raport awarii

Jeśli poprzednia sesja zakończyła się awarią, FFB-Bridge przy następnym uruchomieniu wyświetla okno raportu awarii zamiast wiersza na karcie „Kontrole stanu”. Przycisk Kopiuj kopiuje zapisany ślad stosu, a przycisk Otwórz formularz opinii otwiera stronę opinii w przeglądarce, gdzie możesz wkleić dziennik i dołączyć pakiet diagnostyczny.

Okno naprawy

Napraw… — te przyciski nie wprowadzają zmian bezpośrednio, lecz otwierają okno dialogowe, które dokładnie pokazuje, co i gdzie zostanie zmienione oraz (w systemie Linux) na co poprosi o zgodę okno uwierzytelniania.

Okno naprawy przy instalacji konfiguracji SimConnect. Wyświetla dokładny fragment XML, który zostanie dodany, wraz z podglądem pliku wynikowego. Okno naprawy przy instalacji konfiguracji SimConnect. Wyświetla dokładny fragment XML, który zostanie dodany, wraz z podglądem pliku wynikowego.
Rysunek 6. Okno naprawy przy instalacji konfiguracji SimConnect. Wyświetla dokładny fragment XML, który zostanie dodany, wraz z podglądem pliku wynikowego.

Okno dialogowe zawsze tylko dodaje: istniejące wpisy nigdy nie są nadpisywane. Jeśli pliku docelowego nie da się przetworzyć, okno wyjaśnia, że najpierw zostanie utworzona kopia zapasowa ze znacznikiem czasu. „Anuluj” to zawsze bezpieczny wybór.

Działanie pkexec w systemie Linux

Akcje zapisujące w ścieżkach systemowych (reguły udev, wszystko w katalogu /etc) są wykonywane przez pkexec. Zobaczysz standardowy monit polkit twojej dystrybucji — ten sam, który pojawia się przy uruchamianiu gparted lub graficznego menedżera pakietów. Kody wyjścia interpretowane przez kartę „Kontrole stanu”:

Kod wyjściaZnaczenieKomunikat kontroli stanu
0SukcesZielony znacznik; wiersz jest sprawdzany ponownie.
126Użytkownik zamknął okno uwierzytelnianiaBursztynowy komunikat „Anulowano” — spróbuj ponownie w dogodnej chwili.
127Brak agenta polkit / błąd uwierzytelnianiaCzerwony komunikat „Uwierzytelnianie nie powiodło się.”
Wskazówka

Uruchamianie mostu w minimalnym środowisku (Linux bez środowiska graficznego, sway bez agenta polkit) jest w porządku — nie możesz jedynie korzystać z uprzywilejowanych napraw na stronie „Wsparcie”. Zainstaluj wymagane pliki ręcznie lub włącz agenta polkit, zanim uruchomisz most.

Gdy wszystkie kontrole są zielone

Aplikacja powinna działać. Jeśli tak nie jest, przejdź na kartę Diagnostyka — jej dziennik zdarzeń pokaże więcej szczegółów niż jednowierszowe statusy na karcie „Kontrole stanu”. Możesz też przejść na stronę Rozwiązywanie problemów — znajdziesz tam typowe objawy i rozwiązania.

Jeśli masz MSFS 2020 i 2024 lub kilka instalacji, przed naprawą potwierdź każdy wskazany z nazwy cel konfiguracji. Naprawa aktualizuje konfigurację wybranego symulatora; następnie uruchom ten symulator ponownie. Ustawienie w sekcji Ustawienia → Sesja określa, który symulator Bridge wybierze przy następnym uruchomieniu.

Poprzednia Symulator testowy Następna Diagnostyka