Skip to the content
2 layers80 × 50 mmPcb 10, the printed circuit board in 3D

RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

Size
80 × 50 mm
Copper layers
2
Thickness
1.6 mm
Parts
21
Nets
30
Pads
21
Tracks, vias
132, 8
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
13 May 2026
Updated
13 May 2026

Overview

Pcb 10 is an open-source printed circuit board by bkimkr0139-blip, from the bkimkr0139-blip/AgentIC repository on GitHub. It is a 2-layer board of 80 × 50 mm with 21 parts on 30 nets, routed with 132 tracks and 8 vias.

README

README.md

AgentIC Education Simulator

학생이 RTL → Lint → Simulation → Synthesis → P&R → Report 의 반도체 설계공정을 직접 실험하고, AI 코치의 도움으로 결과를 해석하는 교육 시뮬레이터.

빠른 시작 (Windows / PowerShell)

powershell
cd agentic-education-simulator
# 의존성 (최초 1회)
python -m pip install -r apps\api\requirements.txt
cd apps\web ; npm install ; cd ..\..
# 실행
.\run.ps1

브라우저에서 다음을 확인:

빠른 시작 (bash)

bash
cd agentic-education-simulator
python -m pip install -r apps/api/requirements.txt
(cd apps/web && npm install)
./run.sh

학생 플로우 (4-bit Counter 기준)

  1. /missions 에서 4-bit Counter 시작
  2. RTL 탭의 Monaco 에디터에서 코드 확인 (autosave 800ms)
  3. Run Lint → 통과
  4. Run Simulation → VCD/waveform_json 생성, Simulation 탭에서 파형 확인
  5. Run Synthesis → gate_count / area / slack 확인
  6. Run Place & Route → SVG floorplan + summary 확인
  7. Run Package → ZIP 다운로드
  8. AI Coach 패널에서 RTL/오류/파형/PPA 코칭

아키텍처

