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 (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 "> ADD, ADDS (immediate)</ h2 > 4< p class ="aml "> Add (immediate) adds an immediate value to 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 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 , 23< a href ="#iclass_t3 "> T3</ a > 24 and 25< a href ="#iclass_t4 "> T4</ a > 26 ) 27 . 28</ p > 29< 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 "> 1</ td >< td > 0</ 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 "> ADD< span class ="bitdiff "> (S == 0 && Rn != 11x1)</ span ></ h4 >< a id ="ADD_i_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_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 "> ADDS< span class ="bitdiff "> (S == 1 && Rn != 1101)</ span ></ h4 >< a id ="ADDS_i_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_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"; 30if Rn == '1101' then SEE "ADD (SP plus immediate)"; 31constant 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'); 32constant imm32 =< a href ="shared_pseudocode.html#impl-aarch32.A32ExpandImm.1 "title ="function: bits(32) A32ExpandImm(bits(12) imm12) "> A32ExpandImm</ a > (imm12);</ p > 33< 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 "> 0</ 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 ="ADD_i_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 ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm3 "title ="3-bit unsigned immediate [0-7] (field "imm3") "> <imm3></ a > 34 // 35 36 (Inside IT block) 37</ 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 ="General-purpose source register (field "Rn") "> <Rn></ a > , #< a href ="#sa_imm3 "title ="3-bit unsigned immediate [0-7] (field "imm3") "> <imm3></ a > 38 // 39 40 (Outside IT block) 41</ 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 > (); 42constant 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 > 43< 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 "> 0</ 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 ="ADD_i_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 "Rdn") "> <Rdn></ a > , #< a href ="#sa_imm8 "title ="8-bit unsigned immediate [0-255] (field "imm8") "> <imm8></ a > 44 // 45 46 (Inside IT block, and <Rdn>, <imm8> can be represented in T1) 47</ 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 "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 > 48 // 49 50 (Inside IT block, and <Rdn>, <imm8> cannot be represented in T1) 51</ p >< p class ="asm-code "> ADDS{< 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 > 52 // 53 54 (Outside IT block, and <Rdn>, <imm8> can be represented in T1) 55</ p >< p class ="asm-code "> ADDS{< 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 > 56 // 57 58 (Outside IT block, and <Rdn>, <imm8> cannot be represented in T1) 59</ 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 > (); 60constant 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 > 61< 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 > 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 ="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 "> ADD< span class ="bitdiff "> (S == 0)</ span ></ h4 >< a id ="ADD_i_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 "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 > 62 // 63 64 (Inside IT block, and <Rd>, <Rn>, <const> can be represented in T1 or T2) 65</ 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 "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 "> ADDS< span class ="bitdiff "> (S == 1 && Rd != 1111)</ span ></ h4 >< a id ="ADDS_i_T3 "/>< p class ="asm-code "> ADDS.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 > 66 // 67 68 (Outside IT block, and <Rd>, <Rn>, <const> can be represented in T1 or T2) 69</ 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 "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 "CMN (immediate)"; 70if Rn == '1101' then SEE "ADD (SP plus immediate)"; 71constant 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'); 72constant imm32 =< a href ="shared_pseudocode.html#impl-aarch32.T32ExpandImm.1 "title ="function: bits(32) T32ExpandImm(bits(12) imm12) "> T32ExpandImm</ a > (i:imm3:imm8); 73// Armv8-A removes UNPREDICTABLE for R13 74if (d == 15 && !setflags) || n == 15 then UNPREDICTABLE;</ p > 75< 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 "> 0</ td >< td class ="lr "> 0</ td >< td class ="lr "> 0</ 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 ="ADD_i_T4 "/>< 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_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 > 76 // 77 78 (<imm12> cannot be represented in T1, T2, or T3) 79</ p >< p class ="asm-code "> ADDW{< 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 > 80 // 81 82 (<imm12> can be represented in T1, T2, or T3) 83</ p ></ div >< p class ="pseudocode "> if Rn == '1111' then SEE "ADR"; 84if Rn == '1101' then SEE "ADD (SP plus immediate)"; 85constant 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; 86constant 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); 87// Armv8-A removes UNPREDICTABLE for R13 88if d == 15 then UNPREDICTABLE;</ p > 89< div class ="encoding-notes "> 90< 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 > 91</ 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 "/> 92 93< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 94 95</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <q></ td >< td >< a id ="sa_q "/> 96 97< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 98 99</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rdn></ td >< td >< a id ="sa_rdn "/> 100 101< p class ="aml "> Is the general-purpose source and destination register, encoded in the "Rdn" field.</ p > 102 103</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm8></ td >< td >< a id ="sa_imm8 "/> 104 105< p class ="aml "> Is a 8-bit unsigned immediate, in the range 0 to 255, encoded in the "imm8" field.</ p > 106 107</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rd></ td >< td >< a id ="sa_rd_1 "/> 108 109 110 111 112 113 114< 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 > 115< ul > 116< 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 > 117< 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 > 118</ ul > 119 120</ td ></ tr >< tr >< td />< td >< a id ="sa_rd "/> 121 122 123 124 125< 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 > 126 127</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rn></ td >< td >< a id ="sa_rn_2 "/> 128 129< 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.ADD_SP_i "> ADD (SP plus 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 > 130 131</ td ></ tr >< tr >< td />< td >< a id ="sa_rn "/> 132 133 134 135 136 137 138< p class ="aml "> For encoding T1: is the 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< 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.ADD_SP_i "> ADD (SP plus immediate)</ a > .</ p > 148 149</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm3></ td >< td >< a id ="sa_imm3 "/> 150 151< p class ="aml "> Is a 3-bit unsigned immediate, in the range 0 to 7, encoded in the "imm3" field.</ p > 152 153</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm12></ td >< td >< a id ="sa_imm12 "/> 154 155< p class ="aml "> Is a 12-bit unsigned immediate, in the range 0 to 4095, encoded in the "i:imm3:imm8" field.</ p > 156 157</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <const></ td >< td >< a id ="sa_const_1 "/> 158 159 160 161 162 163< 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 > 164 165</ td ></ tr >< tr >< td />< td >< a id ="sa_const "/> 166 167 168 169 170 171< 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 > 172 173</ td ></ tr ></ table ></ div >< div class ="syntax-notes "> 174< p class ="aml "> When multiple encodings of the same length are available for an instruction, encoding T3 is preferred to encoding T4 (if encoding T4 is required, use the< span class ="asm-code "> ADDW</ span > syntax). Encoding T1 is preferred to encoding T2 if <Rd> is specified and encoding T2 is preferred to encoding T1 if <Rd> is omitted.</ p > 175</ div > 176< div class ="ps ">< a id ="execute "/>< h3 class ="pseudocode "> Operation</ h3 > 177< p class ="pseudocode "> if< a href ="shared_pseudocode.html#impl-shared.CurrentInstrSet.0 "title ="function: InstrSet CurrentInstrSet() "> CurrentInstrSet</ a > () ==< a href ="shared_pseudocode.html#InstrSet_A32 "title ="enumeration InstrSet {InstrSet_A64, InstrSet_A32, InstrSet_T32} "> InstrSet_A32</ a > then 178 if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 179 EncodingSpecificOperations(); 180 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], imm32, '0'); 181 if d == 15 then // Can only occur for A32 encoding 182 if setflags then 183< a href ="shared_pseudocode.html#impl-aarch32.ALUExceptionReturn.1 "title ="function: ALUExceptionReturn(bits(32) address) "> ALUExceptionReturn</ a > (result); 184 else 185< a href ="shared_pseudocode.html#impl-aarch32.ALUWritePC.1 "title ="function: ALUWritePC(bits(32) address) "> ALUWritePC</ a > (result); 186 else 187< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] = result; 188 if setflags then 189 PSTATE.<N,Z,C,V> = nzcv; 190else 191 if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 192 EncodingSpecificOperations(); 193 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], imm32, '0'); 194< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] = result; 195 if setflags then 196 PSTATE.<N,Z,C,V> = nzcv;</ p > 197</ div > 198< h3 > Operational information</ h3 > 199< p class ="aml "> If CPSR.DIT is 1 and this instruction does not use R15 as either its source or destination:</ p > 200< ul > 201< 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 > 202< 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 > 203</ ul > 204< 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 "> 205 Internal version only: isa v01_31, pseudocode v2024-09_rel 206 ; Build timestamp: 2024-09-26T13:26 207</ p >< p class ="copyconf "> 208 Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. 209 This document is Non-Confidential. 210</ p ></ body ></ html >