测试版文档。 随着应用程序进入 1.0 版本,一些文本和图像将被重新设计。如果某个部分显示为过时,请通过 反馈表.

FFB-Bridge

用户手册 — 单页打印版
v1.0.0-beta.11 · Revised 2026-05-06 · Windows 10+ / modern Linux (evdev) · MSFS 2024 / X-Plane 11–12
使用浏览器的“另存为 PDF”——打印样式表会翻转到浅色模式并隐藏导航镶边。

第一章关于本手册

本手册介绍 FFB-Bridge,这是一个用户空间桥,可在 Windows 10+ 和现代 Linux 上驱动 Microsoft Flight Simulator 2024 和 X-Plane 11 / 12 中的 Microsoft Sidewinder Force Feedback 2 操纵杆。这是每页手册的单文件版本,位于 ffb-bridge.com/docs — 相同的内容,旨在从头到尾阅读并打印为 PDF。

操作系统芯片 窗户, Linux, 和 两者都 标记仅适用于一个平台的段落。菜单和按钮位于 粗体; filenames and shortcuts are in code.

第2章安装

2.1 Windows 安装程序

After signing up on the home page, click the Windows link in the emailed download. Save FfbBridge-Setup-x64.exe and double-click it. On first launch SmartScreen warns “Unrecognised app” — click 更多信息,那么 无论如何都要跑. The installer is unsigned until 1.0.

The Inno Setup wizard installs into %LOCALAPPDATA%\Programs\FfbBridge by default. No administrator permission required — this is a per-user install. A Start Menu shortcut lands in the FFB-Bridge group.

要卸载,请打开 应用程序和功能,找到FFB-Bridge,然后选择 卸载. Your profiles under %APPDATA%\ffb-bridge are kept for a later reinstall; remove that folder for a clean slate.

2.2 Linux 应用镜像

保存通过电子邮件发送的链接中的 AppImage,使其可执行,并注册菜单条目:

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

The --install flag writes the .desktop file and icons into XDG directories so FFB-Bridge shows up in your application menu. Uninstall with --uninstall.

Installed menu entry on KDE Plasma; other XDG-compatible desktops pick it up identically.
Figure 2.1. Installed menu entry on KDE Plasma; other XDG-compatible desktops pick it up identically.

2.3 udev规则(Linux)

因此,桥接器可以在每次启动时打开棒,而无需出现 polkit 提示,请安装以下 udev 规则。的 医生 page has a one-click installer that uses pkexec to write it; you can also install by hand:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"

On NixOS, add it to configuration.nix under services.udev.extraRules, then sudo nixos-rebuild switch and replug the stick.

第三章首次推出

首次启动流程是三个连续的模式:物理危险 安全确认,那么 欢迎参观,然后是仪表板。安全模式会阻止解雇,直到您勾选“我理解”复选框为止;可以跳过欢迎词并稍后从“帮助”页面重播。

Safety acknowledgement. Shown on first launch only, and required before the bridge can run.
Figure 3.1. Safety acknowledgement. Shown on first launch only, and required before the bridge can run.
Welcome dialog. Click “Take the tour” or “Skip tour”.
Figure 3.2. Welcome dialog. Click “Take the tour” or “Skip tour”.

仪表板打开,检测到设备,并且顶部条带中的臂规读数 解除武装. Forces do not reach the stick until you explicitly arm. The strip across the top of the window is the operational cockpit: brand block, ARM gauge (centre, the visual hero), Sim · Device · Mode lamps, and the Profile picker + Tune / Save button on the right. Live flight numbers (IAS, G, Mach, pitch / roll force, data age, tick rate) live in a thin tape along the bottom of the content area.

Dashboard in its initial state.
Figure 3.3. Dashboard in its initial state.

单击条带中的 ARM 仪表即可启动。仪表具有三种状态: 解除武装 (静止时的暖边框,中性字形), 武装 (琥珀色渐变+明亮字形), 故障 (red — see § 3.4). Esc cancels the arm-confirmation dialog if you change your mind before confirming. There are no other global keyboard shortcuts; the bridge is mouse / tray-driven by design.

