FacereDataset

Facere/FacereDataset

Fork 0

Commit Graph

Author	SHA1	Message	Date
Knowit	fb577cc89f	tools/epro2/kicad: fix two KiCad 8 parse blockers (newline + pin_numbers) 装 kicad 8.0.9 (apt PPA) 后跑 kicad-cli sch erc 校验我们 emit 的 .kicad_sch 文件，发现 9/9 sheets 一开始全部报 "Failed to load schematic file" — 父节点解析就挂掉。Bisect 找到两个语法 bug： 1. (pin_numbers (hide no)) 不被 KiCad 8 接受 KiCad 8 lib_symbols 里 `pin_numbers` 是 token-form，不接受 (hide yes/no) 子块。要么省略整个 block 默认 visible，要么 `(pin_numbers hide)` 表示隐藏。原来的 `(hide no)` 风格是 KiCad 7 旧语法。 Fix: tools/epro2/kicad/sym_writer.py 删掉 (pin_numbers (hide no)) 行；KiCad 默认 visible 行为正是我们想要的。 2. String 里的字面 \n / \r / \t 让 KiCad 解析器中止 ESP-VoCat 的 Overview sheet 有 TEXT "Battary\n3.7V 700mAH"（多行电池标签），EPRO2 里以字面 0x0a 字符存储。我们把它原样 emit 成 "..." 包住的字符串 → KiCad reader 在 quoted string 内遇到 \n 就报 parse error 不给 message。 Fix: tools/epro2/kicad/sexpr.py 在 str escape 路径加 \n / \r / \t 转义；reader 加 \r 解码（roundtrip 用）。修完后： 9/9 sheets parse OK in KiCad 8.0.9 ERC 跑通，9 个 sheet 共 2793 violations，分布： 1372 endpoint_off_grid (49%, cosmetic — 30-mil EPRO2 grid 不 snap KiCad 默认 50-mil grid) 571 lib_symbol_issues (20%, cosmetic — facere 库未注册到 user library table；库已 embed 在 .kicad_sch 内联可用) 444 wire_dangling (16%, real — wire 端点没精确对齐 pin) 406 pin_not_connected (15%, 同上的另一面) Cosmetic 占 70%，real connectivity 30%，下个 phase 处理： - grid 校准（把 coord 精确 round 到统一 grid 上） - pin tip 端点匹配（KiCad 需要 wire 端点 == pin (at) 字段对应的绝对坐标，浮点必须精确相等） - 生成 sym-lib-table 注册 facere 库（消 lib_symbol_issues）测试： + test_string_escapes_newlines_and_tabs + test_lib_symbol_omits_pin_numbers_block reader 加 \r 解码 41/41 通过（39 旧 + 2 新）。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-28 23:04:58 +08:00
Knowit	9213429a57	tools/epro2/kicad: Phase-1 EPRO2 → KiCad schematic exporter 写第一版 EPRO2 → .kicad_sch 转换：把 SCH_PAGE Document 的 wires + COMPONENT placements + TEXT 输出到一个可被 KiCad 7+ 打开的 sch 文件。不含 symbol 主体（lib_symbols 留空 stub），所以 KiCad 里组件会渲染成红色 "?" 占位，但布线 + 位置 + Designator/Value 属性都正确。完整 symbol 库导出留 Phase 2。模块结构： tools/epro2/kicad/sexpr.py 手写 S-expr emitter，Sym 标记裸符号， str 自动加引号 + 转义；float 去尾零； bool→yes/no；NaN/Inf 主动报错 tools/epro2/kicad/_sexpr_reader.py 极简 S-expr parser，仅给 round-trip 测试用（非完整 KiCad reader） tools/epro2/kicad/sch_writer.py write_sch_page(doc) → str；处理： LINE → (wire (pts ...) ...) COMPONENT → (symbol (lib_id facere:<partId>) (at x y rot) (property Reference ...) ...) TEXT → (text "..." (at ...)) 单位 mil → mm × 0.0254；零长 wire 跳过 tools/epro2/kicad/__main__.py CLI: --doc <uuid> \| --all-sch ESP-VoCat 验证（python -m tools.epro2.kicad <project> --all-sch）： 9 SCH_PAGE 全部转换成功 P1_408c9f4f.kicad_sch wires= 6 symbols= 10 text= 0 skipped= 2 (370 lines) P1_ee409917.kicad_sch wires= 20 symbols= 14 text= 0 skipped= 3 P1_54743d77.kicad_sch wires= 42 symbols= 30 text= 3 Overview_dc13d6d2.kicad_sch wires= 0 symbols= 1 text= 34 (说明页) MCU_510cff33.kicad_sch wires= 91 symbols= 86 text= 9 Interface_b336a7c7.kicad_sch wires= 99 symbols= 95 text= 6 P1_5c38f45b.kicad_sch wires=179 symbols= 86 text= 9 P1_45092758.kicad_sch wires=187 symbols=138 text= 10 (主图) codec_0b0163fa.kicad_sch wires=190 symbols=112 text= 10 输出落在 data/processed/kicad_sch/<filename>.kicad_sch（gitignore 内，可重新生成；不入库）。测试：6 个 sexpr 测 + 6 个 sch_writer 测，含 round-trip parse 验证。 parser/relations/project_relations 的旧 21 个不动，合计 33/33 通过。下一步： 1. Phase 2 — symbol library 导出 (.kicad_sym)，把 SYMBOL doc 的 PIN/RECT/ TEXT primitives 转 KiCad symbol 主体；填 lib_symbols 块让组件渲染出真正的 schematic 符号 2. footprint library + .kicad_pcb 导出 3. 用 KiCad CLI (kicad-cli sch erc) 跑 ERC 校验 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-28 22:29:15 +08:00