text
React (Vite + Monaco)  ──HTTP──▶  FastAPI  ──BackgroundTasks──▶  Mock EDA Runners
        │                              │
        │                              └──▶  SQLite (./data)
        │                              └──▶  Artifacts (./artifacts)
        │
        └──▶  AI Coach Panel  ──▶  /api/projects/{id}/ai/*  ──▶  MockProvider

실 EDA 도구 / 실 LLM 연결로 전환

본 빌드는 학습용 MVP로 모든 EDA 단계가 Mock Runner로 동작한다 (지시서 §9.1 허용). 실제 도구로 전환하려면:

항목작업 위치변경
Verilatorapps/api/app/services/eda/runners.py:run_lintsubprocess verilator --lint-only -Wall ... 호출로 교체
cocotb / Verilator동 run_simulationtestbench 파일 + verilator harness 실행
Yosys동 run_synthesisyosys -p "read_verilog ...; synth -top ...; stat; write_verilog"
OpenROAD동 run_place_routeOpenROAD flow scripts 실행
LLMapps/api/app/services/ai/provider.pyClaudeProvider/OpenAIProvider 구현 후 LLM_PROVIDER env로 선택

보안 / 설계 원칙 준수

  • 모든 EDA 실행은 비동기 (BackgroundTasks) — API 프로세스 블로킹 없음
  • subprocess는 list argument 사용하도록 인터페이스 통일
  • artifact 다운로드는 path traversal 차단 (artifact_root 기준)
  • AI 응답은 학생 코드를 자동 덮어쓰지 않음 — self-heal은 diff만 반환 (지시서 §10.2)
  • API 키 / DB 비밀번호 하드코딩 없음 (.env 사용)
  • xAPI actor는 sha256 익명화 (지시서 §13)

디렉터리

text
apps/api/        FastAPI + SQLAlchemy + SQLite
apps/web/        Vite + React + TS + Monaco
unity/           Unity 2022 LTS 스크립트 스텁 (Editor 작업 별도)
eda/             Mission별 starter / scripts (확장 영역)
artifacts/       Job 산출물 (런타임 생성, gitignore)
data/            SQLite DB

테스트

bash
cd apps/api
python -m pytest app/tests/test_smoke.py -q

Unity 3D 브라우징 (MCP 통합)

vibe3d 패턴으로 mcp-for-unity 서버를 통해 Unity 씬에 합성 결과(셀 배열) 또는 P&R 결과(다이+배치+배선)를 자동 생성합니다.

사전 준비

  1. Unity Hub → 2022 LTS 이상으로 임의 프로젝트 열기
  2. 패키지 매니저 → MCP-FOR-UNITY 설치 / 활성화
  3. Unity 콘솔에서 MCP 서버가 http://localhost:8080/mcp에 떠 있는지 확인
  4. (선택) .env 의 UNITY_MCP_URL 변경

사용

워크스페이스 우측 하단 🎮 Unity 3D Browser 패널:

  • Build Synthesis 3D — 합성 결과를 셀 그리드(FF=amber, LUT=cyan)로 빌드
  • Build Layout 3D — P&R 결과를 다이/코어/배치셀/배선으로 빌드
  • Clear Scene — AgentIC_* 객체 삭제
  • Probe Hierarchy — Unity 씬 상태 검증

REST API

메소드경로설명
GET/api/unity/healthMCP 연결 상태
POST/api/projects/{id}/unity/build-scene?stage=synthesis|layout3D 씬 빌드
POST/api/projects/{id}/unity/clearAgentIC_* 객체 삭제
GET/api/projects/{id}/unity/hierarchy씬 구조 조회

Unity Scene/Build 단계

unity/README.md 참조. WebGL Build 등 Unity Editor 작업이 필요한 단계가 안내되어 있습니다.

외부 공개 (Cloudflare Tunnel)

포트 포워딩 없이 HTTPS로 외부에서 접속하도록 Cloudflare Tunnel을 사용합니다. FastAPI가 SPA(apps/web/dist)와 API를 같은 포트에서 서빙하므로 터널 1개로 끝납니다.

Quick Tunnel (Cloudflare 계정 불필요, 임시 URL)

Windows / PowerShell

powershell
.\tunnel.ps1

bash (Git Bash / Linux / macOS)

bash
./tunnel.sh

스크립트가:

  1. apps/web 빌드 → dist/에 SPA 산출
  2. cloudflared.exe 가 없으면 ./bin/에 자동 다운로드
  3. FastAPI(8000)가 미기동이면 자동 기동
  4. cloudflared tunnel --url http://127.0.0.1:8000 실행 → 콘솔에 공개 URL 출력

출력 예시:

text
+--------------------------------------------------------------------------------------------+
|  Your quick Tunnel has been created! Visit it at (it may take some time to be reachable):  |
|  https://<random-words>.trycloudflare.com                                                  |
+--------------------------------------------------------------------------------------------+

해당 URL을 그대로 공유하면 외부에서 동일한 학생/교수자/3D 뷰어 UI에 접근 가능. Ctrl-C로 종료하면 URL은 즉시 폐기됩니다.

검증된 공개 경로 (단일 origin)

경로응답
/healthAPI health
/api/missions5개 미션(RISC32 포함)
/api/projects/{id}/stages단계 status
/projects/{id}워크스페이스 SPA
/projects/{id}/3d다층 3D 뷰어
/instructor교수자 대시보드

영구 URL이 필요하면 (Named Tunnel)

Cloudflare 계정 + 도메인이 필요합니다:

bash
cloudflared tunnel login
cloudflared tunnel create agentic-edu
# DNS: cloudflared tunnel route dns agentic-edu agentic.example.com
cat > ~/.cloudflared/config.yml <<EOF
tunnel: <UUID>
credentials-file: ~/.cloudflared/<UUID>.json
ingress:
  - hostname: agentic.example.com
    service: http://127.0.0.1:8000
  - service: http_status:404
EOF
cloudflared tunnel run agentic-edu

보안 메모

  • Quick Tunnel URL은 무작위라 외부 추측은 어렵지만 인증이 없는 공개 게이트웨이입니다. 실 학생 데이터를 다룬다면 named tunnel + Cloudflare Access(Zero Trust) 정책으로 이메일 OTP 등 인증 게이트를 거시기 권장합니다.
  • 백엔드는 127.0.0.1에 바인딩되어 직접 외부에서 접근하는 경로가 없습니다. cloudflared 종료 = 즉시 차단.
  • CORS regex가 *.trycloudflare.com, *.cfargotunnel.com, *.workers.dev를 자동 허용합니다.

Parts

21
QtyValueFootprintReferences
4mount_holeAGENTIC:mount_holeH1, H2, H3, H4
4resistorAGENTIC:resistorR_CS, R_LED, R_PU, R_RST
2buttonAGENTIC:buttonBTN_R, BTN_S
2capacitorAGENTIC:capacitorC_DEC1, C_DEC2
2header_8AGENTIC:header_8J_DATA_IN, J_DATA_OUT
1custom_icAGENTIC:custom_icU
1gndAGENTIC:gndGND1
1header_2AGENTIC:header_2J_TP0
1header_4AGENTIC:header_4J_SPI
1ledAGENTIC:ledLED_BUSY
1oscillatorAGENTIC:oscillatorOSC1
1vccAGENTIC:vccPWR1

More from bkimkr0139-blip/AgentIC

10
  • 2 layers80 × 50 mmPcb 5, the printed circuit board in 3D

    Pcb 5

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    20 parts
  • 2 layers80 × 50 mmPcb 8, the printed circuit board in 3D

    Pcb 8

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    19 parts
  • 2 layers60 × 45 mmPcb 10, the printed circuit board in 3D

    Pcb 10

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    19 parts
  • 2 layers80 × 50 mmPcb 11, the printed circuit board in 3D

    Pcb 11

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    17 parts
  • 2 layers80 × 50 mmPcb 2, the printed circuit board in 3D

    Pcb 2

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    16 parts
  • 2 layers80 × 50 mmPcb 11, the printed circuit board in 3D

    Pcb 11

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    15 parts
  • 2 layers80 × 50 mmPcb 3, the printed circuit board in 3D

    Pcb 3

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    14 parts
  • 2 layers80 × 50 mmPcb 4, the printed circuit board in 3D

    Pcb 4

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    13 parts
  • 2 layers80 × 50 mmPcb 3, the printed circuit board in 3D

    Pcb 3

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    12 parts
  • 2 layers80 × 50 mmPcb 4, the printed circuit board in 3D

    Pcb 4

    bkimkr0139-blip/AgentIC

    RTL → IC → Schematic → PCB → 3D Twin: AI 지원형 IC·회로·PCB 제품화 교육 플랫폼

    10 parts

Similar boards

  • 2 layers28.3 × 39.8 mmLevelShifter, the printed circuit board in 3D

    LevelShifter

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    21 parts5.1kGPL-3.0
  • 2 layers171.2 × 72.9 mmAmiga gfxcard before pour, the printed circuit board in 3D

    Amiga gfxcard before pour

    mntmn/amiga2000-gfxcard

    MNT VA2000, an Open Source Amiga 2/3/4000 Graphics Card (Zorro II/III), written in Verilog

    21 parts1k
  • 2 layers93.9 × 46 mmRectifier, the printed circuit board in 3D

    Rectifier

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    21 parts990GPL-3.0
  • 2 layers45.5 × 42.9 mmEsphome han reader, the printed circuit board in 3D

    Esphome han reader

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    21 parts915
  • 2 layers31.8 × 14.5 mmEsp prog, the printed circuit board in 3D

    Esp prog

    drandyhaas/KiCadRoutingTools

    A set of Python/Rust tools to aid routing in KiCad

    21 parts744MIT
  • 2 layers23.5 × 15.8 mmQuiverAttachPCB, the printed circuit board in 3D

    QuiverAttachPCB

    Arrow-air/project-quiver

    Project Quiver documentation, designs, and project artifacts.

    21 parts617CERN-OHL-S-2.0
  • 2 layers69.9 × 41.3 mmHeaterMeterLCD, the printed circuit board in 3D

    HeaterMeterLCD

    CapnBry/HeaterMeter

    HeaterMeter and LinkMeter Arduino BBQ Controller

    21 parts557MIT
  • 2 layers161.3 × 111.8 mmDoj, the printed circuit board in 3D

    Doj

    kelu124/echomods

    Open source ultrasound processing modules and building blocks

    21 parts463

Questions

How big is the Pcb 10 PCB?

It measures 80 × 50 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Pcb 10 use?

21 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Pcb 10 KiCad files?

From the bkimkr0139-blip/AgentIC repository on GitHub, at the commit this page was made from: the board is apps/api/artifacts_test/project_18/pcb_10/design.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pcb 10 design in my own project?

Its repository states no licence, so its author keeps all rights: ask bkimkr0139-blip before reusing the design.