# 2026-08-21 工作日志

## 环路车检器方案 + 原理图

- 老大咨询环路车检器检测方法选型与原理图绘制
- 输出：检测方法对比（LC振荡+频率计数 主推 / PLL 高灵敏 / 电桥 不推荐 / 多频扫频 抗变频器干扰旗舰）+ LC振荡频率计数方案完整原理图
- 文件：`/root/.openclaw/workspace/loop-detector/`
  - `loop-detector-principle.html`（源文件，含图1方法对比 + 图2原理图）
  - `fig1-methods.svg/.png`、`fig2-schematic.svg/.png`
  - `inline_svg.py`（SVG 样式内联转换脚本，librsvg 不支持 CSS 变量）
- 关键设计点：匹配变压器隔离耦合、谐振 20~150kHz、周期法测频、基准频率自适应抗温漂、光耦隔离输出、回差阈值

## 服务器安装 KiCad

- **KiCad 7.0.11** 安装完成（apt 官方源，35 个包，库占 363MB）
- 组件：kicad / kicad-cli / eeschema / pcbnew，符号库+封装库完整
- 无 GPU：3D 查看器软渲染慢，原理图/PCB 编辑不受影响
- 图形界面走向日葵远程桌面使用

## KiCad 环路车检器原理图工程（已交付）

- 目录：`/root/.openclaw/workspace/loop-detector/loop-detector-kicad/`
  - `loopdet.kicad_sym` — 自定义符号库（R/C/Q_NPN/MOS_N/LED/TVS_BI/XFMR/OPTO/COMP/MCU/RELAY_SPDT/CONN2）
  - `loop-detector.kicad_sch` — 原理图（A3，LC振荡+频率计数完整信号链）
  - `loop-detector.kicad_pro` — 工程文件
  - `loop-detector.pdf` — 导出的 PDF
  - `loop-detector-preview.png` — 预览图
  - `gen_sch.py` — 程序化生成脚本（改参数后重跑即可）
  - `sym-lib-table` — 工程级符号库表；全局表在 `~/.config/kicad/7.0/sym-lib-table`
- **KiCad 7 文件格式踩坑记录（重要！）**：
  1. 文件头 `(kicad_sch (version 20230121) (generator eeschema)`，uuid/generator 都不带引号
  2. 内嵌 lib_symbols 符号名必须带库前缀（`"loopdet:C"`），与 lib_id 一致才能解析
  3. pin 必须带电气/图形类型：`(pin passive line (at ...) (length ...) (name "~" ...) (number "1" ...))`
  4. symbol 实例必须有 `(instances (project ... (path ... (reference ...) (unit 1))))` 块
  5. 网络标签是 `(label "VCC" (at ...) (effects ...) (uuid ...))`，不是 net_label
  6. 顶层文本是 `(text "内容" (at ...) ...)`，字符串前置，不是 (string ...) 子块
- 调试方法：kicad-cli sch export pdf 验证；用 top_children 拆分文件做二分测试定位解析错误
- 经验：kicad-cli 查库表加载缺失库会段错误（t11 测试），尽量内嵌符号