sadmen
/
openpilot_comma
mirror of https://github.com/commaai/openpilot.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
openpilot is an open source driver assistance system. openpilot performs the functions of Automated Lane Centering and Adaptive Cruise Control for over 200 supported car makes and models.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
14832 Commits
123 Branches
82 Tags
5.0 GiB
 
 
 
 
 
 
Tag: Branch: Tree: alt-buttons-cancel
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'alt-buttons-cancel'
${ noResults }
openpilot_comma/docs/car-porting/what-is-a-car-port.md

1.6 KiB
Raw Permalink Blame History

What is a car port?

A car port enables openpilot support on a particular car. Each car model openpilot supports needs to be individually ported. The complexity of a car port varies depending on many factors including:

  • existing openpilot support for similar cars
  • architecture and APIs available in the car

Structure of a car port

Virtually all car-specific code is contained in two other repositories: opendbc and panda.

opendbc

Each car brand is supported by a standard interface structure in opendbc/car/[brand]:

  • interface.py: Interface for the car, defines the CarInterface class
  • carstate.py: Reads CAN messages from the car and builds openpilot CarState messages
  • carcontroller.py: Control logic for executing openpilot CarControl actions on the car
  • [brand]can.py: Composes CAN messages for carcontroller to send
  • values.py: Limits for actuation, general constants for cars, and supported car documentation
  • radar_interface.py: Interface for parsing radar points from the car, if applicable

panda

  • board/safety/safety_[brand].h: Brand-specific safety logic
  • tests/safety/test_[brand].py: Brand-specific safety CI tests

openpilot

For historical reasons, openpilot still contains a small amount of car-specific logic. This will eventually be migrated to opendbc or otherwise removed.

  • selfdrive/car/car_specific.py: Brand-specific event logic

Overview

Jason Young gave a talk at COMMA_CON with an overview of the car porting process. The talk is available on YouTube:

https://www.youtube.com/watch?v=XxPS5TpTUnI