Skip to content

This an Openpilot fork which combines the best features from other forks together as well as some extra tweaks sprinkled on top. Popular branches include Shane and Dragonpilot with Spektor56's LKAS-only mode.

Notifications You must be signed in to change notification settings

Gunninite/openpilot

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 

Repository files navigation

🚨 Read before installing! 🚨

To increase the probability that you have an excellent experience and choose the right branch for your car, it is recommended to read this before proceeding.

🚗 Branch Definitions

  • Full: All the goodies and changes from me (like custom alerts, engagement in extra gears, nudgeless ALC) and overall quality-of-life fixes included.
  • Clean: Core code from two different forks merged together with little to no additions from me whatsoever. Same as if found in the wild.
  • Coasting: Only works well on Hondas & GMs. Branch has the functionality to coast beyond the set speed (including downhills) instead of using the brakes.
  • Devel: Branches in development. Check the commit history to see what's being worked on. No stability guarantees.
  • Personal: Branches used on my own fleet of cars. No stability guarantees.
  • Shane: Includes some or all of Shane's fork abilities: Edit settings via SSH with python op_edit.py.
  • DP: Includes Dragonpilot as the core. Dragonpilot has many different customization options accessible from the UI.
  • Spektor: Lane keeping assist can be activated independently of adaptive cruise control. Only for Hondas before 0.8.6, Toyota support added recently.
  • Honda: Honda-specific branch that utilizes the follow distance selector on the steering wheel to specific profiles. Not recommended for other cars.

Example: 0.8.6-dp-spektor-toyota would contain Dragonpilot as the core, Spektor's independent LKAS and ACC, and tested to work on Toyotas.
Example: 0.8.2-shane-spektor would contain Shane as the core, plus Spektor's independent LKAS and ACC for Hondas.
Example: 0.8.6-release-honda is designed specifically for Honda's follow distance selector. Other cars would see no benefit.

🚗 Installation

  • Some branches (especially DP) are known to not work well without a factory reset first. Failing to do so may have errors or conflicts later on. Check this video for instructions on how to factory reset.
  • If using the Dragonpilot branch, enable "Allow Gas Pressed" in the controls settings to work with the standalone LKAS function properly.
  • Install via URL: https://smiskol.com/fork/aragon7777/REPLACE_WITH_BRANCH_NAME
  • Install via SSH: cd /data; cp -rf ./openpilot ./openpilot.bak; rm -rf ./openpilot; git clone https://github.com/Aragon7777/openpilot.git openpilot; cd openpilot; git checkout REPLACEWITHBRANCHNAME && reboot
  • If a NEOS upgrade or downgrade is required, it's always best to factory reset and install stock Openpilot for that specific NEOS version. After that, proceed.

↪️ Spektor56 behavior explained:

  • Honda and Toyota: Behavior like stock Honda Sensing, thanks to Spektor56.
  •  LKAS and ACC are two seperate functions that can be used independently.
    
  •       LKAS: Lane-keeping-assist-system.
    
  •       LKAS is activated using the LKAS button the steering wheel.
    
  •       LKAS is active when the built in HUD lanelines are solid. 
    
  •       LKAS is inactive when the built in HUD lanelines are outlined.
    
  •       LKAS will disengage on brake, but automatically come back.
    
  •       LKAS will disengage below the Auto Lane Change (ALC) speed with blinker.
    
  •       LKAS will stay disengaged briefly after blinkers, this helps driver recenter wheel.
    
  •       LKAS will stay disengaged if seatbelt unlatched, door open, or unsupported gear.
    
  •       ACC: Adaptive cruise control.
    
  •       ACC is activated using the SET or RES(ume) button on the steering wheel.
    
  •       ACC will disengage on brake, and never automatically come back until reset by the driver.
    
  •       ACC can be adjusted in increments of 1MPH or +5MPH by holding, even with a (Honda) comma pedal.
    
  •       ACC will not engage if seatbelt unlatched, door open, or unsupported gear.
    

↪️ Shane Settings (access by ./op_edit.py)

• Follow distance can be adjusted by pressing the "GAP Adjust" button. I usually run "traffic".

