Version: 2.0.0

Blackbox logging

What is Blackbox

Blackbox is a flight data recording feature in Rotorflight. A Blackbox log contains a lot of data, such as the attitude of the heli, gyro sensor measurements, PID data, RC commands, motor outputs etc. It’s an extremely powerful tool for tuning and troubleshooting the heli.

Blackbox data can be logged to:

A flash chip on the FC. Logging is fast, but storage is limited, unless you are using a dedicated RF controller(FlyDragon F7 has 128MByte Flash), and copying log files can be slow.
An SD card on the FC, it's fast and storage is only limited by the capacity of the SD card.
An external logging device: OpenLager. These devices write the log to a micro SD card.

A flash chip or an SD card on the FC are nice, but if your FC doesn't have that you can connect an OpenLager logging device.

Blackbox Tab

Blackbox Configuration

Blackbox Tab

Logging Device

Here you can select the device type.

No Logging: Disable Logging.
Onboard Flash: Log to the onboard flash chip (if available).
SD Card: Log to the onboard SD Card (if available).
Serial Port: Log to an external logging device (eg. OpenLager).

Logging Mode

Select the preferred logging mode.

No Logging: Disable Logging.
Normal: Start logging when both ARM and BLACKBOX switches are active.
Armed: Start logging when ARM switch is active.
Switch: Start logging when BLACKBOX switch is active.

Logging Rate

The log data is saved to the logging device with this rate. For logging to an external device, lower speed may be required.

Set it to 2kHz for OpenLager.

Debug Mode

Choose what extra data is being logged, eight extra debug items are added to the Blackbox Log.

note

Under Blackbox debug mode you can specify what should be logged. There are a lot of choices, but you can select GYRO_SCALED for PID tuning, GOVERNOR for analyzing the governor or CYCLETIME if you're interested in CPU time.

Debug Axis

Choose which axis is being debugged. Applies to some of the debug modes.