Arm Instruction Emulator (armie)

Arm Instruction Emulator is a software tool that runs on 64-bit Arm platforms and emulates Scalable Vector Extension (SVE) . This tool allows you to run your compiled SVE application binaries on hardware that is not SVE-enabled. It does not require a license.

Arm Instruction Emulator runs as an executable on your Linux host. It runs on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu Linux distributions.

In this guide, you’ll learn how to install Arm Instruction Emulator.

Before you begin

Confirm you are using an Arm machine by running:

    

        
        
uname -m

    

The output should be:

    

        
        aarch64

        
    

If you see a different result, you are not using an Arm computer running 64-bit Linux.

You must also ensure that either Environment Modules or the Lmod Environment Module System are installed on your Linux machine. The GNU Compiler (GCC) is also required.

For Ubuntu Linux, install the following required packages.

    

        
        
sudo apt-get install build-essential -y
sudo apt-get install environment-modules -y

    

Download Arm Instruction Emulator

For Ubuntu Linux, download the installer package from Arm Instruction Emulator downloads .

Install Arm Instruction Emulator

To install the Arm Instruction Emulator, extract the downloaded package and run the install script.

Extract the downloaded package:

    

        
        
tar -xvzf ARMIE-BN-UBUNT-r25p0-00rel0.tgz

    

Run the install script:

    

        
        
sudo ./arm-instruction-emulator_25.0_Ubuntu-22.04/arm-instruction-emulator_25.0_Ubuntu-22.04.sh -a

    

Set up the environment, for example, in your .bashrc and add module files:

    

        
        
echo "source /usr/share/modules/init/bash" >> ~/.bashrc
echo "module use /opt/arm/modulefiles" >> ~/.bashrc
source ~/.bashrc

    

List available modules:

    

        
        
module avail

    

Configure Arm Compiler for Linux:

    

        
        
module load armie22/22.0

    

To confirm armie is installed, print the version:

    

        
        
armie --version

    

Get started with Arm Instruction Emulator

To verify everything is working after installation, see Get started with Arm Instruction Emulator for instructions on how to compile and run examples with armie. The examples demonstrate how to compile Scalable Vector Extension (SVE) code and run the resulting binary with Arm Instruction Emulator.

You are now ready to use the Arm Instruction Emulator.