지원 페이지

지원 페이지는 문서, 상태 확인, 진단, 로그 및 지원 번들 내보내기를 위한 단일 홈입니다. 이제 물리적 장치 구성이 하드웨어 아래에 있습니다.

탭 스트립

지원 페이지가 다음에서 열립니다. 리소스 탭 — 문서 + 수동 링크 + 환영 투어 재생이 친근한 첫 번째 착륙으로 거기에 있습니다. 다른 두 탭은 한 번의 클릭으로 가능합니다.

리소스 (먼저 열림) — 여기에 호스팅된 문서 및 매뉴얼과 환영 투어 재생 및 출판사/법률 페이지에 대한 링크입니다.
상태 확인 — 일상적인 심사 표면(장치, Linux의 udev 규칙, SIM 연결 가능성, 런타임 상태). 클릭 검사 실행 을 탐색합니다.
진단 — 런타임 지표, 검색 가능한 이벤트 로그 및 원클릭 지원 번들 내보내기. 에 별도로 기재되어 있습니다. 진단 탭 페이지입니다.

장치 선택, 방향 교정, 검증된 렌더링, 강도 제한 및 제어 할당이 실시간으로 수행됩니다. 하드웨어.

상태 확인 탭

상태 확인은 문제가 있을 때 대부분의 테스터에게 필요한 경로입니다. 클릭 검사 실행 브리지 상태를 조사합니다. 행은 독립적으로 업데이트되므로 느린 시뮬레이션 프로브는 장치 또는 런타임 결과가 나타나는 것을 차단하지 않습니다.

PASS 는 브리지가 설정의 해당 부분을 확인했음을 의미합니다.
정보 아무 문제가 없다는 뜻이지만 행에 유용한 컨텍스트가 있습니다. 예를 들어, MSFS를 비행하거나 모의 모드를 사용할 때 X-Plane이 수신하지 못하는 것이 예상됩니다.
경고 설정을 계속할 수 있지만 수정하거나 보고할 만한 문제가 있음을 의미합니다.
실패 브리지가 차단성 문제를 발견했음을 의미합니다. 상태 확인에서 안전한 수정 방법을 알고 있으면 해당 행에 작업 버튼이 표시됩니다.
준비됨 그리고 확인 중 은 실행 전과 실행 중에 사용되는 중립 상태입니다.

자동 장치 시작 전 검사

시작할 때 FFB-Bridge는 Windows, Linux, macOS의 장치 백엔드를 조용히 검사합니다. Linux에서는 지원 이벤트 노드의 읽기/쓰기 권한과 설치된 udev 규칙이 현재 필요한 모든 장치 권한을 포함하는지도 검사합니다. WARN 또는 FAIL이 있으면 각 문제를 표시하는 비차단 검토 및 수정 배너가 나타납니다.

모든 검사를 통과하면 아무 창도 열리지 않습니다.
시작 시에는 시뮬레이터나 네트워크를 검사하지 않습니다. 시뮬레이터가 닫혀 있는 것은 정상이며 실행 중에 처리됩니다.
대화 상자가 열려 있는 동안 Auto-arm은 대기합니다. 문제를 검토하고 수정하거나 장치를 의도적으로 분리한 경우 닫을 수 있습니다. 닫은 뒤에도 나머지 전제 조건을 통과해야 Auto-arm이 계속됩니다.

Figure 2. Support → Health에는 지원 event node의 PASS, 오래된 udev 규칙의 WARN과 Fix, 물리 장치의 FAIL이 표시됩니다.

하드웨어

이전 지원 페이지 하드웨어 컨트롤에는 이제 전용 영역이 있습니다. 격리 효과 테스트에는 Flight Check를 사용하고 지속적인 물리적 장치 설정에는 하드웨어를 사용하십시오. 하드웨어 가이드 열기.

Figure 3. Hardware → Calibration(보정) — 피치와 롤 방향, 포스 극성, 필요한 축 교체를 확인합니다.

