Table of Contents
- Join our Discord
- Read Before Installing
- Highlight Features
- Driving Enhancement
- Branch Definitions
- Recommended Branches
- Installation
- Donate
- Pull Requests
- Special Thanks
π 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
- NEW
β Modified Assistive Driving Safety (MADS) - openpilot ALC and Hyundai SCC can be engaged independently of each other - NEW
β Dynamic Lane Profile (DLP) - dynamically switch lane profile base on lane recognition confidence
π Driving Enhancement
β Modified Assistive Driving Safety (MADS)
NEWThe 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) orCRUISE (MAIN)
button toggles openpilot ALCSET-
button enables Hyundai SCC/ACCCANCEL
button only disables Hyundai SCC/ACCCRUISE (MAIN)
button disables openpilot completely whenOFF
(strictly enforced in panda safety code)BRAKE pedal
press will pause openpilot ALC;BRAKE pedal
release will resume openpilot ALCGAS pedal
press will not disengage openpilot ALC or Hyundai SCC/ACCTURN SIGNALS
(Left
orRight
) 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
β Dynamic Lane Profile (DLP)
NEWDynamic 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 todevelop
. No stability guaranteed.π¨
π° Recommended Branches
prod-mads
: Contains Modified Assistive Driving Safety (MADS).- HKG cars with
LFA
button on the steering wheel will useLFA
button to engage MADS:- Hyundai: [Sonata] 2020-2021
- Hyundai: [Elantra] 2021
- HKG cars with NO
LFA
button but onlyCRUISE (ACC MAIN)
button on the steering wheel will useCRUISE (ACC MAIN)
button to engage MADS:- All officially supported HKG cars without
LFA
button on steering wheel
- All officially supported HKG cars without
- HKG cars with
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:
-
https://smiskol.com/fork/sunnyhaibin/0.8.8-prod-full
-
https://smiskol.com/fork/sunnyhaibin/0.8.8-prod-personal
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:
-
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
-
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 QR Code:
π 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.