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

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.
4. Set a stac IP address in the host machine. For example, IP address: 192.168.1.2 and Subnet
mask: 255.255.255.0.
a. Go to Control Panel\Network and Internet\Network Connecons and open Properes.
b. Ensure that:
• The last digit of the IP address on the Windows PC is dierent than what is being set
on the board.
• The default gateway has the last digit as one, the rest of the digits should be same as
the IP address eld.
• For example:
○IP address: 192.168.1.2
○Subnet mask: 255.255.255.0
○Default gateway: 192.168.1.1
Chapter 4: Board Setup and Configuration
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 11
Send Feedback

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 automacally 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. Ignore those instrucons.
6. Check the board's IP address by entering:
ifconfig
If you are on DHCP but the IP address is coming up as 192.168.1.11, check if someone has
set it to be persistent as in step 5.
7. Ping the Windows PC with the following command.
ping <host_ip>
Use CTRL+C to stop the ping command.
Chapter 4: Board Setup and Configuration
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 12
Send Feedback

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 gure.
Figure 4: Landing Page
The top horizontal navigaon bar contains three components:
•Home
•Help
•About
The right side vercal navigaon bar contains four components:
•Test the Board
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 13
Send Feedback

•Obtain Linux Prompts
•Run Demos & Designs
•Develop using tools
The le side vercal navigaon bar contains two components:
•About Versal ACAP
•Product Table
The middle of the page shows a picture of the VCK190 evaluaon kit and below that, Visit
Product Page. The footer displays the current version of the VCK190.
These components lead to other pages containing associated elements with more specic
informaon, described in the following secons.
Home
The Home page is displayed aer the BEAM tool has launched. Click Home to redirect back to
this page from any screen.
Figure 5: BEAM Tool Home Page
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 14
Send Feedback

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

About
The About page provides a brief descripon of the Board Evaluaon and Management (BEAM)
Tool.
Figure 7: About Page
Test the Board
The Test the Board page provides a gure showing the VCK190 evaluaon kit, its major
components and connecons (such as the microSD (Versal), microSD (SysCont), Ethernet, FMC,
power switch, and boot module). Informaon such as device, silicon rev, board P/N, serial
number, and MAC addresses is shown in the upper-right poron of the page
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 16
Send Feedback

Figure 8: Test the Board Page
The Boot Mode secon on the right displays the acve boot mode and has an opon to set the
boot mode to a dierent mode. The Change drop-down menu displays the various boot modes
available.
• Select the required boot mode and click Set.
• A loader is displayed when seng the boot mode.
• On a successful set, a green ck mark is displayed next to the set buon.
• On a failure, a red-colored cross icon is displayed.
• When the boot mode is set, the updated boot mode is displayed next to the Acve jtag label.
• The reset buon applies power-on-reset.
The temperature of the board is displayed in degrees cengrade on the le side of the page.
Below that are navigaon opons to Board Sengs and Board Interface Test (BIT). The Visit
Product Page buon is located below the gure, when selected, the product page opens in a new
browser tab.
Board Settings Page
The Board Sengs Page provides informaon about dierent parameters including:
•Clock
•Voltage
•Power
•DDR DIMM
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 17
Send Feedback

• GPIO Expander
• Sys Ctrl Bank I/O
• SFP Data
• QSFP Data
• EBM Data
• FMC
• EEPROM Data
Clock
Clock provides opons for Get Clock, Set Clock, Set Boot Clock, and Restore Clock operaons. For
all of these operaons, you can select all clocks simultaneously or individually. The following
status is indicated:
•A loader symbol is displayed under the Status column.
• On success, a green ck appears.
• On failure, a red color cross icon is displayed. Hover the mouse cursor on the red colored cross
icon to see the error message.
Get Clock
Get Clock displays the clock names and corresponding frequencies.
Figure 9: Get Clock Page
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 18
Send Feedback

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 specied is
set aer the System Controller is booted up.
Figure 11: Set Boot Clock Page
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 19
Send Feedback

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 operaon, the following status is indicated:
• A loader symbol is displayed under the Status column.
• On success, a green ck appears.
• On failure, a red color cross icon is displayed. Hover the mouse cursor on the red colored cross
icon to see the error message.
Chapter 5: Using the BEAM Tool
UG1573 (v1.0) February 22, 2023 www.xilinx.com
System Controller User Guide 20
Send Feedback