Seções da documentação

Calculadora de temporização da interface de áudio I2S

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

Slug i2s-timing. Calcule o relógio de bits I2S (BCLK), o relógio de palavras (LRCLK/WCLK) e a taxa de dados para interfaces de áudio em qualquer taxa de amostragem, profundidade de bits e contagem de canais.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de i2s-timing
Nome	Unidade	Faixa	Padrão	Descrição
sampleRatenúmero	kHz	0.1 … 768	44.1	Taxa de amostragem de áudio (por exemplo, 44,1, 48, 96, 192 kHz)
bitDepthnúmero	bits	8 … 64	24	Bits por amostra (comuns: 16, 24, 32 bits)
channelsnúmero	nenhuma	1 … 32	2	Número de canais de áudio (1 para mono, 2 para estéreo)
mclknúmero	MHz	0.1 … 200	16.9344	O clock do qual o BCLK é obtido por divisão inteira: 16,9344 MHz é 384 × 44,1 kHz, 12,288 MHz é 256 × 48 kHz
rateBudgetnúmero	%	0.001 … 10	0.1	O erro de taxa de amostragem que o link suporta; ±0,1 % (1000 ppm) é a precisão de clock de Nível II da IEC 60958-3 para áudio digital de consumo

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de i2s-timing
Campo	Unidade	Descrição
bclkprincipal	MHz	Clock de bit (BCLK)
wclk	kHz	Clock de palavra (LRCLK)
bclkPeriod	ns	Período do BCLK
dataRate	Mbps	Taxa de dados
mclkDivider	nenhuma	Divisor do MCLK
bclkActual	MHz	BCLK real
sampleRateActual	kHz	Taxa de amostragem real
sampleRateError_pct	%	Erro da taxa de amostragem

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de temporização da interface de áudio I2S, com estes valores