Sections de la documentation

Calculateur de débit en bauds et de chronométrage UART

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

Slug uart-baud-rate. Calculez la synchronisation des trames UART, le débit et le diviseur de registre USART BRR à partir du débit en bauds, du format des données et de la fréquence d'horloge du microcontrôleur. Identifiez les erreurs de débit pour une communication série fiable.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de uart-baud-rate
Nom	Unité	Plage	Valeur par défaut	Description
baudRatenombre	bps	300 … 4000000	115200	Débit en bauds série en bits par seconde
dataBitsnombre	bits	5 … 9	8	Nombre de bits de données par trame (généralement 8)
stopBitsnombre	bits	1 … 2	1	1 bit d'arrêt est standard ; 2 peuvent être utilisés pour les récepteurs lents
paritynombre	bits	0 … 2	0	Bits de paritéL'une de : 0 Aucune · 1 Paire ou impaire (1 bit)
clockFreqnombre	MHz	1 … 1000	16	Fréquence d'horloge du périphérique MCU (APB) utilisée pour le calcul du diviseur BRR
oversamplingnombre	aucune	8 … 16	16	Échantillons par bit : 16× est le mode habituel ; 8× (STM32 OVER8, AVR U2X) double le débit maximal au détriment de l'immunité au bruitL'une de : 16 16× · 8 8×
divisorFractionnombre	aucune	0 … 1	0	Un diviseur entier (AVR UBRR, le 16550) ou un diviseur avec une partie fractionnaire de 1/OS (STM32 USARTDIV), qui approche de bien plus près la plupart des débitsL'une de : 0 Entier · 1 Avec fraction (1/OS)
errorBudgetnombre	%	0.1 … 10	2	L'erreur de débit que la liaison tolère, ± pour les deux extrémités ensemble ; environ ±2 % avec un suréchantillonnage 16× et des trames 8N1

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de uart-baud-rate
Champ	Unité	Description
frameBits	bits	Bits par trame
bitPeriod_us	µs	Durée d'un bit
framePeriod_us	µs	Durée d'une trame
framesPerSecond	fps	Trames par seconde
throughputKbps	kbps	Débit utile
brrDivisor	aucune	Diviseur BRR
actualBaudRate	bps	Débit en bauds réel
baudRateError_pctprincipale	%	Erreur de débit en bauds
divisorSet	aucune	Diviseur réglé
baudError_pct	%	Erreur de débit signée
stopSampleOffset_bits	bits	Décalage d'échantillonnage du bit d'arrêt

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "uart-baud-rate",
    "inputs": {
      "baudRate": 115200,
      "dataBits": 8,
      "stopBits": 1,
      "parity": 0,
      "clockFreq": 16,
      "oversampling": 16,
      "divisorFraction": 0,
      "errorBudget": 2
    }
  }'

import rftools

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

result = client.calculate("uart-baud-rate", {
    "baudRate": 115200,
    "dataBits": 8,
    "stopBits": 1,
    "parity": 0,
    "clockFreq": 16,
    "oversampling": 16,
    "divisorFraction": 0,
    "errorBudget": 2,
})
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": "uart-baud-rate",
    "inputs": {
      "baudRate": 115200,
      "dataBits": 8,
      "stopBits": 1,
      "parity": 0,
      "clockFreq": 16,
      "oversampling": 16,
      "divisorFraction": 0,
      "errorBudget": 2
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "uart-baud-rate",
	  "inputs": {
	    "baudRate": 115200,
	    "dataBits": 8,
	    "stopBits": 1,
	    "parity": 0,
	    "clockFreq": 16,
	    "oversampling": 16,
	    "divisorFraction": 0,
	    "errorBudget": 2
	  }
	}`)
	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": "uart-baud-rate",
  "values": {
    "frameBits": 10,
    "bitPeriod_us": 8.680555555555555,
    "framePeriod_us": 86.80555555555556,
    "framesPerSecond": 11520,
    "throughputKbps": 92.16,
    "brrDivisor": 8.680555555555555,
    "actualBaudRate": 111111.11111111111,
    "baudRateError_pct": 3.549382716049384,
    "divisorSet": 9,
    "baudError_pct": -3.549382716049384,
    "stopSampleOffset_bits": 0.34959999999999947
  },
  "warnings": [
    "Baud rate error exceeds 2% — may cause framing errors"
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:uart-baud-rate",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Microchip ATmega328P datasheet, USART baud rate generator (UBRRn, the whole divisor); STM32 Reference Manual RM0008 §27.3.4 (USARTDIV, the fraction); ST AN2908",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "baudRate": {
          "min": 300,
          "max": 4000000,
          "unit": "bps"
        },
        "dataBits": {
          "min": 5,
          "max": 9,
          "unit": "bits"
        },
        "stopBits": {
          "min": 1,
          "max": 2,
          "unit": "bits"
        },
        "parity": {
          "min": 0,
          "max": 2,
          "unit": "bits"
        },
        "clockFreq": {
          "min": 1,
          "max": 1000,
          "unit": "MHz"
        },
        "oversampling": {
          "min": 8,
          "max": 16,
          "unit": ""
        },
        "divisorFraction": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "errorBudget": {
          "min": 0.1,
          "max": 10,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "baudRate": 115200,
      "dataBits": 8,
      "stopBits": 1,
      "parity": 0,
      "clockFreq": 16,
      "oversampling": 16,
      "divisorFraction": 0,
      "errorBudget": 2
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "baudRate"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de débit en bauds et de chronométrage UART, avec ces valeurs