If the design qualifies for parallel synthesis, the tool writes all of the partitions to the .runs/synth_1/runme.log file.
For an incremental run, these partitions help the tool to identify which partitions have changed and need to be resynthesized, and tracks which partitions are intact (to preserve them).
Note: Parallel Synthesis in the reference run is a requirement for Incremental Synthesis. If 50% or more of the partitions are changed then the tool will use the default flow instead of the Incremental Flow.
Here is a flow level description of Incremental Synthesis, where the left side shows the input set and generated output files of the incremental flow, and the right side shows the respective commands.
Please refer to (UG901) for more detailed project level and non-project level flows.
Key Points for the Revised Design:
There should be NO top-level changes in the revised design.
Global Synthesis Settings which are used with the initial "synth_design" command should be exactly the same for the revised flow.
If tool level changes are required at lower levels of hierarchy, then use the BLOCK_SYNTH property on that boundary. Refer to (UG901) for more details on the BLOCK_SYNTH flow.
In cases where more than 50% of the design has changed (changed partitions), then the tool will use default synthesis instead of using incremental synthesis.
Project Flow Incremental Synthesis Run Example:
To start with the Incremental Synthesis Flow, when you synthesize the design initially, make sure that the "Write Incremental Synthesis" option is checked to write an incremental checkpoint for the incremental run.
Please use the 'Synthesis Settings' window to set this option:
After launching synthesis, please check the log file to confirm whether parallel synthesis was used or not.
Look for INFO: Synth 8-5580 in the synthesis log file.
Also, you can check the 'RTL Partitions' details printed in the log file as below:
At the end of the log file, you can check the total time taken by the synthesis run.
Once synthesis is complete, you can save the generated checkpoint file to use for the incremental flow or you can use the tool option “Automatically use the checkpoint from the previous run”.
You can now modify the design/RTL.
Here is a simple example where I have added two registers into the data path.
the screen capture below shows an example of referring an incremental checkpoint for the incremental run.
To confirm whether the tool read the incremental checkpoint or not, check for "Command: read_checkpoint -incremental ./top.dcp" in the generated synthesis log file.
The tool will analyze the changed and unchanged design to report a summary which can help users to understand the changes and the amount of resynthesis required for the design.
Here is an example of an "Incremental Synthesis Summary Report":
Details of Change Summary:
Module name: The module where the RTL is changed inside the design partition. Please note that there could be more than one module under a partition.
Replication: Total number of instantiations of the mentioned module (in this case "rtlRam”). The replication number depends on the number of direct instantiations.
For example (see the below screen capture), ‘rtlRam’ is instantiated by ‘usbf_top’ only once (hence Replication = 1) even when usbf_top is called twice.
Instances: Number of cells/primitives under ‘rtlRam’ at the time of pre-elaboration phase. This number can change after the elaboration and the post-synthesis phase.
Full Design Size: Total number of cells in the entire design (including changed and unchanged design)
Resynthesis Design Size: Please note that if there is any change in a module which belongs to a partition then the whole partition will be resynthesized by the tool. In this case, the changed partition size is 30279 which is called twice in the design and hence the Resynthesis Design Size number is ~60555.
Also, the tool will resynthesize those partitions where the optimizations were propagated and the Resynthesis Design Size number can vary accordingly.
7. Re-synthesis Design Size: Number of cells which are resynthesized = 60555/801353 * 100 = 7.55%
As you can see in the below synthesis log snapshot, the runtime is only 1 minute 35 seconds after incremental flow as compared to the previous default synthesis runtime of 3 minutes 28 seconds.
Incremental Synthesis is a very powerful feature when the design changes are small. Please feel free to use this feature and share your feedback with us. Thanks for reading.