Abschnitte der Dokumentation

CAN-Bus-Bit-Timing-Rechner

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

Slug can-bus-timing. Berechnet CAN-Bit-Timing-Parameter, einschließlich Prescaler, Zeitquanten, Synchronsegment, Ausbreitungssegment und Phasenpuffersegmente für eine bestimmte Baudrate und einen bestimmten Abtastpunkt

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 can-bus-timing
Name	Einheit	Bereich	Standardwert	Beschreibung
clockFreqZahl	MHz	mindestens 1	48	Peripherie-Taktfrequenz des Mikrocontrollers, die den CAN-Controller speist
baudRateZahl	kbps	mindestens 1	500	Ziel-Baudrate des CAN-Bus
samplePointZahl	%	50 … 95	87.5	Lage des Abtastpunkts in Prozent der Bitzeit (CiA 601 empfiehlt 75–87,5 %)
sjwZahl	tq	1 … 4	1	Wie weit eine Nachsynchronisation den Abtastpunkt verschieben darf; ein größerer Sprung lässt den Bus einen ungenaueren Takt verkraften, bis zur Länge des kürzeren der beiden Phasensegmente

Ausgaben

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

Ausgaben von can-bus-timing
Feld	Einheit	Beschreibung
tq	ns	Zeitquantum (TQ)
nominalBitTime	tq	Nominale Bitzeit
syncSeg	tq	Sync-Segment
propSeg	tq	Ausbreitungssegment
phase1	tq	Phasenpuffer 1 (BS1)
phase2	tq	Phasenpuffer 2 (BS2)
prescalerHauptwert	keine	Prescaler
bitRateActual	kbps	Tatsächliche Bitrate
bitRateError_pct	%	Bitratenfehler
samplePointActual	%	Tatsächlicher Abtastpunkt
oscTolerance_pct	%	Zulässige Takttoleranz

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": "can-bus-timing",
    "inputs": {
      "clockFreq": 48,
      "baudRate": 500,
      "samplePoint": 87.5,
      "sjw": 1
    }
  }'

import rftools

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

result = client.calculate("can-bus-timing", {"clockFreq": 48, "baudRate": 500, "samplePoint": 87.5, "sjw": 1})
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": "can-bus-timing",
    "inputs": {
      "clockFreq": 48,
      "baudRate": 500,
      "samplePoint": 87.5,
      "sjw": 1
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "can-bus-timing",
	  "inputs": {
	    "clockFreq": 48,
	    "baudRate": 500,
	    "samplePoint": 87.5,
	    "sjw": 1
	  }
	}`)
	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": "can-bus-timing",
  "values": {
    "tq": 125.00000000000001,
    "nominalBitTime": 16,
    "syncSeg": 1,
    "propSeg": 6,
    "phase1": 7,
    "phase2": 2,
    "prescaler": 6,
    "bitRateActual": 500,
    "bitRateError_pct": 0,
    "samplePointActual": 87.5,
    "oscTolerance_pct": 0.3125
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:can-bus-timing",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "clockFreq": {
          "min": 1,
          "max": null,
          "unit": "MHz"
        },
        "baudRate": {
          "min": 1,
          "max": null,
          "unit": "kbps"
        },
        "samplePoint": {
          "min": 50,
          "max": 95,
          "unit": "%"
        },
        "sjw": {
          "min": 1,
          "max": 4,
          "unit": "tq"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "clockFreq": 48,
      "baudRate": 500,
      "samplePoint": 87.5,
      "sjw": 1
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "clockFreq"
      ],
      "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 RechnerseiteCAN-Bus-Bit-Timing-Rechner, mit diesen Werten