Sections de la documentation

Calculateur de snubber RC — amortir les oscillations du nœud de commutation en deux mesures

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

Slug rc-snubber. Dimensionnez un snubber RC d'amortissement à partir des oscillations que vous mesurez : la fréquence d'oscillation seule, puis avec un condensateur connu ajouté, donne la capacité et l'inductance parasites, la résistance et le condensateur du snubber, la puissance dissipée dans la résistance et la constante de temps, comparée au temps de conduction minimal.

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 rc-snubber
Nom	Unité	Plage	Valeur par défaut	Description
ringFrequencynombre	MHz	au moins 0.001	100	Fréquence des oscillations au blocage, mesurée aux bornes de l'interrupteur sans snubber
addedCapacitancenombre	pF	au moins 0.001	100	Condensateur connu placé aux bornes de l'interrupteur pour la deuxième mesure ; choisissez-le pour diviser à peu près par deux la fréquence d'oscillation
ringFrequencyAddednombre	MHz	au moins 0.001	50	Fréquence d'oscillation mesurée avec le condensateur de test aux bornes de l'interrupteur ; elle doit être inférieure à la première
capacitorMultiplenombre	×	au moins 0.1	4	Condensateur du snubber exprimé en multiple de la capacité parasite ; 2 à 4 est la valeur habituelle, et une valeur plus grande amortit davantage mais dissipe plus
switchVoltagenombre	V	au moins 0.001	48	Tension à laquelle le condensateur du snubber se charge à chaque transition, normalement la tension aux bornes de l'interrupteur ouvert
switchingFrequencynombre	kHz	au moins 0.001	500	Fréquence à laquelle l'interrupteur devient passant puis se bloque ; le condensateur se charge et se décharge une fois chacun par cycle
minOnTimenombre	ns	au moins 0.001	100	Durée la plus courte pendant laquelle l'interrupteur reste passant ; le condensateur du snubber se décharge pendant ce temps à travers la résistance et l'interrupteur
eSeriesnombre	aucune	0 … 96	0	Arrondit chaque composant à la valeur la plus proche de la série ; la réponse et l'export sont ceux du circuit arrondi.L'une de : 0 Valeurs idéales · 12 E12 (10 %) · 24 E24 (5 %) · 48 E48 (2 %) · 96 E96 (1 %)

Sorties

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

Sorties de rc-snubber
Champ	Unité	Description
snubberResistanceprincipale	Ω	Résistance du snubber (R = Z₀)
snubberCapacitance	pF	Condensateur du snubber
resistorPower	W	Puissance dans la résistance (C_s·V²·f_sw)
parasiticCapacitance	pF	Capacité parasite
parasiticInductance	nH	Inductance parasite
characteristicImpedance	Ω	Impédance caractéristique de la boucle oscillante
timeConstant	ns	Constante de temps du snubber (R·C_s)

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": "rc-snubber",
    "inputs": {
      "ringFrequency": 100,
      "addedCapacitance": 100,
      "ringFrequencyAdded": 50,
      "capacitorMultiple": 4,
      "switchVoltage": 48,
      "switchingFrequency": 500,
      "minOnTime": 100,
      "eSeries": 0
    }
  }'

import rftools

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

result = client.calculate("rc-snubber", {
    "ringFrequency": 100,
    "addedCapacitance": 100,
    "ringFrequencyAdded": 50,
    "capacitorMultiple": 4,
    "switchVoltage": 48,
    "switchingFrequency": 500,
    "minOnTime": 100,
    "eSeries": 0,
})
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": "rc-snubber",
    "inputs": {
      "ringFrequency": 100,
      "addedCapacitance": 100,
      "ringFrequencyAdded": 50,
      "capacitorMultiple": 4,
      "switchVoltage": 48,
      "switchingFrequency": 500,
      "minOnTime": 100,
      "eSeries": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "rc-snubber",
	  "inputs": {
	    "ringFrequency": 100,
	    "addedCapacitance": 100,
	    "ringFrequencyAdded": 50,
	    "capacitorMultiple": 4,
	    "switchVoltage": 48,
	    "switchingFrequency": 500,
	    "minOnTime": 100,
	    "eSeries": 0
	  }
	}`)
	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": "rc-snubber",
  "values": {
    "snubberResistance": 47.74648292756859,
    "snubberCapacitance": 133.33333333333334,
    "resistorPower": 0.1536,
    "parasiticCapacitance": 33.333333333333336,
    "parasiticInductance": 75.9908877317533,
    "characteristicImpedance": 47.74648292756859,
    "timeConstant": 6.366197723675813
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:rc-snubber",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Todd, Snubber Circuits: Theory, Design and Application, Unitrode (1993), TI SLUP100, pp. 2-4 and 2-5",
    "assumptions": [
      {
        "code": "single-lc-loop",
        "text": "The ringing is one parasitic inductance and capacitance, and the inductance does not change when the test capacitor is added."
      },
      {
        "code": "damping-at-z0",
        "text": "The snubber resistor equals the loop's characteristic impedance, which damps it near Q = 1 when the snubber capacitor is several times the parasitic one."
      },
      {
        "code": "full-charge-each-transition",
        "text": "The snubber capacitor charges to the switched voltage and discharges fully once each per cycle, so the resistor dissipates C_s·V²·f_sw whatever its value; ringing overshoot adds to this."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "ringFrequency": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "addedCapacitance": {
          "min": 0.001,
          "max": null,
          "unit": "pF"
        },
        "ringFrequencyAdded": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "capacitorMultiple": {
          "min": 0.1,
          "max": null,
          "unit": "×"
        },
        "switchVoltage": {
          "min": 0.001,
          "max": null,
          "unit": "V"
        },
        "switchingFrequency": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "minOnTime": {
          "min": 0.001,
          "max": null,
          "unit": "ns"
        },
        "eSeries": {
          "min": 0,
          "max": 96,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "ringFrequency": 100,
      "addedCapacitance": 100,
      "ringFrequencyAdded": 50,
      "capacitorMultiple": 4,
      "switchVoltage": 48,
      "switchingFrequency": 500,
      "minOnTime": 100,
      "eSeries": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "ringFrequency"
      ],
      "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 snubber RC — amortir les oscillations du nœud de commutation en deux mesures, avec ces valeurs