Sections de la documentation

Calculateur de budget RF Link

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

Slug rf-link-budget. Calculateur de budget de liaison RF gratuit : entrez la puissance Tx, les gains d'antenne, la fréquence et la distance pour obtenir le niveau du signal reçu, la marge de liaison et la portée maximale. Couvre les liaisons par satellite, terrestres et IoT.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de rf-link-budget
Nom	Unité	Plage	Valeur par défaut	Description
txPowernombre	dBm	−30 … 100	30	Puissance de sortie de l'émetteur
txGainnombre	dBi	−30 … 60	3	Gain de l'antenne TX en dBi
txCableLossnombre	dB	0 … 20	1	Pertes du câble TX + du connecteur (valeur positive)
frequencynombre	MHz	0.1 … 1000000	2400	Fréquence centrale
distancenombre	km	0.001 … 1000000	1	Distance entre TX et RX
rainFadenombre	dB	0 … 50	0	Atténuation de la pluie selon l'UIT-R P.838. Utilisez 0 pour les liaisons terrestres en visibilité directe ; 3 à 20 dB pour les liaisons par satellite supérieures à 10 GHz dans les zones de fortes pluies.
atmosphericLossnombre	dB	0 … 20	0.5	Absorption de gaz (O₂ à 60 GHz : ~15 dB/km ; H₂O à 22 GHz : ~0,2 dB/km). Utilisez 0,5 dB, comme c'est le cas pour les liaisons terrestres inférieures à 6 GHz.
pointingLossnombre	dB	0 … 10	0	Perte de désalignement de l'antenne. Paraboles à rayons : 0,5 à 3 dB. Antennes omnidirectionnelles ou à faisceau large : 0 dB.
extraLossCountnombre	aucune	0 … 4	0	Combien de termes de pertes supplémentaires sont inclus dans le budget, tels que l'inadéquation de la polarisation, la perte corporelle ou le feuillage
extraLoss1nombre	dB	0 … 50	0	Une perte supplémentaire sur le trajet, telle qu'un décalage de polarisation, une perte de corps, de feuillage ou de mur
extraLoss2nombre	dB	0 … 50	0	Une perte supplémentaire sur le trajet, telle qu'un décalage de polarisation, une perte de corps, de feuillage ou de mur
extraLoss3nombre	dB	0 … 50	0	Une perte supplémentaire sur le trajet, telle qu'un décalage de polarisation, une perte de corps, de feuillage ou de mur
extraLoss4nombre	dB	0 … 50	0	Une perte supplémentaire sur le trajet, telle qu'un décalage de polarisation, une perte de corps, de feuillage ou de mur
rxGainnombre	dBi	−30 … 60	3	Gain de l'antenne RX en dBi
rxCableLossnombre	dB	0 … 20	1	Pertes du câble RX et du connecteur
rxSensitivitynombre	dBm	−160 … 0	-90	Niveau de signal recevable minimum
targetMarginnombre	dB	0 … 60	10	La marge de fondu que le lien doit maintenir au-dessus de la sensibilité du récepteur. L'état passe à un niveau supérieur ou égal à celui-ci et passe en dessous de 0 dB.

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de rf-link-budget
Champ	Unité	Description
fspl	dB	Perte de trajectoire spatiale libre
eirp	dBm	EIRP
rxPower	dBm	Puissance reçue
linkMarginprincipale	dB	Marge des liens
maxRangeKm	km	Portée maximale
totalAdditionalLoss	dB	Perte supplémentaire totale
maxRangeAtTarget	km	Fourchette à la marge cible
wavelength	mm	Longueur d'onde
fresnelRadius	m	Rayon de la première zone de Fresnel

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "rf-link-budget",
    "inputs": {
      "txPower": 30,
      "txGain": 3,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 1,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 3,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "targetMargin": 10
    }
  }'

import rftools

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

result = client.calculate("rf-link-budget", {
    "txPower": 30,
    "txGain": 3,
    "txCableLoss": 1,
    "frequency": 2400,
    "distance": 1,
    "rainFade": 0,
    "atmosphericLoss": 0.5,
    "pointingLoss": 0,
    "extraLossCount": 0,
    "extraLoss1": 0,
    "extraLoss2": 0,
    "extraLoss3": 0,
    "extraLoss4": 0,
    "rxGain": 3,
    "rxCableLoss": 1,
    "rxSensitivity": -90,
    "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": "rf-link-budget",
    "inputs": {
      "txPower": 30,
      "txGain": 3,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 1,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 3,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "targetMargin": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "rf-link-budget",
	  "inputs": {
	    "txPower": 30,
	    "txGain": 3,
	    "txCableLoss": 1,
	    "frequency": 2400,
	    "distance": 1,
	    "rainFade": 0,
	    "atmosphericLoss": 0.5,
	    "pointingLoss": 0,
	    "extraLossCount": 0,
	    "extraLoss1": 0,
	    "extraLoss2": 0,
	    "extraLoss3": 0,
	    "extraLoss4": 0,
	    "rxGain": 3,
	    "rxCableLoss": 1,
	    "rxSensitivity": -90,
	    "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": "rf-link-budget",
  "values": {
    "fspl": 100.0520080561155,
    "eirp": 32,
    "rxPower": -66.5520080561155,
    "linkMargin": 23.447991943884503,
    "maxRangeKm": 14.873034905799756,
    "totalAdditionalLoss": 0.5,
    "wavelength": 124.91352416666666,
    "fresnelRadius": 5.588235950786855,
    "maxRangeAtTarget": 4.703266602151508
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:rf-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Friis, \"A Note on a Simple Transmission Formula\" (1946)",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "txPower": {
          "min": -30,
          "max": 100,
          "unit": "dBm"
        },
        "txGain": {
          "min": -30,
          "max": 60,
          "unit": "dBi"
        },
        "txCableLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "frequency": {
          "min": 0.1,
          "max": 1000000,
          "unit": "MHz"
        },
        "distance": {
          "min": 0.001,
          "max": 1000000,
          "unit": "km"
        },
        "rainFade": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "atmosphericLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "pointingLoss": {
          "min": 0,
          "max": 10,
          "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"
        },
        "rxGain": {
          "min": -30,
          "max": 60,
          "unit": "dBi"
        },
        "rxCableLoss": {
          "min": 0,
          "max": 20,
          "unit": "dB"
        },
        "rxSensitivity": {
          "min": -160,
          "max": 0,
          "unit": "dBm"
        },
        "targetMargin": {
          "min": 0,
          "max": 60,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "txPower": 30,
      "txGain": 3,
      "txCableLoss": 1,
      "frequency": 2400,
      "distance": 1,
      "rainFade": 0,
      "atmosphericLoss": 0.5,
      "pointingLoss": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "rxGain": 3,
      "rxCableLoss": 1,
      "rxSensitivity": -90,
      "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"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de budget RF Link, avec ces valeurs