| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Flash Multi is an application for managing the firmware on a Jumper, iRangeX, Vantac, 'Banggood', or DIY MULTI-Module. A GUI application is available for Windows and a shell script for Linux and macOS.
Flash Multi can read the existing firmware, save a backup, and write new firmware.
For STM32 modules, firmware read/write operations can be performed using the built-in USB connection or via an external USB-to-serial adapter. For ATmega328p modules a USBasp programmer is required.
Just three steps are required to update your Jumper, iRangeX, or DIY MULTI-Module (full instructions are below):
All MULTI-Module based on the STM32 or ATmega328p microcontrollers are supported. OrangeRX modules are not supported (yet).
Supported modules include:
Flash Multi cannot be used to update the internal module in any radio (e.g. T12, T16, TX16, T18, T-Lite, Zorro, etc.).
Internal modules are not connected to the radio's USB port so cannot be updated via the radio's port.
If your internal module has MULTI-Module firmware v1.2.1.85 or newer, and the radio is running OpenTX v2.3.2 or newer, or any version of EdgeTX, you can update the internal module from the radio using this process.
If your MULTI-Module has MULTI-Module firmware v1.2.1.51 you must use Flash Multi and a USB-to-serial adapter to update it one time, as explained here. Subsequent updates can then be installed from the radio.
Flash Multi requires .Net Framework 4.5 or newer. You probably already have a compatible version installed, but if not, the latest version can be downloaded from Microsoft.
Tip: When you launch Flash Multi it will tell you if you need to install or upgrade your .Net Framework.
Depending on your MULTI-Module and version of Windows you may need to install additional drivers manually.
The MULTI-Module USB drivers, which are used by many MULTI-Modules, including original Jumper JP4IN1 modules, iRangeX IRX4 and IRX4+ modules, and all Banggood STM32 modules, can be installed directly from Flash Multi.
Note: For the best results, plug the MULTI-Module in before installing the drivers.
Once the driver installation is complete, disconnect and reconnect the MULTI-Module.
The driver for the Jumper JP4IN1 module, the Silicon Labs CP210x driver, is not included with Flash Multi and can be downloaded from here: https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
Other drivers may be needed if you are using an external USB-to-serial adapter. Consult the documentation for your adapter.
Windows 10 includes drivers for many common serial devices, including many USB-to-serial adapters, so check Device Manager to see if your device is recognised.
Please refer to the Linux and macOS instructions.
Note: The first time you flash your module you may need to connect it with an external USB-to-serial adapter in order to flash the bootloader. The bootloader is required in order for the native USB port work, and it can only be written with a USB-to-serial adapter. This does not apply to newer Jumper 4IN1 modules, which have an internal USB-to-serial adapter.
Note for external USB-to-serial connections: When using an external USB-to-serial adapter, the BOOT0 pin on the board must be connected to 3.3V, usually by installing a jumper on the BOOT0 header pins.
Tip: Flash Multi will automatically select the new COM port / device, if it's running when the module is plugged in.
The bootloader enables flashing the MULTI-Module firmware from a radio which supports this (see here). It also enables the native USB port on MULTI-Modules which have one, facilitating firmware updates via native USB rather than an external USB-to-serial adapter.
When flashing with a USB-to-serial adapter the bootloader will be written automatically if the selected firmware file was compiled with support for it.
When flashing via the native USB port the firmware being flashed must be compiled with support for the bootloader otherwise, to avoid rendering the module inoperable, Flash Multi will display an error and stop the flash attempt.
The output will vary depending on the type of module being flashed.
Modules connected via an external USB-to-serial adapter, and the Jumper JP4IN1 module (which has an internal USB-to-serial adapter behind the USB port) will see output like this:
Starting MULTI-Module update [1/3] Erasing flash memory... done [2/3] Writing bootloader... done [3/3] Writing MULTI-Module firmware... done MULTI-Module updated sucessfully
Note: Step 2, writing the bootloader, is not performed when writing firmware which was not compiled with support for the native USB / Flash from TX bootloader.
Modules connected via USB (except the Jumper JP4IN1) will see output like this:
Maple device found in USB mode Starting MULTI-Module update Switching MULTI-Module into DFU mode ... done Waiting for DFU device ... got it Writing firmware to MULTI-Module ... done MULTI-Module updated sucessfully
For both methods, if the 'Show Verbose Output' box is checked the actual output from each of the flash proceses will be shown. If the flash fails for any reason the verbose messages are a good place to look for more details.
Flash Multi can read the existing firmware from the module and, if it is recent (newer than v1.2.1.79), display information about it, as well as the EEPROM Global ID of the module.
Tip: Flash Multi will automatically select the new COM port / device, if it's running when the module is plugged in.
For a recent firmware version, the output will look similar to this:
Reading from MULTI-Module via native USB Switching MULTI-Module into DFU mode ... done Reading flash memory ... done Multi Firmware Version: 1.3.1.9 (STM32) Expected Channel Order: AETR Multi Telemetry Type: OpenTX Invert Telemetry Enabled: True Flash from Radio Enabled: True Bootloader Enabled: True Serial Debug Enabled: False EEPROM Global ID: 0x665DEF2A MULTI-Module read successfully
Note: A Fixed Global ID (one which was set by modifying and compiling the firmware) cannot be read from the module. The value displayed will always be the unique ID which is stored in the module's EEPROM the first time it is used, not the customized one.
Once the module has been read, the existing firmware can be saved. The backup can optionally include the EEPROM data. Saving the EEPROM data allows a module to be cloned.
NOTE: When saving a backup from an Atmega328p module, two files will be created - one containing the firmware and a second containing the EEPROM. For an STM32 module the firmware and EEPROM data are in the same file.
Erasing the module will remove the firmware, and optionally erase the EEPROM data. Once erased, new firmware will need to be written to the module.
THIS OPERATION CANNOT BE UNDONE
Erasing the EEPROM data is necessary to restore a module which has had a backup which included EEPROM data restored to it (making it a clone) back to having its own unique ID.
Tip: Flash Multi will automatically select the new COM port / device, if it's running when the module is plugged in.
Once again, THIS OPERATION CANNOT BE UNDONE.
The Advanced menu contains extra features and settings.
The Advanced -> Actions menu can be used to access several extra actions.
Clicking Advanced -> Actions -> Install USB Drivers will install or upgrade the MULTI-Module USB drivers.
Drivers can be installed with or without a MULTI-Module plugged into the computer.
Note: For best results, do the driver installation with the MULTI-Module plugged in. If the module is plugged in, it will be reset to DFU mode during the driver installation. This is to ensure that the DFU-mode drivers are installed or upgraded properly - if an older driver is present it cannot be updated if the module is not connected. Once the driver installation is complete, you can unplug the module and plug it back in to reset it, but this is not necessary.
Clicking Advanced -> Actions -> Reset Module to DFU Mode will reset the attached MULTI-Module into DFU mode.
This is not normally necessary to do manually, but it may be needed for troubleshooting driver problems. This menu item is only enabled when a MULTI-Module in USB Serial mode is attached, and the COM port corresponding to the module is selected.
Clicking Advanced -> Actions -> Upgrade Module Bootloader will update the MULTI-Module's bootloader.
Updating the bootloader is required before upgrading to firmware v1.3.1.77 or newer, and also for some MULTI-Modules which are known to ship with broken or out-of-date bootloaders installed. See here for detailed instructions.
Clicking Upgrade Module Bootloader will replace the MULTI firmware with an application which will update the bootloader. Once the process completes the module must be unplugged, plugged back in, and new firmware written to it.
Important: Read the on-screen instructions and pay attention to the module's red LED during the bootloader upgrade process. It is important not to unplug the module until the red LED has been off for more than 5 seconds.
This menu item is only enabled when a MULTI-Module in USB Serial mode or DFU Bootloader mode is attached, and the COM port (or DFU Device) corresponding to the module is selected.
Sets the baud rate which is used to read and write MULTI-Modules using an internal or external USB-to-Serial adapter. Value can be 57,600 or 115,200 (default).
Try the lower rate if you have problems reading or writing a device.
Enable or disable running the MULTI firmware after it has been written to the module. Default is enabled (run the firmware after write).
Cloning a MULTI-Module means using the Global ID of one module on another. This may be useful if you have multiple radios or multiple MULTI-Modules and you want all your modules to control all your models without re-binding them.
NOTE: The EEPROM Global ID is not used by protocols which use the CYRF6936 RF component. You must compile your own firmware with a fixed CYRF ID to acheive the same result for those protocols (Devo, DSM, J6Pro, Traxxas, WFly, WK2x01).
There are two ways to clone a module:
EEPROM backup and restore can only be performed with modules with the same MCU - e.g. you cannot backup and Atmega328p module and restore it to an STM32 module.
After restoring the EEPROM you can treat the clone target module like any other - firmware can be read, written, updated etc. The EEPROM data will not be changed.
Note:
Global IDs can be copied between modules of any type.
Note: If you use Flash Multi to read a module which is running firmware which was compiled with a fixed Global ID, the EEPROM Global ID which is read will not be the ID the module is actually using.
Pre-compiled MULTI-Module firmware can be downloaded from https://downloads.multi-module.org/.
The MULTI-Module firmware can also be compiled from source relatively easily.
See the dedicated Troubleshooting page.
Much more information about flashing a MULTI-Module, including how to connect a USB-to-serial adapter and connect the BOOT0 pin, can be found in the documentation for the MULTI-Module at https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/blob/master/README.md.
Flash Multi is free software and comes with ABSOLUTELY NO WARRANTY.
| Back | FazBrowse Home | New Git URL |