#1149515 ITP: amd-aie-rt -- AMD AI Engine runtime components (driver and FAL)

#1149515#5
Date:
2026-09-30 08:25:02 UTC
From:
To:
* Package name    : amd-aie-rt
  Version         : 2026.1.1
* URL             : https://github.com/Xilinx/aie-rt
* License         : GPLv2
  Programming Lang: C/C++
  Description     : AMD AI Engine runtime components (driver and FAL)

AIE-RT (AI Engine Run Time) is an open-source software component by AMD
(formerly Xilinx) that combines low-level drivers and a functional abstraction
layer (FAL) to manage and access AI Engine (AIE) hardware resources

The AIE Driver is a userspace library that provides hardware access to
applications, while the AIE FAL is functional abstraction layer that provides
common userspace APIs for runtime AIE resource management.

This package is required to enable support for additional features
inside the xrt package. As it's directly related to xrt and similar
AMD/Xilinx packages, it should probably go under the umbrella of
xilinx-packages-team. I hope to be able to co-maintain it with the
people in that team.

#1149515#10
Date:
2026-10-13 05:31:32 UTC
From:
To:
This is an automated message from the Debian DFSG, Licensing & New
Packages Team.

The Debian NEW review of amd-aie-rt 2026.1.1+dfsg-1 has been completed.

Decision: ACCEPTED
Reviewer: Andrew McMillan

Review comment:

Hi,

Some of these issues that the LLM review came up with seem kind of extreme - like you wouldn't have been able to build and upload - but perhaps they're real, and you managed to build from a dirty local tree and would fail from a clean one.

They're not copyright issues, so I'll accept it in this case because if they are real you'll be wanting to fix these pretty soon I guess!

1. [blocker] [packaging] libxaiefal-dev has nothing to install: dh_install will abort

 - Files: `debian/libxaiefal-dev.install`, `fal/src/CMakeLists.txt`, `fal/CMakeLists.txt`
 - Evidence: debian/libxaiefal-dev.install contains only `usr/include/xaiefal/`; the effective branch of fal/src/CMakeLists.txt (YOCTO=OFF) only does `file(COPY ... DESTINATION ${CMAKE_BINARY_DIR}/include/xaiefal)` and has no install() rule (the only header install() is in the unused else()/YOCTO branch); nothing else in the fal tree installs the fal headers.
 - Problem: No CMake install() rule or rules-file copy ever creates usr/include/xaiefal, so dh_install finds no files in the current directory or in debian/tmp and aborts the arch build (`dh_install: error: cannot find usr/include/xaiefal/`). Even if it did not abort, libxaiefal-dev would be empty, so the header-only FAL would be unusable by its declared dependents.
 - Fix: Point the install source at the build-tree copy, e.g. `obj-${DEB_HOST_GNU_TYPE}/include/xaiefal usr/include/`, or add an upstream install(DIRECTORY ...) for the fal headers (non-YOCTO branch) and keep `usr/include/xaiefal/`. Verify with a clean `debian/rules binary`.

2. [blocker] [packaging] versal-linux toolchain forces aarch64-linux-gnu compilers that are not in Build-Depends

 - Files: `debian/rules`, `debian/control`, `fal/cmake/platforms/versal-linux.cmake`, `fal/cmake/platforms/cross-linux-g++.cmake`
 - Evidence: debian/rules passes `-DCMAKE_TOOLCHAIN_FILE=versal-linux`; versal-linux.cmake sets `CROSS_PREFIX=aarch64-linux-gnu-` and `include(cross-linux-g++)`, which sets `CMAKE_C_COMPILER=aarch64-linux-gnu-gcc` and `CMAKE_CXX_COMPILER=aarch64-linux-gnu-g++`.
 - Problem: CMake will try to run aarch64-linux-gnu-gcc/g++ (also used by the ExternalProject driver build via CC=${CC}) and fails configuration when the cross compiler is absent; Build-Depends lists only cmake, cpputest, liburing-dev, pkgconf and no gcc-aarch64-linux-gnu/g++-aarch64-linux-gnu, so a clean pbuilder/salsa arm64 chroot cannot configure. The toolchain file effectively assumes a cross build even though the package is native-arm64.
 - Fix: Either add gcc-aarch64-linux-gnu and g++-aarch64-linux-gnu to Build-Depends (and confirm the resulting binaries link against the native arm64 runtime, given CMAKE_FIND_ROOT_PATH_MODE_* are NEVER), or drop -DCMAKE_TOOLCHAIN_FILE=versal-linux and build natively on arm64.

