Skip to content

Releases: betaflight/blackbox-log-viewer

Header Updates and New Analyser

13 Aug 01:02
Compare
Choose a tag to compare

This is a maintenance release.

  1. Updated version number.
  2. Modified header dialog to include new header fields for Betaflight V3.0.0 RC6 (Notch filters/RC interpolation etc).
  3. Status bar now shows gyro/pid/motor sync values (e.g. 250us 4k/2k/SYNCED or 250us 4k/4k/32k).
  4. Accelerometer range extended from 3G to 16G to prevent graph clipping on high powered craft.
  5. Thanks to Rav-Rav, a new enhanced analyser function has replaced the old dynamic one; this analyser is static but shows the noise for the whole log file in far greater detail.
  6. When using Betaflight debug mode feature (from the cli), debug fields on the viewer will be shown with their relevant field name, range and scaling; the debug_mode is logged in the header too (BF3.0.0 and later).

Grids, INAV Header Support and Stick Trails.

02 Aug 23:15
Compare
Choose a tag to compare

New Features

Now also available in chrome store!
Some New Features and minor code cleanups

  1. Added grid's to chart backgrounds;
  2. Added Shortcut key 'G' to toggle the grids On, Off globally.
  3. Thanks to DzikuVx; INAV header's can be displayed in viewer.
  4. Added INAV logo and blue theme to header buttons, graph config dialog. (Theme is Green for Cleanflight, Orange for Betaflight and Blue for INAV).
  5. Gyro chart range increased to +/-2000deg/s was a minor calculation error that limited the gyro chart to approx +/-1500deg/s
  6. Header update for Betaflight v3.0; added fields gyro_notch_hz, gyro_notch_q, rc_smooth_interval and "Craft name"
  7. Craft Name is now shown on status bar (if entered in CLI) and also at top of header dialog (Betaflight v3.0 only).
  8. PID Contoller type names on header updated for Betaflight v3.0.
  9. Stick Trails; This feature can be turned on from the User Settings dialog, will show a phosphor trail on the stick display that shows the movement of the sticks for the last 500ms.
  10. Add tooltips to primary logger controls.
  11. Thanks to BorisB, Added New Event names for Betaflight Twitch Testing mode.
  12. Added new version information to welcome page; A new button is available to download the the latest official release.

Notes on Grid Background

By default, no grids are shown on the graphs.

  1. To add a grid background to the chart, 'ALT' Click the graph field name that you want the grid to show for.
  2. To select another field to show the grid for, 'ALT' click another field.
  3. To remove the grid, 'ALT' click the field again (it is a toggle).

Grid settings are workspace aware, so you can have different configurations for each workspace. (Just save the workspace after you have setup the grid display).

With grids shown, pressing the 'G' key will toggle the grid display on/off globally so that you can quickly hide the grid.

The lines on the grid represent 100ms time slots and each horizontal gridline represents 20% of the range of the signal. It makes it easier to see how the expo setting for the graph emphasises the centre section of the graph.

Custom Line Widths, Single Frame Scrolling, Watermarks and Lap Timer.

21 Jul 12:28
Compare
Choose a tag to compare

Some more minor tweaks and a couple new features.

New Features

  1. Adjustable Line Widths
  2. Single frame scrolling (Hold ALT key whilst using cursor left and right)
  3. Drag/Drop re-ordering of graphs on the chart (works in the graph configuration dialog too).
  4. New shortcut keys 'S' and 'X' to toggle on/off all smoothing and expo on the chart.
  5. New Watermark feature to add your own logo to exported video's or live-streams.
  6. New Lap Time feature to add timing information to your exported video's.

