Crate lora_modulation

lora-modulation

A minimal crate for providing LoRa modulation characteristics of:

• Bandwidth
• Spreading factor
• Coding rate

Provides utility for calculating time on air.

Usage

use lora_modulation::{BaseBandModulationParams, SpreadingFactor, Bandwidth, CodingRate};

let length = 12;
let params = BaseBandModulationParams::new(SpreadingFactor::_9, Bandwidth::_125KHz, CodingRate::_4_5);
let time_on_air = params.time_on_air_us(
    Some(8), // preamble
    true,    // explicit header
    length); // length of payload

// Time on air is 144.384 ms
assert_eq!(time_on_air, 144384);

use lora_modulation::{BaseBandModulationParams, SpreadingFactor, Bandwidth, CodingRate};

let symbols = 14;
let params = BaseBandModulationParams::new(SpreadingFactor::_12, Bandwidth::_125KHz, CodingRate::_4_5);
let timeout = params.symbols_to_ms(symbols);

// Timeout is 458 ms
assert_eq!(timeout, 458);

Structs

BaseBandModulationParams

LoRa modulation parameters barring frequency

Enums

Bandwidth

Channel width. Lower values increase time on air, but may be able to find clear frequencies.

CodingRate

Controls the forward error correction. Higher values are more robust, but reduces the ratio of actual data in transmissions.

SpreadingFactor

Controls the chirp rate. Lower values are slower bandwidth (longer time on air), but more robust.