문서 섹션

KiCad 플러그인

rftools.io board calculations는 KiCad 10용 플러그인으로, 열려 있는 기판의 적층 구성과 넷 클래스를 읽고, 레이아웃에 필요한 수치를 이 API에 요청합니다.

계산하는 내용

마이크로스트립, 스트립라인, 접지 CPW의 싱글엔드 임피던스, 에지 결합 쌍의 차동 임피던스, 목표 임피던스가 되는 배선 폭이나 쌍 간격(목표 하나에 /calculate/solve 호출 한 번. 목표값 역산 참고), 전류에 대한 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 클라이언트 레이블 아래에 표시됩니다.

비용

계산하는 값 하나마다 API 호출 한 번입니다. 목표 폭이나 간격은 탐색이 아니라 역산 호출 한 번입니다. 두 번 요청된 값(대칭 기판의 바깥 두 층 등)은 한 번만 보냅니다. 7일 안의 반복 요청은 로컬 캐시에서 가져오며 비용이 들지 않습니다. 실행 전마다 대화상자가 사용할 호출 수와 이번 달 남은 양을 알려 줍니다.

보내는 내용과 쓰는 내용

보내는 내용. 각 요청에는 계산기 슬러그와 숫자(폭, 높이, εr, 구리 두께, 전류나 목표값)만 담깁니다. 기판 파일, 넷 이름이나 넷 클래스 이름, 레이어 이름, 프로젝트 이름이나 경로는 보내지 않습니다.

넷 클래스 쓰기. 요청하지 않는 한 기판에서 바뀌는 것은 없습니다. 실행하면 쓰기 전에 클래스마다 제안된 배선 폭, 차동 쌍 폭, 간격을 미리 보여 주며, 모든 쓰기는 되돌릴 수 있습니다. KiCad 10.0.6 이하에서는 플러그인이 아무것도 쓰지 않으며(KiCad의 API를 통해 쓴 넷 클래스가 손상되기 때문입니다), 대신 "Board Setup › Net Classes"에 입력할 값을 보여 줍니다.

자세한 내용, 소스, 라이선스(MIT): github.com/antonpogrebenko-public/rftools-kicad.

목표 폭은 역산 호출 한 번

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