Skip to content

Commit d3199da

Browse files
authored
Merge pull request #498 from deadbytefpv/db4xUpdates
Some general updates, including initial 4.x updates
2 parents a5608ad + a137c86 commit d3199da

6 files changed

Lines changed: 125 additions & 58 deletions

File tree

.wordlist.txt

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Axisflying
1515
BETAFPV
1616
BLE
1717
BLHeli
18+
Bayck
1819
Bardwell
1920
Baudrate
2021
BetaFPV
@@ -47,6 +48,7 @@ CrazyF
4748
Crossband
4849
CubeProgrammer
4950
Cura
51+
DBR
5052
DFU
5153
DIY
5254
DJI
@@ -95,6 +97,7 @@ FW
9597
Failsafe
9698
Flite
9799
FlySky
100+
FlySky's
98101
Flybarless
99102
Flywoo
100103
Foxeer
@@ -110,6 +113,7 @@ GND
110113
GPIO
111114
GSoD
112115
Graupner
116+
GX
113117
HD
114118
HDZero
115119
HGLRC
@@ -145,6 +149,7 @@ LQI
145149
LiPo
146150
LinkStatistics
147151
LinkStats
152+
LinkFlow
148153
LoRa
149154
Lua
150155
MAVLink
@@ -161,6 +166,7 @@ Malagoli
161166
Matek
162167
MatekSys
163168
Microbeast
169+
MK
164170
Mobula
165171
ModelMatch
166172
Multicopter
@@ -227,12 +233,14 @@ Remarketing
227233
Repartitioner
228234
Repo
229235
Rox
236+
Runcam
230237
SBUS
231238
SD
232239
SDG
233240
SDR
234241
SG
235242
SIYI
243+
Sirius
236244
SMA
237245
SMD
238246
SNR
@@ -249,6 +257,8 @@ SWCLK
249257
SWDIO
250258
SX
251259
SYS
260+
sync
261+
sync'd
252262
Saad
253263
Schottky
254264
Seba
@@ -308,13 +318,16 @@ Velocidrone
308318
Vergara
309319
Voigt
310320
V16
321+
V14
311322
Walksnail
312323
WebSocket
324+
Webflasher
313325
WebUI
314326
Wifi
315327
Wirelessly
316328
XO
317329
XT
330+
XR
318331
Yagin
319332
Yarillo
320333
YeOldePirate
@@ -553,3 +566,4 @@ unambiguously
553566
injunctive
554567
counsel
555568
Rotorflight
569+
X-Band

docs/quick-start/installing-configurator.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,8 @@ description: The ExpressLRS Configurator has made improvements on ExpressLRS acc
88
There are two ways to build and flash ExpressLRS:
99

1010
1. [ExpressLRS Configurator](https://github.com/ExpressLRS/ExpressLRS-Configurator/releases) (**Recommended**)
11-
2. [Development toolchain setup](../software/toolchain-install.md) (For advanced users)
11+
2. [Web Flasher](https://expresslrs.github.io/web-flasher/)
12+
3. [Development toolchain setup](../software/toolchain-install.md) (For advanced users)
1213

1314
## Configurator Setup
1415

docs/quick-start/pre-1stflight.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,30 @@ On the 900MHz hardware, a value of -20dBm or thereabouts is a good indication yo
8686
- 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.
8787
- 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)
8888

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.
100+
101+
![Presets Home](../../assets/images/preset_home.png)
102+
103+
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.
104+
105+
1. Select 'Pick' to stage the preset:
106+
107+
![Presets Pick](../../assets/images/preset_pick.png)
108+
109+
1. Select **Save and Reboot** to apply the preset:
110+
111+
![Presets Save](../../assets/images/preset_save.png)
112+
89113
## Blackbox
90114

91115
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.

docs/quick-start/receivers/configuring-fc.md

Lines changed: 0 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -66,30 +66,6 @@ The CRSF Protocol requires a full UART pair, uninverted and in full-duplex mode.
6666
- `serialrx_halfduplex` should be **OFF**; configure it with `set serialrx_halfduplex = off`.
6767
- Don't forget to use `save` once you're done setting these up.
6868

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.
80-
81-
![Presets Home](../../assets/images/preset_home.png)
82-
83-
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.
84-
85-
1. Select 'Pick' to stage the preset:
86-
87-
![Presets Pick](../../assets/images/preset_pick.png)
88-
89-
1. Select **Save and Reboot** to apply the preset:
90-
91-
![Presets Save](../../assets/images/preset_save.png)
92-
9369
!!! important
9470
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.
9571

docs/quick-start/transmitters/lua-howto.md

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,22 @@ description: Here is a simple ExpressLRS Lua Script guide explaining the differe
77

88
## Installing the Lua Script
99

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.
1114

1215
<figure markdown>
1316
![Lua Folder](../../assets/images/LuaFolder.jpg)
1417
</figure>
1518

19+
## Running the Lua Script
20+
1621
Access the script by navigating to your radio's System Menu.
1722

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+
1826
1. Press the ++"SYS"++ Key on your Radio.
1927
- Older Radios or those with only one Menu Key will need to long-press the ++context-menu++ Key to access the System Menu.
2028
- 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.
3947

4048
As of 3.3.0:
4149

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.
4453

4554
## Understanding and Using the Lua Script
4655

@@ -114,6 +123,20 @@ Items with `>` before the name is a folder that when selected shows another leve
114123

115124
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`.
116125

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+
117140
### Packet Rate and Telemetry Ratio
118141

119142
<figure markdown>
@@ -194,6 +217,7 @@ Available Options:
194217
!!! warning "WARNING"
195218
When using a Gemini TX with a non-Gemini receiver, you should set the TX in either Switch or Single Antenna (Ant1/Ant2) Mode.
196219
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.
197221

198222
### Link Mode
199223

@@ -366,6 +390,7 @@ The `Protocol` setting controls the output of the connected receiver. The follow
366390
* `Inverted SBUS` - Like the above, but inverted.
367391
* `SUMD` - Lets the receiver output Graupner HoTT SUMD signal for use with devices that don't support CRSF protocol, like Stabilizers, Heli Controllers etc.
368392
* `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.
369394
* `HoTT Telemetry` - Allows to use Graupner HoTT enabled telemetry sensors (Graupner and 3rd party)
370395
* `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.
371396

0 commit comments

Comments
 (0)