Issue with xbutil on XRT 2.8.1 (Edge, Debian 10, ARM64)

[Redoxon33]

Hello @ikwzm,

I have been following your instructions for installing XRT on Debian 10 (ARM64) as described in the repository. Previously, I posted an issue, and thanks to the feedback, I now have a better understanding of the installation process. However, despite my efforts, I have not been able to successfully complete the installation and run xbutil.

After following the steps in the repository, I encountered several issues during the installation process. Below is a detailed explanation of the steps I have followed:

1. The installation process completes, and it appears that XRT installs correctly. Here's the output from the dpkg -i command:

root@spock-som-2:/mnt/drive/ZynqMP-FPGA-XRT# dpkg -i xrt_202020.2.8.1_Edge_Debian_10-arm64.deb 
(Reading database ... 75430 files and directories currently installed.)
Preparing to unpack xrt_202020.2.8.1_Edge_Debian_10-arm64.deb ...
Unloading old XRT Linux kernel modules
Unregistering XRT Linux kernel module sources 2.8.1 from dkms

-------- Uninstall Beginning --------
Module:  xrt
Version: 2.8.1
Kernel:  5.4.0-spock-v2-0-rap-pal-0-gf7defc2 (aarch64)
-------------------------------------

Status: Before uninstall, this module version was ACTIVE on this kernel.

zocl.ko:
 - Uninstallation
   - Deleting from: /lib/modules/5.4.0-spock-v2-0-rap-pal-0-gf7defc2/updates/dkms/
 - Original module
   - No original module was found for this module on this kernel.
   - Use the dkms install command to reinstall any previous module version.

depmod...

DKMS: uninstall completed.

------------------------------
Deleting module version: 2.8.1
completely from the DKMS tree.
------------------------------
Done.
Unpacking xrt (2.8.1) over (2.8.1) ...
Setting up xrt (2.8.1) ...
Unloading old XRT Linux kernel modules
rmmod: ERROR: Module zocl is not currently loaded
Invoking DKMS common.postinst for xrt
Loading new xrt-2.8.1 DKMS files...
Building for 5.4.0-spock-v2-0-rap-pal-0-gf7defc2
Building initial module for 5.4.0-spock-v2-0-rap-pal-0-gf7defc2
Done.

zocl.ko:
Running module version sanity check.
 - Original module
   - No original module exists within this kernel
 - Installation
   - Installing to /lib/modules/5.4.0-spock-v2-0-rap-pal-0-gf7defc2/updates/dkms/

depmod...

DKMS: install completed.
Finished DKMS common.postinst
Loading new XRT Linux kernel modules

2.After the installation, the xbutil command is present, and I try to run xbutil examine, but I get the following error:

root@spock-som-2:/opt/xilinx/xrt/bin# xbutil examine
XRT build version: 2.8.1
Build hash: 2b6cf19aabd930a1f11e46ac104ee8343b43d721
Build date: 2021-05-09 16:21:12
Git branch: HEAD
PID: 11052
UID: 0
[Wed Sep 11 10:02:47 2024 GMT]
HOST: spock-som-2
EXE: /opt/xilinx/xrt/bin/unwrapped/xbutil
[xbutil] ERROR: Internal Error: wrap_paragraphs paragraph indent (2848558341) is greater than or equal to the column width (66)

3. Additionally, when I simply run xbutil, the help menu is displayed correctly, showing available commands such as examine, program, and validate. Here’s the output:

root@spock-som-2:/opt/xilinx/xrt/bin/unwrapped# xbutil
ERROR: Please specify a valid command

DESCRIPTION: The Xilinx (R) Board Utility (xbutil) is a standalone command line utility that is 
             included with the Xilinx Run Time (XRT) installation package. It includes 
             multiple commands to validate and identify the installed card(s) along with 
             additional card details including DDR, PCIe (R), shell name (DSA), and 
             system information.

             This information can be used for both card administration and application 
             debugging.

USAGE: xbutil [-hvb] [command [commandArgs]]

AVAILABLE COMMANDS:
  examine    - Status of the system and device(s)
  program    - Download the acceleration program to a given device
  validate   - Validates the basic shell accelleration functionality

OPTIONS:
  -h, --help         - Help to use this application
  -v, --verbose      - Turn on verbosity
  -b, --batch        - Enable batch mode (disables escape characters)

It seems that there is an internal issue related to formatting in xbutil, as the paragraph indent exceeds the column width. I’ve tried different variations of the xbutil command but always receive a similar error.

I appreciate the help provided earlier and the detailed instructions in the repository, but I'm still encountering these issues during installation. Could you please advise on what might be causing this problem and how I can resolve it?

Thank you for your assistance.

[ikwzm]

Thanks for your issue.

However, I am not currently using XRT.
Therefore, I am unable to help you.
You can find the xbutil source code for XRT at XRT/src/runtime_src/core/tools/xbutil2/.

[Redoxon33]

Okay, thank you.