My Personal Settings

  1. camera_offset: 0.06
  2. global_df_mod: 1.0
  3. min_TR: 0.9
  4. alca_no_nudge_speed: 30.0
  5. steer_ratio: None
  6. upload_on_hotspot: True
  7. disengage_on_gas: False
  8. update_behavior: auto (static)
  9. dynamic_gas: True
  10. hide_auto_df_alerts: False
  11. log_auto_df: False (static)
  12. support_white_panda: False (static)
  13. disable_charging: 30 (static)
  14. prius_use_pid: False (static)
  15. use_lqr: True (static)
  16. corollaTSS2_use_indi: False (static)
  17. rav4TSS2_use_indi: False (static)
  18. standstill_hack: False (static)
  19. username: None

↩️ Dragonpilot Settings (access via UI):

• In order to get follow and acceleration profiles, you must enable them in the settings. Only then will the selectors show up while the car is on.

My Personal Settings

DP - General:
Services:
• Enable Updater Service: Enabled
• Enable Log Service: Enabled
• Enable Uploader Service: Enabled
• Enable Athenad Service: Enabled
• Enable On-Road Dashcam: Enabled (your drives may stop uploading to connect.comma.ai if enabled due to storage)
• Enable Appd Service: Enabled
Hardware - General:
• Enable Hotspot On Boot: Disabled
• Camera Offset: 6cm (if your car hugs one side of the road, tune this yourself)
• Fan Mode: 0
• Enable Auto Shutdown: Disabled
Hardware - Non-C2:
• All options disabled. Toggle these if needed

DP - Controls:
Lateral:
• Lateral Ctrl Mode: 2
• LCA Min Speed: 30mph
• ALCA Delay: 1 second
• ALCA Min Speed: 30mph (min speed for nudgeless lane changes to happen, set to your liking. To disable, set Lateral Ctrl Mode to 1)
• Enable Cont. ALCA: Enabled (for some reason, in recent DP versions lane changes are buggy without this enabled. Use caution)
• Use LQR Controller: Disabled (some people have had good results with this especially on toyotas, try it out)
• Enable Steering Ratio Learner: Disabled (SR learner tends to learn badly causing ping-pongs in a few days)
• Driving Path Offset: 0cm
Longitudinal:
• Use Accel Profile: Enabled (this enables a button on the bottom right while the car is on to toggle between normal, sport, and economy accelerations)
• Use Following Profile: Enabled (this enables a button on the bottom right while the car is on to toggle follow distances in seconds)
• Allow Gas Pedal Pressed: Enabled (this is required to be enabled when using a branch with Spektor)
• Enable Gear Safety Check: Disabled (this lets you run Openpilot in other gears like sport and low, use caution)
Safety:
Enable Device Temp Check: Enabled
Enable Max Ctrl Speed Check: Disabled

DP - UI:
• Display Mode: 2
• Screen Brightness: Auto
• Alert Volume: Auto
• Display Speed: Enabled
• Display Lane Prediction: Enabled
• Display Lead Car Indicator: Enabled
• Display Turning Signal / Blinkers: Enabled
• Display Event / Steer Icon: Enabled
• Display Max Speed: Enabled
• Display Driver Monitor Indicator: Enabled
• Display Side Info: Enabled
• Display Top Info Bar: Disabled

DP - Cars:
• Keep everything disabled unless you have something specific to use, like a torque-modded civic

🚗 General features across all branches (other than clean):

  • Alerts have mostly been rewritten. Better grammar, less annoying, and more details on specific events.
  • Engagement sounds have been muted. For moderate or major warnings, the Tesla warning sound will play.
  • Update prompt forcing an internet connection to check for updates has been disabled.
  • Engagement in gears other than drive, such as sport and low.
  • Reduced the potentional for false driving model lagging alerts.

🏆 Special Thanks

Spektor56
eisenheim
ShaneSmiskol
wirelessnet2
kegman
cfranhonda
doktor
qadmus
reddn

📬 Contact

If you'd like to reach out to me, message Aragon#7777 on Discord, or tag me in #custom-forks on the official Comma server regarding this branch.

About

This an Openpilot fork which combines the best features from other forks together as well as some extra tweaks sprinkled on top. Popular branches include Shane and Dragonpilot with Spektor56's LKAS-only mode.

Resources

Stars

Watchers

Forks

Packages