Seções da documentação

Calculadora de tolerância e erro de frequência do Crystal PPM

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

Slug frequency-ppm-tolerance. Converta a tolerância do cristal em ppm em erro de frequência absoluto em Hz. Combina a tolerância inicial, a estabilidade da temperatura e o envelhecimento nos piores orçamentos e nos orçamentos de RSS, com variação do relógio em segundos por dia.

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 frequency-ppm-tolerance
Nome	Unidade	Faixa	Padrão	Descrição
nominalFrequencynúmero	MHz	0.000001 … 1000	25	Frequência marcada do cristal ou oscilador.
initialTolerancenúmero	ppm	0 … 1000	20	Precisão da calibração em temperatura ambiente, a partir da folha de dados.
tempStabilitynúmero	ppm	0 … 1000	15	Desvio de frequência em toda a faixa de temperatura operacional.
agingPerYearnúmero	ppm/yr	0 … 100	3	Deriva de longo prazo por ano. Cristais de corte AT têm tipicamente 1 a 5 ppm no primeiro ano.
yearsnúmero	years	0 … 30	3	Por quanto tempo o termo de envelhecimento é acumulado.

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de frequency-ppm-tolerance
Campo	Unidade	Descrição
totalPpmWorstprincipal	ppm	Erro total (pior caso)
totalPpmRss	ppm	Erro total (RSS)
agingTotalPpm	ppm	Envelhecimento acumulado
deviationHz	Hz	Desvio de frequência
fMinHz	Hz	Frequência mínima
fMaxHz	Hz	Frequência máxima
spanHz	Hz	Faixa total de frequência
driftSecPerDay	s/day	Deriva do clock
driftMinPerYear	min/year	Deriva do clock

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": "frequency-ppm-tolerance",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    }
  }'

import rftools

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

result = client.calculate("frequency-ppm-tolerance", {
    "nominalFrequency": 25,
    "initialTolerance": 20,
    "tempStability": 15,
    "agingPerYear": 3,
    "years": 3,
})
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": "frequency-ppm-tolerance",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "frequency-ppm-tolerance",
	  "inputs": {
	    "nominalFrequency": 25,
	    "initialTolerance": 20,
	    "tempStability": 15,
	    "agingPerYear": 3,
	    "years": 3
	  }
	}`)
	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": "frequency-ppm-tolerance",
  "values": {
    "totalPpmWorst": 44,
    "totalPpmRss": 26.570660511172846,
    "agingTotalPpm": 9,
    "deviationHz": 1100,
    "fMinHz": 24998900,
    "fMaxHz": 25001100,
    "spanHz": 2200,
    "driftSecPerDay": 3.8016,
    "driftMinPerYear": 23.1264
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:frequency-ppm-tolerance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IEEE 177 quartz resonator definitions; typical AT-cut crystal datasheet parameters",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "nominalFrequency": {
          "min": 0.000001,
          "max": 1000,
          "unit": "MHz"
        },
        "initialTolerance": {
          "min": 0,
          "max": 1000,
          "unit": "ppm"
        },
        "tempStability": {
          "min": 0,
          "max": 1000,
          "unit": "ppm"
        },
        "agingPerYear": {
          "min": 0,
          "max": 100,
          "unit": "ppm/yr"
        },
        "years": {
          "min": 0,
          "max": 30,
          "unit": "years"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "nominalFrequency"
      ],
      "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 tolerância e erro de frequência do Crystal PPM, com estes valores