Secciones de la documentación

Calculadora de Resonancia de Stub de Vía

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

Slug via-stub-resonance. Calcula la frecuencia de resonancia del stub de vía en PCBs de alta velocidad y el beneficio del backdrill.

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 via-stub-resonance
Nombre	Unidad	Rango	Valor predeterminado	Descripción
pcbThicknessnúmero	mm	0.1 … 10	1.6	Grosor total de la placa PCB
layernúmero	ninguna	1 … 32	4	Número de capa por donde sale la señal de la vía (contando desde arriba, capa 1)
totalLayersnúmero	ninguna	2 … 40	8	Número total de capas de cobre de PCB
ernúmero	ninguna	1 … 20	4.3	Constante dieléctrica de la PCB (FR4 = 4,3–4,8)
dataRatenúmero	Gbps	al menos 0.1	10	La velocidad de bits NRZ de la señal; para PAM4 introduzca la velocidad de símbolos, la mitad de la velocidad de bits. Su banda va desde continua hasta la frecuencia de Nyquist, la mitad de la velocidad, y su lóbulo principal hasta la propia velocidad

Salidas

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

Salidas de via-stub-resonance
Campo	Unidad	Descripción
stubLength	mm	Longitud del stub de la vía
resonantFreqprincipal	GHz	Frecuencia de resonancia del stub
notchDepth	dB	Profundidad de muesca (aproximada)
backdrillBenefit	GHz	Frecuencia tras el retrotaladrado
nyquistFreq	GHz	Frecuencia de Nyquist
resonancesInBand	ninguna	Resonancias del stub en la banda de señal
resonancesNearBand	ninguna	Resonancias en el lóbulo principal

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": "via-stub-resonance",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    }
  }'

import rftools

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

result = client.calculate("via-stub-resonance", {
    "pcbThickness": 1.6,
    "layer": 4,
    "totalLayers": 8,
    "er": 4.3,
    "dataRate": 10,
})
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-stub-resonance",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "via-stub-resonance",
	  "inputs": {
	    "pcbThickness": 1.6,
	    "layer": 4,
	    "totalLayers": 8,
	    "er": 4.3,
	    "dataRate": 10
	  }
	}`)
	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-stub-resonance",
  "values": {
    "stubLength": 0.8,
    "resonantFreq": 45.17898781603898,
    "notchDepth": -20,
    "backdrillBenefit": 135.53696344811695,
    "nyquistFreq": 5,
    "resonancesInBand": 0,
    "resonancesNearBand": 0
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:via-stub-resonance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Eric Bogatin, \"Signal and Power Integrity Simplified\" 3rd ed.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "pcbThickness": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "layer": {
          "min": 1,
          "max": 32,
          "unit": ""
        },
        "totalLayers": {
          "min": 2,
          "max": 40,
          "unit": ""
        },
        "er": {
          "min": 1,
          "max": 20,
          "unit": ""
        },
        "dataRate": {
          "min": 0.1,
          "max": null,
          "unit": "Gbps"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "pcbThickness": 1.6,
      "layer": 4,
      "totalLayers": 8,
      "er": 4.3,
      "dataRate": 10
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "pcbThickness"
      ],
      "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 Resonancia de Stub de Vía, con estos valores