当前版本。 FFB-Bridge v1.2.1 已上线。这些文档跟随发布清单所描述的当前应用。如果某个部分看起来过时,请通过 反馈表.

FFB-Bridge

用户手册 — 单页打印版
v1.2.1 · Revised 2026-05-30 · Windows 10+ / modern Linux (evdev) / macOS (Apple Silicon) · MSFS 2024 & 2020 / X-Plane 11–12
使用浏览器的“另存为 PDF”——打印样式表会切换到浅色模式并隐藏导航装饰。

第一章关于本手册

本手册介绍 FFB-Bridge,这是一个用户空间桥,可在 Windows 10+、现代 Linux 和 macOS (Apple Silicon) 上,从 Microsoft Flight Simulator(2024 和 2020)以及 X-Plane 11 / 12 驱动 Force Feedback 摇杆。MSFS 通过 SimConnect TCP 连接;X-Plane 通过 UDP 连接;启动时会自动检测当前活动的模拟器。 五个摇杆系列已通过验证,并在已测试环境中即插即用:Microsoft SideWinder Force Feedback 2、Windows/Linux/macOS 上的 MOZA AB9 + MH16、Logitech Flight System G940、Logitech Force 3D Pro 和 Logitech WingMan Force 3D。其他力反馈摇杆可实验性启用(第 2 章)。 macOS 构建范围限定为使用 SideWinder FFB2 和 MOZA AB9 + MH16 的 X-Plane 12;Windows 和 Linux 仍是 MSFS 平台。这是逐页手册的单文件版本,位于 FFB-Bridge.com/docs — 相同的内容,旨在从头到尾阅读并打印为 PDF。

操作系统芯片 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-probe.com 而是 。

2.1 Windows 安装程序

在主页上注册后,单击通过电子邮件发送的下载中的 Windows 链接。保存 FfbBridge-Setup-x64.exe 并双击它。安装程序由 Rohsam 发布者标识进行代码签名。全新的已签名版本可能仍会显示 SmartScreen 信誉提示;请核实发布者是 Rohsam Inc.Rohsam Inc 然后继续。

Inno Setup 向导安装到 %LOCALAPPDATA%\Programs\FfbBridge 。无需管理员权限——这是按用户安装。“开始”菜单快捷方式会放入 FFB-Bridge 分组中。

要卸载,请打开 应用程序和功能,找到FFB-Bridge,然后选择 卸载。您的配置文件位于 %APPDATA%\ffb-bridge 保留供以后重新安装;删除该文件夹以获得全新的状态。

2.2 Linux 应用镜像

保存通过电子邮件发送的链接中的 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;如果您不再需要该文件,请手动删除该文件。

在 KDE Plasma 上安装了菜单条目;其他 XDG 兼容桌面会在 AppImage --install 步骤后选择它。
图 2.1。 在 KDE Plasma 上安装了菜单条目;其他 XDG 兼容桌面会在 AppImage --install 步骤后选择它。

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)

为了让 FFB-Bridge 每次启动打开摇杆时都不再弹出 polkit 提示,请安装以下 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.nixservices.udev.extraRules,那么 sudo nixos-rebuild switch 并重新插上摇杆。

第 3 章首次推出

首次启动流程是三个连续的模式:物理危险 安全确认,那么 欢迎导览,然后进入仪表盘。在勾选「我已了解」复选框之前,安全弹窗无法关闭;可以跳过欢迎引导,稍后从「帮助」页面重新查看。

安全确认。仅在首次启动时显示,并且在桥可以运行之前需要。 安全确认。仅在首次启动时显示,并且在桥可以运行之前需要。
图 3.1。 安全确认。仅在首次启动时显示,并且在桥可以运行之前需要。
欢迎对话框。单击“开始导览”或“跳过导览”。 欢迎对话框。单击“开始导览”或“跳过导览”。
图 3.2。 欢迎对话框。单击“开始导览”或“跳过导览”。

仪表盘打开后,已检测到设备,顶部条带中的布防仪表读数为 已解除。除非您明确布防,否则力不会到达摇杆。窗口顶部的横条是操作驾驶舱:品牌块、布防仪表(中央,视觉主角)、模拟器·设备·模式指示灯,以及右侧的配置文件选择器 + 调校/保存按钮。实时飞行数据(IAS、G、马赫、俯仰/滚转力、数据时延、节拍率)位于内容区域底部的细条中。

仪表板处于初始状态。 仪表板处于初始状态。
图 3.3。 仪表板处于初始状态。

该窗口使用正常的操作系统控件来进行最小化、最大化、关闭和调整大小。关闭操作仍然遵循下面的托盘行为。

