Abschnitte der Dokumentation

LoRa-Linkbudget-Rechner — Empfindlichkeit, Sendezeit (Time on Air) und Reichweite

POSThttps://rftools.io/api/py/v1/calculate

Slug lora-link-budget. LoRa-Linkbudget nach den Formeln des Semtech SX1276: Empfängerempfindlichkeit nach Spreizfaktor und Bandbreite, Symboldauer, Sendezeit (Time on Air) mit automatischer Low-Data-Rate-Optimierung, Sendepause nach Duty-Cycle, Freiraum- oder Okumura–Hata-Pfadverlust, Linkreserve und maximale Reichweite.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von lora-link-budget
Name	Einheit	Bereich	Standardwert	Beschreibung
spreadingFactorZahl	keine	6 … 12	9	Chips pro Symbol sind 2^SF; jede Stufe höher bringt etwa 2,5 dB Empfindlichkeit und verdoppelt die Sendezeit
bandwidthZahl	kHz	mindestens 7.8	125	LoRa-Signalbandbreite; 125 kHz in den meisten LoRaWAN-Kanälen
codingRateZahl	keine	1 … 4	1	Vorwärtsfehlerkorrektur: vier Datenbits in fünf bis acht codierten BitsEiner von: 1 4/5 · 2 4/6 · 3 4/7 · 4 4/8
payloadLengthZahl	bytes	1 … 255	20	Bytes in der LoRa-Nutzlast, 1 bis 255 (ein LoRaWAN-Frame fügt den Anwendungsdaten 13 Byte Overhead hinzu)
preambleLengthZahl	symbols	mindestens 0	8	Programmierte Präambelsymbole; 8 bei LoRaWAN
implicitHeaderZahl	keine	0 … 1	0	Header-ModusEiner von: 0 Expliziter Header · 1 Impliziter Header
crcZahl	keine	0 … 1	1	Nutzlast-CRCEiner von: 1 CRC an · 0 CRC aus
noiseFigureZahl	dB	mindestens 0	6	Etwa 6 dB für einen SX127x mit höchster LNA-Verstärkung
txPowerZahl	dBm	beliebig	14	14 dBm ist die übliche EU-Grenze bei 868 MHz; 20 dBm mit PA_BOOST
txGainZahl	dBi	beliebig	2.15	Gewinn der Sendeantenne
rxGainZahl	dBi	beliebig	5	Gewinn der Empfangsantenne
lossesZahl	dB	mindestens 0	2	Kabel- und sonstige Verluste
frequencyZahl	MHz	mindestens 1	868	Frequenz
pathLossModelZahl	keine	0 … 5	1	Freiraum oder Okumura–Hata für eine städtische, vorstädtische oder ländliche StreckeEiner von: 0 Freiraum · 1 Okumura–Hata, Stadt (klein/mittelgroß) · 2 Okumura–Hata, Großstadt · 3 Okumura–Hata, Vorort · 4 Okumura–Hata, ländlich, quasi-offen · 5 Okumura–Hata, ländlich, offen
distanceZahl	km	mindestens 0.001	2	Entfernung
baseHeightZahl	m	mindestens 1	30	Wird von Okumura–Hata verwendet, das 30 bis 200 m abdeckt
mobileHeightZahl	m	mindestens 0.1	1.5	Wird von Okumura–Hata verwendet, das 1 bis 10 m abdeckt
dutyCycleZahl	%	0.001 … 100	1	Zeitanteil, in dem ein Gerät senden darf; 1 % im EU-Subband 868,0–868,6 MHz (ETSI EN 300 220-2)
extraLossCountZahl	keine	0 … 6	0	Wie viele weitere Verluste die Strecke enthält, etwa Gebäudedurchdringung, Bewuchs, Körper oder Polarisationsfehlanpassung (0–6)
extraLoss1Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss2Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss3Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss4Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss5Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss6Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von lora-link-budget
Feld	Einheit	Beschreibung
linkMarginHauptwert	dB	Linkreserve
sensitivity	dBm	Empfängerempfindlichkeit
receivedPower	dBm	Empfangsleistung
pathLoss	dB	Pfadverlust
maxRange	km	Maximale Reichweite
timeOnAir	ms	Sendezeit (Time on Air)
symbolTime	ms	Symboldauer
payloadSymbols	keine	Nutzlastsymbole
lowDataRateOptimize	keine	Low-Data-Rate-Optimierung (1 = an)
bitRate	bit/s	Äquivalente Bitrate
offTime	s	Minimale Sendepause nach jedem Paket
packetsPerHour	keine	Pakete pro Stunde im Duty-Cycle
totalLoss	dB	Gesamtverlust

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "lora-link-budget",
    "inputs": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("lora-link-budget", {
    "spreadingFactor": 9,
    "bandwidth": 125,
    "codingRate": 1,
    "payloadLength": 20,
    "preambleLength": 8,
    "implicitHeader": 0,
    "crc": 1,
    "noiseFigure": 6,
    "txPower": 14,
    "txGain": 2.15,
    "rxGain": 5,
    "losses": 2,
    "frequency": 868,
    "pathLossModel": 1,
    "distance": 2,
    "baseHeight": 30,
    "mobileHeight": 1.5,
    "dutyCycle": 1,
    "extraLossCount": 0,
    "extraLoss1": 0,
    "extraLoss2": 0,
    "extraLoss3": 0,
    "extraLoss4": 0,
    "extraLoss5": 0,
    "extraLoss6": 0,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "lora-link-budget",
    "inputs": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "lora-link-budget",
	  "inputs": {
	    "spreadingFactor": 9,
	    "bandwidth": 125,
	    "codingRate": 1,
	    "payloadLength": 20,
	    "preambleLength": 8,
	    "implicitHeader": 0,
	    "crc": 1,
	    "noiseFigure": 6,
	    "txPower": 14,
	    "txGain": 2.15,
	    "rxGain": 5,
	    "losses": 2,
	    "frequency": 868,
	    "pathLossModel": 1,
	    "distance": 2,
	    "baseHeight": 30,
	    "mobileHeight": 1.5,
	    "dutyCycle": 1,
	    "extraLossCount": 0,
	    "extraLoss1": 0,
	    "extraLoss2": 0,
	    "extraLoss3": 0,
	    "extraLoss4": 0,
	    "extraLoss5": 0,
	    "extraLoss6": 0
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "slug": "lora-link-budget",
  "values": {
    "linkMargin": 12.058955385826835,
    "sensitivity": -129.50608706414752,
    "receivedPower": -117.44713167832069,
    "pathLoss": 136.5971316783207,
    "maxRange": 4.399184913581315,
    "timeOnAir": 185.344,
    "symbolTime": 4.096,
    "payloadSymbols": 33,
    "lowDataRateOptimize": 0,
    "bitRate": 1757.8125,
    "offTime": 18.349055999999997,
    "packetsPerHour": 194.23342541436466,
    "totalLoss": 138.5971316783207
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:lora-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Semtech SX1276/77/78/79 datasheet Rev. 4 (2015), Table 13, §4.1.1.5–4.1.1.7; Semtech AN1200.13 Rev. 1 (2013), Eqn. 1; Hata (1980); ITU-R P.525-4",
    "assumptions": [
      {
        "code": "sx1276-snr-limits",
        "text": "Sensitivity uses the SX1276/77/78/79 demodulator SNR limits by spreading factor and the noise figure entered; another LoRa radio may differ by a dB or two."
      },
      {
        "code": "automatic-ldro",
        "text": "Low-data-rate optimisation is switched on exactly when the symbol time exceeds 16 ms, as the datasheet mandates."
      },
      {
        "code": "median-path-loss",
        "text": "Path loss is the free-space or Okumura–Hata median, with no fade margin; the link margin is what is left for fading."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "spreadingFactor": {
          "min": 6,
          "max": 12,
          "unit": ""
        },
        "bandwidth": {
          "min": 7.8,
          "max": null,
          "unit": "kHz"
        },
        "codingRate": {
          "min": 1,
          "max": 4,
          "unit": ""
        },
        "payloadLength": {
          "min": 1,
          "max": 255,
          "unit": "bytes"
        },
        "preambleLength": {
          "min": 0,
          "max": null,
          "unit": "symbols"
        },
        "implicitHeader": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "crc": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "noiseFigure": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "txPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "txGain": {
          "min": null,
          "max": null,
          "unit": "dBi"
        },
        "rxGain": {
          "min": null,
          "max": null,
          "unit": "dBi"
        },
        "losses": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "frequency": {
          "min": 1,
          "max": null,
          "unit": "MHz"
        },
        "pathLossModel": {
          "min": 0,
          "max": 5,
          "unit": ""
        },
        "distance": {
          "min": 0.001,
          "max": null,
          "unit": "km"
        },
        "baseHeight": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "mobileHeight": {
          "min": 0.1,
          "max": null,
          "unit": "m"
        },
        "dutyCycle": {
          "min": 0.001,
          "max": 100,
          "unit": "%"
        },
        "extraLossCount": {
          "min": 0,
          "max": 6,
          "unit": ""
        },
        "extraLoss1": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss2": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss3": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss4": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss5": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss6": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "spreadingFactor"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteLoRa-Linkbudget-Rechner — Empfindlichkeit, Sendezeit (Time on Air) und Reichweite, mit diesen Werten