Ambiguous Device Sheet Path Resolution

Now reading version 17.1. For the latest, read: Ambiguous Device Sheet Path Resolution for version 21
Applies to Altium Designer versions: 15.1, 16.0, 16.1, 17.0 and 17.1
 

Parent category: Violations Associated with Documents

Default report mode:

Summary

This violation occurs when a target device sheet - specified in the Filename field for a Device 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. 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 Filename field. Unlike the entry in the Filename 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 the Device Sheet Symbol dialog. In the Properties region of the dialog, the full path to the instance of the device sheet currently being used is displayed. Below this will be listed any additional device sheets matching the name specified in the Filename field.

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

Note

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

Content