单击条带中的 ARM 仪表即可启动。仪表具有三种状态: 已解除 (静止时的暖边框,中性字形), 已布防 (琥珀色渐变+明亮字形), 故障 (红色——参见第 3.4 节)。 Esc 如果您在确认之前改变主意,则会取消手臂确认对话框。没有其他全局键盘快捷键;该桥由鼠标/托盘驱动设计。

关闭按钮对话框。最小化到托盘可让 FFB-Bridge 继续运行;退出则释放摇杆。 关闭按钮对话框。最小化到托盘可让 FFB-Bridge 继续运行;退出则释放摇杆。
图 3.5。 关闭按钮对话框。最小化到托盘可让 FFB-Bridge 继续运行;退出则释放摇杆。
安全。 首次布防会将摇杆卡入已配平的中心位置。布防时,请确保没有任何东西 —— 手、线缆、桌面上任何松动的物件 —— 搁在摇杆上或抵着摇杆。

3.4 故障恢复

如果在您启用期间某项前提条件失效——最常见的是摇杆被拔掉或模拟器崩溃——仪表会翻转到 故障 并且力量停止。匹配的灯变红,因此原因很明确:设备拔出,模拟器掉线。单击仪表确认并重置回 已解除;恢复缺失的先决条件然后让您重新装备。的 打开诊断 如果您想在重置前了解完整情况,仪表旁边的链接会带您前往支持页面「诊断」选项卡的事件日志。

关闭窗口(X 按钮)会提示隐藏到托盘;如果您选择该选项,桥接器将继续运行 最小化到托盘。使用托盘菜单进行启用 / 停用 / 显示 / 退出。在没有可用托盘的桌面环境(例如原生 GNOME Wayland)上,网桥会提示您关闭将直接退出而非隐藏。

系统托盘菜单。
图 3.5。 系统托盘菜单。

第4章连接 MSFS(2024 年和 2020 年)

Microsoft Flight Simulator 2024 和 2020 都通过 SimConnect TCP 与 FFB-Bridge 通信,并且相同的设置适用于两者。在 Windows 上,这是开箱即用的;在 Proton 下的 Linux 上,无法绑定默认端口 (500),并且支持页面的运行状况检查选项卡上的一键修复添加了并行非特权端口。 (下面的路径是 MSFS 2024 的路径;MSFS 2020 使用等效路径 Microsoft Flight Simulator 文件夹,网桥也会检测到该文件夹。)

4.1 SimConnect.xml 所在的位置

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

  • Windows Steam %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 自动检测正确的路径。覆盖为 FFB_BRIDGE_MSFS_CONFIGFFB_BRIDGE_MSFS_PREFIX 如果您从非标准位置运行 MSFS。

4.2 支持页面中的一键修复

打开 支持页面 → 健康检查选项卡。的 SimConnect 配置 行显示检测到的 XML 路径和网桥所针对的端口。三个结果:

  • 绿色 — 找到匹配的条目,无需执行任何操作。
  • 琥珀色 使用端口:X ——在另一个端口入站;按钮会随之采用该端口。
  • 红色 修复... — 没有可用的条目;该对话框准确显示了它将添加的内容。
修复 Linux 上的对话框,显示即将合并的并行非特权端口条目。 修复 Linux 上的对话框,显示即将合并的并行非特权端口条目。
图 4.1。 修复 Linux 上的对话框,显示即将合并的并行非特权端口条目。

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

第5章连接 X-Plane 11 / 12

零配置。X-Plane 接受 UDP RREF 订阅,端口为 127.0.0.1:49000 默认情况下; FFB-Bridge 订阅启动和数据流。如果启动桥时 X-Plane 正在运行,顶部条中的 SIM 指示灯会在几毫秒内变绿。

一个 3 秒的过时看门狗用于应对 UDP 不断连的问题:如果三秒内没有任何 dataref 到达,SIM 指示灯会变红。加载新航班时会自动重新建立连接。

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

第6章仪表板

仪表盘布局——飞行状态面板位于左侧,摇杆活动面板位于右侧。运行状态(布防、模拟器、设备、模式、配置文件)位于顶部状态条中。 仪表盘布局——飞行状态面板位于左侧,摇杆活动面板位于右侧。运行状态(布防、模拟器、设备、模式、配置文件)位于顶部状态条中。
图 6.1。 仪表盘布局——飞行状态面板位于左侧,摇杆活动面板位于右侧。运行状态(布防、模拟器、设备、模式、配置文件)位于顶部状态条中。

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

