About this Install Guide

This guide is intended to get you up and running with this tool quickly with the most common settings. For a thorough review of all options, refer to the official documentation.

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.

SVE hardware

AWS Graviton 3 and Graviton 4 processors are available and recommended for SVE application development.

Before you begin

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

Confirm you are using an Arm machine by running:


            uname -m

The output should be:




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

You must 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 required packages.


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


You can download the appropriate Arm Instruction Emulator package for your host Linux platform from Product Downloads section of the Arm website.

For Ubuntu Linux download the installer package using wget


            wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-instruction-emulator/22-0/ARM-Instruction-Emulator_22.0_AArch64_Ubuntu_18.04.tar.gz


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

Extract the downloaded package.


            tar xf ARM-Instruction-Emulator_22.0_AArch64_Ubuntu_18.04.tar.gz
cd arm-instruction-emulator_22.0_Ubuntu-18.04

Run the install script.


            sudo ./arm-instruction-emulator_22.0_Ubuntu-18.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

To list available modules:


            module avail

To configure Arm Compiler for Linux:


            module load armie22/22.0

To confirm armie is installed, print the version.


            armie --version

Setting up product license

Arm Instruction Emulator does not require a license.

Get started

To verify everything is working after installation refer to Get started with Arm Instruction Emulator for instructions on how to compile and run examples with armie.

This uses a couple of simple examples to demonstrate how to compile Scalable Vector Extension (SVE) code and run the resulting binary with Arm Instruction Emulator.

You are ready to use the Arm Instruction Emulator.


How would you rate the overall quality of this tool quick-install guide?