Seções da documentação

Calculadora de orçamento RF Link

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

Slug rf-link-budget. Calculadora gratuita de orçamento de links de RF: insira a potência Tx, os ganhos da antena, a frequência e a distância para obter o nível do sinal recebido, a margem do link e o alcance máximo. Abrange links de satélite, terrestres e de IoT.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de rf-link-budget
Nome	Unidade	Faixa	Padrão	Descrição
txPowernúmero	dBm	−30 … 100	30	Potência de saída do transmissor
txGainnúmero	dBi	−30 … 60	3	Ganho da antena TX em dBi
txCableLossnúmero	dB	0 … 20	1	Perdas de cabo TX + conector (valor positivo)
frequencynúmero	MHz	0.1 … 1000000	2400	Frequência central
distancenúmero	km	0.001 … 1000000	1	Distância entre TX e RX
rainFadenúmero	dB	0 … 50	0	Atenuação da chuva de acordo com ITU-R P.838. Use 0 para links terrestres com linha de visão; 3—20 dB para links de satélite acima de 10 GHz em zonas de chuva forte.
atmosphericLossnúmero	dB	0 … 20	0.5	Absorção gasosa (O₂ a 60 GHz: ~15 dB/km; H₂O a 22 GHz: ~0,2 dB/km). Use 0,5 dB típico para links terrestres abaixo de 6 GHz.
pointingLossnúmero	dB	0 … 10	0	Perda de desalinhamento da antena. Pratos com feixe de lápis: 0,5—3 dB. Antenas omnidirecionais ou de feixe amplo: 0 dB.
extraLossCountnúmero	nenhuma	0 … 4	0	Quantos termos extras de perda o orçamento inclui, como descasamento de polarização, perda pelo corpo ou folhagem
extraLoss1número	dB	0 … 50	0	Uma perda extra no percurso, como descasamento de polarização, perda pelo corpo, folhagem ou uma parede
extraLoss2número	dB	0 … 50	0	Uma perda extra no percurso, como descasamento de polarização, perda pelo corpo, folhagem ou uma parede
extraLoss3número	dB	0 … 50	0	Uma perda extra no percurso, como descasamento de polarização, perda pelo corpo, folhagem ou uma parede
extraLoss4número	dB	0 … 50	0	Uma perda extra no percurso, como descasamento de polarização, perda pelo corpo, folhagem ou uma parede
rxGainnúmero	dBi	−30 … 60	3	Ganho de antena RX em dBi
rxCableLossnúmero	dB	0 … 20	1	Perdas de cabo RX e conector
rxSensitivitynúmero	dBm	−160 … 0	-90	Nível mínimo de sinal a receber
targetMarginnúmero	dB	0 … 60	10	A margem de esmaecimento que o link deve manter acima da sensibilidade do receptor. O status passa igual ou superior a ele e falha abaixo de 0 dB.

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de rf-link-budget
Campo	Unidade	Descrição
fspl	dB	Perda de caminho de espaço livre
eirp	dBm	EIRP
rxPower	dBm	Potência recebida
linkMarginprincipal	dB	Margem do link
maxRangeKm	km	Alcance máximo
totalAdditionalLoss	dB	Perda adicional total
maxRangeAtTarget	km	Intervalo na margem alvo
wavelength	mm	Comprimento de onda
fresnelRadius	m	Raio da primeira zona de Fresnel

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de orçamento RF Link, com estes valores