Toyota Lexus - commaai/openpilot GitHub Wiki
- Table of Contents
- Supported Toyota/Lexus Vehicles
- Toyota/Lexus Terms
- openpilot Capabilities
- Community Features
- Common Toyota/Lexus Questions:
- Links:
The most up-to-date list of supported vehicles is on the openpilot main page. Please take careful note of the following columns and pay attention to and read any footnotes:
- Supported Package - Mandatory trim levels or options required for openpilot to work, if any. All means all versions of this model work.
-
ACC - What is in charge of longitudinal control. This can be either Stock (your vehicle's cruise control system) or openpilot.
- Footnote 3 applies to a number of Toyota vehicles. See discussion of Disconnecting DSU.
-
No ACC accel below - Cruise control will not work below these speeds. 0 mph means that the vehicle is capable of stop-and-go driving.
- Footnote 1, see the comma pedal.
- For footnote 4 see openpilot Camry Support.
- No ALC below - No lateral control, this doesn't apply to any supported Toyota/Lexus vehicles currently.
Toyota Camry / Camry Hybrid 2018-20 can only use Stock adaptive cruise control due to having the radar directly control gas and brakes, with no external DSU to unplug. (unplugging the radar = no radar tracks and no ACC)
For 2018-2020 Camry models which don't have Full-Speed Range Dynamic Radar Cruise Control openpilot will not function below 25mph this includes the 4CYL L, 4CYL LE and 4CYL SE non-hybrid models. There is no current solution for this, these vehicles cannot use a comma pedal to solve this issue. This is because these models use a Continental radar not used on other vehicles and messages from the radar cut out completely below 25mph.
This limitation does not apply to Camry models with Full-Speed Range Dynamic Radar Cruise Control including the (2018-2020 XLE, XSE, LE HV, XLE HV, and SE HV)
Please see https://github.com/optskug/docs
The following terms are specific to Toyota and Lexus vehicles and are often used in discussions.
For general terms, go here.
| Term | Abbreviation | Definition |
|---|---|---|
| Toyota Safety Sense 2.0 | TSS2 TSS 2.0 | TSS2 builds on the previous TSS-C and TSS-P suites, and consists of six active safety and driver assistance systems: PCS, DRCC, LDA, AHB, RSA, and LTA. It has a better angle sensor, and supports full range ACC on all openpilot compatible models. |
| Toyota Safety Sense P | TSSP TSS-P | An advanced active safety package for mid-size and large vehicles, and consists of six active safety and driver assistance systems: PCS, LDA, and AHB. Includes a DSU which does ACC and AEB. |
| Toyota Safety Sense C | TSSC TSS-C | An advanced active safety package for compact vehicles, and consists of six active safety and driver assistance systems: PCS, DRCC, LDA, and AHB. It does not feature lane keep assist, thus is not compatible with openpilot. |
| Term | Abbreviation | Definition |
|---|---|---|
| Driver Support Unit | DSU | This embedded system implements cruise control and Automatic Emergency Braking in some Toyota cars. |
| Pre-Collision System | PCS | May also include pedestrian detection and be written as PCS w/PD. This is the main AEB feature. |
| Dynamic Radar Cruise Control | DRCC | This is ACC, and may be full speed depending on the model |
| Lane Departure Alert | LDA | The audible alert when leaving a lane. May also include Steering Assist and be listed as LDA w/SA |
| Auto High Beams | AHB | Pretty straight forward. |
| Road Sign Assist | RSA* | The thing that displays speed limit and stop signs on your dash. |
| Lane Tracing Assist | LTA | The stock feature that enables lane centering or lane keeping while using DRCC |
- RSA Is not available on Canadian sold TSS2.0 or TSS2.5+ Models.
Control over the steering wheel. openpilot handles lateral control for all supported Toyota/Lexus vehicles. However, some TSSP vehicles may have jerky non-precise steering as noted in Steering Sensor.
Toyotas have very good torque, and work well on local and highway roads.
TSS2 Toyotas have a great angle sensor, as well as select 2019+ TSSP Toyotas. Most TSSP Toyotas have a bad angle sensor. This results in jerky, non-precise steering. The worst culprit of this is the Prius. This can be fixed on some models with a ZSS.
As noted in the comma.ai FAQ, openpilot replaces the LDA and LTA features on Toyota and Lexus vehicles when openpilot is enabled. LDA alerts will originate from openpilot when openpilot is enabled, even when the cruise control feature is not enabled. You can disable LDA warnings inside the openpilot settings. Sadly, if your vehicle is equiped with LDA w/SA, openpilot does not currently emulate the Steering Assist function when the cruise control is disabled.
Control over the gas and brakes.
openpilot handles longitudinal control for these vehicles without any additional modifications. AEB and blindspot warning will continue to function as they did on the original vehicle. There is no option on these vehicles to use Stock ACC while using openpilot.
The Driver Support Unit is what controls AEB and longitudinal on TSSP cars. This unit must be unplugged to give openpilot control, although this removes AEB. Users are strongly discouraged from disconnecting their DSU and abandoning AEB. Instead, a SDSU solves this problem, by passing through the correct AEB messages while allowing openpilot to control longitudinal.
TSSP vehicle owners have the benefit of choosing to use openpilot or stock ACC, this is not an option for TSS2 vehicle owners. SmartenedDSU owners may also have the option to switch between stock and openpilot for each drive.
It is possible to enable OP stop-and-go in TSSP vehicles with a non-zero value for "no ACC accel below" on the official supported cars list with an SDSU and comma pedal. Some models may have luck with only an SDSU and the 2-line "SnG hack". See the discord for more information.
Both systems work well and there are numerous people who prefer one system over the other. Generally, the stock ACC is slower to accelerate from a stop and will keep a larger following distance as low speed. openpilot on the other hand accelerates more aggressively and maintains a closer distance at low speeds but a larger distance as high (freeway) speeds. Some hybrid owners prefer the stock system because its gentler acceleration profile means less use of the internal combustion engine in traffic.
A comma pedal allows Toyotas without full-range cruise control to gain stop-and-go using openpilot with a device plugged into the gas pedal.
Upgrades the Driver Support Unit to passthrough AEB and enable openpilot longitudinal control. SDSU was first sold as an external, harness-style contraption, and later the SmartenedDSU (DSU modified by forwarding a severed CAN connection back into the network by way of an onboard, stripped down, reflashed panda) and became preferred, with quick creation/installation.
Upgrades TSSP cars with a better angle sensor which allows more accurate steering with openpilot.
Although not officially supported, a very small change is required to get openpilot functioning with a Toyota manual transmission. All that is necessary (other than fingerprinting) is to change LOW_SPEED_LOCKOUT in /selfdrive/car/toyota/carstate.py from 2 to False, like in this commit.
This video describes how it operates. TL;DR in gears > 1st, and at > ~18mph. Below that, everything disengages (unless using sunnypilot, only ACC disengages).
This has been tested in TSS2 Corolla Hatchbacks from 2019 to 2022.
A couple of helpful links. You can lookup you vehicle details using your VIN on the Toyota Vehicle Information Lookup. You can also review this handy TSS Applicability Chart
- 2010-2015 Prius wiring drawing
- Toyota Wiring Harnesses
