Add Arch Linux support for xdna-driver

This commit adds complete support for building and installing the AMD XDNA
driver on Arch Linux.

Changes:
- tools/amdxdna_deps.sh: Add pacman support for jq installation
- CMake/pkg.cmake: Add Arch Linux detection and TGZ package generation
- xrt submodule: Updated with Arch Linux support (packaging + dependencies)
- README.md: Add detailed Arch Linux installation instructions

New files:
- PKGBUILD-xrt-plugin: Arch package build script for XDNA driver plugin
- xrt-plugin-amdxdna.install: Pacman install hooks for DKMS and kernel module

XRT-specific packaging:
- XRT PKGBUILDs moved to xrt/packaging/arch/ (maintained in XRT submodule)
- See xrt/packaging/arch/README.md for XRT packaging instructions

The build system now properly detects Arch Linux and generates .tar.gz
packages that can be repackaged into proper Arch packages (.pkg.tar.zst)
using the provided PKGBUILDs.

Tested on Arch Linux with kernel 6.17.8 and AMD Ryzen AI 9 HX 370 (NPU Strix).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: kashif

CMake/pkg.cmake

@@ -134,16 +134,27 @@ if("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "debian")
   set(CPACK_DEB_COMPONENT_INSTALL ON)
   set(CPACK_DEBIAN_PACKAGE_DEPENDS "xrt-base (>= ${XDNA_CPACK_XRT_BASE_VERSION}), xrt-base (<< ${XDNA_CPACK_XRT_BASE_NEXT_VERSION})")
   if(NOT SKIP_KMOD)
-    set(CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA "${CMAKE_CURRENT_BINARY_DIR}/package/postinst" 
+    set(CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA "${CMAKE_CURRENT_BINARY_DIR}/package/postinst"
       "${CMAKE_CURRENT_BINARY_DIR}/package/prerm")
   endif()
 elseif("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "fedora")
   set(CPACK_GENERATOR "RPM")
   set(CPACK_RPM_COMPONENT_INSTALL ON)
   set(CPACK_RPM_PACKAGE_REQUIRES "xrt-base >= ${XDNA_CPACK_XRT_BASE_VERSION}, xrt-base < ${XDNA_CPACK_XRT_BASE_NEXT_VERSION}")
   if(NOT SKIP_KMOD)
-    set(CPACK_RPM_POST_INSTALL_SCRIPT_FILE "${CMAKE_CURRENT_BINARY_DIR}/package/postinst") 
-    set(CPACK_RPM_PRE_UNINSTALL_SCRIPT_FILE "${CMAKE_CURRENT_BINARY_DIR}/package/prerm") 
+    set(CPACK_RPM_POST_INSTALL_SCRIPT_FILE "${CMAKE_CURRENT_BINARY_DIR}/package/postinst")
+    set(CPACK_RPM_PRE_UNINSTALL_SCRIPT_FILE "${CMAKE_CURRENT_BINARY_DIR}/package/prerm")
+  endif()
+elseif("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "arch")
+  set(CPACK_GENERATOR "TGZ")
+  # For Arch Linux, we generate a tarball that can be used for manual installation
+  # or to create a PKGBUILD. Post-install scripts need to be run manually.
+  set(CPACK_ARCHIVE_COMPONENT_INSTALL ON)
+  message(STATUS "Arch Linux detected - generating TGZ package")
+  if(NOT SKIP_KMOD)
+    message(STATUS "Post-install script: ${CMAKE_CURRENT_BINARY_DIR}/package/postinst")
+    message(STATUS "Pre-remove script: ${CMAKE_CURRENT_BINARY_DIR}/package/prerm")
+    message(STATUS "Note: For Arch Linux, you'll need to run these scripts manually or create a PKGBUILD")
   endif()
 else("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "debian")
   message(FATAL_ERROR "Unknown Linux package flavor: ${XDNA_CPACK_LINUX_PKG_FLAVOR}")

PKGBUILD-xrt-plugin

@@ -0,0 +1,26 @@
+# Maintainer: Your Name <[email protected]>
+pkgname=xrt-plugin-amdxdna
+pkgver=2.21.0
+pkgrel=1
+pkgdesc="AMD XDNA Driver plugin for Xilinx RunTime"
+arch=('x86_64')
+url="https://github.com/amd/xdna-driver"
+license=('Apache-2.0')
+depends=('xrt-base' 'xrt-npu' 'dkms' 'linux-headers')
+provides=('xrt-plugin-amdxdna')
+conflicts=('amdxdna-driver' 'amdxdna-driver-bin')
+install=xrt-plugin-amdxdna.install
+
+package() {
+  cd "$srcdir"
+
+  # Extract the tarball directly into the package directory
+  tar -xzf /home/kashif/Downloads/xdna-driver/build/Release/xrt_plugin.2.21.0_-x86_64-amdxdna.tar.gz -C "$pkgdir"
+
+  # Copy the install scripts for reference (they'll be called from .install file)
+  mkdir -p "$pkgdir/opt/xilinx/xrt/share/amdxdna/package"
+  install -Dm755 /home/kashif/Downloads/xdna-driver/build/Release/package/postinst \
+    "$pkgdir/opt/xilinx/xrt/share/amdxdna/package/postinst"
+  install -Dm755 /home/kashif/Downloads/xdna-driver/build/Release/package/prerm \
+    "$pkgdir/opt/xilinx/xrt/share/amdxdna/package/prerm"
+}

README.md

@@ -103,7 +103,7 @@ cd <root-of-source-tree>
 exit
 ```
 
-### Steps to create release build DEB package:
+### Steps to create release build DEB package (Ubuntu/Debian):
 
 ``` bash
 cd <root-of-source-tree>/build
@@ -121,7 +121,54 @@ cd ../../build
 # To adapt according to your OS & version
 sudo apt reinstall ./Release/xrt_plugin.2.19.0_ubuntu22.04-x86_64-amdxdna.deb
 ```
-You will find `xrt_plugin\*-amdxdna.deb` in Release/ folder. This package includes:
+
+### Steps to create release build packages (Arch Linux):
+
+``` bash
+cd <root-of-source-tree>
+
+# Install dependencies (requires sudo)
+sudo ./tools/amdxdna_deps.sh
+
+# Get submodules
+git submodule update --init --recursive
+
+# Build XRT
+cd xrt/build
+./build.sh -npu -opt
+
+# Build and install XRT packages using pacman
+# PKGBUILDs are in xrt/packaging/arch/
+cd ../packaging/arch
+makepkg -p PKGBUILD-xrt-base
+sudo pacman -U xrt-base-*.pkg.tar.zst
+
+makepkg -p PKGBUILD-xrt-npu
+sudo pacman -U xrt-npu-*.pkg.tar.zst
+
+# Build XDNA driver
+cd ../../../build
+./build.sh -release
+
+# Build and install XDNA plugin package
+cd ..
+makepkg -p PKGBUILD-xrt-plugin
+sudo pacman -U xrt-plugin-amdxdna-*.pkg.tar.zst
+
+# Configure memory limits (required for NPU access)
+sudo bash -c 'echo "* soft memlock unlimited" >> /etc/security/limits.conf'
+sudo bash -c 'echo "* hard memlock unlimited" >> /etc/security/limits.conf'
+
+# Log out and log back in (or reboot) for memory limit changes to take effect
+```
+
+**Note for Arch Linux users**: The build system generates `.tar.gz` packages which are repackaged into proper Arch packages (`.pkg.tar.zst`) using the provided PKGBUILDs:
+- XRT packages: `xrt/packaging/arch/` (PKGBUILD-xrt-base, PKGBUILD-xrt-npu)
+- XDNA driver: root directory (PKGBUILD-xrt-plugin)
+
+This ensures proper integration with pacman for installation, upgrades, and removal.
+
+You will find `xrt_plugin\*-amdxdna.deb` (Ubuntu/Debian) or `xrt_plugin*.tar.gz` (Arch Linux) in Release/ folder. This package includes:
 * The `.so` library files, which will be installed into `/opt/xilinx/xrt/lib` folder
 * The XDNA driver and DKMS script, which build, install and load
   `amdxdna.ko` driver when installing the .DEB package on target machine

tools/amdxdna_deps.sh

@@ -10,6 +10,8 @@ if [ -x "$(command -v apt-get)" ]; then
     apt-get install -y jq
 elif [ -x "$(command -v dnf)" ]; then
     dnf install -y jq
+elif [ -x "$(command -v pacman)" ]; then
+    pacman -Syu --needed --noconfirm jq
 fi
 
 $SCRIPT_DIR/../xrt/src/runtime_src/tools/scripts/xrtdeps.sh

xrt

@@ -0,0 +1,70 @@
+post_install() {
+  echo "Installing AMD XDNA driver via DKMS..."
+
+  install_datadir=/opt/xilinx/xrt/share/amdxdna
+  udev_rules_d=/etc/udev/rules.d
+  amdxdna_rules_file=99-amdxdna.rules
+  dracut_conf_d=/etc/dracut.conf.d
+  dracut_conf_file=amdxdna.dracut.conf
+
+  # On systems with dracut, exclude driver from initram
+  if [ -e ${dracut_conf_d} ]; then
+    if [ ! -f ${dracut_conf_d}/${dracut_conf_file} ]; then
+      touch ${dracut_conf_d}/${dracut_conf_file}
+    fi
+    echo "omit_drivers+=\" amdxdna \"" > ${dracut_conf_d}/${dracut_conf_file}
+  fi
+
+  # Install DKMS module
+  echo "Installing amdxdna Linux kernel module via DKMS..."
+  $install_datadir/dkms_driver.sh --install
+
+  # Setup udev rules
+  echo "Setting up udev rules..."
+  if [ ! -f ${udev_rules_d}/${amdxdna_rules_file} ]; then
+    touch ${udev_rules_d}/${amdxdna_rules_file}
+  fi
+  echo 'KERNEL=="accel*",DRIVERS=="amdxdna",MODE="0666"' > ${udev_rules_d}/${amdxdna_rules_file}
+
+  # Load the kernel module
+  echo "Loading amdxdna kernel module..."
+  rmmod amdxdna > /dev/null 2>&1 || true
+  modprobe amdxdna
+
+  echo "AMD XDNA driver installation complete!"
+  echo "You can test it with: source /opt/xilinx/xrt/setup.sh && xrt-smi validate"
+}
+
+post_upgrade() {
+  post_install
+}
+
+pre_remove() {
+  echo "Removing AMD XDNA driver..."
+
+  install_datadir=/opt/xilinx/xrt/share/amdxdna
+  udev_rules_d=/etc/udev/rules.d
+  amdxdna_rules_file=99-amdxdna.rules
+  dracut_conf_d=/etc/dracut.conf.d
+  dracut_conf_file=amdxdna.dracut.conf
+
+  # Unload kernel module
+  if lsmod | grep -q "amdxdna "; then
+    rmmod amdxdna
+  fi
+
+  # Remove dracut config
+  if [ -f ${dracut_conf_d}/${dracut_conf_file} ]; then
+    rm -f ${dracut_conf_d}/${dracut_conf_file}
+  fi
+
+  # Remove udev rules
+  if [ -f ${udev_rules_d}/${amdxdna_rules_file} ]; then
+    rm -f ${udev_rules_d}/${amdxdna_rules_file}
+  fi
+
+  # Remove DKMS module
+  $install_datadir/dkms_driver.sh --remove
+
+  echo "AMD XDNA driver removed!"
+}