AMI VFIO Userspace Driver (Experimental)

This guide describes how to build and test the experimental VFIO-based userspace driver for AMI.

Note: This feature is experimental and planned for release in 2026.2.

Prerequisites

Before installing the VFIO userspace driver, ensure your host has support for IOMMU groups.

Building the VFIO Userspace Driver

  1. Navigate to the AMI source directory:

    cd amr/sw/AMI

  2. Run the build script with VFIO option:

    ./script/build.sh -driver vfio

  3. Build artifacts: The build process creates a build_ami directory containing Debian and RPM packages.

Installation

Install the packages based on which distribution you are running:

Debian-based Distributions (Ubuntu, Debian)

sudo dpkg -i build_ami/*.deb

RPM-based Distributions (RHEL, CentOS, Fedora)

sudo rpm -ivh build_ami/*.rpm

Usage

All legacy ami_tool commands continue to work with the VFIO userspace driver without modification.

For detailed information on available commands and usage examples, refer to the AMR Management Interface (ami_tool) User Guide.

Feedback

This is an experimental feature. If you encounter issues or have feedback: