Files
2026-07-21 13:43:46 -05:00

112 lines
4.6 KiB
Python

"""
Copyright © IQ.Lvbs, apart of Project Teal Lvbs, All Rights Reserved, licensed under https://konn3kt.com/tos
Original concept ("Increased Stop Distance") by SpysyWeeb (github.com/SpysyWeeb), ported to
IQ.Pilot and made bidirectional.
Custom Stop Distance: nudge how far back IQ.Pilot stops behind a stopped lead vehicle or a
model-held stop (red light). Independent of IQ Force Stops -- works whether Force Stops is on
or off.
IQCustomStopDistance (meters, -2..2): positive stops further back, negative settles in closer.
0 is stock.
Two mechanisms share the param:
- Lead stops (radard): the reported lead distance is nudged by the offset, faded back out as the
lead gets up to speed so normal following distance is unaffected. Works in chill and end-to-end.
- Model-held stops (planner, end-to-end mode): when the model's trajectory ends at ~zero velocity
(it plans to remain stopped, e.g. a red light), a positive offset brakes toward a point short of
its predicted stop and holds there instead of creeping forward -- it only ever adds braking on
top of the model's own plan, never relaxes below it. A negative offset is a no-op here: there's
no safe way to coax the car past the model's own conservative stop point this way.
"""
import numpy as np
from iqdbc.car.interfaces import ACCEL_MIN
from openpilot.common.params import Params
from openpilot.common.realtime import DT_MDL
from openpilot.selfdrive.modeld.constants import ModelConstants
CUSTOM_STOP_DISTANCE_PARAM = "IQCustomStopDistance"
MIN_DISTANCE_M = -2
MAX_DISTANCE_M = 2
# Fade the offset back out as the lead gets up to speed
STOPPED_DISTANCE_FADE_BP = [0., 3.] # m/s, lead speed
MIN_ADJUSTED_D_REL = 1.0 # m
E2E_STOP_PLAN_VEL_THRESHOLD = 1.0 # m/s, model plan ending below this implies a held stop
E2E_STOP_MIN_BRAKING = -0.1 # m/s^2, only deepen braking the model has already started
E2E_STOP_MIN_DIST = 2.0 # m, never target a stop point closer than this
E2E_STOP_HOLD_MAX_V = 0.5 # m/s, below this the car is considered stopped
E2E_STOP_HOLD_BUFFER = 2.0 # m, hold until the model's stop point moves beyond offset + buffer
def get_sanitize_int_param(key, min_val, max_val, params):
stored = params.get(key, return_default=True)
bounded = min(max(stored, min_val), max_val)
if bounded != stored:
params.put(key, bounded)
return bounded
class CustomStopDistance:
def __init__(self):
self.params = Params()
self.frame = 0
self.distance = 0.
self.read_params()
def read_params(self) -> None:
self.distance = float(get_sanitize_int_param(CUSTOM_STOP_DISTANCE_PARAM, MIN_DISTANCE_M, MAX_DISTANCE_M, self.params))
def update(self) -> None:
if self.frame % int(3 / DT_MDL) == 0:
self.read_params()
self.frame += 1
def apply_lead(self, lead_dict: dict) -> dict:
if self.distance == 0. or not lead_dict.get('status', False):
return lead_dict
offset = self.distance * float(np.interp(lead_dict['vLead'], STOPPED_DISTANCE_FADE_BP, [1., 0.]))
adjusted = lead_dict['dRel'] - offset
if self.distance > 0:
# stop further back: never reduce the reported distance below the floor, and never report further than reality
lead_dict['dRel'] = min(lead_dict['dRel'], max(adjusted, MIN_ADJUSTED_D_REL))
else:
# stop closer in: never report closer than reality
lead_dict['dRel'] = max(lead_dict['dRel'], adjusted)
return lead_dict
def adjust_e2e_stop(self, a_target: float, should_stop: bool, v_ego: float, model_msg) -> tuple[float, bool]:
if self.distance <= 0.:
return a_target, should_stop
x = model_msg.position.x
v = model_msg.velocity.x
if len(x) != ModelConstants.IDX_N or len(v) != ModelConstants.IDX_N:
return a_target, should_stop
# only stops the model plans to hold (red lights) can be shifted -- stop signs are left alone:
# forcing an early stop makes the model treat the stop as completed and roll through the sign
if float(v[-1]) > E2E_STOP_PLAN_VEL_THRESHOLD:
return a_target, should_stop
stop_distance = float(x[-1])
if v_ego < E2E_STOP_HOLD_MAX_V:
# stopped short of the model's stop point: hold instead of creeping up to it
if stop_distance <= self.distance + E2E_STOP_HOLD_BUFFER:
should_stop = True
elif a_target < E2E_STOP_MIN_BRAKING:
# deepen braking that has already started, targeting a stop short of the model's stop point
adjusted_distance = max(stop_distance - self.distance, E2E_STOP_MIN_DIST)
a_required = max(-(v_ego ** 2) / (2 * adjusted_distance), ACCEL_MIN)
if a_required < a_target:
a_target = float(a_required)
return a_target, should_stop