Seções da documentação

Calculadora de orçamento de enlace LoRa — sensibilidade, tempo no ar e alcance

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

Slug lora-link-budget. Orçamento de enlace LoRa pelas fórmulas do Semtech SX1276: sensibilidade do receptor por fator de espalhamento e largura de banda, tempo de símbolo, tempo no ar com otimização automática para baixa taxa de dados, tempo de silêncio imposto pelo ciclo de trabalho, perda de percurso no espaço livre ou de Okumura–Hata, margem do enlace e alcance máximo.

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 lora-link-budget
Nome	Unidade	Faixa	Padrão	Descrição
spreadingFactornúmero	nenhuma	6 … 12	9	São 2^SF chips por símbolo; cada passo acima acrescenta cerca de 2,5 dB de sensibilidade e dobra o tempo no ar
bandwidthnúmero	kHz	no mínimo 7.8	125	Largura de banda do sinal LoRa; 125 kHz na maioria dos canais LoRaWAN
codingRatenúmero	nenhuma	1 … 4	1	Correção antecipada de erros: quatro bits de dados em cinco a oito bits codificadosUm de: 1 4/5 · 2 4/6 · 3 4/7 · 4 4/8
payloadLengthnúmero	bytes	1 … 255	20	Bytes da carga útil LoRa, de 1 a 255 (um quadro LoRaWAN acrescenta 13 bytes de overhead aos dados da aplicação)
preambleLengthnúmero	symbols	no mínimo 0	8	Símbolos de preâmbulo programados; 8 no LoRaWAN
implicitHeadernúmero	nenhuma	0 … 1	0	Modo de cabeçalhoUm de: 0 Cabeçalho explícito · 1 Cabeçalho implícito
crcnúmero	nenhuma	0 … 1	1	CRC da carga útilUm de: 1 CRC ativado · 0 CRC desativado
noiseFigurenúmero	dB	no mínimo 0	6	Cerca de 6 dB para um SX127x com o ganho máximo do LNA
txPowernúmero	dBm	qualquer	14	14 dBm é o limite usual na UE em 868 MHz; 20 dBm com PA_BOOST
txGainnúmero	dBi	qualquer	2.15	Ganho da antena de transmissão
rxGainnúmero	dBi	qualquer	5	Ganho da antena de recepção
lossesnúmero	dB	no mínimo 0	2	Perdas de cabo e outras
frequencynúmero	MHz	no mínimo 1	868	Frequência
pathLossModelnúmero	nenhuma	0 … 5	1	Espaço livre, ou Okumura–Hata para um percurso urbano, suburbano ou ruralUm de: 0 Espaço livre · 1 Okumura–Hata, urbano (cidade pequena/média) · 2 Okumura–Hata, urbano (cidade grande) · 3 Okumura–Hata, suburbano · 4 Okumura–Hata, rural quase aberto · 5 Okumura–Hata, rural aberto
distancenúmero	km	no mínimo 0.001	2	Distância
baseHeightnúmero	m	no mínimo 1	30	Usada pelo Okumura–Hata, que cobre de 30 a 200 m
mobileHeightnúmero	m	no mínimo 0.1	1.5	Usada pelo Okumura–Hata, que cobre de 1 a 10 m
dutyCyclenúmero	%	0.001 … 100	1	Fração do tempo em que um dispositivo pode transmitir; 1% na sub-banda de 868,0–868,6 MHz da UE (ETSI EN 300 220-2)
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 lora-link-budget
Campo	Unidade	Descrição
linkMarginprincipal	dB	Margem do enlace
sensitivity	dBm	Sensibilidade do receptor
receivedPower	dBm	Potência recebida
pathLoss	dB	Perda de percurso
maxRange	km	Alcance máximo
timeOnAir	ms	Tempo no ar
symbolTime	ms	Tempo de símbolo
payloadSymbols	nenhuma	Símbolos da carga útil
lowDataRateOptimize	nenhuma	Otimização para baixa taxa de dados (1 = ativada)
bitRate	bit/s	Taxa de bits equivalente
offTime	s	Tempo mínimo de silêncio após cada pacote
packetsPerHour	nenhuma	Pacotes por hora dentro do ciclo de trabalho
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": "lora-link-budget",
    "inputs": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "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("lora-link-budget", {
    "spreadingFactor": 9,
    "bandwidth": 125,
    "codingRate": 1,
    "payloadLength": 20,
    "preambleLength": 8,
    "implicitHeader": 0,
    "crc": 1,
    "noiseFigure": 6,
    "txPower": 14,
    "txGain": 2.15,
    "rxGain": 5,
    "losses": 2,
    "frequency": 868,
    "pathLossModel": 1,
    "distance": 2,
    "baseHeight": 30,
    "mobileHeight": 1.5,
    "dutyCycle": 1,
    "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": "lora-link-budget",
    "inputs": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "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": "lora-link-budget",
	  "inputs": {
	    "spreadingFactor": 9,
	    "bandwidth": 125,
	    "codingRate": 1,
	    "payloadLength": 20,
	    "preambleLength": 8,
	    "implicitHeader": 0,
	    "crc": 1,
	    "noiseFigure": 6,
	    "txPower": 14,
	    "txGain": 2.15,
	    "rxGain": 5,
	    "losses": 2,
	    "frequency": 868,
	    "pathLossModel": 1,
	    "distance": 2,
	    "baseHeight": 30,
	    "mobileHeight": 1.5,
	    "dutyCycle": 1,
	    "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": "lora-link-budget",
  "values": {
    "linkMargin": 12.058955385826835,
    "sensitivity": -129.50608706414752,
    "receivedPower": -117.44713167832069,
    "pathLoss": 136.5971316783207,
    "maxRange": 4.399184913581315,
    "timeOnAir": 185.344,
    "symbolTime": 4.096,
    "payloadSymbols": 33,
    "lowDataRateOptimize": 0,
    "bitRate": 1757.8125,
    "offTime": 18.349055999999997,
    "packetsPerHour": 194.23342541436466,
    "totalLoss": 138.5971316783207
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:lora-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Semtech SX1276/77/78/79 datasheet Rev. 4 (2015), Table 13, §4.1.1.5–4.1.1.7; Semtech AN1200.13 Rev. 1 (2013), Eqn. 1; Hata (1980); ITU-R P.525-4",
    "assumptions": [
      {
        "code": "sx1276-snr-limits",
        "text": "Sensitivity uses the SX1276/77/78/79 demodulator SNR limits by spreading factor and the noise figure entered; another LoRa radio may differ by a dB or two."
      },
      {
        "code": "automatic-ldro",
        "text": "Low-data-rate optimisation is switched on exactly when the symbol time exceeds 16 ms, as the datasheet mandates."
      },
      {
        "code": "median-path-loss",
        "text": "Path loss is the free-space or Okumura–Hata median, with no fade margin; the link margin is what is left for fading."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "spreadingFactor": {
          "min": 6,
          "max": 12,
          "unit": ""
        },
        "bandwidth": {
          "min": 7.8,
          "max": null,
          "unit": "kHz"
        },
        "codingRate": {
          "min": 1,
          "max": 4,
          "unit": ""
        },
        "payloadLength": {
          "min": 1,
          "max": 255,
          "unit": "bytes"
        },
        "preambleLength": {
          "min": 0,
          "max": null,
          "unit": "symbols"
        },
        "implicitHeader": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "crc": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "noiseFigure": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "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": 5,
          "unit": ""
        },
        "distance": {
          "min": 0.001,
          "max": null,
          "unit": "km"
        },
        "baseHeight": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "mobileHeight": {
          "min": 0.1,
          "max": null,
          "unit": "m"
        },
        "dutyCycle": {
          "min": 0.001,
          "max": 100,
          "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": {
      "spreadingFactor": 9,
      "bandwidth": 125,
      "codingRate": 1,
      "payloadLength": 20,
      "preambleLength": 8,
      "implicitHeader": 0,
      "crc": 1,
      "noiseFigure": 6,
      "txPower": 14,
      "txGain": 2.15,
      "rxGain": 5,
      "losses": 2,
      "frequency": 868,
      "pathLossModel": 1,
      "distance": 2,
      "baseHeight": 30,
      "mobileHeight": 1.5,
      "dutyCycle": 1,
      "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",
        "spreadingFactor"
      ],
      "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 LoRa — sensibilidade, tempo no ar e alcance, com estes valores