使用参数管理器

概览

本文介绍 Altium Designer 原理图中参数的工作原理、存储的信息、适用对象,以及如何查看、添加、编辑、定位和锁定元件、部件、引脚、端口、图纸符号、文档和项目中的参数。文章还重点说明了系统参数与用户参数的区别,展示了如何在“属性”面板和库元件中处理参数,并介绍了图形化编辑、位号处理和参数字符串定位等实际操作。如果您想更清楚地了解参数数据如何帮助组织原理图和定义元件,从而更熟练地使用参数,请继续阅读。

- 了解 Altium Designer 中参数的适用层级,包括对象级、文档级和项目级,以及系统参数与用户参数的区别。
- 了解如何通过“属性”面板、设计空间和库操作流程来添加、编辑、移动、锁定和管理参数字符串。
- 理解元件参数的特定行为,包括位号、自动定位,以及链接等特殊参数类型。
使用 AI 深入了解:
 

参数是通用文本字符串,作为父对象的子对象存在。它们用于标识父对象并为其添加额外信息。在原理图图纸中选中对象后,可以直接在 Properties 面板中访问其参数。

例如,原理图元件广泛使用参数。通用元件参数可用于多种用途,包括 元件详细信息,如功率、电压等; 供应商详细信息,包括供应商名称和料号;库元件设计详细信息,如符号的修订号;以及文档详细信息,如链接到元件数据手册的 URL。

也可以在原理图图纸(文档)和工程级别定义参数。文档级参数用于定义文档标题和编号等字段,而工程级参数则非常适合用于定义设计人员 或工程名称等字段。

参数用于为对象、文档和工程添加详细的设计信息。上图展示了一个元件。参数用于为对象、文档和工程添加详细的设计信息。上图展示了一个元件。

参数作为父对象的属性添加 或自动包含在父对象中,不能像文本字符串那样独立放置。可用参数的类型大致可分为系统参数和用户参数,后者由用户手动添加。

标识符和系统参数

放置在原理图中的对象会自动包含一系列关键系统参数。这些参数提供基本的对象信息,供系统用于区分父对象的名称、类型和数据源。对象固有的系统参数包括但不限于 Comment、Description 和 Design Item ID(库引用)属性。选中父对象()后,可以在 属性面板的 General 区域(位于 General 选项卡下)访问对象的系统参数。当单个参数在设计空间中可见并被选中时,可通过 属性面板的相应模式访问该参数,具体请参见下文说明()。

有些系统参数无法在原理图图纸上显示(也无法 选中),因此无法在 Properties 面板中访问。对于元件对象,这些参数包括 Description、Design Item ID、Footprint、模型引用、 等。其他无法在原理图中直接访问的系统参数还包括文档(图纸)参数和工程参数。

用户参数

可以为以下任意设计对象添加参数。

Component 选中元件(部件)对象后,或在原理图库编辑器中定义元件时,可在 属性面板的 Parameters 区域添加用户自定义参数。如上所述,元件对象始终包含位号和注释等系统参数。双击对象,或右键单击对象并从上下文菜单中选择 Properties,即可打开 Properties 面板。如果 Properties 面板已处于活动状态,则在设计空间中选择一个对象即可。
Part 选中 部件对象后,在 Properties 面板的 Parameters 区域中添加。
Pin 在 *.SchLib 文件中选中 引脚对象后,在 Properties 面板的 Parameters 选项卡上添加。
Port 选中 端口对象后,在 Properties 面板的 Parameters 选项卡上添加。
Sheet Symbol 选中 图纸符号对象后,在 Properties 面板的 Parameters 选项卡上添加。
Document 在 Document Options 模式下(取消选中所有原理图对象, 或单击文档图纸上的空白区域),在 属性面板的 Parameters 选项卡上添加。新建原理图图纸会自动包含若干默认参数,具体由所应用的图纸模板或默认图纸模板决定。
Project 在 工程选项对话框 (Project » 工程选项)中添加。工程级参数在该对话框的 Parameters 选项卡上列出并添加。

选中父对象后,可在 Properties 面板或模态对话框的 Parameters 区域中访问用户参数, 并可添加和编辑参数。例外情况是工程参数(通过 工程选项对话框访问)和元件引脚参数(通过 引脚属性或 Pin 对话框的模态视图访问)。当单个参数在设计空间中可见并被选中时,可通过 属性面板或模态对话框的相应模式访问该参数,具体请参见下文说明。

