lora-calc

A Python library for calculating LoRa (Long Range) wireless transmission parameters. Compute symbol times, airtime, throughput, and link budgets based on LoRa configuration settings.

Installation

pip install lora-calc

Or with Poetry:

poetry add lora-calc

Usage

from lora_calc import LoRaCalculator

# Create a calculator with your LoRa parameters
calc = LoRaCalculator(
    tx_power=20,              # Transmit power in dBm (-14 to 20)
    payload_len=125,          # Payload length in bytes (0-255)
    preamble_len=8,           # Preamble length in symbols (6-65535)
    spreading_factor=10,      # SF6-SF12
    bandwidth=125,            # 62.5, 125, 250, or 500 kHz
    coding_rate=5,            # 5, 6, 7, or 8 (representing 4/5, 4/6, 4/7, 4/8)
    crc=True,                 # Enable CRC
    explicit_header=True,     # Use explicit header mode
    low_data_rate_opt=True,   # Low data rate optimization
)

# Get transmission parameters
print(f"Symbol time: {calc.symbol_time} ms")
print(f"Symbol rate: {calc.symbol_rate} symbols/sec")
print(f"Preamble duration: {calc.t_preamble} ms")
print(f"Payload duration: {calc.t_payload} ms")
print(f"Total airtime: {calc.t_total} ms")
print(f"Throughput: {calc.throughput} bps")
print(f"Effective data rate: {calc.effective_data_rate} bps")
print(f"Link budget: {calc.link_budget} dB")

Parameters

Calculated Properties

References

• SX1276 Data Sheet
• LoRa Theory
• Official LoRa Calculator

Other LoRa Calculator Implementations

• lora-air-time
• lorawan_toa
• airtime-calculator