AR# 71757

Alveo Data Center Accelerator Card - Reverting Card to Factory image

Description

How do I return my Alveo Data Center Accelerator Card to the image shipped from the factory?

Solution

There are two possible ways to return the contents of the Quad SPI part on the Alveo Data Center Accelerator Card to the factory image.   

This Answer provides general instructions, along with references to documentation with step-by-step instructions.


Alveo Data Center Accelerator Card reset via Xilinx Runtime Environment:

Option 1: 

Required Tool: Xilinx Runtime 2019.1 release or later installed on system with Alveo Data Center Accelerator Card.

If the Alveo Card is visible via the xbutil flash scan command in XRT, run the following command:

sudo xbutil flash -r

This will revert all cards to the golden image.



Option 2:

Required Tool: Xilinx Runtime (version 2018.3 or earlier) installed on system with Alveo Data Center Accelerator Card.

Additional guidance is available in (UG1301) - Getting Started Guide for Alveo Data Center Accelerator Cards or by using the 'xbutil -h' command at the command line.

If the Alveo Data Center Accelerator Card is visible via the xbutil flash scan command in the Xilinx Runtime Environment:

  1. Download the image attached to this Answer Record
  2. Run the command below:
     
xbutil flash -m <mcs file>

Note: This will need to be run with root privileges.

  1. Perform a cold reboot on the host machine.
  2. The Alveo Data Center Accelerator Card should now appear, as described in (UG1301) - Getting Started Guide for Alveo Data Center Accelerator Cards



Alveo Data Center Accelerator Card reset via Micro USB - JTAG connection and Vivado Hardware Manager

Required Tool: Xilinx Vivado Hardware Manager installed on a system with USB connectivity available to the Alveo Data Center Accelerator Card.

Additional guidance is available in (UG908) - Vivado Programming and Debugging.

If the Alveo Data Center Accelerator Card is no longer visible in the Xilinx Runtime Environment, or Vivado Hardware Manager is the preferred tool set:

  1. Download the image attached to this Xilinx Answer to the host running Vivado Hardware Manager
  2. Connect to the card via Vivado Hardware Manager (Connect to the Hardware Target) using the provided USB cable via Micro USB port on the card.  
  3. Select "Add a Configuration Memory Device" on the Card Hardware Target
  4. Select the mt25qu01g-spi-x1_x2_x4  part
  5. Select "Program the Configuration Memory Device" on the target.   
    1. Select the MCS file provided in this Answer for the "Configuration File"
    2. Select the Address Range of "Configuration File Only"
    3. Select OK
  6. After this operation has completed, disconnect the card in Hardware Manager, and disconnect the USB Cable from the Alveo Data Center Acceleration Card.
  7. Perform a cold reboot on the host machine.
  8. The Alveo Data Center Accelerator Card should now appear as described in (UG1301) - Getting Stared Guide for Alveo Data Center Accelerator Cards.



 

Alveo Data Center Accelerator Card revert from Custom MCS to Golden / Alveo Platform via Micro USB - JTAG connection and Vivado Hardware Manager

Required Tool: Xilinx Vivado Hardware Manager installed on a system with USB connectivity available to the Alveo Data Center Accelerator Card.

Additional guidance is available in (UG908) - Vivado Programming and Debugging.

If the Alveo Data Center Accelerator Card is no longer visible in the Xilinx Runtime Environment, or Vivado Hardware Manager is the preferred tool set:

  1. Install an Alveo platform on your server
  2. Locate and copy locally the corresponding MCS file from /lib/firmware/xilinx/<Platform_name>.mcs
  3. Connect to the card via Vivado Hardware Manager (Connect to the Hardware Target) using the provided USB cable via the Micro USB port on the card.   
  4. Select "Add a Configuration Memory Device" on the Card Hardware Target
  5. Select the mt25qu01g-spi-x1_x2_x4 part
  6. Select "Program the Configuration Memory Device" on the target.   
    1. Select the MCS file provided in this Answer for the "Configuration File"
    2. Set Address Range to "Configuration File Only"
    3. Select OK
  7. After this operation has completed, disconnect the card in the Hardware Manager, and disconnect the USB Cable from the Alveo Data Center Acceleration Card.
  8. Perform a cold reboot on the host machine.
  9. The Alveo Data Center Accelerator Card should now appear as described in (UG1301) - Getting Stared Guide for Alveo Data Center Accelerator Cards.



For other Design Guidelines, General Information, and Known Issues related to the Alveo Data Center Accelerator Cards see (Xilinx Answer 71752).

For other Design Guidelines, General Information, and Known Issues related to the Alveo Data Center Accelerator Cards - Custom Flow see (Xilinx Answer 71754).

Attachments

Associated Attachments

Name File Size File Type
revert_to_golden.mcs 33 KB MCS

Linked Answer Records

Master Answer Records

Associated Answer Records

AR# 71757
Date 03/13/2020
Status Active
Type General Article
Boards & Kits