From a00fedde9d1fb50f096eb477194c12de26b321a7 Mon Sep 17 00:00:00 2001 From: Shane Smiskol Date: Tue, 22 Mar 2022 14:30:25 -0700 Subject: [PATCH] convert to 2 spaces --- docs/vehicles_template.vue | 578 ++++++++++++++++++------------------- 1 file changed, 289 insertions(+), 289 deletions(-) diff --git a/docs/vehicles_template.vue b/docs/vehicles_template.vue index fee457fa99..568fd71455 100644 --- a/docs/vehicles_template.vue +++ b/docs/vehicles_template.vue @@ -2,310 +2,310 @@
-
-
-

openpilot supports 150+ vehicles

-

A supported vehicle is one that just works when you install a comma device. Every car performs differently with openpilot, but all supported cars should provide a better experience than any stock system.

-
+
+
+

openpilot supports 150+ vehicles

+

A supported vehicle is one that just works when you install a comma device. Every car performs differently with openpilot, but all supported cars should provide a better experience than any stock system.

+
-
-

HOW WE RATE THE CARS

- -
-
- -

Gas & Brakes

-
-
-

openpilot Adaptive Cruise Control (ACC)

-
- {{Star.FULL.html_icon}} -

openpilot is able to control the gas and brakes.

-
-
- {{Star.HALF.html_icon}} -

openpilot is able to control the gas and brakes with some restrictions.

-
-
- {{Star.EMPTY.html_icon}} -

The gas and brakes are controlled by the car's stock Adaptive Cruise Control (ACC) system.

-
-
-
-

Stop and Go

-
- {{Star.FULL.html_icon}} -

Adaptive Cruise Control (ACC) operates down to 0 mph.

-
-
- {{Star.EMPTY.html_icon}} -

Adaptive Cruise Control (ACC) available only above certain speeds. See your car's manual for the minimum speed.

-
-
+
+

HOW WE RATE THE CARS

+ +
+
+ +

Gas & Brakes

+
+
+

openpilot Adaptive Cruise Control (ACC)

+
+ {{Star.FULL.html_icon}} +

openpilot is able to control the gas and brakes.

- -
-
- -

Steering

-
-
-

Steer to 0

-
- {{Star.FULL.html_icon}} -

openpilot can control the steering wheel down to 0 mph.

-
-
- {{Star.EMPTY.html_icon}} -

No steering control below certain speeds.

-
-
-
-

Steering Torque

-
- {{Star.FULL.html_icon}} -

Car has enough steering torque for comfortable highway driving.

-
-
- {{Star.EMPTY.html_icon}} -

Limited ability to make turns.

-
-
+
+ {{Star.HALF.html_icon}} +

openpilot is able to control the gas and brakes with some restrictions.

+
+
+ {{Star.EMPTY.html_icon}} +

The gas and brakes are controlled by the car's stock Adaptive Cruise Control (ACC) system.

+
+
+
+

Stop and Go

+
+ {{Star.FULL.html_icon}} +

Adaptive Cruise Control (ACC) operates down to 0 mph.

+
+
+ {{Star.EMPTY.html_icon}} +

Adaptive Cruise Control (ACC) available only above certain speeds. See your car's manual for the minimum speed.

+
+
-
-
- -

Support

-
-
-

Actively Maintained

-
- {{Star.FULL.html_icon}} -

Mainline software support, harness hardware sold by comma, lots of users, primary development target.

-
-
- {{Star.EMPTY.html_icon}} -

Low user count, community maintained, harness hardware not sold by comma.

-
-
-
+
+
+ +

Steering

+
+
+

Steer to 0

+
+ {{Star.FULL.html_icon}} +

openpilot can control the steering wheel down to 0 mph.

+
+
+ {{Star.EMPTY.html_icon}} +

No steering control below certain speeds.

+
+
+
+

Steering Torque

+
+ {{Star.FULL.html_icon}} +

Car has enough steering torque for comfortable highway driving.

+
+
+ {{Star.EMPTY.html_icon}} +

Limited ability to make turns.

+
+
+
+
+ +

Support

+
+
+

Actively Maintained

