Secciones de la documentación

Complemento de KiCad

rftools.io board calculations es un complemento para KiCad 10 que lee el apilamiento y las clases de red de la placa abierta y llama a esta API para obtener las cifras que necesita un diseño.

Qué calcula

La impedancia single-ended de microstrip, stripline y CPW con plano de tierra; la impedancia diferencial de pares acoplados lateralmente; el ancho de pista o la separación del par que alcanza una impedancia objetivo (una llamada a /calculate/solve por objetivo; consulte Resolver para un valor objetivo); el ancho de pista según IPC-2152 para una corriente; y la impedancia, la capacitancia, la inductancia y la capacidad de corriente de las vías. Cada cifra lleva su referencia de fórmula, si las entradas están dentro del rango válido de la calculadora y la versión del motor que la calculó.

Configuración

Requisitos

KiCad 10.0 o posterior, con la API de KiCad activada (Preferences › Plugins › Enable KiCad API). Se ejecuta con el Python propio de KiCad; no hay nada que instalar.

Instalación

En el «Plugin and Content Manager» de KiCad, en «Manage repositories», añada https://antonpogrebenko-public.github.io/rftools-kicad/repository.json y luego instale «rftools.io board calculations». Repositorio: github.com/antonpogrebenko-public/rftools-kicad (MIT).

Clave

El botón «Get a free key» del diálogo abre https://rftools.io/dashboard/?newKey=1&client=kicad-plugin, una clave normal, como en Obtener una clave. El uso aparece en el panel bajo la etiqueta de cliente kicad-plugin.

Coste

Una llamada a la API por cada cifra calculada; un ancho o una separación objetivo es una llamada a solve, no una búsqueda. Una cifra pedida dos veces (las dos capas exteriores de una placa simétrica) se envía una sola vez: las repeticiones en un plazo de 7 días salen de una caché local y no cuestan nada. Antes de cada ejecución, el diálogo indica las llamadas que usará y lo que queda este mes.

Qué se envía y qué se escribe

Qué se envía. Cada solicitud contiene un slug de calculadora y números: anchos, alturas, εr, espesor de cobre, una corriente o un objetivo. Nunca envía el archivo de la placa, los nombres de redes o de clases de red, los nombres de capas, ni el nombre o la ruta del proyecto.

Escritura de clases de red. Nada cambia en la placa a menos que usted lo pida: una ejecución muestra el ancho de pista, el ancho del par diferencial y la separación propuestos para cada clase antes de escribir nada, y cada escritura se puede deshacer. En KiCad 10.0.6 y anteriores, el complemento no escribe nada (la API de KiCad corrompe una clase de red escrita a través de ella) y muestra en su lugar los valores que hay que introducir en «Board Setup › Net Classes».

Todos los detalles, el código fuente y la licencia (MIT): github.com/antonpogrebenko-public/rftools-kicad.

Un ancho objetivo es una llamada a 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))
}