6.60.16. MIPS SIMD Architecture (MSA) Support

6.60.16 MIPS SIMD Architecture (MSA) Support

GCC provides intrinsics to access the SIMD instructions provided by the MSA MIPS SIMD Architecture. The interface is made available by including <msa.h> and using -mmsa -mhard-float -mfp64 -mnan=2008. For each __builtin_msa_*, there is a shortened name of the intrinsic, __msa_*.

MSA implements 128-bit wide vector registers, operating on 8-, 16-, 32- and 64-bit integer, 16- and 32-bit fixed-point, or 32- and 64-bit floating point data elements. The following vectors typedefs are included in msa.h:

• v16i8, a vector of sixteen signed 8-bit integers;
• v16u8, a vector of sixteen unsigned 8-bit integers;
• v8i16, a vector of eight signed 16-bit integers;
• v8u16, a vector of eight unsigned 16-bit integers;
• v4i32, a vector of four signed 32-bit integers;
• v4u32, a vector of four unsigned 32-bit integers;
• v2i64, a vector of two signed 64-bit integers;
• v2u64, a vector of two unsigned 64-bit integers;
• v4f32, a vector of four 32-bit floats;
• v2f64, a vector of two 64-bit doubles.

Instructions and corresponding built-ins may have additional restrictions and/or input/output values manipulated:

• imm0_1, an integer literal in range 0 to 1;
• imm0_3, an integer literal in range 0 to 3;
• imm0_7, an integer literal in range 0 to 7;
• imm0_15, an integer literal in range 0 to 15;
• imm0_31, an integer literal in range 0 to 31;
• imm0_63, an integer literal in range 0 to 63;
• imm0_255, an integer literal in range 0 to 255;
• imm_n16_15, an integer literal in range -16 to 15;
• imm_n512_511, an integer literal in range -512 to 511;
• imm_n1024_1022, an integer literal in range -512 to 511 left shifted by 1 bit, i.e., -1024, -1022, …, 1020, 1022;
• imm_n2048_2044, an integer literal in range -512 to 511 left shifted by 2 bits, i.e., -2048, -2044, …, 2040, 2044;
• imm_n4096_4088, an integer literal in range -512 to 511 left shifted by 3 bits, i.e., -4096, -4088, …, 4080, 4088;
• imm1_4, an integer literal in range 1 to 4;
• i32, i64, u32, u64, f32, f64, defined as follows:

{
typedef int i32;
#if __LONG_MAX__ == __LONG_LONG_MAX__
typedef long i64;
#else
typedef long long i64;
#endif

typedef unsigned int u32;
#if __LONG_MAX__ == __LONG_LONG_MAX__
typedef unsigned long u64;
#else
typedef unsigned long long u64;
#endif

typedef double f64;
typedef float f32;
}

Next: Other MIPS Built-in Functions, Previous: MIPS Loongson Built-in Functions, Up: Target Builtins [Contents][Index]