Incorrect Link in Project Variant

Now reading version 1.1. For the latest, read: Incorrect Link in Project Variant for version 4

This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Parent category: Violations Associated with Others

Default report mode:

Summary

This violation occurs when a single-part component has been chosen as an Alternate Part for a multi-part component - in a defined Variant for the active design project - and there is more than one part of the original base design component placed within the design. For example, consider a base design with multi-part component R1 - an isolated resistor network with 8 sub-parts. Also consider that four of those parts have been placed (R1A, R1B, R1C, R1D). Now, consider a defined variant of that base design, where an alternate part has been chosen to be used in place of that original base part. The chosen part should also be a multi-part component that can easily accommodate switching out the four sub-parts currently used in the design. However, if by mistake, a single-part resistor component is chosen as the alternate, it does not have the capacity to facilitate the switching-out of existing sub-parts R1B, R1C, and R1D. The Compiler therefore flags this as an incorrect link.

Notification

If compiler errors and warnings are enabled for display on the schematic (enabled on the Schematic - Compiler page of the Preferences dialog), an offending object will display a colored squiggle beneath it. Hovering over the object will display a pop-up hint that summarizes the violation. A notification is also displayed in the Messages panel in the following format:

Incorrect link between project variant "<VariantName>" and schematic component Component <ComponentPhysicalDesignator> (<ComponentLogicalDesignator>) <BasePartComment>

where:

  • VariantName is the name of the design variant in which the erroneous alternate component has been defined.
  • ComponentPhysicalDesignator is the physical designator for the affected component (the designator as displayed on the compiled tab view of the relevant schematic document on which the component in question resides).
  • ComponentLogicalDesignator is the logical designator for the affected component (the designator as displayed on the Editor tab view of the relevant schematic document on which the component in question resides). If the logical and physical designators are identical, this entry will not be displayed.
  • BasePartComment is the value for the Comment parameter for the affected component as defined in the base design.

Recommendation for Resolution

Use the Details region of the Messages panel to cross probe to the component in question. If only one part of the original multi-part component is being used, then you can simply delete any other placed instances and recompile the project. Since the alternate part is a single-part component, it is sufficient for replacement for the single used part of the original multi-part component.

However, this approach, while effective, is not entirely desirable. It is more like a band-aid rather than resolving the underlying issue. A far better approach is to choose a better alternate part for the component in the relevant design variant. To do this:

  1. Make the relevant variant the current variant from the Variants folder for the parent project in the Projects panel. Switch to the Compiled tab for the document, right-click on a part of the base multi-part component, then choose Part Actions » Variants. This opens the Variant Management dialog with only the offending component in only that chosen variant presented.
  2. Use the Component Variation field to open the Edit Component Variation dialog.
  3. With the Alternate Part option still selected, use the other options in the dialog to browse to and choose a more suitable replacement component to be used in that specific variant of the design.
  4. Click OK to close the dialogs and recompile the design project. The incorrect link violation should have been resolved and no longer appear (unless, of course, there are multiple components with this issue, in which case repeat the previous steps).

Tip

  • Object hints will only appear provided the Enable Connectivity Insight option is enabled on the System - Design Insight page of the Preferences dialog. Use the controls associated with the Object Hints entry in the Connectivity Insight Options region of the page to determine the launch style for such hints (Mouse Hover and/or Alt+Double Click). 
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content