Getting Started

UAV Desk supports two entry points into Log Analyzer: a direct upload flow for one-off Blackbox reviews and a saved-file flow for BBL files already attached to UAV configuration, maintenance, or flight records.

Option 1: Direct upload

Use direct upload when you want a quick local review. The file is parsed in the browser and is not stored on the server.

  • Supported extension: .bbl
  • Best for ad-hoc tuning sessions and first-pass analysis
  • Opens the same Graph, Table, Analyzer, and Setup tabs as saved logs

Open the direct upload flow to drop or select a file.

Option 2: Saved BBL files

The main Log Analyzer page also lists BBL files that already exist in your workspace data. Each entry shows the drone name, date, file size, and source badge:

  • Config: attached to UAV configuration files
  • Maintenance: attached to maintenance records
  • Flight: attached to flight BBL logs

Supported file behavior

The parser expects Betaflight Blackbox data. If a saved file is stored as a compressed .gz object, UAV Desk routes it through a proxy and decompresses it before parsing. If a direct upload is not a valid .bbl file, the upload is rejected before analysis starts.

Progress indicator: During parsing, the analyzer shows a phase label and a percentage. Wait for parsing to complete before interpreting graphs or spectra.

What happens after parsing

Once parsing completes, the analyzer opens with the same four functional areas every time:

  • Graph View: time-domain traces across one or more fields
  • Table View: frame-by-frame numeric values with summary statistics
  • Analyzer: FFT, PSD, frequency-vs-throttle, and PID error analysis
  • Setup: firmware and configuration context extracted from the file

Next steps

After your first successful load, continue with Interface & Navigation to learn the controls, or go directly to Spectrum Analysis if you are investigating noise or resonance.

Need a sample workflow? Continue with Best Practices after your first file review.