Intel® Quartus® Prime Pro Edition User Guide: Design Compilation

Download PDF
ID 683236
Date 1/27/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Document Table of Contents x
1. Answers to Top FAQs 2. Design Compilation 3. Reducing Compilation Time 4. Intel® Quartus® Prime Pro Edition User Guide Design Compilation Archives A. Intel® Quartus® Prime Pro Edition User Guides
2. Design Compilation x
2.1. Compilation Overview 2.2. Using the Compilation Dashboard 2.3. Design Synthesis 2.4. Design Place and Route 2.5. Incremental Optimization Flow 2.6. Fast Forward Compilation Flow 2.7. Full Compilation Flow 2.8. Exporting Compilation Results 2.9. Integrating Other EDA Tools 2.10. Synthesis Language Support 2.11. Compiler Optimization Techniques 2.12. Synthesis Settings Reference 2.13. Fitter Settings Reference 2.14. Design Compilation Revision History
2.1. Compilation Overview x
2.1.1. Compilation Flows 2.1.2. Compilation Hierarchy
2.3. Design Synthesis x
2.3.1. Running Synthesis 2.3.2. Viewing Synthesis Reports
2.3.1. Running Synthesis x
2.3.1.1. Preserving Registers During Synthesis 2.3.1.2. Preserving Signals for Monitoring and Debugging
2.4. Design Place and Route x
2.4.1. Running the Fitter 2.4.2. Viewing Fitter Reports
2.4.1. Running the Fitter x
2.4.1.1. Fitter Commands 2.4.1.2. Disabling or Enabling Physical Synthesis Optimization
2.4.2. Viewing Fitter Reports x
2.4.2.1. Plan Stage Reports 2.4.2.2. Place Stage Reports 2.4.2.3. Route Stage Reports 2.4.2.4. Retime Stage Reports 2.4.2.5. Finalize Stage Reports
2.4.2.2. Place Stage Reports x
2.4.2.2.1. Global Signal Visualization Report
2.4.2.3. Route Stage Reports x
2.4.2.3.1. Global Router Wire Utilization Map Report
2.5. Incremental Optimization Flow x
2.5.1. Concurrent Analysis During Synthesis or Fitting 2.5.2. Analyzing Compiler Snapshots 2.5.3. Validating Periphery (I/O) after the Plan Stage
2.5.2. Analyzing Compiler Snapshots x
2.5.2.1. Running Snapshot Viewer
2.5.2.1. Running Snapshot Viewer x
2.5.2.1.1. Analyzing Failing Paths with Snapshot Viewer 2.5.2.1.2. Analyzing Clocking with Snapshot Viewer 2.5.2.1.3. Analyzing High Fan-out Nets with Snapshot Viewer 2.5.2.1.4. Validating Timing Constraints with Snapshot Viewer 2.5.2.1.5. Analyzing Congestion with Snapshot Viewer
2.6. Fast Forward Compilation Flow x
2.6.1. Step 1: Run Register Retiming 2.6.2. Step 2: Review Retiming Results 2.6.3. Step 3: Run Fast Forward Compile 2.6.4. Step 4: Review Fast Forward Results 2.6.5. Step 5: Implement Fast Forward Recommendations 2.6.6. Retiming Restrictions and Workarounds
2.6.2. Step 2: Review Retiming Results x
2.6.2.1. Locate Critical Chains
2.6.3. Step 3: Run Fast Forward Compile x
2.6.3.1. Fast Forward Compile By Hierarchy 2.6.3.2. HyperFlex Settings
2.6.4. Step 4: Review Fast Forward Results x
2.6.4.1. Clock Fmax Summary Report 2.6.4.2. Fast Forward Details Report
2.8. Exporting Compilation Results x
2.8.1. Exporting a Version-Compatible Compilation Database 2.8.2. Importing a Version-Compatible Compilation Database 2.8.3. Creating a Design Partition 2.8.4. Exporting a Design Partition 2.8.5. Reusing a Design Partition 2.8.6. Viewing Quartus Database File Information 2.8.7. Clearing Compilation Results
2.8.6. Viewing Quartus Database File Information x
2.8.6.1. QDB File Attribute Types
2.9. Integrating Other EDA Tools x
2.9.1. Generating a VQM Netlist for other EDA Tools
2.10. Synthesis Language Support x
2.10.1. Verilog and SystemVerilog Synthesis Support 2.10.2. VHDL Synthesis Support
2.10.1. Verilog and SystemVerilog Synthesis Support x
2.10.1.1. Verilog HDL Input Settings (Settings Dialog Box) 2.10.1.2. Design Libraries 2.10.1.3. Verilog HDL Configuration 2.10.1.4. Initial Constructs and Memory System Tasks 2.10.1.5. Verilog HDL Macros
2.10.1.3. Verilog HDL Configuration x
2.10.1.3.1. Hierarchical Design Configurations
2.10.2. VHDL Synthesis Support x
2.10.2.1. VHDL Input Settings (Settings Dialog Box) 2.10.2.2. VHDL Standard Libraries and Packages 2.10.2.3. VHDL wait Constructs 2.10.2.4. VHDL-2019 Conditional Analysis Tool Directives
2.11. Compiler Optimization Techniques x
2.11.1. Compiler Optimization Modes 2.11.2. Allow Register Retiming 2.11.3. Automatic Gated Clock Conversion 2.11.4. Enable Intermediate Fitter Snapshots 2.11.5. Fast Preserve Option 2.11.6. Fractal Synthesis Optimization
2.11.6. Fractal Synthesis Optimization x
2.11.6.1. Enabling or Disabling Fractal Synthesis
2.12. Synthesis Settings Reference x
2.12.1. Advanced Synthesis Settings
3. Reducing Compilation Time x
3.1. Factors Affecting Compilation Results 3.2. Strategies to Reduce the Overall Compilation Time 3.3. Reducing Synthesis Time and Synthesis Netlist Optimization Time 3.4. Reducing Placement Time 3.5. Reducing Routing Time 3.6. Reducing Static Timing Analysis Time 3.7. Setting Process Priority 3.8. Reducing Compilation Time Revision History
3.2. Strategies to Reduce the Overall Compilation Time x
3.2.1. Running the ECO Compilation Flow 3.2.2. Enabling Multi-Processor Compilation 3.2.3. Using Block-Based Compilation
3.3. Reducing Synthesis Time and Synthesis Netlist Optimization Time x
3.3.1. Settings to Reduce Synthesis Time and Synthesis Netlist Optimization Time 3.3.2. Use Appropriate Coding Style to Reduce Synthesis Time
3.4. Reducing Placement Time x
3.4.1. Placement Effort Multiplier Settings
3.5. Reducing Routing Time x
3.5.1. Identifying Routing Congestion with the Chip Planner
3.5.1. Identifying Routing Congestion with the Chip Planner x
3.5.1.1. Areas with Routing Congestion 3.5.1.2. Congestion due to HDL Coding style
1. Answers to Top FAQs
2. Design Compilation
3. Reducing Compilation Time
4. Intel® Quartus® Prime Pro Edition User Guide Design Compilation Archives
A. Intel® Quartus® Prime Pro Edition User Guides