左面板:飞行状态。一排三个数字读数——空速(kt)、G 负载(g,超出正常范围时变为琥珀色)、马赫数——位于一对表示升降舵和副翼偏转的 BiBar 之上。条形下方是升降舵配平、地面状态和失速警告的较小读数。界面以约 20 Hz 刷新——这是 50 Hz 控制环路的降采样视图。

左侧面板的底部是一个列表 效果组开关:摇杆手感、发动机震动、机身抖振、地面滚行、机械肩部、轴载荷和自动驾驶仪跟随。每行都有一个复选框、实时状态和紧凑的电平条。可将它们用作飞行中 A/B 对比的快速静音开关;每个效果的增益仍保留在调校页面。开关状态是活动配置文件的一部分。

右面板:摇杆活动。标题列出贡献最强的动态分量,堆叠条按类别将它们分组,激活通道标签在重要时显示各自的数值。回中弹簧被视为基准手感,因此激活列表聚焦于高于该基准的变化:配平中心、G 载荷弹簧变化、轴载荷、发动机震动、地面滑跑、抖振和机械一次性效果。轴载荷条使用与弹簧载荷分量不同的蓝色;回中弹簧部分显示系数、死区和俯仰/滚转中心。

第 7 章调校

调校页面:主增益强调卡,下方是按子系统分组的效果滑块(力、配平、摇杆手感、地面效应、气动抖振、发动机、单次效果、自动驾驶),每个滑块带有重置箭头和未保存更改指示器。 调校页面:主增益强调卡,下方是按子系统分组的效果滑块(力、配平、摇杆手感、地面效应、气动抖振、发动机、单次效果、自动驾驶),每个滑块带有重置箭头和未保存更改指示器。
图 7.1。 调校页面:主增益强调卡,下方是按子系统分组的效果滑块(力、配平、摇杆手感、地面效应、气动抖振、发动机、单次效果、自动驾驶),每个滑块带有重置箭头和未保存更改指示器。

每次滑块更改都会在下一个 50 Hz 节拍生效;您可以将“调校”页面固定在第二台显示器上,一边飞行一边实时调整正在发生的效果。

7.1 主增益

在设备输出端施加的单个乘数,以 0% 到 100% 的百分比显示。100% 是设计水平(也是默认值);较低的值会衰减 FFB-Bridge 发送的一切,包括回中弹簧系数、空速力、震动、抖振、持续阻力和一次性效果。0% 则不发送任何力输出。没有高于 100% 的「增幅」——该上限正是各逐效果增益滑块所能调到的上限。在此滑块之下,FFB-Bridge 以设备全部权限的 95% 驱动设备,留出 5% 的余量。

大师增益卡。 大师增益卡。
图 7.2。 大师增益卡。

7.2 滑块组

从上到下:回中弹簧(基础、低速下限、G 增益、最小/最大限幅、死区)·气动载荷(俯仰增益、滚转增益)·配平(一 启用配平 开关,升降舵优先)· 摇杆手感(控制系统感觉 选择器,速率阻尼,控制边缘奖励, 摇杆下垂)· 地面效应(跑道隆隆声、接地重击、起落架颠簸、刹车颤振、 前轮摆振, 地面加速俯仰提示,以及 起落架类型 轮式/滑橇/浮筒选择器)· 气动抖振(失速、超速、马赫、扰流板、湍流,外加一个失速 振杆器) · 动力装置(发动机隆隆声、反推隆隆声) · 一次性效果(起落架放下、襟翼分级) · 自动驾驶(低权限 AP 提示)。完整参考请参见第 12 章。

7.3 摇杆失力

杆下落模拟低空速下空载升降舵上的重力偏差——正是它让停放的通用航空飞机的驾驶杆稍微偏向中心前方。两个滑块: (偏差的拉力有多大)和 空速渐弱 (偏置衰减到零时的速度 kts)。默认值为 Cessna 级——将力降至 0,即可在喷气机或电传飞控配置文件上将其关闭。

7.4 配平

Trim 是一个开关: 启用配平,靠近调整页面顶部。有了它 ,配平会减轻所保持的、随空速加载的力(按以下对象计算 (升降舵 − 配平))并将居中目标移至配平位置,因此在摇杆居中的配平稳定状态下,您会感觉到接近零的力,释放时摇杆会稳定在配平位置——就像真实的钢索摇杆的表现。启用它后 关闭,配平对摇杆没有任何作用。升降舵是主要控制面;副翼配平强度位于一个 高级 披露。 (早期版本有第二条隐藏的仅中心修剪路径,即使在修剪关闭的情况下也能保持移动摇杆 - 该路径已被淘汰,因此“启用修剪”关闭现在真正关闭修剪。)

7.5 操纵系统手感

