Secciones de la documentación

Calculadora de Par Diferencial PCB

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

Slug differential-pair. Calcula el ancho y separación de pistas en par diferencial para lograr la impedancia diferencial deseada.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de differential-pair
Nombre	Unidad	Rango	Valor predeterminado	Descripción
traceWidthnúmero	mm	0.05 … 5	0.15	Anchura de cada traza individual en el par diferencial
traceSpacingnúmero	mm	0.05 … 5	0.15	Espacio de borde a borde entre las dos trazas
substrateHeightnúmero	mm	0.05 … 5	0.1	Grosor dieléctrico entre la traza y el plano de tierra
dielectricConstantnúmero	ninguna	1 … 20	4.2	Permitividad relativa del material del sustrato
copperThicknessnúmero	μm	5 … 200	17.5	Grosor de la traza de cobre (metalizado + base)
frequencynúmero	GHz	0.001 … 300	2.4	Se usa solo para la longitud de onda guiada del modo diferencial (impar); las impedancias no dependen de ello en este modelo

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de differential-pair
Campo	Unidad	Descripción
zdiffprincipal	Ω	Impedancia diferencial
zcom	Ω	Impedancia de modo común
z0single	Ω	Impedancia de un solo extremo
zodd	Ω	Impedancia en modo impar
zeven	Ω	Impedancia en modo par
erEffOdd	ninguna	Er efectivo en modo impar
erEffEven	ninguna	Er efectivo en modo par
inValidatedRange	ninguna	Dentro del rango validado
guidedWavelength	mm	Longitud de onda guiada (modo impar)
quarterWavelength	mm	Cuarto de longitud de onda (modo impar)

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "differential-pair",
    "inputs": {
      "traceWidth": 0.15,
      "traceSpacing": 0.15,
      "substrateHeight": 0.1,
      "dielectricConstant": 4.2,
      "copperThickness": 17.5,
      "frequency": 2.4
    }
  }'

import rftools

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

result = client.calculate("differential-pair", {
    "traceWidth": 0.15,
    "traceSpacing": 0.15,
    "substrateHeight": 0.1,
    "dielectricConstant": 4.2,
    "copperThickness": 17.5,
    "frequency": 2.4,
})
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": "differential-pair",
    "inputs": {
      "traceWidth": 0.15,
      "traceSpacing": 0.15,
      "substrateHeight": 0.1,
      "dielectricConstant": 4.2,
      "copperThickness": 17.5,
      "frequency": 2.4
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "differential-pair",
	  "inputs": {
	    "traceWidth": 0.15,
	    "traceSpacing": 0.15,
	    "substrateHeight": 0.1,
	    "dielectricConstant": 4.2,
	    "copperThickness": 17.5,
	    "frequency": 2.4
	  }
	}`)
	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": "differential-pair",
  "values": {
    "zdiff": 99.91396531405557,
    "zcom": 29.82840260591584,
    "z0single": 54.90377067499788,
    "zodd": 49.95698265702779,
    "zeven": 59.65680521183168,
    "erEffOdd": 2.9313216677405416,
    "erEffEven": 3.362873577002329,
    "inValidatedRange": 1,
    "guidedWavelength": 72.95880669275142,
    "quarterWavelength": 18.239701673187856
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:differential-pair",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "E. Hammerstad and Ø. Jensen, “Accurate Models for Microstrip Computer-Aided Design”, IEEE MTT-S International Microwave Symposium Digest, 1980 (single line); coupling fitted to rftools.io’s 2-D method-of-moments solver (src/lib/pcb/__tests__/solver), within 2% on a mode impedance over W/H 0.2–4 and S/H 0.1–3.",
    "assumptions": [
      {
        "code": "quasi-static",
        "text": "Quasi-static: the mode impedances and effective permittivities are the low-frequency values; dispersion is not modelled."
      },
      {
        "code": "bare-microstrip",
        "text": "Bare surface pair: air above the traces, with no soldermask or cover layer, on one homogeneous substrate over a solid ground plane."
      },
      {
        "code": "symmetric-pair",
        "text": "Two identical traces of the same width and thickness; Zdiff = 2·Zodd and Zcommon = Zeven/2."
      },
      {
        "code": "fitted-coupling",
        "text": "Coupling is fitted, as ratios to the Hammerstad–Jensen single line, to a 2-D method-of-moments solver over trace width 0.2–4× and spacing 0.1–3× the substrate height (published bound 2% on a mode impedance); outside that range the result is extrapolated and inValidatedRange reads 0."
      },
      {
        "code": "thickness-single-line-only",
        "text": "Copper thickness enters only through the single line’s effective-width correction; the added sidewall coupling across the gap is not modelled."
      },
      {
        "code": "lossless",
        "text": "Lossless: conductor and dielectric losses are neglected."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "traceWidth": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "traceSpacing": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "substrateHeight": {
          "min": 0.05,
          "max": 5,
          "unit": "mm"
        },
        "dielectricConstant": {
          "min": 1,
          "max": 20,
          "unit": ""
        },
        "copperThickness": {
          "min": 5,
          "max": 200,
          "unit": "μm"
        },
        "frequency": {
          "min": 0.001,
          "max": 300,
          "unit": "GHz"
        }
      },
      "outside": [],
      "model": {
        "description": "trace width 0.2–4× and spacing 0.1–3× the substrate height",
        "worstCaseError": 0.02,
        "inside": true
      }
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "traceWidth": 0.15,
      "traceSpacing": 0.15,
      "substrateHeight": 0.1,
      "dielectricConstant": 4.2,
      "copperThickness": 17.5,
      "frequency": 2.4
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "traceWidth"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Una entrada enviada como texto. No se contó nada.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de Par Diferencial PCB, con estos valores