From comma wiki
Revision as of 08:17, 5 December 2019 by Jyoung8607-2 (talk | contribs) (Convert pinouts to table form)

Jump to: navigation, search


Comma AI currently has no official support for Volkswagen brands, but a community port is available, with plans to upstream for official support in the near future. The community port is designed to support any Volkswagen MQB vehicle with ACC radar. Check the Vehicle Support section for details and caveats.

User Experience

Lateral Control

Lateral is provided by openpilot. All MQB vehicles tested to-date support steering down to 0mph. For vehicles with factory lane assist, it will be ignored when Panda is installed and filtering CAN traffic. The Lane Assist enable/disable checkbox in the instrument cluster or infotainment unit will still be present, but will not do anything.

Available steering torque is adequate for most highway driving conditions. All MQB models support the exact same amount of commanded torque, but the different steering rack and suspension geometry between models can result in different effective performance. For example, the Volkswagen Atlas with its high-static ratio steering has been tested to handle curves somewhat better than the Golf GTI or Golf R which have tighter-variable ratio steering suited to higher performance driving.

Longitudinal Control

Longitudinal control remains with stock ACC, although OP takes control of the engagement process for additional safety and feature needs. The minimum ACC setpoint is 20mph/30kph. Exact behavior depends on whether the vehicle has "ACC High" or "ACC Low" from the factory.

Stock ACC High: These vehicles support follow-to-stop and automatic resume if the stop is less than three seconds, from the factory. OP can improve on that by resuming on behalf of the driver after longer delays. "ACC high" requires an electronic parking brake, and does make use of it under certain conditions. If the vehicle in question has an EPB, chances are good it supports "ACC high".
Stock ACC Low: These vehicles generally support follow-to-stop (XXX review this: may be near-stop only) but will require the driver take over and hold the brake after a very short delay. Resume from stop is moot as "ACC low" vehicles will not hold themselves at a stop. Any vehicles with a manual parking brake, either foot or hand operated, will fall into this category.

Getting Started

Before You Start

Make sure your car is on the supported list, see below. If it's not, or you're in doubt, contact us on Discord in #volkswagen with questions.

What You Need

  • An EON DevKit to run openpilot. Highly recommended. No, you can't run this on a random smartphone, or a Raspberry Pi, or anything else. Yes, it's possible to make your own (a "frEON") but it's not nearly as simple as you might think. You need extremely specific phone hardware and additional parts, access to a 3D printer, and soldering skills. The vision model is extremely tightly coupled to hardware only found in two specific phone models. It's been discussed to death in the community, and further detail is outside the scope of the Volkswagen Wiki and channel.
  • A White Panda interface to connect EON to your car. It's cheap and will do what you need. Grey and Black Panda have a high-precision GPS which will be useful for future map-based features, so they're desirable if you're willing to spend more. However, Black Panda (the Car Harness) doesn't yet have a Volkswagen wiring adapter. Grey Panda works fine if you can get one, but it's been discontinued in favor of Black Panda.
  • A wiring harness to connect Panda to your car. Comma do not sell one at this time. You can make one yourself from the wiring diagram below, or purchase a community-made harness from @jyoung8607 on Discord.
    • @jyoung8607 personal comment: FYI I am not a Comma employee and do not represent Comma. I make these in my spare time for the community. I generally fabricate and ship them in less than a week after I receive payment, but that may vary. Contact me via DM on Comma's discord with questions or when you're ready to order.

Supported Vehicles

Fully Tested and Supported

These vehicles are confirmed supported by the community Volkswagen port, because they have been tested on at least one representative car in the wild.

The vehicle must have ACC (radar-based cruise control). For vehicles without factory Lane Assist, a diagnostic tool will be needed to make minor coding changes to the steering rack in order for OP to steer, and coding changes to the instrument cluster will be needed to receive feedback and status information.

  • 2012-2019 Mk3 Audi A3 (tested variants only) [Wiki]
    • A3
  • 2013-current Mk3 Škoda Octavia [Wiki]
  • 2018-2019 Mk1 Volkswagen Atlas (Teramont in some markets) [Wiki]
  • 2012-2019 Mk7 and Mk7.5 Volkswagen Golf (tested variants only) [Wiki]
    • Please note the MY changeover from Mk6 to Mk7 varied by market, USA did not get Golf 7 until MY 2014!
    • e-Golf (appears to support ACC High features even though factory build data shows ACC Low!)
    • Golf
    • Golf GTI
    • Golf R
  • 2015-current B8 Volkswagen Passat [Wiki]
    • This is NOT the Passat currently available in North America, which is based on the currently unsupported NMS platform

