제1장이 설명서에 대하여
이 설명서는 Windows 10+, 최신 Linux 및 macOS(Apple Silicon)에서 Microsoft Flight Simulator(2024 및 2020)와 X-Plane 11 / 12로부터 Force Feedback 조이스틱을 구동하는 사용자 공간 브리지 FFB-Bridge를 다룹니다. MSFS는 SimConnect TCP로 연결되고 X-Plane은 UDP로 연결되며, 시작 시 활성 시뮬레이터가 자동으로 감지됩니다. 다섯 가지 스틱 제품군이 검증되었고 테스트된 환경에서는 plug-and-play로 동작합니다: Microsoft SideWinder Force Feedback 2, Windows/Linux/macOS의 MOZA AB9 + MH16, Logitech Flight System G940, Logitech Force 3D Pro, Logitech WingMan Force 3D. 다른 Force Feedback 조이스틱은 실험적으로 활성화할 수 있습니다(2장). macOS 빌드는 SideWinder FFB2 및 MOZA AB9 + MH16으로 X-Plane 12를 사용하는 범위로 제한됩니다. MSFS 플랫폼은 여전히 Windows와 Linux입니다. 페이지별 매뉴얼의 단일 파일 버전 위치: FFB-Bridge.com/docs — 동일한 내용을 처음부터 끝까지 읽고 PDF로 인쇄할 수 있도록 구성되었습니다.
OS 칩 Windows,
Linux, 그리고
둘 다 하나의 플랫폼에만 적용되는 단락을 표시하십시오. 메뉴와 버튼이 들어있어요
굵게; 파일 이름과 바로 가기는
code.
제2장설치
검증된 플러그 앤 플레이 Force Feedback 조이스틱: v1.2.1: Microsoft SideWinder Force Feedback 2 (045E:001B), MOZA AB9 + MH16 (346E:1000 / 346E:1002, Windows, Linux, and macOS), Logitech Flight System G940 (046D:C287), Logitech Force 3D Pro (046D:C286), 그리고 Logitech WingMan Force 3D (046D:C283). MOZA 또는 Logitech 스틱을 보유한 경우 설치 후 Support 페이지의 Health checks를 실행하고 장치별 특이점이 나타나면 피드백을 보내 주세요.
MOZA Cockpit의 텔레메트리 모드는 MOZA 자체의 시뮬레이터 연동 텔레메트리 경로용입니다. 일반 기본 모드가 아니며, 독립 실행형 하드웨어 테스트 중에는 베이스가 움직이지 않을 수 있습니다. AB9이 감지되지만 아무 동작도 하지 않으면 MOZA Cockpit을 일반/기본 모드로 되돌린 뒤 다시 시도하십시오.
이러한 검증된 장치 외의 다른 Force Feedback 조이스틱은 다음에서 옵트인하여 활성화할 수 있습니다. 설정 → 하드웨어 → 미등록 장치 허용(실험적). 그런 다음 브리지는 안전한 기본값, 라이브 반전 및 피치/롤 스왑 교정을 통해 방향을 고정하고 충돌 복구를 안전망으로 사용하여 적합한 조이스틱급 장치를 구동합니다. 바퀴, 게임 패드 및 단일 축 장치는 비행 스틱으로 구동할 수 없으며 다음 위치에서 FFB 프로브로 라우팅됩니다. ffb-probe.com 대신.
2.1 윈도우 설치 프로그램
홈 페이지에서 가입한 후 이메일로 전송된 다운로드에 있는 Windows 링크를 클릭하세요. 저장 FfbBridge-Setup-x64.exe
를 더블클릭하세요. 설치 프로그램은 Rohsam 게시자 ID로 코드 서명됩니다. 새로 서명된 빌드에는 여전히 SmartScreen 평판 프롬프트가 표시될 수 있습니다. 게시자가 다음인지 확인하세요.
Rohsam Inc. 또는 Rohsam Inc 계속하기 전에.
Inno 설치 마법사는 다음 위치에 설치됩니다.
%LOCALAPPDATA%\Programs\FfbBridge 기본적으로. 관리자 권한이 필요하지 않습니다. 이는 사용자별 설치입니다. 시작 메뉴 바로가기는 FFB-Bridge 그룹에 있습니다.
제거하려면 다음을 엽니다. 앱 및 기능, FFB-Bridge를 찾아 선택 제거. 귀하의 프로필은 다음과 같습니다. %APPDATA%\ffb-bridge 나중에 다시 설치할 수 있도록 보관됩니다. 완전히 초기화하려면 해당 폴더를 제거하십시오.
2.2 리눅스 앱이미지
이메일로 전송된 링크에서 AppImage를 저장하고 실행 가능하게 만든 후 AppImage가 사용자 범위 데스크톱 항목을 설치하도록 합니다.
chmod +x FfbBridge-1.0.0-x86_64.AppImage
./FfbBridge-1.0.0-x86_64.AppImage --install
는 --install 플래그는 AppImage를 다음에 복사합니다.
~/Applications, 을 쓴다 .desktop
런처와 아이콘을 XDG 데이터 디렉토리에 추가하고 가능한 경우 데스크탑 캐시를 새로 고칩니다. 다음을 사용하여 실행기와 아이콘을 제거합니다. --uninstall; 파일이 더 이상 필요하지 않으면 AppImage를 수동으로 삭제하세요.

2.3 macOS (애플 실리콘)
macOS FFB-Bridge는 Apple Silicon(M1 이상)용으로 서명 및 공증된 DMG를 제공합니다. DMG를 열고 다음으로 드래그하세요. FFB-Bridge Applications 폴더로 이동하세요. 빌드는 Rohsam Inc. Developer ID로 서명되고 stapled 처리되어 Gatekeeper가 “확인되지 않은 개발자” 프롬프트 없이 엽니다. macOS 빌드는 Microsoft SideWinder Force Feedback 2 및 MOZA AB9 + MH16으로 X-Plane 12를 사용하는 범위로 제한됩니다.
2.4 udev 규칙(Linux)
브리지가 시작할 때마다 폴킷 프롬프트 없이 스틱을 열 수 있도록 다음 udev 규칙을 설치하십시오. 는
지원 페이지에는 다음을 사용하는 원클릭 설치 프로그램이 있습니다. pkexec 그것을 쓰다; 수동으로 설치할 수도 있습니다.
# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
NixOS에서는 다음 위치에 추가하세요. configuration.nix 아래
services.udev.extraRules, 그러면
sudo nixos-rebuild switch 그리고 스틱을 다시 꽂으세요.
제3장첫 출시
첫 번째 실행 흐름은 연속적인 3가지 모달입니다: 물리적 위험 안전 확인, 그런 다음 환영 둘러보기, 대시보드를 차례로 선택하세요. 안전 모달은 "이해합니다" 확인란을 선택할 때까지 닫기를 차단합니다. 환영 화면은 건너뛸 수 있으며 나중에 도움말 페이지에서 다시 볼 수 있습니다.




장치가 감지되고 상단 스트립의 무장 게이지가 표시된 상태로 대시보드가 열립니다. 무장 해제됨. 명시적으로 무장하기 전까지는 힘이 스틱에 전달되지 않습니다. 창 상단을 가로지르는 스트립은 운영 조종석입니다: 브랜드 블록, ARM 게이지(가운데, 시각적 핵심 요소), Sim · 장치 · 모드 램프, 그리고 오른쪽의 프로필 선택기 + 튜닝/저장 버튼. 실시간 비행 수치(IAS, G, Mach, 피치/롤 포스, 데이터 경과 시간, 틱 레이트)는 콘텐츠 영역 하단을 따라 얇은 띠에 표시됩니다.


창에서는 최소화, 최대화, 닫기, 크기 조정에 일반 운영 체제 컨트롤을 사용합니다. 닫기 동작은 여전히 아래의 트레이 동작을 따릅니다.
스트립의 ARM 게이지를 클릭하여 무장하세요. 게이지에는 세 가지 상태가 있습니다. 무장 해제됨 (따뜻한 테두리, 중립 글리프), 무장 (호박색 그라디언트 + 밝은 글리프), 오류가 발생했습니다. (빨간색 - § 3.4 참조)
Esc 확인하기 전에 마음이 바뀌면 arm 확인 대화 상자가 취소됩니다. 다른 전역 키보드 단축키는 없습니다. 브리지는 설계상 마우스/트레이 구동 방식입니다.


안전. 첫 번째 암은 스틱을 트림된 중앙 위치로 스냅합니다. 암 시에는 손, 케이블, 책상 위의 헐거운 물건 등 그 무엇도 스틱 위에 놓이거나 기대어 있지 않도록 하십시오.
3.4 오류 복구
무장한 상태에서 전제조건이 떨어지면(가장 자주 스틱이 뽑히거나 심이 충돌하는 경우) 게이지가 다음으로 전환됩니다. 오류가 발생했습니다. 그리고 힘이 멈춘다. 일치하는 램프가 빨간색으로 바뀌므로 원인은 분명합니다. 플러그를 뽑으려면 DEVICE, SIM 드롭은 SIM입니다. 게이지를 클릭하여 확인하고 다시 재설정하세요. 무장 해제됨; 누락된 필수 구성 요소를 복원한 다음 다시 무장할 수 있습니다. 는 진단 열기 재설정하기 전에 전체 내용을 확인하려면 게이지 옆에 있는 링크를 클릭하여 지원 페이지의 진단 탭 이벤트 로그로 이동하세요.
창을 닫으면(X 버튼) 트레이로 숨길지 묻습니다. 선택하면 브리지는 계속 실행됩니다 트레이로 최소화. 트레이 메뉴를 사용하여 무장/해제/표시/종료합니다. 기본 GNOME Wayland와 같이 사용 가능한 트레이가 없는 데스크탑에서는 브리지가 닫히는 대신 숨기는 대신 바로 종료된다는 메시지를 표시합니다.

