 自动生成屏蔽地形状的配置与验证)
1. Allegro 里手动铺屏蔽地为什么总返工做射频板或者高速连接器封装的朋友大概率都遇到过这个场景屏蔽罩下面的地铜皮需要一块一块手动铺铺完还要挨个检查层对不对、网络是不是 GND、跟焊盘过孔走线的间距够不够。一块小板子十几个屏蔽区手动铺完半天就过去了改一版又得重来。DesignForShapes配合CreateAutoShape(ShieldGnd)就是解决这个问题的。简单说它是 Cadence Allegro 里的一组 Skill 程序能根据你指定的参考层铜皮轮廓自动在目标信号层生成静态地铜皮并且按你设定的间距规则避让焊盘、过孔、走线和已有铜皮。适合谁用做封装设计的、做射频模块 layout 的、以及经常要批量处理屏蔽地铜皮的 PCB 工程师。它跟普通Shape Polygon手动铺铜的区别在于三点一是自动提取参考层轮廓不用自己描边二是间距参数一次性配好所有生成结果统一三是直接生成静态铜皮static shape不依赖动态铜皮的重新计算出 Gerber 更可控。我试过在一块 8 层射频板上用这套流程处理 12 个屏蔽区从配置到验证大概 20 分钟比手动铺快了不止一个量级。下面把完整配置和验证步骤拆开讲。核心检索词先明确DesignForShapes 是 Allegro Skill 里负责形状生成与处理的函数集合CreateAutoShape 是其中按参数自动建铜皮的入口ShieldGnd 是屏蔽地这个具体场景的封装调用。你要做的是把层、参考层、间距、合并策略这几个参数喂对然后验证输出。2. 前置准备TaoToken 与 Skill 环境怎么配在讲 Allegro 配置之前先说一个容易被忽略的前置环节。很多工程师现在会用 AI 辅助生成 Skill 脚本或者查 Allegro 命令参数这时候一个稳定的模型调用入口能省不少事。TaoToken 是我实测下来比较顺的一个 API 聚合入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它的作用是让你用统一的接口调不同模型比如你写 Skill 脚本时想让模型帮你补全axlDBCreateShape的参数或者排查CreateAutoShape报错可以直接在对话里问。适合做封装设计时边写边查的场景。配置方式很简单拿到 Key 之后在调用端设置 Base URL 为https://taotoken.net/apiModel ID 按你选的模型填。如果你用的是 Claude Code 这类编码工具可以在 settings 里配{ api_base_url: https://taotoken.net/api, api_key: 你的Key, model: 你选的Model ID }如果你用 Cline 或者带 MCP 的编辑器配置里同样三件套Base URL、Key、Model ID缺一不可。Codex 的auth.json里也是这三个字段对应填。这里要提醒一句TaoToken 是模型调用入口不是 Allegro 的替代工具。Allegro 里的DesignForShapes和CreateAutoShape还是在你本机的 Skill 环境里跑TaoToken 只是帮你在写脚本、查参数、排报错的时候有个顺手的 AI 助手。Skill 环境本身需要确认两件事一是你的 Allegro 版本支持DesignForShapes这套函数16.6 以上基本都有二是 Skill 路径已经加到allegro.ilinit里能用skill load加载。可以在 Allegro 命令行敲skill load(DesignForShapes.il)没报错就说明环境 OK。如果报cant access file检查路径和文件名大小写。3. CreateAutoShape(ShieldGnd) 可复制配置与参数详解这一节是核心。CreateAutoShape(ShieldGnd)的调用需要你准备好几个参数我按 excerpt 里的顺序逐个对应并给出可直接复制的 Skill 调用片段。先看参数对照表参数含义默认值建议layer目标信号层无必填如 TOPref_layer参考层必须有铜皮无必填如 GND02shape_to_pin铜皮到焊盘间距12 mil按工艺能力调shape_to_via铜皮到过孔间距10 mil同上shape_to_cline铜皮到走线间距15 mil同上shape_to_shape铜皮到铜皮间距20 mil同上merge_shape同网络是否合并不勾选铜皮多时慎开pad_connected_with_thermal焊盘花焊盘连接勾选一般保持add_route_keepout_on_R_and_C阻容器件中间加禁布区不勾选建议勾选对应的 Skill 调用可以写成这样axlSetFindFilter(?enabled list(noall shapes) ?onButtons list(noall shapes)) CreateAutoShape( ?layer TOP ?ref_layer GND02 ?shape_to_pin 12.0 ?shape_to_via 10.0 ?shape_to_cline 15.0 ?shape_to_shape 20.0 ?merge_shape nil ?pad_connected_with_thermal t ?add_route_keepout_on_R_and_C t )注意单位。Allegro Skill 里默认单位跟随当前设计如果你的设计是 mil上面数值直接填如果是 mm要换算比如 12 mil ≈ 0.3048 mm。我建议在调用前先确认axlGetParam(paramDesign)-userUnits的值。merge_shape这个参数要重点说。它控制自动创建的铜皮跟现有同网络铜皮是否合并。默认不勾选因为合并运算量大铜皮多的时候会卡。如果你只是补几块小屏蔽地可以开如果是整板批量建议先关生成完再手动决定要不要合并。add_route_keepout_on_R_and_C也很实用。它会给两个管脚的阻容器件在两个焊盘中间自动加一个禁止布线区防止自动生成的铜皮从焊盘中间穿过去造成短路风险。这个在 0402、0201 小封装密集排布时特别有用。配置写好后建议先在一个测试层上跑一遍确认参数生效再上正式层。跑之前记得保存设计因为静态铜皮一旦生成撤销不如动态铜皮方便。4. 验证请求与成功结果报告加目视双检查生成完不能直接出 Gerber必须验证。我一般分两步先看报告再目视检查。报告验证方面CreateAutoShape跑完会在 Allegro 的 log 或者 report 里输出生成结果。你可以在 Skill 里加一段抓取axlMsgPut(ShieldGnd shape created on layer: %s axlGetParam(paramLayer)-layerName)更完整的做法是调用axlShapeReport或者自己遍历生成的 shapeshapes axlDBGetShapes(TOP) foreach(s shapes when(s-net-name GND axlMsgPut(GND shape: %L area%f s-objType s-area) ) )报告里重点看三个数生成数量、网络名、面积。数量对不上说明参考层轮廓提取有问题网络名不是 GND 说明网络绑定错了面积异常大或小说明间距参数或者参考层选错了。目视检查方面在 Allegro 里打开目标层用Display Color/Visibility只显示 TOP 和 GND02对比两块铜皮轮廓是否一致。然后打开 DRC 检查重点看Shape to Pin、Shape to Via、Shape to Cline这几类间距违规有没有冒出来。如果 DRC 干净说明间距参数生效了。还有一个容易漏的点静态铜皮不会自动避让后来新增的走线。所以验证时要在生成铜皮之后、布线之前做或者生成后锁定铜皮。我一般会在生成完立刻跑一次Tools Quick Reports Shape Dynamic Fill确认没有未填充区域。成功的结果应该是目标层出现完整 GND 静态铜皮轮廓跟参考层一致DRC 无间距违规网络属性正确阻容器件中间有禁布区。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来。如果你在配置 TaoToken 或者跑 Skill 时遇到下面这些对照处理。401 UnauthorizedKey 没填对或者过期。检查api_key字段确认没有多余空格确认 Key 还有效。TaoToken 的 Key 在 console 里可以重新生成地址是 https://taotoken.net/console 。local proxy failed本地代理配置问题。如果你在 settings 里填了api_base_url但网络层走不通会报这个。确认 Base URL 是https://taotoken.net/api不要多加路径也不要少斜杠。reading choices 相关报错一般是模型返回格式跟调用端预期不一致。检查 Model ID 是否填对有些调用端对模型名大小写敏感。如果用的是 Claude Code 类工具确认model字段跟 TaoToken 支持的模型列表匹配。OAuth 报错如果你用的是需要 OAuth 的编码工具确认授权流程走完。有些工具第一次调用会弹浏览器授权没完成就会报 OAuth 失败。重新走一遍授权或者改用 API Key 方式。Allegro 侧的报错也要会看CreateAutoShape: ref_layer has no shape参考层没有铜皮。检查ref_layer指定的层是不是真的有 shape可以用axlDBGetShapes(GND02)确认。Shape to Pin violation间距参数太小跟焊盘冲突。把shape_to_pin调大或者检查焊盘是不是有特殊 padstack。merge_shape timeout合并运算超时。把merge_shape设为 nil分步处理。排查顺序建议先确认 TaoToken 侧 Key 和 Base URL 没问题再确认 Allegro Skill 环境加载正常最后看参数。大部分问题出在 Key 和路径上。6. 后续怎么用从单次生成到批量流程单次生成跑通之后你可以把它做成批量流程。思路是遍历所有需要屏蔽地的层对每层调用一次CreateAutoShape参数从配置文件读。配置文件可以用 JSON 存{ layers: [TOP, BOTTOM], ref_layer: GND02, shape_to_pin: 12.0, shape_to_via: 10.0, shape_to_cline: 15.0, shape_to_shape: 20.0, merge_shape: false, pad_connected_with_thermal: true, add_route_keepout_on_R_and_C: true }Skill 里读这个 JSON循环调用。这样改参数不用改脚本改配置文件就行。如果你在写这个批量脚本时需要查axlDBCreateShape的返回值处理或者不确定某个参数的类型可以用 TaoToken 的模型对话快速问一下入口在 https://taotoken.net/models 。长期做封装自动化的话Coding Plan 更适合地址是 https://taotoken.net/coding-plan 。最后说一个实用技巧生成静态铜皮后建议给铜皮加一个自定义属性比如SHIELD_GND TRUE方便后续用 Skill 批量选中或者出报告。加属性的调用是axlDBAddProp(shape SHIELD_GND TRUE)。这样下次改版你可以直接按属性筛选不用重新找。整套流程跑顺之后屏蔽地铜皮这块基本不用再手动铺了。参数配一次后面每版复用验证步骤固定出错概率大幅下降。
DesignForShapes 实战：CreateAutoShape(ShieldGnd) 自动生成屏蔽地形状的配置与验证
1. Allegro 里手动铺屏蔽地为什么总返工做射频板或者高速连接器封装的朋友大概率都遇到过这个场景屏蔽罩下面的地铜皮需要一块一块手动铺铺完还要挨个检查层对不对、网络是不是 GND、跟焊盘过孔走线的间距够不够。一块小板子十几个屏蔽区手动铺完半天就过去了改一版又得重来。DesignForShapes配合CreateAutoShape(ShieldGnd)就是解决这个问题的。简单说它是 Cadence Allegro 里的一组 Skill 程序能根据你指定的参考层铜皮轮廓自动在目标信号层生成静态地铜皮并且按你设定的间距规则避让焊盘、过孔、走线和已有铜皮。适合谁用做封装设计的、做射频模块 layout 的、以及经常要批量处理屏蔽地铜皮的 PCB 工程师。它跟普通Shape Polygon手动铺铜的区别在于三点一是自动提取参考层轮廓不用自己描边二是间距参数一次性配好所有生成结果统一三是直接生成静态铜皮static shape不依赖动态铜皮的重新计算出 Gerber 更可控。我试过在一块 8 层射频板上用这套流程处理 12 个屏蔽区从配置到验证大概 20 分钟比手动铺快了不止一个量级。下面把完整配置和验证步骤拆开讲。核心检索词先明确DesignForShapes 是 Allegro Skill 里负责形状生成与处理的函数集合CreateAutoShape 是其中按参数自动建铜皮的入口ShieldGnd 是屏蔽地这个具体场景的封装调用。你要做的是把层、参考层、间距、合并策略这几个参数喂对然后验证输出。2. 前置准备TaoToken 与 Skill 环境怎么配在讲 Allegro 配置之前先说一个容易被忽略的前置环节。很多工程师现在会用 AI 辅助生成 Skill 脚本或者查 Allegro 命令参数这时候一个稳定的模型调用入口能省不少事。TaoToken 是我实测下来比较顺的一个 API 聚合入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它的作用是让你用统一的接口调不同模型比如你写 Skill 脚本时想让模型帮你补全axlDBCreateShape的参数或者排查CreateAutoShape报错可以直接在对话里问。适合做封装设计时边写边查的场景。配置方式很简单拿到 Key 之后在调用端设置 Base URL 为https://taotoken.net/apiModel ID 按你选的模型填。如果你用的是 Claude Code 这类编码工具可以在 settings 里配{ api_base_url: https://taotoken.net/api, api_key: 你的Key, model: 你选的Model ID }如果你用 Cline 或者带 MCP 的编辑器配置里同样三件套Base URL、Key、Model ID缺一不可。Codex 的auth.json里也是这三个字段对应填。这里要提醒一句TaoToken 是模型调用入口不是 Allegro 的替代工具。Allegro 里的DesignForShapes和CreateAutoShape还是在你本机的 Skill 环境里跑TaoToken 只是帮你在写脚本、查参数、排报错的时候有个顺手的 AI 助手。Skill 环境本身需要确认两件事一是你的 Allegro 版本支持DesignForShapes这套函数16.6 以上基本都有二是 Skill 路径已经加到allegro.ilinit里能用skill load加载。可以在 Allegro 命令行敲skill load(DesignForShapes.il)没报错就说明环境 OK。如果报cant access file检查路径和文件名大小写。3. CreateAutoShape(ShieldGnd) 可复制配置与参数详解这一节是核心。CreateAutoShape(ShieldGnd)的调用需要你准备好几个参数我按 excerpt 里的顺序逐个对应并给出可直接复制的 Skill 调用片段。先看参数对照表参数含义默认值建议layer目标信号层无必填如 TOPref_layer参考层必须有铜皮无必填如 GND02shape_to_pin铜皮到焊盘间距12 mil按工艺能力调shape_to_via铜皮到过孔间距10 mil同上shape_to_cline铜皮到走线间距15 mil同上shape_to_shape铜皮到铜皮间距20 mil同上merge_shape同网络是否合并不勾选铜皮多时慎开pad_connected_with_thermal焊盘花焊盘连接勾选一般保持add_route_keepout_on_R_and_C阻容器件中间加禁布区不勾选建议勾选对应的 Skill 调用可以写成这样axlSetFindFilter(?enabled list(noall shapes) ?onButtons list(noall shapes)) CreateAutoShape( ?layer TOP ?ref_layer GND02 ?shape_to_pin 12.0 ?shape_to_via 10.0 ?shape_to_cline 15.0 ?shape_to_shape 20.0 ?merge_shape nil ?pad_connected_with_thermal t ?add_route_keepout_on_R_and_C t )注意单位。Allegro Skill 里默认单位跟随当前设计如果你的设计是 mil上面数值直接填如果是 mm要换算比如 12 mil ≈ 0.3048 mm。我建议在调用前先确认axlGetParam(paramDesign)-userUnits的值。merge_shape这个参数要重点说。它控制自动创建的铜皮跟现有同网络铜皮是否合并。默认不勾选因为合并运算量大铜皮多的时候会卡。如果你只是补几块小屏蔽地可以开如果是整板批量建议先关生成完再手动决定要不要合并。add_route_keepout_on_R_and_C也很实用。它会给两个管脚的阻容器件在两个焊盘中间自动加一个禁止布线区防止自动生成的铜皮从焊盘中间穿过去造成短路风险。这个在 0402、0201 小封装密集排布时特别有用。配置写好后建议先在一个测试层上跑一遍确认参数生效再上正式层。跑之前记得保存设计因为静态铜皮一旦生成撤销不如动态铜皮方便。4. 验证请求与成功结果报告加目视双检查生成完不能直接出 Gerber必须验证。我一般分两步先看报告再目视检查。报告验证方面CreateAutoShape跑完会在 Allegro 的 log 或者 report 里输出生成结果。你可以在 Skill 里加一段抓取axlMsgPut(ShieldGnd shape created on layer: %s axlGetParam(paramLayer)-layerName)更完整的做法是调用axlShapeReport或者自己遍历生成的 shapeshapes axlDBGetShapes(TOP) foreach(s shapes when(s-net-name GND axlMsgPut(GND shape: %L area%f s-objType s-area) ) )报告里重点看三个数生成数量、网络名、面积。数量对不上说明参考层轮廓提取有问题网络名不是 GND 说明网络绑定错了面积异常大或小说明间距参数或者参考层选错了。目视检查方面在 Allegro 里打开目标层用Display Color/Visibility只显示 TOP 和 GND02对比两块铜皮轮廓是否一致。然后打开 DRC 检查重点看Shape to Pin、Shape to Via、Shape to Cline这几类间距违规有没有冒出来。如果 DRC 干净说明间距参数生效了。还有一个容易漏的点静态铜皮不会自动避让后来新增的走线。所以验证时要在生成铜皮之后、布线之前做或者生成后锁定铜皮。我一般会在生成完立刻跑一次Tools Quick Reports Shape Dynamic Fill确认没有未填充区域。成功的结果应该是目标层出现完整 GND 静态铜皮轮廓跟参考层一致DRC 无间距违规网络属性正确阻容器件中间有禁布区。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来。如果你在配置 TaoToken 或者跑 Skill 时遇到下面这些对照处理。401 UnauthorizedKey 没填对或者过期。检查api_key字段确认没有多余空格确认 Key 还有效。TaoToken 的 Key 在 console 里可以重新生成地址是 https://taotoken.net/console 。local proxy failed本地代理配置问题。如果你在 settings 里填了api_base_url但网络层走不通会报这个。确认 Base URL 是https://taotoken.net/api不要多加路径也不要少斜杠。reading choices 相关报错一般是模型返回格式跟调用端预期不一致。检查 Model ID 是否填对有些调用端对模型名大小写敏感。如果用的是 Claude Code 类工具确认model字段跟 TaoToken 支持的模型列表匹配。OAuth 报错如果你用的是需要 OAuth 的编码工具确认授权流程走完。有些工具第一次调用会弹浏览器授权没完成就会报 OAuth 失败。重新走一遍授权或者改用 API Key 方式。Allegro 侧的报错也要会看CreateAutoShape: ref_layer has no shape参考层没有铜皮。检查ref_layer指定的层是不是真的有 shape可以用axlDBGetShapes(GND02)确认。Shape to Pin violation间距参数太小跟焊盘冲突。把shape_to_pin调大或者检查焊盘是不是有特殊 padstack。merge_shape timeout合并运算超时。把merge_shape设为 nil分步处理。排查顺序建议先确认 TaoToken 侧 Key 和 Base URL 没问题再确认 Allegro Skill 环境加载正常最后看参数。大部分问题出在 Key 和路径上。6. 后续怎么用从单次生成到批量流程单次生成跑通之后你可以把它做成批量流程。思路是遍历所有需要屏蔽地的层对每层调用一次CreateAutoShape参数从配置文件读。配置文件可以用 JSON 存{ layers: [TOP, BOTTOM], ref_layer: GND02, shape_to_pin: 12.0, shape_to_via: 10.0, shape_to_cline: 15.0, shape_to_shape: 20.0, merge_shape: false, pad_connected_with_thermal: true, add_route_keepout_on_R_and_C: true }Skill 里读这个 JSON循环调用。这样改参数不用改脚本改配置文件就行。如果你在写这个批量脚本时需要查axlDBCreateShape的返回值处理或者不确定某个参数的类型可以用 TaoToken 的模型对话快速问一下入口在 https://taotoken.net/models 。长期做封装自动化的话Coding Plan 更适合地址是 https://taotoken.net/coding-plan 。最后说一个实用技巧生成静态铜皮后建议给铜皮加一个自定义属性比如SHIELD_GND TRUE方便后续用 Skill 批量选中或者出报告。加属性的调用是axlDBAddProp(shape SHIELD_GND TRUE)。这样下次改版你可以直接按属性筛选不用重新找。整套流程跑顺之后屏蔽地铜皮这块基本不用再手动铺了。参数配一次后面每版复用验证步骤固定出错概率大幅下降。
