Struct RadioConfig 

pub struct RadioConfig {
    pub frequency_hz: u32,
    pub band_hz: (u32, u32),
    pub link: LinkSettings,
    pub power: TxPower,
    pub ramp: RampTime,
    pub sync_word: SyncWord,
    pub invert_iq_transmit: bool,
    pub invert_iq_receive: bool,
}

What a radio sends and listens with: the carrier, the LoRa link, the power, and the sync word and IQ polarity that keep one network apart from another.

Examples

use pamoja_lora::LinkSettings;
use pamoja_radios::sx126x::config::{PowerAmplifier, SyncWord, TxPower};
use pamoja_radios::sx126x::RadioConfig;

// A LoRaWAN device on 868.1 MHz at SF9, calibrated for the whole 863 to 870 MHz band.
let config = RadioConfig::new(
    868_100_000,
    LinkSettings::new(9, 125_000),
    TxPower::for_output(PowerAmplifier::HighPower, 14),
)
.with_band(863_000_000, 870_000_000)
.lorawan_device();
assert_eq!(config.sync_word, SyncWord::Public);
assert!(config.invert_iq_receive && !config.invert_iq_transmit);

Fields

frequency_hz: u32

The carrier frequency in hertz.

band_hz: (u32, u32)

The band image calibration covers, as its lower and upper edges in hertz.

link: LinkSettings

The spreading factor, bandwidth, coding rate, preamble, header, and CRC.

power: TxPower

The amplifier configuration and power setting.

ramp: RampTime

How fast the amplifier ramps up.

sync_word: SyncWord

The sync word written to the registers at 0x0740.

invert_iq_transmit: bool

Whether frames go out with inverted IQ, as a LoRaWAN gateway sends downlinks.

invert_iq_receive: bool

Whether the receiver expects inverted IQ, as a LoRaWAN device hears downlinks.

Implementations

impl RadioConfig

pub const fn new( frequency_hz: u32, link: LinkSettings, power: TxPower, ) -> RadioConfig

Builds a configuration with a private sync word and standard IQ both ways.

Image calibration covers just the carrier, and the amplifier ramps in 40 us, the time Semtech’s LoRaMac-node reference passes to SetTxParams.

Arguments

• frequency_hz - the carrier frequency in hertz.
• link - the LoRa link settings.
• power - the amplifier configuration and power setting.

Returns

The configuration.

pub const fn with_band(self, low_hz: u32, high_hz: u32) -> RadioConfig

Returns the configuration with image calibration covering a whole band, so moving between channels inside it needs no new calibration.

Arguments

• low_hz - the lower edge of the band in hertz.
• high_hz - the upper edge of the band in hertz.

Returns

The configuration.

pub const fn with_sync_word(self, sync_word: SyncWord) -> RadioConfig

Returns the configuration with another sync word.

Arguments

• sync_word - the sync word.

Returns

The configuration.

pub const fn with_ramp(self, ramp: RampTime) -> RadioConfig

Returns the configuration with another amplifier ramp time.

Arguments

• ramp - the ramp time.

Returns

The configuration.

pub const fn with_inverted_iq( self, transmit: bool, receive: bool, ) -> RadioConfig

Returns the configuration with the IQ polarity set for each direction.

Arguments

• transmit - true to send with inverted IQ.
• receive - true to listen for inverted IQ.

Returns

The configuration.

pub const fn lorawan_device(self) -> RadioConfig

Returns the configuration a LoRaWAN end device uses: the public sync word, uplinks with standard IQ, and downlinks heard with inverted IQ.

Returns

The configuration.

Trait Implementations

impl Clone for RadioConfig

fn clone(&self) -> RadioConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RadioConfig

impl Debug for RadioConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RadioConfig

impl PartialEq for RadioConfig

fn eq(&self, other: &RadioConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RadioConfig