제4장MSFS 연결(2024 & 2020)
Microsoft Flight Simulator 2024와 2020은 모두 SimConnect TCP를 통해 FFB-Bridge와 통신하며 동일한 설정이 두 가지 모두에 적용됩니다. Windows에서는 이 기능이 즉시 작동합니다. Linux의 Proton에서는 기본 포트(500)를 바인딩할 수 없으며 지원 페이지의 상태 확인 탭에서 원클릭 수정을 통해 권한이 없는 병렬 포트를 추가합니다. (아래 경로는 MSFS 2024의 경로입니다. MSFS 2020은 이에 상응하는 경로를 사용합니다. Microsoft Flight Simulator 폴더(브릿지도 감지함)
4.1 SimConnect.xml이 있는 곳
파일 위치는 MSFS 설치 소스에 따라 다릅니다.
- Windows Steam
%APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml - Windows Store / Xbox
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml - Linux Steam + Proton
~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml
FFB-Bridge는 올바른 경로를 자동으로 감지합니다. 다음으로 재정의 FFB_BRIDGE_MSFS_CONFIG 또는
FFB_BRIDGE_MSFS_PREFIX 비표준 위치에서 MSFS를 실행하는 경우.
4.2 지원 페이지에서 원클릭 수정
열기 지원 페이지 → 상태 확인 탭. 는 SimConnect 구성 행에는 감지된 XML 경로와 브리지가 대상으로 삼는 포트가 표시됩니다. 세 가지 결과:
- 녹색 — 일치하는 항목을 찾았으나 수행할 작업이 없습니다.
- Amber 사용 포트 :X — 다른 포트로 들어오는 항목; 버튼이 이를 채택합니다.
- 빨간색 수정… - 사용 가능한 항목이 없습니다. 대화 상자에는 추가할 내용이 정확히 표시됩니다.


모든 수정 작업은 추가됩니다. 즉, 기존 항목을 덮어쓰지 않습니다. XML을 구문 분석할 수 없는 경우 타임스탬프가 지정된 백업이 먼저 수행됩니다.
제5장X-Plane 11 / 12 연결
제로 구성. X-Plane은 UDP RREF 구독을 수락합니다.
127.0.0.1:49000 기본적으로; FFB-Bridge는 실행 및 데이터 흐름을 구독합니다. 브리지를 시작할 때 X-Plane이 실행 중이면 상단 스트립의 SIM 램프가 밀리초 내에 녹색으로 변합니다.
3초 스테일 감시 기능은 UDP 연결 끊김 미감지 문제를 다룹니다. 3초 동안 데이터레프가 도착하지 않으면 SIM 램프가 빨간색으로 켜집니다. 새 비행을 로드하면 자동으로 재연결됩니다.
방화벽은 루프백을 거의 방해하지 않지만, 지원 페이지의 X-Plane 프로브가 빨간색이고 X-Plane이 실제로 실행되고 있는 경우 UDP 49000을 차단하는 방화벽이 있는지 확인하세요. 복구 흐름은 14장을 참조하세요.
제6장대시보드


작동 상태(arm, sim, 장치, 모드, 프로필)는 더 이상 이 페이지에 없습니다. 튜닝, 진단 또는 기타 다른 작업을 수행하는 동안에도 계속 표시되도록 영구 상단 스트립으로 이동했습니다. 대시보드는 시뮬레이션이 보고하는 내용, 활성화된 동적 채널, 스틱이 유지하는 기본 스프링 상태 등을 실시간으로 설명하는 화면입니다.
왼쪽 패널: 비행 상태. 대기 속도(kt), G-부하(g, 정상 범위를 벗어나면 황색으로 변함), Mach 세 가지 숫자 판독값이 한 줄로 표시되고, 그 아래에 엘리베이터와 에일러론 편향을 나타내는 BiBar 한 쌍이 있습니다. 막대 아래에는 엘리베이터 트림, 지상 상태, 실속 경고에 대한 더 작은 판독값이 있습니다. UI는 약 20Hz로 새로 고쳐집니다(50Hz 제어 루프를 솎아낸 표시).
왼쪽 패널 하단에는 다음 목록이 있습니다. 효과 그룹 토글: 스틱 느낌, 엔진 럼블, 기체 버핏, 그라운드 롤, 기계식 숄더, 축 부하, 자동 조종 추종. 각 행에는 체크박스, 실시간 상태, 간단한 레벨 바가 있습니다. 비행 중 A/B 비교를 위한 빠른 음소거로 사용하십시오. 효과별 게인은 튜닝 페이지에 유지됩니다. 토글 상태는 활성 프로필의 일부입니다.
오른쪽 패널: 스틱 활동. 헤드라인에는 가장 강력한 동적 기여 요소의 이름이 표시되고, 누적 막대 그래프는 이들을 계열별로 그룹화하며, 활성 채널 칩은 중요한 경우 개별 값을 표시합니다. 센터링 스프링은 기본 느낌으로 처리되므로 활성 목록은 그 기준 이상의 변화, 즉 트림 센터, G-부하 스프링 변화, 축 부하, 엔진 럼블, 그라운드 롤, 버핏 및 기계적 원샷에 중점을 둡니다. 축 부하 막대는 스프링 부하 기여도와는 다른 파란색을 사용하며, 센터링 스프링 섹션에는 계수, 불감대, 피치/롤 중심이 표시됩니다.
제7장튜닝


모든 슬라이더 변경 사항은 다음 50Hz 틱에 적용됩니다. 두 번째 모니터에 고정된 튜닝 페이지를 사용하여 효과가 진행되는 동안 효과를 조정할 수 있습니다.
7.1 마스터 게인
장치 출력단에 적용되는 단일 승수로, 0%에서 100%까지 백분율로 표시됩니다. 100%는 설계된 수준(및 기본값)입니다. 값이 낮을수록 센터링 스프링 계수, 대기 속도 포스, 럼블, 버핏, 지속 드래그, 원샷을 포함해 브리지가 보내는 모든 것이 감쇠됩니다. 0%는 포스 출력을 전혀 보내지 않습니다. 100%를 넘는 "부스트"는 없으며, 이 상한은 효과별 게인 슬라이더가 작동하는 한계입니다. 슬라이더 아래에서 브리지는 장치를 전체 권한의 95%로 구동하여 5%의 헤드룸을 남깁니다.


7.2 슬라이더 그룹
위에서 아래로: 센터링 스프링(베이스, 저속 플로어, G-게인, 최소/최대 클램프, 데드밴드) · 공력 로딩(피치 게인, 롤 게인) · 트림(하나의 트림 활성화 스위치, 엘리베이터 우선) · 스틱 느낌 (제어 시스템 느낌 선택기, 속도 감쇠, 제어 에지 보너스, 스틱 드롭) · 지상 효과(활주로 럼블, 터치다운 쿵, 기어 범프, 브레이크 셔더, 노즈휠 쉬미, 지면 가속도 피치 큐및 차대 유형 휠/스키/플로트 선택기) · 에어로 버핏(실속, 과속, 마하, 스포일러, 난류, 그리고 실속 스틱셰이커) · 동력 장치(엔진 럼블, 역추력 럼블) · 원샷(기어 전개, 플랩 스텝) · 자동 조종 장치(낮은 권한 AP 큐). 전체 참조 내용은 12장을 참조하세요.
7.3 스틱 드롭
스틱 드롭은 낮은 대기 속도에서 부하가 없는 엘리베이터에 작용하는 중력 편향을 모델링합니다 — 주기된 GA 항공기의 요크가 중앙보다 약간 앞쪽에 놓이게 하는 바로 그것입니다. 슬라이더 2개: 포스 (바이어스가 얼마나 세게 당기는지) 및 페이드 속도 (바이어스가 0으로 감쇠하는 kt). 기본값은 Cessna급입니다. 제트기나 플라이 바이 와이어 프로필에서 없애려면 Force를 0 쪽으로 낮추세요.
7.4 트림
트림은 하나의 스위치입니다. 트림 활성화, 튜닝 페이지 상단 근처. 그것으로 에, 트리밍은 유지된 대기 속도 부하 힘(에 대해 계산됨)을 완화합니다. (엘리베이터 - 트림)) 그리고 센터링 대상을 다듬어진 위치로 이동하므로 중립 스틱을 사용하여 다듬어진 안정된 상태에서 힘이 0에 가까워지고 스틱을 놓으면 다듬어진 위치에 고정됩니다. 이는 실제 케이블로 조작된 스틱이 작동하는 방식입니다. 그것으로 끄기, 트림은 스틱에 아무 작업도 수행하지 않습니다. 엘리베이터는 헤드라인 제어 장치입니다. 에일러론 트림 강도는 아래에 있습니다. 고급 공개 항목. (이전 빌드에는 트림이 꺼진 상태에서도 스틱을 계속 움직이는 두 번째 숨겨진 중앙 전용 트림 경로가 있었습니다. 이는 더 이상 사용되지 않으므로, 이제 “트림 활성화”를 끄면 실제로 트림이 꺼집니다.)
7.5 제어 시스템 느낌
상단에 항공기별 선택기가 있습니다. 스틱 느낌 그룹에는 세 가지 설정이 있습니다. 매뉴얼, 유압 부스트, 그리고 플라이 바이 와이어. 이는 실제 항공기의 제어 느낌과 일치하도록 기존 센터링 및 공력 로딩 힘을 조절합니다:
- 매뉴얼 (기본값) — 기계적/케이블 제어; 기본 느낌에는 변화가 없습니다.
- 유압 부스트 — 인공 감각(artificial-feel) 시스템처럼 공력 로딩을 제거하지 않으면서 부드럽게 완화합니다.
- 플라이 바이 와이어 — 공기 역학적 하중과 G 하중 강화를 억제하여 스프링 중심 사이드스틱과 일치합니다.
내장된 스타터는 이를 기체별로 설정합니다. GA 및 터보프롭 스타터는 수동이고, 747-8은 유압식이며, A320neo는 플라이 바이 와이어이므로 스타터를 선택하는 데 좋은 참조가 됩니다.
7.6 슬라이더 상호작용
엄지손가락을 드래그하고 트랙을 따라 아무 곳이나 클릭하여 그곳으로 이동하거나 한 번 클릭하여 초점을 맞춘 다음 휠/화살표 키를 사용합니다. 호버링과 스크롤링은 아니 휠을 캡처하세요. 슬라이더에 먼저 초점을 맞춰야 합니다. 이렇게 하면 마우스를 올리지 않고도 슬라이더를 지나 페이지를 스크롤할 수 있습니다.
7.7 더티 표시기 및 재설정
슬라이더가 로드된 프로필과 다르면 뒤로 화살표 글리프 재설정 해당 값 옆에 표시됩니다. 해당 슬라이더만 되돌리려면 클릭하세요. 각 섹션 헤더에는 섹션의 모든 슬라이더를 재설정하는 일치하는 문자 모양이 있습니다. 에이 폐기 프로필 카드의 버튼을 누르면 모든 것이 한 번에 되돌려집니다. 프로필 선택기의 황색 점은 "이 프로필에 저장되지 않은 변경 사항이 있습니다"를 요약합니다. 재설정은 로컬에서만 수행되며 저장된 프로필에는 영향을 주지 않습니다.


