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 6810c5b644
from the
master branch. The latest build was done on January 22, 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:
- Turn the car on and off
- Open and close the driver's door
- 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.