Sections de la documentation

Calculateur de snubber RCD — écrêtage de l'inductance de fuite d'un flyback

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

Slug rcd-clamp-snubber. Dimensionnez le circuit d'écrêtage RCD qui limite la surtension de drain d'un convertisseur flyback : puissance du clamp, facteur de tension réfléchie compris, résistance et condensateur du clamp, tension de drain crête et tension inverse nominale de la diode, à partir de l'inductance de fuite, du courant crête et de la tension d'écrêtage.

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 rcd-clamp-snubber
Nom	Unité	Plage	Valeur par défaut	Description
leakageInductancenombre	µH	au moins 0.001	1	Inductance de fuite du transformateur vue du primaire, mesurée avec le secondaire en court-circuit ; typiquement 1 à 3 % de l'inductance magnétisante
peakCurrentnombre	A	au moins 0.001	5	Courant au primaire à l'instant où l'interrupteur se bloque, à pleine charge et à tension d'entrée minimale
switchingFrequencynombre	kHz	au moins 0.001	100	Fréquence de commutation du convertisseur flyback
reflectedVoltagenombre	V	au moins 0.001	40	Tension de sortie (plus la chute du redresseur) multipliée par le rapport de transformation primaire/secondaire n ; c'est la tension que voit le primaire pendant que le secondaire conduit
clampVoltagenombre	V	au moins 0.001	80	Tension que le condensateur du clamp maintient au-dessus du rail d'entrée ; AN-4147 suggère 2 à 2,5 fois la tension réfléchie
ripplenombre	%	0.1 … 99	5	Ondulation admise sur le condensateur du clamp, en pourcentage de la tension d'écrêtage ; 5 à 10 % est la valeur habituelle
maxInputVoltagenombre	V	au moins 0	72	Tension d'entrée continue la plus élevée (pour un convertisseur alimenté sur le secteur, la crête redressée de la tension secteur la plus élevée)
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 rcd-clamp-snubber
Champ	Unité	Description
clampPowerprincipale	W	Puissance du clamp
clampResistance	kΩ	Résistance du clamp
clampCapacitance	nF	Condensateur du clamp
peakDrainVoltage	V	Tension de drain crête (V_in,max + V_sn)
diodeReverseVoltage	V	Tension inverse de la diode (tenue minimale)
leakagePower	W	Pertes dues à la seule énergie de fuite (½·L·I²·f)
lossFactor	aucune	Facteur de tension réfléchie V_sn/(V_sn − nV_o)
diodeConductionTime	ns	Temps de conduction de la diode
rippleVoltage	V	Tension d'ondulation du clamp
clampVoltageBuilt	V	Tension d'écrêtage réalisée
rippleVoltageBuilt	V	Ondulation du clamp réalisée
clampPowerBuilt	W	Puissance réalisée dans la résistance du clamp
peakDrainVoltageBuilt	V	Tension de drain crête réalisée

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": "rcd-clamp-snubber",
    "inputs": {
      "leakageInductance": 1,
      "peakCurrent": 5,
      "switchingFrequency": 100,
      "reflectedVoltage": 40,
      "clampVoltage": 80,
      "ripple": 5,
      "maxInputVoltage": 72,
      "eSeries": 0
    }
  }'

import rftools

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

result = client.calculate("rcd-clamp-snubber", {
    "leakageInductance": 1,
    "peakCurrent": 5,
    "switchingFrequency": 100,
    "reflectedVoltage": 40,
    "clampVoltage": 80,
    "ripple": 5,
    "maxInputVoltage": 72,
    "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": "rcd-clamp-snubber",
    "inputs": {
      "leakageInductance": 1,
      "peakCurrent": 5,
      "switchingFrequency": 100,
      "reflectedVoltage": 40,
      "clampVoltage": 80,
      "ripple": 5,
      "maxInputVoltage": 72,
      "eSeries": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "rcd-clamp-snubber",
	  "inputs": {
	    "leakageInductance": 1,
	    "peakCurrent": 5,
	    "switchingFrequency": 100,
	    "reflectedVoltage": 40,
	    "clampVoltage": 80,
	    "ripple": 5,
	    "maxInputVoltage": 72,
	    "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": "rcd-clamp-snubber",
  "values": {
    "clampPower": 2.5,
    "clampResistance": 2.56,
    "clampCapacitance": 78.125,
    "peakDrainVoltage": 152,
    "diodeReverseVoltage": 152,
    "leakagePower": 1.25,
    "lossFactor": 2,
    "diodeConductionTime": 125,
    "rippleVoltage": 4,
    "clampVoltageBuilt": 80,
    "rippleVoltageBuilt": 4,
    "clampPowerBuilt": 2.5,
    "peakDrainVoltageBuilt": 152
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:rcd-clamp-snubber",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Koo, Design Guidelines for RCD Snubber of Flyback Converters, Fairchild AN-4147, Rev. 1.1.0 (2006), Eqs. (2)–(5)",
    "assumptions": [
      {
        "code": "constant-clamp-voltage",
        "text": "The clamp capacitor is large enough that its voltage stays at V_sn over a switching period."
      },
      {
        "code": "clamp-returns-to-input",
        "text": "The clamp resistor and capacitor return to the input rail, so the drain peaks at V_in,max + V_sn and ringing above the clamp is not modelled."
      },
      {
        "code": "design-point",
        "text": "The leakage inductance and peak current are those at the design point (AN-4147: minimum input voltage, full load); the clamp voltage at other operating points is not computed."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "leakageInductance": {
          "min": 0.001,
          "max": null,
          "unit": "µH"
        },
        "peakCurrent": {
          "min": 0.001,
          "max": null,
          "unit": "A"
        },
        "switchingFrequency": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "reflectedVoltage": {
          "min": 0.001,
          "max": null,
          "unit": "V"
        },
        "clampVoltage": {
          "min": 0.001,
          "max": null,
          "unit": "V"
        },
        "ripple": {
          "min": 0.1,
          "max": 99,
          "unit": "%"
        },
        "maxInputVoltage": {
          "min": 0,
          "max": null,
          "unit": "V"
        },
        "eSeries": {
          "min": 0,
          "max": 96,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "leakageInductance": 1,
      "peakCurrent": 5,
      "switchingFrequency": 100,
      "reflectedVoltage": 40,
      "clampVoltage": 80,
      "ripple": 5,
      "maxInputVoltage": 72,
      "eSeries": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "leakageInductance"
      ],
      "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 RCD — écrêtage de l'inductance de fuite d'un flyback, avec ces valeurs