Ambiguous Device Sheet Path Resolution

This document is no longer available beyond version 21. Information can now be found here: Ambiguous Device Sheet Path Resolution for version 24

Applies to Altium Designer version: 21
 

Parent category: Violations Associated with Documents

Default report mode:

Summary

This violation occurs when a target device sheet - specified in the File Name field for a Sheet Symbol - has been found in multiple declared device sheet folders.

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:

Ambiguous Device Sheet Resolution for <DeviceSheetName>

where:

  • DeviceSheetName is the current entry for the parent device sheet symbol's File Name field. Unlike the entry in the File Name field, the message includes the extension too (*.SchDoc).

Recommendation for Resolution

Use the Details region of the Messages panel to cross probe to the device sheet symbol in question. Double-click on the symbol to access its properties through the Properties panel. In the Source section, on the General tab of the panel, the full path to the instance of the device sheet currently being used is displayed.

Remember that the device sheet instance used will be the first detected across declared device sheet folders, and that these folders - declared on the Data Management - Device Sheets page of the Preferences dialog - are searched in top-down order. If the currently used device sheet is the correct instance, you can simply ignore this violation. If not, select the folder in which the correct instance exists, and click the Move Up button until that folder is at the top of the list.

Note however, that while this may solve the immediate issue for this particular device sheet, the ambiguity will still remain. To fully resolve this issue, identify the redundant device sheet(s), and remove it (them) from the other declared device sheet folder(s).

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). 
Note

The features available depend on your level of Altium Designer Software Subscription.

Content