Zener 是 Starlark 加上 PCB 专用模块的语言,涵盖类型化电气连接、物理器件、采购、布局与诊断。
用途与能力:.zen 文件既可作为普通 Starlark 模块用 load() 导入,也可作为可实例化原理图模块用 Module() 导入。Component() 依据 name、symbol、pins 创建物理器件,符号是封装、器件身份、数据手册与引脚的权威来源。Project() 可用 layout=False 或 schematic=False 关闭其一。
IO 与配置:公共电气连接用顶层赋值定义,如 VDD = io(Power(voltage="3.0V to 5.5V"))、GND = io(Ground)、EN = io(Net, optional=True)。非电气选项用 config() 定义,物理量类型从 @stdlib/units.zen 加载。
用法要点:跨包导入使用完整包 URL;用 pcb list -m -json 查找包源码目录;CLI 行为以 --help 为准。依赖由工具管理,stdlib 不写入 [dependencies];用 pcb list -m -u 查看更新,pcb add -u 做兼容更新。完成后运行 pcb sync、pcb fmt、pcb build,必要时用 pcb bom -f json。
限制:配置可改值与 dnp 状态,但不应增删或重连实例;不支持精确保留源参考位号;旧版 # pcb:sch 记录需保留,迁移前先运行 pcb-sch export-kicad。其余细节暂未提供。