Close-button dialog. Minimize to tray keeps the bridge running; Quit releases the stick.
Figure 3.5. Close-button dialog. Minimize to tray keeps the bridge running; Quit releases the stick.
安全。 第一个臂将棍子卡扣到修剪后的中心位置。确保手臂上或靠在操纵杆上时,没有任何东西(手、电缆、桌子上任何松动的东西)。

3.4 故障恢复

如果在您武装时先决条件下降 - 最常见的是棒被拔掉或 SIM 卡崩溃 - 仪表会翻转到 故障 并且力量停止。匹配的灯变红,因此原因很明确:设备拔出,SIM 卡掉线。单击仪表确认并重置回 解除武装;恢复缺失的先决条件然后让您重新装备。的 打开诊断 如果您想在重置之前了解完整情况,仪表旁边的链接将带您进入事件日志。

关闭窗口(X按钮)隐藏到托盘;桥继续运行。使用托盘菜单布防/撤防/显示/退出。在 GNOME Wayland 上没有托盘 - 窗口会默默隐藏,您需要使用 Alt+Tab 或桌面菜单将其恢复。

System tray menu.
Figure 3.5. System tray menu.

第4章连接 MSFS 2024

MSFS 通过 SimConnect TCP 与 FFB-Bridge 进行通信。在 Windows 上,这是开箱即用的;在 Proton 下的 Linux 上,无法绑定默认端口 (500),一键 Doctor 修复会添加并行非特权端口。

4.1 SimConnect.xml 所在的位置

该文件的位置取决于 MSFS 安装源:

  • Windows 蒸汽 %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
  • Windows 应用商店 / 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 detects the correct path automatically. Override with FFB_BRIDGE_MSFS_CONFIG or FFB_BRIDGE_MSFS_PREFIX if you run MSFS from a non-standard location.

4.2 医生一键修复

打开 医生. The SimConnect 配置 行显示检测到的 XML 路径和网桥所针对的端口。三个结果:

  • 绿色 — 找到匹配的条目,无需执行任何操作。
  • 琥珀色 使用端口:X — 在不同的口岸入境;按钮采用它。
  • 红色 修复... — 没有可用的条目;该对话框准确显示了它将添加的内容。
Fix dialog on Linux, showing the parallel unprivileged port entry about to be merged.
Figure 4.1. Fix dialog on Linux, showing the parallel unprivileged port entry about to be merged.

所有修复操作都是附加的 - 现有条目永远不会被覆盖。如果 XML 不可解析,则首先进行带时间戳的备份。

第5章连接 X-Plane 11 / 12

Zero-config. X-Plane accepts UDP RREF subscribes on 127.0.0.1:49000 by default; FFB-Bridge subscribes on launch and data flows. If X-Plane is running when you start the bridge, the SIM lamp in the top strip goes green within milliseconds.

3 秒过时看门狗涵盖了 UDP 不断开连接问题:如果三秒内没有数据引用到达,SIM 灯将变为红色。加载新航班会自动重新建立。

防火墙很少干扰环回,但如果 Doctor 的 X-Plane 探测器为红色并且 X-Plane 确实在运行,请检查防火墙是否阻止 UDP 49000。有关恢复流程,请参阅第 14 章。

第6章仪表板

Dashboard layout — flight-state panel on the left, stick-activity panel on the right. Operational state (arm, sim, device, mode, profile) lives in the top strip.
Figure 6.1. Dashboard layout — flight-state panel on the left, stick-activity panel on the right. Operational state (arm, sim, device, mode, profile) lives in the top strip.

操作状态——arm、sim、设备、模式、配置文件——不再在此页面上。它移至持久顶部条中,以便在您进行调整、诊断或其他任何地方时保持可见。仪表板是实时解释界面:SIM 正在报告什么、哪些动态通道处于活动状态以及摇杆所保持的基线弹簧状态。

左面板:飞行状态。一对用于升降舵和副翼偏转的 BiBar 上的一排三个数字读数 - 空速 (kt)、G 负载(g,在正常范围外转向琥珀色)、马赫数。条形下方是电梯配平、地面状态和失速警告的较小读数。 UI 以约 20 Hz 的速度刷新 — 50 Hz 控制环路的精简视图。

