MSR (register)

Move general-purpose register to Special register moves selected bits of a general-purpose register to the APSR, CPSR or SPSR_<current_mode>.

Because of the Do-Not-Modify nature of its reserved bits, a read-modify-write sequence is normally required when the MSR instruction is being used at Application level and its destination is not APSR_nzcvq (CPSR_f).

If an MSR (register) moves selected bits of an immediate value to the CPSR, the PE checks whether the value being written to PSTATE.M is legal. See Illegal changes to PSTATE.M.

An MSR (register) executed in User mode:

An MSR (register) executed in System mode is unpredictable if it attempts to update the SPSR.

The CPSR.E bit is writable from any mode using an MSR instruction. Arm deprecates using this to change its value.

It has encodings from the following instruction sets: A32 ( A1 ) and T32 ( T1 ) .

A1

313029282726252423222120191817161514131211109876543210
!= 111100010R10mask(1)(1)(1)(1)(0)(0)0(0)0000Rn
cond

Encoding for the A1 variant

MSR{<c>}{<q>} <spec_reg>, <Rn>

Decode for this encoding

constant n = UInt(Rn); constant write_spsr = (R == '1'); if mask == '0000' then UNPREDICTABLE; if n == 15 then UNPREDICTABLE;

CONSTRAINED UNPREDICTABLE behavior

If mask == '0000', then one of the following behaviors must occur:

T1

15141312111098765432101514131211109876543210
11110011100RRn10(0)0mask(0)(0)0(0)(0)(0)(0)(0)

Encoding for the T1 variant

MSR{<c>}{<q>} <spec_reg>, <Rn>

Decode for this encoding

constant n = UInt(Rn); constant write_spsr = (R == '1'); if mask == '0000' then UNPREDICTABLE; // Armv8-A removes UNPREDICTABLE for R13 if n == 15 then UNPREDICTABLE;

CONSTRAINED UNPREDICTABLE behavior

If mask == '0000', then one of the following behaviors must occur:

For more information about the constrained unpredictable behavior of this instruction, see Architectural Constraints on UNPREDICTABLE behaviors.

Assembler Symbols

<c>

See Standard assembler syntax fields.

<q>

See Standard assembler syntax fields.

<spec_reg>

Is one of:

  • APSR_<bits>.
  • CPSR_<fields>.
  • SPSR_<fields>.

For CPSR and SPSR, <fields> is a sequence of one or more of the following:

c
mask<0> = '1' to enable writing of bits<7:0> of the destination PSR.
x
mask<1> = '1' to enable writing of bits<15:8> of the destination PSR.
s
mask<2> = '1' to enable writing of bits<23:16> of the destination PSR.
f
mask<3> = '1' to enable writing of bits<31:24> of the destination PSR.

For APSR, <bits> is one of nzcvq, g, or nzcvqg. These map to the following CPSR_<fields> values:

  • APSR_nzcvq is the same as CPSR_f (mask== '1000').
  • APSR_g is the same as CPSR_s (mask == '0100').
  • APSR_nzcvqg is the same as CPSR_fs (mask == '1100').

Arm recommends the APSR_<bits> forms when only the N, Z, C, V, Q, and GE[3:0] bits are being written. For more information, see The Application Program Status Register, APSR.

<Rn>

Is the general-purpose source register, encoded in the "Rn" field.

Operation

if ConditionPassed() then EncodingSpecificOperations(); if write_spsr then if PSTATE.M IN {M32_User,M32_System} then UNPREDICTABLE; else SPSRWriteByInstr(R[n], mask); else // Attempts to change to an illegal mode will invoke the Illegal Execution state mechanism CPSRWriteByInstr(R[n], mask);

CONSTRAINED UNPREDICTABLE behavior

If write_spsr && PSTATE.M IN {M32_User,M32_System}, then one of the following behaviors must occur:


Internal version only: isa v01_32, pseudocode v2024-12_rel ; Build timestamp: 2024-12-16T10:54

Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. This document is Non-Confidential.