The software sources are after the install section.
We appreciate all help! Anywhere we get it! To get involved join us on discord or Contribute to the project with code or help support the project by donating.
-
Donating helps me dedicate more time and effort into this project. It also gives me more time to make for helping people.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE
DO NOT USE SPAS WITHOUT UNDERSTANDING, HOW IT WORKS AND WHAT IT DOES, YOU ACCEPT ALL LIABILITY.
It is open source and inherits MIT license. 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.
By using this software you are responsible for anything that occurs while OpenPilot is engaged or disengaged. Be ready to take over at any moment. Fork contributers assumes no liability for your use of this software and any hardware.
Submit issues on the issues page or in a detailed report on GitHub issues page. For quick help post in issues channel on our discord server.
This fork uses the SCC Gap Setting on cluster to display how far a lead is when a lead is there. When there is no lead a "driving" animation will display on screen with scrolling gap bars that change in speed with vehicle speed.
This fork has full long control for all HKG with radar harness(AEB should work for FCA11 and FCA12 cars) and Radar Disable(NO AEB OR FCA!!!). All other cars should require scc to be moved to bus 2 from bus 0 for full long control.
- Reach out to oricalworks#5623 on discord to buy a radar harness. 1 & 1/2 week lead time depending on location of parts.
- SCC ECU / Radar Harness SHOULD preserve Automatic Emergency Braking(FCA) and Evasive Manuver Assist on MOST vehicles. Tested on 2018 Kia Stinger 2.0L Premium.
!!NO AEB OR FCA!!
Make sure the car is OFF.
Under Community set the Radar Disable and HKG Long toggle to the ON position and reboot device and restart car.
Make sure the car is OFF.
Then run this from SSH.
killall boardd; python /data/openpilot/selfdrive/debug/hyundai_enable_radar_points.py
Follow instrucions from script. Reboot and restart car; make sure no errors on dash.
Turn on Are Radar Tracks Enabled? Toggle.
Then reboot and restart car.
For a more detailed look at this, take a look at this great write up by Sunnyhaibin - https://github.com/sunnyhaibin/openpilot/blob/(!)README/HOW-TOS.md#radar-tracks
HKG Modified Assistive Driving Mode (MAD) allows openpilot's Automatic Lane Centering (ALC) and Adaptive Cruise Control (ACC) / Smart Cruise Control (SCC) to be engaged independently of each other.
openpilot's ALC and ACC/SCC can be engaged independently of each other.
Dedicated button to toggle openpilot ALC:
CRUISE (MAIN): Toggle ALC
SET: engage ACC/SCC
CANCEL: only disengage ACC/SCC
BRAKE pedal press will disengage openpilot ACC/SCC
BRAKE pedal press will NOT disengage openpilot ALC
GAS pedal press will NOT disengage openpilot ALC or ACC/SCC
!! WIP !!
Before! testing SPAS steering, ↓↑ !BE SURE TO READ ALL OF THE SPAS SECTION AND UNDERSTAND HOW IT WORKS! ↑↓; Be aware of all the safety concerns with USING ALL OF THE TORQUE that the MDPS/EPS motor can provide! ! KEEP HANDS ON WHEEL AND EYES ON ROAD AT ALL TIMES ! You are responsible for actions of car engaged or not engaged!
SPAS stands for Smart Parking Assist System. Your vehicle does not need to be equiped with this feature to use it. To use this an MDPS harness is required!
Most H.K.G. MDPS will accept these messages. This is currently reported to be working on vehicles 2019 and under, with newer vehicles needing more work due to tighter tolerances on logic, more checks, and new checksums on RSPA. To get a new vehicle working you need to set the ret.emsType = _ for your vehicle if one is not set.
Which EMS am I?
Register your device to RetroPilot. Then go for a short drive and grab a cabana for your car, Then use the "Kia_Hyundai_Generic" DBC. Search for EMS and see which EMS your vehicle uses. Then set ret.emsType = : N/A = 0 : EMS366 = 1 : EMS11 = 2 : E_EMS11 = 3 :
Reach out with any questions or to get help with EMS types not listed, join our discord and ask in the spas channel.
- To use this an MDPS harness is required.
- MDPS stands for Motor Driven Power Steering.
- Panda safety is in a working state and needs more testing and edge case tuning, I.E. The rate limit's for the steering wheel SPAS is set conservatively and may need some increasing.
- Just because there is panda safety code PLEASE do not ever fully assume it is safe, especially since this is so new! Remember this is using the ENTIRE force of the MDPS/EPS Motor!
- This works by faking the vehicle speed ONLY to the MDPS when it's in state 5 (SPAS Steer/Assist) and sending an angle to MDPS to execute.
- OpenPilot currently switches to LKAS steering at 30MPH automatically. If the tune of LKAS steering is not good and stable there can be a noticeable transition on a curve. Although if your vehicle is properly tuned you should have no issues, In all of my testing.
- Dynamic SPAS Activates SPAS on certain driving conditions under 60MPH.
- When LKAS is not active, the controlers are being reset to prevent upwind or unwind issues.
- OpenPilot and Panda are monitoring driver torque from MDPS11. The correct one for use with SPAS. When OpenPilot detects a force being applied to wheel that's greater than the set limit of 2.85Nm. Panda will call a violation and controls not allowed if this higher limit is reached. Panda's limit is set greater than OpenPilots so it won't cause controls mismatch and interference due to it blocking signals when this is violated. - PANDA DRIVER TORQUE MONITORING TEMPORARILY DISABLED - Need to send MDPS into state 7 first before tx = 0 from panda not Openpilot
- OpenPilot is appying a rate limit up and down to the sent steering angles and Panda is enforcing this. NOTE Panda's SPAS up and down rate limits are set conservatively and may require some adjusting. The result of panda calling a violation, will cause a controls mismatch.
- Panda is enforcing that SPAS is off when controls not allowed or not engaged.
- If driver torque is detected above set limit with SPAS on and under 38Mph, OpenPilot will disengage unless dynamic SPAS is active with the LKAS switch toggle.
- ! KEEP HANDS ON WHEEL AND EYES ON ROAD AT ALL TIMES !
Before! testing SPAS steering, ↓↑ !BE SURE TO READ ALL OF THE SPAS SECTION AND UNDERSTAND HOW IT WORKS! ↑↓; Be aware of all the safety concerns with USING ALL OF THE TORQUE that the MDPS/EPS motor can provide! ! KEEP HANDS ON WHEEL AND EYES ON ROAD AT ALL TIMES ! You are responsible for actions of car engaged or not engaged!
- Speed limit wrong or missing? Contribute to Open Street Maps in your area! https://www.openstreetmap.org
- Special Thanks to the Move-Fast Team for all the help and hard work with OSM!
- With an active internet connection, and HKG Long, OpenPilot can plan ahead using vision and map data to slow for curves and adjust the longitudinal plan for speed limit and other factors.
- Cruise speed does not adjust SCC max set speed, OSM instead adjusts longitudinal plan. So for it to work set max SCC speed higher than speed limit. To override speed limit tap on speed limit symbol on screen in top left corner next to max speed.
- All Settings are under
TogglesinSettings. - We have the correct DBC for newer Hyundais; 2019+ with built in navigation. To pull the speed limit information from head unit over can bus. Toggle
Pull Hyundai Navigation Speed Limitto the ON position and OSM will use both the OSM API and the cars Head Unit GPS/Navigation reported speed limit information to decide the speed limit. - https://www.youtube.com/watch?v=hTuvA6o6gjY
- When toggled on, replaces the default Hyundai / Kia / Genesis factory longitudinal control system (SCC) with the openpilot system.
- Lead markers are not available unless you have HKG long toggle on; this is not a method to determine if longitudinal is working.
- Radar harness or mod is needed.
- Move SCC ECU / RADAR to bus 2.
- Radar Off CAN but expected from car.
- Radar Disable (Diagnostics Mode) !Vision only! !AEB and FWC DISABLED!
This fork uses RetroPilot for logging and online services. https://api.retropilot.org/useradmin
Make sure "Upload Raw Logs" and "Enable Logger / Uploader" are both ON for this to work.
The Comma 3 has great performance with this fork.
The Comma 2 has POOR performance with logging and uploader enabled so it's disabled by default. You can change that in Settings under Community.
MDPS Harness are available if you have the newer style plug and or 2015 - 2016 Genesis. Contact johnpr#5623 on discord for more information.
-
2015 - 2016 Genesis requires some work to install please review this guide from Ahmed Barnawi. This guide is centered around SMDPS but from page (2 - 7) is no different for MDPS harness installation. If you have a MDPS Harness kit skip right on past step 1, 2, & 3 of "Execution" on page 2 and start from there. The MDPS harness connects between comma power and RJ45 from the Car Harness Box. https://github.com/Circuit-Pro/openpilot/blob/main/Guides/Hyundai_MDPS_Comma_Harness.pdf
-
Newer style plug for MDPS ECU located in cabin (Most likely up under the steering wheel.) is plug and play. MDPS harness connects between comma power and RJ45 from the Car Harness Box. The MDPS ECU data connector(CAN L, H, and IGN) gets unplugged from MDPS ECU and this connector that just got unplugged gets plugged into female of harness and the male MDPS harness connector will replace where the MDPS ECU data connector(CAN L, H, and IGN) originally was. I.E. MDPS ECU Data female socket. Avoid touching MDPS ECU Power connector and any others.
-
Radar Harness for Kia Stinger, G70, Niro, and Ioniq are available. Varying lead time based on location of radar connector. Contact johnpr#5623 on discord for more information.
Make sure to shut off auto start stop or you will get steering temporarily unavailable if the engine shuts off.
Screen Recordings
-
Comma 3 Storage Location.
/storage/emulated/0/videos -
Comma 2 Storage Location.
/data/media/0/videos
Click any of the settings to get a breif description in OpenPilot settings.
Loading Logo
The loading logo is automatically set to your HKG cars brand after the first boot, first car start, first reboot, and resets on update.
nTune
- nTune Auto Tunes lateral LQR steering and some SCC/Long settings like accuation delay upper and lower bounds, gas factor, and brake factor.=
Run nTune in middle of drive: Use this command cd selfdrive && python ntune.py or use the button in Settings under Device. (make sure your not driving!)
Delete UI Screen Recordings button in Settings under Device.
Toggles
- Toggles are in
SettingsunderCommunity&Device.
Cluster Speed
- Uses the speed of the gauge cluster instead Wheel speeds.
LDWS toggle
- under
CommunityinSettings. For cars with LDWS but not SCC.
Show Debug UI
- I feel like you should understand what “debugging” and a “UI” are before you can use openpilot
Use SMDPS Harness
- Use of MDPS Harness to enable openpilot steering down to 0 MPH
On screen blinkers and blind spot alerts.
- Your choice of Neokii or Crwusiz on screen blinkers with Crwusiz on-screen Blind Spot Monitoring indicators.
Enable Lane Change Assist
- allows openpilot to change lanes. Driver is responsible for ensuring that it is SAFE to change lanes. Requires signal, and steering wheel nudge.
Auto Lane Change with Blind spot monitoring toggle (No Nudge).
- Same as the original, now with 100% less nudge.
Sync Speed on Gas Press
- openpilot will sync cruise control set speed to match last attained speed automatically
Make sure to reboot with toggle changes.
Then give it a spin.
OpenPilot HKG Long will not see totally stopped cars yet until E2E comes in 0.9 so do not trust it to see and stop for a COMPLETLY stopped car.
If Collision Warning is beeping at you OpenPilot has calculated it can't stop quick enough due to safety limitations on unintentional braking. Please apply brakes to avoid collision.
Comma 3
Put this url during setup for Stable https://smiskol.com/fork/Circuit-Pro/stable
Put this url during setup for Stable Open Street Maps https://smiskol.com/fork/Circuit-Pro/stable_OSM
Comma 2
Put this url during setup for Stable https://smiskol.com/fork/Circuit-Pro/stable
If you installed from SSH
- make sure too run
rm /data/params/d/DongleIdto reset your dongle ID.
Make sure to run the ./recover.sh while car is off, otherwise it won't find the device. If it still can't find the device, unplug comma for 5 min and plug it back in and run ./recover.sh again.
Comma 3
Try this first; refer to instructions above, if this does not work. - pkill -f openpilot; cd panda/board; ./recover.sh; sudo reboot
pkill -f openpilot; cd panda/board; ./flash.sh; sudo reboot
Comma 2
Try this first; refer to instructions above, if this does not work. - pkill -f openpilot; cd panda/board; ./recover.sh; reboot
pkill -f openpilot; cd panda/board; ./flash.sh; reboot
To print debug info for Panda and Harness issue:
python panda/tests/debug_console.py
To print Opentpilot live data:
python selfdrive/debug/dump.py <category>
replace with any one of these: health carState carControl controlsState carParams sendcan can
This is based on xx979xx & Neokii's & crwusiz's fork and is tuned best 2.0L Kia Stinger, and works on others... Please submit a tune to our discord if you find a better one.
https://github.com/xx979xx/openpilot
https://github.com/crwusiz/openpilot
https://github.com/move-fast/openpilot
https://github.com/xps-genesis/openpilot
https://github.com/dragonpilot-community/dragonpilot
Unlimited data, data only simcard compatible with C2.
https://www.amazon.com/dp/B07JCTZ3BF/ref=cm_sw_r_u_apa_glt_fabc_SNA9EVB27NT0DPRMEY3Q?psc=1
Run adb shell am start -a android.settings.SETTINGS and go too "SIM cards" and under Cellular network settings choose either "SIM 1 settings" or "SIM 2 settings" (based on which slot you have your non comma sim installed in.) Then go to Access Point Names add and set APN name correctly for sim provider(for the one i'm using and linked above the APN username is m2mglobal leave everything else default or blank. (MCC 310, MNC 260)
Kia Niro MDPS ECU - http://www.kniro.net/schematic_diagrams-1321.html
MDPS Connectors
Male
Female
- https://www.mouser.com/ProductDetail/aptiv/15406142/?qs=xyz6lfZ1ktKtmezTNc3DLw%3D%3D&countrycode=CA¤cycode=CAD
- https://www.mouser.com/ProductDetail/aptiv/15401440-l/?qs=NKHyz0HolODmWpNAvMSDSg%3D%3D&countrycode=CA¤cycode=CAD
Black Panda
RJ45 female connectors
RJ45 black panda and comma power adapter
It is open source and inherits MIT license. 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.
- What is openpilot?
- Running in a car
- Running on PC
- Community and Contributing
- User Data and comma Account
- Safety and Testing
- Directory Structure
- Licensing
openpilot is an open source driver assistance system. Currently, openpilot performs the functions of Adaptive Cruise Control (ACC), Automated Lane Centering (ALC), Forward Collision Warning (FCW) and Lane Departure Warning (LDW) for a growing variety of supported car makes, models and model years. In addition, while openpilot is engaged, a camera based Driver Monitoring (DM) feature alerts distracted and asleep drivers. See more about the vehicle integration and limitations.
 |
 |
 |
 |
 |
 |
 |
 |
To use openpilot in a car, you need four things
- This software. It's free and available right here.
- One of the 140+ supported cars. We support Honda, Toyota, Hyundai, Nissan, Kia, Chrysler, Lexus, Acura, Audi, VW, and more. If your car is not supported, but has adaptive cruise control and lane keeping assist, it's likely able to run openpilot.
- A supported device to run this software. This can be a comma two, comma three, or if you like to experiment, a Ubuntu computer with webcams.
- A way to connect to your car. With a comma two or three, you need only a car harness. With an EON Gold or PC, you also need a black panda.
We have detailed instructions for how to install the device in a car.
All of openpilot's services can run as normal on a PC, even without special hardware or a car. To develop or experiment with openpilot you can run openpilot on recorded or simulated data.
With openpilot's tools you can plot logs, replay drives and watch the full-res camera streams. See the tools README for more information.
You can also run openpilot in simulation with the CARLA simulator. This allows openpilot to drive around a virtual car on your Ubuntu machine. The whole setup should only take a few minutes, but does require a decent GPU.
openpilot is developed by comma and by users like you. We welcome both pull requests and issues on GitHub. Bug fixes and new car ports are encouraged. Check out the contributing docs.
Documentation related to openpilot development can be found on docs.comma.ai. Information about running openpilot (e.g. FAQ, fingerprinting, troubleshooting, custom forks, community hardware) should go on the wiki.
You can add support for your car by following guides we have written for Brand and Model ports. Generally, a car with adaptive cruise control and lane keep assist is a good candidate. Join our Discord to discuss car ports: most car makes have a dedicated channel.
Want to get paid to work on openpilot? comma is hiring.
And follow us on Twitter.
By default, openpilot uploads the driving data to our servers. You can also access your data through comma connect. We use your data to train better models and improve openpilot for everyone.
openpilot is open source software: the user is free to disable data collection if they wish to do so.
openpilot logs the road facing cameras, CAN, GPS, IMU, magnetometer, thermal sensors, crashes, and operating system logs. The driver facing camera is only logged if you explicitly opt-in in settings. The microphone is not recorded.
By using openpilot, you agree to our Privacy Policy. You understand that use of this software or its related services will generate certain types of user data, which may be logged and stored at the sole discretion of comma. By accepting this agreement, you grant an irrevocable, perpetual, worldwide right to comma for the use of this data.
- openpilot observes ISO26262 guidelines, see SAFETY.md for more details.
- openpilot has software in the loop tests that run on every commit.
- The code enforcing the safety model lives in panda and is written in C, see code rigor for more details.
- panda has software in the loop safety tests.
- Internally, we have a hardware in the loop Jenkins test suite that builds and unit tests the various processes.
- panda has additional hardware in the loop tests.
- We run the latest openpilot in a testing closet containing 10 comma devices continuously replaying routes.
.
├── cereal # The messaging spec and libs used for all logs
├── common # Library like functionality we've developed here
├── docs # Documentation
├── opendbc # Files showing how to interpret data from cars
├── panda # Code used to communicate on CAN
├── third_party # External libraries
├── pyextra # Extra python packages
└── selfdrive # Code needed to drive the car
├── assets # Fonts, images, and sounds for UI
├── athena # Allows communication with the app
├── boardd # Daemon to talk to the board
├── camerad # Driver to capture images from the camera sensors
├── car # Car specific code to read states and control actuators
├── common # Shared C/C++ code for the daemons
├── controls # Planning and controls
├── debug # Tools to help you debug and do car ports
├── locationd # Precise localization and vehicle parameter estimation
├── logcatd # Android logcat as a service
├── loggerd # Logger and uploader of car data
├── modeld # Driving and monitoring model runners
├── proclogd # Logs information from proc
├── sensord # IMU interface code
├── test # Unit tests, system tests, and a car simulator
└── ui # The UI
openpilot is released under the MIT license. Some parts of the software are released under other licenses as specified.
Any user of this software shall indemnify and hold harmless Comma.ai, Inc. and its directors, officers, employees, agents, stockholders, affiliates, subcontractors and customers from and against all allegations, claims, actions, suits, demands, damages, liabilities, obligations, losses, settlements, judgments, costs and expenses (including without limitation attorneys’ fees and costs) which arise out of, relate to or result from any use of this software by user.
THIS IS ALPHA QUALITY SOFTWARE FOR RESEARCH PURPOSES ONLY. THIS IS NOT A PRODUCT. YOU ARE RESPONSIBLE FOR COMPLYING WITH LOCAL LAWS AND REGULATIONS. NO WARRANTY EXPRESSED OR IMPLIED.