顶部的每架飞机选择器 摇杆手感 组具有三个设置: 手册, 液压助力, 和 电传飞控。它调节现有的定心力和空气动力加载力,以匹配真实飞机的控制感觉:

  • 手册 (默认)—机械/电缆控制;基本感觉没有变化。
  • 液压助力 ——像人工感觉系统那样减轻气动载荷,但不会将其消除。
  • 电传飞控 — 抑制气动载荷和 G 载荷增刚效应,匹配弹簧回中的侧杆手感。

内置启动配置会按机身设置此项 — GA 和涡轮螺旋桨启动配置为手动,747-8 为液压增压,A320neo 为电传飞控 — 因此启动配置是选择哪种模式的良好参考。

7.6 滑块交互

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

7.7 已修改指示与重置

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

已修改行上的逐滑块和逐分区重置箭头;分区标题上对应的字形;配置文件选择器上的“已修改”圆点。 已修改行上的逐滑块和逐分区重置箭头;分区标题上对应的字形;配置文件选择器上的“已修改”圆点。
图 7.4。 已修改行上的逐滑块和逐分区重置箭头;分区标题上对应的字形;配置文件选择器上的“已修改”圆点。

7.8 保存

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

第8章配置文件

配置文件页面:入门预设和已保存的配置文件集中在一个可搜索的列表中,并高亮显示当前生效的配置文件。 配置文件页面:入门预设和已保存的配置文件集中在一个可搜索的列表中,并高亮显示当前生效的配置文件。
图 8.1。 配置文件页面:入门预设和已保存的配置文件集中在一个可搜索的列表中,并高亮显示当前生效的配置文件。

保存的配置文件是 JSON 文件,位于 %APPDATA%\ffb-bridge\profiles\ (Windows)或 ~/.config/ffb-bridge/profiles/ (Linux,荣誉 $XDG_CONFIG_HOME;macOS 使用相同的路径)。每个文件就是一个配置文件。在不同机器之间复制它们,或通过电子邮件发送文件与他人分享。

还有一个免费社区 配置文件库FFB-Bridge.com/profiles:浏览并下载其他用户发布的配置文件(无需账户),并用地球图标发布您自己的配置文件 分享 「个人资料」页面上的「分享」操作。分享会把配置文件提交到配置文件库,并预先填好提交表单;只有在发布的那一刻您才需要登录,不会静默上传任何内容,内置的入门预设也无法分享。共享配置文件以向前兼容的格式传输,携带描述性元数据,并能干净地迁移到较新的应用版本中;纯手工复制的文件仍像以前一样可用。社区论坛位于 FFB-Bridge.com/community.

入门配置文件和已保存的配置文件共用一个列表。操作: 使用选定的配置文件, 重复选择, 删除所选项, 和 刷新。入门预设是只读的;使用“复制”或“另存为”获得可编辑的副本。

配置文件库列表,包含内置起始行、活动配置文件突出显示和选定配置文件操作。 配置文件库列表,包含内置起始行、活动配置文件突出显示和选定配置文件操作。
图 8.2。 配置文件库列表,包含内置起始行、活动配置文件突出显示和选定配置文件操作。

内置启动配置以 MSFS 机型命名:Cessna 172 Skyhawk (G1000)、Daher TBM 930、Beechcraft King Air 350i、Airbus A320neo 和 Boeing 747-8 Intercontinental。切换配置文件会在下一个 50 Hz 节拍上生效,无需撤防。调校页面上的配置文件选择器会显示一个琥珀色圆点表示未保存的更改 — 请在加载另一个配置文件之前保存,否则您将丢失这些更改。

第9章支持页面 — 诊断选项卡

支持页面内的诊断选项卡——分类摘要、运行时信号、可搜索的事件日志,以及支持包导出。 支持页面内的诊断选项卡——分类摘要、运行时信号、可搜索的事件日志,以及支持包导出。
图 9.1。 支持页面内的诊断选项卡——分类摘要、运行时信号、可搜索的事件日志,以及支持包导出。
分类摘要特写。 分类摘要特写。
图 9.2。 分类摘要特写。

“诊断”选项卡是更深入的分诊界面。顶部的四张卡片显示 设备, 数据源, 强制输出, 和 记录健康状况 在深入研究细节之前。运行时面板显示当前会话的正常运行时间、数据寿命、UI 遥测速率、控制循环速率、目标速率、活动/分配效果、重新断言和异常计数。

事件日志可搜索并按级别过滤。信息、警告和错误开关按严重程度筛减,搜索框匹配任意子字符串,并且 复制可见 准确导出当前显示的行。使用 复制完整日志导出完整日志... 当支持需要整个磁盘会话日志时。