Supportable but Untested

These vehicle-classes should work fine with openpilot, to the best of our information, but have not yet been tested. Minor tweaks or other support may be needed. Be cautious if making an openpilot or vehicle purchase decision based on this information. If in doubt, ask on Discord.

  • All MQB vehicles not listed above, with ACC radar
    • 2018-current Mk2 Audi A1 (listed as MQB-A0, but confirmed to have factory ACC and LKAS options) [Wiki]
    • 2012-current Mk3 Audi A3 variants not explicitly tested so far [Wiki]
      • Audi S3
      • Audi RS3
    • 2014-current Mk3 Audi TT [Wiki]
    • 2017-current Mk1 Audi Q2 [Wiki]
    • 2018-current Mk2 Audi Q3 [Wiki]
    • 2016-current Mk1 SEAT Ateca [Wiki]
    • 2012-current Mk3 SEAT León [Wiki]
    • 2019-current Mk1 SEAT Tarraco [Wiki]
    • 2019-current Mk1 Škoda Kamiq [Wiki]
    • 2017-current Mk1 Škoda Karoq [Wiki]
    • 2017-current Mk1 Škoda Kodiaq [Wiki]
    • 2019-current Mk1 Škoda Scala [Wiki]
    • 2015-current B8 Škoda Superb [Wiki]
    • 2018-current Mk1 Volkswagen Arteon [Wiki]
    • 2018-current Mk4 Volkswagen Bora [Wiki]
    • 2013-2019 Volkswagen Golf variants not explicitly tested so far (Mk7 and Mk7.5) [Wiki]
      • Golf Alltrack
      • Golf GTD
      • Golf GTE
      • Golf GTI TCR
      • Golf Sportsvan / SV
      • Golf SportWagen
    • 2019-current Volkswagen Jetta (except GLI) and Sagitar (Mk7) [Wiki]
      • The GLI variant is architecturally compatible, but factory ACC appears unavailable (thanks for nothing VW)
    • 2015-current Mk1 Volkswagen Lamando [Wiki]
      • Made in China, limited info available, unable to fully verify
    • 2018-current Mk3 Volkswagen Lavida [Wiki]
      • Made in China, limited info available, unable to fully verify
    • 2018-current Mk6 Volkswagen Polo [Wiki]
    • 2019-current Mk1 Volkswagen T-Cross [Wiki]
    • 2018-current Mk1 Volkswagen Tayron [Wiki]
      • Made in China, limited info available, unable to fully verify
    • 2016-current Mk2 Volkswagen Tiguan [Wiki]
      • In North America, all 2016-2017 Tiguans and the 2018 Tiguan "Limited" are unsupported PQ46 Mk1; all other 2018 and all 2019-forward are MQB Mk2
    • 2018-current Mk1 Volkswagen Tharu / Tarek [Wiki]
      • Made in China, limited info available, unable to fully verify
    • 2015-current Mk2 Volkswagen Touran [Wiki]

Long Term Roadmap

We think these vehicles can be supported at some point, but they are not supported just yet. Code changes will be required. There are no firm dates for any of these items. If you have a vehicle in this section and are interested in testing with openpilot, please ask on Discord before proceeding.

  • Support has been tested for vehicles without a DSG/auto transmission, but owners should contact us on Discord for the moment as the changes have not yet been integrated into the main codebase. This includes manual transmission vehicles and the e-Golf.
  • Vision-only longitudinal control using visiond to drive known ACC messaging, for vehicles without radar
    • Radar data fusion might be possible later, if radar points are available on the sensor fusion bus, but this is not yet known
  • All PQ35/PQ46/NMS vehicles. We hope and plan to provide some level of support in the long-term future, but have nothing to announce just yet. Vehicles in this set may or may not be supportable. Most if not all should have electric power steering racks, but they may or may not have configurable support for Lane Assist commands. Some of these may not have ACC available or be compatible with retrofits. Do not purchase a vehicle based solely on this list.
  • All MLB and MLBevo vehicles (requires FlexRay support, VERY long term future)
    • 2018-current Volkswagen Touareg
    • All modern Audi not listed as MQB: A4, A5, A6, A7, A8, R8, Q5, Q7, Q8, e-Tron SUV and all variants thereof
  • All future MEB (new electric mass-market platform) vehicles, big question marks here until we see one, but we have cautious optimism.