2.3.1.2. Preserving Signals for Monitoring and Debugging

The Compiler optimizes the RTL signals during synthesis and place-and-route. Unless preserved, the signal names in your RTL might not exist in the post-fit netlist after signal optimizations. For example, the compilation process can merge duplicate registers, or add tildes (~) to net names that fan-out from a node.

Preserving a signal so that it is available for debugging after synthesis and place-and-route involves the following steps:
  • Marking the signal for preservation.

    You can mark the signal directly in your RTL code or through a QSF assignment command.

  • Enabling signal preservation either for the entire project or for the instance that contains the marked signal.

    You can enable project-wide signal preservation through the Intel® Quartus® Prime GUI or a QSF assignment command. To preserve signals in an instance, use a QSF assignment command.

By separating marking signals for preservation and enabling signal preservation, you can tag signals of interest as you write your code with no effect on optimization until you enable signal preservation.

When signal preservation is enabled, the nodes marked preserve_for_debug inherit the following attributes:
Table 4.  Attributes Inherited by Nodes Marked preserve_for_debug
Attribute Result
preserve Prevents Intel® Quartus® Prime from optimizing away or retiming a register
keep Prevents Intel® Quartus® Prime from minimizing or removing a signal net during combinational logic optimization
noprune Prevents Intel® Quartus® Prime from removing or optimizing a fanout free register
dont_merge Prevents Intel® Quartus® Prime from merging a register with a duplicate register
dont_replicate Prevents Intel® Quartus® Prime from duplicating a register
Important: Instance-level signal preservation settings always override project-wide level settings. Also, signal preservation settings in your RTL always override QSF settings.
After you synthesize your design, you can locate and review your preserved signals:
  • The Preserve for Debug Assignments report shows the preservation status and name of all nodes that are marked for preservation.
  • The preserved for debug filters in Node Finder helps you quickly find preserved nodes.

The overall flow to follow to preserve signals for monitoring and debugging is as follows:

  1. Mark the signals that you want to preserve in one of the following ways:
    • Mark the signals directly in your RTL code with the preserve_for_debug attribute:
      Table 5.  Examples of Marking Signals with the preserve_for_debug Attribute in RTL
      Verilog Example VHDL Example 
      (* preserve_for_debug *) wire [3:0] counter_wire;
(* preserve_for_debug *) reg [3:0] counter_reg;

(* preserve_for_debug *) wire [15:0] decode_out_top;
(* preserve_for_debug *) reg [15:0] decode_out_reg_top;
      		 
      attribute preserve_for_debug : boolean;
