Sections de la documentation

PCB Via Calculator

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

Slug via-calculator. Calculez le PCB en fonction de l'impédance, de la capacité, de l'inductance et de la capacité actuelle. Recevez le rapport hauteur/largeur et les avertissements DFM pour les vias traversants et aveugles. 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 via-calculator
Nom	Unité	Plage	Valeur par défaut	Description
viaDiameternombre	mm	0.1 … 6	0.3	Diamètre de perçage fini du trou de via
padDiameternombre	mm	0.2 … 10	0.6	Diamètre de la pastille en cuivre entourant le via
antipadDiameternombre	mm	0.25 … 12	1	Dégagement dans le plan autour du via. Définit à la fois le conducteur extérieur coaxial et la plaque la plus éloignée de la capacité du via. L'agrandir est le moyen le moins coûteux de réduire la capacité du via.
boardThicknessnombre	mm	0.1 … 10	1.6	Épaisseur totale du circuit imprimé (pour le rapport d'aspect et l'inductance)
dielectricConstantnombre	aucune	1 … 20	4.2	Permittivité relative du matériau de la carte
copperThicknessnombre	μm	5 … 100	25	Épaisseur de la paroi de cuivre déposée dans le barillet du via

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

Sorties

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

Sorties de via-calculator
Champ	Unité	Description
impedanceprincipale	Ω	Impédance du via
capacitancePF	pF	Capacité du via
inductanceNH	nH	Inductance du via
aspectRatio	aucune	Rapport d'aspect
currentCapacityA	A	Courant admissible

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": "via-calculator",
    "inputs": {
      "viaDiameter": 0.3,
      "padDiameter": 0.6,
      "antipadDiameter": 1,
      "boardThickness": 1.6,
      "dielectricConstant": 4.2,
      "copperThickness": 25
    }
  }'

import rftools

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

result = client.calculate("via-calculator", {
    "viaDiameter": 0.3,
    "padDiameter": 0.6,
    "antipadDiameter": 1,
    "boardThickness": 1.6,
    "dielectricConstant": 4.2,
    "copperThickness": 25,
})
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": "via-calculator",
    "inputs": {
      "viaDiameter": 0.3,
      "padDiameter": 0.6,
      "antipadDiameter": 1,
      "boardThickness": 1.6,
      "dielectricConstant": 4.2,
      "copperThickness": 25
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "via-calculator",
	  "inputs": {
	    "viaDiameter": 0.3,
	    "padDiameter": 0.6,
	    "antipadDiameter": 1,
	    "boardThickness": 1.6,
	    "dielectricConstant": 4.2,
	    "copperThickness": 25
	  }
	}`)
	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": "via-calculator",
  "values": {
    "impedance": 35.22432915063511,
    "capacitancePF": 0.558432,
    "inductanceNH": 1.1392866543013003,
    "aspectRatio": 5.333333333333334,
    "currentCapacityA": 1.6853446055708448
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:via-calculator",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IPC-2141A; IPC-2221A (2003) Figure 6-4, chart A (the chart of IPC-2221, 1998), through its published fit, for the current capacity; Howard Johnson \"High-Speed Signal Propagation\"",
    "assumptions": [
      {
        "code": "through-via",
        "text": "A plated through via in a board of one dielectric constant: its height is the full board thickness; blind, buried and back-drilled vias are not modelled."
      },
      {
        "code": "coaxial-impedance",
        "text": "Impedance treats the drilled barrel and the antipad edge as a coaxial line, Z = (η₀/2π)·ln(D_antipad/d)/√εr with η₀/2π = 59.9585 Ω; the pads, the unused stub and return vias are not modelled."
      },
      {
        "code": "ipc-2141-capacitance",
        "text": "Capacitance uses the IPC-2141A pad-to-antipad form C = 0.0554·εr·T·D/(D_antipad − D) pF, dimensions in mm."
      },
      {
        "code": "isolated-wire-inductance",
        "text": "Inductance is that of an isolated round conductor of length T and diameter d, L = 0.2·T·(ln(4T/d) + 0.5) nH; the return path through nearby planes and vias, which sets the loop inductance, is not modelled."
      },
      {
        "code": "lumped",
        "text": "Capacitance and inductance are lumped values, valid while the via is short compared with a wavelength."
      },
      {
        "code": "ipc-2221-current",
        "text": "Current capacity applies the IPC-2221 external-layer fit (k = 0.048) at a fixed 10 °C rise to the plated annulus A = π·t·(d − t)."
      },
      {
        "code": "signal-layer-ignored",
        "text": "The signal-layer input does not change any output."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "viaDiameter": {
          "min": 0.1,
          "max": 6,
          "unit": "mm"
        },
        "padDiameter": {
          "min": 0.2,
          "max": 10,
          "unit": "mm"
        },
        "antipadDiameter": {
          "min": 0.25,
          "max": 12,
          "unit": "mm"
        },
        "boardThickness": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "dielectricConstant": {
          "min": 1,
          "max": 20,
          "unit": ""
        },
        "copperThickness": {
          "min": 5,
          "max": 100,
          "unit": "μm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "viaDiameter": 0.3,
      "padDiameter": 0.6,
      "antipadDiameter": 1,
      "boardThickness": 1.6,
      "dielectricConstant": 4.2,
      "copperThickness": 25
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "viaDiameter"
      ],
      "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 calculateurPCB Via Calculator, avec ces valeurs