This page describes how to set up a mLRS system for EdgeTX/OpenTX radios, so you get CRSF telemetry sensors and can use the Yaapu telemetry app.
Three steps need to be completed:
- The radio needs to be setup for the CRSF protocol.
- The mLRS Tx module needs to be put into "CRSF mode".
- The flight controller needs to be set up to send a MAVLink stream with the desired MAVLink messages.
Optional but recommended steps:
- Install the mLRS Lua script on the radio to configure parameters: Lua Script.
- Set the receiver into "MAVLink mode" (described below).
- Install the Yaapu app (described below).
The mLRS default parameter settings follow the below recommendations. That is, with a freshly flashed mLRS Tx module and receiver all you need to do is to set up your radio and flight controller!
Notes:
- Any radio which supports the CRSF protocol should work, this should include many brands besides EdgeTX/OpenTX radios.
- An ArduPilot flight controller is assumed. PX4 and INAV needs to be tested and validated.
In EdgeTX/OpenTX, navigate to MDL->MODEL SETUP and configure the external RF module for CRSF protocol with 400K baud rate.
Note: mLRS only supports 400K baud rate.
Set the following parameters using the CLI or Lua script (or OLED if available):
- Tx Ch Source = crsf
- Tx Ser Baudrate:
- 115200 for 19 Hz, 31 Hz, 50 Hz, FSK
- 230400 for FLRC (115200 also works)
- Tx Ser Dest = serial or serial2 (not mbridge!)
- Tx Snd RadioStat = on
Note: Tx Ser Baudrate should be larger than the link data rate in order to provide enough capacity (e.g., in the 50 Hz mode the link data rate is 4100 Bytes/sec and the baudrate should thus be larger than 41000), but otherwise the choice is not critical and largely determined by the user's need. The default value is 115200, which is appropriate for all LoRa modes (50 Hz, 31 Hz, 19 Hz)(and also FSK).
The mLRS default settings are Tx Ch Source = crsf, Tx Ser Baudrate = 115200, Tx Ser Dest = serial, Tx Snd RadioStat = on.
A basic setup is described in this section which should get one started, further ArduPilot information is available here: ArduPilot Systems.
Generally, the baud rate setting is not critical, as mLRS will gracefully work with them all. However, parameter download depends somewhat on your ArduPilot firmware version.
- SERIALx_BAUD:
- 115 (= 115200) for 50 Hz, FSK
- 57 (= 57600) for 31 Hz
- 38 (= 38400) for 19 Hz (57 works very well too, only parameter download is slower with ArduPilot 4.5)
- 230 (= 230400) for FLRC
- SERIALx_PROTOCOL = 2 (important, do not use MAVLink v1!)
- SERIALx_OPTIONS = 4096 (ignore commands from GCS to change stream rates)
Note: 'x' refers to the serial port of your flight controller used for connecting with the mLRS receiver's serial port.
Generally, the stream rate settings are not critical, as mLRS will gracefully adjust them when needed. Suggested settings are:
| 50 Hz | 31 Hz | 19 Hz | FLRC | |
|---|---|---|---|---|
| SRy_ADSB | 0 | 0 | 0 | 0 |
| SRy_EXT_STAT | 2 | 2 | 1 | 4 |
| SRy_EXTRA1 | 4 | 4 | 4 | 8 |
| SRy_EXTRA2 | 4 | 4 | 4 | 8 |
| SRy_EXTRA3 | 2 | 2 | 1 | 4 |
| SRy_PARAMS | 50 | 50 | 50 | 50 |
| SRy_POSITION | 2 | 2 | 2 | 4 |
| SRy_RAW_CTRL | 0 | 0 | 0 | 0 |
| SRy_RAW_SENS | 0 | 0 | 0 | 0 |
| SRy_RC_CHAN | 1 | 1 | 1 | 2 |
Note: When configuring SRy parameters, 'y' does not necessarily correspond to the number 'x' of the SERIALx port but to the count of serial ports using the MAVLink protocol. SERIAL0, and thus SR0, will nearly always be reserved for the USB connection and set to use the MAVLink protocol (which should not be modified). Therefore, as an example, in a setup with SERIAL1 and SERIAL2 not set to the MAVLink and with the mLRS receiver connected to SERIAL3, then SR1 should be used to configured the stream rates for the mLRS receiver.
- RC_PROTOCOLS = 536 or 512
- RSSI_TYPE = 3 or 5
- SERIALx_BAUD = irrelevant (baud rate is determined by ArduPilot)
- SERIALx_OPTIONS = 0
- SERIALx_PROTOCOL = 23
Note: 'x' refers to the serial port of your flight controller used for CRSF.
If these settings do not work, more details are available on the ArduPilot Systems page.
Set the following parameters using the CLI or Lua script (or OLED if available):
- Rx Out Mode = crsf
- Rx Ser Baudrate = must match the baudrate of the flight controller's serial port (see SERIALx_BAUD in the above)
- Rx Ser Link Mode = mavlinkX (this sets the receiver into "MAVLink mode")
- Rx Snd RadioStat= ardu_1
The mLRS default settings are Rx Out Mode = crsf, Rx Ser Baudrate = 57600, Rx Ser Link Mode = mavlinkX, Rx Snd RadioStat= ardu_1.
In EdgeTX/OpenTX go to MDL->TELEMETRY and select "Discover new sensors". You should see sensors appearing; mLRS currently provides 28 sensors (CRSF Sensors).
Install the Yaapu app exactly as described in its wiki. Note: You need to install the dev version, the stable release version will not work. You need to enable the CRSF support: Start the "Yaapu Config" script in SYS->TOOLS, and set "enable CRSF support: yes" (then repower the radio). You can check if all is good by running the "Yaapu Debug CRSF" script in SYS->TOOLS.
