Wrapper Configuration Tab - Wrapper Configuration Tab - 1.0 English - PG442

The following subsections describe the IP customization options in the Wrapper Configuration tab.

Figure 1. Wrapper Configuration Tab

Transceiver Type

Select the type of serial transceiver to configure. Available choices are limited to the transceiver types present within the selected device.

Number of Interfaces

Choose the number of interfaces that share the wizard. A maximum of eight interfaces can share the wizard. Based on this selection, customization options to provide the configuration of each interface is enabled in the GUI.

Number of Quad Instances

The wizard can instantiate a maximum of five GT quads in one wizard wrapper. If the requirement is more than five quads, you can instantiate multiple wizards in the design.

Note: Multiple quad configuration are allowed only when the interfaces are shared across the quads.

Enable Register Access

Enable the transceiver register access ports. Selecting this widget opens a customization option to choose the type of register access mode as described in the following section.

Register Access Mode

Select AXI4-Lite or APB3 Access Mode for registers configuration. APB3 is a 32-bit data bus addressing whereas AXI4-Lite is an 8-bit byte-based bus. In the Versal Adaptive SoC GTY and GTYP Transceivers Architecture Manual (AM002) and Versal Adaptive SoC GTM Transceivers Architecture Manual (AM017), the register configuration addressing is APB3 based. If you use AXI4-Lite, you need to multiply addressing by four. Based on the register configuration interface selected, the free running clock needs to drive the apb3clk or s_axi_lite_clk signals.

Note: Manually changing attributes through Register Access Mode can interfere with the automatic rate change process. Refer to the details in the Versal Adaptive SoC GTY and GTYP Transceivers Architecture Manual (AM002) and Versal Adaptive SoC GTM Transceivers Architecture Manual (AM017) in the Rate Change chapter, especially Rate Change Notes.

Use the following customization options to configure each individual interface:

GT Direction

Select GT direction options from in the list.

Number of Lanes

Select the number of lanes. The maximum value for the lanes depends on the number of quads.

Note: For GTME5 configurations requiring user data widths of 320/512, when the line rate is greater than 56 Gb/s, the number of lanes selected for interface are treated as the number of active PCS channels because both the PCS lanes are used. In a given GTME5 Dual, only 1 active PMA lane is possible for these rates. Refer to the configuration protocol GUI option for active PMA lane selection.

Import Settings Interface

A widget helps you import the transceiver configuration settings. Import triggers only when you open the import widget. The import feature populates a list of all valid settings for the project and provides you options to choose the required transceiver settings to use from a drop-down list. When you click OK, the corresponding settings load to the transceiver. Setting values loaded to the widget do not save; The default values load the next time you open the import widget. The following figure shows the two options available to import the transceiver source GT settings.

Figure 2. Import Interface Settings Dialog

Peer-IP

Populates a list of all AMD parent IPs added from the current Vivado IDE project. As previously described, transceiver settings load to the parent IP when you select an IP and click OK. If the selected transceiver type and setting configuration is not compatible with the parent IP's, the widget displays an import error message.

File

Enables you to point to a local Tcl file that has the transceiver settings. After you provide the file path and click OK, the widget populates the transceiver settings from the local Tcl file. The following figure shows an example with the syntax and format of a Tcl file.

Figure 3. Tcl File Syntax for the Import Feature

The preceding Tcl file shown includes two settings that you can select using the settings drop down menu.

Figure 4. Import Transceiver Settings from the Tcl File

After you click OK, the respective transceiver settings display in the Transceiver Configs Interface sub-GUI.

Note:

• The variables you define in the Tcl file need to be defined as a key-value pair, in the form of a dictionary.
• GT_TYPE and GT_DIRECTION are mandatory keys. LR*_SETTINGS is an optional key. Refer to the preceding sample Tcl file image.
• The value of GT_TYPE and GT_DIRECTION need to match with the values configured in the wizard subsystem GUI.
• In the preceding sample Tcl file image, for the LR_SETTINGS value that is expected in dictionary format, where the key represent the parameter in the sub-GUI and the value represent the parameter value. For the keys that are not defined in the dictionary, default values are loaded to the transceiver configuration settings. For more information on LR_SETTINGS string, refer to Sample Tcl File for Import.

Preset

Standard protocol presets are supported. Selecting a preset loads corresponding transceiver settings in Sub GUI. Multi-line rate presets can be loaded in this Preset window. It populates multiple single line rate presets in the corresponding Sub GUI. For example, multi-line rate presets with the suffix MLR are added in preset lists.

Transceiver Config Interface

The Sub GUI configuration tab provides customization options for fundamental transceiver features and transmitter and receiver settings. Each Sub GUI configuration corresponds to a target transceiver configuration referred to as CONFIG<0/1...> in the Protocols panel. The target configuration could be selected by controlling the ch*_txrate[7:0] or ch*_rxrate[7:0] ports on the wizard. Multiple line rate settings require multiple Sub GUI configurations. For information on which attributes are involved in the rate change process, refer to *_rules_output.vh and *_log.txt under the *.gen directory in the GT subsystem IP directory. The following figure shows the tab:

Figure 5. Transceiver Config Interface

Interface Configuration Check

Read-only GUI option provides guidance if you provide in the correct Wrapper Configuration tab information.