문서 섹션

RTD 온도 계산기 (PT100/PT1000)

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

슬러그 rtd-temperature. PT100 또는 PT1000 저항에서 온도를 계산합니다. 측정된 옴을 입력하면 즉시 °C를 얻을 수 있습니다. 캘린더-밴 듀센 선형 근사값을 사용합니다. 일반적인 PT100 값 (119.4Ω = 50°C, 138.5Ω = 100°C) 에 대한 프리셋이 포함되어 있습니다.

입력

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

rtd-temperature의 입력
이름	단위	범위	기본값	설명
resistance숫자	Ω	1 이상	119.4	측정된 RTD 저항. 0 °C에서 PT100=100 Ω, PT1000=1000 Ω.
r0숫자	Ω	1 이상	100	0 °C에서의 공칭 저항 (예: PT100: 100, PT1000: 1000)
alpha숫자	°C⁻¹	0.001 … 0.01	0.003851	저항 온도 계수. IEC 60751 표준: 0.003851 °C⁻¹
fixedResistor숫자	Ω	1 이상	150	분압기의 고정 저항입니다. RTD가 로우 사이드일 때는 기준 전압과 ADC 노드 사이에, 하이 사이드일 때는 ADC 노드와 접지 사이에 연결됩니다. RTD 저항 범위의 중간값 근처로 정하면 분해능이 가장 고르게 됩니다.
adcRef숫자	V	0.1 … 50	3.3	분압기 양단의 전압이며, ADC 풀 스케일이기도 합니다 (레시오메트릭 방식)
adcBits숫자	bit	1 … 24	12	ADC 분해능 (비트)
sensorPosition숫자	없음	제한 없음	0	로우 사이드: RTD가 ADC 노드와 접지 사이에 있습니다. 하이 사이드: 기준 전압과 노드 사이에 있습니다.다음 중 하나: 0 로우 사이드 · 1 하이 사이드

출력

values에 이름별로 반환됩니다. 상한이 없거나 정의되지 않는 값은 null입니다.

rtd-temperature의 출력
필드	단위	설명
temperature주요 값	°C	온도
resistanceAt100C	Ω	100 °C에서의 저항
dividerVoltage	V	분압기 출력
adcCode	없음	ADC 코드
resolution	°C/LSB	분해능

호출 방법

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

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "rtd-temperature",
    "inputs": {
      "resistance": 119.4,
      "r0": 100,
      "alpha": 0.003851,
      "fixedResistor": 150,
      "adcRef": 3.3,
      "adcBits": 12,
      "sensorPosition": 0
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("rtd-temperature", {
    "resistance": 119.4,
    "r0": 100,
    "alpha": 0.003851,
    "fixedResistor": 150,
    "adcRef": 3.3,
    "adcBits": 12,
    "sensorPosition": 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": "rtd-temperature",
    "inputs": {
      "resistance": 119.4,
      "r0": 100,
      "alpha": 0.003851,
      "fixedResistor": 150,
      "adcRef": 3.3,
      "adcBits": 12,
      "sensorPosition": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "rtd-temperature",
	  "inputs": {
	    "resistance": 119.4,
	    "r0": 100,
	    "alpha": 0.003851,
	    "fixedResistor": 150,
	    "adcRef": 3.3,
	    "adcBits": 12,
	    "sensorPosition": 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": "rtd-temperature",
  "values": {
    "temperature": 50.37652557777202,
    "resistanceAt100C": 138.51,
    "dividerVoltage": 1.4625835189309577,
    "adcCode": 1815,
    "resolution": 0.3067400309984419
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:rtd-temperature",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "resistance": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "r0": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "alpha": {
          "min": 0.001,
          "max": 0.01,
          "unit": "°C⁻¹"
        },
        "fixedResistor": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "adcRef": {
          "min": 0.1,
          "max": 50,
          "unit": "V"
        },
        "adcBits": {
          "min": 1,
          "max": 24,
          "unit": "bit"
        },
        "sensorPosition": {
          "min": null,
          "max": null,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "resistance": 119.4,
      "r0": 100,
      "alpha": 0.003851,
      "fixedResistor": 150,
      "adcRef": 3.3,
      "adcBits": 12,
      "sensorPosition": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "resistance"
      ],
      "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가 함께 옵니다.

같은 입력으로 계산기 페이지 열기RTD 온도 계산기 (PT100/PT1000), 이 값으로