Seções da documentação

Calculadora de seleção de capacitores de desacoplamento

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

Slug decoupling-capacitor. Calcule o capacitor de desacoplamento SRF, a impedância na frequência alvo e o número de tampas necessárias para a integridade da energia. Inclui modelagem ESR/ESL. Resultados gratuitos e instantâneos.

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 decoupling-capacitor
Nome	Unidade	Faixa	Padrão	Descrição
capacitancenúmero	nF	no mínimo 0.001	100	Capacitância
esrnúmero	mΩ	no mínimo 0.1	50	Resistência em série equivalente do capacitor
eslnúmero	nH	no mínimo 0.01	1	Indutância em série equivalente (parasita de embalagem)
targetFreqnúmero	MHz	no mínimo 0.001	100	Frequência na qual a impedância de desacoplamento é avaliada
supplyImpedancenúmero	mΩ	no mínimo 0.001	10	Impedância máxima permitida de PDN na frequência alvo

Saídas

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

Saídas de decoupling-capacitor
Campo	Unidade	Descrição
selfResonantFreq	MHz	Frequência autorressonante
impedanceAtSrf	mΩ	Impedância no SRF
impedanceAtTarget	mΩ	Impedância na frequência alvo
effectiveRange	MHz	Alcance de desvio efetivo (superior)
numCapacitorsprincipal	nenhuma	Capacitores necessários

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": "decoupling-capacitor",
    "inputs": {
      "capacitance": 100,
      "esr": 50,
      "esl": 1,
      "targetFreq": 100,
      "supplyImpedance": 10
    }
  }'

import rftools

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

result = client.calculate("decoupling-capacitor", {
    "capacitance": 100,
    "esr": 50,
    "esl": 1,
    "targetFreq": 100,
    "supplyImpedance": 10,
})
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": "decoupling-capacitor",
    "inputs": {
      "capacitance": 100,
      "esr": 50,
      "esl": 1,
      "targetFreq": 100,
      "supplyImpedance": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "decoupling-capacitor",
	  "inputs": {
	    "capacitance": 100,
	    "esr": 50,
	    "esl": 1,
	    "targetFreq": 100,
	    "supplyImpedance": 10
	  }
	}`)
	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": "decoupling-capacitor",
  "values": {
    "selfResonantFreq": 15.915494309189533,
    "impedanceAtSrf": 50,
    "impedanceAtTarget": 614.4407855950648,
    "effectiveRange": 47.7464829275686,
    "numCapacitors": 62
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:decoupling-capacitor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "capacitance": {
          "min": 0.001,
          "max": null,
          "unit": "nF"
        },
        "esr": {
          "min": 0.1,
          "max": null,
          "unit": "mΩ"
        },
        "esl": {
          "min": 0.01,
          "max": null,
          "unit": "nH"
        },
        "targetFreq": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "supplyImpedance": {
          "min": 0.001,
          "max": null,
          "unit": "mΩ"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "capacitance": 100,
      "esr": 50,
      "esl": 1,
      "targetFreq": 100,
      "supplyImpedance": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "capacitance"
      ],
      "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 seleção de capacitores de desacoplamento, com estes valores