검사 항목 배치 방식

모든 확인 행은 네 부분으로 구성됩니다.

상태 — PASS(녹색), INFO(파란색), WARN(황색), FAIL(빨간색), READY / CHECKING(중립) 또는 행이 이 플랫폼에 적용되지 않는 경우 N/A입니다.
제목 — 무엇을 확인하고 있는지.
세부정보 — 발견된 내용을 한 줄로 요약합니다. 전체 세부정보를 보려면 마우스로 가리키거나 터치하세요.
액션 버튼 — 실행 가능한 항목이 있는 경우에만 표시됩니다. 예: udev 규칙 설치, 사용 포트: 5111, 수정….

검사

장치

지원되는 포스 피드백 조이스틱이 OS에 표시되고 브리지가 이를 단독으로 열 수 있는지 확인합니다. 지원되는 VID/PID가 없거나 다른 프로세스가 핸들을 점유하고 있으면 실패합니다.

Linux udev 규칙

Health checks는 /etc/udev/rules.d/99-ffb-bridge.rules에 현재의 모든 지원 장치 입력 행과 MOZA TTY 권한이 포함되는지 검사합니다. Fix는 관리되는 표준 규칙을 보여 주고 pkexec로 설치한 다음 udev를 다시 로드하고 입력 및 TTY 장치를 트리거합니다. 연결되고 명시적으로 활성화된 미등록 조이스틱은 설치 중 추가됩니다.

이벤트만 포함한 이전 규칙은 현재 MOZA TTY 권한이 없으므로 WARN으로 보고됩니다. 파일이 이미 있어도 Fix를 사용하십시오. 앱이 전체 생성 규칙으로 교체합니다.

수정에 성공하면 규칙이 활성화되고 앱에서 재시작을 권장합니다. 지금 재시작은 새 권한으로 조이스틱을 다시 열고 시작 시 대체 경로를 해제합니다. 먼저 계속해야 한다면 나중에 재시작해도 안전합니다.

Figure 4. Linux 수정 대화 상자는 권한을 요청하기 전에 지원 장치용 표준 입력 및 MOZA TTY 규칙을 보여 줍니다. 연결되고 명시적으로 활성화된 미등록 조이스틱은 설치 중 추가됩니다.

Figure 5. 수정에 성공하면 규칙이 활성화되고 앱에서 재시작을 권장합니다. 지금 재시작은 새 권한으로 조이스틱을 다시 열고 시작 시 대체 경로를 해제합니다. 먼저 계속해야 한다면 나중에 재시작해도 안전합니다.

NixOS 예외

상태 점검은 NixOS를 감지합니다(다음을 검색하여). /etc/NIXOS) udev-rule 행을 규칙을 추가하는 명령으로 대체합니다. configuration.nix 대신. 참조 설치 스니펫의 경우.

WindowsLinux SimConnect 구성

SimConnect는 MSFS 경로이므로 이 검사는 Windows 및 Linux에서 실행됩니다. MSFS를 찾습니다. SimConnect.xml 플랫폼에 적합한 위치에서 이를 구문 분석하고 활성화된 IPv4 항목을 브리지가 사용하는 포트와 비교합니다. 세 가지 가능한 결과:

일치하는 항목을 찾았습니다. 녹색 – 할 일이 없습니다.
다른 포트의 항목. Amber — 다음을 제공 사용 포트 :X 해당 포트를 채택하려면 버튼을 누르세요.
사용할 수 있는 항목(또는 구문 분석할 수 없는 파일)이 없습니다. 빨간색 — 제공 수정… 설치 대화 상자를 여는 버튼(아래 참조)

Linux는 권한이 없는 포트를 사용합니다.