左侧面板的底部是一个列表 效果组切换:操纵杆感觉、发动机隆隆声、机身抖振、地面滚转、机械肩部、轴负载和自动驾驶仪跟随。每行都有一个复选框、实时状态和紧凑的水平栏。使用它们作为飞行中 A/B 比较的快速静音;每个效果的增益保留在调音上。切换状态是活动配置文件的一部分。

右图:摇杆活动。标题列出了最具活力的贡献者,堆叠条按家庭对他们进行分组,活跃频道筹码在重要时显示个人价值观。定心弹簧被视为基线感觉,因此活动列表重点关注基线之上的变化:配平中心、G 负载弹簧变化、轴负载、发动机隆隆声、地面滚动、抖振和机械一次性。轴载荷条显示有符号的俯仰/横滚力;定心弹簧部分显示系数、死区和俯仰/滚动中心。

第7章调音

Tuning page: master-gain accent card, then effect sliders grouped by subsystem (Forces, Stick feel, Ground effects, Aero buffets, Powerplant, One-shots, Autopilot, Trim relief), with per-slider reset arrows and dirty indicators.
Figure 7.1. Tuning page: master-gain accent card, then effect sliders grouped by subsystem (Forces, Stick feel, Ground effects, Aero buffets, Powerplant, One-shots, Autopilot, Trim relief), with per-slider reset arrows and dirty indicators.

每个滑块更改都会应用于下一个 50 Hz 刻度;您可以将“调整”页面固定在第二台显示器上进行飞行,并在效果发生时调整效果。

7.1 主增益

在所有效果之后应用的单个乘数,显示为 0% 到 100% 的百分比。 100% 是设计水平(也是默认值);较低的值会立即衰减每个动态输出。没有超过 100% 的“提升”——该上限是每个效果增益滑块工作的上限。 Beta.11 在该滑块下方以 95% 的桥权限驱动设备,留下 5% 的净空。

Master-gain card.
Figure 7.2. Master-gain card.

7.2 滑块组

从上到下:定心弹簧(底座、G 增益、最小/最大夹具、死区)·空气动力载荷(俯仰增益、横滚增益)·操纵杆感觉(速率阻尼、控制边缘奖励、 棒滴) · 地面效应(跑道隆隆声、接地重击、起落架颠簸、刹车颤抖) · 气动抖振(失速、超速、马赫数、扰流板、湍流) · 动力装置(发动机隆隆声、反向隆隆声) · 一击(起落架展开、襟翼步进) · 自动驾驶仪(后轮驱动增益、速率限制)。完整参考请参见第 12 章。

7.3 棍子掉落

杆下落模拟了低空速时空载升降舵上的重力偏差,这使得停放的通用航空飞机的操纵杆稍微偏向中心。两个滑块: (偏差的拉力有多大)和 渐弱空速 (偏差衰减到零时的 kts)。默认值为 Cessna-class — 将力降至 0,以在喷气机或电传飞行剖面上静音。

7.4 TrimRelief(alt-trim 模式)

下的切换 棒感 这改变了配平和杆力相互作用的方式。带有修剪救济 关闭 (默认),俯仰/滚转配平会移动弹簧的中心,但空速加载仍然会对抗总表面偏转 - 带有中立杆的配平飞机会推向您。带有修剪救济 ,空速载荷的计算依据 (升降舵 - 配平) 弹簧中心轨道具有完全权限的修剪。在使用中性操纵杆的修剪稳定状态下,您会感觉到零力 - 松开后可以让操纵杆保持修剪位置,就像真正的电缆操纵杆一样。围绕遗留行为调整的现有配置文件保持不变。如果这是您所追求的心智模型,那么更接近 XPforce / FSforce 模型。

7.5 滑块交互

拖动拇指,单击轨道上的任意位置以跳转到那里,或单击一次进行聚焦,然后使用滚轮/箭头键。悬停和滚动确实 捕获滚轮——滑块必须首先聚焦——这样您就可以将页面滚动到悬停的滑块上,而无需轻推它们。

7.6 脏指示器和重置