可搜索的事件日志。 可搜索的事件日志。
图 9.3。 可搜索的事件日志。

支持包 按钮生成单个 ZIP 用于反馈报告。导出后,该选项卡会显示文件名、大小、反馈表单链接以及 显示文件 桌面上可以打开捆绑包的位置。完整内容列表请参见第 15 章。

捆绑导出的横幅,包含文件名、大小和反馈表单链接。 捆绑导出的横幅,包含文件名、大小和反馈表单链接。
图 9.4。 捆绑导出的横幅,包含文件名、大小和反馈表单链接。

第10章运行状况检查与硬件设置

默认运行状况检查选项卡上的支持页面。 默认运行状况检查选项卡上的支持页面。
图 10.1。 默认运行状况检查选项卡上的支持页面。

10.1 健康检查

支持页面打开时位于 健康检查 选项卡。点击 运行检查 以探测受支持的摇杆、MSFS SimConnect 配置及其可达性、X-Plane 可达性以及运行时状态。各行独立更新,并使用 PASS、INFO、WARN、FAIL、READY、CHECKING 和 N/A 状态,因此未运行的模拟器不会与出故障的模拟器相混淆。

在修复显而易见的地方,该行提供了内联操作 - 安装 udev 规则, 使用端口:X, 修复..., 或 显示。 “修复”对话框准确显示应用之前将发生的更改,并且绝不会覆盖现有条目。

修复 SimConnect 配置安装对话框。 修复 SimConnect 配置安装对话框。
图 10.2。 修复 SimConnect 配置安装对话框。

10.2 设置硬件

设置页面的 硬件 选项卡承载 反转轴极性 和实时拖动板 极性测试。FFB2 的不同生产批次读取的极性不同;该测试通过实时从 2 轴拖动板驱动摇杆来验证您这台是哪个方向。单击“开始”,移动滑块,单击“停止”,然后回答“摇杆跟随滑块了吗?”——选“是”不做更改,选“否”则自动翻转开关。该开关是安装级的,会同时翻转俯仰轴和滚转轴。

设置的硬件选项卡 — 极性、软件混合的周期性效果,以及硬件效果探测。 设置的硬件选项卡 — 极性、软件混合的周期性效果,以及硬件效果探测。
图 10.3。 设置的硬件选项卡 — 极性、软件混合的周期性效果,以及硬件效果探测。

10.3 软件混合周期

该桥有两种方式向 FFB2 发送周期性和一次性效果。 硬件模式 ——全新安装的默认设置——直接在 SideWinder FFB2 上使用原始 HID/PID 力输出,并在需要时保留 DirectInput 作为兼容性后备。当前的 Windows 版本刻意将该拓扑保持得很小:一个矢量恒力、一个两轴弹簧和一个惰性三槽周期效果池。固件仍以原生速率驱动周期波形;FFB-Bridge 将这些物理槽位重新用于跑道、发动机、抖振和一次性提示。 软件混合周期效果,在同一“设置”→“硬件”选项卡上,仅保留连续力/居中硬件路径,并以 200 Hz 的频率在 C# 中合成周期性/一次性提示,将结果折叠到恒力输出中。

硬件模式在最高频效果上更清脆、延迟更低,因为固件驱动它们的速度比网桥的节拍率更快。软件混合是面向硬件探测失败、归类的硬件效果崩溃,或刻意偏好它的用户的兼容性回退方案;普通的非正常退出本身不会强制启用软件混合。它的高频边缘手感会略显柔和。两种方式都需要重启——调度器在启动时读取该模式。使用 测试硬件效果 在单独的工作进程中安全地尝试紧凑的硬件拓扑。

写入系统路径的 Linux 操作 pkexec。退出代码:0 = 成功,126 = 用户取消提示,127 = 身份验证失败/没有 polkit 代理。

第11章Mock Sim

模拟 Sim 页面。 模拟 Sim 页面。
图 11.1。 模拟 Sim 页面。

Mock Sim 是力反馈管线的台架测试模式。先在页面顶部醒目的行中启用 Mock Sim,然后使用顶部状态条中的普通 Arm 按钮。Dashboard 和状态条会把来源标识为演示,而不是实时模拟器。

这些场景被有意夸大处理,以便每一类力在摇杆上都很明显:起飞滑跑、刹车抖动、湍流、襟翼抖振、扰流板抖振、失速抖振、超速抖振以及速率阻尼。它们是演示,而不是经过调校的机型配置文件。

场景预设栏。 场景预设栏。
图 11.2。 场景预设栏。

直接摇杆测试会直接移动弹簧中心:拖动圆点,即使在 0 KIAS 下,物理摇杆也应追随它。这是在飞行前验证力路径、回中弹簧和极性的最快方式。

