Sections de la documentation

Calculateur d'impédance d'empilement de circuit imprimé 4 couches

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

Slug stackup-builder. Calculez les largeurs de piste pour une impédance cible sur un empilement de circuit imprimé à 4 couches : microruban sur L1 au-dessus du plan L2, ligne triplaque sur L3 entre les plans L2 et L4. Saisissez les épaisseurs de diélectrique, la constante diélectrique et le poids du cuivre pour 50 ohms ou un Z0 personnalisé. Résultats instantanés et gratuits.

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 stackup-builder
Nom	Unité	Plage	Valeur par défaut	Description
targetImpedancenombre	Ω	25 … 150	50	Impédance caractéristique cible pour le calcul de la largeur de trace
dielectricH1nombre	mm	0.05 … 2	0.2	Épaisseur du préimprégné entre L1 (en haut) et L2
dielectricH2nombre	mm	0.1 … 5	1.2	Épaisseur du noyau entre L2 et L3
dielectricH3nombre	mm	0.05 … 2	0.2	Épaisseur du préimprégné entre L3 et L4 (en bas)
copperWeightnombre	oz	0.5 … 3	1	Épaisseur de la feuille de cuivre (1 oz = 35 μm)
dielectricConstantnombre	aucune	2 … 12	4.2	Permittivité relative du matériau de la carte à la fréquence de conception

Retirées, toujours acceptées et ignorées avec un avertissement : layerCount (Layer Count, 12 octobre 2026).

Sorties

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

Sorties de stackup-builder
Champ	Unité	Description
traceWidthL1mmprincipale	mm	Largeur de piste L1 (surface)
traceWidthL3mm	mm	Largeur de piste L3 (intérieure)
achievedImpedanceL1	Ω	Z₀ atteinte L1
achievedImpedanceL3	Ω	Z₀ atteinte L3
totalThicknessMm	mm	Épaisseur totale de la carte

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": "stackup-builder",
    "inputs": {
      "targetImpedance": 50,
      "dielectricH1": 0.2,
      "dielectricH2": 1.2,
      "dielectricH3": 0.2,
      "copperWeight": 1,
      "dielectricConstant": 4.2
    }
  }'

import rftools

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

result = client.calculate("stackup-builder", {
    "targetImpedance": 50,
    "dielectricH1": 0.2,
    "dielectricH2": 1.2,
    "dielectricH3": 0.2,
    "copperWeight": 1,
    "dielectricConstant": 4.2,
})
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": "stackup-builder",
    "inputs": {
      "targetImpedance": 50,
      "dielectricH1": 0.2,
      "dielectricH2": 1.2,
      "dielectricH3": 0.2,
      "copperWeight": 1,
      "dielectricConstant": 4.2
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "stackup-builder",
	  "inputs": {
	    "targetImpedance": 50,
	    "dielectricH1": 0.2,
	    "dielectricH2": 1.2,
	    "dielectricH3": 0.2,
	    "copperWeight": 1,
	    "dielectricConstant": 4.2
	  }
	}`)
	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": "stackup-builder",
  "values": {
    "traceWidthL1mm": 0.35795746280812923,
    "traceWidthL3mm": 0.2587100647562412,
    "achievedImpedanceL1": 49.99999999999937,
    "achievedImpedanceL3": 49.99999999999934,
    "totalThicknessMm": 1.7399999999999998
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:stackup-builder",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Hammerstad & Jensen (1980); Cohn (1954), offset stripline; IPC-2141A",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "targetImpedance": {
          "min": 25,
          "max": 150,
          "unit": "Ω"
        },
        "dielectricH1": {
          "min": 0.05,
          "max": 2,
          "unit": "mm"
        },
        "dielectricH2": {
          "min": 0.1,
          "max": 5,
          "unit": "mm"
        },
        "dielectricH3": {
          "min": 0.05,
          "max": 2,
          "unit": "mm"
        },
        "copperWeight": {
          "min": 0.5,
          "max": 3,
          "unit": "oz"
        },
        "dielectricConstant": {
          "min": 2,
          "max": 12,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "targetImpedance": 50,
      "dielectricH1": 0.2,
      "dielectricH2": 1.2,
      "dielectricH3": 0.2,
      "copperWeight": 1,
      "dielectricConstant": 4.2
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "targetImpedance"
      ],
      "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 d'impédance d'empilement de circuit imprimé 4 couches, avec ces valeurs