Abschnitte der Dokumentation

RF Link Margenrechner

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

Slug link-margin. Berechnen Sie die HF-Verbindungsmarge aus TX-Leistung, Antennenverstärkung, Pfadverlust und Empfängerempfindlichkeit. Ermitteln Sie die maximale Reichweite und den Überblendungsrand für drahtlose Verbindungen. Kostenlose, sofortige Ergebnisse.

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 link-margin
Name	Einheit	Bereich	Standardwert	Beschreibung
txPowerZahl	dBm	−30 … 60	20	Ausgangsleistung des Senders
txGainZahl	dBi	−10 … 50	3	Antennengewinn in dBi übertragen
rxGainZahl	dBi	−10 … 50	3	Antennengewinn in dBi empfangen
distanceZahl	km	mindestens 0.001	1	Abstand zwischen Sender und Empfänger
frequencyZahl	GHz	mindestens 0.001	2.4	Betriebsfrequenz in GHz
sensitivityZahl	dBm	−150 … 0	-90	Minimale Empfindlichkeit des Empfängers aus dem Datenblatt
cableLossZahl	dB	mindestens 0	1	Summe der Kabel- und Steckerverluste auf TX- und RX-Seite
extraLossCountZahl	keine	0 … 4	0	Wie viele zusätzliche Verlustbedingungen sind im Budget enthalten, z. B. Polarisationsstörungen, Körperverlust oder Laub
extraLoss1Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss2Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss3Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
extraLoss4Zahl	dB	0 … 50	0	Ein zusätzlicher Verlust auf dem Weg, z. B. Polarisationsfehlanpassung, Körperverlust, Laub oder eine Wand
targetMarginZahl	dB	0 … 60	10	Der Fade-Rand, den die Verbindung einhalten muss, muss über der Empfindlichkeit des Empfängers liegen. Der Status wird an oder über diesem Wert weitergegeben und fällt unter 0 dB aus.

Ausgaben

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

Ausgaben von link-margin
Feld	Einheit	Beschreibung
fspl	dB	Verlust des Pfads im freien Speicherplatz
receivedPower	dBm	Empfangene Leistung
linkMarginHauptwert	dB	Link-Rand
maxRange	km	Maximale Reichweite

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": "link-margin",
    "inputs": {
      "txPower": 20,
      "txGain": 3,
      "rxGain": 3,
      "distance": 1,
      "frequency": 2.4,
      "sensitivity": -90,
      "cableLoss": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "targetMargin": 10
    }
  }'

import rftools

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

result = client.calculate("link-margin", {
    "txPower": 20,
    "txGain": 3,
    "rxGain": 3,
    "distance": 1,
    "frequency": 2.4,
    "sensitivity": -90,
    "cableLoss": 1,
    "extraLossCount": 0,
    "extraLoss1": 0,
    "extraLoss2": 0,
    "extraLoss3": 0,
    "extraLoss4": 0,
    "targetMargin": 10,
})
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": "link-margin",
    "inputs": {
      "txPower": 20,
      "txGain": 3,
      "rxGain": 3,
      "distance": 1,
      "frequency": 2.4,
      "sensitivity": -90,
      "cableLoss": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "targetMargin": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "link-margin",
	  "inputs": {
	    "txPower": 20,
	    "txGain": 3,
	    "rxGain": 3,
	    "distance": 1,
	    "frequency": 2.4,
	    "sensitivity": -90,
	    "cableLoss": 1,
	    "extraLossCount": 0,
	    "extraLoss1": 0,
	    "extraLoss2": 0,
	    "extraLoss3": 0,
	    "extraLoss4": 0,
	    "targetMargin": 10
	  }
	}`)
	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": "link-margin",
  "values": {
    "fspl": 100.05200805611548,
    "receivedPower": -75.05200805611548,
    "linkMargin": 14.947991943884517,
    "maxRange": 5.589842832887214
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:link-margin",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "ITU-R P.525-4, Calculation of free-space attenuation",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "txPower": {
          "min": -30,
          "max": 60,
          "unit": "dBm"
        },
        "txGain": {
          "min": -10,
          "max": 50,
          "unit": "dBi"
        },
        "rxGain": {
          "min": -10,
          "max": 50,
          "unit": "dBi"
        },
        "distance": {
          "min": 0.001,
          "max": null,
          "unit": "km"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "sensitivity": {
          "min": -150,
          "max": 0,
          "unit": "dBm"
        },
        "cableLoss": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "extraLossCount": {
          "min": 0,
          "max": 4,
          "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"
        },
        "targetMargin": {
          "min": 0,
          "max": 60,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "txPower": 20,
      "txGain": 3,
      "rxGain": 3,
      "distance": 1,
      "frequency": 2.4,
      "sensitivity": -90,
      "cableLoss": 1,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "targetMargin": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "txPower"
      ],
      "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 RechnerseiteRF Link Margenrechner, mit diesen Werten