Abschnitte der Dokumentation

BLE-Linkbudget- und Reichweitenrechner — Bluetooth Low Energy nach PHY

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

Slug ble-link-budget. Bluetooth-Low-Energy-Linkbudget nach PHY: Datenrate und Empfängerempfindlichkeit laut Core-Spezifikation für LE 1M, LE 2M und LE Coded, Pfadverlust im Freiraum oder nach dem Indoor-Modell ITU-R P.1238, Empfangsleistung, 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 ble-link-budget
Name	Einheit	Bereich	Standardwert	Beschreibung
phyZahl	keine	0 … 3	0	Bitübertragungsschicht von Bluetooth LE: 1M (1 Mb/s), 2M (2 Mb/s) oder der Coded PHY mit 500 kb/s (S=2) oder 125 kb/s (S=8)
txPowerZahl	dBm	beliebig	0	Die Core-Spezifikation erlaubt −20 bis +20 dBm
txGainZahl	dBi	beliebig	0	Gewinn der Sendeantenne
rxGainZahl	dBi	beliebig	0	Gewinn der Empfangsantenne
lossesZahl	dB	mindestens 0	0	Körper-, Gehäuse- und sonstige Verluste
frequencyZahl	MHz	mindestens 1	2440	LE-Kanäle reichen von 2402 bis 2480 MHz; 2440 MHz liegt in Bandmitte
pathLossModelZahl	keine	0 … 8	2	Freiraum oder ITU-R P.1238 standortunabhängig für Büro, Korridor, Industriegelände oder Konferenzraum, mit Sichtverbindung (LoS) oder ohne (NLoS)Einer von: 0 Freiraum · 1 P.1238 Büro LoS · 2 P.1238 Büro NLoS · 3 P.1238 Korridor LoS · 4 P.1238 Korridor NLoS · 5 P.1238 Industrie LoS · 6 P.1238 Industrie NLoS · 7 P.1238 Konferenzraum LoS · 8 P.1238 Konferenzraum NLoS
distanceZahl	m	mindestens 0.01	10	Direkte Entfernung (3-D) zwischen den Antennen
sensitivityOverrideZahl	dBm	höchstens 0	0	Geben Sie die Datenblattempfindlichkeit des Funkmoduls ein, um den Referenzwert der Core-Spezifikation zu ersetzen; 0 behält den Referenzwert bei
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 ble-link-budget
Feld	Einheit	Beschreibung
linkMarginHauptwert	dB	Linkreserve
dataRate	Mb/s	PHY-Datenrate
sensitivityUsed	dBm	Verwendete Empfängerempfindlichkeit
pathLoss	dB	Pfadverlust
receivedPower	dBm	Empfangsleistung
maxRange	m	Maximale Reichweite
shadowFadingStd	dB	Shadow-Fading-Standardabweichung (P.1238 σ)
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": "ble-link-budget",
    "inputs": {
      "phy": 0,
      "txPower": 0,
      "txGain": 0,
      "rxGain": 0,
      "losses": 0,
      "frequency": 2440,
      "pathLossModel": 2,
      "distance": 10,
      "sensitivityOverride": 0,
      "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("ble-link-budget", {
    "phy": 0,
    "txPower": 0,
    "txGain": 0,
    "rxGain": 0,
    "losses": 0,
    "frequency": 2440,
    "pathLossModel": 2,
    "distance": 10,
    "sensitivityOverride": 0,
    "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": "ble-link-budget",
    "inputs": {
      "phy": 0,
      "txPower": 0,
      "txGain": 0,
      "rxGain": 0,
      "losses": 0,
      "frequency": 2440,
      "pathLossModel": 2,
      "distance": 10,
      "sensitivityOverride": 0,
      "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": "ble-link-budget",
	  "inputs": {
	    "phy": 0,
	    "txPower": 0,
	    "txGain": 0,
	    "rxGain": 0,
	    "losses": 0,
	    "frequency": 2440,
	    "pathLossModel": 2,
	    "distance": 10,
	    "sensitivityOverride": 0,
	    "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": "ble-link-budget",
  "values": {
    "linkMargin": 6.672644167870494,
    "dataRate": 1,
    "sensitivityUsed": -70,
    "pathLoss": 63.327355832129506,
    "receivedPower": -63.327355832129506,
    "maxRange": 19.01910747302111,
    "shadowFadingStd": 5.01,
    "totalLoss": 63.327355832129506
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:ble-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Bluetooth Core Specification v5.4, Vol 6, Part A, §1–§4; ITU-R P.1238-13, §3.1, Table 2; ITU-R P.525-4, Eq. (3)",
    "assumptions": [
      {
        "code": "core-spec-sensitivity",
        "text": "Unless a datasheet value is entered, the receiver sensitivity is the Core Specification requirement for the PHY, the worst a compliant receiver may have; real radios are often 20 dB or more better."
      },
      {
        "code": "median-path-loss",
        "text": "Path loss is the free-space value or the ITU-R P.1238 site-general median for the environment, with no fade margin; the link margin is what is left for fading."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "phy": {
          "min": 0,
          "max": 3,
          "unit": ""
        },
        "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": 8,
          "unit": ""
        },
        "distance": {
          "min": 0.01,
          "max": null,
          "unit": "m"
        },
        "sensitivityOverride": {
          "min": null,
          "max": 0,
          "unit": "dBm"
        },
        "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": {
      "phy": 0,
      "txPower": 0,
      "txGain": 0,
      "rxGain": 0,
      "losses": 0,
      "frequency": 2440,
      "pathLossModel": 2,
      "distance": 10,
      "sensitivityOverride": 0,
      "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",
        "phy"
      ],
      "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 RechnerseiteBLE-Linkbudget- und Reichweitenrechner — Bluetooth Low Energy nach PHY, mit diesen Werten