Emulator Installation

XCENA Emulator provides a virtual environment that allows you to run and test the SDK without physical XCENA hardware. It reproduces the behavior of the XCENA device and host system, enabling software development and debugging in a fully simulated setup.

Prerequisites

Refer to System requirements

1. Install from Emulator Package

Emulator package URL will be provided separately.

$ wget <URL_to_emulator_xxx.tar.xz>
$ tar xvf emulator_xxx.tar.xz
$ cd emulator_xxx
$ ./install.sh

2. Verify Installation

After installation, verify the emulator directory structure.

├── app
│   ├── malloc
│   ├── mlc
│   └── rwmem
├── bin
│   └── qemu_sim
├── cfg
│   └── cxl_socket
│       ├── vmem_32g
│       └── vmem_32g_ip
├── kernel
│   └── arch
│       └── x86
│           └── boot
│               └── bzImage
├── lib
│   ├── libmetisx_sim.so
│   └── libmetisx.so
├── LICENSE
├── qemu
│   └── install
│       └── bin
│           └── qemu-system-x86_64
├── README.md
├── rootfs
│   └── ubuntu
│       └── rootfs.img
├── run.sh
└── trace-events

2.1 Launch QEMU

$ run.sh

If XCENA emulator is successfully installed, this command launches a QEMU instance with the XCENA virtual device enabled.
For detailed usage instructions, refer to the Emulator Guide.

2.2 Verify SDK in QEMU

Navigate to the SDK directory and check the installation contents, following the same procedure as described in Verify Installation

$ cd ~/sdk
# Check SDK files

Next, confirm that the virtual XCENA device is detected correctly:

$ xcena_cli num-device
Number of devices : 1

You can now proceed with the Tutorials in QEMU.