Secciones de la documentación

Calculadora de presupuesto de enlace LoRa: sensibilidad, tiempo en el aire y alcance

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

Slug lora-link-budget. Presupuesto de enlace LoRa con las fórmulas del Semtech SX1276: sensibilidad del receptor según el factor de dispersión y el ancho de banda, tiempo de símbolo, tiempo en el aire con optimización automática para baja velocidad de datos, tiempo de espera por ciclo de trabajo, pérdida de trayecto en espacio libre u Okumura–Hata, margen de enlace y alcance máximo.

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 lora-link-budget
Nombre	Unidad	Rango	Valor predeterminado	Descripción
spreadingFactornúmero	ninguna	6 … 12	9	Los chips por símbolo son 2^SF; cada paso hacia arriba añade unos 2,5 dB de sensibilidad y duplica el tiempo en el aire
bandwidthnúmero	kHz	al menos 7.8	125	Ancho de banda de la señal LoRa; 125 kHz en la mayoría de los canales LoRaWAN
codingRatenúmero	ninguna	1 … 4	1	Corrección de errores hacia adelante (FEC): cuatro bits de datos en cinco a ocho bits codificadosUno de: 1 4/5 · 2 4/6 · 3 4/7 · 4 4/8
payloadLengthnúmero	bytes	1 … 255	20	Bytes de la carga útil LoRa, de 1 a 255 (una trama LoRaWAN añade 13 bytes de sobrecarga a los datos de la aplicación)
preambleLengthnúmero	symbols	al menos 0	8	Símbolos de preámbulo programados; 8 en LoRaWAN
implicitHeadernúmero	ninguna	0 … 1	0	Modo de encabezadoUno de: 0 Encabezado explícito · 1 Encabezado implícito
crcnúmero	ninguna	0 … 1	1	CRC de la carga útilUno de: 1 CRC activado · 0 CRC desactivado
noiseFigurenúmero	dB	al menos 0	6	Unos 6 dB para un SX127x con la máxima ganancia del LNA
txPowernúmero	dBm	cualquiera	14	14 dBm es el límite habitual en la UE a 868 MHz; 20 dBm con PA_BOOST
txGainnúmero	dBi	cualquiera	2.15	Ganancia de la antena de transmisión
rxGainnúmero	dBi	cualquiera	5	Ganancia de la antena de recepción
lossesnúmero	dB	al menos 0	2	Pérdidas por cable y otras
frequencynúmero	MHz	al menos 1	868	Frecuencia
pathLossModelnúmero	ninguna	0 … 5	1	Espacio libre, u Okumura–Hata para un trayecto urbano, suburbano o ruralUno de: 0 Espacio libre · 1 Okumura–Hata, urbano (ciudad pequeña/mediana) · 2 Okumura–Hata, urbano (ciudad grande) · 3 Okumura–Hata, suburbano · 4 Okumura–Hata, rural casi abierto · 5 Okumura–Hata, rural abierto
distancenúmero	km	al menos 0.001	2	Distancia
baseHeightnúmero	m	al menos 1	30	Lo usa Okumura–Hata, válido de 30 a 200 m
mobileHeightnúmero	m	al menos 0.1	1.5	Lo usa Okumura–Hata, válido de 1 a 10 m
dutyCyclenúmero	%	0.001 … 100	1	Fracción del tiempo en que un dispositivo puede transmitir; 1% en la subbanda UE de 868,0–868,6 MHz (ETSI EN 300 220-2)
extraLossCountnúmero	ninguna	0 … 6	0	Cuántas pérdidas más añade el enlace, como la penetración en edificios, el follaje, el cuerpo o el desajuste de polarización (0–6)
extraLoss1número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización
extraLoss2número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización
extraLoss3número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización
extraLoss4número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización
extraLoss5número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización
extraLoss6número	dB	0 … 50	0	Otra pérdida del enlace, como la penetración en edificios, el follaje, la pérdida por el cuerpo o el desajuste de polarización

Salidas

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

Salidas de lora-link-budget
Campo	Unidad	Descripción
linkMarginprincipal	dB	Margen de enlace
sensitivity	dBm	Sensibilidad del receptor
receivedPower	dBm	Potencia recibida
pathLoss	dB	Pérdida de trayecto
maxRange	km	Alcance máximo
timeOnAir	ms	Tiempo en el aire
symbolTime	ms	Tiempo de símbolo
payloadSymbols	ninguna	Símbolos de la carga útil
lowDataRateOptimize	ninguna	Optimización para baja velocidad de datos (1 = activada)
bitRate	bit/s	Tasa de bits equivalente
offTime	s	Tiempo de silencio mínimo tras cada paquete
packetsPerHour	ninguna	Paquetes por hora dentro del ciclo de trabajo
totalLoss	dB	Pérdida total

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

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 LoRa: sensibilidad, tiempo en el aire y alcance, con estos valores