문서 섹션

LoRa 링크 버짓 계산기 — 수신 감도, 전송 시간(Time on Air) 및 통신 거리

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

슬러그 lora-link-budget. Semtech SX1276 공식으로 LoRa 링크 버짓을 계산합니다. 확산 계수(SF)와 대역폭별 수신 감도, 심볼 시간, 저데이터율 최적화를 자동 적용한 전송 시간(Time on Air), 듀티 사이클 휴지 시간, 자유 공간 또는 Okumura–Hata 경로 손실, 링크 마진과 최대 통신 거리를 구합니다.

입력

이 입력을 표시된 단위로 모두 inputs에 담아 보내세요. 대부분 필수이며, 하나라도 빠진 호출은 거부되고(400) 비용이 들지 않습니다. 생략해도 계산할 수 있는 입력은 표시된 기본값을 사용합니다. 범위 밖의 입력도 계산되며 출처 정보에 표시됩니다.

lora-link-budget의 입력
이름	단위	범위	기본값	설명
spreadingFactor숫자	없음	6 … 12	9	심볼당 칩 수는 2^SF입니다. 한 단계 올릴 때마다 감도가 약 2.5 dB 좋아지고 전송 시간은 두 배가 됩니다
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	자유 공간, 또는 도시·교외·농촌 경로용 Okumura–Hata다음 중 하나: 0 자유 공간 · 1 Okumura–Hata, 도시(중소 도시) · 2 Okumura–Hata, 도시(대도시) · 3 Okumura–Hata, 교외 · 4 Okumura–Hata, 농촌 준개활지 · 5 Okumura–Hata, 농촌 개활지
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	없음	듀티 사이클 내 시간당 패킷 수
totalLoss	dB	총 손실

호출 방법

계산: 호출 한 번, 요청과 응답 전체, 그리고 오류.
배치: 이 계산기를 다른 계산기와 함께, 또는 스윕을, 요청 하나로.
목표값 역산: 출력을 목표값으로 만드는 입력 하나의 값.

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) 및 통신 거리, 이 값으로