Author

SHA1

Message

Date

Knowit

fb577cc89f

tools/epro2/kicad: fix two KiCad 8 parse blockers (newline + pin_numbers)

装 kicad 8.0.9 (apt PPA) 后跑 kicad-cli sch erc 校验我们 emit 的
.kicad_sch 文件，发现 9/9 sheets 一开始全部报 "Failed to load schematic
file" — 父节点解析就挂掉。Bisect 找到两个语法 bug：

1. **(pin_numbers (hide no)) 不被 KiCad 8 接受**
   KiCad 8 lib_symbols 里 `pin_numbers` 是 token-form，不接受 (hide
   yes/no) 子块。要么省略整个 block 默认 visible，要么 `(pin_numbers
   hide)` 表示隐藏。原来的 `(hide no)` 风格是 KiCad 7 旧语法。

   Fix: tools/epro2/kicad/sym_writer.py 删掉 (pin_numbers (hide no))
        行；KiCad 默认 visible 行为正是我们想要的。

2. **String 里的字面 \n / \r / \t 让 KiCad 解析器中止**
   ESP-VoCat 的 Overview sheet 有 TEXT "Battary\n3.7V 700mAH"（多行
   电池标签），EPRO2 里以**字面 0x0a 字符**存储。我们把它原样 emit
   成 "..." 包住的字符串 → KiCad reader 在 quoted string 内遇到 \n
   就报 parse error 不给 message。

   Fix: tools/epro2/kicad/sexpr.py 在 str escape 路径加 \n / \r / \t
        转义；reader 加 \r 解码（roundtrip 用）。

修完后：

  9/9 sheets parse OK in KiCad 8.0.9
  ERC 跑通，9 个 sheet 共 2793 violations，分布：
     1372 endpoint_off_grid        (49%, cosmetic — 30-mil EPRO2 grid 不
                                    snap KiCad 默认 50-mil grid)
      571 lib_symbol_issues        (20%, cosmetic — facere 库未注册到
                                    user library table；库已 embed 在
                                    .kicad_sch 内联可用)
      444 wire_dangling            (16%, real — wire 端点没精确对齐 pin)
      406 pin_not_connected        (15%, 同上的另一面)

  Cosmetic 占 70%，real connectivity 30%，下个 phase 处理：
    - grid 校准（把 coord 精确 round 到统一 grid 上）
    - pin tip 端点匹配（KiCad 需要 wire 端点 == pin (at) 字段对应的
      绝对坐标，浮点必须精确相等）
    - 生成 sym-lib-table 注册 facere 库（消 lib_symbol_issues）

