GTS Dynamic Reconfiguration Controller IP User Guide: Agilex™ 3 FPGAs and SoCs

ID 861486
Date 10/31/2025
Public
Document Table of Contents

6.1. Dynamic Reconfiguration QSF Settings

This section describes the QSF settings available for dynamic reconfiguration.
  1. The following example demonstrates how to set global assignments for IP files in a .qsf. These settings are used to specify the IP variants that should be included in the design.
    • set_global_assignment -name IP_FILE ip_variant_1.ip
    • set_global_assignment -name IP_FILE ip_variant_2.ip 
  2. To combine these variants into a DR Group, use the following QSF setting, This command adds an instance of the variant IP to the group, where the instance name and DR group name are user-specified:
    set_instance_assignment -name DR_IP_INSTANCE <ip variant name> -to 
    	    <instance name> -section_id <DR Group name>
  3. Additionally, to assign a profile ID to this IP variant instance, use the following command. This profile ID is used to trigger reconfiguration in the DR controller registers. Note that the numbers must start at 1.
    set_instance_assignment -name DR_GROUP_RECONFIG_ID 1 -to ip_variant_1_inst -section_id dr_top
    You can also assign a profile ID to this IP variant instance. This number is used to trigger reconfiguration in the DR controller registers. Numbers must start at 1.
    set_instance_assignment -name DR_GROUP_RECONFIG_ID <N> -to <instance name> -section_id <DR Group name
    Note: When instantiating a Multi-Rate IP (MRIP) (for example, DPHY or Ethernet) with multiple profiles enabled, those additional profiles are automatically assigned reconfig IDs by the DR tool, starting from the DR_GROUP_RECONFIG_ID specified by the user. For example:
    • Instantiate two multi-rate DPHY instances with 4 profiles each:
      • Assign the first instance DR_GROUP_RECONFIG_ID 1
        • The internal profiles are given the reconfig IDs 1,2,3,4
      • Assign the next DPHY instance RECONFIG_ID 5
        • The internal profiles for the second instance are given the reconfig IDs 5,6,7,8
    • During run-time, you must enable or disable each profile individually based on the computed reconfig ID number above.
  4. Set the relative physical position of the XCVR serial pins for this IP variant instance within the group.
    set_instance_assignment -name DR_IP_INSTANCE_RELATIVE_LOCATION <N> -to 
              <instance name> -section_id <DR Group name>