当滑块与加载的配置文件不同时,后退箭头 重置字形 出现在其值旁边;单击它即可恢复该滑块。每个部分标题都带有一个匹配的字形,用于重置该部分中的每个滑块。一个 丢弃 配置文件卡上的按钮可立即恢复所有内容。配置文件选择器上的琥珀点总结了“此配置文件有未保存的更改”。重置仅限于本地 - 它们不会影响已保存的配置文件。

Per-slider and per-section reset arrows on dirty rows; matching glyph on the section header; dirty dot on the profile picker.
Figure 7.4. Per-slider and per-section reset arrows on dirty rows; matching glyph on the section header; dirty dot on the profile picker.

7.7 保存

保存 覆盖活动配置文件。 另存为... 打开一个对话框以新名称保存。入门预设是只读的;另存为创建您将保留的可编辑飞机调整。

第8章型材

Profiles page: starter presets and saved profiles in one searchable list, with the active profile highlighted.
Figure 8.1. Profiles page: starter presets and saved profiles in one searchable list, with the active profile highlighted.

Saved profiles are JSON files under %APPDATA%\ffb-bridge\profiles\ (Windows) or ~/.config/ffb-bridge/profiles/ (Linux, honouring $XDG_CONFIG_HOME). Each file is one profile. Copy them between machines or share them with others by emailing the file.

初学者和保存的配置文件共享一个列表。行动: 使用选定的配置文件, 重复选择, 删除所选内容, 和 刷新. Starter presets are read-only; use Duplicate or Save as to get an editable copy.

Profile library list with built-in starter rows, active-profile highlight, and selected-profile actions.
Figure 8.2. Profile library list with built-in starter rows, active-profile highlight, and selected-profile actions.

内置启动器以 MSFS 飞机命名:Cessna 172 Skyhawk (G1000)、Daher TBM 930、Beechcraft King Air 350i、Airbus A320neo 和波音 747-8 InterContinental。切换配置文件适用于下一个 50 Hz 滴答声,无需撤防。调整上的配置文件选择器会显示一个琥珀色圆点表示未保存的更改 - 请在加载另一个配置文件之前保存,否则您将放弃更改。

第9章诊断

Diagnostics page — metrics cards, event log, support-bundle export.
Figure 9.1. Diagnostics page — metrics cards, event log, support-bundle export.

顶部有四张度量卡: 控制环路速率 (目标 50 Hz), 管道延迟 (微秒), 效果活跃 (数), 重申 (柜台)。每个都有 60 秒的迷你图。

Metrics grid close-up.
Figure 9.2. Metrics grid close-up.

事件日志占据页面的下半部分。电平颜色:INF / DBG 中性、WRN 琥珀色、ERR / FTL 红色。大约2000行滚动回滚;使用日志顶部的栏按子字符串进行过滤。

Event log.
Figure 9.3. Event log.

导出支持包 按钮生成一个用于反馈报告的 ZIP。完整内容列表请参见第 15 章。

Bundle-exported banner.
Figure 9.4. Bundle-exported banner.

第10章医生

Doctor page. Each row is one check.
Figure 10.1. Doctor page. Each row is one check.

10.1 硬件兼容性

第一张卡包含一个 反转轴极性 切换开关和实时拖动板 极性测试. Different production runs of the FFB2 read polarity differently; the test verifies which way yours runs by driving the stick from a 2-axis drag-pad in real time. Click Start, move the puck, click Stop, then answer “Did the stick follow the puck?” — Yes makes no change, No auto-flips the toggle. The toggle is install-level and flips both pitch and roll axes together.

Hardware compatibility card — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.
Figure 10.2. Hardware compatibility card — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.

10.2 软件混合期刊

该桥有两种方式向 FFB2 发送周期性和一次性效果。 硬件模式 — 全新安装的默认设置 — 使用 DirectInput 硬件效果,但 beta.11 故意保持该拓扑较小:一个矢量常量、一个两轴弹簧和一个惰性三槽周期池。固件仍然以本机速率驱动周期性波形;桥梁将这些物理插槽重新用于跑道、引擎、自助餐和一次性提示。 软件混合期刊 在同一 Doctor 行上仅保留连续力/居中硬件路径,并在 C# 中以 200 Hz 合成周期性/一次性线索,将结果折叠到恒力输出中。

