From bb7244695371a3a895f354d6e36f20e64c5626aa Mon Sep 17 00:00:00 2001 From: "Jose Carmelo O. Almadrones" Date: Fri, 6 Sep 2024 09:17:47 +0800 Subject: [PATCH 1/4] Lua Script Updates --- docs/quick-start/transmitters/lua-howto.md | 32 +++++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/docs/quick-start/transmitters/lua-howto.md b/docs/quick-start/transmitters/lua-howto.md index 702d83e46..18faeae1b 100644 --- a/docs/quick-start/transmitters/lua-howto.md +++ b/docs/quick-start/transmitters/lua-howto.md @@ -188,6 +188,14 @@ Available Options: * Alternate between the two Antennas. +### Link Mode + +Introduced in 3.5.0, `Link Mode` changes the main protocol and function of the TX module. + +* `Normal` - This is the default configuration. The TX module simply sends the commands from the radio handset, and receive telemetry from the receiver and send it to the handset. + +* `MAVLink` - This option enables native MAVLink Telemetry downlink and Radio Control uplink making the TX module and radio handset to be an intermediary between a GCS and a MAVLink-capable craft. See the [MAVLink](../../software/mavlink.md) page for more details. + ### Model Match ExpressLRS supports multiple configuration profiles, and the configuration profile is selected by setting the "Receiver ID" property in the Radio Handset's Model Setup -> Internal/External RF -> Receiver (number). @@ -352,9 +360,27 @@ The `Protocol` setting controls the output of the connected receiver. The follow * `SUMD` - Lets the receiver output Graupner HoTT SUMD signal for use with devices that don't support CRSF protocol, like Stabilizers, Heli Controllers etc. * `DJI RS2 Pro` - Mainly used for the RS2 Pro Gimbals * `HoTT Telemetry` - Allows to use Graupner HoTT enabled telemetry sensors (Graupner and 3rd party) +* `MAVLINK` - Introduced on ExpressLRS 3.5.0, it allows the receiver to output native MAVLink into a flight controller. See the [MAVLink](../../software/mavlink.md) page for more details. For more information, see [Receiver Serial Protocols](../../software/serial-protocols.md) +### Protocol 2 + +The `Protocol 2` option is only available for ESP32-based receivers. This include the True Diversity ones like the RP4TD, Super D, Super P and EP Dual. This option is available on ExpressLRS 3.5.0 and onwards. This option is used to set the protocol for the second UART connection for the receiver. + +It has the same options as the previous parameter above with these additional ones: + +* `Tramp` - If you want to control a VTX using Tramp protocol directly through the ExpressLRS Lua Script's VTX Admin. +* `SmartAudio` - If you want to control a VTX using SmartAudio protocol directly through the ExpressLRS Lua Script's VTX Admin. +* `Off` - Set when the auxiliary UART is not in use. + +### SBUS failsafe + +`SBUS Failsafe` is used to set the behavior of a receiver using SBUS protocol for output. The following options are available: + +* `No Pulses` - When a failsafe occurs, the receiver will stop sending any messages. +* `Last Pos` - When a failsafe occurs, the receiver will keep sending the last channel positions it received. + ### Antenna Mode The `Antenna Mode` setting is only available for Receivers with Antenna Diversity. These options are available: @@ -390,7 +416,7 @@ Team Racing allows selection between multiple connected models, failsafing all u These commands allow the user to Loan/Return the model. For more information, see the [Loan Model](../../software/loan-model.md) guide. -This is deprecated and removed in ExpressLRS 3.4.0 in favor of the new Binding Procedures. See the [binding](../binding.md) page for details. +This is deprecated and removed in ExpressLRS 3.4.0 in favor of the new Binding Procedures. See the [binding](../binding.md) page for details or the **Bind Storage** section below. ### Output Mapping @@ -414,6 +440,8 @@ For more information, see [PWM Receivers](../../hardware/pwm-receivers.md) page. This option is available on ExpressLRS 3.4.0 and newer. See the details [here](https://github.com/ExpressLRS/ExpressLRS/pull/2542). +* `Returnable` - Introduced in ExpressLRS 3.5.0. It is used to allow models to be safely loaned from a fleet if unbound OTA. A Binding Phrase must be set for this to work properly. see [PR 2744](https://github.com/ExpressLRS/ExpressLRS/pull/2744) for details. + ### Enter Bind Mode command This will put the receiver into Bind Mode. It works even if the receiver is already flashed with a binding phrase or already bound traditionally. @@ -432,6 +460,8 @@ This line shows the currently set Model ID for the receiver when Model Matching * For fixed wings, we recommend using `100Hz Full Res`, together with either `Std` or your choice of Telemetry Ratio. Switch Mode will depend greatly on how many full resolution channels you intend to use. +* For Long Range applications, see the [Long Range Records](../../info/long-range.md) page and try the settings the pilots used to achieve the range. It is not guaranteed you'll achieve the same range as they are due to several factors like RF Noise in your area, your location and position and the antenna orientation on your aircraft and transmitter modules. Observe local laws and regulations. + ## Troubleshooting the Lua Script ### ExpressLRS Lua Script is stuck at `Loading...` From 8a022454291aa13e2a0b93254a229153f5f86f03 Mon Sep 17 00:00:00 2001 From: "Jose Carmelo O. Almadrones" Date: Fri, 6 Sep 2024 09:29:08 +0800 Subject: [PATCH 2/4] SmartAudio added to wordlist --- .wordlist.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.wordlist.txt b/.wordlist.txt index 85de0129d..d142e0b25 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -249,6 +249,7 @@ SkyZone Skystars Slickshot SmartPort +SmartAudio Spektrum SteadyView Stefanski From f45d4b0e6578a7cb226241238d9cde9bcc658de4 Mon Sep 17 00:00:00 2001 From: "Jose Carmelo O. Almadrones" Date: Fri, 6 Sep 2024 09:39:25 +0800 Subject: [PATCH 3/4] Rewording on Protocol 2 --- docs/quick-start/transmitters/lua-howto.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/quick-start/transmitters/lua-howto.md b/docs/quick-start/transmitters/lua-howto.md index 18faeae1b..69de613ac 100644 --- a/docs/quick-start/transmitters/lua-howto.md +++ b/docs/quick-start/transmitters/lua-howto.md @@ -366,14 +366,16 @@ For more information, see [Receiver Serial Protocols](../../software/serial-prot ### Protocol 2 -The `Protocol 2` option is only available for ESP32-based receivers. This include the True Diversity ones like the RP4TD, Super D, Super P and EP Dual. This option is available on ExpressLRS 3.5.0 and onwards. This option is used to set the protocol for the second UART connection for the receiver. +The `Protocol 2` setting is only available for ESP32-based receivers. This include the True Diversity ones like the RP4TD, Super D, Super P and EP Dual. These receivers have a second UART that can be used for the same purpose as the main UART. Note that not all of the ESP32-based receivers have the extra uart pads or pins exposed for easy use. -It has the same options as the previous parameter above with these additional ones: +It has the same options as the setting above with these additional ones: * `Tramp` - If you want to control a VTX using Tramp protocol directly through the ExpressLRS Lua Script's VTX Admin. * `SmartAudio` - If you want to control a VTX using SmartAudio protocol directly through the ExpressLRS Lua Script's VTX Admin. * `Off` - Set when the auxiliary UART is not in use. +This setting is available on ExpressLRS 3.5.0 and onwards. See [PR 2605](https://github.com/ExpressLRS/ExpressLRS/pull/2605) for more details. + ### SBUS failsafe `SBUS Failsafe` is used to set the behavior of a receiver using SBUS protocol for output. The following options are available: From 9c61bc8b00d5b73e79b0e047b85244c26f9a604e Mon Sep 17 00:00:00 2001 From: "Jose Carmelo O. Almadrones" Date: Fri, 6 Sep 2024 09:41:34 +0800 Subject: [PATCH 4/4] Corrections for Spellcheck --- docs/quick-start/transmitters/lua-howto.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/quick-start/transmitters/lua-howto.md b/docs/quick-start/transmitters/lua-howto.md index 69de613ac..f30a12bae 100644 --- a/docs/quick-start/transmitters/lua-howto.md +++ b/docs/quick-start/transmitters/lua-howto.md @@ -366,7 +366,7 @@ For more information, see [Receiver Serial Protocols](../../software/serial-prot ### Protocol 2 -The `Protocol 2` setting is only available for ESP32-based receivers. This include the True Diversity ones like the RP4TD, Super D, Super P and EP Dual. These receivers have a second UART that can be used for the same purpose as the main UART. Note that not all of the ESP32-based receivers have the extra uart pads or pins exposed for easy use. +The `Protocol 2` setting is only available for ESP32-based receivers. This include the True Diversity ones like the RP4TD, Super D, Super P and EP Dual. These receivers have a second UART that can be used for the same purpose as the main UART. Note that not all of the ESP32-based receivers have the extra UART pads or pins exposed for easy use. It has the same options as the setting above with these additional ones: