Seções da documentação

Calculadora de largura de fuga BGA

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

Slug bga-breakout-width. Encontre o traço de escape mais amplo que se encaixa entre os terrenos do BGA, desde o campo da bola, o diâmetro do terreno, a folga do fabricante e o número de traços por canal — e se ele se encaixa.

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 bga-breakout-width
Nome	Unidade	Faixa	Padrão	Descrição
ballPitchnúmero	mm	no mínimo 0.1	0.8	Passo das esferas
landDiameternúmero	mm	0.05 … 2	0.4	Ilha definida ou não definida pela máscara de solda, a que o footprint usar
minClearancenúmero	mm	0.01 … 1	0.1	Folga mínima
tracesPerChannelnúmero	nenhuma	1 … 4	1	Quantos condutores passam entre um par de ilhas adjacentes
diagonalRoutenúmero	nenhuma	0 … 1	0	Direção de escapeUm de: 0 Ortogonal · 1 Diagonal (espaço √2)

Saídas

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

Saídas de bga-breakout-width
Campo	Unidade	Descrição
maxTraceWidthprincipal	mm	Largura máxima da trilha de escape
channelWidth	mm	Canal entre ilhas
clearanceDemand	mm	Folga consumida
effectivePitch	mm	Passo efetivo
escapeRows	nenhuma	Fileiras que escapam por camada
fits	nenhuma	Geometria cabe

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": "bga-breakout-width",
    "inputs": {
      "ballPitch": 0.8,
      "landDiameter": 0.4,
      "minClearance": 0.1,
      "tracesPerChannel": 1,
      "diagonalRoute": 0
    }
  }'

import rftools

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

result = client.calculate("bga-breakout-width", {
    "ballPitch": 0.8,
    "landDiameter": 0.4,
    "minClearance": 0.1,
    "tracesPerChannel": 1,
    "diagonalRoute": 0,
})
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": "bga-breakout-width",
    "inputs": {
      "ballPitch": 0.8,
      "landDiameter": 0.4,
      "minClearance": 0.1,
      "tracesPerChannel": 1,
      "diagonalRoute": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "bga-breakout-width",
	  "inputs": {
	    "ballPitch": 0.8,
	    "landDiameter": 0.4,
	    "minClearance": 0.1,
	    "tracesPerChannel": 1,
	    "diagonalRoute": 0
	  }
	}`)
	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": "bga-breakout-width",
  "values": {
    "maxTraceWidth": 0.2,
    "channelWidth": 0.4,
    "clearanceDemand": 0.2,
    "effectivePitch": 0.8,
    "escapeRows": 2,
    "fits": 1
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:bga-breakout-width",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IPC-7351B land geometry; clearance is a fabricator rule and is supplied as an input; rows per layer from Intel AN 114, \"Board Design Guidelines for Intel Programmable Device Packages\" (2019.12.31), section 1.3.4.1.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "ballPitch": {
          "min": 0.1,
          "max": null,
          "unit": "mm"
        },
        "landDiameter": {
          "min": 0.05,
          "max": 2,
          "unit": "mm"
        },
        "minClearance": {
          "min": 0.01,
          "max": 1,
          "unit": "mm"
        },
        "tracesPerChannel": {
          "min": 1,
          "max": 4,
          "unit": ""
        },
        "diagonalRoute": {
          "min": 0,
          "max": 1,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "ballPitch": 0.8,
      "landDiameter": 0.4,
      "minClearance": 0.1,
      "tracesPerChannel": 1,
      "diagonalRoute": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "ballPitch"
      ],
      "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 largura de fuga BGA, com estes valores