使用变量管理器

Applies to Altium Designer versions: 23 and 24

父页面: 设计变体

变体管理器是一个基于文档的用户界面,允许您查看、创建和管理PCB设计项目的设计变体。要访问变体管理器,在项目面板中右击项目条目并选择变体,或者在原理图或PCB编辑器的主菜单中选择项目 » 变体

要访问变体管理器,必须启用UI.ModernVariantsManager选项,在高级设置对话框中可以启用。通过点击系统 - 通用页面首选项对话框中的高级按钮来访问高级设置对话框。如果在高级设置对话框中进行了任何更改,必须重新启动软件才能使更改生效。

UI.ModernVariantsManager选项被禁用时,将使用变体管理对话框来创建和配置设计变体。请参阅使用变体管理对话框页面了解更多信息。

使用变体

创建新变体

要添加新变体,请在变体管理器变体标签页处于活动状态时,使用位于左上角的添加变体按钮。一个带有默认标题的额外变体列将出现在网格区域,如下图所示。新列的所有单元格都将为空,空单元格表示该组件已安装并且与基础设计未发生变化。

默认情况下,添加的新变体中所有组件都已安装。
默认情况下,添加的新变体中所有组件都已安装。

  • 在进行更改后要保存变体管理器,请从主菜单中选择文件 » 保存变体(快捷键Ctrl+S)。
  • 当变体数量超过100时,变体管理器将自动分页,每百个变体列显示在单独的页面上。在这种情况下,当前页面号码和总页数将显示在变体管理器的底部。使用箭头按钮在页面之间导航。

配置变体属性

要更改变体选项,请使用其变体模式下的属性面板,可以通过右击所需变体的列标题并选择属性来访问。

访问变体模式下的属性面板以更改变体的选项。
访问变体模式下的属性面板以更改变体的选项。

  • 使用名称字段为变体定义一个有意义的名称。

    也可以通过点击变体列标题以选中它,然后点击 在变体管理器的左上角或通过右键点击变体列标题然后选择重命名变体来更改变体的名称。
  • 如果需要从设计中生成制造变体,请启用允许变更制造输出选项。如果输出作业为制造输出指定了一个变体,并且该变体没有启用该选项,作业的变体名称将以红色显示。请注意,红色的变体名称仅是一个警告标志,变体特定的输出文件仍将生成。

    如果需要为包含'未安装'组件的设计生成焊膏掩模输出,请启用允许变更焊膏掩模选项。这些组件的焊盘将不再包含焊膏掩模。

    有关如何向输出作业文件添加和查看变体的信息,请访问使用输出作业准备制造数据页面。
  • 使用面板中的变体参数区域定义变体级参数的列表。

    可以通过放置一个特殊字符串在原理图或PCB文档中显示一个变体参数。了解更多关于原理图上的特殊字符串PCB上的特殊字符串

    Altium Designer支持项目的不同级别的参数:项目、原理图文档和变体。项目中不同级别包含的参数存在层次结构,这意味着你实际上可以在项目的不同级别创建同名的参数,每个参数都有不同的值。Altium Designer使用以下方式解决这种情况的优先级:

    1. 变体(最高优先级)
    2. 原理图文档
    3. 项目

    这种安排意味着在原理图文档中定义的参数值将覆盖在项目选项中定义的值,而在变体中定义的参数值将覆盖在原理图文档中定义的值。

变体的属性

右键点击一个单元格,然后选择属性以打开显示所选组件/组的详细信息的属性面板。变体的组件参数可以根据需要进行编辑。

通过在网格中选择一个组件,然后展开网格底部出现的参数区域,也可以查看和编辑参数。

变体的单元格内容可以使用右键上下文菜单中的相应命令或使用适当的快捷键(Ctrl+CCtrl+VCtrl+X)进行复制、粘贴或剪切。

定义组件变体

基础设计中的每个组件可以配置为:

  • 已安装 - 创建新变体时的默认设置。
  • 未安装 - 在该设计变体中未安装/使用基础设计中使用的原始组件。
  • 安装了修改过参数的组件,例如组件的值。
  • 替代部件 - 完全用另一个组件替换一个组件。

