Skip to content
Merged
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions docs/software/mavlink.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ To start using MAVLink, you just need one ESP based ELRS transmitter, and one ES
!!! note "NOTE: Internal TX modules"
If you are using an internal TX module (e.g. a TX16S with internal ELRS), you will be required to use the TX Backpack to connect to you GCS via WiFi (USB cable between the TX and the PC is not an option for internal modules). See WiFi Connectivity below.

## Flashing and Configuring ELRS for MAVLink
## Flashing ELRS for MAVLink

Ensure both your transmitter module, the embedded TX-Backpack (if using WiFi forwarding), and your receiver are up to date with the latest release versions:

Expand All @@ -57,16 +57,18 @@ The minimum versions to use this feature are:
- Transmitter / receiver firmware: `3.5.0`
- TX Backpack firmware: `1.5.0`

1. Using the guides above, flash both the RX and TX
## Configuring ELRS TX & RX for MAVLink

1. Turn on both the RX and TX, and ensure they connect properly
1. Turn on both the RX and TX, and ensure they connect properly.

1. In ELRS LUA script, select `Other Devices`, select your receiver, and set the `serial protocol` to `MAVLink`. This configures the RX to output MAVLink protocol on the UART.

1. Back out to the LUA scripts main menu, and select the `Link Mode` option. Change it from `Normal` to `MAVLink`. This configures the TX module to send / receive MAVLink.
1. For ELRS v3, In ELRS LUA script, select `Other Devices`, select your receiver, and set the `serial protocol` to `MAVLink`. This configures the RX to output MAVLink protocol on the UART. For ELRS v4 RX protocol is now configured automatically when changing the TX mode to MAVLink.
1. First turn off your receiver, link mode cannot be changed when connected. In the main menu select the `Link Mode` option. Change it from `Normal` to `MAVLink`. This configures the TX module to send / receive MAVLink.

1. Configure your usual power, packet rate, etc. The telemetry ratio will be preset to 1:2 (and cannot be changed while in MAVLink mode).

1. Power on your receiver and verify it connects properly to the transmitter.

1. Wire the RX to a free UART on your flight controller that is suitable for TLM + RC. A DMA-capable UART is recommended.

## Flight Controller Setup
Expand Down Expand Up @@ -113,7 +115,7 @@ Once your flight controller and ExpressLRS hardware are configured for MAVLink,

ELRS converts the MAVLink telemetry into standard CRSF format which is understood by EdgeTX. On the Telemetry page in EdgeTX, click "Discover new" to see GPS, battery stats, flight mode, etc.

Yaapu LUA script does not work with ELRS MAVLink in `v3.x.x` but support is coming in `v4.x.x`.
Yaapu LUA script does not work with ELRS MAVLink in `v3.x.x` but is supported in `v4.x.x`.

## Connecting to the Ground Control Station

Expand Down Expand Up @@ -351,4 +353,4 @@ When using WiFi forwarding through the TX Backpack, the Backpack tracks addition
- **Dropped packets**: Number of messages with sequence number gaps (indicates RF link issues)
- **Buffer overflows**: Number of times the 16-message buffer filled up (indicates too much telemetry for available bandwidth)

These statistics help diagnose performance issues.
These statistics help diagnose performance issues.