Secciones de la documentación

Calculadora de Presupuesto de Enlace RF

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

Slug rf-link-budget. Calcula el presupuesto de potencia completo de un enlace inalámbrico incluyendo ganancias, pérdidas y margen de enlace.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de rf-link-budget
Nombre	Unidad	Rango	Valor predeterminado	Descripción
txPowernúmero	dBm	−30 … 100	30	Potencia de salida del transmisor
txGainnúmero	dBi	−30 … 60	3	Ganancia de antena TX en dBi
txCableLossnúmero	dB	0 … 20	1	Pérdidas en el conector del cable TX + (valor positivo)
frequencynúmero	MHz	0.1 … 1000000	2400	Frecuencia central
distancenúmero	km	0.001 … 1000000	1	Distancia entre TX y RX
rainFadenúmero	dB	0 … 50	0	Atenuación por lluvia según ITU-R P.838. Utilice 0 para los enlaces terrestres con línea de visión; de 3 a 20 dB para los enlaces por satélite de más de 10 GHz en zonas de fuertes lluvias.
atmosphericLossnúmero	dB	0 … 20	0.5	Absorción gaseosa (O₂ a 60 GHz: ~15 dB/km; H₂O a 22 GHz: ~0,2 dB/km). Utilice 0,5 dB típicos para enlaces terrestres de menos de 6 GHz.
pointingLossnúmero	dB	0 … 10	0	Pérdida de desalineación de la antena. Antenas con forma de lápiz: 0,5 — 3 dB. Antenas omnidireccionales o de haz ancho: 0 dB.
extraLossCountnúmero	ninguna	0 … 4	0	Cuántas condiciones de pérdida adicionales incluye el presupuesto, como el desajuste de la polarización, la pérdida de cuerpo o el follaje
extraLoss1número	dB	0 … 50	0	Una pérdida adicional en el camino, como un desajuste de la polarización, la pérdida de cuerpo, el follaje o una pared
extraLoss2número	dB	0 … 50	0	Una pérdida adicional en el camino, como un desajuste de la polarización, la pérdida de cuerpo, el follaje o una pared
extraLoss3número	dB	0 … 50	0	Una pérdida adicional en el camino, como un desajuste de la polarización, la pérdida de cuerpo, el follaje o una pared
extraLoss4número	dB	0 … 50	0	Una pérdida adicional en el camino, como un desajuste de la polarización, la pérdida de cuerpo, el follaje o una pared
rxGainnúmero	dBi	−30 … 60	3	Ganancia de antena RX en dBi
rxCableLossnúmero	dB	0 … 20	1	Pérdidas en el conector del cable RX +
rxSensitivitynúmero	dBm	−160 … 0	-90	Nivel mínimo de señal a recibir
targetMarginnúmero	dB	0 … 60	10	El margen de atenuación que el enlace debe mantener por encima de la sensibilidad del receptor. El estado pasa a un valor igual o superior y falla por debajo de 0 dB.

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de rf-link-budget
Campo	Unidad	Descripción
fspl	dB	Pérdida de trayectoria en el espacio libre
eirp	dBm	EIRP
rxPower	dBm	Potencia recibida
linkMarginprincipal	dB	Margen de enlace
maxRangeKm	km	Alcance máximo
totalAdditionalLoss	dB	Pérdida adicional total
maxRangeAtTarget	km	Alcance en el margen objetivo
wavelength	mm	Longitud de onda
fresnelRadius	m	Primer radio de la zona de Fresnel

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

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"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de Presupuesto de Enlace RF, con estos valores