M을 넘어선 후퇴익 항공기의 고마하 버핏
저장 활성 프로필을 덮어씁니다. 다른 이름으로 저장… 새 이름으로 저장하는 대화 상자가 열립니다. 시작 프리셋은 읽기 전용입니다. 다른 이름으로 저장하면 계속 사용할 편집 가능한 항공기 프로필이 생성됩니다.
제8장프로필


저장된 프로필은 다음의 JSON 파일입니다. %APPDATA%\ffb-bridge\profiles\
(Windows) 또는 ~/.config/ffb-bridge/profiles/
(Linux, $XDG_CONFIG_HOME; macOS는 동일한 경로를 사용합니다). 각 파일은 하나의 프로필입니다. 컴퓨터 간에 파일을 복사하거나 파일을 이메일로 보내 다른 사람과 공유할 수 있습니다.
무료 커뮤니티도 있습니다 프로필 라이브러리 에 FFB-Bridge.com/profiles: 다른 사용자가 게시한 프로필을 찾아 다운로드하고(계정 필요 없음) 지구본에 자신의 프로필을 게시하세요. 공유 프로필 페이지의 작업. 공유는 제출 양식이 미리 채워진 채로 프로필을 라이브러리에 전달합니다. 게시하는 순간에만 로그인하며, 자동으로 업로드되는 것은 없고, 내장 스타터는 공유할 수 없습니다. 공유 프로필은 설명 메타데이터를 담고 최신 앱 버전으로 깔끔하게 마이그레이션되는 상위 호환 형식으로 이동합니다. 직접 손으로 복사한 일반 파일도 여전히 이전처럼 작동합니다. 커뮤니티 포럼은 다음 위치에 있습니다. FFB-Bridge.com/community.
스타터와 저장된 프로필은 하나의 목록을 공유합니다. 작업: 선택한 프로필 사용, 선택 항목 복제, 선택 항목 삭제, 그리고 새로고침. 시작 사전 설정은 읽기 전용입니다. 편집 가능한 사본을 얻으려면 복제 또는 다른 이름으로 저장을 사용하십시오.