第一张图:Properties 面板(Parameters 区域)中的元件用户参数。第二张图:Properties 面板中的单个系统参数。 第一张图:Properties 面板(Parameters 区域)中的元件用户参数。第二张图:Properties 面板中的单个系统参数。

在放置父对象期间为其添加的参数(见上文),将成为后续放置该父对象时的默认参数,除非在 Preferences 对话框的 Schematic – Default Primitives 页面上为该对象启用了 Permanent 选项。
启用此选项后,为正在放置的对象添加的参数也会添加到同一次放置操作中后续放置的对象,但不会应用于该对象之后的其他放置操作。

图形化编辑

可直接在设计空间中以图形方式编辑可见的参数字符串。

单击并拖动参数可调整其位置。要就地编辑参数字符串:

  1. 按住鼠标按钮,在参数对象周围拖动鼠标光标。

  2. 选中后,对象将以绿色边框高亮显示。

  3. 选择 Enter 即可开始编辑文本。

  4. 编辑完成后,再次按 Enter 或单击字符串以外的位置,即可退出就地编辑模式。

可以直接在设计空间中选择并编辑参数字符串。选中整个字符串后输入,即可将其替换。可以直接在设计空间中选择并编辑参数字符串。选中整个字符串后输入,即可将其替换。

对于在设计空间中可见且可选的参数,可以将其拖动到新位置,并在拖动过程中旋转。单击并拖动参数字符串,使用 Spacebar 和 Shift+Spacebar 键以 90° 为增量旋转,然后单击以确认新的位置和方向。

有关元件参数 Autopositioning 及相关 Properties 面板选项的信息,请参见下文的参数字符串定位。

锁定的参数

作为 元件部件子对象的参数可以被锁定,这意味着其 Name 和 Value 字符串不可编辑。可通过以下方式锁定:

  • 在父对象的 Properties 面板或模态对话框中,切换 Parameters 区域内对应参数条目旁的锁定图标();或

  • 在设计空间中直接选中该参数后,勾选 属性面板中的 Lock Parameter 选项。

锁定后,参数字符串将无法在 Properties 面板、模态对话框(父对象的 Parameters 下)中编辑,也无法在设计空间中通过 原位编辑进行修改。

元件参数

元件参数是最常见、最常用的原理图参数,还包括多组专用参数和功能,可扩展元件对象的定义能力。  

在原理图库中定义参数

在将元件放置到原理图之前,可以先在元件库源文件中定义父元件对象的子参数。在原理图库编辑器中,可使用 Properties 面板编辑元件条目的参数或向其添加参数,操作方式与在原理图 编辑器中处理参数相同。

打开原理图元件库文档后,在 SCH Library 面板中选择一个元件条目,即可在 Properties 面板中访问其参数属性。

在 SCH Library 面板中选择库元件的条目,即可访问其属性。在 SCH Library 面板中选择库元件的条目,即可访问其属性。

默认情况下,库元件的位号和注释在原理图库编辑器的设计空间中不可见,但可以通过勾选 Properties 面板的 Library Options 模式(Tools » Document Options)中的 Show Comment/Designator 选项来显示。当设计空间中未选中任何对象时,可访问此模式。

库元件所属参数的定义和编辑流程与已放置的原理图元件相同。在设计空间中放置对象时,可以使用 Tab 键即时创建或编辑参数。可通过 Properties 面板或模态对话框访问参数,其中核心系统参数位于面板的 General 选项卡下,用户参数则在面板的 Parameters 下拉列表中添加或编辑。

例如,要为元件引脚添加参数,请在设计空间中选择 引脚对象,然后选择 Properties 面板或模态对话框中的 Parameters 下拉列表。单击 Add 按钮,在列表中插入新的参数名称/值对。与整个元件关联的参数可按上述方法添加。

位号参数

在原理图库编辑器中,元件的 Designator 参数通常设置为合适的前缀,后跟一个问号。将元件从库中放置到原理图后,原理图编辑器的 标注工具会检测到该问号,并在项目标注过程中将其替换为合适的数字后缀。

原理图编辑器还提供简单的位号自动递增功能,可在放置同一元件的多个实例时使用。使用此功能时,在第一个元件悬浮于光标上时按 Tab 暂停放置,然后在 Properties 面板中输入合适的位号,例如 R1。后续元件的位号将依次为 R2、R3 等。 

