UPGRADE YOUR BROWSER

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# 69737

Virtex UltraScale+ FPGA VCU118 Evaluation Kit - Board Debug Checklist

Description

The Virtex UltraScale+ FPGA VCU118 Evaluation Kit Checklist is useful to debug board-related issues and to determine if applying for a Board RMA is the next step.

Before working through the VCU118 Board Debug Checklist, please review (Xilinx Answer 68268) - Virtex UltraScale+ FPGA VCU118 Evaluation Kit - Known Issues and Release Notes Master Answer Record, as the issue you are faced with might be covered there.

Solution


  1. Switch / Jumper Settings
  2. Board Power
  3. Cable detection
  4. JTAG Initialization

The following debug steps assume Steps 1-4 have been checked and are working:

  1. JTAG Configuration
  2. Master BPI Configuration
  3. PCIe
  4. IBERT
  5. DDR4
  6. Interface Tests
  7. Known Issues for VCU118

1) Switch / Jumper Settings

Default Switch and Jumper Settings for the VCU118 are as follows:

Start from a known safe scenario by verifying the default Switch and Jumper settings. You can then set switches / jumpers for your application.

a) DIP Switch Default Settings:

The default switch settings are listed below:


 



b) DIP Switch SW16 Mode Settings:

Mode settings switches M[2:0] are wired to SW16 positions 2, 3, 4, respectively.

The FPGA default mode setting M[2:0] = 101 selects JTAG configuration mode.


 


c) Default Jumper Settings:

The default jumper settings are listed below.

The board header jumper locations can be found in the Figure under the table.




 



2) Board Power

Power-ON LEDs: 

Initial power testing is performed on the bench using the AC-to-DC power adapter provided in the VCU118 Evaluation Kit.

The status of the Power-ON LEDs is an indication of board health.

a) Check the status of the following LEDs at Power-ON:


 





b) Ethernet PHY status LEDs

These LEDs are visible on the left edge of the VCU118 when it is installed into a PCIe slot in a PC chassis.

The two PHY status LEDs are integrated into the metal frame of the J10 RJ-45 connector, as shown below:


 

As viewed from the front opening, the left green LED is the link activity indicator, the right green LED is the 1000BASE-T link mode indicator.

A separate discrete LED on top of the board (DS27) indicates link established.


c) Voltage and current monitoring, as well as control of the Maxim Integrated power system is available through either the VCU118 System Controller or via the Maxim Integrated PowerTool software graphical user interface.

The VCU118 System Controller is the simplest and most convenient way to monitor the voltage and current values for the power rails on the board. 

More information on the System Controller can be found in (UG1224) VCU118 Board User Guide (https://www.xilinx.com/support/documentation/boards_and_kits/vcu118/ug1224-vcu118-eval-bd.pdf), and also in (XTP447) the System Controller Tutorial, available on the VCU118 Product page.


The Maxim Integrated InTune power controllers can also be accessed through the PMBus connector J39.

Using this connector requires the Maxim PowerTool USB cable / dongle (Maxim part number MAXPOWERTOOL002#).

If the Power ON LEDs are not lit at power on, you might need to reprogram the Maxim Integrated Power Controllers on your VCU118.

This can be done using the Maxim Integrated PowerTool software package, and the Maxim Integrated Dongle.

Information on the Maxim Integrated Power Solution on the VCU118 can be found in (Xilinx Answer 69811), together with information on how to order a Maxim Integrated USB cable free of charge.


The Maxim Integrated Power Controllers on the VCU118 can be reprogrammed. This is the first debug work that should be undertaken if power issues are discovered on your VCU118.

Step-by-step instructions, together with the script to be used to reprogram the Maxim devices can be found in (Xilinx Answer 69815).


d) If the 12V power LED (DS26 on the VCU118) is not Green upon power up, and there is not an issue with the LED itself, then 12VDC is not being delivered to the VCU118 power input connector.

Follow these steps:


 

3) Cable Detection

