Abschnitte der Dokumentation

Kristalllastkapazitätsrechner

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

Slug crystal-load-capacitance. Berechnen Sie die tatsächliche Lastkapazität, die von einem Quarzoszillator gesehen wird, schätzen Sie den Frequenzfehler anhand der Spezifikation ab und ermitteln Sie die empfohlenen Werte für externe Kondensatoren.

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 crystal-load-capacitance
Name	Einheit	Bereich	Standardwert	Beschreibung
clZahl	pF	1 … 100	18	Kristallspezifizierte Lastkapazität aus dem Datenblatt
cstrayZahl	pF	0 … 50	3	PCB-Streukapazität bzw. parasitäre Kapazität einschließlich IC-Eingangskapazität
c1Zahl	pF	0.1 … 1000	22	Externer Kondensator 1 (C1 = C2 ist typisch für symmetrische Anordnung)
c2Zahl	pF	0.1 … 1000	22	Externer Kondensator 2
eSeriesZahl	keine	0 … 96	0	Rundet jedes Bauteil auf den nächsten Wert der Reihe; Verhalten und Export gelten für den gerundeten Entwurf.Einer von: 0 Idealwerte · 12 E12 (10%) · 24 E24 (5%) · 48 E48 (2%) · 96 E96 (1%)

Ausgaben

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

Ausgaben von crystal-load-capacitance
Feld	Einheit	Beschreibung
clActualHauptwert	pF	Tatsächliche Lastkapazität
clError	pF	Lastkapazitätsfehler
freqError	ppm	Geschätzter Frequenzfehler
c_recommended	pF	Empfohlene Außenkappe (jeweils)

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": "crystal-load-capacitance",
    "inputs": {
      "cl": 18,
      "cstray": 3,
      "c1": 22,
      "c2": 22,
      "eSeries": 0
    }
  }'

import rftools

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

result = client.calculate("crystal-load-capacitance", {"cl": 18, "cstray": 3, "c1": 22, "c2": 22, "eSeries": 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": "crystal-load-capacitance",
    "inputs": {
      "cl": 18,
      "cstray": 3,
      "c1": 22,
      "c2": 22,
      "eSeries": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "crystal-load-capacitance",
	  "inputs": {
	    "cl": 18,
	    "cstray": 3,
	    "c1": 22,
	    "c2": 22,
	    "eSeries": 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": "crystal-load-capacitance",
  "values": {
    "clActual": 14,
    "clError": -4,
    "freqError": -111.1111111111111,
    "c_recommended": 30
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:crystal-load-capacitance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IEC 60444 / Crystal manufacturer application notes",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "cl": {
          "min": 1,
          "max": 100,
          "unit": "pF"
        },
        "cstray": {
          "min": 0,
          "max": 50,
          "unit": "pF"
        },
        "c1": {
          "min": 0.1,
          "max": 1000,
          "unit": "pF"
        },
        "c2": {
          "min": 0.1,
          "max": 1000,
          "unit": "pF"
        },
        "eSeries": {
          "min": 0,
          "max": 96,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "cl": 18,
      "cstray": 3,
      "c1": 22,
      "c2": 22,
      "eSeries": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "cl"
      ],
      "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 RechnerseiteKristalllastkapazitätsrechner, mit diesen Werten