Board Level Annotation in Altium Designer

Board Level Annotation is the process of annotating the compiled components (the physical view of your components) of your design through the Schematic Editor. Board Level Annotation allows you to either name your components based on a number of naming schemes or specify custom names.

While Board Level Annotation can be used in any design, it is especially useful for multi-channel designs and/or designs that incorporate Device Sheets - where the designators cannot be edited on the Device Sheet itself. In this way, the entire design can be re-annotated without actually modifying the original Device Sheet(s). Board Level Annotation also resolves any conflicting annotation problems that may occur due to duplicate designators across a project, and stores its changes in a *.Annotation text file. It includes additional keywords for customizing naming schemes and allows them to be applied to all or only a select range of parts.

Board Level Annotation gives you complete control over the annotation in your project with annotation settings saved in an *.Annotation text file displayed under the Settings\Annotation Documents sub-folder in the Projects panel. Altium Designer manages Annotation files automatically.

You can choose to name all of the components in your project, name selected components, or name only those components that are not designated.

Configuring Board Level Annotation

To annotate the compiled components in your project through the Schematic Editor:

  • Ensure that the components have been annotated at the schematic level so that the schematic source data, including packaged options for multi-part components, is available as input for your Board Level Annotation.
  • Select Tools » Annotation » Board Level Annotate (shortcut Ctrl+L) which brings up the Board Level Annotate dialog.

The Board Level Annotate  dialog displays all of the schematic documents in your project.
The Board Level Annotate dialog displays all of the schematic documents in your project.

This dialog is comprised of two main regions:

  • Filter Options - for filtering and setting the scope of annotation.
  • Proposed Change List - the proposed changes to be applied, based on your configured annotation options. Changes are applied through an Engineering Change Order (ECO).

The following four buttons are located beneath the Proposed Change List:

  • Annotate Options - click to access the Board Level Annotation Options dialog, from where you can further customize annotation using either predefined or custom naming schemes.
Alternatively, if you want to specify a custom name for all or a particular component, uncheck the Apply box under the Naming Scheme column (in the Board Level Annotate dialog) to disable the Naming Scheme for selected components and edit the PCB Component Instance column.

  • Annotate - click on the drop-down to choose: Annotate Undesignated, Annotate All or Annotate Selected. Once chosen, the Proposed Change List will be updated with the designator to be annotated to each applicable component.
  • Reset All - click to reset all of the designators back to the default names for compiled components. After components have been reset, the Prefix column will display a component icon with a question mark () to show that the component is now undesignated.
  • Back Annotate - use to synchronize changes from your PCB design to the compiled documents in the Schematic Editor. After clicking the Back Annotate button, the Choose WAS-IS File for Back-Annotation from PCB dialog appears from where you can choose the file for back annotation. Back Annotation for Board Level Annotation performs the same way as it does for Schematic Level Annotation. Learn more about generating the Was-Is file.
Note that Back Annotation is a legacy tool and it is best practice to use Design » Update to push annotation changes from the PCB back to the schematic.

To complete Board Level Annotation:

  • Click the Accept Changes (Create ECO) button. The Engineering Change Order dialog opens allowing you to validate, report and execute the ECO.
  • Click the Execute Changes button then the Close button to execute Board Level Annotation.
  • Click the Close button on the Board Level Annotate dialog. Your *.Annotation file will be updated and you can view your Board Level Annotation in your documents. To complete Board Level Annotation, synchronize your schematic documents with your PCB documents by selecting Update PCB Document <Filename> from the Design menu.

Board Level Annotation and Device Sheets

Device Sheets are portable and can be re-used between designs. In most cases, the names of the components in Device Sheets are limited to the scope of that sheet and require Board Level Annotation in order to be incorporated into the design in which they are placed.

Board Level Annotation is relevant to Device Sheets due to the fact that different Device Sheets included in one project can contain duplicate designators resulting in compilation errors. Board Level Annotation can resolve any conflicting naming with the changes saved to an *.Annotation file displayed under the Settings\Annotation Documents sub-folder.

Default Names for Compiled Components

Default Names are required to be able to distinguish between the different instances of the physical representations of components. These default names are displayed in your documents and are used if you have not performed a Board Level Annotation to annotate your compiled (physical) components. When you first launch the Board Level Annotate dialog, the default names are populated in the PCB Component Instance column.

Default naming of compiled components is also applicable for multi-channel designs that reference the same sheet in a project multiple times. This is done by either placing multiple sheet symbols that reference the same sheet in the Schematic Document or by including the Repeat keyword in the designator of a sheet symbol to instantiate a sheet multiple times.

While this makes it easy to repeat circuitry, it also presents a challenge in terms of annotation. In a multi-channel design, there can only be one logical instance of each component with its own unique designator no matter how many "copies" of it exist on the PCB. The Multi-Channel tab of the Project Options dialog (Project » Project Options) ensures that each channel is uniquely annotated with a default name based on Room Naming Style and Component Naming Designator Format.

Multi-Channel Tab

Rooms are regions that assist in the placement and annotation of components in multi-channel designs. More specifically, a channel on the schematic is an instance of a repeated sheet and on the PCB each channel is represented by a room. Once components have been assigned to a room, they move when the room is moved allowing separate channels to be easily controlled and identified.

Rooms play an important role in channel designations ensuring unique names.

Logical designators are assigned to the components in the Schematic Editor View. Physical designators are assigned to the components when they are placed in the PCB design or when you have performed a Board Level Annotation. In multi-channel designs, the logical designators for repeated channel components may be the same, but each component must have a unique physical designator in the PCB design. This can be accomplished by appending the Room Name to the component name as shown in the Component Naming field below.

The Multi-Channel tab of the Project Options dialog allows you to specify the Room Naming Style and the Component Naming Designator Format for your designs. By controlling the multi-channel designator format in this dialog, you control the mapping from the single logical component in the Schematic Editor View to the multiple physical instances on the PCB. The tab is essentially divided into two areas - Room Naming and Component Naming.

The Multi-Channel tab allows for flexible default naming formats in multi-channel designs.
The Multi-Channel tab allows for flexible default naming formats in multi-channel designs.

Room Naming

Use the Room Naming Style drop-down to define the naming format you require for the rooms in your design. These rooms are created by default when you update the project schematics to the PCB. There are five styles available — two flat and three hierarchical.

Flat Room Name Formats

Hierarchical Room Name Formats

Flat Numeric With Names

Numeric Name Path

 

Flat Alpha With Names

Alpha Name Path

Mixed Name Path

Hierarchical room names are formed by concatenating all channelized sheet symbol designators (ChannelPrefix + ChannelIndex) in the relevant channel path hierarchy.

As you select a room naming style from the list, the graphical representation is dynamically updated to reflect the naming convention that will appear in the design. The larger cross-hatch regions represent the upper-level channels (or Banks) and the shaded regions within represent the lower level channels. When the design is compiled, a room is created for each sheet in the design including each bank and each lower-level channel.

Use the Level Separator for Paths field to specify the required character/symbol for separating the path information when using the hierarchical naming styles. There are no restrictions on the character used for the level separator, however, a single non-alphanumeric character is easier to read.

Component Naming

There are several designator formats available for naming components. You can choose a format or define your own using valid keywords. Define the Component Naming format by selecting from the Designator Format drop-down list. There are eight predefined formats — five flat and three that can be used in a hierarchical context:

Flat Designator Formats

$Component$ChannelAlpha

$Component_$ChannelPrefix$ChannelAlpha

$Component_$ChannelIndex

$Component_$ChannelPrefix$ChannelIndex

$ComponentPrefix_$ChannelIndex_$ComponentIndex

Hierarchical Designator Formats  

$Component_$RoomName

$RoomName_$Component

$ComponentPrefix_$RoomName_$ComponentIndex

The Flat Designator Formats name each component designator in a linear progression, starting from the first channel, avoiding the duplication of designators. The Hierarchical Designator Formats include the Room Name in the designator for a component. If the Room Naming Style chosen is one of the two possible flat styles, then the style for the component designator will also be flat. However, if a hierarchical style has been chosen for the Room Naming Style, the component designator will also be hierarchical since the path information will be included in the format.

Defining your own Designator Format

You can define your own component designator format by typing directly into the Designator Format field using valid keywords. Select from any combination of the following keywords to construct the format string.

Keyword

Definition

$RoomName

Name of the associated room as determined by the style chosen in the Room Naming Style field

$Component

Component Logical Designator (e.g., U1)

$ComponentPrefix

Component Logical Designator Prefix (e.g., U for U1)

$ComponentIndex

Component Logical Designator Index (e.g., 1 for U1)

$ChannelPrefix

Logical Sheet Symbol Designator

$ChannelIndex

Index specified to distinguish between different channels

$ChannelAlpha

Channel Index expressed as an alpha character. This format is useful only if your design contains less than 26 channels in total or if you are using a hierarchical designator format

The Room Naming Style is only relevant for component naming if the $RoomName string is included in the Designator Format.

Displaying Physical Names in Your Documents

Your design is constructed in the Editor tab. Compiled Documents (physical representations of your design) are visible and can be accessed by clicking on the Compiled Document tab located along the bottom of the Schematic Document in the design window.

Examples of design space tabs
Examples of design space tabs

You can specify display preferences for the physical names in compiled documents on the Schematic - Compiler page of the Preferences dialog. In the Compiled Names Expansion region, select to expand the compiled (physical) names of Designators, Net Labels, Ports, Sheet Number and/or Document Number.

You also can use the associated drop-down to select how the objects are displayed. Choices include: Never display superscript (expanded names are never displayed), Always display superscript (expanded names are always displayed), or Display superscript if necessary (expanded names are only displayed if they are different from the source).

The superscript options are applicable to both the Editor tab and your Compiled Document tabs. In the Editor tab, the compiled names are in superscript and in the Compiled Document tabs, the logical name (the name in the Editor tab) is displayed in superscript.

Use the Design » Update PCB Document command to initiate a transfer process that will automatically create a component class for each schematic sheet in the design, a room for each component class, and group the components in each class in their room ready for placement.

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Примечание

Набор доступных функций зависит от вашего уровня доступа к продуктам Altium. Ознакомьтесь с функциями, включенными в различные уровни Подписки на ПО Altium, и функциональными возможностями приложений, предоставляемых платформой Altium 365.

Если вы не видите в своем ПО функцию, описанную здесь, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Content