测试：
  + test_string_escapes_newlines_and_tabs
  + test_lib_symbol_omits_pin_numbers_block
  reader 加 \r 解码

41/41 通过（39 旧 + 2 新）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-28 23:04:58 +08:00

Knowit

9213429a57

tools/epro2/kicad: Phase-1 EPRO2 → KiCad schematic exporter

写第一版 EPRO2 → .kicad_sch 转换：把 SCH_PAGE Document 的 wires +
COMPONENT placements + TEXT 输出到一个可被 KiCad 7+ 打开的 sch 文件。
不含 symbol 主体（lib_symbols 留空 stub），所以 KiCad 里组件会渲染
成红色 "?" 占位，但布线 + 位置 + Designator/Value 属性都正确。完整
symbol 库导出留 Phase 2。

模块结构：
  tools/epro2/kicad/sexpr.py        手写 S-expr emitter，Sym 标记裸符号，
                                    str 自动加引号 + 转义；float 去尾零；
                                    bool→yes/no；NaN/Inf 主动报错
  tools/epro2/kicad/_sexpr_reader.py  极简 S-expr parser，仅给 round-trip
                                    测试用（非完整 KiCad reader）
  tools/epro2/kicad/sch_writer.py   write_sch_page(doc) → str；处理：
                                      LINE  → (wire (pts ...) ...)
                                      COMPONENT → (symbol (lib_id facere:<partId>)
                                                  (at x y rot) (property Reference ...) ...)
                                      TEXT  → (text "..." (at ...))
                                    单位 mil → mm × 0.0254；零长 wire 跳过
  tools/epro2/kicad/__main__.py     CLI: --doc <uuid> | --all-sch

ESP-VoCat 验证（python -m tools.epro2.kicad <project> --all-sch）：
  9 SCH_PAGE 全部转换成功
  P1_408c9f4f.kicad_sch    wires=  6  symbols= 10  text=  0  skipped= 2  (370 lines)
  P1_ee409917.kicad_sch    wires= 20  symbols= 14  text=  0  skipped= 3
  P1_54743d77.kicad_sch    wires= 42  symbols= 30  text=  3
  Overview_dc13d6d2.kicad_sch wires=  0  symbols=  1  text= 34   (说明页)
  MCU_510cff33.kicad_sch   wires= 91  symbols= 86  text=  9
  Interface_b336a7c7.kicad_sch wires= 99  symbols= 95  text=  6
  P1_5c38f45b.kicad_sch    wires=179  symbols= 86  text=  9
  P1_45092758.kicad_sch    wires=187  symbols=138  text= 10  (主图)
  codec_0b0163fa.kicad_sch wires=190  symbols=112  text= 10

输出落在 data/processed/kicad_sch/<filename>.kicad_sch（gitignore 内，
可重新生成；不入库）。

测试：6 个 sexpr 测 + 6 个 sch_writer 测，含 round-trip parse 验证。
parser/relations/project_relations 的旧 21 个不动，合计 **33/33 通过**。

下一步：
1. Phase 2 — symbol library 导出 (.kicad_sym)，把 SYMBOL doc 的 PIN/RECT/
   TEXT primitives 转 KiCad symbol 主体；填 lib_symbols 块让组件渲染
   出真正的 schematic 符号
2. footprint library + .kicad_pcb 导出
3. 用 KiCad CLI (kicad-cli sch erc) 跑 ERC 校验

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-28 22:29:15 +08:00

2 Commits