关闭 Mock Sim 会停止力反馈输出、重置所有模拟输入,并让 bridge 返回 Live。如果真实模拟器已连接,页面会用说明横幅锁定,确保实时遥测仍是唯一来源。

锁定横幅。 锁定横幅。
图 11.3。 锁定横幅。

帮助帮助和导览

帮助页面 — 开始选项卡,包含设置状态、起飞前清单、调校顺序和支持证据。 帮助页面 — 开始选项卡,包含设置状态、起飞前清单、调校顺序和支持证据。
图 H.1。 帮助页面 — 开始选项卡,包含设置状态、起飞前清单、调校顺序和支持证据。

帮助页面不在侧边栏中——它会在首次启动时自动打开,并可随时通过以下方式重新查看 支持 → 资源 → 重播欢迎导览。这是一个选项卡式操作中心。 开始 显示设置状态、飞行清单、建议的调整顺序和支持包路径。 故障排除 对常见症状进行分组,并指向拥有每个修复的页面。 支持 将“诊断”选项卡的支持包导出与反馈表单关联起来。 资源 打开在线文档、可打印手册、反馈、隐私和出版商/法律资源。桌面应用程序在存在捆绑的 PDF 手册时使用它,并在本地文件不可用时回退到在线手册。

设置设置

设置页面 — General、Session 和 Privacy & diagnostics 卡片。 设置页面 — General、Session 和 Privacy & diagnostics 卡片。
图S.1。 设置页面 — General、Session 和 Privacy & diagnostics 卡片。

设置保存的是安装级别的偏好设置,而不是机型调校。 常规 控制关闭按钮行为、主题、 视觉对比 (一个 标准 / 高对比度 该选项可在整个应用范围内提高对比度——表面、文字、边框、按钮、状态灯和效果分组颜色——而不改变任何力输出),以及首次启动的 UI 重置。 会议 控制选择启用的自动布防(当受支持的设备和正在运行的模拟器都就绪时)和自动撤防(当模拟器退出时);两者均默认关闭。 硬件 包含力反馈设备选择器、效果渲染模式、Windows 设备后端、 允许未列出的设备(实验性) 选择加入,以及极性/俯仰-滚动-交换轴测试。 隐私与诊断 打开本机的本地配置和诊断文件夹,并清除崩溃报告或日志文件。

第12章力效应参考

随附效果: v1.2.1:

  1. 回中弹簧 — 随 G 载荷而增刚,死区随空速缩放,中心随配平偏移。
  2. 空速加载的俯仰力 ——恒定的俯仰轴力,按空速² × 升降舵偏移量缩放。
  3. 空速加载滚转力 — 滚转轴上的相同模型,独立调校。
  4. 速率阻尼 — 与体轴旋转速率成正比的反向力 (p, q);粘性阻尼。
  5. 摇杆掉落 — 低空速时升降舵上的重力偏差;停车时向前拉杆,以 Fade 空速(默认 30 节)逐渐减弱。
  6. 自动驾驶跟随 ——可选的低权限弹簧提示,指向自动驾驶仪的飞行指引参考。在当前版本中默认关闭。
  7. 跑道隆隆声 — 按地面速度和表面类型缩放的连续周期性力(草 1.5–1.9×,冰 0.3–0.5×)。
  8. 触地重击 — 地面过渡时的单脉冲;振幅由垂直速度和峰值轮胎负载决定(因此润滑器感觉比牢固到达的感觉更软)。
  9. 刹车颤抖 — 与制动偏转成正比的低频隆隆声,在地面上门控。
  10. 起落架颠簸 — 滑行时的离散脉冲约为 40 节。
  11. 气动抖振 — 七个子效果(失速、超速、马赫、扰流板、襟翼、起落架、湍流)共用一个抖振发生器。
  12. 发动机隆隆声 — 报告时使用模拟装置的每个发动机振动值(涡轮螺旋桨发动机、喷气式飞机);当 sim 未报告时,会回落至合成 RPM 斜坡。
  13. 反推力震动 — 倒车时的滚动隆隆声,按地面速度缩放。
  14. 机械式一次性效果 — 齿轮展开和襟翼步进在任何转换过程中都会颤抖,两个方向。
  15. 持续的气动阻力俯仰力 ——襟翼阻力、扰流板阻力、起落架阻力和螺旋桨洗流俯仰。恒定的俯仰偏置,复现飞行员在构型变化时所感受到的配平变化。
  16. 失速抖杆器 — 模拟器自身的失速警告所门控的尖锐持续嗡嗡声,独立于并补充合成的失速抖振。在 GA 入门配置上默认关闭;在更快的入门配置上默认开启。
  17. 前轮摆动 — 地滚过程中快速的左右(滚转轴)振动,根据飞机进行调整。
  18. 地面加速俯仰提示 — 与地面滚滚过程中的加速度相关的俯仰轴提示。

