Releases: ExpressLRS/ExpressLRS
ExpressLRS V2.5.1
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- This update is not required for most users and is only meant to fix some small issues.
Enhancements
- N/A
New targets
- N/A
Bug fixes
- Restore HTTP upload functionality (#1580)
- PlatformIO and Namimno STM Voyager TX bootloader fixes (#1593)
- Fix WiFi force flash (#1600)
- Add WS2812_IS_GRB for Namimno OLED TXes (#1625)
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.5.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- This update is not required for most users.
Enhancements
- Ensure that WiFi firmware uploads are 100% complete before attempting to flash (#1560)
- GEPRC Nano Receiver targets (Configurator only commit: ExpressLRS/ExpressLRS-Configurator#327)
- betaflight/betaflight#11070 and EdgeTX/edgetx#1819 add a new sensor type for baro/altitude data that does not use the gps fields. This PR adds support for the new sensor type (#1528)
- Backport the ability to force-flash firmware from the Configurator when target names mismatch (#1531)
New targets
- BETAFPV LiteRadio 3 Pro
- GEPRC Nano 2400 RX
- GEPRC Nano 900 RX
Bug fixes
- The
streamexpect
library that is used to support ETX passthrough had ones of it's dependencies updated in an incompatible way, so we've included this library directly into the build chain code (#1564) - Fix WiFi firmware update reboot process when auto wifi is set to off (#1559)
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.4.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- This update is not required for most users.
Enhancements
The ExpressLRS team would like to thank RadioMaster and EdgeTX for their collaboration on integrating ExpressLRS into the TX16S.
- TX16S Mk2 internal ExpressLRS transmitter target (#1514)
- NamimnoRC FLASH Diversity receiver target (#1519)
- BETAFPV lite receiver target (configurator only commit: ExpressLRS/ExpressLRS-Configurator#307)
Bug fixes
- Correction to the Radiomaster Zorro output power (#1517)
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.3.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- This update is not required for most users, but contains new features for HDZero users, and minor bugfixes.
Enhancements
The ExpressLRS team would like to thank Divimath / HDZero for their support and collaboration on an integration between ExpressLRS, and the HDZero Video Receiver (VRX).
What does the ELRS + HDZero integration provide?
Currently, the high level feature set allows a user to:
- Change the band (R-band, F-band) and channel (1 to 8) that the VRX is receiving on from the VTX Administrator menu within the ELRS LUA,
- At the same time, change the band and channel that a HDZero VTX is transmitting on, assuming it has been configured to use Smartaudio control, and is connected to a Betaflight FC,
- Start and stop the DVR recording on a HDZero VRX based on the state of an AUX channel,
- Delay the start or stop of DVR recording by a configurable timespan, when using the AUX control described in item 3 above.
There may be more features introduced in future to further extend this integration.
For more information, see the Manual for the HDZero Backpack here: https://docs.google.com/document/d/1L4U4uEqYhuwCww_RxSpavNetltbHMvLAknhM0HjRnwE/edit?usp=sharing
NOTE: This integration uses the Backpack functionality (See https://github.com/ExpressLRS/Backpack), and requires that a backpack receiver, running v1.0 or later be added to your VRX
Bug fixes
- Bring back NamimnoRC Gen1 TX Backpack #1420
- Give the Web Update Success Popup some clearer and Device-type specific messages #1404
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.2.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- This update is not required for most users, but contains minor bugfixes and new targets.
Enhancements
The ExpressLRS team would like to thank RadioMaster and the EdgeTX team for their support and collaboration on an internal ExpressLRS module. RadioMasters contribution of numerous prototypes and final product hardware for testing has resulted in the first fully featured and supported handset... the RadioMaster Zorro!
https://www.radiomasterrc.com/products/zorro-radio-controller
https://github.com/EdgeTX
Internal Full Duplex
- Full duplex internal target #1287
- EdgeTX serial pass-through flashing e.g. update ELRS and the Backpack through the handset USB port EdgeTX/edgetx#1039
- Baud rate up to 5.25M
Misc
- Improved recovery from a bad flash #1351
- Improved dynamic power start up #1360
- Output power monitoring and updating for the SKY85321 RF Amplifier #1287
Bug fixes
New Hardware Targets
2.4GHz
- RadioMaster Zorro
- FrSky VANTAC #1289
- Jumper Aion T Pro #1325
- Jumper Aion Nano #1329
- BetaFPV Micro 1W #1364
915-868MHz
- NA
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.1.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- Be sure to flash both the TX and RX as the 1.x and 2.x protocols are incompatible.
Enhancements
The ExpressLRS team would like to thank Axis for all their hard work making some of these awesome enhancements. They did the initial development and implementation of the thermal sensor (LM75A), the gyro sensor (G-sensor), TFT display support, and the framework for the menu system.
Thermal
- Added LM75A Sensor support (Currently only on Axis TX) #1151
- Added auto fan control based on temperature (Currently only on Axis TX) #1151
G-Sensor
- Added gyro sensor used for motion detection (Currently only on Axis TX) #1151
- Added Automatic display sleep and wakeup (Currently only on Axis TX) #1151
- Added idle cutoff (Currently only on Axis TX) #1151
TFT/OLED Menu
- Added menu page system to change settings (Based on Axis PR) #1151
- Added 5-way joystick support to navigate the menu #1151
- Added TFT screen support #1151
Better Web Interface
- Adds firmware.bin to web UI for quick downloading of firmware to prevent having to build firmware in the field if you want to flash another receiver #1151
- Regulatory domain added to the web interface for easy reference #1200
Misc
- Even more mega megabaudrates (up to 5250000 baud!) #1174
- Regulatory domain appears in the lua (whoops on removing that from 1.x!) #1200
- Fan now has a delay to spin up and spin down (no more fan going to 100% when your dynamic power spikes up) #1255
- Better RSSI calculation, taking RSNR into account #1258
- Many, many optimizations #507 #1169
Bug fixes
- Fix Nonce Slip causing Telem Lost/Recovered Messages #1288
- Dynamic Power Enhancement #1286
- Fixed Team900 STM32-based TX without EEPROM bug #1271
- Fixed Bad packets reported by TX (ESP32 TX’s) #1265
- Fixed LED colors on BetaFPV #1264
- Lots of Optimizations #1266, #1269 and more
Hardware Targets
2.4GHz
- Axis Thor TX #1151
- Axis Thor RX #1151
- NamimnoRC Flash ESP Diversity RX #1074
- iFlight 2400TX & RX #1106
- BetaFPV 2.4 Micro 1000mW #1202
915-868MHz
- iFlight 900TX & RX #1106
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.0.1
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- Be sure to flash both the TX and RX as the 1.x and 2.x protocols are incompatible.
- Update to elrsV2.lua even if you have previously updated with a release candidate.
- Users of SPI receivers (AIO boards) must update Betaflight. Updated firmware is available on the pull request. betaflight/betaflight#10788
Enhancements
NA
Bug fixes
- Fix custom startup melodies #1171
- Python Build Compatibility issue. #1173
- Update Lua Device Names #1189
- Fix BETAFPV Micro TX 915Mhz #1178 #1198
- Fix BF Lua #1201
New Hardware Targets
2.4GHz
NA
915-868MHz
NA
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.0.0
Getting Started 2.0 Documentation
The important stuff
- Arming state must be HIGH on AUX1 for safety and feature reasons
- Be sure to flash both the TX and RX as the 1.x and 2.x protocols are incompatible.
- Update to elrsV2.lua even if you have previously updated with a release candidate.
- Users of SPI receivers (AIO boards) must update Betaflight. Updated firmware is available on the pull request. betaflight/betaflight#10788
Enhancements
Lua Awesomeness
- Change all the things! Lua has been completely rewritten from the ground up to be dynamic based on the transmitter's target and include many new configurable options. Be sure to update to ElrsV2.lua as the old version will no longer work at all. #620
- Many configuration items are now stored per-model. Using the "CRSF Receiver Number" in EdgeTX/OpenTX you can create multiple models on the radio for different purposes. #765
ENABLE_TELEMETRY
is no longer determined at compile time, and will be enabled when Telemetry is received from the flight controller automatically.- Model Match. Don't want to fly your quad with your fixed wing settings by mistake? Enable Model Match to be sure the receiver will only work with a specific model ID. See Model Match for more details.
- Show other devices (Flight Controllers and Receiver) in ELRS Lua script + allow editing of device parameters #977 #1021 #997
Switch 128 new ways
- Added Wide switch mode. Wide switch mode allows up to 128 position AUX channels (7-bit switches), and includes sending TX power to the flight controller. See Switch Config #821
- Removed 1-bit switch mode.
- Switch mode is no longer determined at compile time and is set by Lua (must be disconnected from the receiver to change this setting).
Improved Sync Behavior
- Syncing behavior has been improved in a number of ways for faster initial connection and more reliable reconnection after failsafe as well as being objectively more fun.
- Sync channel has been moved to the middle of the band to hit the antenna sweet spot #797
- Sync packets are sent up to 800% more frequently when "disconnected", and 20% less frequently when "connected", which creates more opportunities for the receiver to establish a connection.
NO_SYNC_ON_ARM
users are unaffected. #784 - The FHSS cycle duration of 25Hz (Team900) and 50Hz (Team2.4) has been halved to double the effective chance of connecting and speed up rate cycling on startup.
- The sync slot now rotates through all available FHSS slots to guarantee a sync packet will resolve any "nonce slip" (getting stuck at 75/50/25 LQ)
- Tired of "RecEIver still connected" when trying to turn off your handset? Disconnect timeout on the TX is now based on the current rate and telemetry ratio #785
- Fixed a bug where we would spend a large portion of the sync period without the radio in receive mode making it difficult to sync on faster rates. #1128
Fly without going outside
- Like to play SIMs? Now you can turn your ELRS module into a bluetooth joystick with the click of a button. In Lua V2 you will find the BLE Joystick option (only ESP32 based modules). #815
Dynamic Power
- The Lua now optionally sets the maximum power output and the output power can be reduced using the link telemetry (requires TLM Ratio to not be Off) Can be overridden with a switch. See Dynamic Transmit Power #762 #724 #812
- The power level where the fan is activated is also configurable via Lua to allow baking of brownies with your TX module.
- Add 250mW power option for SIYI FM30/FR Mini #841
VTx Administrator
- The V2 LUA script now has a folder called VTx Administrator. Here you can set your VTx band, channel, power, and pitmode. Pressing the Send button then forwards this information to the FC and onto the VTx and works with both SmartAudio and Tramp protocols. This information is also automatically sent when a new TLM connection is made e.g. when you plug in your craft. To use this feature, setup the FC VTx settings using the standard 48 index table. Power levels refer to the power index set by the FC. Also works with iNav's fixed function pipeline. #804
Backpack Support
- Backpacks are additional ESP8285 chips you will find on TX modules such as the Happymodel and NamimnoRC range. They allow for communication to peripheral devices such as VRx modules. What does this mean? When you make a VTx frequency change via the VTx Administrator this change will also be sent to the VRx module. The perfect use case is when setting up at a race event. You can set your VTx channel/band while in the pits, and then on power up at the block your VTx and VRx are automatically configured. Flashing of Backpacks is now supported by the ELRS Configurator. Backpack GitHub
Home WiFi
- Store your home WiFi credentials so your TX and RX can automatically connect to your home network when doing updates. No mucking about with access points and phones that don’t allow upload in captive portal mode! The WiFi manager will automatically fall back to creating an access point if the home network can not be found. #527
- Configurator can auto-detect ELRS devices on your network so you can directly upgrade them without even selecting the target type, which is great because Windows support for mDNS can be hit or miss.
- A connected receiver can now be forced into wifi mode using the Lua "Wifi Connectivity -> Enable Rx Wifi" command. The default
AUTO_WIFI_ON_INTERVAL
has been increased to 60 seconds due to this easy way to end the delay manually. - A progress bar was added to the webui’s flashing process. What’s happening? Progress!
Telemetry Improvements
- Telemetry Boost automatically enables a TLM Ratio of 1:2 when doing MSP configuration via the Betaflight Lua or VTx Administrator, even if TLM Ratio is Off #786
- ActiveAntenna added to linkstats telemetry #725
- iNav Vario sensor added #977
- Added support for KISS Lua script #977
- Added support for yaapu telemetry script: thank you yaapu for the good cooperation to implement and tune this feature. #977
Pretty Things for your crotch
- Basic OLED support has been added with status information, to be expanded in future releases. #739
- For those devices with an RGB LED there is a nice unicorn rainbow startup and the LED shows different colors, flashing and fade in/out for different information. #585
- Both RGB and monochrome LED status have been unified across the RX and TX for a consistent experience. LED Status
Gotta go fast
- In addition to the current 115200 and 400k bauds available in your handsets Hardware menu, there are now MEGA BAUDS 921600, 1870000, and 3750000 options with ELRS V2 and EdgeTX 2.5. The faster bauds allow for a further reduction in end to end latency (~0.5ms per end) and improved Lua operation. The use of higher bauds depends on the TX module MCU, handset, and quality of inverters. STM32 based TX modules such as FrSky and NamimnoRC V1 will be limited to 1870000, while ESP32 based TX modules (all other ELRS modules) will be able to run 3750000 if supported by the handset hardware. #864 #640
- Gotta go slow: The RX now supports arbitrary baud rates for compatibility instead of the standard 420000 baud. KISS needs 400000, or an Arduino can be connected at 115200.
See what you're working with
- Accurate version number displayed in the webui (tag/branch and hash) along with the target name lets you know that flash worked.
- Lua displays tag/branch and hash as well, no more confused complaints about wtf version
010200
means. - Target name is also verified before flashing, so CapnBry will stop flashing his X with Y firmware.
Direct PWM output
- Support for PWM servo output has been added with the PWMP target, for both DIY designs (5-6 channel) or the Matek ELRS-R24-P (5 channel).
Misc
- Adds IRegulatory_Domain_IN_866 Domain #683
- Regulatory_Domain_ISM_2400 has been removed from user_defines and is automatically used when building Team2.4 targets.
- Diversity switching has been improved by switching more quickly instead of being stuck on the bad antenna for too long.
Bug fixes
- NA… we squashed all those in V1! sweat-nervous.gif
New Hardware Targets
2.4GHz
- SIYI FR Mini RX as TX #746
- DIY_2400_RX_PWMP #998
- MATEK_2400_RX_PWM #1069
- BetaFPV 2400 Micro #1038
- Namimno Flash OLED #1032
- Happymodel Slim Pro renamed to Pro Series
915-868MHz
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme.
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes
ExpressLRS V2.0.0 Release Candidate 4
https://www.expresslrs.org/2.0/quick-start/getting-started/
Changes since 2.0.0-RC3
- correct elrs logo (#1135)
- Abort current telem receive if about to commit (#1127)
- Lua: Allow changing a value when it is set to ERR (#1131)
- R9M using wrong Idle method and EEPROM speedup (#1133)
- Move all sendLinkStatisticsToFC() to one place (#1128)
- Increase STM32 emulated EEPROM commit delay (#1143)
- Stop resetting MSP state to force sends (RX not going to wifi via Lua) (#1145)
- Display 10 second "Flashing" progress bar on webui (#1146)
- Fix RGB LED being GRB on HM ES24TX Pro Series (#1148)
- Add guard around DEVICE_NAME for common headers (#1147)
The important stuff
- Arming must be on AUX1 for safety and feature reasons, having this fixed allows us to maintain small packet sizes and deliver better aux channel options
- Be sure to flash both the TX and RX
- LUA script MUST be updated for V2 and is not backwards compatible with 1.x. Get it here: LUA
- Users of SPI receivers (AIO boards) must not update until ELRS SPI 2.0 is available, as the protocols are incompatible.
- This is a RELEASE CANDIDATE, and is not guaranteed to be stable or bug free. Test at your own risk! Bad things might happen!
- The user notes below are a concise version of the new features and fixes. Once the final release has been cut, these will be expanded to explain each feature in detail. For now, testers are expected to research within the relevant pull request links, and be prepared to use documentation that is not yet complete
Enhancements
Improved Connection (and disconnect notification)
Dynamic Power and Fan Thresholds
Wide Switch Mode (64/128 pos switches)
Per-Model Configuration & Model Match
- See https://www.expresslrs.org/2.0/software/model-config-match/ for more details
- #765
Bluetooth Joystick
LUA Awesomeness
VTx Administrator
Backpack Support
Home WiFi
Telemetry Boost
ActiveAntenna added to Telemetry
OLED
Can haz RGB (and unified RGB code)
- See https://www.expresslrs.org/2.0/quick-start/led-status/ for details.
- #585
Add 250mW power option for FM30/FR Mini
Adds IRegulatory_Domain_IN_866 Domain
Regulatory_Domain_ISM_2400 removed from user_defines
iNav VARIO Sensor added
Added support for KISS lua script
Added support for yaapu telemetry script: thank you yaapu for the good cooperation to implement and tune this feature
Show other devices (FC and RX) in ELRS lua script + allow editing of device parameters
MEGA Baud Rates
Telemetry always enabled
Switchmode no longer hard coded
Accurate version number and target name shown
- Both the webui and Lua report version number and hash
- And verify firmware target before flashing
New Hardware Targets:
2.4GHz
- SIYI FR Mini RX as TX #746
- DIY_2400_RX_PWMP #998
- MATEK_2400_RX_PWM #1069
- BetaFPV 2400 Micro #1038
- Namimno Flash OLED #1032
- Happymodel Slim Pro renamed to Pro Series
915-868MHz
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme. https://semver.org/
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes)](https://www.expresslrs.org/2.0/quick-start/getting-started/
ExpressLRS V2.0.0 Release Candidate 3
https://www.expresslrs.org/2.0/quick-start/getting-started/
Changes since 2.0.0-RC2
- Minor Lua fixes following RC2 (#1100)
- Perform shell escaping on build args (#1101)
- Only rebuild HTML header if changed (#1109)
- Double blue copy paste bug (#1112)
- Move all build git queries to one function (#1115)
- Lock FM30 TX antenna to left (#1117)
- Don't abort if we're asking the user! (#1118)
- Start dynamic power low instead of high (#1113)
- Add an option to disable all the beeps (#1098)
- Stop DEBUG_CRSF_NO_OUTPUT sending MSP (#1119)
The important stuff
- Arming must be on AUX1 for safety and feature reasons, having this fixed allows us to maintain small packet sizes and deliver better aux channel options
- Be sure to flash both the TX and RX
- LUA script MUST be updated for V2 and is not backwards compatible with 1.x. Get it here: LUA
- Users of SPI receivers (AIO boards) must not update until ELRS SPI 2.0 is available, as the protocols are incompatible.
- This is a RELEASE CANDIDATE, and is not guaranteed to be stable or bug free. Test at your own risk! Bad things might happen!
- The user notes below are a concise version of the new features and fixes. Once the final release has been cut, these will be expanded to explain each feature in detail. For now, testers are expected to research within the relevant pull request links, and be prepared to use documentation that is not yet complete
Enhancements
Improved Connection (and disconnect notification)
Dynamic Power and Fan Thresholds
Wide Switch Mode (64/128 pos switches)
Per-Model Configuration & Model Match
- See https://www.expresslrs.org/2.0/software/model-config-match/ for more details
- #765
Bluetooth Joystick
LUA Awesomeness
VTx Administrator
Backpack Support
Home WiFi
Telemetry Boost
ActiveAntenna added to Telemetry
OLED
Can haz RGB (and unified RGB code)
- See https://www.expresslrs.org/2.0/quick-start/led-status/ for details.
- #585
Add 250mW power option for FM30/FR Mini
Adds IRegulatory_Domain_IN_866 Domain
Regulatory_Domain_ISM_2400 removed from user_defines
iNav VARIO Sensor added
Added support for KISS lua script
Added support for yaapu telemetry script: thank you yaapu for the good cooperation to implement and tune this feature
Show other devices (FC and RX) in ELRS lua script + allow editing of device parameters
MEGA Baud Rates
Telemetry always enabled
Switchmode no longer hard coded
Accurate version number and target name shown
- Both the webui and Lua report version number and hash
- And verify firmware target before flashing
New Hardware Targets:
2.4GHz
- SIYI FR Mini RX as TX #746
- DIY_2400_RX_PWMP #998
- MATEK_2400_RX_PWM #1069
- BetaFPV 2400 Micro #1038
- Namimno Flash OLED #1032
- Happymodel Slim Pro renamed to Pro Series
915-868MHz
A note on versioning
The versioning scheme chosen by the ExpressLRS devs is based on the semantic versioning scheme. https://semver.org/
Where a version is defined as “major.minor.patch”
major = major new feature and/or incompatible changes
minor = minor features or enhancements and/or new targets
patch = bug-fixes)](https://www.expresslrs.org/2.0/quick-start/getting-started/