Difference between revisions of "Main Page"

From comma wiki
Jump to: navigation, search
m (Forum was killed off.)
(Added 'Glossary of terminology' section based on contributions from @sbarne3 and myself.)
Line 51: Line 51:
 
Want to suggest a feature? Go to [https://github.com/commaai/openpilot/issues GitHub Issues Tracker] and make your suggestions.  
 
Want to suggest a feature? Go to [https://github.com/commaai/openpilot/issues GitHub Issues Tracker] and make your suggestions.  
  
−
(you must have at least 500 [[FAQ#commapoints|<span style="color:goldenrod">comma points</span>]] to edit this wiki)
+
== Glossary of terminology ==
 +
{| class="wikitable"
 +
! Term
 +
! Alternate Names
 +
! Links
 +
! Definition
 +
|- id="ACC"
 +
| Adaptive Cruise Control
 +
| ACC
 +
| [https://en.wikipedia.org/wiki/Adaptive_cruise_control wikipedia]
 +
| An available cruise control system for road vehicles that automatically adjusts the vehicle speed to maintain a safe distance from vehicles ahead. As of 2019, it also called by 20 unique names that describe that basic functionality. This is also known as Dynamic cruise control.
 +
|- id="Advance-angle"
 +
| Advance-Angle
 +
|
 +
| [https://discordapp.com/channels/469524606043160576/538741329799413760/615266067002032158 discord]
 +
| A control algorithm that uses the [[#EPS|EPS]] motor torque to calculate a much more accurate steering angle, similar to LQR.
 +
|- id="ADAS"
 +
| Advanced Driver-Assistance Systems
 +
| ADAS
 +
| [https://en.wikipedia.org/wiki/Advanced_driver-assistance_systems wikipedia]
 +
| Electronic systems that aid a vehicle driver while driving.
 +
|- id="ALCA"
 +
| Automatic Lane Change Assistance
 +
| ALCA
 +
|
 +
| Although implemented in some custom forks, considered a safety issue, and not endorsed by Comma.ai.
 +
|- id="AHB"
 +
| Automatic High Beams
 +
| AHB
 +
|
 +
| A safety system designed to help the driver have better visibility at night – while reducing glare for other drivers.
 +
|- id="Bosch"
 +
| Bosch
 +
|
 +
| [https://en.wikipedia.org/wiki/Robert_Bosch_GmbH#Mobility_Solutions wikipedia]
 +
| A manufacturer of auto parts used by [[#OEM|OEMs]]. In the context of OP it refers to a particular type of driver assistance hardware that is found in vehicles such as the 2017+ Honda CR-V.
 +
|- id="CAN"
 +
| Controller Area Network
 +
| CAN, CAN bus
 +
| [https://en.wikipedia.org/wiki/CAN_bus wikipedia]
 +
| A message-based protocol that provides a standardized way for [[#ECU|ECUs]] to communicate with each other.
 +
|- id="Chffr"
 +
| Chffr
 +
|
 +
|
 +
| A free app that turns your cell phone into a dashcam, discontinued mid-2019.
 +
|- id="Chffrplus"
 +
| Chffrplus
 +
|
 +
| [https://{{SERVERNAME}}/Running_ChffrPlus_on_the_EON guide]
 +
| Pre-installed app on the [[#EON|EON DevKit]] that turns the it into a dashcam.
 +
|- id="comma.ai"
 +
| Comma.ai
 +
|
 +
| [http://comma.ai website]
 +
| The company behind openpilot
 +
|- id="Comma Connect"
 +
| Comma Connect
 +
|
 +
|
 +
| A mobile app for [https://play.google.com/store/apps/details?id=ai.comma.connect&hl=en_US Android] and [https://apps.apple.com/us/app/comma-connect/id1456551889 iOS]
 +
|- id="Comma Pedal"
 +
| Comma Pedal
 +
|
 +
| [https://{{SERVERNAME}}/Comma_Pedal wikipedia]
 +
| A device that provides stop-and-go capability on cars that don't currently support it.  This device is not sold by Comma.ai (not officially supported by them), but supported in OpenPilot.
 +
|- id="Comma API"
 +
| Comma API
 +
|
 +
| [https://api.comma.ai/#comma-api-spec docs]
 +
|
 +
|- id="Comma Points"
 +
| Comma Points
 +
|
 +
| [https://{{SERVERNAME}}/FAQ#commapoints wikipedia]
 +
| Awarded for various activities you perform on the platform.
 +
|- id="Comma Power"
 +
| Comma Power
 +
|
 +
| [https://comma.ai/shop/products/power buy]
 +
| Use your car's [[#OBD2|OBD-II]] port to power your Toyota, Bosch, or FCA Giraffe
 +
|- id="Comma Prime"
 +
| Comma Prime
 +
| Prime
 +
| [https://comma.ai/shop/products/comma-prime-sim-card buy]
 +
| A subscription service from comma.ai offering a specific list of benefits.
 +
|- id="DRCC"
 +
| DRCC
 +
|
 +
| Dynamic Radar Cruise Control
 +
| A cruise control system that uses a front grille-mounted radar and a forward-facing camera that is designed to detect a vehicle in front of you and automatically adjust the vehicle's speed to help maintain a pre-set distance behind a vehicle ahead.
 +
|- id="ECU"
 +
| Electronic Control Unit
 +
| ECU
 +
| [https://en.wikipedia.org/wiki/Electronic_control_unit wikipedia]
 +
| Any embedded system in automotive electronics that controls one or more of the electrical systems or subsystems in a vehicle.
 +
|- id="EON"
 +
| EON DevKit
 +
| EON, EON Gold
 +
| [https://comma.ai/shop/products/eon-gold-dashcam-devkit buy] [https://{{SERVERNAME}}/Installing_EON install]
 +
| A smartphone running a customized version of Android and a custom case with additional cooling.  This device runs the OpenPilot software.
 +
|- id="EPS"
 +
| Electric Power Steering
 +
| EPS, EPAS
 +
| [https://en.wikipedia.org/wiki/Power_steering#Electric_systems wikipedia]
 +
| Uses an electric motor to assist the driver of a vehicle.  Sensors detect the position and torque of the steering column, and a computer module applies assistive torque via the motor, which connects to either the steering gear or steering column.
 +
|- id="fingerprint"
 +
| fingerprint
 +
|
 +
| [https://discordapp.com/channels/469524606043160576/524327905937850394/597941450407149599 discord] [https://{{SERVERNAME}}/Creating_Fingerprints creating]
 +
| A list of [[#CAN|CAN bus]] signals unique to a particular vehicle.  Allows OpenPilot to recognize which car it is connected to.
 +
|- id="firmware"
 +
| firmware
 +
|
 +
| [https://en.wikipedia.org/wiki/Firmware wikipedia]
 +
| Low-level software that runs directly on hardware such as the Panda.
 +
|- id="flashing"
 +
| flashing
 +
|
 +
| [https://en.wikipedia.org/wiki/Firmware#Flashing wikipedia]
 +
| A method of writing firmware to a hardware device.
 +
|- id="fork"
 +
| fork
 +
| custom fork
 +
| [https://en.wikipedia.org/wiki/Fork_(software_development) wikipedia]
 +
| In software engineering, a project fork happens when developers take a copy of source code from one software package and start independent development on it, creating a distinct and separate piece of software.
 +
|- id="OpenFrEON"
 +
| FrEON
 +
| OpenFrEON
 +
| [https://github.com/ch4se/OpenFrEON github]
 +
| "Free EON"... an open source variant of the EON case. The repository contains files that can be used for 3D printing a case. Developed by @Chase#7213
 +
|- id="giraffe"
 +
| Giraffe connector
 +
| Giraffe
 +
| [https://comma.ai/shop/products/giraffe buy] [https://{{SERVERNAME}}/Installing_Giraffe install]
 +
| An adapter board that lets you read buses that aren't exposed on the main OBD-II connector, with variants for different vehicle makes/models.
 +
|- id="GMLAN"
 +
| General Motors Local Area Network
 +
| GMLAN
 +
| [https://en.wikipedia.org/wiki/General_Motors_Local_Area_Network wikipedia]
 +
| A superset of [[#CAN|CAN Bus]] bus developed by General Motors.
 +
|- id="heatsink"
 +
| heat sink
 +
| heatsink
 +
| [https://en.wikipedia.org/wiki/Heat_sink wikipedia]
 +
| A passive cooling device.
 +
|- id="hugging"
 +
| hugging
 +
|
 +
|
 +
| An undesired behavior where the vehicle drives too closely to one side of the lane.
 +
|- id="INDI"
 +
| INDI
 +
|
 +
|
 +
| A control algorithm like PIF, PID, and LQR.
 +
|- id="LDA"
 +
| Lane Departure Alert
 +
| LDA
 +
|
 +
| Uses an in-vehicle camera to detect lane departure when traveling on relatively straight roads with clear lane markings, and only alerts the driver.
 +
|- id="LePro"
 +
| LeEco Le Pro 3
 +
| Lepro, LeEco, x727
 +
| [https://www.gsmarena.com/leeco_le_pro3-8344.php specs]
 +
| The current phone used in the EON. Specifically the x727 model
 +
|- id="LiveParameters"
 +
| LiveParameters
 +
|
 +
|
 +
| A continually updated file (ie. "Live")that stores learned calibration data for the vehicle.
 +
|- id="LKAS"
 +
| Lane Keeping Assist
 +
| LKAS
 +
| [https://en.wikipedia.org/wiki/Lane_departure_warning_system#Lane_keeping wikipedia]
 +
| Technology that automatically takes steps to ensure the vehicle stays in its lane.
 +
|- id="LQR"
 +
| LQR
 +
|
 +
|
 +
| A control algorithm like INDI, PIF, and PID.
 +
|- id="model"
 +
| Machine learning model
 +
| model
 +
| [https://en.wikipedia.org/wiki/Machine_learning wikipedia]
 +
|
 +
|- id="Nidec"
 +
| Nidec
 +
|
 +
|
 +
| A manufacturer of auto parts used by [[#OEM|OEMs]].  In the context of OP it refers to a particular type of driver assistance hardware that is found in vehicles such as the 2016+ Honda Pilot.
 +
|- id="obd2"
 +
| OBD-II
 +
|
 +
| [https://en.wikipedia.org/wiki/On-board_diagnostics#OBD-II wikipedia]
 +
| On-Board Diagnostics Connector
 +
|- id="OEM"
 +
| Original Equipment Manufacturer
 +
| OEM
 +
| [https://en.wikipedia.org/wiki/Original_equipment_manufacturer#Automotive_parts wikipedia]
 +
| When referring to auto parts, OEM refers to the manufacturer of the original equipment, that is, the parts assembled and installed during the construction of a new vehicle.
 +
|- id="OP3T"
 +
| OnePlus 3T
 +
| OP3T
 +
| [https://en.wikipedia.org/wiki/OnePlus_3T wikipedia][https://www.gsmarena.com/oneplus_3t-8416.php specs]
 +
| The phone used in the previous generation EON.  It was discontinued due to a lack of supply. [https://forums.oneplus.com/threads/a3000-or-a3010-in-the-u-s.530600/] Known model numbers: A3000(US version) A3010(Asian version)
 +
|- id="openpilot"
 +
| OpenPilot
 +
| OP
 +
| [https://en.wikipedia.org/wiki/Openpilot wikipedia]
 +
|
 +
|- id="OSM"
 +
| OpenStreetMap
 +
| OSM
 +
| [https://en.wikipedia.org/wiki/OpenStreetMap wikipedia]
 +
| An open-source project who's aim is to create a free editable map of the world.
 +
|- id="OSS"
 +
| Open-source software
 +
| OSS
 +
| [https://en.wikipedia.org/wiki/Open-source_software wikipedia]
 +
| A type of computer software in which source code is released under a license in which the copyright holder grants users the rights to study, change, and distribute the software to anyone and for any purpose.
 +
|- id="panda"
 +
| Panda OBD-II Interface
 +
| Panda
 +
| [https://comma.ai/shop/products/panda-obd-ii-dongle buy]
 +
| A CAN-Bus to USB adapter.  Available in 2 variants: white (incl. WiFi) / grey (incl. high precision GPS).
 +
|- id="paw"
 +
| Panda Paw
 +
| Paw
 +
| [https://comma.ai/shop/products/panda-paw buy]
 +
| A device to help you unbrick a panda.
 +
|- id="PID"
 +
| PID
 +
|
 +
| [https://en.wikipedia.org/wiki/PID_controller wikipedia]
 +
| A control algorithm like INDI, LQR, and PIF.
 +
|- id="PIF"
 +
| PIF
 +
|
 +
|
 +
| A control algorithm like INDI, LQR, and PID... where 'F' refers to 'FeedForward'.
 +
|- id="ping pong"
 +
| ping pong
 +
| ping ponging
 +
|
 +
| An undesired behavior where the vehicle sways from one side of the lane to the other repeatedly.  The desired behavior is to stay in the center of the lane.
 +
|- id="PCS"
 +
| Pre-Collision System
 +
| PCS
 +
|
 +
| Uses an integrated forward-facing camera and grille mounted radar system designed to help mitigate or avoid a potential collision with another vehicle or pedestrian.
 +
|- id="proxy panda"
 +
| Proxy Panda
 +
|
 +
|
 +
|
 +
|- id="SnG"
 +
| Stop-and-Go
 +
| SnG
 +
|
 +
|
 +
|- id="SNPE"
 +
| Snapdragon Neural Processing Engine
 +
| SNPE
 +
| [https://developer.qualcomm.com/software/qualcomm-neural-processing-sdk dev info]
 +
| A Qualcomm Snapdragon software accelerated runtime for the execution of deep neural networks.
 +
|- id="STL file"
 +
| STL file
 +
|
 +
| [https://en.wikipedia.org/wiki/STL_(file_format)#Use_in_3D_printing wikipedia]
 +
| A file that describes a 3D object.  In the case of OP, these kind of files are used when 3D printing the [[#OpenFrEON|FrEON]] case, mounts, etc.
 +
|- id="TF"
 +
| TensorFlow
 +
| TF
 +
| [https://en.wikipedia.org/wiki/TensorFlow wikipedia]
 +
| An open-source machine learning library
 +
|- id="TSS2"
 +
| Toyota Safety Sense 2
 +
| TSS-2
 +
| [https://www.toyota.com/content/ebrochure/CFA_TSS_2.pdf info]
 +
| TSS 2.0 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.
 +
|- id="TSS-P"
 +
| Toyota Safety Sense C
 +
| TSS-C
 +
| [https://www.toyota.com/content/ebrochure/CFA_TSS_C.pdf info]
 +
| An advanced active safety package for compact vehicles, and consists of six active safety and driver assistance systems: PCS, DRCC, LDA, and AHB.
 +
|- id="TSS-P"
 +
| Toyota Safety Sense P
 +
| TSS-P
 +
| [https://www.toyota.com/content/ebrochure/CFA_TSS_P.pdf info]
 +
| 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.
 +
|- id="ZSS"
 +
| Zorro Steering Sensor
 +
| ZSS
 +
| [https://github.com/zorrobyte/betterToyotaAngleSensorForOP github]
 +
| A DIY angle sensor to replace the inferior one used in TSS-P Toyotas (notably problematic with Prius and Prius Prime)
 +
|}
 +
 
 +
(You must have at least 500 [[FAQ#commapoints|<span style="color:goldenrod">comma points</span>]] to edit this wiki.)

Revision as of 17:54, 27 August 2019

Quick Start

If you are looking to get your EON up and running see the following guides

Vehicles

Troubleshooting

If you are having any issues with Chffr, Panda, or Neo please refer to the links below

Development

Community

Comma has a vibrant community working on new ports and features for Comma.

Check out the Discord server.

Community initiatives

The Openpilot Community

It is a community supported initiative with a special database website located at https://opc.ai/ which features an up-to-date list of compatible vehicles, as well as vehicles that the community is working on porting. The website also includes Guides, Videos, and detailed information about each vehicle year make and model.

You may also want to subscribe to their subreddit: r/openpilotcommunity

Feedback/Feature requests

openpilot did something wrong or unexpected? Report the event in the openpilot Events.

Want to suggest a feature? Go to GitHub Issues Tracker and make your suggestions.

Glossary of terminology

Term Alternate Names Links Definition
Adaptive Cruise Control ACC wikipedia An available cruise control system for road vehicles that automatically adjusts the vehicle speed to maintain a safe distance from vehicles ahead. As of 2019, it also called by 20 unique names that describe that basic functionality. This is also known as Dynamic cruise control.
Advance-Angle discord A control algorithm that uses the EPS motor torque to calculate a much more accurate steering angle, similar to LQR.
Advanced Driver-Assistance Systems ADAS wikipedia Electronic systems that aid a vehicle driver while driving.
Automatic Lane Change Assistance ALCA Although implemented in some custom forks, considered a safety issue, and not endorsed by Comma.ai.
Automatic High Beams AHB A safety system designed to help the driver have better visibility at night – while reducing glare for other drivers.
Bosch wikipedia A manufacturer of auto parts used by OEMs. In the context of OP it refers to a particular type of driver assistance hardware that is found in vehicles such as the 2017+ Honda CR-V.
Controller Area Network CAN, CAN bus wikipedia A message-based protocol that provides a standardized way for ECUs to communicate with each other.
Chffr A free app that turns your cell phone into a dashcam, discontinued mid-2019.
Chffrplus guide Pre-installed app on the EON DevKit that turns the it into a dashcam.
Comma.ai website The company behind openpilot
Comma Connect A mobile app for Android and iOS
Comma Pedal wikipedia A device that provides stop-and-go capability on cars that don't currently support it. This device is not sold by Comma.ai (not officially supported by them), but supported in OpenPilot.
Comma API docs
Comma Points wikipedia Awarded for various activities you perform on the platform.
Comma Power buy Use your car's OBD-II port to power your Toyota, Bosch, or FCA Giraffe
Comma Prime Prime buy A subscription service from comma.ai offering a specific list of benefits.
DRCC Dynamic Radar Cruise Control A cruise control system that uses a front grille-mounted radar and a forward-facing camera that is designed to detect a vehicle in front of you and automatically adjust the vehicle's speed to help maintain a pre-set distance behind a vehicle ahead.
Electronic Control Unit ECU wikipedia Any embedded system in automotive electronics that controls one or more of the electrical systems or subsystems in a vehicle.
EON DevKit EON, EON Gold buy install A smartphone running a customized version of Android and a custom case with additional cooling. This device runs the OpenPilot software.
Electric Power Steering EPS, EPAS wikipedia Uses an electric motor to assist the driver of a vehicle. Sensors detect the position and torque of the steering column, and a computer module applies assistive torque via the motor, which connects to either the steering gear or steering column.
fingerprint discord creating A list of CAN bus signals unique to a particular vehicle. Allows OpenPilot to recognize which car it is connected to.
firmware wikipedia Low-level software that runs directly on hardware such as the Panda.
flashing wikipedia A method of writing firmware to a hardware device.
fork custom fork wikipedia In software engineering, a project fork happens when developers take a copy of source code from one software package and start independent development on it, creating a distinct and separate piece of software.
FrEON OpenFrEON github "Free EON"... an open source variant of the EON case. The repository contains files that can be used for 3D printing a case. Developed by @Chase#7213
Giraffe connector Giraffe buy install An adapter board that lets you read buses that aren't exposed on the main OBD-II connector, with variants for different vehicle makes/models.
General Motors Local Area Network GMLAN wikipedia A superset of CAN Bus bus developed by General Motors.
heat sink heatsink wikipedia A passive cooling device.
hugging An undesired behavior where the vehicle drives too closely to one side of the lane.
INDI A control algorithm like PIF, PID, and LQR.
Lane Departure Alert LDA Uses an in-vehicle camera to detect lane departure when traveling on relatively straight roads with clear lane markings, and only alerts the driver.
LeEco Le Pro 3 Lepro, LeEco, x727 specs The current phone used in the EON. Specifically the x727 model
LiveParameters A continually updated file (ie. "Live")that stores learned calibration data for the vehicle.
Lane Keeping Assist LKAS wikipedia Technology that automatically takes steps to ensure the vehicle stays in its lane.
LQR A control algorithm like INDI, PIF, and PID.
Machine learning model model wikipedia
Nidec A manufacturer of auto parts used by OEMs. In the context of OP it refers to a particular type of driver assistance hardware that is found in vehicles such as the 2016+ Honda Pilot.
OBD-II wikipedia On-Board Diagnostics Connector
Original Equipment Manufacturer OEM wikipedia When referring to auto parts, OEM refers to the manufacturer of the original equipment, that is, the parts assembled and installed during the construction of a new vehicle.
OnePlus 3T OP3T wikipediaspecs The phone used in the previous generation EON. It was discontinued due to a lack of supply. [1] Known model numbers: A3000(US version) A3010(Asian version)
OpenPilot OP wikipedia
OpenStreetMap OSM wikipedia An open-source project who's aim is to create a free editable map of the world.
Open-source software OSS wikipedia A type of computer software in which source code is released under a license in which the copyright holder grants users the rights to study, change, and distribute the software to anyone and for any purpose.
Panda OBD-II Interface Panda buy A CAN-Bus to USB adapter. Available in 2 variants: white (incl. WiFi) / grey (incl. high precision GPS).
Panda Paw Paw buy A device to help you unbrick a panda.
PID wikipedia A control algorithm like INDI, LQR, and PIF.
PIF A control algorithm like INDI, LQR, and PID... where 'F' refers to 'FeedForward'.
ping pong ping ponging An undesired behavior where the vehicle sways from one side of the lane to the other repeatedly. The desired behavior is to stay in the center of the lane.
Pre-Collision System PCS Uses an integrated forward-facing camera and grille mounted radar system designed to help mitigate or avoid a potential collision with another vehicle or pedestrian.
Proxy Panda
Stop-and-Go SnG
Snapdragon Neural Processing Engine SNPE dev info A Qualcomm Snapdragon software accelerated runtime for the execution of deep neural networks.
STL file wikipedia A file that describes a 3D object. In the case of OP, these kind of files are used when 3D printing the FrEON case, mounts, etc.
TensorFlow TF wikipedia An open-source machine learning library
Toyota Safety Sense 2 TSS-2 info TSS 2.0 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.
Toyota Safety Sense C TSS-C info An advanced active safety package for compact vehicles, and consists of six active safety and driver assistance systems: PCS, DRCC, LDA, and AHB.
Toyota Safety Sense P TSS-P info 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.
Zorro Steering Sensor ZSS github A DIY angle sensor to replace the inferior one used in TSS-P Toyotas (notably problematic with Prius and Prius Prime)

(You must have at least 500 comma points to edit this wiki.)

Retrieved from "https://community.comma.ai/wiki/index.php?title=Main_Page&oldid=1508"