每架飞机两架 调制器 利用上述效果,而不是添加自己的新通道。的 控制系统感觉 选择器(手动/液压增压/电传飞控)会缩放气动载荷和 G 载荷弹簧的刚度,以匹配机型的控制系统(§ 7.5)。 起落架类型 选择器(轮式/滑橇/浮筒)可缩放连续的地面滑行隆隆感——跑道隆隆、起落架颠簸和前轮摆振。

所有内容都汇总为两个输出(俯仰 + 滚转力,加上弹簧参数)。主增益在设备输出端应用于所有力输出,包括弹簧系数;如果您的硬件读取的极性相反,安装级的俯仰/滚转极性反转(设置 → 硬件)会在设备输出端同时反转两个轴。仪表盘将基线弹簧与活动的动态通道分开,因此您可以随时看到在任一时刻有哪些效果在起作用。

配平 更改效果 1(定心弹簧)和 2 / 3(空速加载的俯仰/横滚力)的输入。与 启用配平 上,他们引用 (杆位 − 配平) 和居中目标跟踪修剪位置 - 在使用中立杆的修剪稳定状态下,保持力减弱,释放时杆稳定在修剪位置。关闭它后,修剪根本不会移动摇杆。单个开关位于“调整”页面顶部附近(升降舵优先;副翼强度在“高级”下)。

软件混合周期效果 是调度模式选择,而不是功能切换。两种模式均已完全调整 - 相同的效果目录,相同的滑块。在 硬件 模式(全新安装的默认设置)下,网桥会分配一个矢量常量、一个两轴弹簧,以及一个惰性的 Sine / Triangle / Triangle 定期池。在 软件混合 模式下,桥只保留连续力/回中的硬件路径,并以 200 Hz 在 C# 中合成周期性/一次性提示。在「设置」→「硬件」选项卡中切换;需要重启。

暂停与过时遥测安全性不属于效果目录的范畴。模拟器暂停是即时的——一旦 MSFS 或 X-Plane 报告已暂停(或冻结帧看门狗检测到数值停止变化),所有动态力都会在同一节拍内降至零,摇杆保持中性的默认弹簧,直到实时数据恢复。用户可调的 看门狗 滑块控制单独的“SIM 完全消失”淡入淡出时间。

第13章调校指南

先通过“设置 → 硬件”的拖拽板极性测试(第 10 章)验证极性——如果力的方向反了,您在下面设置的每个增益都会作用于错误的符号。然后按顺序逐阶段调整,每个阶段后保存配置文件,以便可以回退。

  1. 主增益。 从 100% 开始。进行巡航飞行,留意电机是否饱和;如果摇杆在完全偏转时感觉过于生硬,就降到 80% 再试一次。这会缩放所有的力,包括弹簧。100% 以上没有额外增强——这是设计上限。
  2. 回中弹簧。 巡航时松开摇杆:是敏捷还是迟滞。然后拉一个 2 G 转弯:它会变硬吗?如果滑行或模拟器断开时的回中感觉太软,请先提高“低速弹簧下限”,再去调整 G 增益。
  3. 摇杆失去力。 停放飞机并关闭发动机——摇杆应略微前倾(模拟空载升降舵上的重力)。用「力」调整静止位置,用「空速淡出」设置该效果在起飞滑跑中消失的时机。对于喷气机/电传飞控配置文件,将「力」设为 0。
  4. 控制系统的感觉。 在调整增益之前,在摇杆感觉顶部设置手动、液压增压或电传操纵以匹配飞机 - 它会缩放空气动力载荷和 G 负载弹簧,因此请先进行设置,否则您的增益会追逐移动目标。
  5. 配平。 决定是否 启用配平 已开启。开:修剪会减轻保持力,并且摇杆会稳定在修剪位置 - 使用中性摇杆进行修剪时,力量接近于零,松开时摇杆会保持住。关闭:修剪对摇杆没有任何作用。在调整负载之前设置它;切换中调会改变感受到的力量。
  6. 空气动力载荷。 不进行配平直接推杆;应该感觉像空气在向后推。在整个速度包线范围内验证。
  7. 地面效应。 在铺装道面与草地上滑行。刹车。来一次稳稳的着陆。
  8. 自助餐。 以断电失速触发失速抖振;放出扰流板触发扰流板抖振。
  9. 机械一击。 缩回/展开起落架和襟翼。
  10. 发动机。 怠速与起飞功率——感觉应该明显不同。
  11. 速率阻尼。 如果摇杆回中后还会来回弹动,请调高它。太高则摇杆会感觉发死、无回馈。