attribute preserve_for_debug of counter_wire : signal is true;
attribute preserve_for_debug of counter_reg : signal is true;
attribute preserve_for_debug of decode_out : signal is true;
attribute preserve_for_debug of decode_out_reg : signal is true;
      In the Intel® Quartus® Prime GUI, you can also use the Insert Template (Edit > Insert Template) dialog box to add the preserve_for_debug attribute.
    • Mark the signals with the PRESERVE_FOR_DEBUG assignment in one of the following ways:
      • Specify the PRESERVE_FOR_DEBUG assignment for specific nodes from a command line or in your QSF file:
        set_instance_assignment -name PRESERVE_FOR_DEBUG ON -to <node hpath>
      • Specify the Preserve signal for debug assignment To any node of interest in the Assignment Editor. Select On as the assignment value.
      Important: In some rare cases, logic might be optimized away before the signal can be preserved when you use the PRESERVE_FOR_DEBUG assignment. If you encounter this issue, use the preserve_for_debug attribute in your HDL code instead.
    • Mark a system module, interface, or port for preservation in Platform Designer.

      For details, refer to "Preserving a System Module, Interface, or Port for Debugging" in Intel® Quartus® Prime Pro Edition User Guide: Platform Designer.

  2. Enable preserve for debug either project-wide or for specific instances.
    • To enable preservation and reporting project-wide, do one of the following steps:
      • Enable project-wide signal preservation from the Signal Tap Logic Analyzer settings:

        Select Assignments > Settings > Signal Tap Logic Analyzer > Enable preserve for debug assignments.

      • Specify the global PRESERVE_FOR_DEBUG_ENABLE assignment from a command line or in your QSF file:
        set_global_assignment -name PRESERVE_FOR_DEBUG_ENABLE ON
      • Specify a global Enable preserve for debug assignments assignment in the Assignment Editor. Select On as the assignment value.
      Tip: When project-wide signal preservation and reporting is enabled, use the instance-level setting to exclude instances from project-wide signal preservation and reporting.
    • To enable (or disable) preservation and reporting for only specific instances:
      • Specify the instance PRESERVE_FOR_DEBUG_ENABLE assignment as ON (or OFF) from a command line or in your QSF file:
        set_instance_assignment -name PRESERVE_FOR_DEBUG_ENABLE ON -to <instance hpath>
      • Specify the Enable preserve for debug assignments assignment To any instance of interest in the Assignment Editor. Select On (or Off) as the assignment value.
      • Specify the PRESERVE_FOR_DEBUG_ENABLE attribute with a value of ON (or OFF) on the instance in your RTL.
        Table 6.  Examples of Setting the PRESERVE_FOR_DEBUG_ENABLE Attribute in RTL
        Verilog Example VHDL Example 
        ...
(* altera_attribute = "-name PRESERVE_FOR_DEBUG_ENABLE ON" *)
decoder decoder_inst(
...
        		 
        ...
attribute altera_attribute : string;   
attribute altera_attribute of my_decoder_inst : LABEL is "-name PRESERVE_FOR_DEBUG_ENABLE ON";

...
begin
...

my_decoder_inst :  decoder
  3. Synthesize your design.

    On the Compilation Dashboard, click Analysis & Synthesis. The Compilation Report generates when synthesis is complete. You can also now use preserved for debug filters in Node Finder to help you quickly find preserved nodes.

  4. View the results of signal preservation.
    Open the Preserve for Debug Assignments report located in the Synthesis > Partition <name> > Preserve for Debug report folder.
    Figure 4. Preserve for Debug Assignments Report
  5. Run a full compilation to perform place and route of the design and Signal Tap instance by selecting Processing > Start Compilation.
    The debug signals that you preserve persist through the Fitter into the finalized compilation database.

After running a full compilation, you can debug your design with any of the Intel® Quartus® Prime debug tools.

Remember: After you have debugged your design, you might want to disable signal preservation (both globally and at the instance level) and run a full compilation to optimize signals that were preserved.
Table 7.  Debug Signal Preservation Assignments
Assignment Description Example
preserve_for_debug

(Preserve signal for debug in Assignments Editor)

Marks a signal to be preserved during compilation for post-synthesis or post-fit debugging when preserve-for-debug is enabled. set_instance_assignment -name PRESERVE_FOR_DEBUG ON -to <node hpath>
preserve_for_debug_enable

(Enable preserve for debug assignments in Assignments Editor)

Enables preserve-for-debug at either the project or instance level.

When enabled, the Compiler reports the results of signal preservation in the Preserve for Debug Assignments report after compilation.

The Compiler reports these nodes in the Preserve for Debug Assignments report following compilation. 		set_global_assignment -name PRESERVE_FOR_DEBUG_ENABLE ON

set_instance_assignment -name PRESERVE_FOR_DEBUG_ENABLE ON -to <instance hpath>

Related Information
Level Two Title