硬件模式在最高频率效果上更清晰且延迟更低,因为固件驱动它们的速度比桥的滴答率更快。软件混合是硬件探测失败、分类硬件影响崩溃或故意喜欢它的用户的兼容性后备方案;通用的不干净退出本身不会强制软件混合。它的高频边缘感觉会更柔和一些。无论哪种方式都需要重新启动 - 调度程序在启动时读取模式。使用 测试硬件效果 在单独的工作进程中安全地尝试紧凑的硬件拓扑。

10.3 健康检查

检查: 设备, udev规则 (Linux), SimConnect 配置, SimConnect 可达性, X-Plane可达性, 运行时健康状况, 崩溃日志. Row status dots are green / amber / red / grey (not applicable).

在修复显而易见的地方,该行提供了内联操作 - 安装 udev 规则, 使用端口:X, 修复.... The Fix dialog shows exactly what will change before it's applied, and never overwrites existing entries.

Fix dialog for SimConnect config install.
Figure 10.4. Fix dialog for SimConnect config install.

Linux actions that write system paths route through pkexec. Exit codes: 0 = success, 126 = user dismissed the prompt, 127 = auth failure / no polkit agent.

第11章模拟 SimConnect

Mock SimConnect page.
Figure 11.1. Mock SimConnect page.

该桥具有三个输入源: 直播 (真实模拟), 模拟 (用户界面驱动的滑块), 空闲 (无数据)。 Mock 是一流的对等体——arm、dispatch、reassertion 和 stale-watchdog 都以相同的方式运行。

使用模拟来感受单独的效果,无需飞行即可调整配置文件,或者无需安装模拟程序即可演示桥接器。四个一键式场景预设将每个滑块捕捉到滑行/起飞滑跑/巡航/着陆耀斑的合理值。

Scenario preset bar.
Figure 11.2. Scenario preset bar.

Live 和 Mock 是互斥的。检测到的真实模拟卡会通过解释性横幅将模拟卡锁定。

Lockout banner.
Figure 11.3. Lockout banner.

帮助帮助页面

Help page — setup status, get-flying checklist, tuning order, support evidence, and common fixes.
Figure H.1. Help page — setup status, get-flying checklist, tuning order, support evidence, and common fixes.

应用程序内帮助页面是当前运行的简洁参考。它显示设置状态,引导您完成飞行流程,给出建议的调整顺序,并链接到拥有每个工作流程的页面:实时力可见性的仪表板、滑块的调整、库管理的配置文件、运行状况检查的医生以及支持包的诊断。

第12章力效应参考

The fourteen effects shipped with v1.0.0-beta.11:

  1. 定心弹簧 — 随 G 负载而变硬,死区随空速变化,中心偏移随配平变化。
  2. 空速加载俯仰力 — 恒定的俯仰轴力,按空速² × 升降舵偏移量缩放。
  3. 空速加载滚转力 — 横滚轴上的模型相同,独立调整。
  4. 速率阻尼 — 与体轴旋转速率成正比的反向力 (p, q);粘性阻尼。
  5. 棒滴 — 低空速时升降舵上的重力偏差;停车时向前拉杆,以 Fade 空速(默认 30 节)逐渐减弱。
  6. 自动驾驶仪后驱 — 弹簧中心跟踪 AP 指令的偏转,速率有限。
  7. 跑道隆隆声 — 按地面速度和表面类型缩放的连续周期性力(草 1.5–1.9×,冰 0.3–0.5×)。
  8. 触地重击 — 地面过渡时的单脉冲,幅度按垂直速度缩放。
  9. 刹车颤抖 — 与制动偏转成正比的低频隆隆声,在地面上门控。
  10. 齿轮颠簸 — 滑行时的离散脉冲约为 40 节。
  11. 航空自助餐 — 五个子效果(失速、超速、马赫、扰流板、湍流)共享一个抖振发生器。
  12. 发动机隆隆声 — 连续周期性力由每台发动机的 RPM × 燃烧标志缩放。
  13. 反向推力隆隆声 — 倒车时的滚动隆隆声,按地面速度缩放。
  14. 机械一击 — 齿轮展开和襟翼步进在任何转换过程中都会颤抖,两个方向。