按机型规律:轻型单发飞机需要较硬的回中和适中的载荷;特技飞机需要柔和的回中和低阻尼;重型喷气机需要大阻尼和强力的自动驾驶反向驱动;丛林/短距起降(STOL)机型需要较低的回中基准但较高的 G 增益。从最接近您机型的内置起始配置开始:Cessna 172 Skyhawk (G1000)、Daher TBM 930、Beechcraft King Air 350i、Airbus A320neo 或 Boeing 747-8 Intercontinental。

第14章故障排除

14.1 摇杆不动

在顶部条中,按顺序确认:(1) ARM 仪表显示“已武装”(琥珀色)— 未“已解除武装”或“出现故障”; (2) DEVICE灯为绿色(“Ready”); (3) SIM 灯呈绿色(“Sim 已连接”)。红灯指向支持页面的运行状况检查选项卡上的相应行。

14.2 MSFS 连接但力量感觉不对

加载最接近您机型的起始配置文件。大多数“不对劲”的手感都来自为不同机型类别调校的配置文件。第三方机型偶尔会跳过实现标准 SimVar——网桥能容忍这一点(缺失的变量默认为零),但依赖它们的效果会变得安静。

14.3 托盘图标不出现(Linux)

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

14.4 布防后 Windows 硬件模式崩溃

早期版本可能会在某些 Windows / FFB2 堆栈上崩溃,因为硬件模式创建了一个大型保留的 DirectInput 效果表。这是一个桥接架构错误,而不是 MSFS 或错误的固件。当前硬件路径使用一个矢量常量、一个两轴弹簧和一个惰性三槽周期池,以原始 HID/PID 作为默认 SideWinder FFB2 路径,以 DirectInput 作为后备。 1.0 版还在模拟器断开连接后重新设置之前重置原始 HID/PID 效果表。如果当前构建在硬件模式下仍然崩溃,请运行 测试硬件效果 在“设置”→“硬件”选项卡上进行探测并切换到 软件混合周期效果 如果这座桥能够提供这种恢复。

14.5 启动时崩溃

下次启动会显示一个崩溃报告对话框,其中包含堆栈跟踪和 打开反馈表单 预先附加崩溃日志的按钮。如果应用程序在对话框出现之前崩溃,请手动从 %LOCALAPPDATA%\ffb-bridge\crashes\ (Windows)或 ~/.local/share/ffb-bridge/crashes/ (Linux)。

14.6 暂停或长时间卡顿后力消失

当前版本直接针对此问题。MSFS 暂停和主动暂停会立即抑制动态效果,在暂停时保持一个中性默认弹簧,尽可能在静默期间让弹簧继续作用,并在静默后重播之前重新上传弹簧参数。如果恢复后仍感觉缺少滚转或俯仰力,请立即导出支持包,并记录仪表盘在摇杆活动下显示的内容。

第15章支持捆绑包

支持包是由以下人员生成的单个 ZIP: 诊断 → 支持包。 ZIP 包含且仅包含:

  • sysinfo.txt ——操作系统、内核、发行版、CPU、内存、.NET 版本、区域设置。
  • session.log — 当前会话的完整事件日志。
  • last-crash.log — 崩溃日志(如果存在)。
  • doctor.json — 最后的支持页面扫描以机器可读的形式。
  • tunables.json ——导出时的活动配置文件。
  • hardware-settings.json — 硬件后端、平滑、极性、轴交换和兼容性设置。
  • simconnect.txt — MSFS SimConnect 路径和内容,IP 已遮蔽。

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

支持包绝不会自动离开您的计算机——由您选择何时将其附加到反馈报告,以及是否发送。

导出流程 — 诊断按钮,然后是带有文件名和反馈表单链接的横幅。 导出流程 — 诊断按钮,然后是带有文件名和反馈表单链接的横幅。
图 15.1。 导出流程 — 诊断按钮,然后是带有文件名和反馈表单链接的横幅。

第 16 章许可和免责声明

FFB-Bridge 二进制文件是 Rohsam Inc. 的专有软件,依据《FFB-Bridge 最终用户条款》提供,按原样提供,不附带任何保证。使用风险自负——本程序驱动物理硬件,缺陷可能产生意外的力。请把每次启用都当作「双手离开」的时刻。

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

完整的常见问题解答和隐私政策位于 FFB-Bridge.com/#faqFFB-Bridge.com/privacy.

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