Troubleshooting common problems you might encounter and how to fix them:

Symptom Solution
Vehicle or Controller does not boot up Some SD cards larger than 32Gb do not boot correctly. Use SD cards smaller than 32Gb.
Flight modes are wrong Make sure you set the right vehicle type in Menu->Vehicle->General as the flight modes types depend on the vehicle type (car, drone, plane, etc).
Video freezes Usually a sign a insufficient power supply. You need a power supply that can deliver more current.
Video freezes after few minutes Make sure your USB connections wires are shielded or twisted. Better yet, also solder directly all the wires instead of using USB connectors.
Also, you can try decreasing the CPU clock on the vehicle (from Ruby menu) and increase the CPU over voltage from 3 to 4.
Controller and vehicle start, but controller did not detected the vehicle A) If using Raspberry Pi 2B, 3B or 4, try to use different USB ports on the Pi;
B) Or, from the controller: search for the vehicle on all bands.
C) Check if vehicle does boot in vehicle mode (using a HDMI display). On boot, on the vehicle side, the check to see if it should boot as vehicle is successful if one of these conditions is true:
  • A camera is attached to the Pi;
  • GPIO 19 is connected to 3.3v; (see hardware connections for detailed info)
  • A file named "forcevehicle" is detected at boot on the SD Card;
There is visible video latency If you have video latency do:
* Decrease video bitrate and/or
* Increase radio bitrate;
If using a HDMI camera, change camera profile to HDMI from Menu->Vehicle->Camera->Profile
Strong interferences
(Video has random bad picture)
You have an undesired strong source of radio interferences near the controller or the vehicle. Shield the radio cards and the CSI camera cable.
RC RSSI Always shows 0 in the OSD If you don't have a valid telemetry connection to your flight controller and you are not using Ruby RC link, it will always show 0.
If you have enabled Ruby RC link, it will show the RC link quality of the Ruby RC link.
If you have telemetry link to the flight controller, make sure you configure your flight controller to generate the RSSI value as here: ArduPilot RSSI configuration

Note: Some RC receivers and some RC protocols can't generate a RSSI value that a flight controller could use.

You can ask questions and find answers related to various setups and hardware configurations or to any unknown issue you might have here on this forum:

or here on Telegram: Telegram Channel