FAQ - commaai/openpilot Wiki

Original URL: https://github.com/commaai/openpilot/wiki/FAQ

FAQ

◄ Home

The official comma FAQ is found here comma.ai/faq

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 45 Mph/72 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. This must occur within 10 seconds of initiating the turn signal. Always pay attention when changing lanes, Openpilot has limited or no ability to check if changing lanes is safe.

How to a Change 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 two

Why won't my comma two turn on?

The comma two 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 my.comma.ai/useradmin and grab your Dongle ID from the main page under Devices.

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?

Reset the comma two by pressing and holding Power and Volume Up -> Factory Reset -> Full Factory Reset

What is the comma two hardware?

LeEco LePro 3, Snapdragon 821. Battery and driver camera infrared filter are removed.

I can't see my screen while wearing polarized sunglasses

Try a matte screen protector film which can be trimmed with scissors to fix the screen, that will stop glare and enable you to see the screen with polarized lenses. This one from amazon has been used and recommended.

Will the comma two kill my car battery?

It shouldn't. The comma two 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.

Can I adjust the brightness calibration?

Yes. Adjust the light sensor calibration in /persist/comma/params/d/BRIGHTNESS_M & BRIGHTNESS_B. M is multiplicative, whereas B is an offset. If it's good at night, but dim during the day, increase M. If it's too dim all the time, adjust B.

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

Videos are saved on your device until additional room 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 2, this results storage for around 12 hours of segments. The oldest segments will be deleted to make room for new segments even if the old segments have not been uploaded.

What are the infrared emitter specifications, and are they safe?

The 850 nm IR LEDs are, combined, rated for 3 Watts continuous but limited to 1.5 W in software. Assuming a 75 degree spread at 70 cm distance, the intensity is 0.16 mW/cm^2. To avoid thermal injury, a recommended continuous exposure limit is < 10 mW/cm^2.

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.