# pcb/ — PCB 设计文档目录

> 本目录存放 PCB 设计相关文档（原理图、布局、Gerber、评审记录等）。
> 由硬件同事**唐磊**提交的文档统一归档于此，随 xdeSpace 每日自动同步（每天 02:30）。

## 归档约定

- 原理图 / 布局文件：KiCad 工程（`.kicad_sch` / `.kicad_pcb`）或嘉立创EDA 导出文件
- 评审记录：Markdown，命名建议 `YYYY-MM-DD-主题.md`
- 生产文件：Gerber / BOM / 坐标文件，按项目子目录存放

## KiCad 项目命名规范

- 每个 KiCad 工程放在其项目子目录内，命名为 `<项目名>-kicad/`
  - 例：环路车检器 → `loop-detector/loop-detector-kicad/`
- 工程文件统一命名（避免与目录名重复冲突）：
  - 原理图：`<项目名>.kicad_sch`
  - PCB 布局：`<项目名>.kicad_pcb`
  - 工程文件：`<项目名>.kicad_pro`
  - 自定义符号库：`<项目名>.kicad_sym`
- 导出交付件（PDF / PNG / Gerber）与源文件同目录存放，便于一站式出档
- 一个项目只对应一个 `-kicad/` 目录，不要散落

## 当前项目

### loop-detector（环路车检器）— 2026-08-21 唐磊产出

KiCad 7.0.11 工程，A3 单页原理图，完整信号链：
**线圈端子 → TVS 浪涌保护 → 匹配变压器 → 考毕兹振荡 → 比较器整形 → MCU 测频 → 光耦隔离 → 继电器输出**

目录结构：
```
pcb/loop-detector/
├── loop-detector-kicad/     ← KiCad 工程
│   ├── loop-detector.kicad_sch   ← 原理图
│   ├── loop-detector.kicad_pro   ← 工程文件
│   ├── loopdet.kicad_sym         ← 自定义符号库（12 符号）
│   ├── loop-detector.pdf         ← 导出 PDF
│   ├── loop-detector-preview.png ← 预览图
│   └── gen_sch.py                ← 程序化生成脚本
├── loop-detector-principle.html  ← 原理图网页版（交互）
├── fig1-methods.svg/png          ← 检测方法对比图
├── fig2-schematic.svg/png        ← 系统框图
└── inline_svg.py                 ← SVG 内联化工具
```

---

_维护：小德（自动归档）_