You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/quick-start/pre-1stflight.md
+24Lines changed: 24 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -86,6 +86,30 @@ On the 900MHz hardware, a value of -20dBm or thereabouts is a good indication yo
86
86
- Most DIY modules require moving the 0-ohm resistor on the E28 from the PCB antenna side towards the UFL side. A solder bridge will work just fine as well, but make sure it is on the correct pads.
87
87
- Swap out antennas on the receiver and/or the TX module; Most ExpressLRS receiver antennas use IPEX 1/UFL connectors and as long as the frequency tuning of the antenna is appropriate for the frequency you're in, it should work. You can also use old 2.4GHz WiFi Router antennas for your 2.4GHz modules, but avoid those that are dual-band. Also, make sure that the connector on the antenna is the appropriate one (RP-SMA on R9 modules; SMA on most off-the-shelf ExpressLRS modules)
88
88
89
+
## RC Link Preset (BETAFLIGHT ONLY)
90
+
For flight controllers based on Betaflight, there are 'RC Link Presets' available that configure feedforward smoothing and associated link settings based on your packet rate and usage case.
91
+
92
+
!!! Warning
93
+
Using no link preset, or using the incorrect one for your packet rate, can result in unwanted noise and jitter in feedforward, which can affect setpoint tracking and thus flight characteristics.
94
+
95
+
To install the correct 'RC Link Preset', follow these steps in **Betaflight Configurator**:
96
+
97
+
1. Select the **Preset** tab
98
+
1. In the preset tab, select **Save Backup** and save a backup to a safe location before applying any preset.
99
+
1. Search for 'ExpressLRS' and select the Link Preset that matches your [Packet Rate](../transmitters/lua-howto.md#packet-rate-and-telemetry-ratio). If no direct match is available, choose the closest preset below your packet rate.
1. Read through the options by selecting the dropdown list. NOTE: These are all optional, if none of them apply to your circumstances, it is OK to leave everything unticked.
Blackbox is handy for evaluating the performance of the RF link for a flight. Set your BB to debug mode `RC_SMOOTHING_RATE`, which will capture the rate that Betaflight is receiving RC Packets from the RX.
Copy file name to clipboardExpand all lines: docs/quick-start/receivers/configuring-fc.md
-24Lines changed: 0 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -66,30 +66,6 @@ The CRSF Protocol requires a full UART pair, uninverted and in full-duplex mode.
66
66
-`serialrx_halfduplex` should be **OFF**; configure it with `set serialrx_halfduplex = off`.
67
67
- Don't forget to use `save` once you're done setting these up.
68
68
69
-
## RC Link Preset (BETAFLIGHT ONLY)
70
-
For flight controllers based on Betaflight, there are 'RC Link Presets' available that configure feedforward smoothing and associated link settings based on your packet rate and usage case.
71
-
72
-
!!! Warning
73
-
Using no link preset, or using the incorrect one for your packet rate, can result in unwanted noise and jitter in feedforward, which can affect setpoint tracking and thus flight characteristics.
74
-
75
-
To install the correct 'RC Link Preset', follow these steps in **Betaflight Configurator**:
76
-
77
-
1. Select the **Preset** tab
78
-
1. In the preset tab, select **Save Backup** and save a backup to a safe location before applying any preset.
79
-
1. Search for 'ExpressLRS' and select the Link Preset that matches your [Packet Rate](../transmitters/lua-howto.md#packet-rate-and-telemetry-ratio). If no direct match is available, choose the closest preset below your packet rate.
1. Read through the options by selecting the dropdown list. NOTE: These are all optional, if none of them apply to your circumstances, it is OK to leave everything unticked.
Close your Flight Controller Configurator once you've set it up for ExpressLRS. Keeping it open could prevent the next steps from completing properly, particularly flashing via Passthrough. You must also unplug the FC from USB before proceeding to the next steps to refresh the connection.
Copy file name to clipboardExpand all lines: docs/quick-start/transmitters/lua-howto.md
+28-3Lines changed: 28 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,14 +7,22 @@ description: Here is a simple ExpressLRS Lua Script guide explaining the differe
7
7
8
8
## Installing the Lua Script
9
9
10
-
Download the [ELRS v3 Lua Script](https://github.com/ExpressLRS/ExpressLRS/blob/3.x.x-maintenance/src/lua/elrsV3.lua?raw=true) (you can simply right-click, save-as) into your radio's SD Card under the `Scripts/Tools` folder.
10
+
Download the [ExpressLRS Lua Script](https://github.com/ExpressLRS/ExpressLRS/blob/master/src/lua/elrs.lua?raw=true) (you can simply right-click, save-as) into your radio's SD Card under the `Scripts/Tools` folder.
11
+
12
+
!!! note "ExpressLRS 4.0"
13
+
Starting with ExpressLRS 4.0, the ExpressLRS Lua Script will once again go back to just using `elrs.lua` and will no longer be tied to a specific firmware version.
11
14
12
15
<figuremarkdown>
13
16

14
17
</figure>
15
18
19
+
## Running the Lua Script
20
+
16
21
Access the script by navigating to your radio's System Menu.
17
22
23
+
!!! note "EdgeTX 3.0 Update"
24
+
EdgeTX 3.0 will bring changes into how colored-screen radios are navigated. Please refer to EdgeTX user manual for these changes.
25
+
18
26
1. Press the ++"SYS"++ Key on your Radio.
19
27
- Older Radios or those with only one Menu Key will need to long-press the ++context-menu++ Key to access the System Menu.
20
28
- Consult your Radio User's Manual on how to access the System Menu.
@@ -39,8 +47,9 @@ Access the script by navigating to your radio's System Menu.
39
47
40
48
As of 3.3.0:
41
49
42
-
- 500Hz or faster packet rates require >400K Baudrate.
43
-
- 333Hz is the fastest packet rate you can use with 400K Baudrate.
50
+
- 333Hz or faster packet rates require >400K Baudrate for external ELRS modules.
51
+
- 250Hz is the fastest packet rate you can use with 400K Baudrate on external modules.
52
+
- Best to stick to the fastest baudrate your radio can handle. See the [Baud Rate](tx-prep.md#serial-baud-rate) table.
44
53
45
54
## Understanding and Using the Lua Script
46
55
@@ -114,6 +123,20 @@ Items with `>` before the name is a folder that when selected shows another leve
114
123
115
124
These items will now show what is currently set for the items within. An example would be on `TX Power`, which will show the current Power set, and if Dynamic Power is enabled, it will show the current set Max Power, followed by the indicator `Dyn`.
116
125
126
+
### RF Band
127
+
128
+
This option is only available for RF modules capable of Dual-Band operation.
129
+
130
+
The following options will be available:
131
+
132
+
- X-Band
133
+
134
+
* Gemini X-Band (Crossband) or GemX mode; Simultaneous operation in 900MHz and 2.4GHz Band. Available only to modules with Dual LR1121 RF chips like the Nomad, Internal GX12 GemX module, Bayck Dual-Band Gemini External modules, etc. Will only sync or connect with GemX-capable receivers like the XR4, DBR4, GEPRC Gemini Xrossband, Bayck Dual Band, etc.
135
+
136
+
- 2.4GHz
137
+
138
+
- 900MHz
139
+
117
140
### Packet Rate and Telemetry Ratio
118
141
119
142
<figuremarkdown>
@@ -194,6 +217,7 @@ Available Options:
194
217
!!! warning "WARNING"
195
218
When using a Gemini TX with a non-Gemini receiver, you should set the TX in either Switch or Single Antenna (Ant1/Ant2) Mode.
196
219
The reason is that as the receiver only get the signal from the TX it has synchronized with, the other TX will act as a noise generator and increase both the noise floor and power consumption.
220
+
X-Band or X modes will now lock this to Gemini or if it detects the Receiver isn't capable of Gemini Mode, it will be set to `Switch` starting with ExpressLRS 4.0.
197
221
198
222
### Link Mode
199
223
@@ -366,6 +390,7 @@ The `Protocol` setting controls the output of the connected receiver. The follow
366
390
*`Inverted SBUS` - Like the above, but inverted.
367
391
*`SUMD` - Lets the receiver output Graupner HoTT SUMD signal for use with devices that don't support CRSF protocol, like Stabilizers, Heli Controllers etc.
368
392
*`DJI RS2 Pro` - Mainly used for the RS2 Pro Gimbals
393
+
*`DisplayPort` - For controlling (primarily) DJI Air units to take them out of Low Power mode. New in ExpressLRS 4.0.
369
394
*`HoTT Telemetry` - Allows to use Graupner HoTT enabled telemetry sensors (Graupner and 3rd party)
370
395
*`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.
0 commit comments