Abschnitte der Dokumentation

Crystal PPM-Toleranz- und Frequenzfehlerrechner

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

Slug frequency-ppm-tolerance. Rechnen Sie die Kristalltoleranz in ppm in den absoluten Frequenzfehler in Hz um. Stapelt Anfangstoleranz, Temperaturstabilität und Alterung in Worst-Case-Budgets und RSS-Budgets auf, wobei die Zeitabweichung in Sekunden pro Tag erfolgt.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von frequency-ppm-tolerance
Name	Einheit	Bereich	Standardwert	Beschreibung
nominalFrequencyZahl	MHz	0.000001 … 1000	25	Aufgedruckte Frequenz des Quarzes oder Oszillators.
initialToleranceZahl	ppm	0 … 1000	20	Kalibrierungsgenauigkeit bei Raumtemperatur, aus dem Datenblatt.
tempStabilityZahl	ppm	0 … 1000	15	Frequenzabweichung über den gesamten Betriebstemperaturbereich.
agingPerYearZahl	ppm/yr	0 … 100	3	Langzeitdrift pro Jahr. AT-Schnitt-Quarze liegen im ersten Jahr typisch bei 1–5 ppm.
yearsZahl	years	0 … 30	3	Zeitraum, über den die Alterung aufsummiert wird.

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von frequency-ppm-tolerance
Feld	Einheit	Beschreibung
totalPpmWorstHauptwert	ppm	Gesamtfehler (Worst Case)
totalPpmRss	ppm	Gesamtfehler (RSS)
agingTotalPpm	ppm	Kumulierte Alterung
deviationHz	Hz	Frequenzabweichung
fMinHz	Hz	Minimale Frequenz
fMaxHz	Hz	Maximale Frequenz
spanHz	Hz	Gesamtfrequenzspanne
driftSecPerDay	s/day	Taktdrift
driftMinPerYear	min/year	Taktdrift

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

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

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

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

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteCrystal PPM-Toleranz- und Frequenzfehlerrechner, mit diesen Werten