The VCU118 uses a USB A-to-micro-B cable plugged into the VCU118 Digilent USB-to-JTAG module, U115.

A 2-mm JTAG header (J3) is also provided in parallel for access by Xilinx download cables such as the Platform Cable USB II.

a) USB A-to-micro-B cable:

  1. Is the cable visible in Device Manager?
    If the three items highlighted in the figure below are visible in Device Manager, this confirms that your USB cable is operational and has been correctly identified.



  2. Are cable drivers loaded correctly? Drivers for this cable should be included in the Vivado Design Tools installation.
    However, if problems are experienced with USB A-to-micro-B cable connection, a Digilent plug-in can be downloaded from the link below.
    For installation, please follow the guidelines in the document provided in the downloaded files:
    http://digilentinc.com/Products/Detail.cfm?NavPath=2,66,768&Prod=DIGILENT-PLUGIN.
    This plug-in requires Adept systems 2.4 or later for Windows and Adept systems 2.3.9 or later for Linux.
    Adept software is available from Digilent:
    http://digilentinc.com/Products/Detail.cfm?NavPath=2,66,828&Prod=ADEPT2.
  3. Check system properties and environment variables.
    For information on environment variables, see (Xilinx Answer 11630).
  4. Is the USB port enabled?
    You can reboot your system to re-initialize the USB buses.
  5. Are Xilinx tools correctly installed? (Vivado Hardware Manager or ILA)
    For supported software version information, see the Kit Product Page:
    https://www.xilinx.com/products/boards-and-kits/vcu118.html
    If an issue is suspected with tools installation, see the Installation and Licensing Guide, UG973 (make sure to use the most recent version of tools and associated documentation which supports the VCU118).
  6. Is the Operating System (OS) being used Windows 7?
    If so, please see (Xilinx Answer 41442) and (Xilinx Answer 44397).


b) Platform Cable USB II

  1. Is the cable visible in Device Manager?


  2. Are cable drivers loaded correctly? Drivers for this cable should be included in the Vivado Design Tools installation.
    However, if problems are experienced with the Platform Cable USB II connection, please follow the reinstall instructions in (Xilinx Answer 44397).
  3. Check system properties and environment variables.
    For information on environment variables, see (Xilinx Answer 11630).
  4. Is the USB port enabled? You can reboot your system to re-initialize the USB buses.
  5. Are Xilinx tools correctly installed? (Hardware Manager or ILA)
    For supported software version information, see the Kit Product Page:
    https://www.xilinx.com/products/boards-and-kits/vcu118.html
    If an issue is suspected with tools installation, see the Installation and Licensing Guide, UG973 (make sure to use the most recent version of tools and associated documentation which supports the VCU118).
  6. Is the Operating System (OS) being used Windows 7?
    If so, please see (Xilinx Answer 41442) and (Xilinx Answer 44397).


If the above steps do not enable you to connect, please review the Support Webpage for your available Support options.

4) JTAG Initialization

The status of the board JTAG chain is checked using Xilinx Tools (Hardware Manager in Vivado).

To check to see that the JTAG chain is initialized correctly, follow this JTAG Initialization Test Case:

  1. Remove any FMC cards from VCU118.
  2. Set the mode switch SW16 for JTAG mode (101).
  3. Power up VCU118 on the bench (not in a PC chassis).
  4. Connect the Digilent USB A-to-micro-B cable to the VCU118 (through the Digilent onboard USB-to-JTAG configuration logic module - U115 - through header J106).
  5. Check that the Digilent device shows up in the Device Manager.
  6. Ensure Xilinx tools (Vivado 2016.4 or later - preferably the latest version of the tools that support the VCU118) are correctly installed.
  7. Launch Vivado Hardware Manager - is the cable identified correctly?

  • If not, see section 3. Cable Detection above.
  • If yes, but Vivado Hardware Manager did not discover and display the JTAG chain, slow down the cable speed (Output > Cable Setup).
  • If yes, but Vivado Hardware Manager did not discover and display the JTAG chain, and slowing down the cable speed does not resolve the issue, see the following (assumes Digilent USB A-to-micro-B cable is plugged into USB-to-JTAG configuration logic module U115 through J106):


