Messages

Old Content - visit altium.com/documentation

Function

Whether compiling a project, running a design rule check for the active PCB document, performing a mixed signal simulation, or using any of the other message-enabled features of the software, the Messages panel provides an intelligent way of listing any warnings and/or errors that may be present, as well as any status information.

Content and Use

Primarily, the Messages panel is used to report the results of project compilation, listing any warnings and/or errors that the Compiler may have found whilst interrogating the design for electrical and drafting integrity. In this case, the entries in the panel, the individual messages will be directly affected by the error reporting levels and/or connection matrix you defined in the Options for Project dialog.

The Messages panel will also provide warning/error/status information for many other features in the software. These include: DRC, Signal Integrity analysis, Mixed-Signal simulation, VHDL simulation and synthesis and when using the Situs Autorouter.

The information contained within a message can be broken down into several distinct areas:

  • Class - this can range from general (e.g. Warning) to more specific (e.g. a particular design rule check category). Each degree of message will also carry a different color:


  • Document - the source document upon which the cause of the warning/error/violation resides
  • Source - the server or engine that performed the task when the warning/error/violation was encountered (e.g. the Compiler)
  • Message - the actual message itself

Each message is also date and time stamped and given a specific number within the list of messages that may appear.

Right-click Menu

The right-click pop-up menu for the panel provides the following commands:

  • Cross Probe - cross probe from the selected message in the panel to the object responsible for the message in the associated document
  • Clear All - clear all messages that are currently displayed in the panel
  • Clear Selected - clear all selected messages from the panel
  • Clear Class - clear all messages from the panel that are of the same class as the currently selected message
  • Save - save the current list of messages in the panel to file. After launching the command, the Save Message List To File dialog appears. Use this dialog to browse to a particular destination in which to save the file and to give the file a new name (if required)
  • Save Selection - save selected messages in the panel to file. After launching the command, the Save Message List To File dialog appears. Use this dialog to browse to a particular destination in which to save the file and to give the file a new name (if required)
  • Copy - copy the selected messages to the Windows clipboard
  • Print - preview and print a report containing all messages currently listed in the panel.

When cross-probing (where applicable) from a message in the panel to the offending object(s) on the affected document, you will either be taken directly to the object on the associated document, or indirectly, depending on the particular source of the message. The following scenarios show how the cross probing behavior can differ, depending on the source of the message:

Scenario 1

Running a DRC on your PCB design document may create violation messages with the Source field entry of Advanced PCB. Launching the cross probe command will cross probe directly to the offending object on the document.

Scenario 2

Compiling the source schematic documents of a PCB project may create violation messages with the Source field entry of Compiler. Launching the cross probe command from such a message will display the Compile Errors panel, which displays detailed information on the offending object(s) associated with the selected message. From the Compile Errors panel you can cross probe directly to the offending object(s) on the relevant document in the design editor window.

Scenario 3

Compiling the source VHDL documents of an FPGA project will create various notice-class messages with the Source field entry of VHDL Simulator. Launching the command from one of these messages will take you directly to the respective declaration in the VHDL code of the associated document.

Notes

  • Not all messages can be cross probed. You can only cross probe from a message if it has a valid (existing) associated document, specified in the Document field of the message.
  • When cross-probing to a PCB document:
    1. Ensure that the relative PCB document is the active document in the design editor window, otherwise cross probing will occur, but you will not jump to the document
    2. The offending object(s) will be automatically zoomed and centered (where possible) in the design editor window. Highlighting options available from the PCB panel have no affect on the display.
  • When cross-probing to a schematic document:
    1. The document will be made active if it is not already, or unhidden and made active if it was previously in hidden mode
    2. The visual display of a cross-probed object on a schematic document in the design editor window is dependant on the highlighting options defined on the System - Navigation page of the Preferences dialog (DXP»Preferences). These options include zooming, selecting and masking, the latter of which causes all other objects on the document to become dimmed, leaving only the offending object fully visible
    3. The filtering applied when cross-probing from the Messages panel is temporary. Clicking inside the design editor window will clear the filter. As such, you are not prevented from selecting or editing design objects that fall outside the scope of the filter
    4. The extent of 'dimming' applied when the masking highlight option is enabled can be manually adjusted using the Dim slider bar - accessed by clicking the Mask Level button, to the immediate left of the Clear button, at the bottom-right of the design editor window.
  • Data may be sorted by any column by clicking on the header for that column. Clicking once will sort in ascending order. Click again to sort by descending order.
  • You can change the order in which columns of data are displayed. To move a column, click on its header and drag it horizontally to the required position. A valid position is indicated by the appearance of two green positional arrows.
  • Clearing messages does not necessarily mean the messages have been resolved. The same unresolved messages will be listed after performing the same command that led to the messages being generated initially. Message clearance is a visual aid when resolving errors in the design, allowing you to manually remove messages as you feel they have been resolved. The instigating command must be launched again to obtain an up-to-date picture of any violations that still exist.
  • Clearing all messages is particularly useful when you don't want any previous messages from any other sources to confuse warnings and errors that have been generated from the last command. In some cases, running a command will automatically clear the Messages panel, prior to populating it with a fresh list of messages, generated as a consequence of running that command.
  • With respect to PCB/Compiler/Comparator-specific messages, if the associated document is closed, the corresponding message entries will be automatically cleared from the panel. For example, if you run a DRC Check on a PCB document, any violation messages listed in the Messages panel for that document will be cleared from the panel if the document is closed.

See Also

You are reporting an issue with the following selected text and/or image within the active document: