Seções da documentação

Calculadora de orçamento de enlace 5G NR — perda de percurso 3GPP TR 38.901, SINR e alcance

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

Slug 5g-nr-link-budget. Orçamento de enlace 5G NR com os modelos de canal do 3GPP: perda de percurso do TR 38.901 para macro rural, macro urbana, micro urbana e escritório indoor, com ou sem linha de visada (LOS/NLOS), o piso de ruído a partir dos blocos de recursos, SINR, margem do enlace, o alcance máximo dentro da validade do modelo e a taxa de dados de pico da TS 38.306.

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 5g-nr-link-budget
Nome	Unidade	Faixa	Padrão	Descrição
scenarionúmero	nenhuma	0 … 3	1	Cenário de implantação do 3GPP TR 38.901: 0 macro rural, 1 macro urbana, 2 micro urbana em cânion de rua, 3 escritório indoor
lineOfSightnúmero	nenhuma	0 … 1	0	Se o percurso direto está desobstruído; em NLOS vale a maior entre as fórmulas LOS e NLOS
frequencynúmero	GHz	no mínimo 0.1	3.5	Frequência central; o TR 38.901 cobre de 0,5 a 100 GHz (30 GHz para RMa)
channelBandwidthnúmero	MHz	no mínimo 3	100	Largura de banda do canal do UE; define os blocos de recursos e, portanto, a largura de banda de ruído
scsnúmero	kHz	no mínimo 15	30	15, 30 ou 60 kHz na FR1; 60 ou 120 kHz na FR2
bsHeightnúmero	m	no mínimo 1	25	O TR 38.901 fixa 25 m para UMa e 10 m para UMi; RMa cobre de 10 a 150 m
utHeightnúmero	m	no mínimo 0.5	1.5	Altura do terminal do usuário; 1,5 m no nível da rua
distancenúmero	m	no mínimo 1	500	Distância no solo da estação base até o usuário
txPowernúmero	dBm	qualquer	46	Potência conduzida total na portadora (46 dBm são 40 W)
txGainnúmero	dBi	qualquer	17	Ganho da antena de transmissão
rxGainnúmero	dBi	qualquer	0	Ganho da antena de recepção
lossesnúmero	dB	no mínimo 0	3	Perdas de cabo, corpo e outras
shadowMarginnúmero	dB	no mínimo 0	8	Margem reservada para o sombreamento; compare com a saída σ_SF do cenário
noiseFigurenúmero	dB	no mínimo 0	7	Figura de ruído do receptor
requiredSinrnúmero	dB	qualquer	0	SINR exigida pela modulação e codificação escolhidas
interferenceMarginnúmero	dB	no mínimo 0	3	Elevação do ruído mais interferência sobre o ruído térmico
layersnúmero	nenhuma	1 … 8	4	Camadas MIMO
modulationOrdernúmero	nenhuma	1 … 10	8	Ordem de modulação (bits por símbolo)
scalingFactornúmero	nenhuma	0.1 … 1	1	Fator de escala de capacidade do UE na TS 38.306: 1; 0,8; 0,75 ou 0,4
linkDirectionnúmero	nenhuma	0 … 1	0	Define o overhead da TS 38.306: 0,14 DL e 0,08 UL na FR1, 0,18 e 0,10 na FR2
extraLossCountnúmero	nenhuma	0 … 6	0	Quantas perdas a mais o enlace soma, como entrada em edificação, vegetação, corpo ou descasamento de polarização (0–6)
extraLoss1número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização
extraLoss2número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização
extraLoss3número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização
extraLoss4número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização
extraLoss5número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização
extraLoss6número	dB	0 … 50	0	Uma perda a mais no enlace, como entrada em edificação, vegetação, perda pelo corpo ou descasamento de polarização

Saídas

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

Saídas de 5g-nr-link-budget
Campo	Unidade	Descrição
linkMarginprincipal	dB	Margem do enlace
pathLoss	dB	Perda de percurso (TR 38.901)
receivedPower	dBm	Potência recebida
sinr	dB	SINR (mediana)
maxPathLoss	dB	Perda de percurso máxima admissível
maxRange	m	Alcance máximo (2-D, dentro da validade do modelo)
resourceBlocks	nenhuma	Blocos de recursos (N_RB)
occupiedBandwidth	MHz	Largura de banda ocupada (N_RB × 12 × SCS)
thermalNoise	dBm	Ruído térmico (kTB)
noiseFloor	dBm	Piso de ruído do receptor (kTB + NF)
breakpointDistance	m	Distância de breakpoint
shadowFadingStd	dB	Desvio padrão do sombreamento (σ_SF)
peakDataRate	Mbps	Taxa de dados de pico (TS 38.306)
totalLoss	dB	Perda total

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": "5g-nr-link-budget",
    "inputs": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 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("5g-nr-link-budget", {
    "scenario": 1,
    "lineOfSight": 0,
    "frequency": 3.5,
    "channelBandwidth": 100,
    "scs": 30,
    "bsHeight": 25,
    "utHeight": 1.5,
    "distance": 500,
    "txPower": 46,
    "txGain": 17,
    "rxGain": 0,
    "losses": 3,
    "shadowMargin": 8,
    "noiseFigure": 7,
    "requiredSinr": 0,
    "interferenceMargin": 3,
    "layers": 4,
    "modulationOrder": 8,
    "scalingFactor": 1,
    "linkDirection": 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": "5g-nr-link-budget",
    "inputs": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 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": "5g-nr-link-budget",
	  "inputs": {
	    "scenario": 1,
	    "lineOfSight": 0,
	    "frequency": 3.5,
	    "channelBandwidth": 100,
	    "scs": 30,
	    "bsHeight": 25,
	    "utHeight": 1.5,
	    "distance": 500,
	    "txPower": 46,
	    "txGain": 17,
	    "rxGain": 0,
	    "losses": 3,
	    "shadowMargin": 8,
	    "noiseFigure": 7,
	    "requiredSinr": 0,
	    "interferenceMargin": 3,
	    "layers": 4,
	    "modulationOrder": 8,
	    "scalingFactor": 1,
	    "linkDirection": 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": "5g-nr-link-budget",
  "values": {
    "linkMargin": 6.134701907799126,
    "pathLoss": 129.9158338083485,
    "receivedPower": -69.91583380834851,
    "sinr": 14.13470190779914,
    "maxPathLoss": 136.05053571614764,
    "maxRange": 718.1162910484755,
    "resourceBlocks": 273,
    "occupiedBandwidth": 98.28,
    "thermalNoise": -94.05053571614765,
    "noiseFloor": -87.05053571614765,
    "breakpointDistance": 560.3876799328955,
    "shadowFadingStd": 6,
    "peakDataRate": 2337.00012,
    "totalLoss": 132.9158338083485
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:5g-nr-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "3GPP TR 38.901 V17.0.0, Table 7.4.1-1; TS 38.101-1 V18.15.0 Table 5.3.2-1; TS 38.306 V18.11.0, §4.1.2",
    "assumptions": [
      {
        "code": "tr38901-median-path-loss",
        "text": "Path loss is the median of the 3GPP TR 38.901 V17.0.0 Table 7.4.1-1 model for the chosen scenario and line-of-sight state; shadowing is covered only by the margin entered, and the LOS probability is not applied."
      },
      {
        "code": "effective-environment-height",
        "text": "UMa and UMi use an effective environment height of 1 m, and RMa the default building height of 5 m and street width of 20 m."
      },
      {
        "code": "exact-speed-of-light",
        "text": "Breakpoint distances use c = 299792458 m/s, where TR 38.901 writes 3.0×10⁸ m/s."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "scenario": {
          "min": 0,
          "max": 3,
          "unit": ""
        },
        "lineOfSight": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "frequency": {
          "min": 0.1,
          "max": null,
          "unit": "GHz"
        },
        "channelBandwidth": {
          "min": 3,
          "max": null,
          "unit": "MHz"
        },
        "scs": {
          "min": 15,
          "max": null,
          "unit": "kHz"
        },
        "bsHeight": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "utHeight": {
          "min": 0.5,
          "max": null,
          "unit": "m"
        },
        "distance": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "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"
        },
        "shadowMargin": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "noiseFigure": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "requiredSinr": {
          "min": null,
          "max": null,
          "unit": "dB"
        },
        "interferenceMargin": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "layers": {
          "min": 1,
          "max": 8,
          "unit": ""
        },
        "modulationOrder": {
          "min": 1,
          "max": 10,
          "unit": ""
        },
        "scalingFactor": {
          "min": 0.1,
          "max": 1,
          "unit": ""
        },
        "linkDirection": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "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": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 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",
        "scenario"
      ],
      "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 de enlace 5G NR — perda de percurso 3GPP TR 38.901, SINR e alcance, com estes valores