CleanFlight Blackbox

What is Blackbox in Cleanflight

CleanFlight can now log your flight data with BlackBox feature. This is a great tool for diagnosing problems of flight controller, motors, power system, or radio transmitter/receiver. It’s also great for tuning PID and other flight performance settings.

Your captured flight data logs can be converted to CSV for analysis using the included software. You can even rendered them out as PNG frames, which you can overlay onto your flight video with your favourite video editing software. There are quite a few people used data recorded with BlackBox to overlay on their FPV video, and the result looks great.


How to use Blackbox

The flight data is transmitted via serial port and it’s recorded on . The current recommended hardware for logging data is the OpenLog serial data logger and a microSDHC card. The OpenLog logger needs to be flashed with Blackbox firmware first.

You can find documentation for setting up the BlackBox on the CleanFlight github docs page here. You can find the github for BlackBox here and the developers (thenickdude) youtube here.

This document outlines in detail how to use Blackbox and the hardware required to start logging your flight data.

This is my detail blackbox setup guide on Naze32.

Convert and Render Flight data from Blackbox

There are various tools you can use to convert and render flight logs into format you want. It’s very well documented, giving you all the instructions you need in the official page.

Cleanflight Blackbox Explorer

This is a really handy tool. Blackbox Explorer allows you to open logs recorded by Cleanflight’s Blackbox feature in your web browser. If you have a flight video you can also play the video in the background and have your data overlayed .It saves you time rendering the video.

17 thoughts on “CleanFlight Blackbox

  1. Javier

    Hi Oscar!!

    Excellent article

    I just add one more thing to it:

    Enable Blackbox recording by typing this at the CLI

    set blackbox_device=SPIFLASH

  2. Joakim

    Hi Oscar.
    I dont know what background you have. But when u tell people that all info you will need is there i guess you are refering to programers. There is abolutely nothing there to tell you how to use those files and how to make png files with the render tool. I have been looking on answers on internet for a ful week now. installing XCODE, MACPORT, something called libcairo, updated Java, entered lots of terminal commands and so on. i still dont have the first clue what to do and what im doing.
    I was thinking it wouldnt be so complicated.
    I cant find a tutorial online either. So if anyone out there would put one together it would be more then awesome.

    1. Oscar Post author

      Hi Joakim
      it is a bit difficult to use.
      It’s a bit like windows command line, you need to type in the command with different parameters depends on what you need.
      I will see if i can find some time and do a short tutorial on that.

  3. tournesol

    all the links seem to be missing from this section:

    “You can find documentation for setting up the BlackBox on the CleanFlight github docs page here. You can find the github for BlackBox here and the developers (thenickdude) youtube here.”

  4. wwwsam

    Hi Oscar
    I made a DIY version of the datalogger from parts I had around (~ <$10 USD):
    -Arduino Nano development board (Same atmel processor as this expensive datalogger) ~$8 USD
    -microsd arduino adapter ~$2 USD

    I wired it up and flashed the blackbox firmware and found that everything works… except the logs are empty.
    ie. It creates the config file and a bunch of empty log files on the microsd. It seems it cannot communicate with my nano..
    As I do not have a spare nano I cannot test if it is just a problem with the board =/

    Anyone have similar parts and care to try?

    Also as side note, my FC is Flip32+. and the TX can be read perfectly through a usb to uart adapter


    1. V_kingo


      Open Arduino Serial monitor set 115200 baud and carriage return and the COM port where your Nano is, type some characters, press entet sometimes, switch off, remove micro SD and check if your wrinting was done.

  5. CaTiO

    Cheapest I can found:

  6. fongworld

    “blackbox_render LOG00001.TXT”
    “This will create PNG files at 30 fps into a new directory called LOG00001.01 next to the log file ”
    What software do I need to do it?
    I already have a “TXT” file, download the “blackbox_render tool”, but I still do not know how to decode a “PNG” file.
    Thank you, I was a beginner

  7. Neil

    goofy question but is there a Chinese clone of the openlog? I have no objection in supporting sparkfun (have spent plenty there in the past) but for something that I am just wanting to do for ‘fun’ I cant see spending 30 bucks for an sd card logger… really really cool feature though!

    1. Oscar Post author

      you are absolutely right, $30 is a bit too much for what it does. I haven’t looked deep enough into this feature yet to answer your question. I will post updates in social media if I find any cheap alternative to this expensive sparkfun logger. (google plus / facebook page)

      1. Neil

        Thank you very much. I would love a diy approach. I found that build
        I searched around to see if someone had a public pcb anywhere.. I would love to diy it.. I found another arduinopro mini data log build here it is a bit bulkier than I want to go on my 250 though..
        so there has to be a way. Keep me posted if you find anything. Thanks again for the great updates to the site!

Leave a Reply

Your email address will not be published. Required fields are marked *

For prompt technical support, please use our forum I check blog comments weekly.