3. [minor] [packaging] No autopkgtests

 - Files: `debian/tests/control`
 - Evidence: There is no debian/tests/ directory; the package builds unit-test binaries (run-test-aie, via WITH_TESTS=ON) but never wires them into the test harness.
 - Problem: The unit-test binaries are built but not exercised in any automated way, so CI/autopkgtest regressions in the library API go undetected (tests do need arm64 Versal hardware, but could at least be smoke-run).
 - Fix: Add a debian/tests/control that smoke-runs the built unit tests and examples (or drop WITH_TESTS=ON if the tests are only built, not run).

4. [minor] [packaging] driver/tests/utest CMake still references the excluded elf_files directory

 - Files: `driver/tests/utest/CMakeLists.txt:18`
 - Evidence: `file(COPY elf_files DESTINATION ${CMAKE_CURRENT_BINARY_DIR})` runs unconditionally when the driver's own CMake project is configured, but driver/tests/utest/elf_files is listed in Files-Excluded and absent from the tree.
 - Problem: Configuring the upstream driver/ CMake (the upstream way to build the unit tests) fails at configure time. The Debian build avoids this because it builds the driver via Makefile.Linux through fal's ExternalProject, so it is latent rather than a current build failure.
 - Fix: Guard the copy with `if (EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/elf_files)` or restore a minimal fixture, so the exclusion does not break upstream's own test build.

5. [minor] [packaging] debian/watch is in the old version 4 format

 - Files: `debian/watch`
 - Evidence: `version=4`
 - Problem: Version 5 is the current format of `debian/watch`.
 - Fix: Convert it to version 5; a mechanical conversion is included below.

==========================================================================
Version: 5

Source: https://github.com/Xilinx/aie-rt.git
Matching-Pattern: refs/tags/xilinx_v@ANY_VERSION@
Dversionmangle: s/\+dfsg\d*$//
Mode: git
Repacksuffix: +dfsg
==========================================================================



Thanks!

Full review details: https://dfsg-new-queue.debian.org/reviews/amd-aie-rt

#1149515#15
Date:
2026-10-13 06:00:24 UTC
From:
To:
We believe that the bug you reported is fixed in the latest version of
amd-aie-rt, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1149515@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Isaac True <isaac@is.having.coffee> (supplier of updated amd-aie-rt package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)
Format: 1.8
Date: Tue, 29 Sep 2026 14:20:42 +0200
Source: amd-aie-rt
Binary: libxaiefal-dev libxaiengine-dev libxaiengine3 libxaiengine3-dbgsym xaiefal-doc xaiefal-examples xaiefal-examples-dbgsym xaiefal-tests xaiefal-tests-dbgsym
Architecture: source arm64 all
Version: 2026.1.1+dfsg-1
Distribution: unstable
Urgency: medium
Maintainer: Mario Limonciello <superm1@debian.org>
Changed-By: Isaac True <isaac@is.having.coffee>
Description:
 libxaiefal-dev - Xilinx AI Engine Runtime - Functional Abstraction Layer - headers
 libxaiengine-dev - Xilinx AI Engine Runtime - Userspace Driver - headers
 libxaiengine3 - Xilinx AI Engine Runtime - Userspace Driver
 xaiefal-doc - Xilinx AI Engine Runtime - Functional Abstraction Layer - doc
 xaiefal-examples - Xilinx AI Engine Runtime - Functional Abstraction Layer - example
 xaiefal-tests - Xilinx AI Engine Runtime - Functional Abstraction Layer - tests
