Skip to main content

Module lora

Module lora 

Source
Expand description

The C ABI for LoRa link math.

These functions wrap [pamoja_lora] for callers that reach the SDK through the flat C boundary: the time a transmission spends on air, and the silence a duty-cycle limit then forces. Both are what a long-range node needs to stay inside its regional budget, and both are pure arithmetic.

A link is only scalars, so it crosses by value as PamojaLoraLink rather than as a handle, which keeps the whole capability free of allocation.

Structs§

PamojaLoraLink
The radio settings of a LoRa link.
PamojaLoraLinkBudget
The gains and losses of a LoRa link, from the transmitting radio to the receiving one.

Functions§

pamoja_lora_airtime_us
Returns the time on air of a payload, in microseconds.
pamoja_lora_demodulator_snr_centi_db
Returns the signal-to-noise ratio the LoRa demodulator needs at a spreading factor.
pamoja_lora_fcc_digital_max_conducted_centi_dbm
Returns the most conducted power 47 CFR 15.247 allows a digitally modulated 902-928 MHz transmitter through an antenna.
pamoja_lora_fcc_hopping_max_conducted_centi_dbm
Returns the most conducted power 47 CFR 15.247 allows a 902-928 MHz frequency hopping transmitter through an antenna.
pamoja_lora_free_space_loss_centi_db
Returns the free-space basic transmission loss between isotropic antennas.
pamoja_lora_fresnel_radius_mm
Returns the radius of the first Fresnel ellipsoid at a point on a path.
pamoja_lora_link_budget_default
Returns a link budget of 0 dBm between isotropic antennas with no cable loss.
pamoja_lora_link_budget_eirp_centi_dbm
Returns the equivalent isotropically radiated power of a budget.
pamoja_lora_link_budget_margin_centi_db
Returns how far above the sensitivity a signal arrives across a path.
pamoja_lora_link_budget_max_path_loss_centi_db
Returns the most path loss a link survives.
pamoja_lora_link_budget_max_transmit_power_centi_dbm
Returns the most transmit power that keeps the EIRP of a budget at or under a ceiling.
pamoja_lora_link_budget_received_centi_dbm
Returns the power that reaches the receiving radio across a path.
pamoja_lora_link_budget_sensitivity_centi_dbm
Returns the weakest signal the receiver of a budget can demodulate on a link.
pamoja_lora_link_default
Returns the settings for a spreading factor and bandwidth, with LoRa defaults.
pamoja_lora_low_data_rate_optimization
Reports whether a link uses low data rate optimization.
pamoja_lora_messages_per_hour
Returns how many transmissions of a payload fit in an hour under a duty-cycle limit.
pamoja_lora_min_off_time_us
Returns the minimum silence after a transmission to honor a duty-cycle limit.
pamoja_lora_noise_floor_centi_dbm
Returns the thermal noise power in a channel.
pamoja_lora_symbol_time_us
Returns the duration of one symbol on a link, in microseconds.