Secciones de la documentación

Calculadora de Temporización I2S

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

Slug i2s-timing. Calcula el reloj de bit (BCLK), reloj de palabra (LRCLK) y tasa de datos para interfaces de audio I2S.

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 i2s-timing
Nombre	Unidad	Rango	Valor predeterminado	Descripción
sampleRatenúmero	kHz	0.1 … 768	44.1	Frecuencia de muestreo de audio (p. ej., 44,1, 48, 96, 192 kHz)
bitDepthnúmero	bits	8 … 64	24	Bits por muestra (común: 16, 24, 32 bits)
channelsnúmero	ninguna	1 … 32	2	Número de canales de audio (1 para mono, 2 para estéreo)
mclknúmero	MHz	0.1 … 200	16.9344	El reloj del que se obtiene BCLK dividiendo por un entero: 16,9344 MHz es 384 × 44,1 kHz, 12,288 MHz es 256 × 48 kHz
rateBudgetnúmero	%	0.001 … 10	0.1	El error de frecuencia de muestreo que admite el enlace; ±0,1 % (1000 ppm) es la precisión de reloj de nivel II de IEC 60958-3 para audio digital de consumo

Salidas

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

Salidas de i2s-timing
Campo	Unidad	Descripción
bclkprincipal	MHz	Reloj de bits (BCLK)
wclk	kHz	Reloj de palabra (LRCLK)
bclkPeriod	ns	Período BCLK
dataRate	Mbps	Velocidad de datos
mclkDivider	ninguna	Divisor de MCLK
bclkActual	MHz	BCLK real
sampleRateActual	kHz	Frecuencia de muestreo real
sampleRateError_pct	%	Error de frecuencia de muestreo

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": "i2s-timing",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    }
  }'

import rftools

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

result = client.calculate("i2s-timing", {
    "sampleRate": 44.1,
    "bitDepth": 24,
    "channels": 2,
    "mclk": 16.9344,
    "rateBudget": 0.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": "i2s-timing",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "i2s-timing",
	  "inputs": {
	    "sampleRate": 44.1,
	    "bitDepth": 24,
	    "channels": 2,
	    "mclk": 16.9344,
	    "rateBudget": 0.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": "i2s-timing",
  "values": {
    "bclk": 2.1168,
    "wclk": 44.1,
    "bclkPeriod": 472.411186696901,
    "dataRate": 2.1168,
    "mclkDivider": 8,
    "bclkActual": 2.1168,
    "sampleRateActual": 44.1,
    "sampleRateError_pct": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:i2s-timing",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Philips I2S Bus Specification, 1996",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "sampleRate": {
          "min": 0.1,
          "max": 768,
          "unit": "kHz"
        },
        "bitDepth": {
          "min": 8,
          "max": 64,
          "unit": "bits"
        },
        "channels": {
          "min": 1,
          "max": 32,
          "unit": ""
        },
        "mclk": {
          "min": 0.1,
          "max": 200,
          "unit": "MHz"
        },
        "rateBudget": {
          "min": 0.001,
          "max": 10,
          "unit": "%"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "sampleRate": 44.1,
      "bitDepth": 24,
      "channels": 2,
      "mclk": 16.9344,
      "rateBudget": 0.1
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "sampleRate"
      ],
      "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 I2S, con estos valores