Secciones de la documentación

Calculadora de tolerancia y error de frecuencia de Crystal PPM

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

Slug frequency-ppm-tolerance. Convierte la tolerancia del cristal en ppm en un error de frecuencia absoluto en Hz. Apila la tolerancia inicial, la estabilidad de la temperatura y el envejecimiento en los presupuestos del peor de los casos y del RSS, con un cambio del reloj en segundos por día.

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 frequency-ppm-tolerance
Nombre	Unidad	Rango	Valor predeterminado	Descripción
nominalFrequencynúmero	MHz	0.000001 … 1000	25	Frecuencia marcada del cristal o del oscilador.
initialTolerancenúmero	ppm	0 … 1000	20	Precisión de calibración a temperatura ambiente, según la hoja de datos.
tempStabilitynúmero	ppm	0 … 1000	15	Desviación de frecuencia en todo el rango de temperatura de funcionamiento.
agingPerYearnúmero	ppm/yr	0 … 100	3	Deriva a largo plazo por año. Los cristales de corte AT suelen envejecer de 1 a 5 ppm el primer año.
yearsnúmero	years	0 … 30	3	Durante cuánto tiempo se acumula el envejecimiento.

Salidas

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

Salidas de frequency-ppm-tolerance
Campo	Unidad	Descripción
totalPpmWorstprincipal	ppm	Error total (peor caso)
totalPpmRss	ppm	Error total (RSS)
agingTotalPpm	ppm	Envejecimiento acumulado
deviationHz	Hz	Desviación de frecuencia
fMinHz	Hz	Frecuencia mínima
fMaxHz	Hz	Frecuencia máxima
spanHz	Hz	Intervalo de frecuencia total
driftSecPerDay	s/day	Deriva del reloj
driftMinPerYear	min/year	Deriva del reloj

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

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 tolerancia y error de frecuencia de Crystal PPM, con estos valores