These vehicles either don't have electric power steering, or we don't have a known control channel, or there is no factory option or ability to retrofit the necessary ACC and steering components. Support could be reexamined if new information comes to light, but at this time we have no plans to investigate further.

  • Volkswagen Touareg prior to 2018 (hydraulic power steering, lane departure warning only via steering wheel haptic)
  • Volkswagen Phaeton (hydraulic power steering, lane departure warning only via steering wheel haptic)
  • MQB-A0 supermini and city cars without factory options for ACC or LKAS. However, the MQB-A0 Audi A1 and VW Polo have optional ACC and LKAS, so other MQB-A0 vehicles may have some hope for retrofits.
    • 2017-current SEAT Arona [Wiki]
    • 2017-current SEAT Ibiza [Wiki]
  • NSF (New Small Family) supermini models without factory options for ACC or LKAS.
    • 2011-current SEAT Mii [Wiki]
    • 2011-current Škoda Citigo [Wiki]
    • 2011-current Volkswagen Up! [Wiki]


Vehicle Hardware

The radar and camera are standard Bosch hardware running software customized for VW MQB. The forward radar can be any of three: Bosch LRR3 (very old and uncommon), Bosch MRR1plus (older and common), or Bosch MRREvo14F (newer and common). The camera is Bosch's MPC1(?) monocular multipurpose camera.

Steering rack imposed limits for Heading Control Assist:

  • Cannot steer at a standstill, but appears to work at any nonzero speed
    • HCA goes to not ready and HCA torque is ignored if this is violated; recoverable without a restart
  • Commanded torque limit: 3.0 newton-meters
    • HCA goes to not ready and HCA torque is ignored if this is violated
  • Rate of change: 5.0 nm/seconds
    • Found in certain documentation, but not observed in real world, at least not as a steering-disabling fault
  • Continuous time limit for HCA to be engaged: 180 seconds
    • Documented at 300 seconds in some places, 180 in others, 180 observed in real world testing
    • HCA goes to not ready and HCA torque is ignored if this is violated; recoverable without a restart
    • Working around this by disabling steering for one frame for every zero crossing
  • Same/stuck torque input detection: 6 seconds
    • Not documented anywhere, but observed in real world testing
    • HCA goes to not ready and HCA torque is ignored if this is violated; recoverable without a restart
    • Working around this by introducing slight noise, 0.01nm reduction in torque for one frame 1x/second

Controller Area Network (CAN)


XXX TBD J533 concept

Critical Messages and Flows

XXX TBD detail around certain select messages read or sent by OP

  • LWI_01
  • EPS_01 / LH_EPS_03
  • ACC_06
  • Getribe_11
  • HCA_01
  • LDW_02

Integration at J533 Gateway

J533 gateway pinout:

