MAVLINKHUD

Overview

The BRD_RADIO parameter group configures the Internal Radio found on certain flight controllers (e.g., SkyViper or boards with integrated SiK/ExpressLRS hardware).

Unlike external radios connected via UART, these are directly managed by the board's HAL (Hardware Abstraction Layer).

Key Concepts

1. Transmit Power (BRD_RADIO_TXPOW)

Sets the output power of the integrated radio module.

  • Safety: Ensure compliance with local RF regulations (e.g., 20dBm / 100mW).

2. Stick Mode (BRD_RADIO_STKMD)

Defines the mapping of the transmitter sticks (Mode 1, Mode 2, etc.) for integrated controllers.

Developer Notes

  • Library: libraries/AP_Radio.
  • Context: Primarily used for RTF (Ready-To-Fly) consumer-grade hardware running ArduPilot.

BRD_RADIO_ABLVL

Default 0
Range 0 31

Auto-bind level (BRD_RADIO_ABLVL)

Description

Security threshold for auto-binding. Higher values require the transmitter to be very close to the receiver during the auto-bind process, preventing accidental binding to other transmitters nearby.

BRD_RADIO_ABTIME

s
Default 0
Range 0 120

Auto-bind time (BRD_RADIO_ABTIME)

Description

Configures the timeout period of inactivity after which the receiver will automatically enter "binding" mode to search for a new transmitter.

  • A value of 0 disables auto-bind.

BRD_RADIO_BZOFS

Default 25
Range 0 40

Transmitter buzzer adjustment (BRD_RADIO_BZOFS)

Description

Fine-tunes the audio frequency (pitch) of the transmitter's internal buzzer.

BRD_RADIO_DEBUG

Default 0
Range 0 4

Radio debug level (BRD_RADIO_DEBUG)

Description

Sets the verbosity of radio-specific debug information sent to the serial console.

BRD_RADIO_DISCRC

Default 0
Range 0 1

Disable receive CRC (BRD_RADIO_DISCRC)

Description

Disables the Cyclical Redundancy Check (CRC) for incoming radio packets.

  • WARNING: Should only be used for debugging. Disabling CRC allows corrupted data to be processed as valid commands.

BRD_RADIO_FCCTST

Default 0
Range 0 6

FCC test mode (BRD_RADIO_FCCTST)

Description

Puts the internal radio into a specialized continuous-transmit state required for regulatory certification.

  • WARNING: The radio will not process RC inputs while in this mode.

BRD_RADIO_PPSCH

Default 0
Range 0 16

Packet rate channel (BRD_RADIO_PPSCH)

Description

Maps the Packet-Per-Second (PPS) rate to a virtual RC channel.

BRD_RADIO_PROT

Default 0

Radio Protocol (BRD_RADIO_PROT)

Description

Selects the specific transmission protocol for the direct-attached radio.

Tuning & Behavior

  • Default Value: 0 (Auto)
  • Values: 0:Auto, 1:DSM2, 2:DSMX

BRD_RADIO_SIGCH

Default 0
Range 0 16

RSSI signal strength channel (BRD_RADIO_SIGCH)

Description

Maps the RSSI (Signal Strength) value to a virtual RC channel, allowing it to be monitored by the GCS or used in other logic.

BRD_RADIO_STKMD

Default 2
Range 1 2

Stick input mode (BRD_RADIO_STKMD)

Description

Configures the transmitter stick mapping. Mode 2 (throttle on left) is standard in most regions.

Tuning & Behavior

  • Default Value: 2 (Mode 2)
  • Values: 1:Mode1, 2:Mode2

BRD_RADIO_TELEM

Default 0
Range 0 1

Enable telemetry (BRD_RADIO_TELEM)

Description

Enables bidirectional telemetry communication over the internal radio link.

BRD_RADIO_TESTCH

Default 0
Range 0 8

Factory test channel (BRD_RADIO_TESTCH)

Description

Overrides the normal frequency-hopping behavior to lock the radio onto a specific channel for production testing.

BRD_RADIO_TPPSCH

Default 0
Range 0 16

Telemetry PPS channel (BRD_RADIO_TPPSCH)

Description

Maps the telemetry Packet-Per-Second (PPS) rate measured by the transmitter to a virtual RC channel.

BRD_RADIO_TSIGCH

Default 0
Range 0 16

Telemetry RSSI value channel (BRD_RADIO_TSIGCH)

Description

Maps the telemetry signal strength (RSSI) measured by the transmitter back to a virtual RC channel.

BRD_RADIO_TXMAX

Default 8
Range 1 8

Transmitter maximum transmit power (BRD_RADIO_TXMAX)

Description

Sets the upper limit for the radio's transmission power.

BRD_RADIO_TXPOW

Default 8
Range 1 8

Telemetry Transmit power (BRD_RADIO_TXPOW)

Description

Sets the transmission power level for telemetry data sent back to the transmitter.

BRD_RADIO_TYPE

Default 0

Radio type (BRD_RADIO_TYPE)

Description

Enables support for built-in or direct-attached radio receivers (e.g., on SkyViper vehicles).

Tuning & Behavior

  • Default Value: 0 (None)
  • Values: 0:None, 1:CYRF6936, 2:CC2500, 3:BK2425
  • Requires reboot to take effect.