SD Logging
English | Deutsch
Every frame of telemetry, written to microSD in Betaflight blackbox format, so a bench run can be plotted rather than remembered.
Any microSD card, FAT32. Insert it before powering the board on if you can — the
card is mounted once at boot, and there is no card-detect pin on either board,
so a card inserted afterwards needs the RETRY MOUNT button.
Files land in the card's root as LOG00001.BFL, LOG00002.BFL, and so on. The
number goes up; nothing is ever overwritten.
Automatically: arming starts a log, disarming stops it. That is the normal case and needs no interaction at all.
Manually: START on the SD LOG screen begins one whenever you like, and a
log you started by hand survives the arm and disarm that would otherwise have
controlled it. STOP ends it.
The tester screen shows the state in its top row: REC in red while recording,
SD while idle, SDERR if the card is faulty, NOSD if there is none.
| Row | Meaning |
|---|---|
| STATUS |
NO CARD, READY, RECORDING, or CARD ERROR
|
| FILE | The file currently open |
| FRAMES | Telemetry frames written so far |
| WRITTEN | Kilobytes on the card |
| DROPPED FRAMES | Frames the buffer could not hold. Should be zero |
| BUF PEAK | High-water mark of the write buffer, against its size |
| WORST FLUSH | The longest single write to the card, in milliseconds |
| CARD | What the card reports about itself: type and size |
| MOUNT | The filesystem result. 0 OK is what you want |
The bottom four are diagnostics, and the interesting one is the pair. BUF PEAK
approaching the buffer size, or a WORST FLUSH longer than the buffer can cover,
is the warning that the card is too slow for the buffer it has. DROPPED FRAMES
above zero says it already was — the log has holes.
A slow card is the usual cause. Try another one before anything else.
NO CARD with MOUNT 3 NOT READY means nothing answered on the bus at all —
no card, or not seated. MOUNT 13 NO FILESYSTEM with a size shown under CARD
is the opposite and much more useful: the card is present and talking, and the
problem is the filesystem. Reformat it as FAT32.
RETRY MOUNT. Without it, a card put in after power-up is indistinguishable
from a card the firmware cannot read.
logwiju — the intended viewer
Browser-based, nothing to install, and it does not upload anything: the file is
read locally. Drop a .BFL file on it and you get the traces plotted against
time — RPM, voltage, current, temperature, stress, throttle.
That is the tool these logs were shaped for, and it is the one to reach for first.
The files are ordinary Betaflight blackbox logs, so
Blackbox Explorer opens them too, as does
the blackbox_decode command-line tool. Some fields are named for a flight
controller rather than a bench tester, which is the price of using a format that
already has tooling.
Per frame: time, RPM and eRPM, throttle, voltage, current, ESC temperature, stress, the ESC status byte, arm state, and the packet/error counters.
Where a KISS telemetry wire is fitted, both sources are recorded separately as well as merged, so a log can be used to check one against the other rather than having to trust the merge.
Logging is a compile-time feature and is on by default. If you built the
firmware yourself with SD_LOG_ENABLE=0, the screen still exists and will
always report NO CARD.