openpilot 与原厂 ADAS 的共存机制：LKA、ACC、LDW 与 FCW 的替换/保留策略解析

本文基于 openpilot 仓库的集成说明文档 docs/INTEGRATION.md 展开，讲清楚 openpilot 接管车辆后与原厂（stock）驾驶辅助功能之间的三条基本关系——“替换、并存、保留”——分别适用于哪些功能、哪些车型，并深入源码印证 openpilot LDW、FCW 与原厂功能的实际判定逻辑，帮助读者准确理解 openpilot 在不同支持车型上的接管边界。

一、集成总原则：三类功能关系

docs/INTEGRATION.md 给出的集成规则可以归纳为一张表：

原厂功能	与 openpilot 的关系	适用车型范围
原厂车道保持辅助（LKA）/ 自动车道居中（ALC）	替换：由 openpilot ALC 取代，且仅在用户激活 openpilot 时工作	所有支持车型
原厂车道偏离预警（LDW）	替换：由 openpilot LDW 取代	所有支持车型
原厂自适应巡航（ACC）	替换：由 openpilot ACC 取代	仅特定支持车型（见 CARS.md 的 ACC 列）
前向碰撞预警（FCW）	并存：openpilot FCW 与原厂 FCW 同时工作	特定支持车型
AEB、自动大灯（auto high-beam）、盲点预警（BSW）、侧碰撞预警（SCW）等	保留：openpilot 不应影响这些功能	所有支持车型

核心设计意图是：openpilot 只接管自己负责的纵向/横向控制链路，其余安全功能继续由车辆原生 ECU 独立运行。文档原文明确要求 “openpilot should preserve all other vehicle's stock features”，即 AEB、自动大灯、盲点预警、侧碰撞预警等必须原样保留。

二、如何判断一台车属于哪种集成模式：CARS.md 的 ACC 列

INTEGRATION.md 指出，判断某车型是否由 openpilot 接管 ACC，需查看 docs/CARS.md 中的 ACC 列。该表格是由 openpilot/selfdrive/car/CARS_template.md 模板自动生成的（文件头注释标明 AUTOGENERATED FROM openpilot/selfdrive/car/CARS_template.md, DO NOT EDIT），模板中通过 $table_header、$table_rows、$footnotes 占位符注入车型数据与脚注。

从 CARS.md 的实际表格行可以看到 ACC 列的几种取值：

• openpilot：纵向控制由 openpilot 完整接管，例如 Acura ILX 2016-18、Ford Bronco Sport 2021-24 等；
• openpilot available[<sup>1</sup>]：openpilot 纵向控制为可用（通常对应社区维护或 alpha 级别的支持，见表格脚注 1）；
• Stock：纵向控制仍由原厂 ACC 完成，例如 Chrysler Pacifica 2021-23、Genesis G80 2018-19，此时 openpilot 只提供横向控制。

其中一条对集成边界影响很大的脚注是（docs/CARS.md L363）：

¹⁶Only available for vehicles using a gateway (J533) harness. At this time, vehicles using a camera harness are limited to using stock ACC.

即大众系（VW J533 网关）车型：只有使用 J533 网关线束的车型才能由 openpilot 接管 ACC，使用摄像头线束的车型只能保留原厂 ACC。这解释了为什么集成模式不只取决于车本身，还取决于 comma 设备接入 CAN 总线的具体方式。

从源码结构看，这种模式差异最终落在 CarParams 消息上：openpilot/selfdrive/car/card.py 中的 Car 类在初始化时通过 get_car() 得到车辆接口，将 self.CI.CP（即 car.CarParams）序列化后写入 CarParams 等持久化参数（L147-L150），随后 controls、selfdrived 等进程都依据该消息中的字段（如 openpilotLongitudinalControl、dashcamOnly）决定自己的行为。例如：

• 当纵向控制不由 openpilot 承担时，实验模式（纵向接管）会被禁用，对应 UI 提示见 openpilot/selfdrive/ui/layouts/settings/toggles.py L182："Experimental mode is currently unavailable on this car since the car's stock ACC is used for longitudinal control."
• 当车辆仅以行车记录仪模式运行时，card.py 会将安全模型强制为 safetyModel.noOutput（L114-L118），openpilot 退化为纯监控状态，所有原厂功能自然全部保留。

三、横向接管：原厂 LKA/ALC 如何被 openpilot ALC 取代

INTEGRATION.md 规定原厂 LKA/ALC 被 openpilot ALC 取代，且“only functions when openpilot is engaged by the user”——即横向控制仅在用户激活（长按启用）openpilot 时生效，未激活时 openpilot 不输出转向控制。

仓库中能看到 openpilot 对“原厂 LKAS 状态”有明确的交互要求。openpilot/selfdrive/selfdrived/events.py L375-L383 定义了 invalid_lkas_setting_alert：

def invalid_lkas_setting_alert(CP, CS, sm, metric, soft_disable_time, personality) -> Alert:
  text = "Toggle stock LKAS on or off to engage"
  if CP.brand == "tesla":
    text = "Switch to Traffic-Aware Cruise Control to engage"
  elif CP.brand == "mazda":
    text = "Enable your car's LKAS to engage"
  elif CP.brand == "nissan":
    text = "Disable your car's stock LKAS to engage"
  return NormalPermanentAlert("Invalid LKAS setting", text)

这段告警逻辑印证了集成机制的一个重要细节：不同品牌对“允许接管”的原厂 LKAS 状态要求不同（特斯拉要求切到 TACC 模式、马自达要求开启 LKAS、日产要求关闭 LKAS），因此“替换原厂 LKA”不是简单屏蔽信号，而是各车辆接口（vehicle interface）在车辆初始化阶段校验的约束条件，校验不通过时 openpilot 拒绝激活并给出品牌定制的提示。

四、openpilot LDW 的实现：替换原厂 LDW 的判定逻辑

被替换后的车道偏离预警由 openpilot 自己实现，核心代码在 openpilot/selfdrive/controls/lib/ldw.py，关键参数与逻辑如下：

CAMERA_OFFSET = 0.04
LDW_MIN_SPEED = 31 * CV.MPH_TO_MS      # 31 mph 以上才触发
LANE_DEPARTURE_THRESHOLD = 0.1         # 变道意图概率阈值

LaneDepartureWarning.update() 的判定流程（L16-L37）：

1. 生效前提：车速高于 31 mph、近 5 秒内未打转向灯（recent_blinker 冷却）、横向控制未激活（not CC.latActive，即 LKA 未接管时 LDW 才有意义）；
2. 车道线可见性：使用模型输出 modelV2.laneLineProbs，左/右侧车道线概率需大于 0.5 才认为该侧车道线可见；
3. 车道线接近判定：车道线在自车处的横向位置 lane_lines[y] 超过 ±(1.08 ± CAMERA_OFFSET) 米（相机标定偏移 0.04 m）认为已贴边；
4. 变道意图判定：结合 modelV2.meta.desirePrediction 中 laneChangeLeft / laneChangeRight 的概率，超过 LANE_DEPARTURE_THRESHOLD = 0.1 才告警，避免驾驶员有明确变道意图时误报。

从源码结构看，该模块位于 selfdrive/controls/lib/ 下，由控制循环（controlsd）每帧更新，最终以 warning 属性汇总左右两侧状态，供 UI 提示与告警链路消费。也就是说，INTEGRATION.md 中 “Stock LDW is replaced by openpilot LDW” 一句，在代码层面体现为：openpilot 用自己的视觉模型输出取代了原厂 LDW 的触发源，并额外加入了转向灯冷却、变道意图抑制等原厂告警通常不具备的抑制条件。

五、ACC 替换与 FCW 并存：selfdrived 中的 FCW 判定代码

对纵向接管（openpilot ACC）的车型，“openpilot FCW operates in addition to stock FCW”（openpilot FCW 与原厂 FCW 并存工作）。这段规则的实际判定逻辑在 openpilot/selfdrive/selfdrived/selfdrived.py L436-L441：

# Check for FCW
stock_long_is_braking = self.enabled and not self.CP.openpilotLongitudinalControl and CS.aEgo < -1.25
model_fcw = self.sm['modelV2'].meta.hardBrakePredicted and not CS.brakePressed and not stock_long_is_braking
planner_fcw = self.sm['longitudinalPlan'].fcw and self.enabled
if (planner_fcw or model_fcw) and not self.CP.notCar:
  self.events.add(EventName.fcw)

逐行拆解这段与集成规则一一对应的逻辑：

• planner_fcw：纵向规划器（longitudinalPlan.fcw）给出的 FCW，仅在 openpilot 激活且由 openpilot 负责纵向控制（即 ACC 列标注为 openpilot 的车型）时可能置位；
• model_fcw：基于视觉模型 hardBrakePredicted（预测前车急刹）的 FCW，需满足驾驶员未踩刹车；
• stock_long_is_braking：这一行是“FCW 与原厂 FCW/AEB 共存”的关键协调——当车型使用原厂 ACC（not self.CP.openpilotLongitudinalControl）且自车减速度小于 -1.25 m/s² 时，认为原厂纵向系统正在急刹（原厂 FCW/AEB 很可能已介入），此时抑制 openpilot 的模型 FCW，避免与原厂系统双重告警、干扰驾驶员。

因此，openpilot 的 FCW 是“叠加层”：两条触发路径（规划器 FCW 与模型 FCW）任何一条成立即触发 EventName.fcw，同时在“原厂纵向正在急刹”的场景主动让位。FCW 事件本身的告警定义见 openpilot/selfdrive/selfdrived/events.py L493 起的 EventName.fcw 条目（VisualAlert.fcw、最高优先级）。

仓库的 RELEASES.md 中还保留了该集成策略的历史演进证据，例如 L652 的 “Forward stock FCW for Honda Nidec” 与 L684 的 “Forward stock AEB for Honda Nidec”，说明在部分车型（Honda Nidec 转向架构）上，openpilot 对保留类功能采用的是“转发原厂信号”的实现方式，保证原厂 FCW/AEB 在 openpilot 安装后依然可用——这正是 INTEGRATION.md 中“preserve all other stock features”承诺在代码层面的落地手段之一。

六、实战核对清单：验证你的车型处于哪种集成模式

1. 查车型表：在 docs/CARS.md 中找到车型，读取 ACC 列：
   • openpilot / openpilot available：纵向由 openpilot 接管，FCW 由 openpilot 规划器与视觉模型双路径提供；
   • Stock：纵向保留原厂 ACC，openpilot 仅提供横向控制，且实验模式（纵向 alpha 功能）不可用。
2. 看脚注：注意 ACC 列脚注标记（如 ¹⁶ 的 J533 网关线束限制），集成模式可能与所用 harness 相关。
3. 看 CarParams：运行时 card 进程发布的 carParams 消息（写入自 openpilot/selfdrive/car/card.py L147-L150 的持久化参数）中的 openpilotLongitudinalControl 字段是各进程判断纵向归属的最终依据，selfdrived.py L437 的 stock_long_is_braking 判定即直接读取该字段。
4. 确认保留功能：AEB、自动大灯、盲点预警、侧碰撞预警等不在 openpilot 接管清单内，安装后应保持可用；若出现失效，属于集成缺陷而非预期行为。

小结

INTEGRATION.md 用短短一段文字定义了 openpilot 与原厂 ADAS 的边界契约：横向（LKA/ALC/LDW）全面替换且仅在激活时生效，纵向（ACC）按车型选择性替换，FCW 叠加运行，其余安全功能一律保留。仓库源码逐条印证了这一契约：车型模式由 CarParams 中的纵向控制字段驱动（card.py）、openpilot LDW 由视觉模型独立判定（ldw.py）、FCW 判定中对原厂急刹场景显式让位（selfdrived.py）、不同品牌的 LKAS 前置状态由事件系统强制校验（events.py）。理解这套替换/并存/保留的三层结构，是理解 openpilot 车辆支持矩阵（CARS.md）以及各厂商车辆接口实现差异的基础。