ドキュメントのセクション

KiCad プラグイン

rftools.io board calculations は KiCad 10 用のプラグインで、開いている基板の層構成とネットクラスを読み取り、レイアウトに必要な数値をこの API に問い合わせます。

計算する内容

マイクロストリップ、ストリップライン、グラウンド付き CPW のシングルエンドインピーダンス、エッジ結合ペアの差動インピーダンス、目標インピーダンスになる配線幅またはペア間隔（目標 1 つにつき /calculate/solve の呼び出し 1 回。目標値からの逆算をご覧ください）、電流に対する IPC-2152 の配線幅、そしてビアのインピーダンス、容量、インダクタンス、許容電流です。どの値にも、式の出典、入力が計算ツールの有効範囲内かどうか、計算したエンジンのバージョンが付きます。

セットアップ

動作要件

KiCad 10.0 以降で、KiCad API が有効になっていること（Preferences › Plugins › Enable KiCad API）。KiCad 自身の Python で動くため、追加のインストールは不要です。

インストール

KiCad の「Plugin and Content Manager」で「Manage repositories」から https://antonpogrebenko-public.github.io/rftools-kicad/repository.json を追加し、「rftools.io board calculations」をインストールします。リポジトリ：github.com/antonpogrebenko-public/rftools-kicad（MIT）。

キー

ダイアログの「Get a free key」ボタンは https://rftools.io/dashboard/?newKey=1&client=kicad-plugin を開きます。これは通常のキーで、キーを取得すると同じです。使用状況はダッシュボードの kicad-plugin クライアントラベルの下に表示されます。

費用

計算する値 1 つにつき API 呼び出し 1 回です。目標の配線幅や間隔は、探索ではなく逆算の呼び出し 1 回です。2 回求められた値（対称な基板の外側 2 層など）は 1 回だけ送信されます。7 日以内の繰り返しはローカルのキャッシュから取得され、費用はかかりません。実行の前に、ダイアログが使用する呼び出し回数と今月の残りを示します。

送信する内容と書き込む内容

送信する内容。 各リクエストに含まれるのは、計算ツールのスラッグと数値（幅、高さ、εr、銅厚、電流、目標値）だけです。基板ファイル、ネット名やネットクラス名、層の名前、プロジェクト名やパスは送信しません。

ネットクラスの書き込み。 指示しない限り、基板は何も変わりません。実行すると、書き込む前に各クラスの配線幅、差動ペアの幅、間隔の提案値をプレビューし、書き込みはすべて元に戻せます。KiCad 10.0.6 以前では、プラグインは何も書き込みません（KiCad の API を通じて書き込んだネットクラスが壊れるため）。代わりに、「Board Setup › Net Classes」に入力する値を表示します。

詳細、ソースコード、ライセンス（MIT）：github.com/antonpogrebenko-public/rftools-kicad。

目標の配線幅は逆算の呼び出し 1 回

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