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.

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:

    

        
        aarch64

        
    

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
        
    

Download

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
        
    

Install

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.