+
+ {{Star.FULL.html_icon}} +

Mainline software support, harness hardware sold by comma, lots of users, primary development target.

+
+
+ {{Star.EMPTY.html_icon}} +

Low user count, community maintained, harness hardware not sold by comma.

+
+
+
+ +
-
-
- {% set footnote_tag = '{}' %} - {% for tier, car_rows in tiers %} - -
- {{tier.name.title()}}
{{car_rows|length}} cars -

The best openpilot experience. Great highway driving and beyond.

-
- -
-
{{columns[0]}}
-
{{columns[1]}}
-
{{columns[2]}}
-
{{columns[3]}}
-
{{columns[4]}}
-
{{columns[5]}}
-
{{columns[6]}}
-
{{columns[7]}}
-
- - {% for row in car_rows %} -
-
{{row[0].text}}
-
{{row[1].text}}
-
{{row[2].text}}
- {% for star_col in row if star_col.star is not none %} -
{{star_col.star.html_icon}}{{footnote_tag.format(star_col.footnote) if star_col.footnote else ''}}
- {% endfor %} -
- {% endfor %} - - {% endfor %} -
- -
-
- {% for footnote in footnotes[:4] %} -

{{loop.index}}{{footnote}}

- {% endfor %} -
-
- {% for footnote in footnotes[4:] %} -

{{loop.index + 4}}{{footnote}}

- {% endfor %} -
+
+
+ {% set footnote_tag = '{}' %} + {% for tier, car_rows in tiers %} + +
+ {{tier.name.title()}}
{{car_rows|length}} cars +

The best openpilot experience. Great highway driving and beyond.

+
+ +
+
{{columns[0]}}
+
{{columns[1]}}
+
{{columns[2]}}
+
{{columns[3]}}
+
{{columns[4]}}
+
{{columns[5]}}
+
{{columns[6]}}
+
{{columns[7]}}
+
+ + {% for row in car_rows %} +
+
{{row[0].text}}
+
{{row[1].text}}
+
{{row[2].text}}
+ {% for star_col in row if star_col.star is not none %} +
{{star_col.star.html_icon}}{{footnote_tag.format(star_col.footnote) if star_col.footnote else ''}}
+ {% endfor %} +
+ {% endfor %} + + {% endfor %}
+ +
+
+ {% for footnote in footnotes[:4] %} +

{{loop.index}}{{footnote}}

+ {% endfor %} +
+
+ {% for footnote in footnotes[4:] %} +

{{loop.index + 4}}{{footnote}}

+ {% endfor %} +
+
-
- -

FREQUENTLY ASKED QUESTIONS

- -
-

comma openpilot is an open source driver-assistance system. Currently, openpilot performs the functions of Adaptive Cruise Control (ACC) and Automated Lane Centering (ALC) for compatible vehicles. It performs similarly to Tesla Autopilot and GM Super Cruise. openpilot can steer, accelerate, and brake automatically for other vehicles within its lane. Check it out on GitHub.

-

In order to enforce driver alertness, openpilot includes a camera based Driver Monitoring (DM) system that alerts the driver when distracted or asleep. However, even with an attentive driver, we must make further efforts for the system to be safe. We have designed openpilot with two other safety considerations:

-
    -
  1. The driver must always be capable to immediately retake manual control of the vehicle, by stepping on either pedal or by pressing the cancel button.
    2. -
  2. The vehicle must not alter its trajectory too quickly for the driver to safely react. This means that while the system is engaged, the actuators are constrained to operate within reasonable limits.
    3. -
-
- - -
-

openpilot works by taking the radar data integrated with supported car models and combining it with the camera built into comma hardware, to determine what acceleration, braking, and steering events are required.

-
- - -
-

After verifying that your car is compatible, we recommend purchasing a comma device in our shop. Don't forget to purchase a car harness to connect it to your vehicle. Add to cart, check out, and you’re good to go!

-
- - -
-

Yes, the driver must always be able to immediately retake manual control of the vehicle, by stepping on either pedal or by pressing the cancel button. When openpilot is engaged, a driver monitoring system actively tracks driver awareness to help prevent distractions. The openpilot system disengages if you are distracted. Drivers must keep their eyes on the road at all times and be ready to take control of the car.

