How olliw42/mlrs works
mLRS is embedded firmware for a bidirectional LoRa radio link combining remote-control channels with serial data, including MAVLink/MSP-focused capabilities. A typical workflow carries radio input through transmitter firmware, over the RF link, and through receiver firmware to an autopilot or serial device; data also travels in the reverse direction. The README documents protocol, configuration, diversity, and GCS options. Sampled board entry points call main_main(), but the shared runtime implementations were not sampled, so internal flow beyond those calls is kept conservative.
Main entry points: CommonTx TX runtime · Common LoRa RF link · Src/main.cpp TX board entry · Src/main.cpp RX board entry
Components 19
Transmitter firmware
- TX board entry
mLRS/tx-R9M-f103c8/Core/Src/main.cpp - TX runtime
mLRS/CommonTx - Input interfaces
mLRS/CommonTx/in.h - TX setup
mLRS/CommonTx/setup_tx.h
Radio link
- LoRa RF link
mLRS/Common - Semtech drivers
mLRS/Common/sx-drivers - ARQ and diversity
mLRS/Common/arq.h
Receiver firmware
- RX board entry
mLRS/rx-R9M-f103c8/Core/Src/main.cpp - RX runtime
mLRS/CommonRx - Output interfaces
mLRS/CommonRx/out.h
Protocols and configuration
- MAVLink support
mLRS/CommonTx/mavlink_interface_tx.h - MSP support
mLRS/CommonTx/msp_interface_tx.h - CRSF support
mLRS/CommonTx/crsf_interface_tx.h - Wireless bridges
mLRS/CommonTx/esp-wifi-bridge.h - Remote parameters
mLRS/CommonRx - CLI and display
mLRS/CommonTx
Other components
- Pilot radio
- Autopilot / serial device
- Ground station
Connections 18
- Pilot radio → TX board entry: provides control
- TX board entry → TX runtime: calls main_main
mLRS/tx-R9M-f103c8/Core/Src/main.cpp - TX runtime → Input interfaces: accepts input
- TX runtime → LoRa RF link: transmits link data
- LoRa RF link → RX board entry: delivers RF
- RX board entry → RX runtime: calls main_main
- RX runtime → Output interfaces: routes output
- Output interfaces → Autopilot / serial device: provides serial data
- LoRa RF link → Semtech drivers: supports chip drivers
- LoRa RF link → ARQ and diversity: supports retransmission
- TX runtime → TX setup: uses settings
- TX runtime → MAVLink support: supports MAVLink
- TX runtime → MSP support: supports MSP
- TX runtime → CRSF support: supports CRSF
- TX runtime → Wireless bridges: supports wireless GCS
- TX runtime → CLI and display: offers configuration
- TX runtime → Remote parameters: sets receiver parameters
- Ground station → Wireless bridges: connects wirelessly