Gyroflow documentation
  • ๐Ÿ‘‹Welcome to Gyroflow
    • ๐Ÿ’ŽFeatures
    • โœจExamples
    • ๐ŸงชTest Files
  • Getting started
    • โš™๏ธInstallation
      • DaVinci Resolve (OpenFX)
      • Final Cut Pro (Gyroflow Toolbox)
    • ๐ŸŽฅSupported Cameras
      • GoPro
      • DJI
      • Sony
      • Insta360
      • Blackmagic
      • RED
      • Flight controllers
      • RunCam
      • Caddx
      • Hawkeye
      • Mobile Phones
      • Other Cameras
    • ๐Ÿ”งBasic Usage
      • ๐Ÿ“ˆTimeline & Gyro Chart
      • โŒ›Synchronization
      • ๐Ÿ”ฅStabilization
      • ๐ŸŽฌExporting
    • ๐Ÿ“ธCommon Filming Tips & Issues
    • ๐ŸLens Calibration
    • โŒจ๏ธKeyboard Shortcuts
    • ๐ŸŽž๏ธFile Joiner
    • โ“FAQ
    • ๐ŸžTroubleshooting
    • ๐Ÿ—ฃ๏ธTranslations
    • ๐Ÿ›Report an Issue
  • Advanced usage
    • ๐ŸŽฌInput Data
    • ๐Ÿ”ญLens Profiles
    • โŒ›Synchronization
    • ๐Ÿ”ฅStabilization
    • ๐Ÿ”‘Keyframes
    • โš™๏ธSettings Presets
    • โฉRender Queue
    • ๐ŸŽฌExporting
    • ๐Ÿ—๏ธCommand Line (CLI)
    • ๐Ÿ’ปOther
    • ๐Ÿ”€IMU Orientation and rotation
    • ๐ŸŽจColor Differences
    • ๐ŸŒ€Using External Gyro Source
      • Action Camera as a Logger
      • Flight Controller
      • ESP-gyrologger
      • Flowshutter
    • ๐Ÿ“บLive Feed Stabilization
    • ๐Ÿฅฝ360ยฐ Cameras
  • Hardware Acceleration
    • ๐ŸŸขNVIDIA
    • ๐Ÿ”ดAMD
    • ๐Ÿ”ตIntel
    • โšชApple
    • ๐ŸŸขAndroid
  • Video Editor Plugins
    • ๐Ÿ’กGeneral Plugin Workflow
    • ๐Ÿ”ŒDaVinci Resolve (OpenFX)
    • ๐ŸŽž๏ธAdobe Premiere / After Effects
    • ๐ŸŽฌFinal Cut Pro X
    • ๐Ÿช„frei0r
    • ๐Ÿ—ƒ๏ธCSV Export
  • Technical Details
    • ๐Ÿฆ€Used Technologies
    • ๐Ÿ–‡๏ธParsing Gyro Data
    • ๐Ÿ› ๏ธGyroflow Core
    • ๐ŸงชBuilding from Source
    • ๐Ÿ—ƒ๏ธGCSV Format
    • ๐Ÿ—„๏ธGyroflow protobuf
    • ๐Ÿ–ฅ๏ธGitHub Repository
  • Authors
    • ๐Ÿ‘จโ€๐Ÿ”งAuthors
Powered by GitBook
On this page
  • Hardware
  • Betaflight/(Cleanflight/Emuflight?)
  • Gyroflow logger preset
  • Acknowledgements
  1. Advanced usage
  2. Using External Gyro Source

Flight Controller

Last updated 1 year ago

Betaflight/Cleanflight/Inav/Emuflight/etc form a popular family of flight control firmware for high-performance multicopters. By using the built-in blackbox logging feature, gyro data for use with Gyroflow video stabilization can be collected. This was in fact one of the initial goals of the project! Betaflight, Cleanflight, Inav, Emuflight etc. all use more or less the same structure for handling blackbox data logging, so this page covers all of these.

Hardware

As you may already know, the above mentioned flight firmwares can all run on the same type of hardware. A flight controller supporting this family of flight firmwares typically contain:

  • STMicroelectronics 32 bit microcontroller (F4, F7, G4, H7)

  • MEMS inertial measurement unit (MPU6000, BMI270, ICM2xxxx, ICM4xxxx etc.)

Some flight controllers have an onboard magnetometer. In general, this is not required for video stabilization purposes unless absolute orientation is desired.

Different gyros exhibit different behaviors in terms of data quality, noise, etc. In general, if the IMU is capable of providing clean data for the drone control loop, the same data is suitable for video stabilization purposes.

For blackbox data logging, the hardware typically either contains an onboard SPI Flash chip, or a slot for an SD card. If neither of these are available, additional hardware solutions can be connected to the flight controller in order to enable blackbox logging. This can be using:

  • - A open source and commercially available board containing an STM32f4 and a MicroSD slot for logging high rate data through a spare serial port.

  • - An open source ultra-light logger containing a 16 MB flash chip.

  • - A serial-based logger similar to the Openlager. This is no longer officially supported by Betaflight etc. due to data rate limitations.

Betaflight/(Cleanflight/Emuflight?)

Required software:

  • Betaflight/Cleanflight/Emuflight configurator

  • Betaflight blackbox explorer

The following should be a decent starting point for the blackbox configuration

  • 250 Hz logging rate

  • Debug mode: None

If you're running Betaflight 4.3 or newer, it is possible to deselect specific elements of the data logging in order to save precious recording space.

Gyroflow logger preset

We have a gyroflow-betaflight presets source for your convenience. You can easily set it up like the picture shown below:

Once the gyroflow logger preset is actived, you'll see some special gyroflow presets:

  • Gyroflow minimal settings: for users who wanna use the blackbox data from main FC as motion data for video stabilization.

  • Sencondary FC as Gyroflow motion logger: for users who use a secondary FC as a gyroflow motion logger.

  • Gyroflow BMI270 Filter sttings: for users whose FC has a BMI270 sensor and want to use it as a gyroflow motion logger.

  • Flowbox target settings: preset for flowbox and flowbox+flowshutter

CLI commands

Or you might prefer the "old fashion", from the CLI:

set blackbox_disable_pids = ON
set blackbox_disable_rc = ON
set blackbox_disable_setpoint = ON
set blackbox_disable_bat = ON
set blackbox_disable_mag = ON
set blackbox_disable_alt = ON
set blackbox_disable_rssi = ON
set blackbox_disable_debug = ON
set blackbox_disable_motors = ON
set blackbox_disable_gps = ON

Acknowledgements

TODO
    - logger from fpvframe.ch
    - Camera angle

: Forked from betaflight/firmware-persets

๐ŸŒ€
The Openlager
Tiny Blackbox
SparkFun OpenLog
logger-presets