1. 从“画封装”这件事说起为什么我最终选择了脚本化路线画原理图封装这件事说大不大说小也绝对不小。任何一个用过 Altium Designer 的人都有体会一个电阻电容的封装手动画也就半分钟但当你面对一颗几百个引脚的大型芯片比如 BGA 或者多排 QFN手动一根一根放引脚、改名字、设电气类型那基本就是一场耐力赛。更别提画完之后发现引脚编号从 1 开始错了位或者某个电源引脚忘了标成 Power 类型回头再改一遍心态直接崩掉。我最早接触 AD 的时候也是老老实实手动建库。一个项目下来原理图库里堆了几百个器件每个器件的封装都是自己一笔一划描出来的。后来项目越做越大器件越来越复杂我开始琢磨这东西能不能用脚本自动生成毕竟 AD 本身就支持脚本扩展DelphiScript、VBScript、JavaScript 都能跑官方还提供了完整的 API 文档。于是就有了这个“AD 原理图模拟操作助手”的雏形——一套用脚本批量绘制原理图封装的工具集。这篇文章要聊的就是这套脚本工具的使用说明和背后的设计思路。它解决的核心问题很明确把重复性极高的封装绘制工作自动化让脚本帮你放引脚、设属性、排布局你只需要提供一份引脚定义表剩下的交给代码。适合谁看有一定 AD 基础、会画原理图、但被大量封装工作折磨过的硬件工程师也适合想学 AD 二次开发、用脚本提升效率的同行。哪怕你之前没写过一行脚本跟着思路走也能上手。2. 整体设计思路为什么是脚本而不是手动或者第三方工具2.1 手动绘制的效率瓶颈到底在哪里先算一笔账。假设一颗 100 引脚的芯片手动绘制原理图封装的流程大致是放置一个矩形边框然后逐个放置引脚每个引脚需要设置编号、名称、电气类型、引脚长度、方向还要调整位置对齐。熟练工操作一个引脚大概需要 8 到 12 秒100 个引脚就是 15 到 20 分钟。这还不包括中途改错、对齐调整、检查遗漏的时间。如果一天要建 5 个这样的器件大半天就没了。更关键的是手动操作的一致性很难保证。今天画的引脚长度是 200mil明天可能就变成 300mil这个器件的电源引脚标了 Power那个器件忘了标。这些细节在后期 ERC 检查时才会暴露出来返工成本很高。2.2 脚本方案的核心优势脚本化绘制的逻辑完全不同。你把引脚信息整理成一份结构化的数据——通常就是一个表格包含引脚编号、引脚名称、电气类型、所在边上下左右、在边上的顺序——然后脚本读取这份数据按照预设的规则自动生成封装。整个过程从“手工劳动”变成了“数据录入加一键生成”。这样做的好处有几个。第一是速度100 个引脚的器件脚本跑完不到 2 秒。第二是一致性所有封装都遵循同一套规则引脚长度、字体大小、间距全部统一。第三是可维护性如果发现某个引脚类型标错了改一下数据表重新生成就行不用在 AD 界面里一个个找。第四是可复用性同一套脚本稍作修改就能适配不同封装的器件积累下来就是一个效率工具库。2.3 为什么不用现成的第三方工具市面上确实有一些封装生成工具比如某些在线引脚图生成器或者芯片厂商提供的 Symbol 文件。但这些方案有几个问题。一是格式兼容性下载下来的文件往往需要转换才能导入 AD转换过程中容易丢信息。二是灵活性差厂商提供的 Symbol 往往不符合自己公司的绘图规范比如引脚分组方式、电源引脚的位置安排等。三是数据安全把芯片引脚定义上传到在线工具对于某些项目来说不太合适。自己写脚本虽然前期投入一些时间学习 API但换来的是完全可控、完全贴合自己工作流的方案。而且 AD 的脚本 API 并不复杂常用的就是那几个对象SchLib、SchComponent、SchPin掌握之后可以玩出很多花样。2.4 脚本语言的选择考量AD 支持多种脚本语言我最终选择了 DelphiScript 作为主要开发语言。原因很简单它是 AD 原生支持最好的脚本语言官方文档和示例代码最多API 覆盖最全。VBScript 虽然写起来更简单但在处理复杂逻辑和大量数据时性能稍弱。JavaScript 在 AD 里的支持相对有限某些 API 调用不太稳定。当然如果你已经熟悉 VBScript 或 JavaScript用它们也完全可以。核心的 API 调用逻辑是相通的差别主要在语法层面。我建议新手从 DelphiScript 入手因为遇到问题时最容易找到参考资料。3. 核心细节解析脚本绘制封装的几个关键环节3.1 引脚数据的结构化组织脚本绘制的第一步也是最关键的一步是把引脚信息整理成脚本能读懂的格式。我通常用 CSV 文件来存储引脚数据因为 Excel 编辑方便导出也简单。一个典型的引脚数据表包含以下字段字段名说明示例PinNumber引脚编号A1, B2, 1, 2PinName引脚名称VCC, GND, GPIO0ElectricalType电气类型Power, Input, Output, BidirectionalSide所在边Left, Right, Top, BottomOrder在边上的排列顺序1, 2, 3这里有几个细节需要注意。引脚编号在 BGA 封装里通常是字母加数字的组合比如 A1、B2脚本需要原样读取不能做数值转换。电气类型必须用 AD 能识别的标准字符串大小写敏感写错了脚本会报错。Side 字段决定了引脚放在矩形的哪一边Order 决定了在同一边上的上下或左右顺序。注意CSV 文件保存时一定要用 UTF-8 编码否则引脚名称里的中文或特殊字符会乱码。另外字段之间的逗号分隔要严格如果引脚名称本身包含逗号需要用引号包裹。3.2 封装边框的自动计算引脚放好之后需要画一个矩形边框把引脚框起来。边框的大小不能随便定要根据引脚数量和分布来计算。我的做法是先确定每一边的引脚数量和引脚间距然后算出每一边需要的长度取最大值作为边框的对应边长再加上一定的边距。具体来说假设左边有 20 个引脚引脚间距是 100mil那么左边需要的长度是 20 乘以 100 等于 2000mil。如果右边有 15 个引脚右边需要的长度是 1500mil。那么矩形的高度就取 2000mil 加上上下各 200mil 的边距总共 2400mil。宽度同理根据上下两边的引脚数量计算。这个计算逻辑看起来简单但实际写脚本时要注意单位换算。AD 的内部单位是 1/10000 英寸也就是 0.1mil。你在脚本里设置的坐标值需要乘以 10000 才能对应到 AD 的实际位置。比如你想把引脚放在 100mil 的位置脚本里要写 1000000。这个坑我踩过好几次刚开始总是发现引脚位置偏了十倍。3.3 引脚属性的批量设置每个引脚除了位置之外还有一堆属性需要设置名称、编号、电气类型、引脚长度、名称字体大小、编号字体大小、是否显示名称、是否显示编号等。手动设置这些属性极其繁琐但脚本可以批量处理。在 DelphiScript 里创建一个引脚的基本代码是这样的Pin : SchComponent.AddSchPin; Pin.Designator : A1; Pin.Name : VCC; Pin.ElectricalType : eElectricPower; Pin.PinLength : 200; Pin.Location.X : 0; Pin.Location.Y : 0; Pin.Orientation : eRotate0;这里有几个容易出错的地方。ElectricalType 的枚举值在不同 AD 版本里可能略有差异建议查一下对应版本的 API 文档。PinLength 的单位是 mil不是内部单位这个和坐标设置不一样要注意区分。Orientation 决定了引脚的朝向eRotate0 是引脚朝右eRotate180 是朝左eRotate90 是朝上eRotate270 是朝下。3.4 引脚名称和编号的显示控制AD 默认会显示引脚的名称和编号但在某些情况下需要隐藏。比如电源引脚通常不显示名称只显示编号或者某些封装的引脚编号在内部不需要显示。脚本可以通过设置 Pin.NameVisible 和 Pin.DesignatorVisible 属性来控制。还有一个细节是引脚名称的位置。AD 允许把引脚名称放在引脚内部或外部通过 Pin.NamePosition 属性设置。对于引脚密集的器件把名称放在内部可以节省空间但可读性会下降。我的经验是引脚数量少于 50 个时名称放外部超过 50 个时考虑放内部或者用缩写。4. 实操过程从零开始跑通一个封装生成脚本4.1 环境准备与脚本加载首先确保你的 AD 已经安装完整脚本功能没有被精简掉。打开 AD 后通过菜单栏的“DXP”或“文件”菜单找到“运行脚本”入口。如果你用的是较新版本可能在“系统”菜单下。第一次运行脚本时AD 会要求你选择脚本文件通常是一个 .pas 文件DelphiScript或 .vbs 文件。我建议把脚本文件放在一个固定的目录比如“文档/AltiumScripts/”方便管理和版本控制。如果团队多人使用可以把脚本目录放在共享盘上统一更新。加载脚本后AD 会弹出一个对话框让你选择要运行的函数。一个脚本文件里可以定义多个函数每个函数完成一个独立的功能比如“GenerateSymbolFromCSV”、“UpdatePinLength”、“ExportPinList”等。选择对应的函数后点击运行即可。4.2 创建原理图库和器件脚本的第一步是创建一个新的原理图库文件或者打开一个已有的库。如果是从零开始代码大致如下Library : CreateNewDocumentFromDocumentKind(SCHLIB); SchLib : Library.DM_GetSchLibDocument; SchComponent : SchLib.AddSchComponent; SchComponent.Designator.Text : U1;这里要注意CreateNewDocumentFromDocumentKind 的参数在不同 AD 版本里可能不同有的是 SCHLIB有的是 SchLib。如果报错查一下你所用版本的文档。创建器件后需要设置器件的默认属性比如默认的引脚长度、字体大小、颜色等。这些属性会应用到该器件下的所有引脚除非单独覆盖。4.3 读取 CSV 并生成引脚这是脚本的核心部分。首先用 TStringList 读取 CSV 文件然后逐行解析提取引脚信息创建对应的引脚对象。SL : TStringList.Create; SL.LoadFromFile(pins.csv); for i : 1 to SL.Count - 1 do begin Line : SL[i]; Fields : SplitString(Line, ,); Pin : SchComponent.AddSchPin; Pin.Designator : Fields[0]; Pin.Name : Fields[1]; Pin.ElectricalType : StrToElectricalType(Fields[2]); // 根据 Side 和 Order 计算位置 // ... end;SplitString 是一个自定义函数因为 DelphiScript 没有内置的字符串分割函数。你可以用 Pos 和 Copy 函数手动实现逻辑不复杂。位置计算是重点。假设左边引脚从下往上排列第一个引脚在 Y0第二个在 Y100第三个在 Y200以此类推。右边引脚从上往下排列第一个在最高点依次递减。上边引脚从左往右排列下边引脚从右往左排列。这些规则可以根据实际需求调整关键是保持一致性。4.4 绘制边框和调整布局引脚放完之后根据引脚的分布范围计算边框的坐标然后添加一个矩形。AD 里画矩形用 SchComponent.AddSchRectangle设置左上角和右下角的坐标即可。边框画好后可能需要微调引脚的位置让它们均匀分布。我的做法是先按固定间距放置引脚然后计算实际占用的总长度如果和边框长度不匹配就调整间距重新放置。这个迭代过程在脚本里用一个循环实现通常两三次就能收敛。4.5 保存和导出脚本的最后一步是保存库文件并可选地导出引脚列表供核对。保存用 SchLib.SaveToFile 方法指定路径即可。导出引脚列表可以用 TStringList 把每个引脚的编号、名称、类型写到一个文本文件里方便和原始数据对比。提示脚本运行过程中如果出错AD 通常会弹出一个错误对话框显示错误信息和行号。建议在脚本里加一些日志输出把关键步骤的信息写到文件里方便排查问题。5. 常见问题与排查技巧实录5.1 引脚位置偏移或重叠这是最常见的问题通常由单位换算错误或坐标计算逻辑错误引起。先检查坐标值是否乘以了 10000再检查引脚间距是否一致。如果引脚重叠可能是 Order 字段有重复值或者位置计算公式里用了错误的索引。排查方法在脚本里加一行日志把每个引脚的最终坐标打印出来和预期值对比。如果某个引脚的坐标明显异常顺着计算逻辑往回找。5.2 电气类型设置无效AD 的电气类型枚举值有特定要求比如 eElectricPower、eElectricInput、eElectricOutput、eElectricBidirectional、eElectricPassive 等。如果你从 CSV 里读的是字符串需要写一个转换函数把字符串映射到对应的枚举值。映射表要完整遗漏任何一个都会导致该引脚类型设置失败。另外注意某些 AD 版本对电气类型的支持有差异比如 eElectricOpenCollector 在某些版本里不可用。建议先用少量引脚测试确认所有类型都能正确设置后再批量运行。5.3 脚本运行速度慢如果引脚数量很多比如超过 500 个脚本可能会跑得比较慢。主要原因是每次添加引脚都会触发 AD 的界面刷新。解决办法是在脚本开始时关闭界面更新结束时再打开。AD 提供了 Screen.UpdateLock 或类似机制具体方法查一下 API 文档。另一个优化点是减少不必要的属性设置。比如如果所有引脚的字体大小都一样可以在器件级别设置一次而不是每个引脚都设一遍。5.4 CSV 文件读取失败常见原因有文件路径包含中文或空格、文件编码不是 UTF-8、字段分隔符不匹配。建议把 CSV 文件放在纯英文路径下用 Excel 另存为 UTF-8 编码的 CSV并确认分隔符是逗号而不是制表符。如果引脚名称里本身包含逗号比如“VCC, 3.3V”需要用双引号把整个字段包裹起来脚本解析时也要相应处理引号。5.5 生成的封装在原理图里显示异常有时候脚本生成的封装在库里看没问题但放到原理图里后发现引脚名称不显示、边框颜色不对、引脚编号位置偏移等。这通常是器件属性的默认值没有设置好。检查器件的 PinNamePosition、PinDesignatorPosition、RectangleColor 等属性确保它们符合你的显示要求。还有一个可能是库文件的版本兼容性问题。如果你用的 AD 版本和脚本开发时的版本不一致某些属性可能不被识别。建议在目标版本上重新测试一遍。6. 进阶技巧让脚本工具更贴合你的工作流6.1 从芯片数据手册自动提取引脚信息手动整理 CSV 虽然比手动画封装快但面对几百个引脚的芯片录入数据也是一件苦差事。如果你的数据手册是 PDF 格式可以尝试用 Python 脚本提取引脚表格然后转换成 CSV。常用的库有 pdfplumber、camelot 等对于规整的表格效果不错。当然PDF 提取的准确率不是百分之百提取后需要人工核对一遍。但即使这样也比纯手动录入快得多。我通常的做法是先用 Python 提取导出 CSV然后在 Excel 里快速过一遍修正明显的错误再交给 AD 脚本生成封装。6.2 封装模板化与参数化如果你经常画同一类封装比如不同引脚数量的 QFN 或 BGA可以把脚本进一步抽象成模板。模板里定义好引脚的排列规则、边框的计算公式、属性的默认值使用时只需要提供引脚数量和间距等少数参数。这样做的好处是新器件的封装生成时间从几分钟缩短到几秒钟。而且因为模板统一所有封装的风格完全一致后期维护也方便。6.3 与版本控制系统结合脚本文件和 CSV 数据文件都建议纳入版本控制比如 Git。每次修改脚本或数据都提交一次记录变更原因。这样如果某次修改导致封装生成出错可以快速回滚到之前的版本。对于团队协作可以把脚本放在共享仓库里每个人拉取最新版本使用。如果某个人改进了脚本提交后其他人也能受益。6.4 批量生成多个封装如果你有一批器件需要建库可以把它们的引脚数据分别存成多个 CSV 文件然后写一个批处理脚本依次读取每个 CSV 并生成对应的封装。这样一次运行就能建好整个库效率提升非常明显。批处理脚本的关键是处理好文件遍历和错误处理。如果某个 CSV 有问题脚本应该跳过它并记录错误而不是整个批处理中断。7. 一些踩坑之后的个人体会这套脚本工具我从最初的一个简单函数慢慢迭代到现在能处理各种复杂封装中间踩的坑不计其数。最大的体会是脚本化不是一蹴而就的而是随着使用不断完善的。一开始不要追求大而全先解决最痛的那个点比如自动放置引脚跑通了再逐步加功能。另一个体会是数据质量比脚本本身更重要。引脚数据表如果整理得规范、准确脚本跑起来就很顺如果数据表里错误百出脚本再强大也救不了。所以我现在花在整理数据上的时间往往比写脚本的时间还多。最后分享一个小技巧在脚本里加一个“干跑”模式只读取数据并打印将要执行的操作不实际修改库文件。这样可以在正式生成之前快速检查数据有没有问题避免生成一堆错误的封装再回头删。这个模式在调试阶段特别有用强烈建议加上。