MSFS는 기본 SimConnect 항목을 500번 포트에 제공합니다. Windows에서는 정상적으로 바인딩되며 브리지는 이를 사용합니다. Linux의 Proton에서는 사용자 네임스페이스 프로세스가 1024 미만의 포트를 바인딩할 수 없으므로, 브리지는 Proton 환경의 MSFS가 실제로 바인딩할 수 있는 비특권 포트(기본값 5111)에 병렬 항목을 설치하고 사용합니다. 이것이 바로 Linux 수정 사항과 포트 사용 해당 상위 포트의 작업 지점입니다.

SimConnect 연결 가능성

구성된 TCP 포트를 조사합니다. 실제 SimConnect OPEN 패킷을 보내고 응답 헤더를 검사하여 구별할 수 있습니다. MSFS가 듣고 있습니다 에서 뭔가 다른 게 듣고 있어.

X-Plane 접근성

X-Plane 경로는 모든 플랫폼에서 작동하며 macOS(Apple Silicon)에서는 SideWinder FFB2가 포함된 X-Plane 12가 지원되는 조합입니다. 이 검사는 작은 RREF 프로브를 다음으로 보냅니다. 127.0.0.1:49000 응답으로 dataref를 잠시 기다립니다. 시간 초과와 Winsock을 모두 매핑합니다. WSAECONNRESET (ICMP 포트에 연결할 수 없는 것이 전달되었을 때 수신됨)을 "실행되지 않음"으로 설정합니다.

런타임

제어 루프가 목표 50Hz에서 작동하는지 확인합니다. 마지막 60초의 평균이 45Hz 아래로 떨어지면 경고합니다.

충돌 로그

마지막 세션의 충돌 로그가 있는 경우 행이 황색으로 바뀌고 다음을 제공합니다. 표시 파일 관리자에서 해당 항목으로 이동하고 피드백 양식을 통해 보내기 로그가 첨부된 피드백 제출을 미리 채웁니다.

수정 대화 상자

수정… 버튼은 변경 사항을 직접 적용하지 않습니다. 변경하려는 내용, 위치 및 (Linux의 경우) 인증 프롬프트에서 승인을 요청하는 내용을 정확하게 보여주는 대화 상자가 열립니다.

Figure 6. SimConnect 구성 설치 대화 상자를 수정했습니다. 추가할 정확한 XML 조각이 결과 파일의 미리보기와 함께 표시됩니다.

대화는 항상 가산: 기존 항목을 덮어쓰지 않습니다. 대상 파일을 구문 분석할 수 없는 경우 타임스탬프가 지정된 백업이 먼저 수행된다는 대화 상자가 설명됩니다. 취소는 항상 안전한 선택입니다.

Linux pkexec 동작

시스템 경로(udev 규칙, 아래의 모든 항목)에 쓰는 작업 /etc) 경로를 통해 pkexec. 배포판의 일반 폴킷 프롬프트가 표시됩니다. gparted 또는 패키지 관리자 GUI. 상태 확인이 해석하는 종료 코드:

종료	의미	상태 확인 보고서
`0`	성공	그린 체크; 행이 재평가됩니다.
`126`	사용자가 인증 프롬프트를 닫았습니다	황색 "취소됨" — 준비되면 다시 시도하세요.
`127`	Polkit 에이전트 없음/인증 실패	빨간색 “인증에 실패했습니다.”

팁

최소 환경(헤드리스 Linux, 폴킷 에이전트 없이 sway)에서 브리지를 실행하는 것은 괜찮습니다. 단지 지원 페이지의 권한 있는 수정 사항을 사용할 수는 없습니다. 필요한 파일을 수동으로 설치하거나 브리지를 시작하기 전에 polkit 에이전트를 시작하십시오.

모든 체크가 녹색일 때

앱이 작동해야 합니다. 그렇지 않은 경우 다음으로 전환하십시오. 진단 탭 — 해당 이벤트 로그에는 상태 확인의 한 줄 상태보다 더 자세한 내용이 표시됩니다. 아니면 다음으로 이동하세요. 문제 해결 일반적인 증상 및 해결 방법은 다음과 같습니다.