F-Tile Dynamic Reconfiguration Suite Intel® FPGA IP User Guide

ID 711009
Date 4/22/2022
Public

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

Document Table of Contents

4.2. Dynamic Reconfiguration QSF Settings

This section describes the QSF settings available for dynamic reconfiguration.
When creating the QSF assignments, you must define the <ip_instance_hpath> hierarchy paths for all IPs in use. The .qip file determines the directory of each IP generated by the tool in <ip_name>/ip_name.qip path.
Table 11.  Dynamic Reconfiguration QSF Settings
QSF Settings Description
set_instance_assignment -name IP_TILE_ASSIGNMENT -to <ip_instance_hpath> <tileid> Assign a Tile IP compliant IP in design to a Tile IP compliant tile.
set_instance_assignment -name IP_BB_LOCATION -to <bb_instance_hpath> <bb-location>

Assign a BB instance in the design to a location in the tile to which the containing IP is assigned.

Note that this assignment does not identify a specific tile.

set_instance_assignment -name IP_RECONFIG_GROUP -to <ip_instance_hpath> <reconfig-group-id-string> Assign a Tile IP compliant IP in design to a named reconfiguration group. All IP in a group are located in the same tile.
set_instance_assignment -name IP_RECONFIG_GROUP -to <ip_instance_hpath> <reconfig-group-id-string> Assign a Tile IP compliant IP in design to a named reconfiguration group. All IP in a group are located in the same tile.
set_instance_assignment -name IP_RECONFIG_GROUP_STARTUP_INSTANCE -to <ip_instance_hpath> ON|OFF Indicate if a Tile IP compliant IP instance is active at startup; also supplies the clocks.
set_instance_assignment -name IP_RECONFIG_GROUP_SHARED_SIP -to <ip_instance_hpath> ON|OFF The SIP of this IP will serve all the profiles of its shared_sip group.
set_instance_assignment -name IP_RECONFIG_ID -to <ip_instance_hpath> <positive-number-greater-than-zero> Specify a positive integer > 0 as an identifier for an IP. All such identifiers should be consecutive. The IDs are global, i.e. across the entire design. If you don't provide an id, the tool assigns an id.
set_global_assignment -name IP_RECONFIG_GROUP_TYPE <reconfig-group-id-string>:<exclusive|inclusive>:shared_sip:clk_master
Assign a reconfiguration group type to a Tile IP compliant IP in the design.
  • Not given implies inclusive, exclusive implies not inclusive and vice-versa.

    Exclusive indicates that the group only exists by itself after dynamic reconfiguration. Inclusive indicates that the group can exist simultaneously with other groups after dynamic reconfiguration.

  • shared_sip implies that SIPs are shared between IP in the group. If not given, we assume 'separate_sip' where each IP provides its own SIP. There will be one and only one IP_RECONFIG_GROUP_SHARED_SIP QSF for IP in that group
  • clk_master implies that the QSF IP_RECONFIG_GROUP_MASTER_CLOCK_CHANNEL is available for one and only one BB instance in the group.

set_global_assignment -name IP_RECONFIG_GROUP_PARENT <parent-reconfig-group-id-string>:<child-reconfig-group-id-string> Create group hierarchy, should be cumulative like VERILOG_FILE.
set_instance_assignment -name IP_COLOCATE -from <hpath1> -to <hpath2> F_TILE

A QSF that associates a hub IP like the DR controller, with a slot IP like a protocol IP it is controlling.

The IP instance represented by hpath1 and hpath2 should be put in the same F-tile.
Note: The hpath1 is the hierarchy path of the Dynamic Reconfiguration Suite IP in your design and hpath2 is the hierarchy path of the Protocol IP in your design.
set_instance_assignment -name IP_RECONFIG_GROUP_MASTER_CLOCK_CHANNEL -to <bb_instance_hpath> <clock-port-name>

Indicates which bb_m_hdpladadapt_rx or bb_m_hdpldadapt_tx instance supplies the master clock.

The allowed clock port names are:
  • pld_pcs_rx_clk_out1_dcm
  • pld_pcs_rx_clk_out1_hioint
  • pld_pcs_rx_clk_out2_dcm
  • pld_pcs_rx_clk_out2_hioint
  • pld_pcs_tx_clk_out1_dcm
  • pld_pcs_tx_clk_out1_hioint
  • pld_pcs_tx_clk_out2_dcm
  • pld_pcs_tx_clk_out2_hioint
All IP in the group containing <ip_instance_hpath> and any sub-groups will get this master clock.

QSF assignment example required for the dynamic reconfiguration designs

The Tile Interface Planner derives both the tile locations and IP hierarchy for the IP_TILE_ASSIGNMENT and IP_BB_LOCATION assignments.

You must create the IP_RECONFIG_ID assignment.

The following .qsf assignments illustrate the required settings for a design using the Ethernet Multirate Intel® FPGA IP:
set_instance_assignment -name IP_COLOCATE F_TILE -from dr_ctrl_inst|dr_f_0 \
   -to ex_100G_mr_dut|eth_f_dr_0 -entity eth_dr_ed 

set_instance_assignment -name IP_RECONFIG_ID 1 \
   -to ex_100G_mr_dut|eth_f_dr_0 \
   -entity eth_dr_ed 
The following .qsf assignments illustrate the required settings for a design using the CPRI Multirate Intel® FPGA IP:
set_instance_assignment -name IP_COLOCATE F_TILE -from dr_ctrl_inst|dr_f_0 \
   -to GEN_CPRIPHY_MR_INST[0].cpriphy_dr_ed_dut_wrapper|cpriphy_mr_dut|cpriphy_mr_f_0 \
   -entity cpriphy_dr_ed_hw 

set_instance_assignment -name IP_RECONFIG_ID 1 \
   -to GEN_CPRIPHY_MR_INST[0].cpriphy_dr_ed_dut_wrapper|cpriphy_mr_dut|cpriphy_mr_f_0 \
   -entity cpriphy_dr_ed_hw 
The following .qsf assignments illustrate the required settings for a design using the PMA/FEC Direct PHY Multirate Intel® FPGA IP:
set_instance_assignment -name IP_COLOCATE F_TILE -from dr_dut|dr_f_0 \
-to dut|directphy_f_dr_0

set_instance_assignment -name IP_RECONFIG_ID 1 -to dut|directphy_f_dr_0
Note: The additional .qsf settings required for dynamic reconfiguration are contained within the CPRI, Ethernet, and PMA/FEC Direct PHY Multirate Intel® FPGA IPs themselves.