Seções da documentação

Calculadora BGA Land Pad

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

Slug bga-land-pad. Calcule o diâmetro do bloco de terra BGA, a abertura da máscara de solda e o roteamento de escape de acordo com os níveis de densidade IPC-7351B.

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-land-pad
Nome	Unidade	Faixa	Padrão	Descrição
ballPitchnúmero	mm	0.3 … 1.27	1	Passo das esferas
ballDiameternúmero	mm	0.15 … 0.89	0.6	Diâmetro da esfera
solderMaskDefinednúmero	nenhuma	0 … 1	0	Definido pela máscara de soldaUm de: 0 Não (NSMD) · 1 Sim (SMD)
viaInPadnúmero	nenhuma	0 … 1	0	Via-in-padUm de: 0 Não · 1 Sim
ballTypenúmero	nenhuma	0 … 1	0	Esferas colapsáveis (a maioria dos BGAs) usam uma ilha menor que a esfera; esferas não colapsáveis, uma maiorUm de: 0 Colapsável · 1 Não colapsável
landDiameternúmero	mm	0.05 … 1.5	0.48	O diâmetro da ilha na sua placa, comparado com a ilha da IPC-7351B para a esfera

Descontinuadas, ainda aceitas e ignoradas com um aviso: densityLevel (Density Level (0=Most, 1=Nominal, 2=Least), 6 de outubro de 2026).

Saídas

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

Saídas de bga-land-pad
Campo	Unidade	Descrição
padDiaprincipal	mm	Diâmetro do pad
maskOpening	mm	Abertura da máscara de solda
maxViaDrill	mm	Furo máx. da via (via no pad)
channelWidth	mm	Largura do canal
escapeRoutes	nenhuma	Rotas de escape por canal
maxTraceWidth	mm	Largura máxima de trilha no canal
stencilAperture	mm	Abertura do estêncil
padToPadGap	mm	Espaço entre pads
ipcLand	mm	Ilha nominal IPC-7351B
landDeviation	mm	Desvio da ilha
landTolerance	mm	Variação da ilha
landPercent	%	Porcentagem do limite
compliantLand	mm	Ilha 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": "bga-land-pad",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    }
  }'

import rftools

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

result = client.calculate("bga-land-pad", {
    "ballPitch": 1,
    "ballDiameter": 0.6,
    "solderMaskDefined": 0,
    "viaInPad": 0,
    "ballType": 0,
    "landDiameter": 0.48,
})
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-land-pad",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "bga-land-pad",
	  "inputs": {
	    "ballPitch": 1,
	    "ballDiameter": 0.6,
	    "solderMaskDefined": 0,
	    "viaInPad": 0,
	    "ballType": 0,
	    "landDiameter": 0.48
	  }
	}`)
	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-land-pad",
  "values": {
    "padDia": 0.45,
    "maskOpening": 0.55,
    "maxViaDrill": 0,
    "channelWidth": 0.55,
    "escapeRoutes": 2,
    "maxTraceWidth": 0.17500000000000002,
    "stencilAperture": 0.45,
    "padToPadGap": 0.55,
    "ipcLand": 0.45,
    "landDeviation": 0.02999999999999997,
    "landTolerance": 0.05,
    "landPercent": 59.99999999999994,
    "compliantLand": 0.5
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:bga-land-pad",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "ballPitch": {
          "min": 0.3,
          "max": 1.27,
          "unit": "mm"
        },
        "ballDiameter": {
          "min": 0.15,
          "max": 0.89,
          "unit": "mm"
        },
        "solderMaskDefined": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "viaInPad": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "ballType": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "landDiameter": {
          "min": 0.05,
          "max": 1.5,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "ballPitch": 1,
      "ballDiameter": 0.6,
      "solderMaskDefined": 0,
      "viaInPad": 0,
      "ballType": 0,
      "landDiameter": 0.48
    },
    "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 BGA Land Pad, com estes valores