Secciones de la documentación

Calculadora de Temporización del Bus CAN

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

Slug can-bus-timing. Calcula los parámetros de temporización del bus CAN: prescaler, segmentos de bit y velocidad de baudios.

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 can-bus-timing
Nombre	Unidad	Rango	Valor predeterminado	Descripción
clockFreqnúmero	MHz	al menos 1	48	Frecuencia de reloj periférico del microcontrolador que alimenta el controlador CAN
baudRatenúmero	kbps	al menos 1	500	Velocidad objetivo en baudios del bus CAN
samplePointnúmero	%	50 … 95	87.5	Posición del punto de muestreo como porcentaje del tiempo de bit (CiA 601 recomienda entre un 75 y un 87,5%)
sjwnúmero	tq	1 … 4	1	Cuánto puede mover una resincronización el punto de muestreo; un salto más ancho permite que el bus tolere un reloj menos preciso, sin superar la longitud de ninguno de los dos segmentos de fase

Salidas

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

Salidas de can-bus-timing
Campo	Unidad	Descripción
tq	ns	Cuanto de tiempo (TQ)
nominalBitTime	tq	Tiempo de bit nominal
syncSeg	tq	Segmento de sincronización
propSeg	tq	Segmento de propagación
phase1	tq	Segmento de fase 1 (BS1)
phase2	tq	Segmento de fase 2 (BS2)
prescalerprincipal	ninguna	Preescalador
bitRateActual	kbps	Velocidad de bits real
bitRateError_pct	%	Error de velocidad de bits
samplePointActual	%	Punto de muestreo real
oscTolerance_pct	%	Tolerancia de reloj permitida

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

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 Temporización del Bus CAN, con estos valores