Closes: 1149515
Changes:
 amd-aie-rt (2026.1.1+dfsg-1) unstable; urgency=medium
 .
   [ Isaac True ]
 .
   * Initial release. (Closes: #1149515)
   * d/patches: add use-system-liburing.patch to avoid using the vendored
     liburing.
   * Remove vendored liburing sources.
   * Remove pre-built ELF binaries.
 .
   [ Talha Can Havadar ]
 .
   * d/patches: add patches to resolve build errors
     * fix-license-file-path.patch
     * fix-aiedrv-backend.patch
     * fal-update-cflags-ldflags.patch
     * cmake-bump-minimum-required-to-3.5.patch
Checksums-Sha1:
 3a75b7df4f94817c7324b0c6fcb804d057a2063d 2419 amd-aie-rt_2026.1.1+dfsg-1.dsc
 5365097876332c9ef2e67b1ffdaf58ac58f1f6e8 529948 amd-aie-rt_2026.1.1+dfsg.orig.tar.xz
 ffc79ecc09b15daf5170abd14e7fd868f7e4348d 10268 amd-aie-rt_2026.1.1+dfsg-1.debian.tar.xz
 020dffd805afe8f03bfbba2129d8098f0cdbc8da 12724 amd-aie-rt_2026.1.1+dfsg-1_arm64.buildinfo
 25efc72b786a874e97a8044f04e329332871beeb 37864 libxaiefal-dev_2026.1.1+dfsg-1_arm64.deb
 10fe89cdc9a2fde3c9a2451c08f2195c31a12947 84240 libxaiengine-dev_2026.1.1+dfsg-1_arm64.deb
 f779d48413194b1f2e240b8c713502d718fe868e 428784 libxaiengine3-dbgsym_2026.1.1+dfsg-1_arm64.deb
 93bc8dd5ffffa74915ba4f5b9a2b47bbdd5b9771 135492 libxaiengine3_2026.1.1+dfsg-1_arm64.deb
 ed9d96ad9d4c6072b6cb3f81219780a2e5fff82a 291396 xaiefal-doc_2026.1.1+dfsg-1_all.deb
 eaa5c7dc8e31a8ccddc6229e1c2b09224351ff25 2100476 xaiefal-examples-dbgsym_2026.1.1+dfsg-1_arm64.deb
 792f9f9028fa4bc79d210fe71788405971e02a71 95264 xaiefal-examples_2026.1.1+dfsg-1_arm64.deb
 f52a876ced6861d0cb45942270ac74333bd3a708 5872888 xaiefal-tests-dbgsym_2026.1.1+dfsg-1_arm64.deb
 c86ad57b93de6e8ffc76b36786bfff2173675430 208128 xaiefal-tests_2026.1.1+dfsg-1_arm64.deb
Checksums-Sha256:
 e01fe5a4d6b88adbaa82995bbe96aacbaf090942eb19c36cc2269baddf327c7b 2419 amd-aie-rt_2026.1.1+dfsg-1.dsc
 0ad63f4ed5d8af1e082ddd9298c885adfb22794e5d3e4166f3b4c0357f9f0aed 529948 amd-aie-rt_2026.1.1+dfsg.orig.tar.xz
 b64cebe81f41968343a9e43f58940f9a4a1c3e032afb30dae00b7ff6890c6889 10268 amd-aie-rt_2026.1.1+dfsg-1.debian.tar.xz
 fd18cebf538eb2e056493a5340c1bb29bf2fefa3b84b995d87b7c9748350fce5 12724 amd-aie-rt_2026.1.1+dfsg-1_arm64.buildinfo
 90e07dd1cad38991002f4b03ba34bd0d382019d644fe00c80c74bc56e90353ab 37864 libxaiefal-dev_2026.1.1+dfsg-1_arm64.deb
 1784e1ca003741f93248171a1dee6f1ebb331ecabd19cbe32b7a8f70ebe0825e 84240 libxaiengine-dev_2026.1.1+dfsg-1_arm64.deb
 d2dab2a215c0e1d5c3a9437a9d20699122795a6b561a49a9ae2fcff5dccf0612 428784 libxaiengine3-dbgsym_2026.1.1+dfsg-1_arm64.deb
 750f1ba97a1e1f337f1d247e3f71d87eb4b160c83c575c62e281750c2541087d 135492 libxaiengine3_2026.1.1+dfsg-1_arm64.deb
 8d59f587067153beca94cd4caa4c21f5c7abf5f11a4896c6aeb19bb9b3b30682 291396 xaiefal-doc_2026.1.1+dfsg-1_all.deb
 86189626f6eb5831568d6bc2f7762fd3509c93240ddbd984c576f4a4e3ff1961 2100476 xaiefal-examples-dbgsym_2026.1.1+dfsg-1_arm64.deb
 a72a40b5335a9d0e0564ba6dcbb86b311e6c60b91035fed1e4b9d909dbd9fec7 95264 xaiefal-examples_2026.1.1+dfsg-1_arm64.deb
 a6fd46bbd6fcc45918244df08aa29528160e77ceda30ddb762e0dbb85c051a02 5872888 xaiefal-tests-dbgsym_2026.1.1+dfsg-1_arm64.deb
 199f22fd4f13eca69f8422a56df2325cb82d09097e5d05b5d354e5406595c132 208128 xaiefal-tests_2026.1.1+dfsg-1_arm64.deb
Files:
 797aab498cc051f81851fa1f35dcf033 2419 libdevel optional amd-aie-rt_2026.1.1+dfsg-1.dsc
 dc6eac27864ee4695e96ab45f8100bb6 529948 libdevel optional amd-aie-rt_2026.1.1+dfsg.orig.tar.xz
 b9797bf6c11ee4ad865555f46561d5da 10268 libdevel optional amd-aie-rt_2026.1.1+dfsg-1.debian.tar.xz
 6a624bad0b577d621fdeedaf67b4d9a5 12724 libdevel optional amd-aie-rt_2026.1.1+dfsg-1_arm64.buildinfo
 1611e570d78ff3344026998ba8acb02b 37864 libdevel optional libxaiefal-dev_2026.1.1+dfsg-1_arm64.deb
 5959e99d8361ae92c73481bf6d10001b 84240 libdevel optional libxaiengine-dev_2026.1.1+dfsg-1_arm64.deb
 7e904392e2f735bb1b263ef64231d37d 428784 debug optional libxaiengine3-dbgsym_2026.1.1+dfsg-1_arm64.deb
 bbe0a9a30de76c02dfe61d3d3ce39cd7 135492 libs optional libxaiengine3_2026.1.1+dfsg-1_arm64.deb
 05a316946afd04dae0eafaad7f712f47 291396 doc optional xaiefal-doc_2026.1.1+dfsg-1_all.deb
 5de82b804be8d6e0518e6bb7e420bc1e 2100476 debug optional xaiefal-examples-dbgsym_2026.1.1+dfsg-1_arm64.deb
 8c380690a5e19261987268886cb76a17 95264 utils optional xaiefal-examples_2026.1.1+dfsg-1_arm64.deb
 5fd5b1227e303d4472980bc093e2fad8 5872888 debug optional xaiefal-tests-dbgsym_2026.1.1+dfsg-1_arm64.deb
 ff036b1a7b68d43d90d85a917ab16b29 208128 utils optional xaiefal-tests_2026.1.1+dfsg-1_arm64.deb
-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEECwtuSU6dXvs5GA2aLRkspiR3AnYFAmrM65UACgkQLRkspiR3
AnapHBAAgZMwPco2PUxMCBXqH4eXWf08ZkQ5ena6gpfoxA7AeZLWEidmDryCaH0S
b1EaZAMuG5aLaYXGsvIyxhJJYo4ki4Y1iQqiNqmsc1xCmaykhpyt+BbExOzRbELU
bly3DABJWQtvE4gpYZh3EWjnpUF/LUh4ysOzLuBZu2gcZEm1al8CyGtjdCXuOf3Y
uDxIzaF1KpE/ow3YO+ffqmST/rcvNAD/C1rtxa4Nawvduil1z8L+vu9SiwPwkwHn
M7BRB34y7C0t0g7khqNjwFrkOtHLJNirAggzKLILvGyEbPDcS/Qay9Qb6LnRmKq0
lTABe1l9/hhb8OAGA1gZ5C9xcxeYDAWw0QGERKaARA1L5VJShDOBMZtttMe1xtaw
0tSHvlVcwSUk+9o8d57l1lJcC3n4/D2SkY8C4/OkwbT8BaCTYA2IeZLqQH1dCG21
4SiYbSID+g9bwfT5WIaCs1A8CduwaxPEaAH38RXiRVTI2WbGxq+6J48v+qgSLohh
PLNoDIUK2TDTYQl3QUGmRyQD8aB2xw23iWChFBFEnzNlUZVNWe7ILK4l4E+Ae8T8
w2YkWDqG7DqxB1AXgVXCebtm0FqUV0+niYw2jWjMTkqYyd7896XtKlDsahTeeQd1
F1lZllNOlRvL2PF/j/90h4u8F4P6M6nzGckLlVMu64wD1kA4ONA=
=M7oj
-----END PGP SIGNATURE-----