# tools/netlist_semantics/ — 网表语义分析

> 把电路**网表文件**（`.tel`）解析成"有语义的引脚知识库"，供生成引脚表与网表分析报告。

## 脚本一览

| 脚本 | 作用 |
|---|---|
| `netlist_sem.py` | 网表解析核心（把 `.tel` 网表 → 结构化的网络/引脚连接） |
| `gen_kb.py` | 生成**引脚知识库** `pinout_kb.json` |
| `pinout_kb.json` | 引脚知识库产物（MCU 引脚 ↔ 网络 ↔ 外设的映射） |

## 使用方式

```bash
& '.venv\Scripts\python.exe' tools/netlist_semantics/netlist_sem.py <网表.tel>
& '.venv\Scripts\python.exe' tools/netlist_semantics/gen_kb.py
```

## 输入 / 产物

- **输入**：硬件网表 `.tel`（位于 `docs/硬件平台/`，如 `V0.0.tel`、`V0.1.tel`）
- **产物**：`pinout_kb.json` + `docs/硬件平台/V0.0_网表详细分析报告.md`、`docs/硬件平台/V0.0_网表语义图.md`

## 相关文档

- `docs/硬件平台/V0.0_网表详细分析报告.md`
- `docs/硬件平台/V0.0_网表语义图.md`
- 硬件引脚表：根 `README.md`「外设接口」