通过点击变体列中的组件单元格并访问提供三个选项的单元格下拉菜单,可以更改设计变体中组件的状态:

  • (已安装) - 基础设计中使用的原始组件也在该设计变体中安装/使用。请注意,也可以为已安装的组件变化单独的参数 - 见下文
  • 未安装 - 在该设计变体中未安装/使用基础设计中使用的原始组件。
  • 替代部件 - 此选项允许选择不同的(替代的)部件。使用替换对话框(这是组件面板的模态对话框版本)来选择所需的替代部件。一旦选择了该部件,单元格将显示替代部件的ID。

    选择替代部件后,软件会检查所选替代组件与原始基础设计组件之间的引脚兼容性。为了具有引脚兼容性,替代部件必须与原始组件具有相同数量的引脚,并且这些引脚在位置和电气类型上必须相同。两个组件的符号中使用的图形原语不需要匹配。如果软件检测到替代组件不具有引脚兼容性,则必须关闭确认对话框才能接受替换。在这种情况下,您需要注意对布线的潜在影响。
上述列出的组件状态也可以通过在网格中右键点击,选择设置所选为然后从关联菜单中选择所需状态,如下所示。

使用所需变体列单元格中的下拉菜单定义组件变体。选择替代部件选项时,使用替换对话框选择一个替代部件。

可以通过在属性面板中输入新的参数值来变更已安装或替代组件的单独参数。点击所需变体列中的组件单元格,并在其变体组件模式下的属性面板的组件参数区域中使用选定变体的列输入变更的参数值。对于印制板参数,如果组件分配了多个印制板模型,则点击单元格下拉菜单选择一个印制板。与基础设计不同的参数值将以黄色显示,网格区域的组件单元格将显示组件名称。

定义已安装组件的替代参数示例。如图所示输入新的参数值。将光标悬停在图像上以查看定义新参数值后的组件单元格。
定义已安装组件的替代参数示例。如图所示输入新的参数值。将光标悬停在图像上以查看定义新参数值后的组件单元格。

如果您只想查看已更改的组件,请在变体管理器的右上角启用仅显示更改选项(或在变体管理器的主区域内右键单击,然后选择仅显示变体组件)。在下面的图片中,对变体进行了四次更改,然后启用了仅显示更改选项,这将更改显示以仅显示五个变体组件。对于具有大量变体的大型设计,此选项非常有用。

启用仅显示更改选项以有效过滤组件列表并仅显示变体组件。
启用仅显示更改选项以有效过滤组件列表并仅显示变体组件。

更新替代部件参数

如果用作替代部件的库组件的参数在库中已更改,则可以将这些更改直接带入项目中的变体定义。选择从库更新值命令,该命令位于变体管理器底部的参数区域的右键菜单中,或在所需替代组件在主网格区域中选中时的属性面板的组件参数区域中,以带入对库组件所做的任何参数更改。

通过变体管理器中的从库更新值命令访问。这里显示的是当选中所需组件条目时,从参数区域的右键菜单访问。将光标悬停在图像上,可以看到当选中替代部件条目时,从属性面板访问。
通过变体管理器中的从库更新值命令访问。这里显示的是当选中所需组件条目时,从参数区域的右键菜单访问。将光标悬停在图像上,可以看到当选中替代部件条目时,从属性面板访问。

通过替换对话框浏览并定位源库中的组件,然后点击确定打开从库更新项目变体对话框。所有参数都列在从库更新项目变体对话框的左侧 - 如果需要,可以取消选择任何参数以将其从更新过程中排除。在对话框的右侧,可以更改目标项目变体(要更新的项目变体)。默认情况下,将选择激活从库更新值命令时选择的变体。点击确定完成更新过程。

请注意,这只更新参数,而不是组件本身。

克隆变体

您可以使用克隆命令克隆变体。在变体名称列的标题中右键单击,然后选择克隆选项。将添加一个具有相同数据和名称(附加有"副本")的新列。您可以使用重命名选项为新列命名一个合适的标题。

删除变体

要删除变体,请选择标题,然后使用图标。在下面显示的右键上下文菜单中也包括删除此变体或所有变体的功能。删除发生之前会打开一个对话框进行确认。

与组一起工作

为了方便管理大量的设计变体,变体管理器还允许您根据选定的原理图页、被选定的图纸符号引用的页或选定的组件类别,创建组件群组,并提供基于功能的组件变体视图。对于每个群组,您可以定义一个或多个“选项”,这些选项本质上反映了群组中一个或多个组件的某种变化。然后可以基于这些定义的群组和选项创建变体,支持创建变体的层次结构。当需要进行更改时,编辑群组选项中的值会立即反映在使用该群组选项的所有变体中。

