Installation

What’s Included

SDK Package

SDK package contains everything you need to develop applications for XCENA hardware:

  • PXL Runtime Library: Core library for host-device communication
  • MU Kernel Compiler: Toolchain for building compute kernels
  • Device Driver: Linux kernel module for hardware access
  • CLI Tools: Command-line utilities for device management and debugging
  • Examples & Templates: Sample applications and project templates

Emulator Package

Emulator package provides a fully virtual environment where all SDK features can be used without physical hardware.

  • QEMU-based Environment: Complete virtual environment that reproduces XCENA device behavior
  • Identical SDK Interface: Same APIs and tools work seamlessly in both real hardware and emulated environments
  • No Hardware Required: Start developing XCENA applications immediately

Docker Image

A preconfigured Docker image is also available, offering:

  • All-in-One Environment: SDK and emulator components pre-installed
  • Cross-Platform Support: Works on any system with Docker
  • Isolated Development: Consistent, reproducible environment

System requirements

  • OS: Ubuntu 24.04.3 LTS
  • Required APT packages
      build-essential cmake ninja-build wget
      python3-dev python3-pip python3-venv libncurses6
      libglib2.0-0 libslirp0 liburing2 libcurl3-gnutls
    
  • Required Python packages
      numpy tomli capstone cxxfilt pyelftools
    
  • Docker: Optional, recommended for consistent build environments

Note
For non-Ubuntu systems, it is recommended to use the official Docker image to ensure full compatibility.


Table of contents