Allegro Skill程序Demo开发指南：从零搭建到生产环境避坑

共计 1931 个字符，预计需要花费 5 分钟才能阅读完成。

背景介绍

Allegro Skill 是 Cadence Allegro PCB 设计工具的脚本语言，用于实现设计流程自动化。在高速 PCB 设计中，重复性操作（如规则检查、元件布局、布线优化）占据大量时间。通过 Skill 编程，工程师可将人工操作转换为自动化脚本，显著提升设计效率。例如，某设计团队使用 Skill 脚本将 DRC 检查时间从 2 小时缩短至 5 分钟，同时避免了人工遗漏错误。

开发环境搭建

1. 软件准备
2. 安装 Cadence Allegro PCB Designer（建议 17.4 或更新版本）

3. 确认安装目录下的 pcbenv 文件夹（默认路径：C:\Cadence\SPB_17.4\share\pcbenv）

4. 环境配置

5. 在 pcbenv 文件夹中创建 allegro.ilinit 文件（若不存在）

6. 添加以下代码设置 Skill 开发环境：

   ; 加载 Skill 调试工具
   (load "debug.il")
   
   ; 设置脚本搜索路径
   (setSkillPath '("./skill_scripts""/shared_libs"))

7. 工具验证

8. 打开 Allegro，在命令窗口输入：

   skill getSkillPath()

9. 应返回包含自定义路径的列表

核心语法解析

Skill 基于 Lisp 方言，但针对 EDA 场景进行了优化：

• 数据类型对比

  ; Lisp 传统写法
  (setq list '(1 2 3))
  
  ; Skill 增强写法
  (list = '(1 2 3))  ; 支持更直观的赋值语法

• PCB 对象操作

  ; 获取当前设计中的所有元件
  (foreach comp (axlDBGetDesign)->components
    (printf "Component: %s\n" comp->name))

• 关键差异点

• 支持面向对象语法（如obj->property）
• 内置 EDA 专用函数（如axlDBCreateRectangle）
• 弱化递归强调循环（因 PCB 数据量庞大）

完整 Demo 实现：自动布线检查

以下脚本检查未连接的网络并生成报告：

;;; @brief 检查未完成布线的网络
;;; @return 未连接网络列表
defun(CheckUnroutedNets (@optional (reportFile "unrouted_report.txt"))
  prog((nets unconnectedNets)
    ; 获取设计中的所有网络
    nets = axlDBGetDesign()->nets

    ; 筛选未完全连接的网
    unconnectedNets = setof(
      net nets
      !axlNetIsRouted(net)
    )

    ; 生成报告
    outfile = outfile(reportFile)
    fprintf(outfile "Unrouted Nets Report - %s\n\n" date())

    foreach(net unconnectedNets
      fprintf(outfile "%-20s\tPin Count: %d\n" 
             net->name length(net->pins))
    )

    close(outfile)
    return unconnectedNets
  )
)

性能优化

1. 数据库访问优化
2. 使用 axlDBGetDesign 缓存设计对象

3. 避免在循环中重复查询

4. 内存管理

   ; 错误示范（每次循环创建新列表）(for i 1 100
     (setq temp (cons i nil)))
   
   ; 正确做法（预分配内存）(setq result (makeTable "results" nil))
   (for i 1 100
     (tblput result i (calculateSomething i)))

5. 批量操作

6. 用 axlSetFindFilter+axlGetSelSet 替代单对象操作

避坑指南

1. 路径问题
2. 错误：直接使用绝对路径C:/project/script.il

3. 解决：使用getWorkingDir()+ 相对路径

4. 单位混淆

5. 错误：未指定单位导致 1mm 被当作 1mil

6. 解决：明确使用axlMKSToUU(1.0 'mm)

7. 对象生命周期

8. 错误：保存 DB 对象引用导致内存泄漏

9. 解决：及时用 axlDBClear 释放

10. 字符串处理

11. 错误：用 strcat 拼接大量字符串

12. 解决：使用 sprintf 或makeStringStream

13. 版本兼容

14. 错误：使用新版 API 导致旧版本报错
15. 解决：添加版本检查：

    (when (version >= 17.4)
      (useNewFeature))

进阶建议

• 官方资源
• Cadence 帮助文档：allegro_skill_ref.pdf

• 安装目录下的skill/examples

• 调试技巧

• 使用 axlShell 交互式测试代码片段

• 通过 trace 函数跟踪变量变化

• 扩展学习

• 阅读 PCB 设计规范（IPC-7351 等）
• 学习算法优化（如 A * 自动布线算法）

思考题

1. 如何修改 Demo 程序使其能检查特定层（如仅 TOP 层）的布线完成情况？
2. 当处理超过 10 万个元件的设计时，哪些优化措施能避免脚本卡死？