Verify Setup

Before running any XCENA SDK examples, verify that the XCENA device is properly recognized by the system.

Note After completing the Installation, following steps work identically on both real hardware and QEMU emulator environments.

Run Validation Script

Download and run validate_host.sh to check your host environment:

wget https://raw.githubusercontent.com/metisx-dev/public_sdk_release/refs/heads/main/scripts/validate_host.sh
bash validate_host.sh

Example Output 

  XCENA Host Environment Validation
  2026-02-12 09:21:03

--- System Environment ----------------------
  [ INFO ] OS            Ubuntu 24.04.3 LTS
  [ INFO ] Kernel        6.17.0-14-generic
  [ INFO ] Environment   Native

--- PCI / Hardware --------------------------
  [  OK  ] XCENA PCI device detected
           01:00.0 CXL [0502]: Device [20a6:0100] (rev 01)
           11:00.0 CXL [0502]: Device [20a6:0100] (rev 01)

--- CXL / DAX -------------------------------
  [  OK  ] cxl command found
  [  OK  ] daxctl command found
  [  OK  ] CEDT ACPI table present
  [  OK  ] CXL kernel modules loaded
  [  OK  ] CXL region detected
           region0  size=229.0 GB  type=ram  state=commit
           region1  size=229.0 GB  type=ram  state=commit
  [  OK  ] DAX device found
           dax0.0  perm=666  size=229.0 GB  mode=devdax
           dax1.0  perm=666  size=229.0 GB  mode=devdax

--- Driver ----------------------------------
  [  OK  ] mx_dma module loaded
  [  OK  ] /dev/mx_dma/ devices found
  [  OK  ] /dev/mx_dma/ device permissions OK

--- PXL Library -----------------------------
  [  OK  ] libpxl installed (v2.0.0)
  [  OK  ] pxl_resourced service active
  [  OK  ] pxl_resourced service enabled

--- CLI & Tools -----------------------------
  [  OK  ] xcena_cli found
  [  OK  ] Number of devices : 2
           [0] mx1p  BDF=0000:01:00.0  computable=True
           [1] mx1p  BDF=0000:11:00.0  computable=True
  [  OK  ] xtop found

--- MU Toolchain ----------------------------
  [  OK  ] MU library installed
  [ WARN ] MU LLVM installed (21.1.2/r4)

Validation Categories

System Environment

  • Host OS distribution and version, Linux kernel version, and execution environment type (Native or Docker).
  • Ensures the system meets the minimum platform requirements for the SDK.

PCI / Hardware

  • Detects XCENA CXL Type 3 devices on the PCIe bus via lspci.
  • At least one device must be present for the SDK to operate.

CXL / DAX

  • Verifies CXL userspace utilities (cxl, daxctl) and CEDT ACPI table presence.
  • Checks CXL kernel module loading and CXL region commitment.
  • Validates DAX device availability with correct permissions.

Driver

  • Checks that the mx_dma kernel module is loaded.
  • Verifies /dev/mx_dma/ character device nodes are created with proper permissions for DMA communication.

PXL Library

  • Confirms the PXL shared library is installed.
  • Verifies the pxl_resourced resource management daemon is active (running) and enabled (auto-start on boot).

CLI & Tools

  • Verifies that xcena_cli can enumerate connected devices.
  • Checks that monitoring tools such as xtop are available in the system PATH.

MU Toolchain

  • Checks installation of the MU firmware library.
  • Verifies the MU LLVM cross-compiler toolchain required for building device-side MU kernel binaries.

Tip All items should show [ OK ] or [ INFO ]. If any item shows [ FAIL ], refer to the Troubleshooting guide.