-
- - -
-

openpilot Automated Lane Centering (ALC) system does not automatically drive the vehicle or reduce the amount of attention that must be paid to the area in front of the vehicle. The driver must always keep control of the steering wheel and be ready to correct the ALC system action at all times.

-

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

-
    -
  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions are interfering 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 device 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.

-
- - -
-

openpilot Adaptive Cruise Control (ACC) is not a system that allows 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, causing it to be unable to function as intended. These include, but are not limited to:

-
    -
  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions are interfering 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 device is mounted incorrectly.
    • -
  • Approaching a toll booth. 
    • -
  • 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 ultrasonic 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.

-
- - -
-

When openpilot is enabled in settings, Lane Keep Assist (LKAS), and Automated Lane Centering (ALC) are replaced by openpilot lateral control and only function when openpilot is engaged. Lane Departure Warning (LDW) works whether engaged or disengaged.

On certain cars, Adaptive Cruise Control (ACC) is replaced by openpilot longitudinal control.

openpilot preserves any other vehicle safety features, including, but are not limited to: AEB, auto high-beam, blind spot warning, and side collision warning.

-
- - -
-

openpilot does not currently support manual transmission cars. If you’d like to learn more, join us on Discord, where some of our members are supporting manual cars.

-
- - -
-

If your car is on the list of supported cars, openpilot will automatically recognize the model of your car by performing a scan of relevant ECU firmware versions present in your car. The presence of certain ECU firmware versions is an indication of the model year, car brand, car model, and trim.

-

If your car isn’t recognized as supported, your device will fall back to a dashcam only mode, preserving the stock functionalities and the user will receive a notification on the screen.

-
- - -
-

All software updates are received over-the-air (OTA). openpilot will automatically check for updates when connected to the internet. Your device will notify you on the screen when an update is available and prompt you to reboot the device to complete the update.

-

You may also manually check for update in the settings, under the "software" tab.

-
- - -
-

Supported speeds vary depending on the car. Please reference the supported car list for vehicle specific speed limitations. Maximum speed is the same as the maximum speed that stock ACC can be set to (car dependent) with a hard limit at ~84mph.

-
- - -
-

A fingerprint is the method openpilot uses to determine which vehicle it is connected to.

-

Current methods use vehicle ECU firmware logging. openpilot will fingerprint the vehicle on each start up.

-

If openpilot detects a firmware version not previously logged, it will need to be added to the codebase. Guides on adding new firmware can be found here.

-
- - -
-

The dongle ID of your device can be found in Settings of the device in the Device tab.

-
- - -
-

Feedback, good or bad, can be given in the #openpilot-experience channel on our community Discord.

-
-
+
+ +

FREQUENTLY ASKED QUESTIONS

+ +
+

comma openpilot is an open source driver-assistance system. Currently, openpilot performs the functions of Adaptive Cruise Control (ACC) and Automated Lane Centering (ALC) for compatible vehicles. It performs similarly to Tesla Autopilot and GM Super Cruise. openpilot can steer, accelerate, and brake automatically for other vehicles within its lane. Check it out on GitHub.

+

In order to enforce driver alertness, openpilot includes a camera based Driver Monitoring (DM) system that alerts the driver when distracted or asleep. However, even with an attentive driver, we must make further efforts for the system to be safe. We have designed openpilot with two other safety considerations:

+
    +
  1. The driver must always be capable to immediately retake manual control of the vehicle, by stepping on either pedal or by pressing the cancel button.
    2. +
  2. The vehicle must not alter its trajectory too quickly for the driver to safely react. This means that while the system is engaged, the actuators are constrained to operate within reasonable limits.
    3. +
+
+ + +
+

openpilot works by taking the radar data integrated with supported car models and combining it with the camera built into comma hardware, to determine what acceleration, braking, and steering events are required.

+
+ + +
+

After verifying that your car is compatible, we recommend purchasing a comma device in our shop. Don't forget to purchase a car harness to connect it to your vehicle. Add to cart, check out, and you’re good to go!

+
+ + +
+

