Skip to main content
  1. Projects/

openpilot

·2541 words·12 mins
Jake Roggenbuck
Author
Jake Roggenbuck
I am currently studying Computer Science

Table of Contents #


What is openpilot? #

openpilot is an open source driver assistance system. Currently, openpilot performs the functions of Adaptive Cruise Control (ACC), Automated Lane Centering (ALC), Forward Collision Warning (FCW) and Lane Departure Warning (LDW) for a growing variety of supported car makes, models and model years. In addition, while openpilot is engaged, a camera based Driver Monitoring (DM) feature alerts distracted and asleep drivers.

Integration with Stock Features #

In all supported cars:

  • Stock Lane Keep Assist (LKA) and stock ALC are replaced by openpilot ALC, which only functions when openpilot is engaged by the user.
  • Stock LDW is replaced by openpilot LDW.

Additionally, on specific supported cars (see ACC column in supported cars):

  • Stock ACC is replaced by openpilot ACC.
  • openpilot FCW operates in addition to stock FCW.

openpilot should preserve all other vehicle’s stock features, including, but are not limited to: FCW, Automatic Emergency Braking (AEB), auto high-beam, blind spot warning, and side collision warning.

Supported Hardware #

At the moment, openpilot supports the EON DevKit and the comma two. A car harness is recommended to connect the EON or comma two to the car. In the future, we’d like to support other platforms as well, like gaming PCs.

Supported Cars #

MakeModel (US Market Reference)Supported PackageACCNo ACC accel belowNo ALC below
AcuraILX 2016-18AcuraWatch Plusopenpilot25mph625mph
AcuraRDX 2016-18AcuraWatch Plusopenpilot25mph612mph
ChryslerPacifica 2017-18Adaptive CruiseStock0mph9mph
ChryslerPacifica Hybrid 2017-18Adaptive CruiseStock0mph9mph
ChryslerPacifica Hybrid 2019-20Adaptive CruiseStock0mph39mph
HondaAccord 2018-19AllStock0mph3mph
HondaAccord Hybrid 2018-19AllStock0mph3mph
HondaCivic Hatchback 2017-19Honda SensingStock0mph12mph
HondaCivic Sedan/Coupe 2016-18Honda Sensingopenpilot0mph12mph
HondaCivic Sedan/Coupe 2019Honda SensingStock0mph2mph4
HondaCR-V 2015-16Touringopenpilot25mph612mph
HondaCR-V 2017-19Honda SensingStock0mph12mph
HondaCR-V Hybrid 2017-2019Honda SensingStock0mph12mph
HondaFit 2018-19Honda Sensingopenpilot25mph612mph
HondaOdyssey 2018-20Honda Sensingopenpilot25mph60mph
HondaPassport 2019Allopenpilot25mph612mph
HondaPilot 2016-18Honda Sensingopenpilot25mph612mph
HondaPilot 2019Allopenpilot25mph612mph
HondaRidgeline 2017-19Honda Sensingopenpilot25mph612mph
HyundaiElantra 2017-191SCC + LKASStock19mph34mph
HyundaiGenesis 20181AllStock19mph34mph
HyundaiSanta Fe 20191AllStock0mph0mph
JeepGrand Cherokee 2016-18Adaptive CruiseStock0mph9mph
JeepGrand Cherokee 2019Adaptive CruiseStock0mph39mph
KiaOptima 20191SCC + LKASStock0mph0mph
KiaSorento 20181AllStock0mph0mph
KiaStinger 20181SCC + LKASStock0mph0mph
LexusCT Hybrid 2017-18AllStock50mph0mph
LexusES 2019Allopenpilot0mph0mph
LexusES Hybrid 2019Allopenpilot0mph0mph
LexusIS 2017-2019AllStock22mph0mph
LexusIS Hybrid 2017AllStock0mph0mph
LexusNX Hybrid 2018AllStock50mph0mph
LexusRX 2016-17AllStock50mph0mph
LexusRX 2020Allopenpilot0mph0mph
LexusRX Hybrid 2016-19AllStock50mph0mph
SubaruCrosstrek 2018-19EyeSightStock0mph0mph
SubaruImpreza 2019-20EyeSightStock0mph0mph
ToyotaAvalon 2016TSS-PStock520mph60mph
ToyotaAvalon 2017-18AllStock520mph60mph
ToyotaCamry 2018-19AllStock0mph20mph
ToyotaCamry Hybrid 2018-19AllStock0mph20mph
ToyotaC-HR 2017-19AllStock0mph0mph
ToyotaC-HR Hybrid 2017-19AllStock0mph0mph
ToyotaCorolla 2017-19AllStock520mph60mph
ToyotaCorolla 2020Allopenpilot0mph0mph
ToyotaCorolla Hatchback 2019-20Allopenpilot0mph0mph
ToyotaCorolla Hybrid 2020Allopenpilot0mph0mph
ToyotaHighlander 2017-19AllStock50mph0mph
ToyotaHighlander Hybrid 2017-19AllStock50mph0mph
ToyotaHighlander 2020Allopenpilot0mph0mph
ToyotaPrius 2016TSS-PStock50mph0mph
ToyotaPrius 2017-19AllStock50mph0mph
ToyotaPrius Prime 2017-20AllStock50mph0mph
ToyotaRav4 2016TSS-PStock520mph60mph
ToyotaRav4 2017-18AllStock520mph60mph
ToyotaRav4 2019Allopenpilot0mph0mph
ToyotaRav4 Hybrid 2016TSS-PStock50mph0mph
ToyotaRav4 Hybrid 2017-18AllStock50mph0mph
ToyotaRav4 Hybrid 2019-20Allopenpilot0mph0mph
ToyotaSienna 2018AllStock50mph0mph
VolkswagenGolf 2016-193Driver AssistanceStock0mph0mph

