Abschnitte der Dokumentation

KiCad-Plugin

rftools.io board calculations ist ein Plugin für KiCad 10, das den Lagenaufbau und die Netzklassen der geöffneten Platine liest und diese API nach den Werten fragt, die ein Layout braucht.

Was es berechnet

Single-Ended-Impedanz von Microstrip, Stripline und geerdetem CPW; Differenzimpedanz kantengekoppelter Paare; die Leiterbahnbreite oder den Paarabstand, der eine Zielimpedanz erreicht (ein /calculate/solve-Aufruf pro Zielwert; siehe Nach einem Zielwert auflösen); die Leiterbahnbreite nach IPC-2152 für einen Strom; sowie Impedanz, Kapazität, Induktivität und Strombelastbarkeit von Vias. Jeder Wert trägt seine Formelquelle, die Angabe, ob die Eingaben im gültigen Bereich des Rechners liegen, und die Version der Engine, die ihn berechnet hat.

Einrichtung

Voraussetzungen

KiCad 10.0 oder neuer, mit eingeschalteter KiCad-API (Preferences › Plugins › Enable KiCad API). Es läuft auf dem eigenen Python von KiCad; nichts zu installieren.

Installation

Fügen Sie im „Plugin and Content Manager“ von KiCad unter „Manage repositories“ https://antonpogrebenko-public.github.io/rftools-kicad/repository.json hinzu und installieren Sie dann „rftools.io board calculations“. Repository: github.com/antonpogrebenko-public/rftools-kicad (MIT).

Schlüssel

Die Schaltfläche „Get a free key“ des Dialogs öffnet https://rftools.io/dashboard/?newKey=1&client=kicad-plugin, einen gewöhnlichen Schlüssel, wie unter Einen Schlüssel holen. Die Nutzung erscheint im Dashboard unter der Client-Bezeichnung kicad-plugin.

Kosten

Ein API-Aufruf pro berechnetem Wert; eine Zielbreite oder ein Zielabstand ist ein Solve-Aufruf, keine Suche. Ein zweimal angefragter Wert (die beiden Außenlagen einer symmetrischen Platine) wird einmal gesendet: Wiederholungen innerhalb von 7 Tagen kommen aus einem lokalen Cache und kosten nichts. Vor jedem Lauf nennt der Dialog die Aufrufe, die er verbrauchen wird, und was in diesem Monat übrig ist.

Was gesendet und was geschrieben wird

Was gesendet wird. Jede Anfrage enthält einen Rechner-Slug und Zahlen: Breiten, Höhen, εr, Kupferdicke, einen Strom oder einen Zielwert. Sie sendet nie die Platinendatei, Netz- oder Netzklassennamen, Lagennamen oder den Projektnamen oder -pfad.

Schreiben von Netzklassen. Auf der Platine ändert sich nichts, solange Sie es nicht verlangen: Ein Lauf zeigt die vorgeschlagene Leiterbahnbreite, Differenzpaarbreite und den Abstand für jede Klasse an, bevor etwas geschrieben wird, und jedes Schreiben lässt sich rückgängig machen. Unter KiCad 10.0.6 und älter schreibt das Plugin nichts (die API von KiCad beschädigt eine über sie geschriebene Netzklasse) und zeigt stattdessen die Werte an, die Sie unter „Board Setup › Net Classes“ eintragen.

Alle Details, Quellcode und Lizenz (MIT): github.com/antonpogrebenko-public/rftools-kicad.

Eine Zielbreite ist ein Solve-Aufruf

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))
}