openpilot 胡萝卜分支参数配置详解

概述

本文档详细说明 openpilot Carrot（胡萝卜）分支的全部参数配置。openpilot 是开源自动驾驶系统，通过摄像头感知、路径规划和车辆控制实现 L2+ 级辅助驾驶。胡萝卜分支在其基础上增加了大量可调参数，适配更多车型和驾驶场景。

参数总览：

一、基础控制参数

1.1 核心开关

原理详解 - AlwaysLateral：

openpilot 的控制分为纵向控制（油门/刹车）和横向控制（转向）。默认情况下，横向控制只在 ACC 巡航激活时工作。设为 1 后，即使未开巡航，系统也会通过 EPS（电动助力转向）控制方向盘保持车道居中。

这在高速长途时很实用，但需注意：

• 城市道路不建议开启，因为系统可能在复杂路况下做出错误转向
• 驾驶员随时可以通过施加转向力矩接管

原理详解 - AutoEngage：

openpilot 激活需要满足多个条件：

1. 摄像头检测到有效车道线
2. 车速高于最低阈值（通常 5km/h）
3. 驾驶员注意力正常（未被 DMS 标记为分心）

AutoEngage=1 时，满足条件自动进入控制状态；=2 时条件更宽松，如更低的速度阈值。

1.2 按钮配置

原理详解 - 按钮映射：

openpilot 复用车辆原有的物理按钮来控制功能。不同车型的按钮布局不同，胡萝卜分支允许自定义每个按钮的行为：

• CancelButtonMode：现代/起亚的取消按钮，默认按下取消巡航。可改为按下暂停横向控制、切换模式等
• LfaButtonMode：现代/起亚有独立的 LFA（Lane Following Assist）按钮，可复用为 openpilot 总开关
• PaddleMode：方向盘后的换挡拨片，可复用为调速（+/-）或功能切换

1.3 速度单位

原理：CruiseSpeedUnit=10 表示按一次 RES/+ 按钮，巡航速度 +10km/h。CruiseSpeedUnitBasic=1 是精细模式，用于需要精确设定速度的场景。

二、巡航速度控制

2.1 预设速度

原理：通过按钮组合快速切换到预设速度，无需逐步调节。例如在匝道汇入高速时，一键从 50 切换到 110。

2.2 最大速度限制

原理：硬限制各模式下的最高巡航速度，即使驾驶员按 RES/+ 也无法超过。用于防止超速，不同模式对应不同的道路场景。

2.3 快速按钮

原理：用于调试和测试按钮映射，正常用户无需修改。

三、横向控制参数

3.1 路径与摄像头

原理详解 - PathOffset：

openpilot 默认在车道中央行驶。PathOffset 让你调整横向位置偏好：

• 正值：偏右行驶，适合右侧有隔离带的道路
• 负值：偏左行驶，适合左侧有大车的道路
• 典型值：5-15cm

PathOffset 的单位是 cm，实际偏移量会因车速和弯道略有变化。

3.2 转向执行参数

原理详解 - SteerActuatorDelay：

这是 MPC（模型预测控制）的关键参数。从 openpilot 发出转向指令到 EPS 实际执行存在延迟（通常 20-40ms）。MPC 模型需要知道这个延迟来提前规划。

• 值太小（<15ms）：MPC 预测过早，转向过度，车辆左右晃动
• 值太大（>40ms）：MPC 预测过晚，转向不足，弯道偏离
• 调节方法：在直道上观察方向盘响应，调整至无明显延迟感

原理详解 - CustomSR（转向比）：

转向比 = 方向盘转角 ÷ 车轮转角。例如 CustomSR=168 表示转向比 16.8:1。

不同车型转向比不同：

转向比不准确会导致：弯道转向过度或不足、直线行驶时方向盘不居中。

3.3 横向 PID + 前馈控制

原理详解 - PID + 前馈控制：

横向控制的核心算法是 PID + 前馈：

转向力矩 = Kp×误差 + Ki×误差积分 + Kd×误差微分 + Kf×前馈预测

LateralTorqueAccelFactor：车辆加速时，由于载荷转移，前轮抓地力变化，需要额外的转向补偿。值 2500 表示每 1m/s² 加速度增加 2500 单位力矩。

3.4 神经网络前馈（NNFF）

原理详解 - NNFF：

传统前馈使用几何公式计算弯道所需的转向角：θ = L/R（L=轴距，R=弯道半径）。但实际道路并非理想圆弧，且车辆动力学存在非线性。

NNFF 使用深度神经网络，输入当前车速、道路曲率、横向偏差等，直接输出前馈转向力矩。训练数据来自大量真实驾驶数据。

3.5 变道控制

原理详解 - 变道机制：

openpilot 的变道流程：

1. 驾驶员拨转向灯或施加转向力矩
2. 系统检查目标车道是否可用（车道线检测）
3. 如果启用了 BSD，检查盲区是否有车
4. 延迟 LaneChangeDelay 毫秒后开始执行
5. 以设定的转向速率平滑变道

• LaneChangeNeedTorque=0：仅靠转向灯触发变道
• LaneChangeNeedTorque>0：需要驾驶员施加一定转向力矩才触发，更安全

3.6 自动转弯

原理详解 - AutoTurnControl：

在交叉路口，传统 ACC 会因为前方无车而失灵。AutoTurnControl=2 时：

• 结合导航地图的路口信息
• 识别转向灯信号
• 在低速时自动控制转向通过路口
• 转弯完成后恢复车道保持

3.7 转向速率限制

原理：限制 EPS 每个控制周期（通常 10ms）的转向角变化量。防止突然大幅转向。变道时允许更快的转向速率。

3.8 角度控制（按车速分段）