If following the above steps does not allow you to initialize the JTAG chain, please disconnect the Digilent USB A-to-micro-B cable from the board and PC.

Connect the Platform Cable USB to header J3, and connect to your PC.

Ensure Xilinx tools (preferably the latest version of tools that support the VCU118) are correctly installed.

Launch Vivado Hardware Manager - is the cable identified correctly?

If following the above steps does not allow you to initialize the JTAG chain, please review the Support Webpage for your available Support options.


5) JTAG Configuration

If the JTAG chain initializes, but JTAG configuration fails, check the following:

a) Verify the mode switch settings for JTAG configuration mode:

  • SW16-2 (M2) 1
  • SW16-3 (M1) 0
  • SW16-4 (M0) 1

b) In Vivado Hardware Manager, select a lower cable frequency and re-attempt configuration.

c) Pulse the PROG push button on the VCU118 (SW4).

Pulsing PROG will clear out any problems caused by power up ramp rate issues to the FPGA.

d) Review (Xilinx Answer 34904) - Xilinx Configuration Solution Center.

The Configuration Solution Center is available to address all questions related to Configuration.

If the above steps fail to enable JTAG configuration, please review the Support Webpage for your available Support options.

6) Master BPI configuration

The Vivado Hardware Manager can be used to indirectly program the Linear BPI Flash memory (U133) on the VCU118.

With SW16 set as follows:

  • SW16-2 (M2) 0
  • SW16-3 (M1) 1
  • SW16-4 (M0) 0

a bitstream programmed into the BPI flash device is used to configure the UltraScale+ FPGA U1.

If you have loaded a .mcs file into the BPI flash on the VCU118, and subsequent Master BPI configuration of the Virtex UltraScale+ device fails, the following points should be checked:

a) If the .mcs file is correctly loaded, you will see the selected FLASH device added to the JTAG chain.

By clicking on the flash device, you will see the MCS file successfully loaded.

If you do not see the FLASH device attached to the VU9P device as shown, see the Vivado Design Suite User Guide: (UG908) Programming and Debugging.

b) Verify the mode switch settings for Master BPI configuration:

  • SW16-2 (M2) 0
  • SW16-3 (M1) 1
  • SW16-4 (M0) 0

c) In the Vivado Hardware Manager, select a lower cable frequency and re-attempt configuration.

d) Pulse the PROG push button on the VCU118 (SW4), to attempt to reload the FPGA with the configuration image.

e) Review (Xilinx Answer 34904) - Xilinx Configuration Solution Center. The Configuration Solution Center is available to address all questions related to Configuration.

If the above steps fail to enable BPI configuration, please review the Support Webpage for your available Support options. 


7) PCIe

If the VCU118 configures correctly, but the PCIe interface does not operate as expected, check the following:

a) Do NOT plug a PC ATX power supply 6-pin connector into J15 on the VCU118 board. The ATX 6-pin connector has a different pinout to J15.

Connecting an ATX 6-pin connector into J15 will damage the VCU118 board and will void the board warranty.

To install and power the board correctly, follow the instructions given in (UG1224) VCU118 Board User Guide.

b) Check J7, PCIe lane width, is set correctly for your application.

c) See one of the following Answer Records, covering Known Issues for PCI Express, including Virtex UltraScale+:


(Xilinx Answer 65751) UltraScale+ PCI Express Integrated Block - Release Notes and Known Issues Answer Record
(Xilinx Answer 68134) UltraScale and UltraScale+ FPGA Gen3 Integrated Block for PCI Express - Integrated Debugging Features and Usage Guide


d) Download and run the VCU118 PCIe Example Design, whichever version is appropriate for your silicon and software version.

