Trên GitHub, commaai/opendbc đã đạt 3.6k sao, nhóm Data, ngôn ngữ Python. a Python API for your car
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
opendbc is a Python API for your car.
Control the gas, brake, steering, and more. Read the speed, steering angle, and more.
Docs
·
Contribute
·
Discord
How to Port a Car — Jason Young, COMMA_CON 2023
How Do We Control The Car? — Robbe Derks, COMMA_CON 2021
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 the steering, gas, and brakes on every single one of those cars.
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) such that we can build the best vehicle management app ever.
This README and the supported cars list are all the docs for the opendbc project.
Everything you need to know to use, contribute, and extend opendbc are in these docs.
Quick start
git clone https://github.com/commaai/opendbc.git
cd opendbc
# you probably just want to use this. it's an all-in-one for dependency
# installation, compiling, linting, and tests. it's also what runs in CI
./test.sh
# here are the individual commands it runs
pip3 install -e .[testing] # install dependencies
scons -j8 # build with 8 cores
unittest-parallel # run the tests
lefthook run lint # run the linter
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.
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
opendbc/safety/ is the functional safety for all the cars supported by opendbc/car/
How to Port a Car
This guide covers everything from adding support to a new car all the way to improving existing cars (e.g. adding longitudinal control or radar parsing). If similar cars to yours are already compatible, most of this work is likely already done for you.
At its most basic, a car port will control the steering on a car. A "complete" car port will have all of: lateral control, longitudinal control, good tuning for both lateral and longitudinal, radar parsing (if equipped), fuzzy fingerprinting, and more. The new car support docs will clearly communicate each car's support level.
Connect to the Car
The first step is to get connected to the car with a comma four and a car harness.
The car harness gets you connected to two different CAN buses and splits one of those buses to send our own actuation messages.
If you're lucky, a harness compatible with your car will already be designed and sold on comma.ai/shop.
If you're not so lucky, start with a "developer harness" from comma.ai/shop and crimp on whatever connector you need.
Structure of a port
Depending on the brand, most of this basic structure will already be in place.
The entirety of a car port lives in opendbc/car/<brand>/:
carstate.py: parses out the relevant information from the CAN stream using the car's DBC file
carcontroller.py: outputs CAN messages to control the car
<brand>can.py: thin Python helpers around the DBC file to build CAN messages
fingerprints.py: database of ECU firmware versions for identifying car models
interface.py: high level class for interfacing with the car
radar_interface.py: parses out the radar
values.py: enumerates the brand's supported cars
Reverse Engineer CAN messages
Start off by recording a route with lots of interesting events: enable LKAS and ACC, turn the steering wheel both extremes, etc. Then, load up that route in cabana.
Tuning
Longitudinal
Use the longitudinal maneuvers report to evaluate your car's longitudinal control and tune it.
Validation
Before submitting a port, go through the car porting checklist.
Contributing
All opendbc development is coordinated on GitHub and Discord. Check out the #dev-opendbc-cars channel and Vehicle Specific section.
Roadmap
Short term
pip install opendbc
100% type coverage
100% line coverage
Make car ports easier: refactors, tools, tests, and docs
Expose the state of all supported cars better: https://github.com/commaai/opendbc/issues/1144
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.
Safety Model
When a panda powers up with opendbc safety firmware, by default it's in SAFETY_SILENT mode. While in SAFETY_SILENT mode, the CAN buses are forced to be silent. In order to send messages, you have to select a safety mode. Some of safety modes (for example SAFETY_ALLOUTPUT) are disabled in release firmwares. In order to use them, compile and flash your own build.
Safety modes optionally support controls_allowed, which allows or blocks a subset of messages based on a customizable state in the board.
Code Rigor
The opendbc safety firmware is written for its use in conjunction with openpilot and panda. The safety firmware, through its safety model, provides and enforces the
openpilot safety. Due to its critical function, it's important that the application code rigor within the safety folder is held to high standards.
These are the CI regression tests we have in place:
A generic static code analysis is performed by cppcheck.
In addition, cppcheck has a specific addon to check for MISRA C:2012 violations. See current coverage.
Compiler options are relatively strict: the flags -Wall -Wextra -Wstrict-prototypes -Werror are enforced.
The safety logic is tested and verified by unit tests for each supported car variant.
The above tests are themselves tested by:
a mutation test on the MISRA coverage
100% line coverage enforced on the safety unit tests
In addition, we run the ruff linter and ty on the car interface library.
Bounties
Every car port is eligible for a bounty:
$2000 - Any car brand / platform port
$250 - Any car model port
$300 - Reverse Engineering a new Actuation Message
In addition to the standard bounties, we also offer higher value bounties for more popular cars. See those at comma.ai/bounties.
FAQ
How do I use this? A comma four is custom-designed to be the best way to run and develop opendbc and openpilot.
Which cars are supported? See the supported cars list.
Can I add support for my car? Yes, most car support comes from the community. Read the guide here.
Which cars can be supported? Any car with LKAS and ACC. More info here.
How does this work? In short, we designed hardware to replace your car's built-in lane keep and adaptive cruise features. See this talk for an in-depth explanation.
Is there a timeline or roadmap for adding car support? No, most car support comes from the community, with comma doing final safety and quality validation. The more complete the community car port is and the more popular the car is, the more likely we are to pick it up as the next one to validate.
Terms
port: refers to the integration and support of a specific car
lateral control: aka steering control
longitudinal control: aka gas/brakes control
fingerprinting: automatic process for identifying the car
LKAS: lane keeping assist
ACC: adaptive cruise control
harness: car-specific hardware to attach to the car and intercept the ADAS messages
panda: hardware used to get on a car's CAN bus
ECU: computers or control modules inside the car
CAN bus: a bus that connects the ECUs in a car
cabana: our tool for reverse engineering CAN messages
DBC file: contains definitions for messages on a CAN bus
openpilot: an ADAS system for cars supported by opendbc
comma: the company behind opendbc
comma four: the hardware used to run openpilot
More resources
How Do We Control The Car? by @robbederks from COMMA_CON 2021
How to Port a Car by @jyoung8607 from COMMA_CON 2023
commaCarSegments: a massive dataset of CAN data from 300 different car models
cabana: our tool for reverse engineering CAN messages
can_print_changes.py: diff the whole CAN bus across two drives, such as one without any LKAS and one with LKAS
longitudinal maneuvers: a tool for evaluating and tuning longitudinal control
opendbc data: a repository of longitudinal maneuver evaluations
Come work with us -- comma.ai/jobs
comma is hiring engineers to work on opendbc and openpilot. We love hiring contributors.
GitHub topics của commaai/opendbc: "automotive", "can", "dbc", "reverse-engineering". TopGit xếp repo vào nhóm Data.
commaai/opendbc có phải mã nguồn mở không?
Có — commaai/opendbc phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/commaai/opendbc.
commaai/opendbc có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho commaai/opendbc. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
commaai/opendbc còn đang phát triển không?
Commit gần nhất trên commaai/opendbc là 6 ngày trước (theo timestamp GitHub). Repo có 2.4k fork — một chỉ báo về mức độ quan tâm của cộng đồng.
commaai/opendbc dùng license gì?
commaai/opendbc phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
Đọc thêm về commaai/opendbc ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/commaai/opendbc là nguồn chính thức.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về opendbc?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về opendbc.