原理详解 - 速度分段控制：

低速时车辆惯性小，可以快速转向；高速时惯性大，快速转向会导致侧滑或翻车。因此系统根据车速分段限制转向速率：

四、纵向控制参数

4.1 纵向 PID

原理详解 - 纵向控制：

纵向控制的目标是让车辆跟随目标速度或与前车保持安全距离。控制输出是油门开度或刹车压力。

控制量 = Kp×(目标速度-实际速度) + Ki×速度误差积分 + Kf×目标加速度

• LongTuningKpV=100：比例响应中等，不会太激进
• LongTuningKiV=0：不用积分项，避免长时间偏差积累后的突然加速
• LongTuningKf=100：前馈为主，直接根据规划的加速度输出

4.2 跟车时距（Time Gap）

原理详解 - 跟车时距：

跟车时距 = 与前车的时间距离 = 车距 ÷ 车速

DynamicTFollow：车速越高，动态时距自动增大。公式：实际时距 = TFollowGap × (1 + DynamicTFollow/100 × 速度因子)

4.3 停车控制

原理详解 - 停车过程：

1. 检测到前车或红灯，开始减速
2. 车速降至 VEgoStopping（15km/h）以下，进入停车模式
3. 使用特殊的低速控制逻辑，平稳停车
4. 停在 StopDistanceCarrot（6m）处
5. 前车起步后，系统自动跟随起步

4.4 跟车响应

原理详解 - 跟车响应：

当前车减速时，系统需要快速响应以避免追尾：

1. RadarReactionFactor：雷达检测到前车减速后，多快开始响应。值 40 表示中等响应速度
2. TFollowDecelBoost：检测到前车急刹时，额外增加的制动力。值 50 表示增加 50% 制动力
3. JLeadFactor3：对前车加速度变化的跟踪灵敏度。值 79 表示适度跟随

五、导航与限速参数

5.1 导航限速

原理详解 - 导航限速：

当 AutoNaviSpeedCtrlMode=2 时，系统会：

1. 从导航地图获取前方限速信息
2. 提前 AutoNaviSpeedCtrlEnd 米开始减速
3. 以 AutoNaviSpeedDecelRate 的速率减速
4. 达到限速后，保持 限速 × AutoNaviSpeedSafetyFactor/100 的速度
5. AutoRoadSpeedLimitOffset=-1 表示限速 120 时巡航 119km/h

5.2 弯道速度

原理详解 - 弯道降速：

弯道降速的物理原理是向心力限制：

最大过弯速度 = √(μ × g × R)
μ = 轮胎摩擦系数（干沥青约0.7-0.9）
g = 重力加速度（9.8m/s²）
R = 弯道半径(m)

系统通过摄像头识别弯道曲率（1/R），结合地图数据，计算安全过弯速度。AutoCurveSpeedFactor=70 表示以理论最大速度的 70% 通过，留有安全余量。

5.3 红绿灯

原理详解 - 红绿灯检测：

TrafficLightDetectMode=2 时，系统使用摄像头图像识别红绿灯：

1. 检测前方是否有红绿灯
2. 识别当前灯色（红/绿/黄）
3. 红灯时自动减速停车
4. 绿灯时保持或恢复巡航

TrafficStopDistanceAdjust=-150 表示停在停止线前 1.5m 处（负值表示更靠近）。

六、驾驶模式与经济控制

原理详解 - 经济模式：

MyDrivingMode=1（经济模式）时：

• 加速更平缓，避免急加速
• 提前松油门，利用惯性滑行
• 跟车距离适当增大
• 弯道降速更保守

CruiseEcoControl=2 进一步优化：

• 预判前方路况，提前调整速度
• 下坡时减少刹车，利用发动机制动
• 绿波速度建议（如果导航支持）

七、雷达与感知参数

原理详解 - 雷达数据处理：

EnableCornerRadar=2：启用车辆四角的毫米波雷达，用于：

• 盲区检测（BSD）
• 后方来车预警（RCTA）
• 交叉路口预警（FCTA）
• 变道辅助

八、车辆适配参数（比亚迪/现代）

8.1 比亚迪专属

原理详解 - 比亚迪适配：

比亚迪车辆的 EPS 和 ACC 系统与 openpilot 的接口方式特殊：

• BydLowSpdLong=true：比亚迪在低速（<30km/h）时 ACC 可能失效，此参数启用自定义低速纵向控制
• BydLatUseSiglin=true：比亚迪的转向控制通过特定 CAN 信号实现，而非标准的 LKA 接口
• BydDisableEpsTemporaryFault=false：不建议设为 true，EPS 故障可能是真正的硬件问题

8.2 现代/起亚专属

九、显示界面参数

9.1 信息显示

9.2 路径显示

原理详解 - 路径颜色编码：

RainbowPath=true 时，路径颜色随曲率变化：

• 绿色：直道
• 黄色：小曲率弯道
• 红色：大曲率弯道

这让驾驶员直观了解车辆即将行驶的路径形状。

9.3 亮度与摄像头

9.4 HUD 抬头显示

9.5 导航地图（HUD）

十、设备与系统参数

原理详解 - DisableDM：

驾驶员监控（Driver Monitoring）通过红外摄像头检测：

• 驾驶员眼睛是否睁开
• 视线方向是否在道路上
• 是否有分心行为（看手机等）

建议：日常使用保持 DisableDM=0 或 1，确保驾驶员注意力。

十一、声音参数

十二、参数调节建议

12.1 新手安全配置

12.2 高速通勤配置

12.3 激进驾驶配置

本文基于 openpilot Carrot 分支参数整理，具体参数效果因车型和版本不同可能有差异。调节参数前请充分了解风险，确保安全驾驶。