ドキュメントのセクション

LoRaリンクバジェット計算ツール — 受信感度、送信時間（Time on Air）、通信距離

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

スラッグ lora-link-budget。Semtech SX1276の計算式によるLoRaのリンクバジェット。拡散率と帯域幅ごとの受信感度、シンボル時間、低データレート最適化を自動で適用した送信時間（Time on Air）、デューティサイクルによる送信停止時間、自由空間またはOkumura–Hata（奥村–秦）モデルの伝搬損失、リンクマージン、最大通信距離を求めます。

入力

これらの入力を、表示されている単位ですべて inputs に入れて送ってください。ほとんどは必須で、1 つでも欠けた呼び出しは拒否され（400）、費用はかかりません。省略しても計算できる入力は、表示されている既定値を使います。範囲外の入力も計算され、来歴で示されます。

lora-link-budget の入力
名前	単位	範囲	既定値	説明
spreadingFactor数値	なし	6 … 12	9	1シンボルあたりのチップ数は2^SF。1段上げるごとに受信感度が約2.5 dB向上し、送信時間は2倍になります
bandwidth数値	kHz	7.8 以上	125	LoRaの信号帯域幅。ほとんどのLoRaWANチャネルでは125 kHz
codingRate数値	なし	1 … 4	1	前方誤り訂正: データ 4 ビットを 5〜8 ビットの符号にします次のいずれか：1 4/5 · 2 4/6 · 3 4/7 · 4 4/8
payloadLength数値	bytes	1 … 255	20	LoRaペイロードのバイト数、1〜255 (LoRaWANフレームではアプリケーションデータに13バイトのオーバーヘッドが加わります)
preambleLength数値	symbols	0 以上	8	設定するプリアンブルのシンボル数。LoRaWANでは8
implicitHeader数値	なし	0 … 1	0	ヘッダーモード次のいずれか：0 明示的ヘッダー · 1 暗黙的ヘッダー
crc数値	なし	0 … 1	1	ペイロード CRC次のいずれか：1 CRC オン · 0 CRC オフ
noiseFigure数値	dB	0 以上	6	LNA利得を最大にしたSX127xで約6 dB
txPower数値	dBm	制限なし	14	EUの868 MHzでは通常14 dBmが上限。PA_BOOST使用時は20 dBm
txGain数値	dBi	制限なし	2.15	送信アンテナ利得
rxGain数値	dBi	制限なし	5	受信アンテナ利得
losses数値	dB	0 以上	2	ケーブル・その他の損失
frequency数値	MHz	1 以上	868	周波数
pathLossModel数値	なし	0 … 5	1	自由空間、または市街地・郊外・ルーラル経路の奥村–秦モデル次のいずれか：0 自由空間 · 1 奥村–秦、市街地 (中小都市) · 2 奥村–秦、市街地 (大都市) · 3 奥村–秦、郊外 · 4 奥村–秦、ルーラル (準開放地) · 5 奥村–秦、ルーラル (開放地)
distance数値	km	0.001 以上	2	距離
baseHeight数値	m	1 以上	30	Okumura–Hataで使用。適用範囲は30〜200 m
mobileHeight数値	m	0.1 以上	1.5	Okumura–Hataで使用。適用範囲は1〜10 m
dutyCycle数値	%	0.001 … 100	1	デバイスが送信できる時間の割合。EUの868.0–868.6 MHzサブバンドでは1% (ETSI EN 300 220-2)
extraLossCount数値	なし	0 … 6	0	リンクに加わる追加損失の数。建物侵入、樹木、人体、偏波不整合など (0～6)
extraLoss1数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など
extraLoss2数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など
extraLoss3数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など
extraLoss4数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など
extraLoss5数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など
extraLoss6数値	dB	0 … 50	0	リンクに加わる追加損失。建物侵入、樹木、人体損失、偏波不整合など

出力

values に名前ごとに返されます。上限がない値や定義されない値は null です。

lora-link-budget の出力
フィールド	単位	説明
linkMargin主要値	dB	リンクマージン
sensitivity	dBm	受信感度
receivedPower	dBm	受信電力
pathLoss	dB	伝搬損失
maxRange	km	最大通信距離
timeOnAir	ms	送信時間 (Time on Air)
symbolTime	ms	シンボル時間
payloadSymbols	なし	ペイロードシンボル数
lowDataRateOptimize	なし	低データレート最適化 (1 = 有効)
bitRate	bit/s	等価ビットレート
offTime	s	各パケット後の最小送信停止時間
packetsPerHour	なし	デューティサイクル内の1時間あたりパケット数
totalLoss	dB	総損失

呼び出し方

計算：1 回の呼び出し、リクエストとレスポンスの全体、そのエラー。
バッチ：この計算ツールをほかと組み合わせて、または掃引を、1 リクエストで。
目標値からの逆算：出力を目標値にする入力の値。

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

テキストとして送られた入力。計上はされていません。

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

1 分あたりのリクエストが多すぎます。Retry-After 付き。

同じ入力で計算ツールのページを開くLoRaリンクバジェット計算ツール — 受信感度、送信時間（Time on Air）、通信距離、この値で