Add Arch Linux support for xdna-driver

CMake/pkg.cmake

@@ -118,19 +118,31 @@ 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()
-else("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "debian")
+elseif("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "arch")
+  set(CPACK_GENERATOR "TGZ")
+  # For Arch Linux, we generate a tarball that can be repackaged into a proper
+  # Arch package using the provided PKGBUILD. When using the PKGBUILD, install
+  # hooks handle post-install/pre-remove automatically via pacman.
+  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: Use the provided PKGBUILD to create an Arch package with proper install hooks")
+  endif()
+else()
   message(FATAL_ERROR "Unknown Linux package flavor: ${XDNA_CPACK_LINUX_PKG_FLAVOR}")
-endif("${XDNA_CPACK_LINUX_PKG_FLAVOR}" MATCHES "debian")
+endif()
 
 include(CPack)

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,53 @@ 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/build/arch/
+cd 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
+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/build/arch/` (PKGBUILD-xrt-base, PKGBUILD-xrt-npu)
+- XDNA driver: `build/` 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

build/PKGBUILD-xrt-plugin

@@ -0,0 +1,39 @@
+# 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
+
+# Set this to your xdna-driver build output directory (relative to PKGBUILD location)
+: ${XDNA_BUILD_DIR:="Release"}
+
+package() {
+  cd "$srcdir"
+
+  # Extract the tarball directly into the package directory
+  # The tarball should be at $startdir/$XDNA_BUILD_DIR/xrt_plugin*.tar.gz
+  local tarballs=("$startdir/${XDNA_BUILD_DIR}"/xrt_plugin*-amdxdna.tar.gz)
+  if [ ${#tarballs[@]} -eq 0 ] || [ ! -f "${tarballs[0]}" ]; then
+    error "XDNA plugin tarball not found in ${XDNA_BUILD_DIR}"
+    error "Please build XDNA driver first: cd build && ./build.sh -release"
+    return 1
+  fi
+
+  local tarball="${tarballs[0]}"
+  msg2 "Extracting $tarball"
+  tar -xzf "$tarball" -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 $startdir/${XDNA_BUILD_DIR}/package/postinst \
+    "$pkgdir/opt/xilinx/xrt/share/amdxdna/package/postinst"
+  install -Dm755 $startdir/${XDNA_BUILD_DIR}/package/prerm \
+    "$pkgdir/opt/xilinx/xrt/share/amdxdna/package/prerm"
+}

build/xrt-plugin-amdxdna.install

@@ -0,0 +1,71 @@
+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 initramfs
+  if [ -e ${dracut_conf_d} ]; then
+    if [ ! -f ${dracut_conf_d}/${dracut_conf_file} ]; then
+      touch ${dracut_conf_d}/${dracut_conf_file}
+    fi
+    grep -q '^omit_drivers\+=\" amdxdna \"' "${dracut_conf_d}/${dracut_conf_file}" || 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
+  grep -q '^KERNEL=="accel\*",DRIVERS=="amdxdna",MODE="0666"$' ${udev_rules_d}/${amdxdna_rules_file} || \
+    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!"
+}

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