1Requires a panda and open sourced Hyundai giraffe, designed for the 2019 Sante Fe; pinout may differ for other Hyundai and Kia models.
228mph for Camry 4CYL L, 4CYL LE and 4CYL SE which don’t have Full-Speed Range Dynamic Radar Cruise Control.
3Requires a custom connector for the car harness
42019 Honda Civic 1.6L Diesel Sedan does not have ALC below 12mph.

Community Maintained Cars and Features #

MakeModel (US Market Reference)Supported PackageACCNo ACC accel belowNo ALC below
BuickRegal 20187Adaptive Cruiseopenpilot0mph7mph
CadillacATS 20187Adaptive Cruiseopenpilot0mph7mph
ChevroletMalibu 20177Adaptive Cruiseopenpilot0mph7mph
ChevroletVolt 2017-187Adaptive Cruiseopenpilot0mph7mph
GMCAcadia Denali 20187Adaptive Cruiseopenpilot0mph7mph
HoldenAstra 20177Adaptive Cruiseopenpilot0mph7mph

5When disconnecting the Driver Support Unit (DSU), openpilot ACC will replace stock ACC. For DSU locations, see Toyota Wiki page. NOTE: disconnecting the DSU disables Automatic Emergency Braking (AEB).
6 Comma Pedal is used to provide stop-and-go capability to some of the openpilot-supported cars that don’t currently support stop-and-go. Here is how to build a Comma Pedal. NOTE: The Comma Pedal is not officially supported by comma.
7Requires a panda and community built giraffe. NOTE: disconnecting the ASCM disables Automatic Emergency Braking (AEB).

Community Maintained Cars and Features are not verified by comma to meet our safety model. Be extra cautious using them. They are only available after enabling the toggle in Settings->Developer->Enable Community Features.

Installation Instructions #

Install openpilot on a EON by entering https://openpilot.comma.ai during the installer setup.

Follow this video instructions to properly mount the EON on the windshield. Note: openpilot features an automatic pose calibration routine and openpilot performance should not be affected by small pitch and yaw misalignments caused by imprecise EON mounting.

