Seções da documentação

Calculadora de padstack e anel anular

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

Slug padstack-annular-ring. Calcule o diâmetro mínimo da almofada e o anel anular de acordo com IPC-6012 para vias passantes e blocos de componentes.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de padstack-annular-ring
Nome	Unidade	Faixa	Padrão	Descrição
drillDiameternúmero	mm	0.1 … 6.35	0.3	Diâmetro da broca
platingThicknessnúmero	µm	18 … 50	25	Espessura da metalização
fabricationAllowancenúmero	mm	0 … 0.15	0.05	Margem de fabricação
ipcClassnúmero	nenhuma	2 … 3	2	Classe IPCUm de: 2 Classe 2 · 3 Classe 3
boardThicknessnúmero	mm	0.2 … 6	1.6	Espessura da placa
standardnúmero	nenhuma	0 … 1	0	IPC-2221B: a regra de projeto a + 2b + c. IPC-6012E: o anel de aceitação da Classe 3 após a margem de fabricaçãoUm de: 0 IPC-2221B · 1 IPC-6012E
producibilityLevelnúmero	nenhuma	0 … 2	1	Define a margem de fabricação c da IPC-2221B Tabela 9-1: 0,4, 0,25 ou 0,2 mmUm de: 0 Nível A (geral) · 1 Nível B (moderado) · 2 Nível C (alto)
padDiameternúmero	mm	0.1 … 10	0.65	O diâmetro da ilha na sua placa, comparado com a ilha mínima da norma escolhida

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de padstack-annular-ring
Campo	Unidade	Descrição
finishedHoleDia	mm	Diâmetro do furo acabado
minPadDiaExtprincipal	mm	Diâmetro mínimo do pad (externo, regra do fabricante)
minPadDiaInt	mm	Diâmetro mínimo do pad (interno, regra do fabricante)
minAnnularExt	mm	Anel anular mínimo (externo)
minAnnularInt	mm	Anel anular mínimo (interno)
landAreaExt	mm²	Área do pad (externa)
aspectRatio	:1	Razão de aspecto
maxAspect	:1	Limite de razão de aspecto do nível B (IPC-2222)
minLandDiameter	mm	Ilha mínima
landPercent	%	Porcentagem do limite
maxDrillDiameter	mm	Furo para conformidade

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "padstack-annular-ring",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "fabricationAllowance": 0.05,
      "ipcClass": 2,
      "boardThickness": 1.6,
      "standard": 0,
      "producibilityLevel": 1,
      "padDiameter": 0.65
    }
  }'

import rftools

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

result = client.calculate("padstack-annular-ring", {
    "drillDiameter": 0.3,
    "platingThickness": 25,
    "fabricationAllowance": 0.05,
    "ipcClass": 2,
    "boardThickness": 1.6,
    "standard": 0,
    "producibilityLevel": 1,
    "padDiameter": 0.65,
})
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": "padstack-annular-ring",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "fabricationAllowance": 0.05,
      "ipcClass": 2,
      "boardThickness": 1.6,
      "standard": 0,
      "producibilityLevel": 1,
      "padDiameter": 0.65
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "padstack-annular-ring",
	  "inputs": {
	    "drillDiameter": 0.3,
	    "platingThickness": 25,
	    "fabricationAllowance": 0.05,
	    "ipcClass": 2,
	    "boardThickness": 1.6,
	    "standard": 0,
	    "producibilityLevel": 1,
	    "padDiameter": 0.65
	  }
	}`)
	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": "padstack-annular-ring",
  "values": {
    "finishedHoleDia": 0.25,
    "minPadDiaExt": 0.45,
    "minPadDiaInt": 0.39999999999999997,
    "minAnnularExt": 0.05,
    "minAnnularInt": 0.025,
    "landAreaExt": 0.08835729338221295,
    "landAreaInt": 0.05497787143782136,
    "aspectRatio": 5.333333333333334,
    "maxAspect": 8,
    "minLandDiameter": 0.6,
    "landPercent": 92.3076923076923,
    "maxDrillDiameter": 0.35
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:padstack-annular-ring",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IPC-6012E, Table 3-9; IPC-2222 (February 1998), Tables 9-4 and 9-6; IPC-2221 (February 1998), §9.1.1 and Table 9-1",
    "assumptions": [
      {
        "code": "ipc-2221b-base-allowance",
        "text": "The IPC-2221B fabrication allowance is the Table 9-1 base value; its additions for copper heavier than 1 oz/ft² and for boards of more than eight layers are not applied."
      },
      {
        "code": "finished-hole-from-drill",
        "text": "The finished hole is the drill diameter less twice the plating thickness, and stands for IPC-2221B's maximum finished hole a."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "drillDiameter": {
          "min": 0.1,
          "max": 6.35,
          "unit": "mm"
        },
        "platingThickness": {
          "min": 18,
          "max": 50,
          "unit": "µm"
        },
        "fabricationAllowance": {
          "min": 0,
          "max": 0.15,
          "unit": "mm"
        },
        "ipcClass": {
          "min": 2,
          "max": 3,
          "unit": ""
        },
        "boardThickness": {
          "min": 0.2,
          "max": 6,
          "unit": "mm"
        },
        "standard": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "producibilityLevel": {
          "min": 0,
          "max": 2,
          "unit": ""
        },
        "padDiameter": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "drillDiameter": 0.3,
      "platingThickness": 25,
      "fabricationAllowance": 0.05,
      "ipcClass": 2,
      "boardThickness": 1.6,
      "standard": 0,
      "producibilityLevel": 1,
      "padDiameter": 0.65
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraCalculadora de padstack e anel anular, com estes valores