* This software. It's free and available right here.
* A supported device to run this software: a [comma three](https://comma.ai/shop/products/three).
* This software. The setup procedure of the comma three allows the user to enter a url for custom software.
The url, openpilot.comma.ai will install the release version of openpilot. To install openpilot master, you can use installer.comma.ai/commaai/master, and replacing commaai with another github username can install a fork.
* One of [the 150+ supported cars](docs/CARS.md). We support Honda, Toyota, Hyundai, Nissan, Kia, Chrysler, Lexus, Acura, Audi, VW, and more. If your car is not supported, but has adaptive cruise control and lane keeping assist, it's likely able to run openpilot.
* A supported device to run this software: a [comma three](https://comma.ai/shop/products/three), or if you like to experiment, a [Ubuntu computer with webcams](https://github.com/commaai/openpilot/tree/master/tools/webcam).
* A way to connect to your car. With a comma three, you need only a [car harness](https://comma.ai/shop/products/car-harness). With a PC, you also need a [black panda](https://comma.ai/shop/products/panda).
* A [car harness](https://comma.ai/shop/products/car-harness) to connect to your car.
We have detailed instructions for [how to install the device in a car](https://comma.ai/setup).
We have detailed instructions for [how to mount the device in a car](https://comma.ai/setup).
Running on PC
------
@ -55,6 +56,7 @@ With openpilot's tools you can plot logs, replay drives and watch the full-res c
You can also run openpilot in simulation [with the CARLA simulator](tools/sim/README.md). This allows openpilot to drive around a virtual car on your Ubuntu machine. The whole setup should only take a few minutes, but does require a decent GPU.
A PC running openpilot can also control your vehicle if it is connected to a [a webcam](https://github.com/commaai/openpilot/tree/master/tools/webcam), a [black panda](https://comma.ai/shop/products/panda), and [a harness](https://comma.ai/shop/products/car-harness).
|Make|Model|Supported Package|openpilot ACC|Stop and Go|Steer to 0|Steering Torque|Actively Maintained|
|---|---|---|:---:|:---:|:---:|:---:|:---:|
|Audi|A3 2014-19|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|A3 Sportback e-tron 2017-18|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|Q2 2018|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|RS3 2018|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|S3 2015-17|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Toyota|Prius Prime 2017-20|All|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>3</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Volkswagen|Golf R 2016-19|Driver Assistance|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|A3 2014-19|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|A3 Sportback e-tron 2017-18|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|Q3 2020-21|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|RS3 2018|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|S3 2015-17|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Audi|Q3 2020-21|ACC + Lane Assist|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Hyundai|Ioniq Electric 2019|SCC + LKAS|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Toyota|Prius Prime 2017-20|All|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>3</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>5</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Toyota|Prius v 2017|TSS-P|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>3</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>5</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Volkswagen|Golf R 2016-19|Driver Assistance|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Volkswagen|Jetta GLI 2021|Driver Assistance|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Toyota|Prius v 2017|TSS-P|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>[<sup>3</sup>](#footnotes)|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
|Volkswagen|Jetta GLI 2021|Driver Assistance|<ahref="##"><imgvalign="top"src="assets/icon-star-empty.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-half.svg"width="22"/></a>|<ahref="##"><imgvalign="top"src="assets/icon-star-full.svg"width="22"/></a>|
<sup>2</sup>2019 Honda Civic 1.6L Diesel Sedan does not have ALC below 12mph. <br/>
<sup>3</sup>When disconnecting the Driver Support Unit (DSU), openpilot Adaptive Cruise Control (ACC) will replace stock Adaptive Cruise Control (ACC). <b><i> NOTE: disconnecting the DSU disables Automatic Emergency Braking (AEB).</i></b><br/>
<sup>4</sup>28mph for Camry 4CYL L, 4CYL LE and 4CYL SE which don't have Full-Speed Range Dynamic Radar Cruise Control. <br/>
<sup>5</sup>An inaccurate steering wheel angle sensor makes precise control difficult. <br/>
<sup>6</sup>Not including the China market Kamiq, which is based on the (currently) unsupported PQ34 platform. <br/>
<sup>7</sup>Not including the USA/China market Passat, which is based on the (currently) unsupported PQ35/NMS platform. <br/>
<sup>8</sup>Model-years 2021 and beyond may have a new camera harness design, which isn't yet available from the comma store. Before ordering, remove the Lane Assist camera cover and check to see if the connector is black (older design) or light brown (newer design). For the newer design, in the interim, choose "VW J533 Development" from the vehicle drop-down for a harness that integrates at the CAN gateway inside the dashboard. <br/>
<sup>5</sup>Not including the China market Kamiq, which is based on the (currently) unsupported PQ34 platform. <br/>
<sup>6</sup>Not including the USA/China market Passat, which is based on the (currently) unsupported PQ35/NMS platform. <br/>
<sup>7</sup>Model-years 2021 and beyond may have a new camera harness design, which isn't yet available from the comma store. Before ordering, remove the Lane Assist camera cover and check to see if the connector is black (older design) or light brown (newer design). For the newer design, in the interim, choose "VW J533 Development" from the vehicle drop-down for a harness that integrates at the CAN gateway inside the dashboard. <br/>
## Community Maintained Cars
Although they're not upstream, the community has openpilot running on other makes and models. See the 'Community Supported Models' section of each make [on our wiki](https://wiki.comma.ai/).
@ -14,31 +14,19 @@ Cars are organized into three tiers:
How We Rate The Cars
---
### openpilot Adaptive Cruise Control (ACC)
- {{star_icon.format(Star.FULL.value)}} - openpilot is able to control the gas and brakes.
- {{star_icon.format(Star.HALF.value)}} - openpilot is able to control the gas and brakes with some restrictions.
- {{star_icon.format(Star.EMPTY.value)}} - The gas and brakes are controlled by the car's stock Adaptive Cruise Control (ACC) system.
### Stop and Go
- {{star_icon.format(Star.FULL.value)}} - Adaptive Cruise Control (ACC) operates down to 0 mph.
- {{star_icon.format(Star.EMPTY.value)}} - Adaptive Cruise Control (ACC) available only above certain speeds. See your car's manual for the minimum speed.
### Steer to 0
- {{star_icon.format(Star.FULL.value)}} - openpilot can control the steering wheel down to 0 mph.
- {{star_icon.format(Star.EMPTY.value)}} - No steering control below certain speeds.
### Steering Torque
- {{star_icon.format(Star.FULL.value)}} - Car has enough steering torque for comfortable highway driving.
- {{star_icon.format(Star.EMPTY.value)}} - Limited ability to make turns.
### Actively Maintained
- {{star_icon.format(Star.FULL.value)}} - Mainline software support, harness hardware sold by comma, lots of users, primary development target.
- {{star_icon.format(Star.EMPTY.value)}} - Low user count, community maintained, harness hardware not sold by comma.
{% for star_row in star_descriptions.values() %}
{% for name, stars in star_row.items() %}
### {{name}}
{% for star, description in stars %}
- {{star_icon.format(star)}} - {{description}}
{% endfor %}
{% endfor %}
{% endfor %}
**All supported cars can move between the tiers as support changes.**