Complete Change Summary

  1. Added User selectable line widths to graphs. (on Graph Config dialog box)
  2. Added single frame scrolling (hold ALT key down whilst using LEFT or RIGHT cursor keys). This feature will either scroll a single log frame if no video is loaded; or a single video frame (based upon a video at 60FPS).
  3. Adjusted Keyboard shortcut keys popup to show new single frame scrolling.
  4. Minor tidy up of bookmark scrolling to optimise the code. (this is a cosmetic change to the code only).
  5. Added drag re-ordering of graphs on legend and graph config dialog box.
  6. Added shortcut keys 'S' to toggle smoothing on/off and 'X' to toggle expo on/off. For quickly removing smoothing/expo on graphs.
  7. The Video playback controls are now height dynamic to prevent overlapping on small window sizes.
  8. Add watermark feature to place a configurable logo anywhere on the graph. This is setup up in the user settings dialog box. Recommend you use a .png file (with transparency) for your logo. The overall transparency can be adjusted on the dialog. The logo can be scaled by adjusting the size value.
  9. Add Lap Timer feature to overlay timing onto video's/logs.

Note on Lap Timer Feature

To use this feature

  1. Go to the Advanced User Settings Dialog box and turn on the Lap Timer;
  2. Open a Log file (required) and an associated Video File (recommended). Sync them up as per normal.
  3. Bookmark the start frame of a race (for example);
  4. Add additional bookmarks at each time you cross the start/finish line.
  5. Keep adding as many bookmarks as you need (up to 8 laps).
  6. Play your video from the beginning or export it in the normal way.

As you play the video/log, the lap timer will auto start at the race start (the first bookmark) and accumulate a current lap time, last lap time, best lap time plus a summary of all lap times as the video progresses.

You MUST have a log loaded to use this feature although if you don't want the charts to display on your exported video, setup a workspace with no graphs (workspace 0 for example)

