twilsonco / openpilot-1

The goal of this fork is to enhance the user driving experience for Hyundai vehicles with openpilot with modified behaviors of openpilot engagements, the Modified Assistive Driving Safety (MADS) Mode. This fork complies with Comma's safety rules as accurately as possible.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Table of Contents


πŸ’­ Join our Discord πŸ’­

Join sunnyhaibin's openpilot server!

🚨 Read Before Installing 🚨

It is recommended to read this entire page before proceeding. This will ensure that you are selecting the right branch for your car to have the best driving experience.

This fork is recommended to be used for Hyundai, Kia, and Genesis (HKG) cars. It is a fork of comma.ai's openpilot. By installing this software, you accept all responsibility for anything that might occur while you use it. All contributors to this fork are not liable. Use at your own risk.

πŸš— Highlight Features

Driving Enhancement

πŸš— Driving Enhancement

NEW❗ Modified Assistive Driving Safety (MADS)

The goal of Modified Assistive Driving Safety (MADS) is to enhance the user driving experience with modified behaviors of openpilot engagements. This feature complies with comma.ai's safety rules as accurately as possible with the following changes:

  • openpilot ALC and Hyundai SCC/ACC can be engaged independently of each other
  • LFA button (only on newer HKG vehicles) or CRUISE (MAIN) button toggles openpilot ALC
  • SET- button enables Hyundai SCC/ACC
  • CANCEL button only disables Hyundai SCC/ACC
  • CRUISE (MAIN) button disables openpilot completely when OFF (strictly enforced in panda safety code)
  • BRAKE pedal press will pause openpilot ALC; BRAKE pedal release will resume openpilot ALC
  • GAS pedal press will not disengage openpilot ALC or Hyundai SCC/ACC
  • TURN SIGNALS (Left or Right) will pause openpilot ALC if the vehicle speed is below the threshold for openpilot Automatic Lane Change
  • Event audible alerts are more relaxed to match Hyundai stock behavior

NEW❗ Dynamic Lane Profile (DLP)

Dynamic Lane Profile (DLP) aims to provide the best driving experience with staying within the lane confidently. Dynamic Lane Profile allows openpilot to dynamically switch between lane profiles base on lane recognition confidence level on road.

βš’ Branch Definitions

  • prod: Production branches. Include features that are tested by users and ready to use. βœ…
  • staging: Staging branches. Include new features that are not tested by users. No stability guaranteed. 🚨
  • feature: Feature branches. Represent new features being added to the system. No stability guaranteed. 🚨
  • test: Test branches. For experimenting with concepts that might not get used in the project. No stability guaranteed. 🚨
  • develop: Development branches. All features are gathered in respective versions. Reviewed features will be committed to develop. No stability guaranteed. 🚨

πŸ“° Recommended Branches

  • prod-mads: Contains Modified Assistive Driving Safety (MADS).
    • HKG cars with LFA button on the steering wheel will use LFA button to engage MADS:
      • Hyundai: [Sonata] 2020-2021
      • Hyundai: [Elantra] 2021
    • HKG cars with NO LFA button but only CRUISE (ACC MAIN) button on the steering wheel will use CRUISE (ACC MAIN) button to engage MADS:
      • All officially supported HKG cars without LFA button on steering wheel
  • prod-full: Contains all features supported by this fork, such as Modified Assistive Driving Safety (MADS), Dynamic Lane Profile (DLP), etc.
  • prod-personal: sunnyhaibin's everyday use branch, contains changes and good stuff for my personal use (i.e. custom alerts, custom boot screens, quick boot time, etc.) and quality-of-life features.
    • Hyundai: [Sonata N Line] 2021

βš’ Installation

Smiskol URL (Quickest and Easiest)

To install sunnyhaibin's fork, simply use the Smiskol URL (thanks Shane!) on the setup screen for "Custom Software" after you factory reset or uninstalled openpilot from a previous install:

https://smiskol.com/fork/sunnyhaibin/<insert_branch_name>

For example, if you would like to install the branch:

SSH (More Versatile)

If you are looking to install sunnyhaibin's fork via SSH, run the following command in an SSH terminal after connecting to your device:

  • 0.8.8-prod-full:

    cd /data; cp -rf ./openpilot ./openpilot.bak; rm -rf ./openpilot; git clone https://github.com/sunnyhaibin/openpilot.git openpilot; cd openpilot; git checkout 0.8.8-prod-full; pkill -f thermald; rm -f prebuilt; reboot
    
  • 0.8.8-prod-personal:

    cd /data; cp -rf ./openpilot ./openpilot.bak; rm -rf ./openpilot; git clone https://github.com/sunnyhaibin/openpilot.git openpilot; cd openpilot; git checkout 0.8.8-prod-personal; pkill -f thermald; rm -f prebuilt; reboot
    

πŸ’° Donate πŸ’°

If you find any of the features useful, feel free to donate for coffee to support for future development.

Thank you for your continuous love and support!

PayPal:

PayPal this

PayPal QR Code:

haibin.wen3@gmail.com_paypal_qr.png.png

πŸŽ† Pull Requests πŸŽ†

We welcome both pull requests and issues on GitHub. Bug fixes are encouraged.

Pull requests should be against the most current develop-full branch.

πŸ† Special Thanks

About

The goal of this fork is to enhance the user driving experience for Hyundai vehicles with openpilot with modified behaviors of openpilot engagements, the Modified Assistive Driving Safety (MADS) Mode. This fork complies with Comma's safety rules as accurately as possible.