Before placing the device on your windshield, check the state and local laws and ordinances where you drive. Some state laws prohibit or restrict the placement of objects on the windshield of a motor vehicle.

You will be able to engage openpilot after reviewing the onboarding screens and finishing the calibration procedure.

Limitations of openpilot ALC and LDW #

openpilot ALC and openpilot LDW do not automatically drive the vehicle or reduce the amount of attention that must be paid to operate your vehicle. The driver must always keep control of the steering wheel and be ready to correct the openpilot ALC action at all times.

While changing lanes, openpilot is not capable of looking next to you or checking your blind spot. Only nudge the wheel to initiate a lane change after you have confirmed it’s safe to do so.

Many factors can impact the performance of openpilot ALC and openpilot LDW, causing them to be unable to function as intended. These include, but are not limited to:

  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions that may interfere with sensor operation.
  • The road facing camera is obstructed, covered or damaged by mud, ice, snow, etc.
  • Obstruction caused by applying excessive paint or adhesive products (such as wraps, stickers, rubber coating, etc.) onto the vehicle.
  • The EON is mounted incorrectly.
  • When in sharp curves, like on-off ramps, intersections etc…; openpilot is designed to be limited in the amount of steering torque it can produce.
  • In the presence of restricted lanes or construction zones.
  • When driving on highly banked roads or in presence of strong cross-wind.
  • Extremely hot or cold temperatures.
  • Bright light (due to oncoming headlights, direct sunlight, etc.).
  • Driving on hills, narrow, or winding roads.

The list above does not represent an exhaustive list of situations that may interfere with proper operation of openpilot components. It is the driver’s responsibility to be in control of the vehicle at all times.

Limitations of openpilot ACC and FCW #

openpilot ACC and openpilot FCW are not systems that allow careless or inattentive driving. It is still necessary for the driver to pay close attention to the vehicle’s surroundings and to be ready to re-take control of the gas and the brake at all times.

Many factors can impact the performance of openpilot ACC and openpilot FCW, causing them to be unable to function as intended. These include, but are not limited to:

  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions that may interfere with sensor operation.
  • The road facing camera or radar are obstructed, covered, or damaged by mud, ice, snow, etc.
  • Obstruction caused by applying excessive paint or adhesive products (such as wraps, stickers, rubber coating, etc.) onto the vehicle.
  • The EON is mounted incorrectly.
  • Approaching a toll booth, a bridge or a large metal plate.
  • When driving on roads with pedestrians, cyclists, etc…
  • In presence of traffic signs or stop lights, which are not detected by openpilot at this time.
  • When the posted speed limit is below the user selected set speed. openpilot does not detect speed limits at this time.
  • In presence of vehicles in the same lane that are not moving.
  • When abrupt braking maneuvers are required. openpilot is designed to be limited in the amount of deceleration and acceleration that it can produce.
  • When surrounding vehicles perform close cut-ins from neighbor lanes.
  • Driving on hills, narrow, or winding roads.
  • Extremely hot or cold temperatures.
  • Bright light (due to oncoming headlights, direct sunlight, etc.).
  • Interference from other equipment that generates radar waves.

The list above does not represent an exhaustive list of situations that may interfere with proper operation of openpilot components. It is the driver’s responsibility to be in control of the vehicle at all times.

Limitations of openpilot DM #

openpilot DM should not be considered an exact measurements of the status of alertness of the driver.

Many factors can impact the performance of openpilot DM, causing it to be unable to function as intended. These include, but are not limited to:

  • Low light conditions, such as driving at night or in dark tunnels.
  • Bright light (due to oncoming headlights, direct sunlight, etc.).
  • The driver face is partially or completely outside field of view of the driver facing camera.
  • Right hand driving vehicles.
  • The driver facing camera is obstructed, covered, or damaged.

The list above does not represent an exhaustive list of situations that may interfere with proper operation of openpilot components. A driver should not rely on openpilot DM to assess their level of attention.