放置多部件元件时,如果以这种方式指定初始位号,系统会自动添加部件后缀,例如 U3A、U3B 等。 如果未指定初始位号,所有部件将具有相同的后缀。可通过原理图编辑器的标注功能解决此问题。部件后缀可以是字母或数字,具体由 Preferences 对话框的 原理图 - 常规 页面中的 Alpha Numeric Suffix 选项指定。

参数字符串定位

默认情况下,在放置元件期间或放置后旋转元件时,元件参数字符串会自动定位(即保持方向)。如果不需要此行为,请关闭 Properties 面板中 Parameters 区域下相应元件参数条目的 Autoposition 选项。要访问此选项,请在列表中选择参数,然后单击 Other。请注意,放置元件时可使用 Spacebar 和 Shift+Spacebar 键进行旋转。对于已放置的元件对象,可通过 Properties 面板中 Location 区域的 Rotation 菜单进行旋转,也可以选择元件后按 Spacebar 或 Shift+Spacebar。

单击并拖动可见参数,即可在原理图上手动调整其位置;此时可使用标准方向快捷键 。如果该参数的 Autoposition 选项已禁用,and Preferences 对话框中 原理图 - 图形编辑 页面的 Mark Manual Parameters 选项已启用,则手动移动过的参数会在其选择框左下角显示一个圆点作为标识。

专用元件参数

专用元件参数可用于链接到相关 URL 目标或文件形式的文档。对于选中的元件,可单击 Properties 面板中 Parameters 区域的 Add ,然后从下拉列表中选择 Link 来添加这些参数;也可在 Parameters 选项卡下添加使用 F1 键激活的专用帮助链接。

链接参数

链接功能可用于定义和显示指向任意数量参考 URL 或文档的命名链接。

要为元件添加参考链接,请在设计空间中选择元件,然后单击 Properties 面板中 Parameters 区域下的 Links 。从 Parameters 区域底部的 Add 下拉菜单中选择 Link 。在表格中输入链接的 Name 和 Value (目标 URL 或文件路径)。之后,在设计空间中右键单击元件,并从 References 子菜单中选择链接 <name>,即可访问该链接。

 

面板和设计空间中显示的元件链接,在内部以 ComponentLinknDescription/ComponentLinknURL 格式的名称/值对为基础(其中,n 是链接在列表中的编号,按创建顺序确定)。有关更多详细信息,请查看该元件在 参数表编辑器中的条目。

HelpURL 参数

与链接参数类似,HelpURL 参数可用于定义从元件指向外部文档(如 PDF)或网页 URL 的链接。将其添加为元件参数后,在原理图图纸上将光标悬停于元件上并按 F1 键,或在 Libraries 面板中选中元件后按该键,即可激活链接。请注意,此操作会覆盖 F1 键的常规功能,即链接到 Altium 在线文档中的相关页面。

在设计空间中选中元件后,可在 Properties 面板中将帮助链接添加为用户参数。单击 Properties 面板中 Parameters 区域下的 Parameters ,然后从 Parameters 区域底部的 Add 下拉菜单中选择 Parameter 。将参数 Name 设置为“HelpURL”,并将参数 Value设置为目标路径/URL。

指定参数值时,可以使用 URL、文档的绝对路径,也可以仅使用文档名称。当光标悬停在已放置的元件对象上时按 F1,或使用右键菜单中的 References » Help 选项时,软件将按以下方式搜索帮助参考:

  • 如果指定了路径,则首先在该位置搜索。
  • 如果在该位置找不到文档,或未指定路径,则在软件安装目录的 \Help 文件夹中搜索。
  • 如果目标为 URL,则根据 Preferences 对话框中 系统 - 视图 页面的 Open internet links in external Web browser 选项状态,在软件的内部浏览器或外部浏览器中打开网页。

间接引用 - 将参数用作字符串值

大多数元件参数都可以通过启用 Properties 面板中的可见性图标 ()(如果可用)来显示在原理图图纸上。标识符和系统参数位于面板的 General 选项卡下,用户参数则可在面板的 Parameters 区域中访问。

但是,其他参数(例如文档参数和项目参数)无法直接显示在原理图图纸上,而是可以通过一种称为 String Indirection 的技术插入到标准文本对象中。间接引用是指将字符串对象的值设置为可用参数(例如文档参数或项目参数)的名称,并在名称前加上等号,例如 =Title。

