collab/polyglot-riscv-arm
what if the same machine code was valid riscv and arm asm
git clone https://git.julia.blue/collab/polyglot-riscv-arm
885cc4e
main
1< ?xml version="1.0" encoding="utf-8"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" > 3< html xmlns ="http://www.w3.org/1999/xhtml ">< head >< link rel ="stylesheet "type ="text/css "href ="insn.css "/>< meta name ="generator "content ="iform.xsl "/>< title > SUB, SUBS (immediate) -- AArch32</ title ></ head >< body >< table style ="margin: 0 auto; ">< tr >< td >< div class ="topbar ">< a href ="index.html "> Base Instructions</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="fpsimdindex.html "> SIMD&FP Instructions</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="a32_encindex.html "> A32 Instructions by Encoding</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="t32_encindex.html "> T32 Instructions by Encoding</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="shared_pseudocode.html "> Shared Pseudocode</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="notice.html "> Proprietary Notice</ a ></ div ></ td ></ tr ></ table >< hr />< h2 class ="instruction-section "> SUB, SUBS (immediate)</ h2 > 4< p class ="aml "> Subtract (immediate) subtracts an immediate value from a register value, and writes the result to the destination register.</ p > 5< p class ="aml "> If the destination register is not the PC, the SUBS variant of the instruction updates the condition flags based on the result.</ p > 6< p class ="aml "> The field descriptions for <Rd> identify the encodings where the PC is permitted as the destination register. If the destination register is the PC:</ p > 7< ul > 8< li > The SUB variant of the instruction is an interworking branch, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BEICJFEH "> Pseudocode description of operations on the AArch32 general-purpose registers and the PC</ a > .</ li > 9< li > The SUBS variant of the instruction performs an exception return without the use of the stack. In this case:< ul >< li > The PE branches to the address written to the PC, and restores< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BEIDIGBH "> PSTATE</ a > from SPSR_<current_mode>.</ li >< li > The PE checks SPSR_<current_mode> for an illegal return event. See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="CHDDDJDB "> Illegal return events from AArch32 state</ a > .</ li >< li > The instruction is< span class ="arm-defined-word "> undefined</ span > in Hyp mode, except for encoding T5 with <imm8> set to zero, which is the encoding for the< span class ="asm-code "> ERET</ span > instruction, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.ERET "> ERET</ a > .</ li >< li > The instruction is< span class ="arm-defined-word "> constrained unpredictable</ span > in User mode and System mode.</ li ></ ul ></ li > 10</ ul > 11 12< p class ="desc "> 13 It has encodings from the following instruction sets: 14 A32 ( 15< a href ="#iclass_a1 "> A1</ a > 16 ) 17 and 18 T32 ( 19< a href ="#iclass_t1 "> T1</ a > 20 , 21< a href ="#iclass_t2 "> T2</ a > 22 , 23< a href ="#iclass_t3 "> T3</ a > 24 , 25< a href ="#iclass_t4 "> T4</ a > 26 and 27< a href ="#iclass_t5 "> T5</ a > 28 ) 29 . 30</ p > 31< h3 class ="classheading ">< a id ="iclass_a1 "/> A1</ h3 >< p class ="desc "/>< div class ="regdiagram-32 ">< table class ="regdiagram ">< thead >< tr >< td > 31</ td >< td > 30</ td >< td > 29</ td >< td > 28</ td >< td > 27</ td >< td > 26</ td >< td > 25</ td >< td > 24</ td >< td > 23</ td >< td > 22</ td >< td > 21</ td >< td > 20</ td >< td > 19</ td >< td > 18</ td >< td > 17</ td >< td > 16</ td >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td colspan ="4 "class ="lr "> != 1111</ td >< td class ="l "> 0</ td >< td > 0</ td >< td > 1</ td >< td class ="r "> 0</ td >< td class ="l "> 0</ td >< td > 1</ td >< td class ="r "> 0</ td >< td class ="lr "> S</ td >< td colspan ="4 "class ="lr "> Rn</ td >< td colspan ="4 "class ="lr "> Rd</ td >< td colspan ="12 "class ="lr "> imm12</ td ></ tr >< tr class ="secondrow ">< td colspan ="4 "class ="droppedname "> cond</ td >< td colspan ="4 "/>< td colspan ="3 "/>< td />< td colspan ="4 "/>< td colspan ="4 "/>< td colspan ="12 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> SUB< span class ="bitdiff "> (S == 0 && Rn != 11x1)</ span ></ h4 >< a id ="SUB_i_A1 "/>< p class ="asm-code "> SUB{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd_1 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const_1 "title ="An immediate value "> <const></ a ></ p ></ div >< div class ="encoding ">< h4 class ="encoding "> SUBS< span class ="bitdiff "> (S == 1 && Rn != 1101)</ span ></ h4 >< a id ="SUBS_i_A1 "/>< p class ="asm-code "> SUBS{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd_1 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const_1 "title ="An immediate value "> <const></ a ></ p ></ div >< p class ="pseudocode "> if Rn == '1111' && S == '0' then SEE "ADR"; 32if Rn == '1101' then SEE "SUB (SP minus immediate)"; 33constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rd); constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant setflags = (S == '1'); 34constant imm32 =< a href ="shared_pseudocode.html#impl-aarch32.A32ExpandImm.1 "title ="function: bits(32) A32ExpandImm(bits(12) imm12) "> A32ExpandImm</ a > (imm12);</ p > 35< h3 class ="classheading ">< a id ="iclass_t1 "/> T1</ h3 >< div class ="regdiagram-16 ">< table class ="regdiagram ">< thead >< tr >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td class ="l "> 0</ td >< td > 0</ td >< td > 0</ td >< td > 1</ td >< td > 1</ td >< td class ="r "> 1</ td >< td class ="lr "> 1</ td >< td colspan ="3 "class ="lr "> imm3</ td >< td colspan ="3 "class ="lr "> Rn</ td >< td colspan ="3 "class ="lr "> Rd</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T1</ h4 >< a id ="SUB_i_T1 "/>< p class ="asm-code "> SUB< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > {< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > }< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm3 "title ="3-bit unsigned immediate [0-7] (field "imm3") "> <imm3></ a > 36 // 37 38 (Inside IT block) 39</ p >< p class ="asm-code "> SUBS{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > }< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm3 "title ="3-bit unsigned immediate [0-7] (field "imm3") "> <imm3></ a > 40 // 41 42 (Outside IT block) 43</ p ></ div >< p class ="pseudocode "> constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rd); constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant setflags = !< a href ="shared_pseudocode.html#impl-aarch32.InITBlock.0 "title ="function: boolean InITBlock() "> InITBlock</ a > (); 44constant imm32 =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (imm3, 32);</ p > 45< h3 class ="classheading ">< a id ="iclass_t2 "/> T2</ h3 >< div class ="regdiagram-16 ">< table class ="regdiagram ">< thead >< tr >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td class ="l "> 0</ td >< td > 0</ td >< td class ="r "> 1</ td >< td class ="l "> 1</ td >< td class ="r "> 1</ td >< td colspan ="3 "class ="lr "> Rdn</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T2</ h4 >< a id ="SUB_i_T2 "/>< p class ="asm-code "> SUB< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > {< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > }< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > , #< a href ="#sa_imm8 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a > 46 // 47 48 (Inside IT block, and <Rdn>, <imm8> can be represented in T1) 49</ p >< p class ="asm-code "> SUB< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > {< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > ,}< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > , #< a href ="#sa_imm8 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a > 50 // 51 52 (Inside IT block, and <Rdn>, <imm8> cannot be represented in T1) 53</ p >< p class ="asm-code "> SUBS{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > }< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > , #< a href ="#sa_imm8 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a > 54 // 55 56 (Outside IT block, and <Rdn>, <imm8> can be represented in T1) 57</ p >< p class ="asm-code "> SUBS{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > ,}< a href ="#sa_rdn "title ="General-purpose source and destination register (field "Rdn") "> <Rdn></ a > , #< a href ="#sa_imm8 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a > 58 // 59 60 (Outside IT block, and <Rdn>, <imm8> cannot be represented in T1) 61</ p ></ div >< p class ="pseudocode "> constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rdn); constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rdn); constant setflags = !< a href ="shared_pseudocode.html#impl-aarch32.InITBlock.0 "title ="function: boolean InITBlock() "> InITBlock</ a > (); 62constant imm32 =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (imm8, 32);</ p > 63< h3 class ="classheading ">< a id ="iclass_t3 "/> T3</ h3 >< p class ="desc "/>< div class ="regdiagram-16x2 ">< table class ="regdiagram ">< thead >< tr >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td class ="l "> 1</ td >< td > 1</ td >< td > 1</ td >< td > 1</ td >< td class ="r "> 0</ td >< td class ="lr "> i</ td >< td class ="lr "> 0</ td >< td class ="l "> 1</ td >< td > 1</ td >< td > 0</ td >< td class ="r "> 1</ td >< td class ="lr "> S</ td >< td colspan ="4 "class ="lr "> != 1101</ td >< td class ="lr "> 0</ td >< td colspan ="3 "class ="lr "> imm3</ td >< td colspan ="4 "class ="lr "> Rd</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr >< tr class ="secondrow ">< td colspan ="5 "/>< td />< td />< td colspan ="4 "/>< td />< td colspan ="4 "class ="droppedname "> Rn</ td >< td />< td colspan ="3 "/>< td colspan ="4 "/>< td colspan ="8 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> SUB< span class ="bitdiff "> (S == 0)</ span ></ h4 >< a id ="SUB_i_T3 "/>< p class ="asm-code "> SUB< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > .W {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const "title ="An immediate value "> <const></ a > 64 // 65 66 (Inside IT block, and <Rd>, <Rn>, <const> can be represented in T1 or T2) 67</ p >< p class ="asm-code "> SUB{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const "title ="An immediate value "> <const></ a ></ p ></ div >< div class ="encoding ">< h4 class ="encoding "> SUBS< span class ="bitdiff "> (S == 1 && Rd != 1111)</ span ></ h4 >< a id ="SUBS_i_T3 "/>< p class ="asm-code "> SUBS.W {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const "title ="An immediate value "> <const></ a > 68 // 69 70 (Outside IT block, and <Rd>, <Rn>, <const> can be represented in T1 or T2) 71</ p >< p class ="asm-code "> SUBS{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_const "title ="An immediate value "> <const></ a ></ p ></ div >< p class ="pseudocode "> if Rd == '1111' && S == '1' then SEE "CMP (immediate)"; 72if Rn == '1101' then SEE "SUB (SP minus immediate)"; 73constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rd); constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant setflags = (S == '1'); 74constant imm32 =< a href ="shared_pseudocode.html#impl-aarch32.T32ExpandImm.1 "title ="function: bits(32) T32ExpandImm(bits(12) imm12) "> T32ExpandImm</ a > (i:imm3:imm8); 75// Armv8-A removes UNPREDICTABLE for R13 76if (d == 15 && !setflags) || n == 15 then UNPREDICTABLE;</ p > 77< h3 class ="classheading ">< a id ="iclass_t4 "/> T4</ h3 >< div class ="regdiagram-16x2 ">< table class ="regdiagram ">< thead >< tr >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td class ="l "> 1</ td >< td > 1</ td >< td > 1</ td >< td > 1</ td >< td class ="r "> 0</ td >< td class ="lr "> i</ td >< td class ="l "> 1</ td >< td class ="r "> 0</ td >< td class ="lr "> 1</ td >< td class ="lr "> 0</ td >< td class ="lr "> 1</ td >< td class ="lr "> 0</ td >< td colspan ="4 "class ="lr "> != 11x1</ td >< td class ="lr "> 0</ td >< td colspan ="3 "class ="lr "> imm3</ td >< td colspan ="4 "class ="lr "> Rd</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr >< tr class ="secondrow ">< td colspan ="5 "/>< td />< td colspan ="2 "/>< td />< td />< td />< td />< td colspan ="4 "class ="droppedname "> Rn</ td >< td />< td colspan ="3 "/>< td colspan ="4 "/>< td colspan ="8 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T4</ h4 >< a id ="SUB_i_T4 "/>< p class ="asm-code "> SUB{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm12 "title ="12-bit unsigned immediate [0-4095] (field "i:imm3:imm8") "> <imm12></ a > 78 // 79 80 (<imm12> cannot be represented in T1, T2, or T3) 81</ p >< p class ="asm-code "> SUBW{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } {< a href ="#sa_rd "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm12 "title ="12-bit unsigned immediate [0-4095] (field "i:imm3:imm8") "> <imm12></ a > 82 // 83 84 (<imm12> can be represented in T1, T2, or T3) 85</ p ></ div >< p class ="pseudocode "> if Rn == '1111' then SEE "ADR"; 86if Rn == '1101' then SEE "SUB (SP minus immediate)"; 87constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rd); constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant setflags = FALSE; 88constant imm32 =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (i:imm3:imm8, 32); 89// Armv8-A removes UNPREDICTABLE for R13 90if d == 15 then UNPREDICTABLE;</ p > 91< h3 class ="classheading ">< a id ="iclass_t5 "/> T5</ h3 >< div class ="regdiagram-16x2 ">< table class ="regdiagram ">< thead >< tr >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td >< td > 15</ td >< td > 14</ td >< td > 13</ td >< td > 12</ td >< td > 11</ td >< td > 10</ td >< td > 9</ td >< td > 8</ td >< td > 7</ td >< td > 6</ td >< td > 5</ td >< td > 4</ td >< td > 3</ td >< td > 2</ td >< td > 1</ td >< td > 0</ td ></ tr ></ thead >< tbody >< tr class ="firstrow ">< td class ="l "> 1</ td >< td > 1</ td >< td > 1</ td >< td > 1</ td >< td > 0</ td >< td > 0</ td >< td > 1</ td >< td > 1</ td >< td > 1</ td >< td > 1</ td >< td > 0</ td >< td class ="r "> 1</ td >< td colspan ="4 "class ="lr "> Rn</ td >< td class ="l "> 1</ td >< td class ="r "> 0</ td >< td class ="lr "> (0)</ td >< td class ="lr "> 0</ td >< td class ="lr "> (1)</ td >< td class ="lr "> (1)</ td >< td class ="lr "> (1)</ td >< td class ="lr "> (1)</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T5< span class ="bitdiff "> (!(Rn == 1110 && imm8 == 00000000))</ span ></ h4 >< a id ="SUBS_PC_T5_AS "/>< p class ="asm-code "> SUBS{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }{< a href ="#sa_q "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <q></ a > } PC, LR, #< a href ="#sa_imm8_1 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a ></ p ></ div >< p class ="pseudocode "> if Rn == '1110' &&< a href ="shared_pseudocode.html#impl-shared.IsZero.1 "title ="function: boolean IsZero(bits(N) x) "> IsZero</ a > (imm8) then SEE "ERET"; 92constant d = 15; constant n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant setflags = TRUE; 93constant imm32 =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (imm8, 32); 94if n != 14 then UNPREDICTABLE; 95if< a href ="shared_pseudocode.html#impl-aarch32.InITBlock.0 "title ="function: boolean InITBlock() "> InITBlock</ a > () && !< a href ="shared_pseudocode.html#impl-aarch32.LastInITBlock.0 "title ="function: boolean LastInITBlock() "> LastInITBlock</ a > () then UNPREDICTABLE;</ p > 96< div class ="encoding-notes "> 97< p class ="aml "> For more information about the< span class ="arm-defined-word "> constrained unpredictable</ span > behavior of this instruction, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="CJAEGDJC "> Architectural Constraints on UNPREDICTABLE behaviors</ a > , and particularly< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="CEGCDCGA "> SUBS PC. LR and related instructions (A32)</ a > and< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="CEGDJHBD "> SUBS PC, LR and related instructions (T32)</ a > .</ p > 98</ div >< h3 class ="explanations "> Assembler Symbols</ h3 >< div class ="explanations ">< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <c></ td >< td >< a id ="sa_c "/> 99 100< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 101 102</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <q></ td >< td >< a id ="sa_q "/> 103 104< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 105 106</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rdn></ td >< td >< a id ="sa_rdn "/> 107 108< p class ="aml "> Is the general-purpose source and destination register, encoded in the "Rdn" field.</ p > 109 110</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm8></ td >< td >< a id ="sa_imm8 "/> 111 112 113 114 115 116< p class ="aml "> For encoding T2: is a 8-bit unsigned immediate, in the range 0 to 255, encoded in the "imm8" field.</ p > 117 118</ td ></ tr >< tr >< td />< td >< a id ="sa_imm8_1 "/> 119 120 121 122 123 124< p class ="aml "> For encoding T5: is a 8-bit unsigned immediate, in the range 0 to 255, encoded in the "imm8" field. If <Rn> is the LR, and zero is used, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.ERET "> ERET</ a > .</ p > 125 126</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rd></ td >< td >< a id ="sa_rd_1 "/> 127 128 129 130 131 132 133< p class ="aml "> For encoding A1: is the general-purpose destination register, encoded in the "Rd" field. If omitted, this register is the same as <Rn>. If the PC is used:</ p > 134< ul > 135< li > For the SUB variant, the instruction is a branch to the address calculated by the operation. This is an interworking branch, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BEICJFEH "> Pseudocode description of operations on the AArch32 general-purpose registers and the PC</ a > .</ li > 136< li > For the SUBS variant, the instruction performs an exception return, that restores< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BEIDIGBH "> PSTATE</ a > from SPSR_<current_mode>. Arm deprecates use of this instruction unless <Rn> is the LR.</ li > 137</ ul > 138 139</ td ></ tr >< tr >< td />< td >< a id ="sa_rd "/> 140 141 142 143 144< p class ="aml "> For encoding T1, T3 and T4: is the general-purpose destination register, encoded in the "Rd" field. If omitted, this register is the same as <Rn>.</ p > 145 146</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rn></ td >< td >< a id ="sa_rn_2 "/> 147 148< p class ="aml "> For encoding A1 and T4: is the general-purpose source register, encoded in the "Rn" field. If the SP is used, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.SUB_SP_i "> SUB (SP minus immediate)</ a > . If the PC is used, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.ADR "> ADR</ a > .</ p > 149 150</ td ></ tr >< tr >< td />< td >< a id ="sa_rn "/> 151 152 153 154 155 156 157< p class ="aml "> For encoding T1: is the general-purpose source register, encoded in the "Rn" field.</ p > 158 159</ td ></ tr >< tr >< td />< td >< a id ="sa_rn_1 "/> 160 161 162 163 164 165 166< p class ="aml "> For encoding T3: is the general-purpose source register, encoded in the "Rn" field. If the SP is used, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.SUB_SP_i "> SUB (SP minus immediate)</ a > .</ p > 167 168</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm3></ td >< td >< a id ="sa_imm3 "/> 169 170< p class ="aml "> Is a 3-bit unsigned immediate, in the range 0 to 7, encoded in the "imm3" field.</ p > 171 172</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm12></ td >< td >< a id ="sa_imm12 "/> 173 174< p class ="aml "> Is a 12-bit unsigned immediate, in the range 0 to 4095, encoded in the "i:imm3:imm8" field.</ p > 175 176</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <const></ td >< td >< a id ="sa_const_1 "/> 177 178 179 180 181 182< p class ="aml "> For encoding A1: an immediate value. See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BABHDAJF "> Modified immediate constants in A32 instructions</ a > for the range of values.</ p > 183 184</ td ></ tr >< tr >< td />< td >< a id ="sa_const "/> 185 186 187 188 189 190< p class ="aml "> For encoding T3: an immediate value. See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BABGHAGA "> Modified immediate constants in T32 instructions</ a > for the range of values.</ p > 191 192</ td ></ tr ></ table ></ div >< div class ="syntax-notes "> 193< p class ="aml "> In the T32 instruction set, MOVS{<c>}{<q>} PC, LR is a pseudo-instruction for SUBS{<c>}{<q>} PC, LR, #0.</ p > 194</ div > 195< div class ="ps ">< a id ="execute "/>< h3 class ="pseudocode "> Operation</ h3 > 196< p class ="pseudocode "> if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 197 EncodingSpecificOperations(); 198 constant (result, nzcv) =< a href ="shared_pseudocode.html#impl-shared.AddWithCarry.3 "title ="function: (bits(N), bits(4)) AddWithCarry(bits(N) x, bits(N) y, bit carry_in) "> AddWithCarry</ a > (< a href ="shared_pseudocode.html#impl-aarch32.R.read.1 "title ="accessor: bits(32) R[integer n] "> R</ a > [n], NOT(imm32), '1'); 199 if d == 15 then 200 if setflags then 201< a href ="shared_pseudocode.html#impl-aarch32.ALUExceptionReturn.1 "title ="function: ALUExceptionReturn(bits(32) address) "> ALUExceptionReturn</ a > (result); 202 else 203< a href ="shared_pseudocode.html#impl-aarch32.ALUWritePC.1 "title ="function: ALUWritePC(bits(32) address) "> ALUWritePC</ a > (result); 204 else 205< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] = result; 206 if setflags then 207 PSTATE.<N,Z,C,V> = nzcv;</ p > 208</ div > 209< h3 > Operational information</ h3 > 210< p class ="aml "> If CPSR.DIT is 1 and this instruction does not use R15 as either its source or destination:</ p > 211< ul > 212< li > The execution time of this instruction is independent of:< ul >< li > The values of the data supplied in any of its registers.</ li >< li > The values of the NZCV flags.</ li ></ ul ></ li > 213< li > The response of this instruction to asynchronous exceptions does not vary based on:< ul >< li > The values of the data supplied in any of its registers.</ li >< li > The values of the NZCV flags.</ li ></ ul ></ li > 214</ ul > 215< hr />< table style ="margin: 0 auto; ">< tr >< td >< div class ="topbar ">< a href ="index.html "> Base Instructions</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="fpsimdindex.html "> SIMD&FP Instructions</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="a32_encindex.html "> A32 Instructions by Encoding</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="t32_encindex.html "> T32 Instructions by Encoding</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="shared_pseudocode.html "> Shared Pseudocode</ a ></ div ></ td >< td >< div class ="topbar ">< a href ="notice.html "> Proprietary Notice</ a ></ div ></ td ></ tr ></ table >< p class ="versions "> 216 Internal version only: isa v01_31, pseudocode v2024-09_rel 217 ; Build timestamp: 2024-09-26T13:26 218</ p >< p class ="copyconf "> 219 Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. 220 This document is Non-Confidential. 221</ p ></ body ></ html >