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

X-Plane 11 / 12

X-Plane 不需要特殊设置。 FFB-Bridge 订阅 X-Plane 的内置 UDP dataref 协议(参考文献)在端口 49000 上。X-Plane 端不需要安装任何东西,没有插件,没有 SimConnect 样式的 XML 文件。如果启动桥时 X-Plane 正在运行,则表示您已连接。

自动检测行为

启动时,网桥并行运行两个探针:SimConnect TCP 探针(用于 MSFS)和 X-Plane UDP 探针。第一个返回真实响应的人获胜。实际上这意味着:

  • 如果只有 X-Plane 正在运行,它会在几毫秒内获胜。
  • 如果 MSFS 和 X-Plane 都在运行,则使用先响应的那个 — 如果出现问题,您可以从 CLI 强制进行选择。
  • 如果两者都没有运行,桥就会进入 空闲 模式,直到出现一个。

当 X-Plane 运行并且网桥已成功订阅时,顶部条中的 SIM 指示灯将变为绿色(“Sim 已连接”),并且 MODE 指示灯将显示“Live”。 DEVICE 灯是独立的 - 只要 FFB2 已插入,设备灯就会呈绿色。

确保 X-Plane 未被防火墙阻止

UDP 49000 是网桥在 X-Plane侧接触的唯一端口。全新 X-Plane 安装上的默认 Windows 防火墙规则通常会自动允许这样做; Linux 桌面 firewalldufw 几乎从不阻止环回。如果 X-Plane 启动后桥的事件日志中没有显示任何内容,请打开 医生 — 的 X-Plane可达性 row 尝试探测并告诉您返回了什么(超时、连接被拒绝或实际数据包)。

桥读取的 Datarefs

该桥订阅了 24 个数据引用,这些数据引用与 X-Plane 公开的 MSFS 变量集密切相关。您不需要配置任何内容 - 此处列出以供参考和调试:

  • sim/flightmodel/position/indicated_airspeed
  • sim/flightmodel/position/true_airspeed
  • sim/flightmodel/position/vh_ind (垂直速度)
  • sim/flightmodel/position/theta (音高)
  • sim/flightmodel/position/phi (银行)
  • sim/flightmodel/position/psi (标题)
  • sim/flightmodel/forces/g_nrml (负载系数)
  • sim/flightmodel/position/alpha (迎角)
  • sim/flightmodel2/controls/yoke_pitch_ratio
  • sim/flightmodel2/controls/yoke_roll_ratio
  • sim/flightmodel2/controls/pitch_trim
  • sim/flightmodel2/controls/roll_trim
  • sim/cockpit/warnings/annunciators/stall_warning
  • sim/flightmodel/failures/over_vne
  • sim/flightmodel2/controls/gear_handle_down
  • sim/flightmodel2/controls/flap_handle_deploy_ratio
  • sim/flightmodel2/controls/speedbrake_ratio
  • sim/flightmodel/engine/ENGN_running[0..3]
  • sim/flightmodel/engine/ENGN_N1_[0..3]
  • sim/cockpit2/autopilot/autopilot_on
  • sim/cockpit2/autopilot/heading_dial_deg_mag_pilot
  • sim/flightmodel2/gear/on_ground_fraction
  • sim/flightmodel/misc/h_ind (气压高度)
  • sim/operation/override/override_throttles (用于反向推力检测)

陈旧和重新连接

UDP 没有断开连接信号,因此桥接器运行自己的看门狗:如果三秒内没有数据引用到达,它将将该会话视为已死亡,并且 西姆 芯片变红。重新启动 X-Plane 或加载新航班会自动重新建立连接 - 您无需重新启动桥接器。

暂停与加载

X-Plane 暂停继续发送 datarefs(只是冻结值),因此桥保持不变 已连接 但过时看门狗不会跳闸。在菜单级屏幕(飞机选择、位置对话框)期间,X-Plane 短暂停止发射;当航班恢复时,驾驶台会将 SIM 指示灯恢复为灰色(“SIM 未运行”)并再次变为绿色。

非默认 X-Plane 安装

免费和付费的 X-Plane 二进制文件默认绑定 UDP 49000。如果您更改了 X-Plane 的 UDP 端口(设置 → 网络 → UDP 端口),网桥当前不会公开备用端口的 UI — 使用 X-Plane 的默认值或 告诉我们 这样我们就可以优先考虑它。