Skip to content
Cameron Clough edited this page Sep 24, 2022 · 66 revisions
Clone this wiki locally

FAQ

◄ Home

Table of Contents

openpilot

How do I report a bug?

Search Discord and this wiki to confirm anomalous behavior. Find the segment of interest in explorer, then click the lower right Copy Current Segment. Go to #bug-reports and share the segment with a description of the issue.

What is lateral control?

In openpilot, lateral control means that openpilot can control your steering wheel.

What is longitudinal control?

In openpilot, longitudinal control means that openpilot can control gas and brake. If a car uses stock longitudinal control, that means the stock system that came with you car is in control.

How does Lane Change Assist Work?

Lane Change Assist only works at or above 30 mph/49 km/h. Activate the turn signal and, when it is safe to change lanes, gently nudge the wheel in the direction of the turn signal. Always pay attention when changing lanes, openpilot has limited or no ability to check if changing lanes is safe.

How to change to a specific release?

See the instructions for how to checkout a specific release.

When are my videos uploaded to the cloud?

With comma prime, low quality videos and condensed logs are uploaded constantly, but at a maximum rate of 512kbps. When your device connects to wifi and the vehicle is stopped, it will upload the full logs and high quality videos.

Where is my dashcam video footage stored? How can I stitch the segments together?

Videos are stored on the device in /sdcard/realdata as 1 minute segment directories. Each directory contains the log data and video in hevc form. You can stitch these videos together using this Linux command:

cat fcamera1.hevc fcamera2.hevc fcamera3.hevc > output.hevc

The Windows equivalent for binary file concatenation would be

copy /b fcamera1.hevc+fcamera2.hevc+fcamera3.hevc output.hevc

If you rename the videos in sequence, you can use the shorter command:

cat fcamera* > output.hevc

Yet another option that doesn't require any renaming, simply change the date and time to match the start of your drive:

cd /sdcard/realdata
find . -type f -wholename "*2020-08-01--09-01-14--*/*.hevc" -exec cat {} + > drive.hevc

The output.hevc file can be uploaded to YouTube straight away, or played in VLC. But many others won’t know what to do with a .hevc file. So if sending, then download ffmpeg and convert it first. To make a .mpg copy for emailing etc., put the output.hevc file in the same folder as the ffmpeg program, then run a command like

ffmpeg -I output.hevc -qscale:v 1 output.mpg

Step by step guide for accessing video files here.

comma three

Why won't my comma three turn on?

The comma three is designed to be setup in the car. The USB-C to USB-C cable will only work when attached to the car harness in the vehicle. If you wish to power on the device inside, you must use a USB-A to USB-C cable and a wall charger.

What is a Dongle ID?

The Dongle ID is what identifies your device. It can be used to look up drives, and troubleshoot.

Where can I find my Dongle ID?

The device Dongle ID is found in Settings -> Device -> Dongle ID. If your device is paired with comma connect, you can also log into connect.comma.ai and grab your Dongle ID from the device list in the sidebar.

How do I delete my drives?

Perform a factory reset to delete your drives fully (answer below this one). An uninstall / reinstall of openpilot will still keep the drives preserved on the device.

How can I reset the device?

You can uninstall openpilot by heading into Settings -> Software, scrolling to the bottom and tapping "uninstall". The device will be ready to install new software.

You can install a custom fork using the comma installer URL (https://installer.comma.ai/<user>/<branch>). For example, to install the master-ci branch you should enter https://installer.comma.ai/commaai/master-ci. See How to change to a specific release?

You can also factory reset the device by tapping and holding on the comma logo while the device boots.

If the device is in a bad state and you cannot factory reset it normally, you should check out the agnos repository for instructions to re-flash it using fastboot from a computer or laptop.

What is the comma three hardware?

Read more on the comma three page.

Will the comma three kill my car battery?

It shouldn't. The comma three is designed to turn off after 30 hours of inactivity, or after a shorter amount of time if it senses the car battery is running low.

My storage space is filling up, How long are drive segments kept on my device?

Videos are saved on your device until additional space is needed. When less than 5GB or 10% of the drive space remains, the oldest segments will be deleted to clear up room. On the comma three 32GB stores approximately 1 hour of footage. The more storage you have, the more driving video you can store. The 250GB stores approximately 15 hours of footage, while the crosscountry edition with 1TB storage can save stores approximately 60 hours of footage. The oldest segments will be deleted to make room for new segments even if the old segments have not been uploaded. Want your video footage saved for longer? – Sign up for comma prime for 1 year of video storage.

comma two

The comma two is no longer supported. The most recent software release for the comma two is 0.8.13.1. Hot fixes may be pushed to the commatwo_master branch, but no new features will be released. Read more on the comma two page.

comma prime

What are comma points for?

What aren't they for? Same thing as Reddit karma.

Development

What is the openpilot development workflow? / What are the branches master, devel, and release?

Read this Medium post on Externalization.

What do the LED colors mean?

The LED indicates the status of the inbuilt panda (UNO).

* White: CAN send enabled
* Red: This is your panda's heartbeat(power). It fades in and out
* Green: Bad firmware or firmware flashing (only green, fast)
* Blue (static): CAN detected
* Blue (fades in and out): power saving

How can I contribute?

To contribute to the openpilot codebase:

If you're not into coding, feel free to join the comma pencil movement! You can help comma train their driving model by annotating driving data.

Join the Discord and check out the pinned messages in the #comma-pencil channel!

Discord Help

comma.ai is a very open company. Their developers spend a lot of time on the Discord Server working with users and collaborating with other community developers. This is awesome. But please don't abuse this. Asking questions that have already be answered is a waste of everyone's time. Wasting developer time, means slower improvements for us all.

Before Asking a Question

Please follow the instructions on the #Guidelines channel, specifically:

• Is it answered on https://comma.ai/faq ?
• Is it answered on https://wiki.comma.ai/ ?
• Is the answer found in the pins of a related channel? (Discord Pins)
• Has the question been asked before? (Discord Search)
• Have you read the channel description to confirm this is the correct place for your question?

How do I search on discord?

Basic word searching is simple, but you may have better luck if you use search modifiers:

image

So if you have a question about a Toyota Camry you should search in the #Toyota-Lexus channel such as: in:#toyota-lexus <search term>

How do I read discord channel pins?

On the web app, it is as simple as clicking on the pin icon in the top right of the channel:

image

On the mobile app pins can be found by dragging from the right edge of the screen to the left.

How do I read the channel description?

On the desktop/web app, the channel description is located at the top of the page. If the description is truncated, you can click on it to read the entire contents:

image

On the mobile app the channel description can be found by dragging from the right edge of the screen to the left.