🇫🇷 | 🇬🇧 | 🇩🇪 | 🇪🇸 | 🇵🇹 | 🇮🇹 | 🇳🇱 | 🇵🇱 | 🇷🇺 | 🇨🇳 | 🇯🇵 | 🇰🇷
Installation Guide
Complete guide to install the AMD XDNA driver and get the NPU working on Framework Laptop 13 with Debian 13.
Hardware Specifications
AMD Ryzen AI 9 HX 370 Processor
| Specification | Details |
|---|---|
| Architecture | Zen 5 (4 cores) + Zen 5c (8 cores) |
| Threads | 24 |
| Integrated GPU | Radeon 890M (16 CUs RDNA 3.5) |
| NPU | XDNA 2 (Strix) - 50 TOPS |
| TDP | 28W |
NPU (Neural Processing Unit)
| Specification | Details |
|---|---|
| Architecture | AMD XDNA 2 |
| Code name | Strix |
| Performance | 50 TOPS (INT8) |
| PCI ID | c2:00.1 |
Prerequisites
Verify NPU Detection
lspci | grep -i "Processing"
Expected output:
c2:00.1 Signal processing controller: Advanced Micro Devices, Inc. [AMD] Strix/Krackan/Strix Halo Neural Processing Unit (rev 10)
Install Build Tools
sudo apt update
sudo apt install linux-headers-$(uname -r) build-essential git dkms \
libcurl4-openssl-dev libtbb-dev pybind11-dev python3-pybind11
Step 1: Clone xdna-driver Repository
cd ~/sources
git clone https://github.com/amd/xdna-driver.git
cd xdna-driver
git submodule update --init --recursive
Step 2: Install Dependencies
sudo ./tools/amdxdna_deps.sh
Step 3: Build XRT (Xilinx Runtime)
cd xrt/build
./build.sh -npu -opt
Step 4: Install XRT Packages
sudo apt reinstall ./Release/xrt_*-amd64-base.deb ./Release/xrt_*-amd64-npu.deb
Step 5: Build XDNA Driver
cd ~/sources/xdna-driver/build
./build.sh -release
Step 6: Install XDNA Plugin
sudo apt reinstall ./Release/xrt_plugin.*-x86_64-amdxdna.deb
Post-Installation Configuration
Increase Locked Memory Limit
sudo sh -c 'echo "* soft memlock unlimited" >> /etc/security/limits.conf'
sudo sh -c 'echo "* hard memlock unlimited" >> /etc/security/limits.conf'
Reboot to apply changes.
Configure XRT Environment
echo 'source /opt/xilinx/xrt/setup.sh' >> ~/.bashrc
Verification
source /opt/xilinx/xrt/setup.sh
xrt-smi examine
xrt-smi validate
| ← Home | Troubleshooting → |