It is recommended to always use the latest version of software which supports the VCU118, and associated version of the VCU118 PCIe Example Design.

Follow the associated PDF. All are available from the VCU118 Documentation & Designs tab.


 

e) Read the VCU118 PCIe Example Design document: VCU118 PDF: XTP444.pdf and follow the instructions within.

f) Review (Xilinx Answer 34536) - Xilinx Solution Center for PCI Express.

The Solution Center for PCI Express is available to address all questions related to the Xilinx solutions for PCI Express.

If the above steps fail to resolve the PCIe issue, please review the Support Webpage for your available Support options.


8) IBERT

Note: Running IBERT requires the installation of Vivado ILA.

A device-locked license for this software is provided with the Virtex UltraScale+ VCU118 Evaluation Kit.

If the VCU118 configures correctly, but IBERT does not operate as expected, check the following:

a) If using MGT loopback, ensure that you have the correct equipment, including SMA cables, SMA Quick connects and Connect Optical Loopback Adapter:


 

For more detail, see XTP449 VCU118 Software Install and Board Setup.

b) Download and run the VCU118 GT IBERT Example Design, whichever version is appropriate for your silicon and software version.

It is recommended to always use the latest version of software which supports the VCU118, and associated version of the VCU118 GT IBERT Example Design.

Follow the associated PDF. All are available from the VCU118 Documentation & Designs tab.


 

c) Read the VCU118 GT IBERT Example Design document: VCU118 GT IBERT PDF: XTP440.pdf and follow the instructions within.

d) IBERT Design Assistant: (Xilinx Answer 45562).

If the above steps fail to resolve the IBERT issue, please review the Support Webpage for your available Support options.


9) DDR4

If a problem is suspected with DDR4 / MIG, check the following:

a) Ensure that the DDR4 DIMM component memory is inserted correctly.

b) Download and run the VCU118 MIG Example Design, whichever version is appropriate for your silicon and software version.

It is recommended to always use the latest version of software which supports the VCU118, and associated version of the VCU118 MIG Example Design.

Follow the associated PDF. All are available from the VCU118 Documentation & Designs tab.


 

c) Read the VCU118 MIG Example Design document: VCU118 MIG PDF: XTP442.pdf

d) Review (Xilinx Answer 34243) - Xilinx MIG Solution Center.

The Memory Interface Generator (MIG) Solution Center is available to address all questions related to MIG.

If the above steps fail to resolve the DDR4 issue, please review the Support Webpage for your available Support options.


10) Interface Tests

(Xilinx Answer 69835) - Virtex UltraScale+ FPGA VCU118 Evaluation Kit - Interface Test Designs can be run to ensure that the interfaces on the VCU118 are working correctly.

This Answer Record forms part of (Xilinx Answer 43748) - Xilinx Boards and Kits Debug Assistant.

If the above tests fail to resolve the issue, please review the Support Webpage for your available Support options.


11) Known Issues for VCU118

All Known Issues for the Virtex UltraScale+ FPGA VCU118 Evaluation Kit are listed in (Xilinx Answer 68268) - Virtex UltraScale+ FPGA VCU118 Evaluation Kit - Known Issues and Release Notes Master Answer Record.

If the issue you are faced with is not listed in the Known Issues and Release Notes Master Answer Record, and the steps above fail to resolve the issue, please review the Support Webpage for your available Support options.

Linked Answer Records

Master Answer Records

Answer Number Answer Title Version Found Version Resolved
43748 Xilinx Boards and Kits - Debug Assistant N/A N/A

Child Answer Records

Answer Number Answer Title Version Found Version Resolved
69835 Virtex UltraScale+ FPGA VCU118 Evaluation Kit - Interface Test Designs N/A N/A
AR# 69737
Date 11/10/2017
Status Active
Type General Article
Boards & Kits
  • Virtex UltraScale Plus FPGA VCU118 Evaluation Kit
Page Bookmarked