使用群组的工作流程如下:

  1. 使用变体管理器顶部的控件切换到标签。
  2. 使用添加组按钮的下拉菜单,选择应该为其创建组的原理图文档、表符号或组件类。

    添加一个组以便于基于此组进行进一步的变体管理。
    添加一个组以便于基于此组进行进一步的变体管理。

  3. 新组将在变体管理器的左侧窗格中列出,而选定组的组件将在右侧列出。

    默认情况下,所选原理图表、表符号或组件类的名称将被分配给新创建的组。使用组列表区域底部的重命名按钮根据需要重命名组。

    使用添加选项按钮为当前选定的组添加一个选项。一个带有默认标题的额外选项列将出现在网格区域。新列的所有单元格将为空,空单元格表示该组件已安装且与基础设计未更改。

    为选定的组添加一个选项,如图所示。将光标悬停在图像上以查看默认选项列。
    为选定的组添加一个选项,如图所示。将光标悬停在图像上以查看默认选项列。

  4. 通过更改默认名称为新创建的选项分配一个有意义的名称。点击选项的列标题以选择它,然后点击网格区域底部的重命名按钮或右键点击标题并选择重命名来访问对话框输入新名称。

    为一个选项设置一个有意义的名称。
    为一个选项设置一个有意义的名称。

  5. 使用所需选项列中的组件单元格配置组件变体。该过程与为变体定义组件变体时的过程相同。

    为所选选项配置组件变体。
    为所选选项配置组件变体。

    可以使用右键上下文菜单中的相应命令或使用适当的快捷键(分别为Ctrl+CCtrl+VCtrl+X)来复制、粘贴或剪切变体组选项的单元格内容。
  6. 通过在网格区域中右键点击并选择添加选项,为选定的组添加更多选项。根据需要配置新选项。

    根据需要添加和配置更多选项。
    根据需要添加和配置更多选项。

  7. 变体管理器变体标签中,为其创建了组的组件将在网格区域的适当条目下显示。使用单元格的下拉菜单为组条目选择在标签上创建的选项。将应用为该组中的组件配置的变体。

    为选定的组添加一个选项,如图所示。将光标悬停在图像上以查看默认选项列。
    为选定的组添加一个选项,如图所示。将光标悬停在图像上以查看默认选项列。

克隆组选项

要克隆变体组的一个选项,在标签页上,右键点击<新选项>列标题然后选择克隆。将会添加一个具有相同数据和名称(附加有"副本")的新列。您可以使用重命名选项为新列命名一个合适的标题。

注释

  • 当您配置变体时,设置将保存在项目文件中。这包括未安装状态,对已安装组件的本地参数变化,以及替代部件的参数值。替代部件存储在文件<项目名称>.PrjPcbVariants中。
  • 变体列可以被固定显示在最前面,位于未固定列的左侧。要固定一个变体列,将光标悬停在其标题上并点击
  • 双击一个组件或右键点击,然后选择交叉探测选项跳转到原理图上的那个组件。
  • 使用全选命令,从变体标签页或参数区域的网格区域的右键菜单中快速选择所有网格内容。
  • 使用反选命令,从变体标签页或参数区域的网格区域的右键菜单中快速选择未选中的并取消选择已选中的条目。
  • 点击变体管理器左下角的查看报告按钮,使用打开的变体报告对话框生成详细的变体报告HTML格式。
  • 变体标签页或参数区域的网格区域中右键点击,并使用上下文菜单中的以下命令生成报告文件:
    • 报告 - 点击打开报告预览对话框,创建网格的打印输出。
    • 保存全部 - 点击打开对话框,将所有组件/选定组件的所有参数保存为制表符格式的文本文件(*.txt)。
    • 保存选定 - 点击打开对话框,将选定的组件/选定的参数保存为制表符格式的文本文件(*.txt)。
  • 当原理图发生变化时,变体管理器顶部会显示相应的通知。点击通知旁边的刷新控件以更新变体管理器中的数据。
  • 右键点击单元格时找到的删除选项可以用来删除一个变体、一个组或一个选项。

可用的功能取决于您的 Altium Designer 软件订阅级别

Content