ARM-Thumb Lab GNU-based Assembly (Instruction Set)
| Operation | Assembly | Action | Updates | Notes | |
|---|---|---|---|---|---|
| Move | 8-bit immediate | mov Rd, #imm8 | Rd ← imm8 | NZ | Rd: r0..r7; imm8: 0…255 |
| Low registers | mov Rd, Rm | Rd ← Rm | NZ | Rd: r0..r7; Rm: r0..r7 | |
| High register involved | mov Rd, Rm | Rd ← Rm | — | Rd: r0..r15; Rm: r0..r15 At least one of Rd, Rm: r8…r15. | |
| Add | 3-bit immediate | add Rd, Rn, #imm3 | Rd ← Rn + imm3 | NZCV | Rd: r0..r7; Rn: r0..r7; imm3: 0…7 |
| 8-bit immediate | add Rd, Rd, #imm8add Rd, #imm8 | Rd ← Rd + imm8 | NZCV | Rd: r0..r7; imm8: 0…255 | |
| Low registers | add Rd, Rn, Rmadd Rd, Rm | Rd ← Rn + Rm | NZCV | Rd: r0..r7; Rn: r0..r7; Rm: r0..r7 | |
| High register involved | add Rd, Rd, Rmadd Rd, Rmadd Rd, Rm, Rd | Rd ← Rd + Rm | — | Rd: r0..r15; Rm: r0..r15 At least one of Rd, Rm: r8…r15. | |
| Adjust SP | add SP, SP, #immadd SP, #imm | SP ← SP + imm | — | SP: sp/r13; imm: 0…508, multiple of 4 | |
| Address from SP | add Rd, SP, #imm | Rd ← SP + imm | — | Rd: r0..r7; SP: sp/r13; imm: 0…1020, multiple of 4 | |
| Subtract | 3-bit immediate | sub Rd, Rn, #imm3 | Rd ← Rn - imm3 | NZCV | Rd: r0..r7; Rn: r0..r7; imm3: 0…7 |
| 8-bit immediate | sub Rd, Rd, #imm8sub Rd, #imm8 | Rd ← Rd - imm8 | NZCV | Rd: r0..r7; imm8: 0…255 | |
| Low registers | sub Rd, Rn, Rmsub Rd, Rm | Rd ← Rn - Rm | NZCV | Rd: r0..r7; Rn: r0..r7; Rm: r0..r7 | |
| Adjust SP | sub SP, SP, #immsub SP, #imm | SP ← SP - imm | — | SP: sp/r13; imm: 0…508, multiple of 4 | |
| Negate | neg Rd, Rm | Rd ← -Rm | NZCV | Rd: r0..r7; Rm: r0..r7 | |
| Multiply | Multiply | mul Rd, Rmmul Rd, Rm, Rdmul Rd, Rd, Rm | Rd ← Rm * Rd | NZ | Rd: r0..r7; Rm: r0..r7 |
| Compare | Low registers | cmp Rn, Rm | Update flags from Rn - Rm | NZCV | Rn: r0..r7; Rm: r0..r7 |
| High register involved | cmp Rn, Rm | Update flags from Rn - Rm | NZCV | Rn: r0..r15; Rm: r0..r15 At least one of Rn, Rm: r8…r15. | |
| 8-bit immediate | cmp Rn, #imm8 | Update flags from Rn - imm8 | NZCV | Rn: r0..r7; imm8: 0…255 | |
| Compare negative | cmn Rn, Rm | Update flags from Rn + Rm | NZCV | Rn: r0..r7; Rm: r0..r7 | |
| Logic | AND | and Rd, Rmand Rd, Rd, Rmand Rd, Rm, Rd | Rd ← Rd AND Rm | NZ | Rd: r0..r7; Rm: r0..r7 |
| AND NOT (clear bits) | bic Rd, Rm | Rd ← Rd AND NOT Rm | NZ | Rd: r0..r7; Rm: r0..r7 | |
| OR | orr Rd, Rmorr Rd, Rd, Rmorr Rd, Rm, Rd | Rd ← Rd OR Rm | NZ | Rd: r0..r7; Rm: r0..r7 | |
| Exclusive OR | eor Rd, Rmeor Rd, Rd, Rmeor Rd, Rm, Rd | Rd ← Rd XOR Rm | NZ | Rd: r0..r7; Rm: r0..r7 | |
| NOT | mvn Rd, Rm | Rd ← NOT Rm | NZ | Rd: r0..r7; Rm: r0..r7 | |
| Test bits | tst Rn, Rm | Update flags from Rn AND Rm | NZ | Rn: r0..r7; Rm: r0..r7 | |
| Shift | Logical shift left (immediate) | lsl Rd, Rm, #shift | Rd ← Rm << Shift | NZC | Rd: r0..r7; Rm: r0..r7; shift: 0…31 |
| Logical shift left (immediate, short form) | lsl Rd, #shift | Rd ← Rd << Shift | NZC | Rd: r0..r7; shift: 0…31 | |
| Logical shift left (register) | lsl Rd, Rd, Rslsl Rd, Rs | Rd ← Rd << Rs[7:0] | NZC | Rd: r0..r7; Rs: r0..r7 | |
| Logical shift right (immediate) | lsr Rd, Rm, #shift | Rd ← Rm >>l Shift | NZC | Rd: r0..r7; Rm: r0..r7; shift: 0…31* | |
| Logical shift right (immediate, short form) | lsr Rd, #shift | Rd ← Rd >>l Shift | NZC | Rd: r0..r7; shift: 0…31* | |
| Logical shift right (register) | lsr Rd, Rd, Rslsr Rd, Rs | Rd ← Rd >>l Rs[7:0] | NZC | Rd: r0..r7; Rs: r0..r7 | |
| Arithmetic shift right (immediate) | asr Rd, Rm, #shift | Rd ← Rm >>a Shift | NZC | Rd: r0..r7; Rm: r0..r7; shift: 0…31* | |
| Arithmetic shift right (immediate, short form) | asr Rd, #shift | Rd ← Rd >>a Shift | NZC | Rd: r0..r7; shift: 0…31* | |
| Arithmetic shift right (register) | asr Rd, Rd, Rsasr Rd, Rs | Rd ← Rd >>a Rs[7:0] | NZC | Rd: r0..r7; Rs: r0..r7 | |
| Rotate right (register) | ror Rd, Rd, Rsror Rd, Rs | Rd ← Rd ROR Rs[7:0] | NZC | Rd: r0..r7; Rs: r0..r7 | |
| Load | Load 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, =expr | Rd ← 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 | |
| Store | Store 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 | |
| Push | Push low-register contents | push {loreglist} | Push the contents of the listed low registers onto the stack | — | Register list: r0..r7 |
| Push low-register and LR contents | push {loreglist, lr} | Push the contents of the listed low registers and LR onto the stack | — | Register list: r0..r7, lr | |
| Pop | Pop into low registers | pop {loreglist} | Load the listed low registers with values popped from the stack | — | Register list: r0..r7 |
| Pop into low registers and PC | pop {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 | |
| Branch | Branch unconditional | b label | PC ← label | — | label: -1024…1023 (2-byte units, PC-relative) |
| Branch with link (32-bit) | bl label | LR ← address of next instruction, PC ← label | — | label: -4194304…4194303 (2-byte units, PC-relative) | |
| Branch if equal | beq label | If Z = 1, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if not equal | bne label | If Z = 0, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if carry set (unsigned higher or same) | bcs label | If C = 1, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if carry clear (unsigned lower) | bcc label | If C = 0, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if negative | bmi label | If N = 1, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if positive or zero | bpl label | If N = 0, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if overflow | bvs label | If V = 1, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if no overflow | bvc label | If V = 0, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if unsigned higher | bhi label | If C = 1 and Z = 0, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if unsigned lower or same | bls label | If C = 0 or Z = 1, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if signed greater or equal | bge label | If N = V, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if signed less than | blt label | If N ≠ V, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if signed greater than | bgt label | If Z = 0 and N = V, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Branch if signed less or equal | ble label | If Z = 1 or N ≠ V, PC ← label | — | Branch range: −252 to +258 bytes from the current instruction. | |
| Extend | Signed halfword to word | sxth Rd, Rm | Rd31:0 ← SignExtend(Rm15:0) | — | Rd: r0..r7; Rm: r0..r7 |
| Signed byte to word | sxtb Rd, Rm | Rd31:0 ← SignExtend(Rm7:0) | — | Rd: r0..r7; Rm: r0..r7 | |
| Unsigned halfword to word | uxth Rd, Rm | Rd31:0 ← ZeroExtend(Rm15:0) | — | Rd: r0..r7; Rm: r0..r7 | |
| Unsigned byte to word | uxtb Rd, Rm | Rd31:0 ← ZeroExtend(Rm7:0) | — | Rd: r0..r7; Rm: r0..r7 | |
| Wait | Wait for interrupt | wfi | Wait 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.