软件会自动检测此类字符串,并检查是否存在与已放置文本对象的值匹配的可用参数名称。在 Title 示例中,软件找到了对应的文档参数,因此会解析该文本字符串并显示标题参数值,例如 MyDocument。您可以通过就地编辑(即输入 =Title)将参数名称指定为所选文本字符串的值,也可以采用更直观的方式,使用 属性面板 中的 Text 下拉菜单,从可用的参数字符串中进行选择。

特殊字符串

可用作间接引用字符串(见上文)的参数字符串称为 special strings。这些字符串呈现的值会根据模板、系统数据和源数据动态确定。例如,特殊字符串 =Time 会检测并显示当前系统时间,而 =DocumentName 则会显示当前原理图文档的文件名(例如 MySchematic.SchDoc)。

软件提供了大量预定义的特殊字符串。请参阅使用原理图中的文本对象 页面,了解有关这些特殊字符串的更多信息。任何用户定义的文档参数或项目参数也可以用作特殊字符串,并通过“间接引用”显示为原理图图纸上的文本字符串。

在生成输出(例如打印原理图图纸)时,始终会解析并显示间接引用字符串。其中许多字符串也会直接在屏幕上解析并显示。

特殊字符串用于定义标题栏中的字段,字符串间接引用功能可确保从文档参数中提取当前原理图的正确信息,并相应地显示。

参数具有层级关系,这意味着您可以在项目的不同层级创建同名参数,并为它们设置不同的值。对于元件参数,Altium Designer 按以下顺序进行解析:

  1. 元件参数(最高优先级)

  2. 变体

  3. 原理图文档

  4. 图纸符号(要查看上一级图纸符号的参数值,请选择设计空间底部的 Compiled 选项卡)

  5. 项目

此面板中的大多数选项/控件都很直观,无需进一步说明。下面介绍其中一个需要说明的选项。

  • Allow Synchronization with Database (仅限 Preferences 对话框)- 启用后可与数据库同步。此选项用于控制是否可以更新注释。默认情况下,这些选项处于启用状态,以始终允许与源库/数据库同步。您可以禁用此选项,防止在更新过程中更新该注释。

使用参数管理器

您可以使用参数将用户定义的设计属性添加到设计中。参数既可以单独添加和编辑,也可以使用 Parameter Table Editor 对话框 (Tools » Parameter Manager) 在整个设计或整个库中添加和编辑。这些参数“隶属于”当前项目源原理图文档中的各类对象,或当前库中的元件。通过这种方式,您可以快速高效地将所有参数集中在一处进行编辑,并可创建工程变更单,将所做的任何参数更改直接应用到每个受影响的“所属”设计对象。

打开此对话框时,它会收集整个设计中的所有参数数据,并以表格形式呈现。从原理图中启动此对话框时,会先打开 Parameter Editor Options 对话框。请选择要加载到 Parameter Table Editor 对话框中的参数类型。例如,如果您要处理元件参数,请禁用 Include Parameters Owned By 区域中除 Parts 之外的所有选项。您还可以使用对话框中部的下拉字段,进一步限定要包含的对象范围。可以选择包含所有对象、仅包含具有现有参数的对象,或仅包含具有实际使用的现有参数的对象。

再例如,如果您要处理文档参数,请仅启用 Documents 选项。请注意,Exclude System Parameters 选项包含元件模型设置、模板中定义的文档参数等内容。建议您在更熟悉参数管理后再探索此选项。

如果您只想编辑设计中特定对象的参数,请根据需要选择对象,并启用 Selected Objects Only 选项。只要在对话框的 Include Parameters Owned By 区域中启用了相应的对象类型,就只会包含您所选的对象。

选择所需选项后,单击 OK 打开 Parameter Table Editor 对话框。

对话框中的大多数选项/字段都很直观。下面说明其中需要解释的选项/字段。

  • Remove Columns - 单击以移除列。此选项仅适用于包含静态信息的列。

  • Add Column - 单击以添加列。随后将打开 Add Parameter 对话框,您可以在其中定义参数名称。

  • Reset Column Order - 单击以按字母顺序显示各列。

  • Accept Changes (Create ECO) - 要将这些更改应用到元件,必须生成 ECO(工程变更单)。单击以打开 Engineering Change Order 对话框。 

