democratize access to car decoder rings
Go to file
Louis Velez e57375f1e2
CI: fix macOS test running (#1516)
* CI: fixes MacOS test running

* CI: adds coreutils for nproc

* CI: fixes based on PR

* cleanup

---------

Co-authored-by: Adeeb Shihadeh <adeebshihadeh@gmail.com>
2024-11-21 14:16:17 -08:00
.github CI: fix macOS test running (#1516) 2024-11-21 14:16:17 -08:00
docs docs: add Honda Odyssey WIP to CARS.md (#1365) 2024-10-12 11:47:48 -04:00
examples rm longitudinal profiles (#1240) 2024-09-12 16:55:06 -07:00
opendbc Match pid.py file from openpilot (#1514) 2024-11-20 19:26:21 -08:00
site_scons/site_tools cython dependency scanner 2021-01-11 14:16:02 -08:00
.gitignore longitudinal profile runner (#1197) 2024-08-30 13:48:13 -07:00
.pre-commit-config.yaml Bump pre-commit hooks, more coverage (similar to openpilot) (#1078) 2024-08-16 22:24:44 -07:00
LICENSE add license 2021-04-30 14:25:37 -07:00
README.md hiring shill in readme 2024-11-17 14:35:46 -08:00
SConstruct CI: fix macOS test running (#1516) 2024-11-21 14:16:17 -08:00
pyproject.toml CI: fix macOS test running (#1516) 2024-11-21 14:16:17 -08:00
test.sh CI: fix macOS test running (#1516) 2024-11-21 14:16:17 -08:00

README.md

opendbc

opendbc is a Python API for your car.
Read the speed, steering angle, and more. Send gas, braking, and steering commands.

Docs · Contribute · Discord

License: MIT X Follow Discord


Most cars since 2016 have electronically-actuatable steering, gas, and brakes thanks to LKAS and ACC. The goal of this project is to support controlling every single one of those cars. See docs/CARS.md for the current supported cars list.

While the primary focus is on supporting ADAS interfaces for openpilot, we're also interested in reading and writing as many things as we can: EV charge status, lock/unlocking doors, etc.

Contributing

All opendbc development is coordinated on GitHub and Discord. Check out the #dev-opendbc-cars channel and Vehicle Specific section.

Roadmap

Short term

Longer term

  • Extend support to every car with LKAS + ACC interfaces
  • Automatic lateral and longitudinal control/tuning evaluation
  • Auto-tuning for lateral and longitudinal control
  • Automatic Emergency Braking

Contributions towards anything here are welcome.

Bounties

Every car port is eligible for a bounty:

In addition to the standard bounties, we also offer higher value bounties for more popular cars. See those at comma.ai/bounties.

Project Structure

  • opendbc/dbc/ is a repository of DBC files
  • opendbc/can/ is a library for parsing and building CAN messages from DBC files
  • opendbc/car/ is a high-level library for interfacing with cars using Python

Quick start

git clone https://github.com/commaai/opendbc.git

cd opendbc

# Install the dependencies
pip3 install -e .[testing,docs]

# Build
scons -j8

# Run the tests
pytest .

# Run the linter
pre-commit run --all-files

# ./test.sh is the all-in-one that will install deps, build, lint, and test
./test.sh

examples/ contains small example programs that can read state from the car and control the steering, gas, and brakes. examples/joystick.py allows you to control a car with a joystick.

FAQ

How do I use this?

Depends on what you want to do. openpilot is our development target and offers a replacement for your car's ADAS, but you can also use a panda for basic control or just reading state from your car.

What hardware do I need?

Which cars are supported?

See the supported cars list.

Can I add support for my car?

Yes, most car support comes from the community. Join the Discord and watch this talk to get started. (We also offer paid bounties on car ports.)

Which cars can be supported?

Any car with LKAS and ACC. More info here.

How does this work?

In short, we designed hardware to sit at a convenient spot on your car's communication bus that allows for filtering out interesting messages and replacing them with our own.
See this talk for an in-depth explanation.

Come work with us -- comma.ai/jobs

comma is hiring engineers to work on opendbc and openpilot. We love contributors.