내장 스타터는 MSFS 항공기의 이름을 따서 명명되었습니다: Cessna 172 Skyhawk (G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo 및 Boeing 747-8 Intercontinental. 프로필 전환은 해제 없이 다음 50Hz 틱에 적용됩니다. 튜닝의 프로필 선택기에는 저장되지 않은 변경 사항에 대해 황색 점이 표시됩니다. 다른 프로필을 불러오기 전에 저장하지 않으면 변경 사항이 삭제됩니다.
제9장지원 페이지 - 진단 탭




진단 탭은 더 깊은 분류 표면입니다. 4개의 상위 카드가 표시됩니다. 장치, 데이터 소스, 포스 출력, 그리고 로그 상태 자세히 살펴보기 전에 런타임 패널에는 현재 세션의 가동 시간, 데이터 수명, UI 텔레메트리 속도, 제어 루프 속도, 목표 속도, 활성/할당된 효과, 재확인 및 예외 횟수가 표시됩니다.
이벤트 로그는 검색 가능하며 수준별로 필터링됩니다. 정보, 경고, 오류 토글은 심각도별로 항목을 줄이고, 검색 상자는 모든 하위 문자열과 일치하며 사본 표시 는 현재 표시된 행을 정확하게 내보냅니다. 사용 전체 로그 복사 또는 전체 로그 내보내기... 지원에 전체 디스크 세션 로그가 필요한 경우.


는 지원 번들 버튼을 누르면 피드백 보고서용 단일 ZIP가 생성됩니다. 내보낸 후 탭에는 파일 이름, 크기, 피드백 양식 링크 및 파일 표시 데스크탑이 번들 위치를 열 수 있는 곳입니다. 전체 내용 목록은 15장을 참조하세요.


제10장상태 확인 및 하드웨어 설정


10.1 상태 확인
지원 페이지가 다음에서 열립니다. 상태 확인 탭입니다. 클릭 검사 실행 지원되는 조이스틱, MSFS SimConnect 구성 및 연결 가능성, X-Plane 연결 가능성 및 런타임 상태를 조사합니다. 행은 독립적으로 업데이트되고 PASS, INFO, WARN, FAIL, READY, CHECKING 및 N/A 상태를 사용하므로 실행되지 않는 시뮬레이터가 손상된 시뮬레이터와 혼동되지 않습니다.
수정 사항이 분명한 경우 행은 인라인 작업을 제공합니다. udev 규칙 설치, 사용 포트 :X, 수정…, 또는 표시. 수정 대화 상자에는 적용되기 전에 변경될 사항이 정확히 표시되며 기존 항목을 덮어쓰지 않습니다.


10.2 하드웨어 설정
설정 페이지의 하드웨어 탭이 호스팅합니다 축 극성 반전 및 라이브 드래그 패드 극성 테스트. FFB2의 다양한 생산 실행은 극성을 다르게 읽습니다. 테스트에서는 2축 드래그 패드에서 스틱을 실시간으로 구동하여 어떤 방식으로 작동하는지 확인합니다. 시작을 클릭하고 퍽을 이동한 다음 중지를 클릭하고 "스틱이 퍽을 따라갔나요?"라고 대답하세요. — 예는 변경되지 않으며, 아니요는 토글을 자동으로 뒤집습니다. 토글은 설치 수준이며 피치 및 롤 축을 함께 뒤집습니다.


10.3 소프트웨어 혼합 주기 효과
브리지에는 FFB2에 주기적 효과와 일회성 효과를 전달하는 두 가지 방법이 있습니다. 하드웨어 모드 — 새로 설치한 기본값 —은 SideWinder FFB2에서 직접 원시 HID/PID 포스 출력을 사용하고 DirectInput은 필요한 경우 호환성 폴백으로 유지됩니다. 현재 Windows 빌드에서는 벡터 상수 1개, 2축 스프링 1개, 지연 로딩되는 3슬롯 주기적 풀 등 토폴로지를 의도적으로 작게 유지합니다. 펌웨어는 여전히 기본 속도로 주기적인 파형을 구동합니다. 브리지는 활주로, 엔진, 버핏 및 원샷 큐에 이러한 물리적 슬롯을 재사용합니다. 소프트웨어 혼합 주기 효과, 동일한 설정 → 하드웨어 탭에서 연속 힘/센터링 하드웨어 경로만 유지하고 C#에서 200Hz의 주기적/일회성 큐를 합성하여 결과를 일정한 힘 출력으로 접습니다.
하드웨어 모드는 펌웨어가 브리지의 틱 속도보다 더 빠르게 구동하기 때문에 가장 높은 주파수 효과에서 더 선명하고 지연 시간이 더 낮습니다. 소프트웨어 블렌딩은 실패한 하드웨어 프로브, 분류된 하드웨어 효과 충돌 또는 의도적으로 이를 선호하는 사용자를 위한 호환성 대체 수단입니다. 일반적인 비정상 종료 자체로는 소프트웨어 블렌딩이 강제되지 않습니다. 고주파수 에지가 조금 더 부드러워질 수 있습니다. 어느 쪽이든 재시작이 필요합니다 — 디스패처는 시작 시 모드를 읽습니다. 사용 하드웨어 효과 테스트 별도의 작업자 프로세스에서 컴팩트 하드웨어 토폴로지를 안전하게 시도합니다.
시스템 경로를 작성하는 Linux 작업은 다음을 통해 라우팅됩니다.
pkexec. 종료 코드: 0 = 성공, 126 = 사용자가 프롬프트를 무시함, 127 = 인증 실패 / 폴킷 에이전트 없음.
제11장Mock Sim


Mock Sim은 힘 파이프라인을 위한 벤치 테스트 모드입니다. 페이지 상단의 눈에 띄는 행에서 Mock Sim을 활성화한 다음 상단 스트립의 일반 Arm 버튼을 사용하세요. Dashboard와 상태 스트립은 소스를 라이브 시뮬레이터가 아닌 데모로 표시합니다.
각 힘 계열이 스틱에서 분명히 느껴지도록 시나리오는 의도적으로 과장되어 있습니다: 이륙 활주, 브레이크 셔더, 난기류, 플랩 버핏, 스포일러 버핏, 실속 버핏, 과속 버핏, 레이트 댐핑. 이는 데모이며 조정된 항공기 프로필이 아닙니다.


직접 스틱 테스트는 스프링 센터를 직접 이동시킵니다. 점을 드래그하면 0 KIAS에서도 물리적 스틱이 점을 따라가야 합니다. 이는 비행 전에 포스 경로, 센터링 스프링, 극성을 확인하는 가장 빠른 방법입니다.
Mock Sim을 끄면 힘 출력이 중지되고 모든 mock 입력이 초기화되며 브리지가 Live로 돌아갑니다. 실제 시뮬레이터가 연결되어 있으면 라이브 텔레메트리만 소스로 유지되도록 설명 배너와 함께 페이지가 잠깁니다.


도움말도움말 및 둘러보기


도움말 페이지는 사이드바에 없습니다. 처음 시작할 때 자동으로 열리고 다음을 통해 언제든지 재생할 수 있습니다. 지원 → 리소스 → 재생 환영 투어. 탭으로 구성된 작업 허브입니다. 시작 설정 상태, get-flying 체크리스트, 권장 튜닝 순서 및 지원 번들 경로를 보여줍니다. 문제 해결 은 일반적인 증상을 그룹화하고 각 수정 사항이 포함된 페이지를 가리킵니다. 지원 진단 탭의 지원 번들 내보내기를 피드백 양식과 연결합니다. 리소스 온라인 문서, 인쇄 가능한 매뉴얼, 피드백, 개인 정보 보호 및 게시자/법률 리소스를 엽니다. 데스크탑 앱은 번들로 제공되는 PDF 설명서가 있으면 이를 사용하고, 로컬 파일을 사용할 수 없으면 온라인 설명서로 대체합니다.
설정설정


Settings는 항공기 튜닝이 아니라 설치 단위 기본 설정을 보관합니다. 일반 는 닫기 버튼 동작, 테마, 시각적 대비 (a 표준 / 고대비 강제 출력을 변경하지 않고 앱 전체(표면, 텍스트, 테두리, 버튼, 상태 램프 및 효과 그룹 색상)의 대비를 높이는 선택) 및 첫 실행 UI 재설정. 세션 옵트인 자동 무장(지원되는 장치와 라이브 시뮬레이터가 모두 준비된 경우) 및 자동 무장 해제(시뮬레이터가 종료될 때)를 제어합니다. 둘 다 기본값은 꺼짐입니다. 하드웨어 에는 포스 피드백 장치 선택기, 효과 렌더링 모드, Windows 장치 백엔드, 목록에 없는 장치 허용(실험단계) 옵트인 및 극성/피치-롤-스왑 축 테스트. 개인정보 및 진단 이 컴퓨터의 로컬 구성 및 진단 폴더를 열고 크래시 보고서나 로그 파일을 지웁니다.
제12장포스 효과 참조
포함된 효과: v1.2.1:
- 센터링 스프링 — G-부하에 따라 강해지고, 데드밴드는 대기 속도에 따라 스케일되며, 중심은 트림에 따라 이동합니다.
- 대기 속도에 따른 피치 힘 — 대기 속도² × 엘리베이터 오프셋으로 스케일되는 일정한 피치 축 포스.
- 대기 속도 하중을 받는 롤 포스 — 롤 축의 동일한 모델, 독립적으로 조정됨.
- 레이트 댐핑 — 기체 축 회전 속도(p, q)에 비례하는 반대 방향 포스; 점성 댐핑.
- 스틱 드롭 — 저속에서 엘리베이터에 작용하는 중력 편향; 주기 시 스틱을 앞으로 당기며, 페이드 대기 속도(기본값 30kt)에서 사라집니다.
- 자동조종장치 팔로우 — 오토파일럿의 플라이트 디렉터 기준을 향한 선택적 저권한 스프링 큐입니다. 현재 빌드에서는 기본적으로 꺼져 있습니다.
- 런웨이 럼블 — 지상 속도와 표면 유형(잔디 1.5–1.9×, 얼음 0.3–0.5×)에 따라 조정되는 연속 주기 힘.
- 터치다운 쿵 — 지상 접지 전환 시 단일 임펄스; 진폭은 수직 속도와 최대 타이어 하중에 따라 조정됩니다(부드럽게 안착한 착륙이 강하게 접지한 착륙보다 더 부드럽게 느껴집니다).
- 브레이크 셔더 — 브레이크 편향에 비례하는 저주파 럼블, 지상 게이트.
- 기어 범프 — ~40kt 이하로 택시 중 개별 충격.
- 에어로 버핏 — 버핏 생성기를 공유하는 7개의 하위 효과(실속, 과속, 마하, 스포일러, 플랩, 기어, 난기류).
- 엔진 럼블 — 보고될 때(터보프롭, 제트기) 시뮬레이터의 엔진별 진동 값을 사용하고, 시뮬레이터가 보고하지 않으면 합성된 RPM 램프로 대체합니다.
- 역추력 럼블 — 역추력이 작동할 때의 롤아웃 럼블이며, 지상 속도에 따라 조정됩니다.
- 기계적 원샷 — 모든 전환에서 양방향으로 발생하는 기어 전개 및 플랩 스텝 셔더.
- 지속적인 에어로 드래그 피치 힘 — 플랩 드래그, 스포일러 드래그, 기어 드래그 및 프로펠러 피치. 구성이 변경될 때 조종사가 느끼는 트림아웃을 반영하는 일정한 피치 바이어스입니다.
- 실속 스틱 셰이커 — 합성된 실속 뷔페와는 별도로 보완되는 심 자신의 실속 경고에 맞춰 날카롭고 연속적인 윙윙거리는 소리가 납니다. GA 스타터에서는 기본적으로 꺼져 있습니다. 더 빠른 시작을 위해 켜져 있습니다.
- 노즈휠 쉬미 — 그라운드 롤 중 빠른 좌우(롤 축) 진동으로 항공기별로 조정됩니다.
- 지면 가속도 피치 큐 — 그라운드 롤 중 가속도와 연결된 피치축 큐입니다.
항공기당 2대 변조기 자체 채널을 새로 추가하는 대신 위의 효과를 활용하세요. 는 제어 시스템 느낌 선택기(수동/유압 부스트/플라이 바이 와이어)는 항공기 제어 시스템(§ 7.5)에 맞게 공기 역학적 하중과 G-부하 스프링 보강을 조정합니다. 는 차대 유형 선택기(휠/스키/플로트)는 활주로 럼블, 기어 범프, 노즈휠 시미 등 연속적인 그라운드 롤 럼블의 크기를 조정합니다.
모든 것은 두 가지 출력(피치 + 롤 힘 및 스프링 매개변수)으로 합산됩니다. 마스터 게인은 스프링 계수를 포함한 모든 힘 출력에 대해 장치 출력 단에서 적용됩니다. 설치 수준의 피치/롤 극성 반전(설정 → 하드웨어)은 하드웨어가 극성을 반대로 읽는 경우 장치 출력 단에서 두 축을 함께 반전시킵니다. 대시보드는 기준 스프링을 활성 동적 채널과 분리하여 어떤 순간에 어떤 효과가 기여하는지 확인할 수 있게 해 줍니다.
트림 는 효과 1(센터링 스프링) 및 2/3(공기 속도 부하 피치/롤 힘)에 대한 입력을 변경합니다. 와 트림 활성화 에, 그들은 참조합니다 (스틱 - 트림) 및 센터링 대상은 트림된 위치를 추적합니다. 중립 스틱으로 트림된 정상 상태에서는 유지되던 힘이 완화되고, 놓으면 스틱이 트림된 위치에 안착합니다. 끄면 트림이 스틱을 전혀 움직이지 않습니다. 단일 스위치는 튜닝 페이지 상단 근처에 있습니다(엘리베이터 우선, 에일러론 강도는 고급 아래).
소프트웨어 혼합 주기 효과 기능 토글이 아닌 디스패치 모드 선택입니다. 두 모드 모두 완전히 조정되어 있습니다. 동일한 효과 카탈로그, 동일한 슬라이더입니다. 다음에서 하드웨어
모드(새로 설치 시 기본값)에서 브리지는 벡터 상수 1개, 2축 스프링 1개, 그리고 지연 로드되는
Sine / Triangle /
Triangle 주기적 풀입니다. 에서
소프트웨어 블렌딩 모드에서는 브리지가 연속적인 힘/센터링 하드웨어 경로만 유지하고 200Hz에서 C#으로 주기적/일회성 큐를 합성합니다. 설정 → 하드웨어 탭을 전환합니다. 재시작이 필요합니다.
일시 중지 및 오래된 원격 측정 안전은 효과 카탈로그 외부에 있습니다. Sim 일시 중지는 즉각적입니다. MSFS 또는 X-Plane이 일시 중지된 것으로 보고하는 순간(또는 고정 프레임 감시가 변경이 중지된 값을 감지하는 순간) 모든 동적 힘은 동일한 틱에서 0으로 떨어지고 스틱은 라이브 데이터가 다시 시작될 때까지 중립 기본 스프링을 유지합니다. 사용자 조정 가능 워치독 슬라이더는 별도의 "심이 완전히 사라졌습니다" 페이드 타이밍을 제어합니다.
제13장튜닝 가이드
먼저 설정 → 하드웨어 드래그 패드 극성 테스트(10장)를 통해 극성을 확인하십시오. 힘이 반대가 되면 아래에 설정한 모든 게인이 잘못된 기호와 싸우게 됩니다. 그런 다음 단계를 순서대로 진행하고 각 단계 후에 프로필을 저장하여 다시 돌아갈 수 있습니다.
- 마스터 게인. 100%에서 시작하세요. 크루즈를 타고 모터 포화 상태를 찾으세요. 스틱이 완전히 휘어졌을 때 거칠게 느껴지면 80%로 낮추고 반복하십시오. 이는 스프링을 포함한 모든 힘의 크기를 조정합니다. 100%를 초과하는 부스트는 없습니다. 이는 설계된 상한선입니다.
- 센터링 스프링. 순항 중에 스틱을 놓습니다: 빠름 vs 느림. 그런 다음 2G 회전을 당깁니다. 단단해지나요? 택시 또는 Sim-Disconnect 센터링이 너무 느슨하게 느껴지면 G 게인을 쫓기 전에 저속 스프링 플로어를 올립니다.
- 스틱 드롭. 항공기를 주기시키고 엔진을 끄십시오. 스틱이 약간 앞쪽에 위치해야 합니다(무부하 엘리베이터의 중력 모델링). 정지 위치에 대한 힘(Force)을 조정하고, 이륙 롤에서 사라질 때의 속도 페이드(Fade airspeed)를 조정합니다. 제트/플라이 바이 와이어 프로필의 경우 힘을 0으로 설정합니다.
- 제어 시스템 느낌. 게인을 튜닝하기 전에 스틱 느낌 상단에서 수동, 유압 부스트, 또는 플라이 바이 와이어를 설정하여 기체와 맞추세요. 이 설정은 공력 로딩과 G-로드 스프링의 크기를 조정하므로, 먼저 설정하지 않으면 게인이 움직이는 표적을 쫓게 됩니다.
- 트림. 여부를 결정합니다. 트림 활성화 이 켜져 있습니다. 켜기: 트림하면 유지력이 완화되고 스틱이 트림된 위치에 자리잡습니다 — 중립 스틱으로 트림 상태일 때 힘이 거의 0이며 스틱을 놓으면 그 위치를 유지합니다. 끄기: 트림이 스틱에 아무 영향도 주지 않습니다. 로딩을 튜닝하기 전에 설정하세요. 튜닝 도중에 전환하면 느껴지는 힘이 달라집니다.
- 공기역학적 로딩. 트리밍하지 않고 스틱을 밀어 보십시오. 공기가 뒤로 밀어내는 듯한 느낌이 들어야 합니다. 속도 범위 전체에 걸쳐 확인하십시오.
- 지상 효과. 포장된 도로와 잔디 위의 택시. 브레이크. 확고한 도착을 심습니다.
- 버핏. 실속 버핏을 위한 파워 오프 실속; 스포일러 버핏을 위한 스포일러 전개.
- 기계적 원샷. 기어와 플랩을 격납/전개합니다.
- 엔진. 유휴 출력과 이륙 출력은 확실히 다르게 느껴져야 합니다.
- 속도 감쇠. 스틱이 중앙으로 다시 울리면 들어올립니다. 너무 많으면 스틱이 죽은 느낌이 듭니다.
항공기 유형 패턴: 가벼운 싱글은 견고한 센터링과 적당한 로딩을 원합니다. 곡예 비행은 부드러운 센터링과 낮은 감쇠를 원합니다. 무거운 제트기는 강한 댐핑과 강력한 AP 백 드라이브를 원합니다. bush / STOL은 센터링 베이스는 낮지만 G 게인은 높기를 원합니다. 항공기에 가장 가까운 내장 스타터(Cessna 172 Skyhawk(G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo 또는 Boeing 747-8 Intercontinental)에서 시작하세요.
제14장문제 해결
14.1 스틱이 움직이지 않아요
상단 스트립에서 순서대로 확인합니다. (1) ARM 게이지에 ARMED(황색)가 표시됩니다. 무장 해제 또는 오류가 발생하지 않았습니다. (2) DEVICE 램프가 녹색("준비")입니다. (3) SIM 램프가 녹색입니다("Sim 연결됨"). 빨간색 램프는 지원 페이지의 상태 확인 탭에 있는 해당 행을 가리킵니다.
14.2 MSFS는 연결되지만 힘이 잘못된 느낌입니다
항공기에 가장 가까운 스타터를 불러오십시오. 대부분의 "잘못된" 느낌은 다른 항공기 클래스에 맞게 튜닝된 프로필에서 비롯됩니다. 타사 항공기는 때때로 표준 SimVar 구현을 건너뜁니다. 브리지는 이를 허용하지만(누락된 변수의 기본값은 0) 그에 의존하는 효과는 조용해집니다.
14.3 트레이 아이콘이 나타나지 않습니다(Linux)
일부 데스크탑은 기본적으로 트레이 호스트를 제공하지 않습니다. GNOME Wayland가 가장 큰 제품입니다. 브리지는 이를 감지하고 닫기가 숨는 대신 앱을 직접 종료한다는 것을 설명하는 배너를 표시합니다. 트레이를 다시 얻으려면 GNOME에 AppIndicator 지원을 설치하십시오. KDE, Xfce, Cinnamon, MATE, Budgie는 즉시 사용할 수 있습니다.
14.4 무장 후 Windows 하드웨어 모드 충돌
이전 빌드는 하드웨어 모드에서 유지된 대규모 DirectInput 효과 테이블을 생성했기 때문에 일부 Windows/FFB2 스택에서 충돌이 발생할 수 있었습니다. 이는 MSFS나 잘못된 펌웨어가 아닌 브리지 아키텍처 버그였습니다. 현재 하드웨어 경로는 기본 SideWinder FFB2 경로로 원시 HID/PID를 사용하고 폴백으로 DirectInput을 사용하여 벡터 상수 1개, 2축 스프링 1개, 게으른 3슬롯 주기적 풀을 사용합니다. 버전 1.0은 또한 시뮬레이터 연결을 끊은 후 재설정하기 전에 원시 HID/PID 효과 테이블을 재설정합니다. 현재 빌드가 하드웨어 모드에서 여전히 충돌하는 경우 다음을 실행하세요. 하드웨어 효과 테스트 설정 → 하드웨어 탭에서 프로브를 선택하고 소프트웨어 혼합 주기 효과 브리지가 그 회복을 제공한다면.
14.5 실행 시 충돌 발생
다음 실행에서는 스택 추적 및 피드백 양식 열기 크래시 로그를 미리 첨부하는 버튼입니다. 대화 상자가 나타나기 전에 앱이 충돌하면 다음에서 직접 로그를 가져오세요.
%LOCALAPPDATA%\ffb-bridge\crashes\ (Windows) 또는
~/.local/share/ffb-bridge/crashes/ (리눅스).
14.6 일시 중지 또는 긴 말더듬 후에 힘이 사라집니다.
현재 빌드는 이를 직접 대상으로 합니다. MSFS 일시 정지와 액티브 포즈는 동적 효과를 즉시 억제하고, 일시 정지된 동안 중립 기본 스프링을 유지하며, 가능한 경우 정지(quiesce) 중에도 스프링을 계속 재생하고, 정지 후 리플레이 전에 스프링 매개변수를 다시 업로드합니다. 재개 후에도 롤이나 피치 포스가 여전히 느껴지지 않으면 즉시 지원 번들을 내보내고, 당시 대시보드의 스틱 활동에 표시된 내용을 메모하세요.
제15장지원 번들
지원 번들은 다음에서 생성된 단일 ZIP입니다. 진단 → 지원 번들. ZIP에는 다음 내용만 포함됩니다.
sysinfo.txt— OS, 커널, 배포판, CPU, RAM, .NET 버전, 로캘.session.log— 현재 세션에 대한 전체 이벤트 로그.last-crash.log— 충돌 로그가 있는 경우.doctor.json— 기계가 읽을 수 있는 형식의 마지막 지원 페이지 검색입니다.tunables.json— 내보내기 시 활성 프로필.hardware-settings.json— 하드웨어 백엔드, 스무딩, 극성, 축 교환 및 호환성 설정.simconnect.txt— IP가 편집된 MSFS SimConnect 경로와 내용.
제한: 압축된 총 50MB, 항목당 5MB, 최대 30개 항목, 압축되지 않은 총 20MB, UTF-8 텍스트만(XML 포함). 일반적인 번들은 메가바이트 미만입니다.
번들은 컴퓨터를 자동으로 벗어나지 않습니다 — 피드백 보고서에 첨부할 시점과 전송 여부는 사용자가 선택합니다.


16장라이선스 및 면책조항
FFB-Bridge 바이너리는 FFB-Bridge 최종 사용자 약관에 따라 제공되는 독점 Rohsam Inc. 소프트웨어이며 보증 없이 있는 그대로 제공됩니다. 사용에 따른 책임은 사용자에게 있습니다. 브리지는 물리적 하드웨어를 구동하며 버그로 인해 예상치 못한 힘이 발생할 수 있습니다. 활성화할 때마다 '손을 치우는' 순간으로 여기십시오.
FFB-Bridge는 Rohsam Inc.에서 발행하며 Microsoft 및 Laminar Research와는 독립적입니다. "Microsoft Flight Simulator", "SimConnect", "Sidewinder" 및 "X-Plane"은 해당 소유자의 상표입니다. 호환되는 제품을 식별하기 위한 목적으로만 여기에 표시됩니다. 이 페이지의 어떤 내용도 어느 회사의 보증을 의미하지 않습니다.
전체 FAQ 및 개인정보 보호정책은 다음 사이트에서 확인하실 수 있습니다. FFB-Bridge.com/#faq 그리고 FFB-Bridge.com/privacy.
매뉴얼 끝. 도움이 되지 않은 텍스트, 그림, 튜닝 조언 등 모든 섹션에 대한 피드백 FFB-Bridge.com/feedback.