右键菜单

  • Revert - 单击以撤销对所选单元格的编辑。

  • Add - 单击以向所选单元格添加信息。使用随后出现的下拉列表选择所需信息。

  • Rename Column - 单击打开重命名现有参数对话框,您可以在其中重命名现有参数。

  • Remove Columns - 单击删除所选列。

  • Report - 单击打开 Report Preview 对话框以生成报告。

  • Cross Probe - 单击对所选对象进行交叉探查。所选对象将在原理图中高亮显示。

无法使用右键菜单编辑或删除 Object Type、Document 和 Identifier 。

注意事项

  • 您可以在网格区域中拖放列,以更改列的显示顺序。 新顺序会保存在工程文件中,因此再次打开此对话框时会保留该顺序。

  • 可以通过以下方式防止参数被更新:

    • 在单个元件参数层面,在 Properties 面板的 Component 模式下启用 Lock Parameter 选项(双击元件即可访问)。Allow Synchronization With Database 选项 还用于控制是否允许更新注释。默认情况下,此选项 处于启用状态 ,以始终允许与源库/数据库同步。您可以禁用此选项,防止注释被纳入更新过程。
    • 在数据库链接层面,相关数据库链接文档(*.DbLink、*.DbLib 或 *.SvnDbLib 文件)的 Field Mapping 区域包含多个选项,用于控制是否可以更新参数 ,包括 Update Values、Add to Design 和 Remove from Design。

     

使用此对话框可在整个工程中添加、编辑和删除参数。此对话框可用于直接编辑工程中的现有参数,也可用于配置来自关联数据库(通过 DbLink、DbLib 或 SvnDbLib 文件关联)的参数更新。请注意,这些数据库库链接类型的文件包含用于控制是否更新参数的选项。 随后,这些更改将通过您在此对话框中创建的工程更改单来实施。

添加参数

要添加新参数,请单击该按钮(或右键单击主网格中的任意位置,然后从上下文菜单中选择 Add Column 命令)。随后将打开 Add Parameter 对话框。如果只想创建新参数,而不为任何对象赋值,请输入所需的参数名称,然后单击 OK。如果想将该参数连同指定值添加到所有对象,请启用 Add to all objects 选项,输入所需的值,然后单击 OK。新参数列将添加到现有列的末尾(列表的最右侧)。

重命名参数

要重命名参数,请右键单击要重命名的列中的某个单元格,然后从下拉菜单中选择 Rename Column 。 随后将打开 Rename Existing Parameter 对话框。在 Enter the new name for the parameter 字段中输入新名称,然后单击 OK。请注意,列标题已更改,且名称旁边会出现一个蓝色小三角形。此图标表示该单元格的值已更改。

Rename Existing Parameter 对话框
Rename Existing Parameter 对话框

向选定元件添加参数

要向元件添加参数,请在 Parameter Table Editor 对话框编辑器中使用 Shift+Click 或 Ctrl+Click 组合键选择单元格,右键单击,然后从下拉菜单中选择 Add 。选择 Add 后, 每个单元格中都会显示一个绿色小加号。这表示已添加新参数。

添加参数后,您可以为每个元件定义元件类型。Parameter Table Editor 对话框支持标准的表格编辑快捷键。您可以按 F2 编辑单元格,然后按 Enter 应用编辑。要编辑多个单元格,请先选择这些单元格,然后 右键单击并从 菜单中选择 Edit 。输入 新值,然后按 Enter 将编辑应用到所有选定的单元格。

应用参数更改

刚刚完成的参数编辑目前保存在 Parameter Table Editor 对话框中,尚未应用到原理图上的元件。要将这些更改应用到元件,您需要生成 ECO,然后将 ECO 应用到设计。在 Parameter Table Editor 对话框中,单击 Accept Changes (Create ECO) 按钮。 Parameter Editor Table 对话框将关闭,随后将打开 Engineering Change Order 对话框。

单击 Validate Changes 按钮,验证是否可以应用这些更改。如果更改有效,Check 列中将显示绿色勾号。

单击 Execute Changes,将参数更改应用到元件。更改应用完成后,关闭 Engineering Change Order 对话框。

AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。
Contents
功能可用性

您可使用的功能取决于您所采用的 Altium 解决方案——Altium Develop、Altium Agile Teams、Altium Agile Enterprise,或 Altium Designer(在有效订阅期内)。

如果您在实际软件中未看到文档中介绍的某项功能, 请联系 Altium Sales 了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档,请前往其他安装程序页面的旧版文档部分。

Contents