AMD XILINX VCK190 User Manual

AMD XILINX VCK190 User Manual

Board evaluation and management (beam) tool

Advertisement

VCK190/VMK180 Board
Evaluation and Management
(BEAM) Tool
User Guide
UG1573 (v1.0) February 22, 2023
Xilinx is creating an environment where employees, customers, and
partners feel welcome and included. To that end, we're removing non-
inclusive language from our products and related collateral. We've
launched an internal initiative to remove language that could exclude
people or reinforce historical biases, including terms embedded in our
software and IPs. You may still find examples of non-inclusive language
in our older products as we work to make these changes and align
with evolving industry standards. Follow this
link
for more
information.

Advertisement

Table of Contents
loading

Summary of Contents for AMD XILINX VCK190

  • Page 1 VCK190/VMK180 Board Evaluation and Management (BEAM) Tool User Guide UG1573 (v1.0) February 22, 2023 Xilinx is creating an environment where employees, customers, and partners feel welcome and included. To that end, we’re removing non- inclusive language from our products and related collateral. We’ve launched an internal initiative to remove language that could exclude people or reinforce historical biases, including terms embedded in our software and IPs.
  • Page 2: Table Of Contents

    Table of Contents Chapter 1: Introduction ....................3 Chapter 2: Requirements ................... 4 Chapter 3: Installing the System Controller Image ........5 Chapter 4: Board Setup and Configuration ............10 Chapter 5: Using the BEAM Tool ................13 Overview.............................13 Home............................14 Help.............................
  • Page 3: Chapter 1: Introduction

    Chapter 1: Introduction Chapter 1 Introduction The Board Evaluation and Management (BEAM) tool is a web-based graphical user interface (GUI) application that connects to the web server running on the System Controller. It allows you to monitor and modify different parameters such as clocks, voltages, and power on the evaluation board and to run the Board Interface Test (BIT) to ensure that the board functions properly.
  • Page 4: Chapter 2: Requirements

    Chapter 2: Requirements Chapter 2 Requirements These accessories from the Versal ® evaluation kit are required to launch the BEAM tool: • Micro SD card (16 GB), shipped with a System Controller image pre-installed • Ethernet cable • USB-C to USB-A cable •...
  • Page 5: Chapter 3: Installing The System Controller Image

    Chapter 3: Installing the System Controller Image Chapter 3 Installing the System Controller Image ® The Versal evaluation kit comes with a system controller image pre-installed on the micro SD card. If necessary, you can install the image onto a blank micro SD card with the following procedures.
  • Page 6 Chapter 3: Installing the System Controller Image UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 7 Chapter 3: Installing the System Controller Image Preparing the SD Card Use the Win32 disk imager (Windows extractor) utility or the dd command line utility for Linux to write the given raw disk image petalinux-sdimage.wic to the micro SD card. Using the Win32 disk imager utility (as shown in the following figure and keyed steps): Figure 2: Win32 Disk Imager Utility 1.
  • Page 8 Chapter 3: Installing the System Controller Image 2. Choose the correct SD card under device. 3. Click Write and then Yes at the prompt and wait until the operation is complete. Using the command line utility for Linux: 1. Unzip the image file petalinux-sdimage.wic.zip: unzip petalinux-sdimage.wic.zip 2.
  • Page 9 Chapter 3: Installing the System Controller Image Note: Windows OS only allows FAT32 partitions to be viewed, which is the boot partition. ext4 format is not recognized. UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 10: Chapter 4: Board Setup And Configuration

    Chapter 4: Board Setup and Configuration Chapter 4 Board Setup and Configuration Connections Make the necessary connections and ensure that the SW11 switch settings are as shown in the following figure. You only need the pre-programmed micro SD card (SysCont) to launch the BEAM tool.
  • Page 11 Chapter 4: Board Setup and Configuration 3. If the board is in a network with DHCP, proceed to step 6. If the board is connected back-to- back with the host, perform the following steps. You can run the udhcpc linux command to view the IP address assigned by the DHCP server.
  • Page 12 Chapter 4: Board Setup and Configuration 5. If your board's Ethernet port is directly connected to the PC, you will need to manually set the IP address because there is no DHCP to automatically assign an IP address. Enter the following command in the Linux terminal to manually set the IP address: ifconfig eth0 192.168.1.11 Note: The Linux console might instruct you to open a browser to a URL.
  • Page 13: Chapter 5: Using The Beam Tool

    Chapter 5: Using the BEAM Tool Chapter 5 Using the BEAM Tool Overview To launch the BEAM tool, open the web browser and enter the following address: <ip of system controller>:50002 The landing page for the BEAM tool is shown in the following figure. Figure 4: Landing Page The top horizontal navigation bar contains three components: •...
  • Page 14: Home

    Chapter 5: Using the BEAM Tool • Obtain Linux Prompts • Run Demos & Designs • Develop using tools The left side vertical navigation bar contains two components: • About Versal ACAP • Product Table The middle of the page shows a picture of the VCK190 evaluation kit and below that, Visit Product Page.
  • Page 15: Help

    Chapter 5: Using the BEAM Tool Help The Help page contains information about: • Known issues and bugs • Jupyter notebooks Figure 6: Help Page UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 16: About

    Chapter 5: Using the BEAM Tool About The About page provides a brief description of the Board Evaluation and Management (BEAM) Tool. Figure 7: About Page Test the Board The Test the Board page provides a figure showing the VCK190 evaluation kit, its major components and connections (such as the microSD (Versal), microSD (SysCont), Ethernet, FMC, power switch, and boot module).
  • Page 17 Chapter 5: Using the BEAM Tool Figure 8: Test the Board Page The Boot Mode section on the right displays the active boot mode and has an option to set the boot mode to a different mode. The Change drop-down menu displays the various boot modes available.
  • Page 18 Chapter 5: Using the BEAM Tool • GPIO Expander • Sys Ctrl Bank I/O • SFP Data • QSFP Data • EBM Data • FMC • EEPROM Data Clock Clock provides options for Get Clock, Set Clock, Set Boot Clock, and Restore Clock operations. For all of these operations, you can select all clocks simultaneously or individually.
  • Page 19 Chapter 5: Using the BEAM Tool Set Clock Set Clock enables you to set the clock frequencies. Figure 10: Set Clock Page Set Boot Clock Set Boot Clock enables you to set custom boot clock frequencies. The clock frequency specified is set after the System Controller is booted up.
  • Page 20 Chapter 5: Using the BEAM Tool Restore Clock Restore Clock restores clocks to their default values. Figure 12: Restore Clock Page Voltage Voltage displays voltage names (signals) and their corresponding voltages. You can view all voltages simultaneously, or individually. During the operation, the following status is indicated: •...
  • Page 21 Chapter 5: Using the BEAM Tool Figure 13: Voltage Page Power Power displays default calibration rail names, power (W), voltage (V), and current (A). You can view all rail values simultaneously, or individually. During the operation, the following status is indicated: •...
  • Page 22 Chapter 5: Using the BEAM Tool Figure 14: Power/Use Default Calibration Page In addition, four tabs at the top of the page provide the following features: • Use Default Calibration gathers power information based on default INA226 calibration data. The default INA226 data can be obtained by selecting Get INA226 Registers after a power cycle.
  • Page 23 Chapter 5: Using the BEAM Tool Figure 15: DDR DIMM Page GPIO Expander GPIO Expander provides options for Get GPIO Expander, Set GPIO Expander, and Restore IO Expander operations. For all of these operations, you can select all GPIO expanders simultaneously, or individually.
  • Page 24 Chapter 5: Using the BEAM Tool Figure 16: Get GPIO Expander Page Set GPIO Expander Set GPIO Expander enables you to set the states. Figure 17: Set GPIO Expander Page Restore IO Expander Restore IO Expander restores the GPIO and IO expanders to their default states. UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback...
  • Page 25 Chapter 5: Using the BEAM Tool Figure 18: Restore GPIO Expander Page Sys Ctrl Bank IO Sys Ctrl Bank IO displays the respective GPIO names and their states. You can view all GPIO states simultaneously, or individually. During the operation, the following status is indicated: •...
  • Page 26 Chapter 5: Using the BEAM Tool Figure 19: Sys Ctrl Bank IO Page SFP Data SFP Data displays the SFP names and corresponding information. You can view SFP data simultaneously, or individually. During the operation, the following status is indicated: •...
  • Page 27 Chapter 5: Using the BEAM Tool Figure 20: SFP Data Page QSFP Data QSFP Data displays the QSFP names and corresponding information. You can view QSFP data simultaneously, or individually. During the operation, the following status is indicated: • A loader symbol is displayed under the Status column. •...
  • Page 28 Chapter 5: Using the BEAM Tool Figure 21: QSFP Data Page EBM Data EBM Data displays the EBM names and respective information. You can view EBM data simultaneously, or individually. During the operation, the following status is indicated: • A loader symbol is displayed under the Status column. •...
  • Page 29 Chapter 5: Using the BEAM Tool Figure 22: EBM Data Page FMC provides options for Current and Boot-Up operations. During each operation, the following status is indicated: • A loader symbol is displayed under the Status column. • On success, a green tick appears. •...
  • Page 30 Chapter 5: Using the BEAM Tool Figure 23: FMC Current Page Boot-Up Boot-Up enables you to set the boot-up value. Figure 24: FMC Boot-Up Page Board Interface Test This page enables you to run checks on different parameters such as Check Clocks, IDCODE Check, EBM EEPROM Check, DIMM EEPROM Check, and Check Voltages.
  • Page 31 Chapter 5: Using the BEAM Tool Figure 25: Board Interface Test Page As the checks are run, progress bars indicate status with different colors defined as follows. Figure 26: Board Interface Test Status • Check Clocks and Check Voltages test if clock and voltage parameters are working properly (Success or Fail).
  • Page 32: Obtain Linux Prompts

    Chapter 5: Using the BEAM Tool Obtain Linux Prompts This page provides instructions to obtain Linux prompts from the Versal ® adaptive compute acceleration (ACAP) platform. The Learn More button opens a new tab where you are prompted to log in using Google or Microsoft accounts. Figure 27: Obtain Linux Prompt Page Run Demos and Designs This page provides access to demos and designs such as Petalinux BSP Designs, Versal Power Tool,...
  • Page 33 Chapter 5: Using the BEAM Tool Figure 28: Run Demos and Designs Page Petalinux BSP Designs The Product Page (accessed by clicking the respective Product Page button) indicates price, part number, device support information, and an option to buy online. Contact sales are drop-down elements.
  • Page 34: Develop Using Tools

    Chapter 5: Using the BEAM Tool • Jupyter notebook and BITs/SCUI tabs cannot run at the same time. Shut down Jupyter notebook kernals to use the BIT or SCUI tab components. The Learn More leads to related documentation. See the Chapter 6: Versal Power Tool chapter for a more detailed overview.
  • Page 35 Chapter 5: Using the BEAM Tool Figure 30: Develop Using Tools Page UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 36: Chapter 6: Versal Power Tool

    Chapter 6: Versal Power Tool Chapter 6 Versal Power Tool The Versal power tool is launched from the Home page. To launch, first click the Run Demos & Designs button, then click the Run button under Versal Power Tool on the Run Demos & Designs page (see Run Demos and Designs).
  • Page 37 Chapter 6: Versal Power Tool The Versal power tool provides additional features. It can be used to benchmark power, prototype, or to continuously ensure that power meets the budget during development. The tool runs on the System Controller independently of whatever is running on the Versal device. This includes interfacing to the Versal device in ways that do not require any specific designs or resources from the device.
  • Page 38: Chapter 7: Acap Cockpit Console

    Chapter 7: ACAP Cockpit Console Chapter 7 ACAP Cockpit Console Overview The ACAP Cockpit Console provides the ability to configure any Versal ACAP module register (seeVersal ACAP Register Reference (AM012). It is a useful tool that monitors the health of the register's configuration, reduces time for debugging system configuration issues, and reports register details.
  • Page 39: Board Details

    Chapter 7: ACAP Cockpit Console IMPORTANT! • Invoking one or more XSDBs on the Versal ACAP and the System Controller might result in slowness, incorrect usage of the XSDB might result in an “Invalid Context“ error. • Running XSDB commands that take excessive time to execute from multiple masters might result in XSDB warnings.
  • Page 40 Chapter 7: ACAP Cockpit Console Figure 33: Board Details Pop-up Window When the force memory read option is enabled, the following command is executed on the XSDB: config force-mem-accesses 1 This forces reading of the registers (equivalent to the mrd -force command on the XSDB). Figure 34: Module Summary When the force memory read option is disabled, the following command is executed on the XSDB:...
  • Page 41: Acap Cockpit Menu Options

    Chapter 7: ACAP Cockpit Console ACAP Cockpit Menu Options The ACAP Cockpit offers four menu options located on the left side of the GUI. These are (from top to bottom): Menu Option Available Features Register Reference Versal ACAP, XSearch System Debugger Debugger, SysAddress Watch System Monitor Clock...
  • Page 42 Chapter 7: ACAP Cockpit Console An option is provided to search for modules/registers using the Module Name or Base Address. All Versal ACAP registers can be downloaded by clicking the DOWNLOAD button. You can download the registers in either ZIP or TCL format. ZIP provides a zip file with a tcl for each module.
  • Page 43 Chapter 7: ACAP Cockpit Console Figure 37: CFU_CSR Register Table If the Live Value of a register is not same as its Reset Value, then the live value of that register is displayed in an amber color. Click on a module name to see the respective register list. If the register is permitted to write, you can write to it by providing the value in the input field under Update and then click the pen icon.
  • Page 44 Chapter 7: ACAP Cockpit Console Figure 38: XSearch For example, to search all CFRM registers in the CFRAME0_REG module, search using CFRAME0_REG in the Module Name field and CFRM in the Register Name field. Search rules are as follows. • To search for modules: Use the exact module name (case insensitive).
  • Page 45 Chapter 7: ACAP Cockpit Console • After writing a command in the command line press Enter on the keyboard or click the SEND button to execute the command. To clear the command line input, click the CLEAR button. • A series of commands can also be executed by uploading a file using the UPLOAD button (.tcl and .xregv files are supported).
  • Page 46 Chapter 7: ACAP Cockpit Console Figure 40: SysAddress Watch UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 47 Chapter 7: ACAP Cockpit Console System Monitor The system monitor enables you to view the values of PS/PMC and CPM clocks, resets, and related information. Clock Table The clock table displays selected PLL, divider, target frequency, and the actual frequency for PS/PMC and CPM modules in respective tabs.
  • Page 48 Chapter 7: ACAP Cockpit Console Figure 42: Clock Tree Note: The change in clock value is specific to the tab. For example, if you change the reference clock in the PS, then only PS clock tree frequencies are calculated based on the new value. Click the REFRESH button to read live clock frequencies for all available PLL (APLL, NPLL, PPLL, and RPLL).
  • Page 49 Chapter 7: ACAP Cockpit Console Figure 43: Reset Table User Dashboard The user dashboard helps to debug read and write issues and can be used to plot (display graphs) for any register by name/address. Debugger You can read/write to/from any register by name/address (use thehelp command to see all supported formats).
  • Page 50 Chapter 7: ACAP Cockpit Console Figure 44: Plotting Graphs Figure 45: Graph Generation UG1573 (v1.0) February 22, 2023 www.xilinx.com Send Feedback System Controller User Guide...
  • Page 51: Appendix A: Additional Resources And Legal Notices

    Appendix A: Additional Resources and Legal Notices Appendix A Additional Resources and Legal Notices Xilinx Resources For support resources such as Answers, Documentation, Downloads, and Forums, see Xilinx Support. Documentation Navigator and Design Hubs Xilinx ® Documentation Navigator (DocNav) provides access to Xilinx documents, videos, and support resources, which you can filter and search to find information.
  • Page 52: References

    Appendix A: Additional Resources and Legal Notices References The most up to date information related to the BEAM Tool and the VCK190 Evaluation Board and its documentation is available on these websites: BEAM Tool for VCK190 Evaluation Kit Wiki VCK190 Evaluation Kit Product Page VMK180 Evaluation Kit Product Page These documents provide supplemental material useful with this guide: 1.
  • Page 53 Appendix A: Additional Resources and Legal Notices had been advised of the possibility of the same. Xilinx assumes no obligation to correct any errors contained in the Materials or to notify you of updates to the Materials or to product specifications.

This manual is also suitable for:

Xilinx vmk180

Table of Contents