Skip to the content
2 layers80 × 50 mmPcb 2, 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
16
Nets
17
Pads
16
Tracks, vias
57, 2
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
13 May 2026
Updated
13 May 2026

Overview

Pcb 2 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 16 parts on 17 nets, routed with 57 tracks and 2 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

16
QtyValueFootprintReferences
5ledAGENTIC:ledLED_Y0, LED_Y1, LED_Y2, LED_Y3, LED_Y4
4mount_holeAGENTIC:mount_holeH1, H2, H3, H4
2dip_switch_4AGENTIC:dip_switch_4DIP_A, DIP_B
1capacitorAGENTIC:capacitorC_DECX0
1custom_icAGENTIC:custom_icU
1dip_switch_2AGENTIC:dip_switch_2DIP_OP
1gndAGENTIC:gndGND1
1vccAGENTIC:vccPWR1

More from bkimkr0139-blip/AgentIC

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

    Pcb 10

    bkimkr0139-blip/AgentIC

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

    21 parts
  • 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 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 layers140.5 × 30 mmType e, the printed circuit board in 3D

    Type e

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    16 parts3kApache-2.0
  • 2 layers41.4 × 14.5 mmU2f zero, the printed circuit board in 3D

    U2f zero

    conorpp/u2f-zero

    U2F USB token optimized for physical security, affordability, and style

    16 parts2.4k
  • 2 layers122 × 37 mmV0-UmbilicalBoard, the printed circuit board in 3D

    V0-UmbilicalBoard

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    16 parts1.1kGPL-3.0
  • 2 layers152 × 57.6 mmVideoslotadapter, the printed circuit board in 3D

    Videoslotadapter

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    16 parts1kGPL-3.0
  • 2 layers36 × 63.4 mmSmart ringfinal layout, the printed circuit board in 3D

    Smart ringfinal layout

    hackclub/OnBoard

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

    16 parts915
  • 2 layers60 × 40 mmHASwitchPlate, the printed circuit board in 3D

    HASwitchPlate

    aderusha/HASwitchPlate

    LCD touchscreen for Home Automation

    16 parts738MIT
  • 2 layers21.1 × 26.9 mmDemo, the printed circuit board in 3D

    Demo

    easyw/kicadStepUpMod

    kicadStepUp: ECAD to MCAD FreeCAD WorkBench

    16 parts704

Questions

How big is the Pcb 2 PCB?

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

What parts does the Pcb 2 use?

16 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 2 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_2/pcb_2/design.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

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

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