Sections de la documentation

Calculateur de largeur de découpage BGA

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

Slug bga-breakout-width. Trouvez la piste d'évacuation la plus large qui convient entre les pistes BGA, en fonction du terrain de balle, du diamètre du terrain, de la distance dégagée par votre fabricant et du nombre de pistes par canal, et si elle convient parfaitement.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de bga-breakout-width
Nom	Unité	Plage	Valeur par défaut	Description
ballPitchnombre	mm	au moins 0.1	0.8	Pas des billes
landDiameternombre	mm	0.05 … 2	0.4	Pastille définie par le masque de soudure (SMD) ou non (NSMD), selon l'empreinte utilisée
minClearancenombre	mm	0.01 … 1	0.1	Espacement minimal
tracesPerChannelnombre	aucune	1 … 4	1	Nombre de conducteurs passant entre deux pastilles adjacentes
diagonalRoutenombre	aucune	0 … 1	0	Direction de sortieL'une de : 0 Orthogonale · 1 Diagonale (écart √2)

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de bga-breakout-width
Champ	Unité	Description
maxTraceWidthprincipale	mm	Largeur maximale de trace de sortie
channelWidth	mm	Canal entre les pastilles
clearanceDemand	mm	Espacement consommé
effectivePitch	mm	Pas effectif
escapeRows	aucune	Rangées pouvant sortir par couche
fits	aucune	Géométrie réalisable

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

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"
    }
  ]
}

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de largeur de découpage BGA, avec ces valeurs