所有十四个总和为两个输出(俯仰+侧倾力加上弹簧参数)。最后应用主增益;如果您的硬件读取极性相反,安装级俯仰/滚动极性反转(Doctor 的硬件兼容卡)会在设备输出边缘同时取消两个轴。仪表板将基线弹簧与活动动态通道分开,因此您可以随时查看哪些效果起作用。

TrimRelief 替代修剪模式 更改效果 1(定心弹簧)和 2 / 3(空速加载的俯仰/横滚力)的输入。当 TrimRelief 关闭(默认)时,它们参考总表面变形。启用 TrimRelief 后,它们会引用 (坚持-修剪) 弹簧中心全权跟踪配平——在中性操纵杆的配平稳定状态下,每个力为零,释放时操纵杆保持在配平位置。在“Stick Feel”下的“Tuning”页面上切换。

软件混合期刊 是调度模式选择,而不是功能切换。两种模式均已完全调整 - 相同的十四种效果,相同的滑块。在 硬件 mode (the fresh-install default) the bridge allocates one vector constant, one two-axis spring, and a lazy Sine / Triangle / Triangle periodic pool. In 软件混合 模式下,桥仅保留连续力/居中硬件路径,并以 200 Hz 的频率在 C# 中合成周期性/一次性提示。切换医生页面;需要重新启动。

暂停和过时的遥测安全不属于这十四种影响。当检测到 MSFS 暂停、主动暂停或冻结遥测时,动态力立即消失,并且操纵杆保持中性默认弹簧,直到实时数据恢复。

第13章调音指南

首先通过 Doctor 的拖板极性测试(第 10 章)验证极性 - 如果力反向,您在下面设置的每个增益都会与错误的符号作斗争。然后按顺序完成各个阶段,并在每个阶段后保存配置文件,以便您可以回退。

  1. 大师增益。 从 100% 开始。飞行巡航,寻找电机饱和度;如果摇杆在完全偏转时感觉刺耳,则降至 80% 并重复。没有超过 100% 的提升——这是设计的上限。
  2. 定心弹簧。 巡航时松开操纵杆:敏捷与迟缓。然后拉2G转:牢固吗?
  3. 棒滴。 停放飞机,关闭发动机 - 操纵杆应稍微向前(模拟空载电梯上的重力)。调整静止位置的力,调整空速在起飞滑跑中消失时的淡入淡出。对于喷气/电传飞行剖面,将力设置为 0。
  4. 选择修剪型号。 TrimRelief 关闭(默认)可保留传统的 TrimFeel — 空速加载可对抗总表面偏转,修剪后的飞机会向您推力。参考文献上的 TrimRelief (坚持-修剪) — 使用中立杆进行配平时,力为零,释放时杆保持不动。在调整负载之前进行选择;切换中调会改变感受到的力量。
  5. 空气动力载荷。 推棒不修剪;应该感觉像是空气在向后推。验证整个速度包络线。
  6. 地面效应。 路面出租车与草地出租车。刹车。植物坚定抵达。
  7. 自助餐。 摊位自助餐断电摊位;为扰流自助餐部署扰流板。
  8. 机械一击。 缩回/展开起落架和襟翼。
  9. 动力装置。 怠速与起飞功率——感觉应该明显不同。
  10. 速率阻尼。 如果摇杆回到中心,请将其抬起。太多了,棍子就会感觉死了。

飞机型图案:轻单人要求定心牢固、负载适中;特技飞行需要柔和的定心和低阻尼;重型喷气式飞机需要大阻尼和强大的 AP 反向驱动;布什 / STOL 需要低定心基础但高 G 增益。从距离您的飞机最近的内置启动器开始:Cessna 172 Skyhawk (G1000)、Daher TBM 930、Beechcraft King Air 350i、Airbus A320neo 或波音 747-8 InterContinental。

第14章故障排除

14.1 摇杆不动

