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 > ADD, ADDS (register) -- 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 "> ADD, ADDS (register)</ h2 > 4< p class ="aml "> Add (register) adds a register value and an optionally-shifted register value, and writes the result to the destination register.</ p > 5< p class ="aml "> If the destination register is not the PC, the ADDS 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 ADD 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 ADDS variant of the instruction performs an exception return without the use of the stack. Arm deprecates use of this instruction. However, 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.</ 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 and 23< a href ="#iclass_t3 "> T3</ a > 24 ) 25 . 26</ p > 27< 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 > 0</ td >< td class ="r "> 0</ td >< td class ="l "> 1</ td >< td > 0</ td >< td class ="r "> 0</ td >< td class ="lr "> S</ td >< td colspan ="4 "class ="lr "> != 1101</ td >< td colspan ="4 "class ="lr "> Rd</ td >< td colspan ="5 "class ="lr "> imm5</ td >< td colspan ="2 "class ="lr "> stype</ td >< td class ="lr "> 0</ td >< td colspan ="4 "class ="lr "> Rm</ td ></ tr >< tr class ="secondrow ">< td colspan ="4 "class ="droppedname "> cond</ td >< td colspan ="4 "/>< td colspan ="3 "/>< td />< td colspan ="4 "class ="droppedname "> Rn</ td >< td colspan ="4 "/>< td colspan ="5 "/>< td colspan ="2 "/>< td />< td colspan ="4 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> ADD, rotate right with extend< span class ="bitdiff "> (S == 0 && imm5 == 00000 && stype == 11)</ span ></ h4 >< a id ="ADD_r_A1_RRX "/>< p class ="asm-code "> ADD{< 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_2 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm_2 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > , RRX</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADD, shift or rotate by value< span class ="bitdiff "> (S == 0 && !(imm5 == 00000 && stype == 11))</ span ></ h4 >< a id ="ADD_r_A1 "/>< p class ="asm-code "> ADD{< 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_2 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm_2 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > {,< a href ="#sa_shift "title ="Type of shift applied to second source register (field "stype") [ASR,LSL,LSR,ROR] "> <shift></ a > #< a href ="#sa_amount_1 "title ="Shift amount [1-31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR) (field "imm5") "> <amount></ a > }</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADDS, rotate right with extend< span class ="bitdiff "> (S == 1 && imm5 == 00000 && stype == 11)</ span ></ h4 >< a id ="ADDS_r_A1_RRX "/>< p class ="asm-code "> ADDS{< 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_2 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm_2 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > , RRX</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADDS, shift or rotate by value< span class ="bitdiff "> (S == 1 && !(imm5 == 00000 && stype == 11))</ span ></ h4 >< a id ="ADDS_r_A1 "/>< p class ="asm-code "> ADDS{< 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_2 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_2 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm_2 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > {,< a href ="#sa_shift "title ="Type of shift applied to second source register (field "stype") [ASR,LSL,LSR,ROR] "> <shift></ a > #< a href ="#sa_amount_1 "title ="Shift amount [1-31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR) (field "imm5") "> <amount></ a > }</ p ></ div >< p class ="pseudocode "> if Rn == '1101' then SEE "ADD (SP plus register)"; 28constant 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 m =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rm); 29constant setflags = (S == '1'); 30constant (shift_t, shift_n) =< a href ="shared_pseudocode.html#impl-aarch32.DecodeImmShift.2 "title ="function: (SRType, integer) DecodeImmShift(bits(2) srtype, bits(5) imm5) "> DecodeImmShift</ a > (stype, imm5);</ p > 31< 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 "> 0</ td >< td class ="lr "> 0</ td >< td colspan ="3 "class ="lr "> Rm</ 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 ="ADD_r_T1 "/>< p class ="asm-code "> ADD< 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 ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 32 // 33 34 (Inside IT block) 35</ p >< p class ="asm-code "> ADDS{< 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 ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 36 // 37 38 (Outside IT block) 39</ 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 m =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rm); 40constant setflags = !< a href ="shared_pseudocode.html#impl-aarch32.InITBlock.0 "title ="function: boolean InITBlock() "> InITBlock</ a > (); 41constant (shift_t, shift_n) = (< a href ="shared_pseudocode.html#SRType_LSL "title ="enumeration SRType {SRType_LSL, SRType_LSR, SRType_ASR, SRType_ROR, SRType_RRX} "> SRType_LSL</ a > , 0);</ p > 42< 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 > 1</ td >< td > 0</ td >< td > 0</ td >< td > 0</ td >< td class ="r "> 1</ td >< td class ="l "> 0</ td >< td class ="r "> 0</ td >< td class ="lr "> DN</ td >< td colspan ="4 "class ="lr "> != 1101</ td >< td colspan ="3 "class ="lr "> Rdn</ td ></ tr >< tr class ="secondrow ">< td colspan ="6 "/>< td colspan ="2 "/>< td />< td colspan ="4 "class ="droppedname "> Rm</ td >< td colspan ="3 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T2< span class ="bitdiff "> (!(DN == 1 && Rdn == 101))</ span ></ h4 >< a id ="ADD_r_T2 "/>< p class ="asm-code "> ADD< 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 "DN:Rdn") "> <Rdn></ a > ,< a href ="#sa_rm_1 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 43 // 44 45 (Preferred syntax, Inside IT block) 46</ p >< p class ="asm-code "> ADD{< 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 "DN:Rdn") "> <Rdn></ a > ,}< a href ="#sa_rdn "title ="General-purpose source and destination register (field "DN:Rdn") "> <Rdn></ a > ,< a href ="#sa_rm_1 "title ="Second general-purpose source register (field "Rm") "> <Rm></ a ></ p ></ div >< p class ="pseudocode "> if (DN:Rdn) == '1101' || Rm == '1101' then SEE "ADD (SP plus register)"; 47constant d =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (DN:Rdn); constant n = d; constant m =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rm); constant setflags = FALSE; 48constant (shift_t, shift_n) = (< a href ="shared_pseudocode.html#SRType_LSL "title ="enumeration SRType {SRType_LSL, SRType_LSR, SRType_ASR, SRType_ROR, SRType_RRX} "> SRType_LSL</ a > , 0); 49if n == 15 && m == 15 then UNPREDICTABLE; 50if d == 15 &&< 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 > 51< 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 > 0</ td >< td > 1</ td >< td > 0</ td >< td class ="r "> 1</ td >< td class ="l "> 1</ td >< td > 0</ td >< td > 0</ td >< td class ="r "> 0</ 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 ="2 "class ="lr "> imm2</ td >< td colspan ="2 "class ="lr "> stype</ td >< td colspan ="4 "class ="lr "> Rm</ td ></ tr >< tr class ="secondrow ">< td colspan ="7 "/>< td colspan ="4 "/>< td />< td colspan ="4 "class ="droppedname "> Rn</ td >< td />< td colspan ="3 "/>< td colspan ="4 "/>< td colspan ="2 "/>< td colspan ="2 "/>< td colspan ="4 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> ADD, rotate right with extend< span class ="bitdiff "> (S == 0 && imm3 == 000 && imm2 == 00 && stype == 11)</ span ></ h4 >< a id ="ADD_r_T3_RRX "/>< p class ="asm-code "> ADD{< 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_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > , RRX</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADD, shift or rotate by value< span class ="bitdiff "> (S == 0 && !(imm3 == 000 && imm2 == 00 && stype == 11))</ span ></ h4 >< a id ="ADD_r_T3 "/>< p class ="asm-code "> ADD< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > .W {< a href ="#sa_rd_1 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 52 // 53 54 (Inside IT block, and <Rd>, <Rn>, <Rm> can be represented in T1) 55</ p >< p class ="asm-code "> ADD{< a href ="#sa_c "title ="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}} "> <c></ a > }.W {< a href ="#sa_rd_1 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 56 // 57 58 (<Rd> == <Rn>, and <Rd>, <Rn>, <Rm> can be represented in T2) 59</ p >< p class ="asm-code "> ADD{< 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_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > {,< a href ="#sa_shift "title ="Type of shift applied to second source register (field "stype") [ASR,LSL,LSR,ROR] "> <shift></ a > #< a href ="#sa_amount "title ="Shift amount [1-31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR)] (field "imm3:imm2") "> <amount></ a > }</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADDS, rotate right with extend< span class ="bitdiff "> (S == 1 && imm3 == 000 && Rd != 1111 && imm2 == 00 && stype == 11)</ span ></ h4 >< a id ="ADDS_r_T3_RRX "/>< p class ="asm-code "> ADDS{< 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_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > , RRX</ p ></ div >< div class ="encoding ">< h4 class ="encoding "> ADDS, shift or rotate by value< span class ="bitdiff "> (S == 1 && !(imm3 == 000 && imm2 == 00 && stype == 11) && Rd != 1111)</ span ></ h4 >< a id ="ADDS_r_T3 "/>< p class ="asm-code "> ADDS.W {< a href ="#sa_rd_1 "title ="General-purpose destination register (field "Rd") "> <Rd></ a > ,}< a href ="#sa_rn_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > 60 // 61 62 (Outside IT block, and <Rd>, <Rn>, <Rm> can be represented in T1 or T2) 63</ p >< p class ="asm-code "> ADDS{< 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_1 "title ="First general-purpose source register (field "Rn") "> <Rn></ a > ,< a href ="#sa_rm "title ="Second general-purpose source register (field "Rm") "> <Rm></ a > {,< a href ="#sa_shift "title ="Type of shift applied to second source register (field "stype") [ASR,LSL,LSR,ROR] "> <shift></ a > #< a href ="#sa_amount "title ="Shift amount [1-31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR)] (field "imm3:imm2") "> <amount></ a > }</ p ></ div >< p class ="pseudocode "> if Rd == '1111' && S == '1' then SEE "CMN (register)"; 64if Rn == '1101' then SEE "ADD (SP plus register)"; 65constant 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 m =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rm); 66constant setflags = (S == '1'); 67constant (shift_t, shift_n) =< a href ="shared_pseudocode.html#impl-aarch32.DecodeImmShift.2 "title ="function: (SRType, integer) DecodeImmShift(bits(2) srtype, bits(5) imm5) "> DecodeImmShift</ a > (stype, imm3:imm2); 68// Armv8-A removes UNPREDICTABLE for R13 69if (d == 15 && !setflags) || n == 15 || m == 15 then UNPREDICTABLE;</ p > 70< div class ="encoding-notes "> 71< p class ="aml "> For more information about the< span class ="arm-defined-word "> constrained unpredictable</ span > behavior, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="CJAEGDJC "> Architectural Constraints on UNPREDICTABLE behaviors</ a > .</ p > 72</ 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 "/> 73 74< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 75 76</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <q></ td >< td >< a id ="sa_q "/> 77 78< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 79 80</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rdn></ td >< td >< a id ="sa_rdn "/> 81 82< p class ="aml "> Is the general-purpose source and destination register, encoded in the "DN:Rdn" field. If the PC is used, the instruction is a branch to the address calculated by the operation. This is a simple 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 > .</ p > 83< p class ="aml "> The assembler language allows <Rdn> to be specified once or twice in the assembler syntax. When used inside an IT block, and <Rdn> and <Rm> are in the range R0 to R7, <Rdn> must be specified once so that encoding T2 is preferred to encoding T1. In all other cases there is no difference in behavior when <Rdn> is specified once or twice.</ p > 84 85</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rd></ td >< td >< a id ="sa_rd_2 "/> 86 87 88 89 90 91 92 93< 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 > 94< ul > 95< li > For the ADD 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 > 96< li > For the ADDS 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.</ li > 97</ ul > 98 99</ td ></ tr >< tr >< td />< td >< a id ="sa_rd "/> 100 101 102 103 104 105< p class ="aml "> For encoding T1: is the general-purpose destination register, encoded in the "Rd" field.</ p > 106< p class ="aml "> When used inside an IT block, <Rd> must be specified. When used outside an IT block, <Rd> is optional, and:</ p > 107< ul > 108< li > If omitted, this register is the same as <Rn>.</ li > 109< li > If present, encoding T1 is preferred to encoding T2.</ li > 110</ ul > 111 112</ td ></ tr >< tr >< td />< td >< a id ="sa_rd_1 "/> 113 114 115 116 117 118 119 120< p class ="aml "> For encoding T3: is the general-purpose destination register, encoded in the "Rd" field. If omitted, this register is the same as <Rn>.</ p > 121 122</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rn></ td >< td >< a id ="sa_rn_2 "/> 123 124 125 126 127 128 129 130< p class ="aml "> For encoding A1: is the first general-purpose source register, encoded in the "Rn" field. The PC can be used. If the SP is used, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="A32T32-base.instructions.ADD_SP_r "> ADD (SP plus register)</ a > .</ p > 131 132</ td ></ tr >< tr >< td />< td >< a id ="sa_rn "/> 133 134 135 136 137 138< p class ="aml "> For encoding T1: is the first general-purpose source register, encoded in the "Rn" field.</ p > 139 140</ td ></ tr >< tr >< td />< td >< a id ="sa_rn_1 "/> 141 142 143 144 145 146 147 148< p class ="aml "> For encoding T3: is the first 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.ADD_SP_r "> ADD (SP plus register)</ a > .</ p > 149 150</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rm></ td >< td >< a id ="sa_rm_2 "/> 151 152 153 154 155 156 157 158< p class ="aml "> For encoding A1: is the second general-purpose source register, encoded in the "Rm" field. The PC can be used, but this is deprecated.</ p > 159 160</ td ></ tr >< tr >< td />< td >< a id ="sa_rm "/> 161 162 163 164 165< p class ="aml "> For encoding T1 and T3: is the second general-purpose source register, encoded in the "Rm" field.</ p > 166 167</ td ></ tr >< tr >< td />< td >< a id ="sa_rm_1 "/> 168 169 170 171 172 173< p class ="aml "> For encoding T2: is the second general-purpose source register, encoded in the "Rm" field. The PC can be used.</ p > 174 175</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <shift></ td >< td >< a id ="sa_shift "/> 176< p > Is the type of shift to be applied to the second source register, 177 encoded in 178< q > stype</ q > : 179</ p > 180< table class ="valuetable "> 181 182< thead > 183< tr > 184< th class ="bitfield "> stype</ th > 185< th class ="symbol "> <shift></ th > 186</ tr > 187</ thead > 188< tbody > 189< tr > 190< td class ="bitfield "> 00</ td > 191< td class ="symbol "> LSL</ td > 192</ tr > 193< tr > 194< td class ="bitfield "> 01</ td > 195< td class ="symbol "> LSR</ td > 196</ tr > 197< tr > 198< td class ="bitfield "> 10</ td > 199< td class ="symbol "> ASR</ td > 200</ tr > 201< tr > 202< td class ="bitfield "> 11</ td > 203< td class ="symbol "> ROR</ td > 204</ tr > 205</ tbody > 206 207</ table > 208</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <amount></ td >< td >< a id ="sa_amount_1 "/> 209 210 211 212 213 214< p class ="aml "> For encoding A1: is the shift amount, in the range 1 to 31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR) encoded in the "imm5" field as <amount> modulo 32.</ p > 215 216</ td ></ tr >< tr >< td />< td >< a id ="sa_amount "/> 217 218 219 220 221 222< p class ="aml "> For encoding T3: is the shift amount, in the range 1 to 31 (when <shift> = LSL or ROR) or 1 to 32 (when <shift> = LSR or ASR), encoded in the "imm3:imm2" field as <amount> modulo 32.</ p > 223 224</ td ></ tr ></ table ></ div >< div class ="syntax-notes "> 225< p class ="aml "> Inside an IT block, if ADD<c> <Rd>, <Rn>, <Rd> cannot be assembled using encoding T1, it is assembled using encoding T2 as though ADD<c> <Rd>, <Rn> had been written. To prevent this happening, use the .W qualifier.</ p > 226</ div > 227< div class ="ps ">< a id ="execute "/>< h3 class ="pseudocode "> Operation</ h3 > 228< p class ="pseudocode "> if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 229 EncodingSpecificOperations(); 230 constant shifted =< a href ="shared_pseudocode.html#impl-aarch32.Shift.4 "title ="function: bits(N) Shift(bits(N) value, SRType srtype, integer amount, bit carry_in) "> Shift</ a > (< a href ="shared_pseudocode.html#impl-aarch32.R.read.1 "title ="accessor: bits(32) R[integer n] "> R</ a > [m], shift_t, shift_n, PSTATE.C); 231 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], shifted, '0'); 232 if d == 15 then 233 if setflags then 234< a href ="shared_pseudocode.html#impl-aarch32.ALUExceptionReturn.1 "title ="function: ALUExceptionReturn(bits(32) address) "> ALUExceptionReturn</ a > (result); 235 else 236< a href ="shared_pseudocode.html#impl-aarch32.ALUWritePC.1 "title ="function: ALUWritePC(bits(32) address) "> ALUWritePC</ a > (result); 237 else 238< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] = result; 239 if setflags then 240 PSTATE.<N,Z,C,V> = nzcv;</ p > 241</ div > 242< h3 > Operational information</ h3 > 243< p class ="aml "> If CPSR.DIT is 1 and this instruction does not use R15 as either its source or destination:</ p > 244< ul > 245< 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 > 246< 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 > 247</ ul > 248< 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 "> 249 Internal version only: isa v01_31, pseudocode v2024-09_rel 250 ; Build timestamp: 2024-09-26T13:26 251</ p >< p class ="copyconf "> 252 Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. 253 This document is Non-Confidential. 254</ p ></ body ></ html >