Sections de la documentation

Extension KiCad

rftools.io board calculations est une extension pour KiCad 10 qui lit l'empilage et les classes de réseaux de la carte ouverte et appelle cette API pour obtenir les valeurs dont un routage a besoin.

Ce qu'elle calcule

L'impédance asymétrique des lignes microstrip, stripline et CPW avec plan de masse ; l'impédance différentielle des paires couplées par les bords ; la largeur de piste ou l'écart de paire qui atteint une impédance cible (un appel à /calculate/solve par cible ; voir Résoudre pour une valeur cible) ; la largeur de piste IPC-2152 pour un courant ; et l'impédance, la capacité, l'inductance et le courant admissible des vias. Chaque valeur porte sa référence de formule, l'indication que les entrées sont ou non dans la plage valide du calculateur, et la version du moteur qui l'a calculée.

Mise en place

Prérequis

KiCad 10.0 ou ultérieur, avec l'API KiCad activée (Preferences › Plugins › Enable KiCad API). Elle s'exécute sur le Python propre à KiCad ; rien à installer.

Installation

Dans le « Plugin and Content Manager » de KiCad, sous « Manage repositories », ajoutez https://antonpogrebenko-public.github.io/rftools-kicad/repository.json, puis installez « rftools.io board calculations ». Dépôt : github.com/antonpogrebenko-public/rftools-kicad (MIT).

Clé

Le bouton « Get a free key » de la boîte de dialogue ouvre https://rftools.io/dashboard/?newKey=1&client=kicad-plugin, une clé ordinaire, comme dans Obtenir une clé. L'usage apparaît sur le tableau de bord sous le libellé de client kicad-plugin.

Coût

Un appel d'API par valeur calculée ; une largeur ou un écart cible, c'est un appel à solve, pas une recherche. Une valeur demandée deux fois (les deux couches externes d'une carte symétrique) n'est envoyée qu'une fois : les répétitions dans un délai de 7 jours viennent d'un cache local et ne coûtent rien. Avant chaque exécution, la boîte de dialogue indique les appels qu'elle utilisera et ce qui reste ce mois-ci.

Ce qui est envoyé, et ce qui est écrit

Ce qui est envoyé. Chaque requête contient un slug de calculateur et des nombres : largeurs, hauteurs, εr, épaisseur de cuivre, un courant ou une cible. Elle n'envoie jamais le fichier de la carte, les noms de réseaux ou de classes de réseaux, les noms de couches, ni le nom ou le chemin du projet.

Écriture des classes de réseaux. Rien ne change sur la carte sans votre demande : une exécution présente la largeur de piste, la largeur de paire différentielle et l'écart proposés pour chaque classe avant toute écriture, et chaque écriture peut être annulée. Sous KiCad 10.0.6 et versions antérieures, l'extension n'écrit rien (l'API de KiCad corrompt une classe de réseau écrite par son intermédiaire) et affiche à la place les valeurs à saisir dans « Board Setup › Net Classes ».

Détails complets, code source et licence (MIT) : github.com/antonpogrebenko-public/rftools-kicad.

Une largeur cible, c'est un appel à solve

curl -X POST https://rftools.io/api/py/v1/calculate/solve \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "microstrip-impedance",
    "inputs": {
      "substrateHeight": 1.51,
      "dielectricConstant": 4.5,
      "copperThickness": 35
    },
    "solveFor": "traceWidth",
    "target": {
      "output": "impedance",
      "value": 50
    },
    "grid": 0.001
  }'

import rftools

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

result = client.solve(
    "microstrip-impedance",
    {
        "substrateHeight": 1.51,
        "dielectricConstant": 4.5,
        "copperThickness": 35,
    },
    "traceWidth", "impedance", 50,
    grid=0.001,
)
print(result.value, result.reached)
print(result.result.values)

const response = await fetch("https://rftools.io/api/py/v1/calculate/solve", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "microstrip-impedance",
    "inputs": {
      "substrateHeight": 1.51,
      "dielectricConstant": 4.5,
      "copperThickness": 35
    },
    "solveFor": "traceWidth",
    "target": {
      "output": "impedance",
      "value": 50
    },
    "grid": 0.001
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "microstrip-impedance",
	  "inputs": {
	    "substrateHeight": 1.51,
	    "dielectricConstant": 4.5,
	    "copperThickness": 35
	  },
	  "solveFor": "traceWidth",
	  "target": {
	    "output": "impedance",
	    "value": 50
	  },
	  "grid": 0.001
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate/solve", 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))
}