Seções da documentação

Plugin do KiCad

rftools.io board calculations é um plugin para o KiCad 10 que lê o empilhamento e as classes de rede da placa aberta e chama esta API para obter os números de que um layout precisa.

O que ele calcula

A impedância single-ended de microstrip, stripline e CPW aterrado; a impedância diferencial de pares acoplados pela borda; a largura de trilha ou o espaçamento do par que atinge uma impedância alvo (uma chamada a /calculate/solve por alvo; veja Resolver para um alvo); a largura de trilha IPC-2152 para uma corrente; e a impedância, a capacitância, a indutância e a capacidade de corrente das vias. Cada valor traz a referência da fórmula, se as entradas estão dentro da faixa válida da calculadora e a versão do motor que o calculou.

Configuração

Requisitos

KiCad 10.0 ou mais recente, com a API do KiCad ativada (Preferences › Plugins › Enable KiCad API). Ele roda no Python do próprio KiCad; não há nada para instalar.

Instalação

No "Plugin and Content Manager" do KiCad, em "Manage repositories", adicione https://antonpogrebenko-public.github.io/rftools-kicad/repository.json e depois instale "rftools.io board calculations". Repositório: github.com/antonpogrebenko-public/rftools-kicad (MIT).

Chave

O botão "Get a free key" da caixa de diálogo abre https://rftools.io/dashboard/?newKey=1&client=kicad-plugin, uma chave comum, como em Obter uma chave. O uso aparece no painel sob o rótulo de cliente kicad-plugin.

Custo

Uma chamada à API por valor calculado; uma largura ou um espaçamento alvo é uma chamada a solve, não uma busca. Um valor pedido duas vezes (as duas camadas externas de uma placa simétrica) é enviado uma vez: as repetições em até 7 dias vêm de um cache local e não custam nada. Antes de cada execução, a caixa de diálogo informa as chamadas que vai usar e o que resta neste mês.

O que é enviado, e o que é gravado

O que é enviado. Cada requisição contém um slug de calculadora e números: larguras, alturas, εr, espessura do cobre, uma corrente ou um alvo. Ela nunca envia o arquivo da placa, nomes de redes ou de classes de rede, nomes de camadas, nem o nome ou o caminho do projeto.

Gravação das classes de rede. Nada muda na placa a menos que você peça: uma execução mostra a largura de trilha, a largura do par diferencial e o espaçamento propostos para cada classe antes de qualquer gravação, e toda gravação pode ser desfeita. No KiCad 10.0.6 e anteriores, o plugin não grava nada (a API do KiCad corrompe uma classe de rede gravada por meio dela) e mostra, em vez disso, os valores a digitar em "Board Setup › Net Classes".

Detalhes completos, código-fonte e licença (MIT): github.com/antonpogrebenko-public/rftools-kicad.

Uma largura alvo é uma chamada 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))
}