ARM-Thumb Lab GNU-based Assembly (Instruction Set)

OperationAssemblyActionUpdatesNotes
Move8-bit immediatemov Rd, #imm8Rd ← imm8NZRd: r0..r7; imm8: 0…255
Low registersmov Rd, RmRd ← RmNZRd: r0..r7; Rm: r0..r7
High register involvedmov Rd, RmRd ← Rm—Rd: r0..r15; Rm: r0..r15
At least one of Rd, Rm: r8…r15.
Add3-bit immediateadd Rd, Rn, #imm3Rd ← Rn + imm3NZCVRd: r0..r7; Rn: r0..r7; imm3: 0…7
8-bit immediateadd Rd, Rd, #imm8add Rd, #imm8Rd ← Rd + imm8NZCVRd: r0..r7; imm8: 0…255
Low registersadd Rd, Rn, Rmadd Rd, RmRd ← Rn + RmNZCVRd: r0..r7; Rn: r0..r7; Rm: r0..r7
High register involvedadd Rd, Rd, Rmadd Rd, Rmadd Rd, Rm, RdRd ← Rd + Rm—Rd: r0..r15; Rm: r0..r15
At least one of Rd, Rm: r8…r15.
Adjust SPadd SP, SP, #immadd SP, #immSP ← SP + imm—SP: sp/r13; imm: 0…508, multiple of 4
Address from SPadd Rd, SP, #immRd ← SP + imm—Rd: r0..r7; SP: sp/r13; imm: 0…1020, multiple of 4
Subtract3-bit immediatesub Rd, Rn, #imm3Rd ← Rn - imm3NZCVRd: r0..r7; Rn: r0..r7; imm3: 0…7
8-bit immediatesub Rd, Rd, #imm8sub Rd, #imm8Rd ← Rd - imm8NZCVRd: r0..r7; imm8: 0…255
Low registerssub Rd, Rn, Rmsub Rd, RmRd ← Rn - RmNZCVRd: r0..r7; Rn: r0..r7; Rm: r0..r7
Adjust SPsub SP, SP, #immsub SP, #immSP ← SP - imm—SP: sp/r13; imm: 0…508, multiple of 4
Negateneg Rd, RmRd ← -RmNZCVRd: r0..r7; Rm: r0..r7
MultiplyMultiplymul Rd, Rmmul Rd, Rm, Rdmul Rd, Rd, RmRd ← Rm * RdNZRd: r0..r7; Rm: r0..r7
CompareLow registerscmp Rn, RmUpdate flags from Rn - RmNZCVRn: r0..r7; Rm: r0..r7
High register involvedcmp Rn, RmUpdate flags from Rn - RmNZCVRn: r0..r15; Rm: r0..r15
At least one of Rn, Rm: r8…r15.
8-bit immediatecmp Rn, #imm8Update flags from Rn - imm8NZCVRn: r0..r7; imm8: 0…255
Compare negativecmn Rn, RmUpdate flags from Rn + RmNZCVRn: r0..r7; Rm: r0..r7
LogicANDand Rd, Rmand Rd, Rd, Rmand Rd, Rm, RdRd ← Rd AND RmNZRd: r0..r7; Rm: r0..r7
AND NOT (clear bits)bic Rd, RmRd ← Rd AND NOT RmNZRd: r0..r7; Rm: r0..r7
ORorr Rd, Rmorr Rd, Rd, Rmorr Rd, Rm, RdRd ← Rd OR RmNZRd: r0..r7; Rm: r0..r7
Exclusive OReor Rd, Rmeor Rd, Rd, Rmeor Rd, Rm, RdRd ← Rd XOR RmNZRd: r0..r7; Rm: r0..r7
NOTmvn Rd, RmRd ← NOT RmNZRd: r0..r7; Rm: r0..r7
Test bitstst Rn, RmUpdate flags from Rn AND RmNZRn: r0..r7; Rm: r0..r7
ShiftLogical shift left (immediate)lsl Rd, Rm, #shiftRd ← Rm << ShiftNZCRd: r0..r7; Rm: r0..r7; shift: 0…31
Logical shift left (immediate, short form)lsl Rd, #shiftRd ← Rd << ShiftNZCRd: r0..r7; shift: 0…31
Logical shift left (register)lsl Rd, Rd, Rslsl Rd, RsRd ← Rd << Rs[7:0]NZCRd: r0..r7; Rs: r0..r7
Logical shift right (immediate)lsr Rd, Rm, #shiftRd ← Rm >>l ShiftNZCRd: r0..r7; Rm: r0..r7; shift: 0…31*
Logical shift right (immediate, short form)lsr Rd, #shiftRd ← Rd >>l ShiftNZCRd: r0..r7; shift: 0…31*
Logical shift right (register)lsr Rd, Rd, Rslsr Rd, RsRd ← Rd >>l Rs[7:0]NZCRd: r0..r7; Rs: r0..r7
Arithmetic shift right (immediate)asr Rd, Rm, #shiftRd ← Rm >>a ShiftNZCRd: r0..r7; Rm: r0..r7; shift: 0…31*
Arithmetic shift right (immediate, short form)asr Rd, #shiftRd ← Rd >>a ShiftNZCRd: r0..r7; shift: 0…31*
Arithmetic shift right (register)asr Rd, Rd, Rsasr Rd, RsRd ← Rd >>a Rs[7:0]NZCRd: r0..r7; Rs: r0..r7
Rotate right (register)ror Rd, Rd, Rsror Rd, RsRd ← Rd ROR Rs[7:0]NZCRd: r0..r7; Rs: r0..r7
LoadLoad a word (register indirect)ldr Rd, [Rn]Rd ← [Rn]—Rd: r0..r7; Rn: r0..r7
Load a word (register indirect with immediate offset)ldr Rd, [Rn, #imm]Rd ← [Rn + imm]—Rd: r0..r7; Rn: r0..r7; imm: 0…124, multiple of 4
Load a word (register indirect with register offset)ldr Rd, [Rn, Rm]Rd ← [Rn + Rm]—Rd: r0..r7; Rn: r0..r7; Rm: r0..r7
Load a word (PC-relative)ldr Rd, [PC, #imm]Rd ← [PC + imm]—Rd: r0..r7; PC: pc/r15; imm: 0…1020, multiple of 4
Load a word (SP-relative)ldr Rd, [SP, #imm]Rd ← [SP + imm]—Rd: r0..r7; SP: sp/r13; imm: 0…1020, multiple of 4
Load the value of a constant expression
Pseudoinstruction
ldr Rd, =exprRd ← value of expr—Rd: r0…r7. Supports the same sums and differences of numbers, character literals, constants and labels as .equ; parentheses and other operators are not supported. Example: ldr r0, =label + 8 loads the address of label plus 8 bytes. Loads a constant or the numeric value represented by a label into Rd. Example: ldr r0, =label loads the address of label, not the data stored there.
Load a halfword (register indirect with immediate offset)ldrh Rd, [Rn, #imm]Rd ← ZeroExtend([Rn + imm]15:0)—Rd: r0..r7; Rn: r0..r7; imm: 0…62, multiple of 2
Load a halfword (register indirect with register offset)ldrh Rd, [Rn, Rm]Rd ← ZeroExtend([Rn + Rm]15:0)—Rd: r0..r7; Rn: r0..r7; Rm: r0..r7
Load a byte (register indirect with immediate offset)ldrb Rd, [Rn, #imm]Rd ← ZeroExtend([Rn + imm]7:0)—Rd: r0..r7; Rn: r0..r7; imm: 0…31
Load a byte (register indirect with register offset)ldrb Rd, [Rn, Rm]Rd ← ZeroExtend([Rn + Rm]7:0)—Rd: r0..r7; Rn: r0..r7; Rm: r0..r7
Load a signed halfword (register indirect with register offset)ldrsh Rd, [Rn, Rm]Rd ← SignExtend([Rn + Rm]15:0)—Rd: r0..r7; Rn: r0..r7; Rm: r0..r7
Load a signed byte (register indirect with register offset)ldrsb Rd, [Rn, Rm]Rd ← SignExtend([Rn + Rm]7:0)—Rd: r0..r7; Rn: r0..r7; Rm: r0..r7
StoreStore a word (register indirect)str Rs, [Rn][Rn] ← Rs—Rs: r0..r7; Rn: r0..r7
Store a word (register indirect with immediate offset)str Rs, [Rn, #imm][Rn + imm] ← Rs—Rs: r0..r7; Rn: r0..r7; imm: 0…124, multiple of 4
Store a word (register indirect with register offset)str Rs, [Rn, Rm][Rn + Rm] ← Rs—Rs: r0..r7; Rn: r0..r7; Rm: r0..r7
Store a word (SP-relative)str Rs, [SP, #imm][SP + imm] ← Rs—Rs: r0..r7; SP: sp/r13; imm: 0…1020, multiple of 4
Store a halfword (register indirect with immediate offset)strh Rs, [Rn, #imm][Rn + imm]15:0 ← Rs15:0—Rs: r0..r7; Rn: r0..r7; imm: 0…62, multiple of 2
Store a halfword (register indirect with register offset)strh Rs, [Rn, Rm][Rn + Rm]15:0 ← Rs15:0—Rs: r0..r7; Rn: r0..r7; Rm: r0..r7
Store a byte (register indirect with immediate offset)strb Rs, [Rn, #imm][Rn + imm]7:0 ← Rs7:0—Rs: r0..r7; Rn: r0..r7; imm: 0…31
Store a byte (register indirect with register offset)strb Rs, [Rn, Rm][Rn + Rm]7:0 ← Rs7:0—Rs: r0..r7; Rn: r0..r7; Rm: r0..r7
PushPush low-register contentspush {loreglist}Push the contents of the listed low registers onto the stack—Register list: r0..r7
Push low-register and LR contentspush {loreglist, lr}Push the contents of the listed low registers and LR onto the stack—Register list: r0..r7, lr
PopPop into low registerspop {loreglist}Load the listed low registers with values popped from the stack—Register list: r0..r7
Pop into low registers and PCpop {loreglist, pc}Load the listed low registers and PC with values popped from the stack, then branch to the address loaded into PC—Register list: r0..r7, pc
BranchBranch unconditionalb labelPC ← label—label: -1024…1023 (2-byte units, PC-relative)
Branch with link (32-bit)bl labelLR ← address of next instruction, PC ← label—label: -4194304…4194303 (2-byte units, PC-relative)
Branch if equalbeq labelIf Z = 1, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if not equalbne labelIf Z = 0, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if carry set (unsigned higher or same)bcs labelIf C = 1, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if carry clear (unsigned lower)bcc labelIf C = 0, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if negativebmi labelIf N = 1, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if positive or zerobpl labelIf N = 0, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if overflowbvs labelIf V = 1, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if no overflowbvc labelIf V = 0, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if unsigned higherbhi labelIf C = 1 and Z = 0, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if unsigned lower or samebls labelIf C = 0 or Z = 1, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if signed greater or equalbge labelIf N = V, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if signed less thanblt labelIf N ≠ V, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if signed greater thanbgt labelIf Z = 0 and N = V, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
Branch if signed less or equalble labelIf Z = 1 or N ≠ V, PC ← label—Branch range: −252 to +258 bytes from the current instruction.
ExtendSigned halfword to wordsxth Rd, RmRd31:0 ← SignExtend(Rm15:0)—Rd: r0..r7; Rm: r0..r7
Signed byte to wordsxtb Rd, RmRd31:0 ← SignExtend(Rm7:0)—Rd: r0..r7; Rm: r0..r7
Unsigned halfword to worduxth Rd, RmRd31:0 ← ZeroExtend(Rm15:0)—Rd: r0..r7; Rm: r0..r7
Unsigned byte to worduxtb Rd, RmRd31:0 ← ZeroExtend(Rm7:0)—Rd: r0..r7; Rm: r0..r7
WaitWait for interruptwfiWait for interrupt (ends execution in ATL)—
Used by the simulator as normal program termination.

* ATL and ARM Thumb: for immediate LSR and ASR, ATL currently accepts 0–31 and treats 0 as no shift. ARM Thumb defines shifts of 1–32 for these encodings; a zero in the encoded immediate field represents a shift of 32.