Unique Identifiers Errors
Parent category: Violations Associated with Documents
Default report mode:
Summary
This violation occurs when two circuit elements (including Ports, Sheets, Components, Component pins, Sheet symbols, parameters, etc) - across source schematic sheets in a design - have the same Unique ID associated to them.
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. A notification is also displayed in the Messages panel in the following format:
Unique Identifiers Errors: found at <
Location1> and <
Location2>
where:
- Location1 is the X,Y coordinates for the first object found with a Unique ID error.
- Location2 is the X,Y coordinates for the second object found with a Unique ID error.
Recommendation for Resolution
Reset the Unique ID's for the offending objects as required. This can be done at the individual object level, by accessing the object's associated properties dialog and clicking the Reset button next to the field for the Unique ID. Alternatively, you can reset Unique IDs on a more global level using the Tools » Convert » Reset Component Unique IDs command. This command encompasses two processes, which are effectively performed in sequence:
- Duplicate UIDs are detected within the design and corrected by resetting (regenerating) the UID value for one of the objects in the duplicate pair.
- The UIDs for Parts and Sheet symbols are reset (regenerated).
Note that the command can be applied to the active document, all source schematics in the active project, or all open schematics (regardless of the project to which they belong).
Tips
- With the exception of component UniqueIDs, duplicate UIDs are automatically detected and corrected when a Schematic document is loaded in Altium Designer, thereby removing the need for user intervention. The detection/correction process works through all UIDs in the design, including Set Parameters and parameter additions to Ports, Nets Labels, Directives, Sheets and so on. This correction is important for Parameter UIDs in particular, where duplicate UIDs can cause obscure Rule misbehavior and annotation errors in projects with Variants.
- Components that have duplicate UIDs are not processed by the automatic correction on document load. Component UIDs are fundamental to design connectivity, and any duplicate UIDs (which are very unlikely to occur) are best resolved by intention when detected by the Compiler.
- When any of the corrective measures have been applied to resolve duplicate UniqueIDs – individual, multiple or automated UID changes – the related Schematic-to-PCB links need be reinstated to maintain design connectivity. Use the PCB editor’s Edit Component Links dialog to perform the required updates (Project » Component Links).