Yes, the driver must always be able to immediately retake manual control of the vehicle, by stepping on either pedal or by pressing the cancel button. When openpilot is engaged, a driver monitoring system actively tracks driver awareness to help prevent distractions. The openpilot system disengages if you are distracted. Drivers must keep their eyes on the road at all times and be ready to take control of the car.

+
+ + +
+

openpilot Automated Lane Centering (ALC) system does not automatically drive the vehicle or reduce the amount of attention that must be paid to the area in front of the vehicle. The driver must always keep control of the steering wheel and be ready to correct the ALC system action at all times.

+

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

+
    +
  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions are interfering 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 device 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.

+
+ + +
+

openpilot Adaptive Cruise Control (ACC) is not a system that allows 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, causing it to be unable to function as intended. These include, but are not limited to:

+
    +
  • Poor visibility (heavy rain, snow, fog, etc.) or weather conditions are interfering 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 device is mounted incorrectly.
    • +
  • Approaching a toll booth. 
    • +
  • 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 ultrasonic 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.

+
+ + +
+

When openpilot is enabled in settings, Lane Keep Assist (LKAS), and Automated Lane Centering (ALC) are replaced by openpilot lateral control and only function when openpilot is engaged. Lane Departure Warning (LDW) works whether engaged or disengaged.

On certain cars, Adaptive Cruise Control (ACC) is replaced by openpilot longitudinal control.

openpilot preserves any other vehicle safety features, including, but are not limited to: AEB, auto high-beam, blind spot warning, and side collision warning.

+
+ + +
+

openpilot does not currently support manual transmission cars. If you’d like to learn more, join us on Discord, where some of our members are supporting manual cars.

+
+ + +
+

If your car is on the list of supported cars, openpilot will automatically recognize the model of your car by performing a scan of relevant ECU firmware versions present in your car. The presence of certain ECU firmware versions is an indication of the model year, car brand, car model, and trim.

+

If your car isn’t recognized as supported, your device will fall back to a dashcam only mode, preserving the stock functionalities and the user will receive a notification on the screen.

+
+ + +
+

All software updates are received over-the-air (OTA). openpilot will automatically check for updates when connected to the internet. Your device will notify you on the screen when an update is available and prompt you to reboot the device to complete the update.

+

You may also manually check for update in the settings, under the "software" tab.

+
+ + +
+

Supported speeds vary depending on the car. Please reference the supported car list for vehicle specific speed limitations. Maximum speed is the same as the maximum speed that stock ACC can be set to (car dependent) with a hard limit at ~84mph.

+
+ + +
+

A fingerprint is the method openpilot uses to determine which vehicle it is connected to.

+

Current methods use vehicle ECU firmware logging. openpilot will fingerprint the vehicle on each start up.

+

If openpilot detects a firmware version not previously logged, it will need to be added to the codebase. Guides on adding new firmware can be found here.

+
+ + +
+

The dongle ID of your device can be found in Settings of the device in the Device tab.

+
+ + +
+

Feedback, good or bad, can be given in the #openpilot-experience channel on our community Discord.

+
+
-
-
-
- Icon Frequently Asked Questions -

Join the conversation

-

Have a question or want to learn more? There are thousands of knowledgeable community members on the Discord; most car makes have a dedicated channel!

- Join our Discord -
-
- Icon GitHub -

Developer Resources

-

Check out the code behind openpilot and learn how to add support for your own car. Review, fork, and contribute to the open source ecosystem.

- Visit our GitHub -
+
+
+
+ Icon Frequently Asked Questions +

Join the conversation

+

Have a question or want to learn more? There are thousands of knowledgeable community members on the Discord; most car makes have a dedicated channel!

+ Join our Discord +
+
+ Icon GitHub +

Developer Resources

+

Check out the code behind openpilot and learn how to add support for your own car. Review, fork, and contribute to the open source ecosystem.

+ Visit our GitHub +
-
+
-
-
-
-

Try the comma three with our 30-day money back trial.

- Buy Now -
+
+
+
+

Try the comma three with our 30-day money back trial.

+ Buy Now +
-
-
+
+
@@ -314,29 +314,29 @@