Multiple Top-Level Documents

Now reading version 17.1. For the latest, read: Multiple Top-Level Documents 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 in hierarchical designs, where two or more schematic sheets are at the top-level of the structure.

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:

Multiple top level documents: <SheetName> has been used

where:

  • SheetName is the name of the schematic document currently being used as the top-level sheet.

Recommendation for Resolution

This issue typically arises due to the sheet symbol on the true top sheet not targeting the intended sub-sheet correctly. To resolve this issue, first determine which schematic sheet is the intended sub-sheet. Check to see if a sheet symbol has been placed for the intended sub-sheet on the top-level schematic:

  • If a sheet symbol does not exist, create it - either by manual placement or by using the Create Sheet Symbol From Sheet or HDL command (available from the main Design menu).
  • If the sheet symbol exists, check the symbol's Filename field and ensure that it references the sub-sheet.

Upon recompiling, the hierarchy will be resolved and the error will disappear from the Messages panel.

 

Note

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

Content