Apologies

  1. Still no audio on video export, this is proving a little difficult to achieve at the moment :-(

Advanced User Settings

24 Jun 14:17
Compare
Choose a tag to compare

New features available

  1. Custom Stick Configurations for those that fly mode 1; stick display will now show correctly.
  2. General Cosmetic Changes;
  3. Betaflight and Cleanflight logos displayed on header bar; autodetect log version to display correct logo.
  4. Header popup window is disabled for Cleanflight users (as the information is not held in the log file yet).
  5. New links on the welcome screen and title has been changed to the Enhanced Blackbox Explorer to distinguish it from the standard viewer.
  6. Advanced User Dialog Box to allow user to adjust size and position of the overlay icons (craft, sticks and analyser view)
  7. User configurable stick display,can now display the sticks with throttle % and roll,pitch,yaw in deg/s
  8. Marker/Measure mode (M key) will now show the time difference directly on the graph when you scroll; also the calculated frequency is displayed to quickly measure noise (for example).
  9. Log controls now locked to the top of the display so they are visible even if you scroll down the page.
  10. The multiple log selection and dropdown is now shown in the graph legend for easier selection. (and to prevent it being hidden on lower resolution displays).

Minor Improvements and Bug Fixes

31 May 13:02
Compare
Choose a tag to compare

Some Minor Bug Fixes and improvements

  1. Selecting [all] fields in graph config will cyclically assign alternate colors to fields (starting with the selected color)
  2. When entering filters on configuration file, the updating list would generate errors if the grep statement was invalid. (could only be seen in developer mode).
  3. Video export now fixed (still no sound though :-( ); also if you hide an item on the graph display (hide the craft for example), then it will also be hidden on exported video.
  4. Cleanup hide/display of popup table (key 'T'); originally if the table was hidden and you popped up the overlay, when you hid the table again, it would show at the bottom of the page; now it will return to its originally selected state.
  5. You can load 2 configuration dump files; if you load a second one with the the word 'default' in its filename (e.g. Betaflight V2.7.2 Default.txt) then this file will be used as a baseline for the first loaded file; all differences between the two files will be highlighted in red. Also, once a "default" file is loaded, it will be cached and autoloaded next time you open up the log viewer; thus you only have to re-load the "default" file if and when the default values are changed.
  6. Header and Scaling now Betaflight v2.8.0 compliant; will auto-detect version from log file and scale accordingly.
  7. Analyser Crash fix for crash that occurs if switching between many logs repeatedly (more than 6 times per session).
  8. Code improvements for operation in Linux.
  9. Additional User Settings Dialog for custom motor mixes (for those not running a standard X quad). Note that this setting only affects the craft overlay icon that is displayed. Deselecting "Custom" will display craft the traditional way (this is the default, you only need to change it if you are running a special motor configuration).
  10. When using the Marker function (M), the time offset from the marker also shows the frequency in Hz (so if you mark the peak of a wave, then scroll to the next peak, you can quickly see the frequency of the wave). Quickly identify the frequency of your noisy gyro's.

New features

18 May 20:09
Compare
Choose a tag to compare

New features.

  1. Shortcut key 'T' will toggle the field value table as an overlay; no need to keep scrolling down to look at the values; the table is still dynamic and will update if the the log is scrolled, played...
  2. Users can select their own colors for the graph fields on the graph configuration dialog. Colors are workspace aware and can be set on a per workspace.
  3. FOCUS, selecting the graph title on the legend will hide the other graphs leaving only the selected one displayed; selecting the title again will put them back.
  4. The log filename is now in the header and the header is fixed so that it doesn't scroll off the top of the display.
  5. The filter settings from the header are shown on the analyser screen for reference
  6. Configurable relative graph heights.
  7. Workspace Export and Load feature. (New Export button for workspaces shown on page header creates a file "workspaces.json" in your downloads folder, these can be renamed to whatever but MUST have the extension .json). To re-load saved workspaces from file, use the standard open log file/video to select the archived file.
  8. Configuration Dump text file load and view; it is now possible to open up a "dump" file for the flight controller configuration. This has to be a text file, with extension .TXT and must include the "# dump" line near the top of the file for the viewer to recognise it as a configuration file (rather than a normal LOG.txt file). Simply copy the CLI dump output to a text file and save it as "something.txt". Use the standard open log file/video button to open the file. The name of the loaded file is shown on the status bar (bottom right). To view it, either click the name in the status bar or press key 'C' (pressing C repeatedly will toggle the display). The view is scrollable and there is a filter search feature if your looking for a particular entry.

Status Bar Additions

16 May 11:21
Compare
Choose a tag to compare

Added new status bar feature.

Minor update release

15 May 06:53
Compare
Choose a tag to compare

Minor changes to tidy up log header to match released version of Betaflight v2.7.0.

Minor bug fixes

09 May 09:20
Compare
Choose a tag to compare

Noticed that the Smart Sync combination M and M only worked if you dragged the graph in the positive direction only. This is now fixed so that you can sync backwards and forwards of the marked point.

Also moved the header and keyboard shortcut buttons off the legend and up into the view toolbar to maximise space for the legend.

Header Dialog, Analyser Improvements

28 Apr 20:03
Compare
Choose a tag to compare
  1. New dialog box added to review extra log header data;
  2. Added Keyboard Shortcut Pop-up dialog.
  3. Added ability to maximise the analyser window.
  4. Added bookmarks;

The new header dialog box displays the information from the log, also, if the log does not have all the information, then the user can enter the information if they want; It is not written back to the log file though. The only reason to enter the information is so that the rcCommands[] etc fields can be accurately scaled.

If you are using Betaflight v2.6.2 onwards, then the header is populated automatically.

RED fields are missing from the log header (using and older version of the log); greyed out fields are not applicable to the version of cleanflight/betaflight the log was made on.

The dialog will attempt to work out if the log is cleanflight or betaflight; if it cannot, then it will provide a button next to the cancel and save to allow you to manually choose the firmware you were using.

New bookmark feature, can now mark up to 9 points in time through the log to quickly jump back and forwards. Please look at the "keyboard shortcuts" dialog for details.