T20/1  -- POWER     -- gr/ro terminal 30 power from 5a fuse SC5
T20/2  -- passthru  -- rt/vi terminal 30 power from 18a fuse SB18 (optional, w/o start/stop)
T20/3  -- passthru  -- vi/ws LIN bus to BEM 
T20/4  --           -- unused
T20/5  -- passthru  -- or/br Comfort CAN Low
T20/6  -- passthru  -- or/br Powertrain CAN Low
T20/7  -- PANDA 1/3 -- or/br Extended CAN Low
T20/8  -- passthru  -- or/br Suspension CAN Low
T20/9  -- passthru  -- or/br Diagnostic CAN Low / T16/14 on DLC
T20/10 -- passthru  -- or/br Infotainment CAN Low
T20/11 -- GROUND    -- br    Ground
T20/12 -- passthru  -- br    Ground
T20/13 -- passthru  -- vi/bl LIN bus to steering column electronics
T20/14 -- IGNITION  -- sw/vi terminal 15 power from PC3/A192
T20/15 -- passthru  -- or/gn Comfort CAN High
T20/16 -- passthru  -- or/sw Powertrain CAN High
T20/17 -- PANDA 1/3 -- or/gr Extended CAN High
T20/18 -- passthru  -- or/bl Suspension CAN High
T20/19 -- passthru  -- or/rt Diagnostic CAN High / T16/6 on DLC
T20/20 -- passthru  -- or/vi Infotainment CAN High

Gray or White Panda pinout:

Panda 1  -- unused
Panda 2  -- unused
Panda 3  -- unused
Panda 4  -- GROUND
Panda 5  -- unused
Panda 6  -- CAN1 Hi, toward gateway
Panda 7  -- unused
Panda 8  -- IGNITION
Panda 9  -- unused
Panda 10 -- unused
Panda 11 -- unused
Panda 12 -- CAN3 Hi, toward extended CAN, WITH termination resistor
Panda 13 -- CAN3 Lo, toward extended CAN, WITH termination resistor
Panda 14 -- CAN1 Lo, toward gateway
Panda 15 -- unused
Panda 16 -- POWER

XXX wiring diagram from @tmatheso

Integration at R242 Camera

Car Harness/Black Panda doesn't have an official harness connector in the Comma store yet, but it can be ordered with a development harness, and built by hand using the information below.


Retailer links are provided for example and convenience only, not as a referral or endorsement.

  • Connector Housings
    • Female connector housing 4F0-972-112, orderable from any VW group dealer parts department, or online: 1stVWParts ECS Tuning
    • Male connector housing 8Z0-972-112, orderable from any VW group dealer parts department, or online: 1stVWParts ECS Tuning
  • Terminals
    • AMP/TE female terminals 928999-1, orderable from Mouser in cut strips of 100: 571-928999-1-CT
    • AMP/TE male terminals 1-928918-1, orderable from Mouser in cut strips of 100: 571-1-928918-1-CT
  • Miscellaneous


Additional detail about the development harness:

In addition to the pin mapping shown below, CAN termination will need to be physically configured. The dev harness will ship with a single resistor loopback wire preinstalled between P3/P5, which configures 120 ohm termination on both CAN0 and CAN2. Volkswagen MQB should be configured for no extra termination on CAN0 and 60 ohm on CAN2. Do this by de-pinning the existing loopback between P3/P5 and reinstalling it between P23/P25.

Suggested work order:

  • De-pin the Dev Harness wires not used in this application, extra pass-through and constant +12V (which will come from Comma Power)
  • De-pin the CAN termination selector loop and relocate it as described above
  • Make all the pin and connector terminations described below
Factory Wiring Diagram for "T12ar" Connector
Pin Color mm2 Dia Description
1 or/br 0.35 Radar-camera sensor fusion, CAN low
2 or/br 0.35 Extended CAN, low
3 Unused
4 gr 0.5 Z113 heater/defogger pin 1, supply
5 br 0.35 R242 camera ground
6 sw/gn 0.35 12V from fuse SC32, ignition switched
7 or/ws 0.35 Radar-camera sensor fusion, CAN high
8 or/gr 0.35 Extended CAN High
9 unused
10 br 0.5 Z113 heater/defogger pin 2, ground
11 Unused
12 Unused
Mapping "T12ar" pins to the Dev Harness, Per-Side
Pin DH Color Description
1 Blue BP CAN 1, sensor fusion CAN low
2 Green BP CAN 0/2, extended CAN low
3 Unused
4 White Pass-through 2, camera heater supply
5 Black Ground
6 Brown Ignition switched power
7 Pink BP CAN 1, sensor fusion CAN high
8 Orange BP CAN 0/2, extended CAN high
9 Unused
10 Grey Pass-through 1, camera heater ground
11 Unused
12 Unused

Official Documentation

Volkswagen technical info can be found here: