openpilot 支持车辆体系全解析：335 款车型的判定规则、CARS.md 生成机制与新车适配条件

openpilot 支持车辆体系全解析335 款车型的判定规则、CARS.md 生成机制与新车适配条件【免费下载链接】openpilotopenpilot is an operating system for robotics. Currently, it upgrades the driver assistance system on 300 supported cars.项目地址: https://gitcode.com/GitHub_Trending/op/openpilotdocs/CARS.md是 openpilot 项目中唯一权威的支持车辆清单它用一张由脚本自动生成的大表定义了当前 335 款受支持车型的硬件门槛、功能边界纵向控制可用性、低速能力限制以及安装所需的硬件清单。本文基于该文档逐列拆解表格语义与全部脚注并结合仓库源码生成脚本、模板文件、集成说明说明这份清单是如何从车型定义自动产出、又是什么条件决定一辆车能不能被支持。什么是受支持车辆Supported Car原文的定义非常直接见 docs/CARS.md 开篇A supported vehicle is one that just works when you install a comma device.即装上 comma 硬件设备后开箱即用的车。文档同时给出两条前提所有受支持车型提供的体验都优于原厂系统表格默认以美国市场车型为参照除非条目中明确标注了其他市场例如 Honda City (Brazil only) 2023、Kia Carnival (China only) 2023、Hyundai Ioniq 5 (Southeast Asia and Europe only) 2022-24 等。当前仓库快照中标题为# 335 Supported Cars即本清单收录 335 款上游upstream支持车型覆盖 Acura、Audi、Chevrolet、Chrysler、comma自研平台 car body、CUPRA、Dodge、Ford、GMC、Genesis、Honda、Hyundai、Jeep、Kia、Lexus、Lincoln、MAN、Mazda、Nissan、Ram、Rivian、SEAT、Subaru、Škoda、Tesla、Toyota、Volkswagen 等品牌。注意支持数量本身就是一个动态值——它由生成脚本按车型定义实时统计填入见下文源码部分。逐列读懂支持车型表表格列结构为Make | Model | Supported Package | ACC | No ACC accel below | No ALC below | Steering Torque | Resume from stop | Hardware Needed | Video | Setup Video。下面结合表中真实行解释每列语义。Supported Package功能生效的配置前提不是同品牌所有车都能装必须是带特定驾驶辅助配置的车型。表中典型例子Acura ILX 2016-18→ Technology Plus Package or AcuraWatch PlusHonda Civic 2016-18→ Honda SensingSubaru Crosstrek 2018-19→ EyeSight Driver Assistance脚注 7 补充非美市场要求带 Lane Keep Assistance 的 EyeSightNissan Altima 2019-24→ ProPILOT AssistChevrolet Bolt EUV 2022-23→ Premier 或 Premier Redline 配置且不带Super Cruise PackageAudi / VW 全系→ Adaptive Cruise Control (ACC) Lane Assist脚注 12 说明 J533 线束插在转向柱上方、仪表台下方的 CAN 网关处Subaru 全表→ 脚注 7openpilot 复用其 EyeSight 车道功能。ACC 列三种状态区分纵向控制实现方这是整张表信息密度最高的一列只有三种取值形态取值含义表内示例Stock纵向加减速由原厂 ACC控制openpilot 只接管横向与车道保持Toyota Prius 2017-20、Chrysler Pacifica 2017-18、Subaru Ascent 2019-21、Mazda CX-5 2022-25openpilot纵向由 openpilot 完整控制已正式可用Ford Bronco Sport 2021-24、Lexus ES 2019-25、Rivian R1S/R1T 2022-24、Toyota RAV4 2019-21openpilot available[1,5]/openpilot available[1,16]纵向控制处于Alpha阶段需手动开关且受附加条件限制Honda Accord 2018-22、Acura MDX 2022-24、全部 VW 系对应脚注docs/CARS.md Footnotes 一节脚注 1openpilot Longitudinal Control (Alpha) 通过一个开关启用该开关只存在于nightly-dev等非 release 分支脚注 5开启纵向控制alpha会禁用全部 CMBS 功能包括 AEB 和 FCW本田系脚注 8同理Subaru 上开启纵向控制会禁用 EyeSight 全部功能AEB、LDW、RAB脚注 16alpha 纵向目前仅限使用J533 网关线束的车辆使用摄像头线束的车辆只能用原厂 ACC。No ACC accel below / No ALC below低速能力下限两列分别表示低于该速度时纵向无法加速起步/跟停与低于该速度时车道保持不工作。取值规律在表里非常清晰纵向为openpilot控制的车型普遍是0 mph全程可用纵向为Stock的车型则继承原厂 ACC 的低速限制例如Hyundai Elantra 2017-18为 19 mph、Chrysler Pacifica 2019-20为 39 mph、Acura ILX 2016-18为 26 mph、Mazda CX-9 2021-23的 ALC 下限为 28 mph特例带脚注Toyota Camry系列标0 mph[11]脚注 11 解释不带 Full-Speed Range DRCC 的 4CYL L/LE/SE 实际从 28 mph 以上才工作Honda Civic 2019-21的 ALC 下限为2 mph[4]脚注 4 指出 2019 款 1.6L 柴油版低于 12 mph 无 ALC。Steering Torque / Resume from stop星号图标两列这两列用 SVG 星形图标空心 不支持实心 支持表示Steering Torque车辆横向控制采用扭矩接口openpilot 直接下发转向扭矩而非角度/力矩混合Resume from stop是否支持 Stop Go完全停稳后自动恢复跟车。例如老平台 HondaHonda Pilot 2016-22、Honda Odyssey 2018-20两列均为空心星表示无扭矩控制、无停走功能而Hyundai Kona Electric 2018-21、Rivian R1T 2022-24等均为实心双星。Hardware Needed逐车型硬件 BOM每行展开HTMLdetails列出精确配件典型组合为厂商线束连接器如Honda Nidec connector、Ford Q3/Q4 connector、VW J533 connector、Hyundai H connector OBD-C 线 comma four harness box 支架部分品牌Honda、Hyundai、Ford、Chrysler、Nissan、Mazda、Rivian还需comma power v3VW 系与 Nissan 等需加长 OBD-C 线9.5 ftSubaru 额外列出工具撬棒、8mm 深套筒。文档背后的生成链路从 opendbc 到 CARS.mddocs/CARS.md 第 1 行注释表明它是自动产物!--- AUTOGENERATED FROM openpilot/selfdrive/car/CARS_template.md, DO NOT EDIT. ---生成逻辑在 openpilot/selfdrive/car/docs.py 中关键事实输出路径与模板路径为常量CARS_MD_OUT docs/CARS.md、CARS_MD_TEMPLATE openpilot/selfdrive/car/CARS_template.mddocs.py#L10-L11车型文档数据来自opendbc子模块的opendbc.car.docs.get_all_car_docs()列定义与枚举Column、SupportType来自opendbc.car.docs_definitionsdocs.py#L7-L8表格只收录SupportType.UPSTREAM的车型generate_cars_md中c.support_type SupportType.UPSTREAM过滤社区车型不进主表docs.py#L42-L46_build_cars_table()逐列调用car_docs.get_column(...)渲染单元格其中Hardware Needed列被替换成一个 2000px 宽的占位图a href##img width2000/aHardware Needed目的是强制该列在渲染后加宽容纳配件清单docs.py#L16-L18星形与视频图标也是在这里拼装的STAR_ICON star、VIDEO_ICON指向assets/icon-youtube.svgdocs.py#L14-L15标题中的数量335由supported_countlen(upstream_cars)注入模板占位符$supported_countCARS_template.md 第 7 行脚注区由get_all_footnotes()统一编号输出正文中的supn/sup锚点即FOOTNOTE_TAG模板docs.py#L13命令行用法python openpilot/selfdrive/car/docs.py [--template X] [--out Y]默认写入docs/CARS.md。一致性有测试兜底openpilot/selfdrive/car/tests/test_docs.py 会调用generate_cars_md(all_cars, CARS_MD_TEMPLATE)验证生成流程可用同目录的 test_car_interfaces.py、test_cruise_speed.py 则分别校验各车型接口实现与设定车速逻辑。车型定义本体存放在 git 子模块opendbc见 .gitmodules 中[submodule opendbc] path opendbc_repo因此克隆仓库后需初始化子模块才能跑通完整生成链路。表格数值与运行时限制的对应关系CARS.md 中0 mph / 26 mph等逐车限制描述的是该车型原厂硬件的接口下限而 openpilot 自身的运行速度窗口在全局层面定义于 openpilot/selfdrive/car/cruise.pyV_CRUISE_MIN 8kph、V_CRUISE_MAX 145kph注释明确这是依据模型训练分布确定的边界超出后预测不可靠。两者共同构成实际可用速度 车型接口下限表中两列∩ openpilot 全局窗口。支持车型上 openpilot 接管了哪些原厂功能结合 docs/INTEGRATION.md 可以精确回答装了之后车变成什么样全部支持车型原厂 LKA/ALC 在 openpilot 激活时由其 ALC 替代原厂 LDW 被 openpilot LDW 替代仅当 CARS.md 的 ACC 列为openpilot时原厂 ACC 被 openpilot ACC 替代且 openpilot FCW 与原厂 FCW并存工作其余原厂功能FCW、AEB、自动远光、盲区监测、侧碰撞预警等应全部保留。这也解释了表中Stock列车辆的定位它们是横向增强、纵向保守的支持级别。Dont see your car?——一辆车能否被支持的判定标准文档末节给出了官方兼容性判据值得完整保留接口前提openpilot 复用车辆既有的转向、油门、刹车接口。三者缺一则无法控制车辆。文档的经验判据车若带 ACC 加任意形式的 LKAS/LCA几乎必然具备这些接口此类功能大约从 2016 年前后开始在车型上普及各厂营销命名如 Hyundai 的 Smart Cruise Control并不妨碍识别。各品牌高概率可支持的配置特征品牌需要的配置/功能Acura带 AcuraWatch新款多为标配Ford带 Lane CenteringHonda带 Honda Sensing新款多为标配Subaru带 EyeSight新款多为标配Nissan带 ProPILOTToyota LexusTSS 中需 Lane Departure Alert with Steering Assist (LDA w/SA) 和/或 Lane Tracing Assist (LTA)不带 Steering Assist 的 LDA 不行Hyundai / Kia / Genesis带 SCC含 NSCC 等任意形式加 LFA 或 LKASChrysler / Jeep / Ram带 LaneSense 加自适应巡航FlexRay 总线是硬门槛openpilot 支持的所有车辆都走 CAN 总线而BMW、Mercedes、Audi、Land Rover 及部分 Volvo大多改用 FlexRay文档明确表示可能未来支持但没有即时计划。注意这与主表中出现 AudiMQB 平台并不矛盾——主表 Audi 均带脚注 12说明它们经由 J533 CAN 网关接入。Toyota Security新一代消息认证导致的黑名单由于新的消息认证机制以下车型暂不支持Toyota RAV4 Prime 2021Toyota Sienna 2021Toyota Venza 2021Toyota Sequoia 2023Toyota Tundra 2022Toyota Highlander 2024Toyota Corolla Cross 2022仅美版Toyota Camry 2025Lexus NX 2022Toyota bZ4x 2023Subaru Solterra 2023其他实用脚注速查脚注 9/10Tesla部分 2023 款为 HW4在中控Software - Additional Vehicle Information下的 Autopilot computer 可确认硬件代次线束随代次不同Tesla A / Tesla B connector脚注 13Škoda Kamiq中国区 Kamiq 基于尚未支持的 PQ34 平台不在范围内脚注 14VW Passat仅指欧版 MQB B8 Passat非美/中/中东 NMS Passat脚注 15Škoda部分车型挡风玻璃加热会遮挡 GPS 信号影响 comma four 的部分功能脚注 172022 年款及之后的部分车型为 CAN 网关与 BCM 二合一软件已支持但官方商店暂无对应线束。社区维护车型与后续适配入口主表之外的车型由社区维护见 CARS.md Community Maintained Cars 一节指向各品牌 wiki 的 Community Supported Models 段落。若你的车不满足上述任何不兼容条件文档明确表态大概率可以支持且没有官方车型支持路线图大部分车型支持来自用户贡献。仓库中为新车适配准备的工具位于 tools/car_porting/包含 VIN 指纹、模糊指纹、转向精度测量等脚本与示例 notebooktools/scripts/car/ 下还有 CAN 报文打印、固件版本查询等调试脚本是验证我的车有没有这些接口的实际入口。小结docs/CARS.md 不是一份静态清单而是由 openpilot/selfdrive/car/docs.py 从 opendbc 中的车型定义与 CARS_template.md 模板自动渲染的产物335 款车型、逐车 BOM、逐车低速限制、星号能力标记与 17 条脚注全部可在仓库内追溯到数据源与生成代码。读这张表的正确姿势是——先看 Supported Package 确认配置门槛再用 ACC 列与脚注 1/5/8/16 判断纵向是原厂接管还是 openpilot 接管以及 Alpha 开关与 AEB 禁用代价最后用 No ACC accel below / No ALC below / Resume from stop 三列对齐你所在市场的实际使用边界。【免费下载链接】openpilotopenpilot is an operating system for robotics. Currently, it upgrades the driver assistance system on 300 supported cars.项目地址: https://gitcode.com/GitHub_Trending/op/openpilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考