Stock Additions is a fork of openpilot designed to be minimal in design while boasting various feature additions and behavior improvements over stock. I have a 2017 Toyota Corolla with comma pedal, so most of my changes are designed to improve the longitudinal performance.
Want to request a feature or create a bug report? Open an issue here! Want to reach me to debug an issue or have a question? Shane#6175
on Discord!
View Stock Additions Changelog
- Dynamic follow (now with profiles!) - 3 + auto profiles to control distance
- Lane Speed
- Lane Speed Alerts - alerts for when an adjacent lane is faster
- Dynamic camera offsetting - moves you over if adjacent lane has oncoming traffic
- Dynamic gas - smoother gas control
- NEWISH❗ Adding derivative to PI for better control - lat: smoother control in turns; long: fix for comma pedal overshoot
- Customize this fork - easily edit fork parameters with support for live tuning
- Automatic updates
- NEW❗ ZSS Support - takes advantage of your high-precision Zorrobyte Steering Sensor
- Offline crash logging - check out
/data/community/crashes
- Colored the lane lines - based on distance from car
- Colored model path - based on curvature
Dynamic follow aims to provide the stock (Toyota) experience of having three different distance settings. Dynamic follow works by dynamically changing the distance in seconds which is sent to the long MPC to predict a speed to travel at. Basically, if the lead is decelerating or might soon, increase distance to prepare. And if the lead is accelerating, reduce distance to get up to speed quicker.
Dynamic follow works if openpilot can control your vehicle's gas and brakes (longitudinal). Check if openpilot can control your vehicle's longitudinal from this list.
Just use the button on the button right of the screen while driving to change between these profiles:
traffic
- Meant to keep you a bit closer in traffic, hopefully reducing cut-ins. Always be alert, as you are with any driving assistance software.relaxed
- This is the default dynamic follow profile for casual driving.roadtrip
- This profile is for road trips where you're mainly on two lane highways and don't want to be following particularly closely; at night for example.auto
- The auto dynamic follow model was trained on about an hour of me manually cycling through the different profiles based on driving conditions, this profile tries to replicate those decisions entirely on its own.
I've trained a custom model with Keras that takes in the past 35 seconds of your speed, the lead's speed and the lead's distance. With these inputs, it tries to correctly predict which profile is the best for your current situation.
It's only been trained on about an hour of data, so it's not perfect yet, but it's great for users who just want to set it and forget it. To enable the auto
profile, simply tap the profile changing button for dynamic follow until it reaches the auto
profile!
If you're annoyed by the silent alerts that show when the model has changed the profile automatically, just use opEdit and set hide_auto_df_alerts
to True
. Auto profile and model will remain functional but will not show alerts.
Resources:
- The auto-df repo.
- The model file.
- I converted the Keras model to be able to run with pure NumPy using Konverter.
This feature alerts you of faster-travelling adjacent lanes and can be configured using the on-screen LS button on the bottom right to either be disabled, audible, or silent.
The idea behind this feature is since we often become very relaxed behind the wheel when being driven by openpilot, we don't always notice when we've become stuck behind a slower-moving vehicle. When either the left or right adjacent lane is moving faster than your current lane, LaneSpeed alerts the user that a faster lane is available so that they can make a lane change, overtaking the slower current lane. Thus saving time in the long run on long roadtrips or in general highway driving!
The original idea is thanks to Greengree#5537 on Discord. This feature is available at 35 mph and up.
This feature automatically adjusts your position in the lane if an adjacent lane has oncoming traffic. For example, if you're on a two-lane highway and the left adjacent lane has oncoming cars, LaneSpeed recognizes those cars and applies an offset to your CAMERA_OFFSET
to move you over in the lane, keeping you farther from oncoming cars.
This feature is available from 35 to ~60 mph due to a limitation with the Toyota radar. It may not recognize oncoming traffic above 60 mph or so. To enable or disable this feature, use opEdit
and change this parameter: dynamic_camera_offset
.
Dynamic gas aims to provide a smoother driving experience in stop and go traffic (under 20 mph) by reducing the maximum gas that can be applied based on your current velocity, the relative velocity of the lead, the acceleration of the lead, and the distance of the lead. This usually results in quicker and smoother acceleration from a standstill without the jerking you get in stock openpilot with comma pedal (ex. taking off from a traffic light). It tries to coast if the lead is just inching up, it doesn’t use maximum gas as soon as the lead inches forward. When you are above 20 mph, relative velocity and the current following distance in seconds is taken into consideration.
All cars that have a comma pedal are supported! However to get the smoothest acceleration, I've custom tuned gas curve profiles for the following cars:
pedal cars:
- 2017 Toyota Corolla (non-TSS2)
- Toyota RAV4 (non-TSS2)
- 2017 Honda Civic
- 2019 Honda Pilot
non-pedal cars:
- None yet
If you have a car without a pedal, or you do have one but I haven't created a profile for you yet, please let me know and we can develop one for your car to test.
(long: longitudinal, speed control. lat: latitudinal, steering control)
Changes for lat control: (NEW❗)
-
Adding the derivative componenet to lat control greatly improves the turning performance of openpilot, I've found it loses control much less frequently in both slight and sharp curves and smooths out steering in all situations. Basically it ramps down torque as your wheel approaches the desired angle, and ramps up torque quicky when your wheel is moving away from desired.
Currently Supported Cars: (when param
use_lqr
is False)- 2017 Toyota Corolla
- TSS2 Toyota Corolla (when param
corollaTSS2_use_indi
is False) - tune from birdman! - All Prius years (when param
prius_use_pid
is True) - tune from Trae!
Changes for long control:
-
I've added a custom implementation of derivative to the PI loop controlling the gas and brake output sent to your car. Derivative (change in error) is calculated based on the current and last error and added to the class's integral variable. It's essentially winding down integral according to derivative. It helps fix overshoot on some cars with the comma pedal and increases responsiveness (like when going up and down hills) on all other cars! Still need to figure out the tuning, right now it's using the same derivative gain for all cars. Test it out and let me know what you think!
Long derivative is disabled by default due to only one tune for all cars, but can be enabled by using opEdit and setting the
enable_long_derivative
parameter toTrue
. It works well on my '17 Corolla with pedal.
If you have a Prius with a ZSS (Zorrobyte Steer Sensor), you can use this fork to take full advantage of your high-precision angle sensor! Added support for ZSS with PR #198, there's nothing you need to do. Special thanks to Trae for helping testing the addition!
If you have a ZSS but not a Prius, let me know and I can add support for your car.
This is a handy tool to change your opParams
parameters without diving into any json files or code. You can specify parameters to be used in any fork's operation that supports opParams
. First, ssh in to your EON and make sure you're in /data/openpilot
, then start opEdit
:
cd /data/openpilot
python op_edit.py # or ./op_edit.py
To see what features opEdit has, click me!
Here are the main parameters you can change with this fork:
- Tuning params:
camera_offset
(live!)
: Your camera offset to use in lane_planner.py. Helps fix lane huggingsteer_ratio
(live!)
: The steering ratio you want to use with openpilot. If you enter None, it will use the learned steer ratio from openpilot insteadenable_long_derivative
: This enables derivative-based integral wind-down to help overshooting within the PID loop. Useful for Toyotas with pedals or cars with bad long tuninguse_lqr
: Enable this to use LQR for lateral control with any car. It uses the RAV4 tuning, but has proven to work well for many cars
- General fork params:
alca_nudge_required
: Whether to wait for applied torque to the wheel (nudge) before making lane changesalca_min_speed
: The minimum speed allowed for an automatic lane change in mphupload_on_hotspot
: Controls whether your EON will upload driving data on your phone's hotspotupdate_behavior
:off
will never update,alert
shows an alert on-screen.auto
will reboot the device when an update is seendisengage_on_gas
: Whether you want openpilot to disengage on gas input or notslowdown_for_curves
: Whether your car will slow down for curves using the old planner code from 0.5/0.6
- Dynamic params:
dynamic_gas
: Whether to use dynamic gas if your car is supportedglobal_df_mod
(live!)
: The multiplier for the current distance used by dynamic follow. The range is limited from 0.85 to 2.5. Smaller values will get you closer, larger will get you farther. This is applied to ALL profiles!min_TR
(live!)
: The minimum allowed following distance in seconds. Default is 0.9 seconds, the range of this mod is limited from 0.85 to 1.3 seconds. This is applied to ALL profiles!hide_auto_df_alerts
: Hides the alert that shows what profile the model has chosendynamic_camera_offset
: Whether to automatically keep away from oncoming traffic. Works from 35 to ~60 mphdynamic_camera_offset_time
: How long to keep the offset after losing the oncoming lane/radar track in seconds
dynamic_follow
: Deprecated, use the on-screen button to change profiles
- Experimental params:
support_white_panda
: This allows users with the original white panda to use openpilot above 0.7.7. The high precision localizer's performance may be reduced due to a lack of GPSprius_use_pid
: This enables the PID lateral controller with new a experimental derivative tunecorollaTSS2_use_indi
: Enable this to use INDI for lat with your TSS2 Corolla (can be enabled for all years by request)standstill_hack
: Some cars support stop and go, you just need to enable this
A full list of parameters that you can modify are located here.
An archive of opParams lives here.
Parameters are stored at /data/op_params.json
When a new update is available on GitHub for Stock Additions, your EON/C2 will pull and reset your local branch to the remote. It then queues a reboot to occur when the following is true:
- your EON has been inactive or offroad for more than 5 minutes
update_behavior
param is set toauto
Therefore, if your device sees an update while you're driving it will reboot approximately 5 to 10 minutes after you finish your drive, it resets the timer if you start driving again before the time is up.
If you experience a crash or exception while driving with this fork and you're not on internet for the error to be uploaded to Sentry, you should be able to check out the directory /data/community/crashes
to see any and all logs of exceptions caught in manager.py
. Simply cat
the log file you wish to view. This does not catch all errors, for example scons compilation errors or some Python syntax errors will not be caught, tmux a
is usually best to view these (if openpilot didn't start).
Feel free to reach out to me on Discord or my email if you're having any issues with the fork!
To install Stock Additions, just run the following on your EON/C2 (make sure to press enter after each line):
cd /data/
mv openpilot openpilot.old # or equivalent
git clone -b stock_additions --single-branch https://github.com/shanesmiskol/openpilot --depth 1
reboot
The --depth 1
flag shallow clones the fork, it ends up being about 90 Mb so you can get the fork up and running quickly. Once you install Stock Additions, automatic updating should always keep openpilot up to date with the latest from my fork!
Or use the emu CLI to easily switch to this fork's default branch: emu fork switch ShaneSmiskol
. The initial setup may take longer than the above command, but you gain the ability to switch to any fork you want.
Most of the branches on this fork are development branches I use as various openpilot tests. The few that more permanent are the following:
stock_additions
: This is similar to stock openpilot's release branch. Will receive occasional and tested updates to Stock Additions.stock_additions-devel
orSA-staging
: My development branch of Stock Additions I use to test new features or changes; similar to the master branch. Not recommendeded as a daily driver.
- Stock Additions 0.7
- Stock Additions 0.7.1
- Stock Additions 0.7.4
- Stock Additions 0.7.5
- Stock Additions 0.7.7
- Stock Additions 0.7.10
Here's a short video showing how close the traffic profile was in 0.7.4
. In 0.7.5
, the traffic profile is an average of 7.371 feet closer from 18 mph to 90 mph. Video thanks to @rolo01!
If you'd like to support my development of Stock Additions with a dollar for a RaceTrac ICEE (my PayPal link). Thanks! 🥰