在顶部条中,按顺序确认:(1) ARM 仪表显示“已武装”(琥珀色)— 未“已解除武装”或“出现故障”; (2) DEVICE灯为绿色(“Ready”); (3) SIM 灯呈绿色(“Sim 已连接”)。红灯指向相应的医生行。

14.2 MSFS 连接但力量感觉不对

加载距离您的飞机最近的启动器。大多数“错误”感觉来自于针对不同飞机类别进行调整的配置文件。第三方飞机偶尔会跳过实施标准 SimVars - 桥接器可以容忍这种情况(缺少 vars 默认为零),但依赖于它们的效果将变得安静。

14.3 托盘图标不出现(Linux)

有些桌面并没有开箱即用的托盘主机——GNOME Wayland 是最重要的。桥接器检测到这一点并显示一个横幅,解释关闭将直接退出应用程序而不是隐藏。在 GNOME 上安装 AppIndicator 支持以恢复托盘; KDE、Xfce、Cinnamon、MATE、Budgie 开箱即用。

14.4 布防后 Windows 硬件模式崩溃

Beta.10 之前的版本可能会在某些 Windows/FFB2 堆栈上崩溃,因为硬件模式创建了一个大型保留的 DirectInput 效果表。这是一个桥接架构错误,而不是 MSFS 或错误的固件。 Beta.10 用一个矢量常数、一个两轴弹簧和一个惰性三槽周期池替换了该路径。如果 beta.10 或更高版本的版本在硬件模式下仍然崩溃,请运行 Doctor's 测试硬件效果 并切换到 软件混合期刊 如果这座桥能够提供这种恢复。

14.5 启动时崩溃

下次启动会显示一个崩溃报告对话框,其中包含堆栈跟踪和 打开反馈表 button that pre-attaches the crash log. If the app crashes before the dialog appears, pull the log by hand from %LOCALAPPDATA%\ffb-bridge\crashes\ (Windows) or ~/.local/share/ffb-bridge/crashes/ (Linux).

14.6 停顿或长时间口吃后力量消失

Beta.11 直接针对此目标。 MSFS 暂停和主动暂停现在立即抑制动态效果,在暂停时保持中性默认弹簧,并在静止后重播之前重新上传弹簧参数。如果恢复后仍然感觉不存在横摇或俯仰力,请立即导出支撑束并注意仪表板在摇杆活动下显示的内容。

第15章支持捆绑包

支持包是由以下人员生成的单个 ZIP: 诊断 → 导出支持包. The ZIP contains, and only contains:

  • sysinfo.txt — OS, kernel, distro, CPU, RAM, .NET version, locale.
  • session.log — full event log for the current session.
  • last-crash.log — crash log if one exists.
  • doctor.json — last Doctor scan in machine-readable form.
  • tunables.yaml — the active profile at export time.
  • simconnect-config.xml — MSFS's config, passwords stripped (MSFS sessions only).

限制:压缩后总计 50 MB,每个条目 5 MB,最多 30 个条目,未压缩总计 20 MB,仅限 UTF-8 文本(加上 XML)。典型的捆绑包不到一兆字节。

该捆绑包永远不会自动离开您的计算机 - 您可以选择何时将其附加到反馈报告以及是否发送它。

Export flow — Diagnostics button, then the banner with Reveal / Open feedback form.
Figure 15.1. Export flow — Diagnostics button, then the banner with Reveal / Open feedback form.

第16章许可和免责声明

FFB-Bridge 是按原样提供的免费软件,不提供任何保证。使用风险自负——桥驱动物理硬件,错误可能会产生意想不到的力量。将每只手臂视为“双手空闲”的时刻。

这是一个独立项目,独立于 Microsoft 和 Laminar Research。 “Microsoft Flight Simulator”、“SimConnect”、“Sidewinder”和“X-Plane”是其各自所有者的商标;它们出现在这里的唯一目的是识别兼容产品。本页上的任何内容均不暗示任何一家公司的认可。

完整的常见问题解答和隐私政策位于 ffb-bridge.com/#faqffb-bridge.com/privacy.

手册结束。对任何部分的反馈——文本、图形或对您没有帮助的调整建议—— ffb-bridge.com/feedback.