We have detected your current browser version is not the latest one. Xilinx.com uses the latest web technologies to bring you the best online experience possible. Please upgrade to a Xilinx.com supported browser:Chrome, Firefox, Internet Explorer 11, Safari. Thank you!

AR# 56137

Vivado Debug - A repository of useful Tcl scripts for use in Vivado Serial I/O Debug


This answer record hosts useful scripting examples for Vivado Serial I/O Debug and Vivado Logic Debug 2013.2 and earlier.

Below you will find an assortment of scripts that do various functions within Vivado Serial I/O Debug and Vivado Logic Debug.

This answer record should be used as a reference. These scripts have been designed by various Xilinx employees and customers.

Useful Tcl Links

The scripts will be in the following format:

  • Target - The target devices will be listed here.
  • Filename - The filename here will correspond to the download link on the bottom of the page.
  • Description - This will include a short description of what the Tcl function does.
  • Notes - Any pertinent notes for the Tcl function will be listed here.


Vivado Serial I/O Debug Tcl Scripts

Target: All Vivado Based GTs

Filename: gt_Attributes.tcl

Description: Dumps a listing of the all GT channel and gt_common attributes to the file named at the top of the script.

It also dumps a list of the Input ports that are tied to either ground or Vcc. If an input port is changeable, driven by logic, then it is not dumped.

Notes: to run the script open the implemented design (or the routed dcp file checkpoint), and then run the script.

This script has been tested in Vivado 2015.2 but also seems to work in all versions.

The output of the Tcl commands can change somewhat between versions of Vivado which can make comparisons between versions a bit more difficult.

The resulting file can also be used to compare attributes from one version of the design to another if a rate change is being done.

This will verify that all of the attributes that need to change on the rate change are being modified.

Vivado Serial I/O Debug Tcl Scripts

Target: All Vivado Based GTs

Filename: IbertCompare.tcl

Description: Compares the settings of a GT design with a similar IBERT design. It generates a list of parameters that are different and a script that will update the IBERT parameters to equal the parameters in the GT design. The gt_Attributes script above must be used to get a dump of parameters from a GT design. This is used as an input to this script specified on line 35. The parameters are then compared to the running parameters in the IBERT. Any different parameters are listed and a command to change the parameter to make it equal to the GT design is generated and put into a file called setGtParams.tcl. This script can be modified or run as required.

Notes: To run the script, set the path and name to the gtParams.txt file for the design to be compared on line 35 of the text and then run the Tcl script in the running IBERT on the Tcl command line.

This script has been tested in Vivado 2015.4 but might work in all versions and will be tested in future versions of Vivado. To be viable the designs do not have to be exactly the same but have to have the same data width. (The script can help change speeds or DFE/LPM equalization but cannot change the bus width of the IBERT core that is being used)

Vivado Logic Debug

Target: 7 Series devices

Filename: repetitive_trigger.tcl

Description: Runs a repetitive trigger feature like that in ISE ChipScope Pro 1.x cores


Vivado Eye Scan

Target: 7 Series devices

Filename: Eye Scan AR (Xilinx Answer 60024)

Description: Installs Eye Scan in a GTX example design similar to XAPP1198 but not limited to PCI Express.



Associated Attachments

AR# 56137
Date 09/26/2016
Status Active
Type General Article
Page Bookmarked