Skip to content

Cross-platform application for BLHeli firmware flashing and configuration

License

Notifications You must be signed in to change notification settings

asizon/blheli-configurator

 
 

Repository files navigation

blheli-configurator

Google Chrome application for BLHeli firmware flashing and configuration.

Disclaimer

This software is provided as is, use it at your own risk. ALWAYS REMOVE THE PROPELLERS and power your ESCs via a current-limiting device or power supply.

Features

  • Only BLHeli passthrough supported at the moment, hence only CleanFlight, BetaFlight, INAV and TriFlight
  • Changing settings for any BLHeli_S, BLHeli SiLabs and BLHeli Atmel ESCs with bootloader
  • Flashing BLHeli and BLHeli_S to SiLabs and Atmel ESCs (BLheli_32 NOT supported)

Future plans

  • Add declarative UI description for MAIN and MULTI modes
  • Full-featured 4-way interface support via BLHeli boxes, with C2-interface support
  • Electron/NW.js wrapper with auto-update
  • Android/iOS version based on the same code-base

Adding a new BLHeli revision or new supported ESC

You can submit pull requests to js/blheli_versions.json and js/blheli_escs.json files, user installations of BLHeli Configurator will see the changes shortly.

Installing BLHeli Configurator

Standalone

Download the appropriate installer for your platform from Releases.

Via Chrome Web Store

available in the Chrome web store

  1. Visit Chrome Web Store
  2. Click + Add to Chrome

Building (Chrome App)

This project uses ReactJS, JSX and some modern ECMAScript extensions and depends on yarn for building. Following the initial checkout, you have to run:

yarn

After that, to actually compile all the required .jsx files, run:

yarn build

Native app build via NW.js

Development

  1. Install node.js
  2. Change to project folder and run yarn.
  3. Run yarn start to build & run the debug flavor.

App build and release

The tasks are defined in gulpfile.js and can be run either via gulp <task-name> (if the command is in PATH or via ../node_modules/gulp/bin/gulp.js <task-name>:

  1. Run yarn gulp <taskname> [[platform] [platform] ...].

List of possible values of <task-name>:

  • dist copies all the JS and CSS files in the ./dist folder.
  • apps builds the apps in the ./apps folder [1].
  • debug builds debug version of the apps in the ./debug folder [1].
  • release zips up the apps into individual archives in the ./release folder [1].

[1] Running this task on macOS or Linux requires Wine, since it's needed to set the icon for the Windows app (build for specific platform to avoid errors).

Build or release app for one specific platform

To build or release only for one specific platform you can append the plaform after the task-name. If no platform is provided, all the platforms will be done in sequence.

  • MacOS use gulp <task-name> --osx64
  • Linux use gulp <task-name> --linux64
  • Windows use gulp <task-name> --win32
  • ChromeOS use gulp <task-name> --chromeos

You can also use multiple platforms e.g. gulp <taskname> --osx64 --linux64.

Usage

Having enabled Developer Mode in Chrome, navigate to chrome://extensions/ and use Load unpacked extension..., providing path to the root directory of your working copy.

Launch the application, plug your flight controller into a USB port, press Connect, power your ESCs. If you run into problems while working with the program, make sure to copy Developer's Console output as well as save log using the Save Log button.

Thanks

This software started as a tab in Cleanflight Configurator, hence my deep appreciation to all of you who contributed to it's development.

Special thanks to everyone who helped me with development, testing, collecting of logs and ideas and all other stuff:

  • Stefan van der Ende
  • Nathan
  • Steffen Windoffer
  • Steven R. Lilly
  • Tuomas Kuosmanen
  • Robyn Bachofer
  • ByeJon from the IntoFPV forum for drawing an icon :-)

This list is extended as the development goes on and I remember all the names :)

About

Cross-platform application for BLHeli firmware flashing and configuration

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 56.4%
  • HTML 35.6%
  • CSS 8.0%