Skip to content
/ openpilot Public
forked from commaai/openpilot

GM openpilot is an open source driver assistance system. openpilot performs the functions of Automated Lane Centering and Adaptive Cruise Control for over 100 supported car makes and models.

License

Notifications You must be signed in to change notification settings

opgm/openpilot

 
 

Repository files navigation

OPGM openpilot fork

This is a fork of openpilot, an open source driver assistance system. Please consult the official documentation for most questions.

OPGM strives to align as closely to the official openpilot as possible, while adding functionality for GM vehicles that are officially unsupported. Additionally, OPGM adds some creature comforts and quality of life improvements.

OPGM will be rebased on top of the official openpilot frequently to keep up with upstream changes. The latest sync was with commit 93fa207c5c from the master branch. The latest build was done on May 15, 2024.

Features

  • Support for GM vehicles with LKAS but no ACC
  • Pedal interceptor support for longitudinal control
    • Also provides full regen on GM Bolt EV/EUV with ACC (in process of upstreaming)
  • CC long, aka "redneck ACC" to automatically adjust nonadaptive cruise control
    • CC long is not a substitute for ACC. It is incapable of reducing the vehicle speed below 24mph.

  • Neural network steering control, credit twilsonco
  • Always On Lateral (AOL), credit pfeiferj

Supported vehicles list

OPGM is capable of supportng vehicles on the Global A architecture that have factory LKAS. Currently supported vehicles include:

  • All vehicles supported by upstream openpilot
  • 2016-2019 Chevrolet Volt
  • 2017-2019 Chevrolet Bolt EV
  • 2020-2023 Chevrolet Bolt EV/EUV w/o ACC
  • Chevrolet Equinox/GMC Terrain w/o ACC
  • Chevrolet Tahoe/GMC Yukon w/o ACC
  • Chevrolet Suburban w/o ACC

If your vehicle is not on this list, there is a very good chance that already is or can be supported! You will need to collect your vehicle's fingerprint.

At this time, Global B and VIP architectures are unsupported due to CAN bus encryption. If you have a vehicle on one of these architectures and consider yourself to be a hacker/tinkerer type, we would love to hear from you!

Fingerprinting your vehicle

Note! You likely do not have to do this. Try installing OPGM first, and only proceed with the fingerprinting process if it does not work out of the box.

You will first need to set up SSH access to your device. Then, follow the fingerprinting instructions posted here.

You must follow the v1.0 instructions. Fingerprint v2.0 is not yet supported for GM vehicles.

Reach out in the OPGM discord channel with questions, or after you have fingerprinted your vehicle so it can be added to OPGM.

Installation

Hardware

OPGM supports the Comma Three development platform; legacy support for Comma Two is not guaranteed. Some older development branches may work on Comma Two. Use at your own risk.

Verify first that your vehicle has LKAS. Verify as well that it has a forward-facing camera; you can do this by removing the plastic cover on the windshield behind the rearview mirror. If you see a silver rectangular camera, you're good to go.

If you have vehicle supported by upstream openpilot, buy the corresponding hardware from Comma.

If you have a vehicle without ACC, buy the Bolt EV/EUV kit from Comma. If you have a Bolt EV/EUV, it is strongly recommended to purchase a pedal interceptor for the best experience. (You may always add one later, if you want to try OPGM before committing.)

You may buy a pedal interceptor from the following vendors:

Software

For the latest stable build, use the install URL: opgm.cc

Installation troubleshooting

If the installation fails partway through, try moving your device closer to your WiFi router.

  • You may plug the Comma Three into a USB power source delivering at least 2A of current.

Ensure that your car is completely powered off during software installation, otherwise you may get a "no panda" error. To be sure that your car is completely powered down:

  1. Turn the car on and off
  2. Open and close the driver's door
  3. Wait 5 minutes

Known issues

  • Curve hugging and laneline crossing are known issues of upstream openpilot.
  • Officially supported cars (e.g. ACC Volt and Bolt) may have issues fingerprinting on OPGM. Currently, the only workaround is to hardcode your fingerprint in the /data/openpilot/launch_openpilot.sh file.

Discussion

Come join us on the OPGM channel in the openpilot community discord!

Contributing

Feel free to open a pull request against the dev branch.

Credits

  • comma.ai for openpilot
  • jshuler
  • nworby
  • twilsonco
  • k1mu
  • kliu
  • mochi86420
  • Many others

License

OPGM is under the MIT license. See LICENSE for more information.

About

GM openpilot is an open source driver assistance system. openpilot performs the functions of Automated Lane Centering and Adaptive Cruise Control for over 100 supported car makes and models.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 61.8%
  • C++ 29.5%
  • Python 7.8%
  • Cap'n Proto 0.3%
  • Assembly 0.3%
  • Cython 0.2%
  • Other 0.1%