User Data and comma Account #

By default, openpilot uploads the driving data to our servers. You can also access your data by pairing with the comma connect app ( iOS, Android). We use your data to train better models and improve openpilot for everyone.

openpilot is open source software: the user is free to disable data collection if they wish to do so.

openpilot logs the road facing camera, CAN, GPS, IMU, magnetometer, thermal sensors, crashes, and operating system logs. The driver facing camera is only logged if you explicitly opt-in in settings. The microphone is not recorded.

By using openpilot, you agree to our Privacy Policy. You understand that use of this software or its related services will generate certain types of user data, which may be logged and stored at the sole discretion of comma. By accepting this agreement, you grant an irrevocable, perpetual, worldwide right to comma for the use of this data.

Safety and Testing #

  • openpilot observes ISO26262 guidelines, see SAFETY.md for more detail.
  • openpilot has software in the loop tests that run on every commit.
  • The safety model code lives in panda and is written in C, see code rigor for more details.
  • panda has software in the loop safety tests.
  • Internally, we have a hardware in the loop Jenkins test suite that builds and unit tests the various processes.
  • panda has additional hardware in the loop tests.
  • We run the latest openpilot in a testing closet containing 10 EONs continuously replaying routes.

Testing on PC #

Check out the tools directory in master: lots of tools you can use to replay driving data, test and develop openpilot from your pc.

Community and Contributing #

openpilot is developed by comma and by users like you. We welcome both pull requests and issues on GitHub. Bug fixes and new car ports are encouraged.

You can add support for your car by following guides we have written for Brand and Model ports. Generally, a car with adaptive cruise control and lane keep assist is a good candidate. Join our Discord to discuss car ports: most car makes have a dedicated channel.

Want to get paid to work on openpilot? comma is hiring. We also have a bounty program.

And follow us on Twitter.

Directory Structure #

.
├── apk                 # The apk files used for the UI
├── cereal              # The messaging spec and libs used for all logs on EON
├── common              # Library like functionality we've developed here
├── installer/updater   # Manages auto-updates of openpilot
├── opendbc             # Files showing how to interpret data from cars
├── panda               # Code used to communicate on CAN
├── phonelibs           # Libraries used on EON
├── pyextra             # Libraries used on EON
└── selfdrive           # Code needed to drive the car
    ├── assets          # Fonts and images for UI
    ├── athena          # Allows communication with the app
    ├── boardd          # Daemon to talk to the board
    ├── camerad         # Driver to capture images from the camera sensors
    ├── car             # Car specific code to read states and control actuators
    ├── common          # Shared C/C++ code for the daemons
    ├── controls        # Perception, planning and controls
    ├── debug           # Tools to help you debug and do car ports
    ├── locationd       # Soon to be home of precise location
    ├── logcatd         # Android logcat as a service
    ├── loggerd         # Logger and uploader of car data
    ├── modeld          # Driving and monitoring model runners
    ├── proclogd        # Logs information from proc
    ├── sensord         # IMU / GPS interface code
    ├── tests           # Unit tests, system tests and a car simulator
    └── ui              # The UI

To understand how the services interact, see cereal/service_list.yaml.

Licensing #

openpilot is released under the MIT license. Some parts of the software are released under other licenses as specified.

Any user of this software shall indemnify and hold harmless comma.ai, Inc. and its directors, officers, employees, agents, stockholders, affiliates, subcontractors and customers from and against all allegations, claims, actions, suits, demands, damages, liabilities, obligations, losses, settlements, judgments, costs and expenses (including without limitation attorneys’ fees and costs) which arise out of, relate to or result from any use of this software by user.

THIS IS ALPHA QUALITY SOFTWARE FOR RESEARCH PURPOSES ONLY. THIS IS NOT A PRODUCT. YOU ARE RESPONSIBLE FOR COMPLYING WITH LOCAL LAWS AND REGULATIONS. NO WARRANTY EXPRESSED OR IMPLIED.