PCBCraft 사용법: LED 예제로 연결·배선·KiCad 파일 확인하기
공식 LED 샘플에서 연결과 풋프린트, 검사, 원본 저장과 .kicad_pcb 출력을 확인하는 6단계 문서 가이드예요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.
이번 목표는 공식 LED 샘플을 열고 연결과 배선을 확인한 뒤 KiCad 기판 파일까지 점검하는 것이에요. 새 회로를 설계하는 강의가 아니라 PCBCraft의 작은 파일 흐름을 익히는 문서 기반 안내예요. 앱을 직접 빌드하거나 실행한 기록은 아직 없어요.
준비할 것
공식 README의 Rust·시스템 라이브러리 조건에 맞는 개발 환경이 필요해요. Linux·WSL 경로와 Windows 네이티브 실행 안내를 먼저 읽어주세요. 원본을 덮어쓰지 않을 시험 폴더와 내보낸 파일을 열 KiCad도 준비하는 계획이에요. 브라우저 파일 저장은 이 가이드의 완료 경로로 쓰지 않아요.
이번에는 이렇게 설정해볼게요
| 항목 | 작은 시험의 범위 |
|---|---|
| 시작 자료 | 공식 LED example |
| 확인 탭 | Schematic, PCB Layout, Libraries, Checks |
| 원본 | led-test.pcbcraft |
| 전달 파일 | led-test.kicad_pcb |
| 완료 기준 | 저장·재열기와 연결·간격 검사 |
1. 공식 샘플로 시작하기
문서의 LED example 또는 cargo run -p pcbcraft -- --sample 경로를 사용해요. 샘플에 어떤 부품이 있는지, 각 참조 이름이 무엇인지 먼저 살펴봐요. 예제의 전원과 부품 값을 이해하지 못한 상태에서 새 실제 회로의 적합성까지 판단하지는 않을게요.
2. Schematic에서 핀과 연결 읽기
회로 기호와 핀을 확인해요. 새 기호 선택은 A, 핀 연결은 W가 문서에 안내돼 있어요. 연결할 때 클릭 대상은 핀 원이에요. 단순히 선이 서로 겹친 곳을 연결점으로 가정하지 말고, 논리적 넷이 같은지 확인해주세요.
3. 풋프린트와 기판 동기화 확인하기
부품의 핀 번호와 풋프린트 패드 번호를 맞춰보고 Sync to PCB를 사용해요. 외부 라이브러리를 쓰면 Libraries에서 지원되는 기호와 패키지를 선택해야 해요. 이번에는 샘플이 제공하는 기본 부품에서 시작해 라이브러리 호환 문제와 회로 문제를 분리할게요.
4. PCB Layout에서 배선과 간격 보기
문서의 X 도구는 같은 넷의 패드를 연결하는 기본 배선이에요. 장애물을 자동으로 우회하지 않으므로 선이 다른 패드나 보드 경계를 침범하는지 봐주세요. 부품을 옮겼다면 배선 끝이 따라왔는지도 다시 확인해요. 화면에서 가까워 보이는 것과 실제 연결은 달라요.
5. Checks를 읽고 원본 저장하기
Checks에서 미배선, 구리 단락, 간격, 외곽과 컷아웃 관련 항목을 읽어봐요. 발견 사항의 객체 ID로 어느 부분인지 찾아 기록하는 편이 좋아요. 검사 수가 줄었다는 이유만으로 전자회로 전체의 기능이 검증된 것은 아니에요. 수정 뒤에는 .pcbcraft 원본을 새 이름으로 저장해요.
6. KiCad 파일을 내보내 다시 열기
문서에 안내된 보드 출력으로 .kicad_pcb를 남기고 KiCad에서 열어요. 보드 외곽, 패드, 넷과 배선이 같은지 확인해주세요. 원본도 PCBCraft에서 다시 열어 변경이 남는지 봐요. 기판 파일 생성과 제작 준비 완료를 구분하는 것이 마지막 단계예요.
명령 경로를 살펴보면
공식 CLI 예제에는 다음 흐름이 있어요. 저장소를 준비한 환경에서 읽어볼 명령이며 이 글에서 실행한 로그는 아니에요.
cargo run -p pcbcraft-cli -- sample --out led-test.pcbcraft
cargo run -p pcbcraft-cli -- checks --project led-test.pcbcraft
README에는 run examples/led-indicator.json --save ... --export ... 경로도 나와요. 명령이 파일을 만드는 순서와 UI에서 확인할 연결을 함께 읽으면 자동화를 이해하기 좋아요.
기대 결과와 확인
편집 가능한 PCBCraft 원본과 KiCad에서 살펴볼 기판 파일을 구분해 남기는 것이 목표예요. 검사 항목이 있다면 개수만 적지 말고 내용과 객체를 남겨주세요. 파일 열기 성공, 같은 논리 연결, 실제 배선과 보드 외곽이 각각 확인돼야 해요.
작업이 막힐 때
풋프린트가 없으면 지원 라이브러리 설치와 핀·패드 번호부터 봐주세요. 넷이 다르면 배선을 억지로 이어보기보다 회로도 연결을 확인해요. 브라우저에서 다운로드가 안 되는 경우는 현재 문서에 미구현으로 적힌 범위를 먼저 살펴봐야 해요. 실제 제작에 쓸 프로젝트로 넓히기 전에는 KiCad에서 남은 검사와 제조 출력 요구사항을 따로 확인해주세요.
공식 자료와 확인 범위
자료 확인일은 2026년 10월 19일이에요. 소개·사용법·비교 모두 아래 공개 자료를 기준으로 썼고, 앱을 직접 실행한 후기나 성능 측정은 포함하지 않았어요. 개발 중인 기능은 확인한 소스 시점에 따라 달라질 수 있어요.
- README · 31138579e5ce
- docs/mcp.md
- examples/led-indicator.json
- docs/kicad-libraries.md
- ROADMAP.md
- LICENSE
- NOTICE
- KiCad 10 getting started
소개 · 사용법 · 후기·비교: 공식 자료
참고 자료
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/README.md
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/docs/mcp.md
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/examples/led-indicator.json
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/docs/kicad-libraries.md
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/ROADMAP.md
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/LICENSE
- https://github.com/tangency-labs/pcbcraft/blob/31138579e5ce1c9d9ba4ee1f83f9253581c1c689/NOTICE
- https://docs.kicad.org/10.0/en/getting_started_in_kicad/getting_started_in_kicad.html