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

Versal Adaptive SoC Transceiver Subsystem Product Guide (PG442)

Document ID
PG442
Release Date
2024-11-13
Version
1.0 English

IP customization options in the Wrapper Configuration tab are described in the following subsections:

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
Customization option to choose the number of interfaces which can 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 5 GT QUADs in one wizard wrapper. If the requirement is more than five quads, user can instantiate multiple wizards in the design.
Note: Multiple quad configuration are allow only when the interfaces are shared across the quads.
Enable Register Access
Selection to 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 Versal Adaptive SoC GTY and GTYP Transceivers Architecture Manual (AM002) and Versal Adaptive SoC GTM Transceivers Architecture Manual (AM017), register configuration addressing is APB3 based. So, if you use AXI4-Lite, you need to multiply addressing by four. Based on the register configuration interface selected, the free running clock must drive the apb3clk or s_axi_lite_clk signals.

The following are customization options to configure each interface. These options are provided for each interface:

GT Direction
Select GT direction options given in the drop-down menu.
Number of Lanes
Select the number of lanes. Maximum value for lanes depends on the number of quads.
Note: In the case of 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 provided to help you import the transceiver configuration settings. Import is triggered only when you open the import widget. The import feature populates a list of all valid settings for the project and provides you an option to choose the desired transceiver settings to use from a drop-down list. When you click OK, the corresponding settings are loaded to transceiver. Setting values loaded to the widget are not saved, default values are loaded next time you open the import widget. There are two options to import the transceiver source GT settings as shown in the following figure.
Figure 2. Import Interface Settings Dialog

Peer-IP: This selection populates a list of all AMD parent IPs added from the current Vivado project. As described earlier, transceiver setting are loaded 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 throws an import error message.

File: This selection allows 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 image shows an example illustrating the syntax and format of a Tcl file.

Figure 3. Tcl File Syntax for the Import Feature

The Tcl file shown above has two settings that you can select using the settings drop down menu as follows.

Figure 4. Import Transceiver Settings from the Tcl File

After you click OK, the respective transceiver settings can be seen from the Transceiver Configs Interface sub-GUI.

Note:
  • Variables defined in the Tcl file must be defined as a key-value pair, that is in the form of a dictionary.
  • GT_TYPE and GT_DIRECTION are mandatory keys. LR*_SETTINGS is an optional key. See the sample Tcl file image above.
  • The value of GT_TYPE and GT_DIRECTION must match with the values configured in the wizard subsystem GUI.
  • In the sample Tcl file image shown above, 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, see 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. The following figure displays the tab:
Figure 5. Transceiver Config Interface

Interface Configuration Check
Read-only GUI option provides guidance to the user if the information provided in the Wrapper Configuration tab is correct.