XRT
XRT copied to clipboard
Published
20 hours ago •
Xilinx
Xilinx
VITIS-5838 xbutil PS Kernel reports
Problem solved by the commit
https://jira.xilinx.com/browse/VITIS-5838 The Versal platform introduces the idea of PS kernels, which are a type of software application that runs onboard a device's APU. The new report will collect and display the information to the user using a built in PS kernel.
How problem was solved, alternative solutions (if any) and why they were rejected
A new report was added to xbutil examine named ps-kernels
Risks (if any) associated the changes in the commit
New feature so minimal risk to existing features.
What has been tested and how, request additional testing if necessary
Tested on Ubuntu 20.04 using an interim step to acquire the data as the built in kernel software is not yet ready. New help menu
dbenusov@xsjpranjal01:/proj/rdi/staff/dbenusov/XRT$ xbutil examine --help
DESCRIPTION: This command will 'examine' the state of the system/device and will generate a report
of interest in a text or JSON format.
USAGE: xbutil examine [--help] [-d arg] [-r arg] [-f arg] [-o arg]
OPTIONS:
-d, --device - The Bus:Device.Function (e.g., 0000:d8:00.0) device of interest.
-r, --report - The type of report to be produced. Reports currently available are:
aie - AIE metadata in xclbin
aieshim - AIE shim tile status
all - All known reports are produced
cmc - CMC status of the device
debug-ip-status - Status of Debug IPs present in xclbin loaded on device
dynamic-regions - Information about the xclbin and the compute units
electrical - Electrical and power sensors present on the device
error - Asyncronus Error present on the device
firewall - Firewall status
host - Host information
mailbox - Mailbox metrics of the device
mechanical - Mechanical sensors on and surrounding the device
memory - Memory information present on the device
pcie-info - Pcie information of the device
platform - Platforms flashed on the device
ps-kernels - On card PS kernel instance information
qspi-status - QSPI write protection status
thermal - Thermal sensors present on the device
-f, --format - Report output format. Valid values are:
JSON - Latest JSON schema
JSON-2020.2 - JSON 2020.2 schema
-o, --output - Direct the output to the given file
--help - Help to use this sub-command
GLOBAL OPTIONS:
--verbose - Turn on verbosity
--batch - Enable batch mode (disables escape characters)
--force - When possible, force an operation
Example Invocation of command
dbenusov@xsjpranjal01:/proj/rdi/staff/dbenusov/XRT$ xbutil examine -d 17:00 -r ps-kernels
---------------------------------------------------
[0000:17:00.1] : xilinx_vck5000_gen4x8_qdma_base_1
---------------------------------------------------
PS Kernels
APU Image
System name : Linux
Release : 5.15.36-xilinx-v2022.2
Version : #1 SMP Tue Jun 7 13:09:31 UTC 2022
Machine : aarch64
Distribution : PetaLinux 2022.2_release_S06080830 (honister)
Model : Xilinx Versal
Cores : 2
Total Memory : 2684489728 B
Available Memory : 2175877120 B
Address Space : 2684489728 B
PS Kernel Instances
----------------------
Kernel: hello_world
----------------------
====================================================================================================================================
[0] hello_world_0
Kernel : hello_world
CU Address : 0x0
CU Index : 3
Protocol : CTRL_HS
Interrupt Compatible : 0
Resettable : 0
Argument Count : 0
Process Properties
Name Value Name Value Name Value
----------------------------------------------------------------------------------------------------------------------------------
CapAmb 0000000000000000 PPid 441 Uid 1001 1001 1001 1001
CapBnd 000001ffffffffff Pid 482 Umask 0000
CapEff 0000000000000000 RssAnon 1156 kB VmData 1056 kB
CapInh 0000000000000000 RssFile 4 kB VmExe 32 kB
CapPrm 0000000000000000 RssShmem 5208 kB VmHWM 6368 kB
CoreDumping 0 Seccomp 0 VmLck 0 kB
CpusAllowed 3 SeccompFilters 0 VmLib 8580 kB
CpusAllowedList 0-1 ShdPnd 0000000000000000 VmPTE 60 kB
FDSize 64 SigBlk 0000000000000000 VmPeak 11076 kB
Gid 1001 1001 1001 1001 SigCgt 0000000000007eff VmPin 0 kB
Groups 1001 SigIgn 0000000000010000 VmRSS 6368 kB
HugetlbPages 0 kB SigPnd 0000000000000000 VmSize 11076 kB
MemsAllowed 1 SigQ 0/8927 VmStk 132 kB
MemsAllowedList 0 SpeculationIndirectBranch unknown VmSwap 0 kB
NSpgid 441 SpeculationStoreBypass not vulnerable NonvoluntaryCtxtSwitches 191
NSpid 482 State R (running) VoluntaryCtxtSwitches 26
NSsid 441 THPEnabled 1
NStgid 482 Tgid 482
Ngid 0 Threads 1
NoNewPrivs 0 TracerPid 0
---------------------------
Kernel: loop_hello_world
---------------------------
====================================================================================================================================
[0] loop_hello_world_0
Kernel : loop_hello_world
CU Address : 0x0
CU Index : 0
Protocol : CTRL_HS
Interrupt Compatible : 0
Resettable : 0
Argument Count : 0
Process Properties
Name Value Name Value Name Value
----------------------------------------------------------------------------------------------------------------------------------
CapAmb 0000000000000000 PPid 441 Uid 1001 1001 1001 1001
CapBnd 000001ffffffffff Pid 479 Umask 0000
CapEff 0000000000000000 RssAnon 596 kB VmData 528 kB
CapInh 0000000000000000 RssFile 4 kB VmExe 32 kB
CapPrm 0000000000000000 RssShmem 4568 kB VmHWM 5168 kB
CoreDumping 0 Seccomp 0 VmLck 0 kB
CpusAllowed 3 SeccompFilters 0 VmLib 8444 kB
CpusAllowedList 0-1 ShdPnd 0000000000000000 VmPTE 60 kB
FDSize 64 SigBlk 0000000000000000 VmPeak 10396 kB
Gid 1001 1001 1001 1001 SigCgt 0000000000007eff VmPin 0 kB
Groups 1001 SigIgn 0000000000000000 VmRSS 5168 kB
HugetlbPages 0 kB SigPnd 0000000000000000 VmSize 10392 kB
MemsAllowed 1 SigQ 0/8927 VmStk 132 kB
MemsAllowedList 0 SpeculationIndirectBranch unknown VmSwap 0 kB
NSpgid 441 SpeculationStoreBypass not vulnerable NonvoluntaryCtxtSwitches 7
NSpid 479 State S (sleeping) VoluntaryCtxtSwitches 1
NSsid 441 THPEnabled 1
NStgid 479 Tgid 479
Ngid 0 Threads 1
NoNewPrivs 0 TracerPid 0
====================================================================================================================================
[1] loop_hello_world_1
Kernel : loop_hello_world
CU Address : 0x0
CU Index : 1
Protocol : CTRL_HS
Interrupt Compatible : 0
Resettable : 0
Argument Count : 0
Process Properties
Name Value Name Value Name Value
----------------------------------------------------------------------------------------------------------------------------------
CapAmb 0000000000000000 PPid 441 Uid 1001 1001 1001 1001
CapBnd 000001ffffffffff Pid 480 Umask 0000
CapEff 0000000000000000 RssAnon 596 kB VmData 528 kB
CapInh 0000000000000000 RssFile 4 kB VmExe 32 kB
CapPrm 0000000000000000 RssShmem 4568 kB VmHWM 5168 kB
CoreDumping 0 Seccomp 0 VmLck 0 kB
CpusAllowed 3 SeccompFilters 0 VmLib 8444 kB
CpusAllowedList 0-1 ShdPnd 0000000000000000 VmPTE 60 kB
FDSize 64 SigBlk 0000000000000000 VmPeak 10396 kB
Gid 1001 1001 1001 1001 SigCgt 0000000000007eff VmPin 0 kB
Groups 1001 SigIgn 0000000000010000 VmRSS 5168 kB
HugetlbPages 0 kB SigPnd 0000000000000000 VmSize 10392 kB
MemsAllowed 1 SigQ 0/8927 VmStk 132 kB
MemsAllowedList 0 SpeculationIndirectBranch unknown VmSwap 0 kB
NSpgid 441 SpeculationStoreBypass not vulnerable NonvoluntaryCtxtSwitches 5
NSpid 480 State S (sleeping) VoluntaryCtxtSwitches 1
NSsid 441 THPEnabled 1
NStgid 480 Tgid 480
Ngid 0 Threads 1
NoNewPrivs 0 TracerPid 0
====================================================================================================================================
[2] loop_hello_world_2
Kernel : loop_hello_world
CU Address : 0x0
CU Index : 2
Protocol : CTRL_HS
Interrupt Compatible : 0
Resettable : 0
Argument Count : 0
Process Properties
Name Value Name Value Name Value
----------------------------------------------------------------------------------------------------------------------------------
CapAmb 0000000000000000 PPid 441 Uid 1001 1001 1001 1001
CapBnd 000001ffffffffff Pid 481 Umask 0000
CapEff 0000000000000000 RssAnon 596 kB VmData 528 kB
CapInh 0000000000000000 RssFile 4 kB VmExe 32 kB
CapPrm 0000000000000000 RssShmem 4568 kB VmHWM 5168 kB
CoreDumping 0 Seccomp 0 VmLck 0 kB
CpusAllowed 3 SeccompFilters 0 VmLib 8444 kB
CpusAllowedList 0-1 ShdPnd 0000000000000000 VmPTE 60 kB
FDSize 64 SigBlk 0000000000000000 VmPeak 10396 kB
Gid 1001 1001 1001 1001 SigCgt 0000000000007eff VmPin 0 kB
Groups 1001 SigIgn 0000000000010000 VmRSS 5168 kB
HugetlbPages 0 kB SigPnd 0000000000000000 VmSize 10392 kB
MemsAllowed 1 SigQ 0/8927 VmStk 132 kB
MemsAllowedList 0 SpeculationIndirectBranch unknown VmSwap 0 kB
NSpgid 441 SpeculationStoreBypass not vulnerable NonvoluntaryCtxtSwitches 5
NSpid 481 State S (sleeping) VoluntaryCtxtSwitches 1
NSsid 441 THPEnabled 1
NStgid 481 Tgid 481
Ngid 0 Threads 1
NoNewPrivs 0 TracerPid 0
Documentation impact (if any)
Need to add new report and description to Documentation page
