AMD XILINX VCK190 User manual

VCK190/VMK180 Board
Evaluaon 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.

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.............................................................................................................................................15
About.......................................................................................................................................... 16
Test the Board............................................................................................................................16
Obtain Linux Prompts...............................................................................................................32
Run Demos and Designs.......................................................................................................... 32
Develop Using Tools................................................................................................................. 34
Chapter 6: Versal Power Tool................................................................................. 36
Chapter 7: ACAP Cockpit Console........................................................................ 38
Overview.....................................................................................................................................38
ACAP Cockpit Scope.................................................................................................................. 38
Board Details............................................................................................................................. 39
ACAP Cockpit Menu Options....................................................................................................41
Appendix A: Additional Resources and Legal Notices............................. 51
Xilinx Resources.........................................................................................................................51
Documentation Navigator and Design Hubs.........................................................................51
References..................................................................................................................................52
Revision History.........................................................................................................................52
Please Read: Important Legal Notices................................................................................... 52
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 2
Send Feedback

Chapter 1
Introduction
The Board Evaluaon and Management (BEAM) tool is a web-based graphical user interface
(GUI) applicaon that connects to the web server running on the System Controller. It allows you
to monitor and modify dierent parameters such as clocks, voltages, and power on the
evaluaon board and to run the Board Interface Test (BIT) to ensure that the board funcons
properly.
The BEAM tool home page consists of various navigaon opons and links and provides an easy
and intuive experience with Xilinx® Versal® evaluaon kits. The goal is to help you get started
faster and have all the available resources in one place for easy access. Depending on the
persona type (hardware, soware, or embedded developer), you can choose to start with either
tesng the board, using the power advantage demo, downloading Versal reference designs or
learning more about the latest Xilinx tools and libraries.
The VCK190 evaluaon board and its major components are shown in the following gure.
Figure 1: VCK190 Evaluation Board
Refer to the VCK190 Evaluaon Board User Guide (UG1366) for detailed informaon about the
board including regulatory and compliance informaon.
Chapter 1: Introduction
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 3
Send Feedback

Chapter 2
Requirements
These accessories from the Versal® evaluaon 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
•Evaluaon board
A Windows PC (host machine) with an ethernet port is needed to connect to the system
controller on the Versal® evaluaon board.
Chapter 2: Requirements
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 4
Send Feedback

Chapter 3
Installing the System Controller
Image
The Versal® evaluaon 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. Otherwise proceed to Chapter 4: Board Setup and Conguraon.
Formatting the SD Card
1. Insert the SD card into a card reader and connect the card reader to your computer.
2. Ensure that there are no parons in the SD card.
3. Open Windows Explorer on your PC, right-click the micro SD card, and select Format. This
erases all of the contents on the micro SD card.
4. Specify the le system and set a new label to the SD card.
If the instrucons in the previous steps do not work perform the following steps to format the
SD card.:
1. Right-click on the Window Start icon located at the boom le poron of the screen, select
Disk Management. Navigate to the Removable Disk volume and clear all the paron by right
clicking on volume and selecng Delete Volume.
2. The removable disk should indicate FAT32 and all space as Unallocated as shown in the
following gure.
Chapter 3: Installing the System Controller Image
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 5
Send Feedback

Chapter 3: Installing the System Controller Image
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 6
Send Feedback

Preparing the SD Card
Use the Win32 disk imager (Windows extractor) ulity or the dd command line ulity for Linux to
write the given raw disk image petalinux-sdimage.wic to the micro SD card.
Using the Win32 disk imager ulity (as shown in the following gure and keyed steps):
Figure 2: Win32 Disk Imager Utility
1. Use the Windows extractor to unzip the image le petalinux-sdimage.wic.zip and
browse to the locaon of the unzipped image in the Win32 ulity. Based on the format of
your image (.img or .wic), select the appropriate opon from the drop-down menu as shown
in the following gure. Selecng ‘*.*’ enables all of the .wic le-based images to be visible.
Chapter 3: Installing the System Controller Image
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 7
Send Feedback

2. Choose the correct SD card under device.
3. Click Write and then Yes at the prompt and wait unl the operaon is complete.
Using the command line ulity for Linux:
1. Unzip the image le petalinux-sdimage.wic.zip:
unzip petalinux-sdimage.wic.zip
2. Use dd to write sdcard.img to the correct enumerated disk for the SD card (check output of
mount command to know sdxx mount point) in the Linux machine:
sudo dd if=petalinux-sdimage.wic.zip of=/dev/sdbx bs=1M
Micro SD Card Partitions
Aer the raw image is wrien to the SD card, there will be two parons. The rst paron
(FAT32 format) contains:
•boot image (BOOT.bin)
•u-boot script (boot.scr)
•kernel image (Image)
The second paron (ext4 format) contains the root le system.
Chapter 3: Installing the System Controller Image
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 8
Send Feedback

Note: Windows OS only allows FAT32 parons to be viewed, which is the boot paron. ext4 format is
not recognized.
Chapter 3: Installing the System Controller Image
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 9
Send Feedback

Chapter 4
Board Setup and Configuration
Connections
Make the necessary connecons and ensure that the SW11 switch sengs are as shown in the
following gure. You only need the pre-programmed micro SD card (SysCont) to launch the
BEAM tool. Plug the micro SD card (SysCont) into the SD card slot as shown in the gure.
Figure 3: Board Connections
IP Configuration
1. Set up a Tera-Term session between a host PC COM port and the serial port (JTAG/UART) on
the evaluaon board, Ensure that the correct COM port is selected, and port speed is set to
115200.
2. The board and Host machine can be connected back-to-back using Ethernet cable, or the
board can be in a network with a DHCP server running to provide the address.
Chapter 4: Board Setup and Configuration
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 10
Send Feedback