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 > ADR -- 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 "> ADR</ h2 > 4< p class ="aml "> Form PC-relative address adds an immediate value to the PC value to form a PC-relative address, and writes the result to the destination register.</ p > 5< p class ="desc "> This instruction is used by the alias< a href ="sub_adr.html "title ="Subtract from PC "> SUB (immediate, from PC)</ a > .</ p >< p class ="desc "> This instruction is used by the pseudo-instruction< a href ="add_adr.html "title ="Add to PC "> ADD (immediate, to PC)</ a > .</ p > 6< p class ="desc "> 7 It has encodings from the following instruction sets: 8 A32 ( 9< a href ="#iclass_a1 "> A1</ a > 10 and 11< a href ="#iclass_a2 "> A2</ a > 12 ) 13 and 14 T32 ( 15< a href ="#iclass_t1 "> T1</ a > 16 , 17< a href ="#iclass_t2 "> T2</ a > 18 and 19< a href ="#iclass_t3 "> T3</ a > 20 ) 21 . 22</ p > 23< h3 class ="classheading ">< a id ="iclass_a1 "/> A1</ h3 >< 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 "> 0</ td >< td class ="l "> 1</ td >< td > 1</ td >< td > 1</ td >< td class ="r "> 1</ 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 "> A1</ h4 >< a id ="ADR_A1 "/>< p class ="asm-code "> ADR{< 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_label_2 "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a ></ 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 imm32 =< a href ="shared_pseudocode.html#impl-aarch32.A32ExpandImm.1 "title ="function: bits(32) A32ExpandImm(bits(12) imm12) "> A32ExpandImm</ a > (imm12); constant add = TRUE;</ p > 24< h3 class ="classheading ">< a id ="iclass_a2 "/> A2</ h3 >< 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 "> 0</ td >< td class ="l "> 1</ td >< td > 1</ td >< td > 1</ td >< td class ="r "> 1</ 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 "> A2</ h4 >< a id ="ADR_A2 "/>< p class ="asm-code "> ADR{< 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_label_2 "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a ></ 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 imm32 =< a href ="shared_pseudocode.html#impl-aarch32.A32ExpandImm.1 "title ="function: bits(32) A32ExpandImm(bits(12) imm12) "> A32ExpandImm</ a > (imm12); constant add = FALSE;</ p > 25< 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 "> 1</ td >< td > 0</ td >< td > 1</ td >< td class ="r "> 0</ td >< td class ="lr "> 0</ td >< td colspan ="3 "class ="lr "> Rd</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T1</ h4 >< a id ="ADR_T1 "/>< p class ="asm-code "> ADR{< 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_label "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a ></ 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 imm32 =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (imm8:'00', 32); constant add = TRUE;</ p > 26< h3 class ="classheading ">< a id ="iclass_t2 "/> T2</ 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 class ="l "> 1</ 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 ="4 "class ="lr "> Rd</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T2</ h4 >< a id ="ADR_T2 "/>< p class ="asm-code "> ADR{< 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_label_1 "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a ></ 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 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); constant add = FALSE; 27// Armv8-A removes UNPREDICTABLE for R13 28if d == 15 then UNPREDICTABLE;</ p > 29< h3 class ="classheading ">< a id ="iclass_t3 "/> T3</ 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 class ="l "> 1</ 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 ="4 "class ="lr "> Rd</ td >< td colspan ="8 "class ="lr "> imm8</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> T3</ h4 >< a id ="ADR_T3 "/>< p class ="asm-code "> ADR{< 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_label_1 "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a > 30 // 31 32 (<Rd>, <label> can be presented in T1) 33</ p >< p class ="asm-code "> ADR{< 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_label_1 "title ="The label of an instruction or literal data item whose address is to be loaded into {syntax{<Rd>}} "> <label></ a ></ 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 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); constant add = TRUE; 34// Armv8-A removes UNPREDICTABLE for R13 35if d == 15 then UNPREDICTABLE;</ p > 36< div class ="encoding-notes "> 37< 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 > 38</ 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 "/> 39 40< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 41 42</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <q></ td >< td >< a id ="sa_q "/> 43 44< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 45 46</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rd></ td >< td >< a id ="sa_rd_1 "/> 47 48 49 50 51< p class ="aml "> For encoding A1 and A2: is the general-purpose destination register, encoded in the "Rd" field. If the PC is used, 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 > .</ p > 52 53</ td ></ tr >< tr >< td />< td >< a id ="sa_rd "/> 54 55 56 57 58< p class ="aml "> For encoding T1, T2 and T3: is the general-purpose destination register, encoded in the "Rd" field.</ p > 59 60</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <label></ td >< td >< a id ="sa_label_2 "/> 61 62 63 64 65< p class ="aml "> For encoding A1 and A2: the label of an instruction or literal data item whose address is to be loaded into <Rd>. The assembler calculates the required value of the offset from the Align(PC, 4) value of the< span class ="asm-code "> ADR</ span > instruction to this label.</ p > 66< p class ="aml "> If the offset is zero or positive, encoding A1 is used, with imm32 equal to the offset.</ p > 67< p class ="aml "> If the offset is negative, encoding A2 is used, with imm32 equal to the size of the offset. That is, the use of encoding A2 indicates that the required offset is minus the value of imm32.</ p > 68< p class ="aml "> Permitted values of the size of the offset are any of the constants described in< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BABHDAJF "> Modified immediate constants in A32 instructions</ a > .</ p > 69 70</ td ></ tr >< tr >< td />< td >< a id ="sa_label "/> 71 72 73 74 75 76< p class ="aml "> For encoding T1: the label of an instruction or literal data item whose address is to be loaded into <Rd>. The assembler calculates the required value of the offset from the Align(PC, 4) value of the< span class ="asm-code "> ADR</ span > instruction to this label. Permitted values of the size of the offset are multiples of 4 in the range 0 to 1020.</ p > 77 78</ td ></ tr >< tr >< td />< td >< a id ="sa_label_1 "/> 79 80 81 82 83< p class ="aml "> For encoding T2 and T3: the label of an instruction or literal data item whose address is to be loaded into <Rd>. The assembler calculates the required value of the offset from the Align(PC, 4) value of the< span class ="asm-code "> ADR</ span > instruction to this label.</ p > 84< p class ="aml "> If the offset is zero or positive, encoding T3 is used, with imm32 equal to the offset.</ p > 85< p class ="aml "> If the offset is negative, encoding T2 is used, with imm32 equal to the size of the offset. That is, the use of encoding T2 indicates that the required offset is minus the value of imm32.</ p > 86< p class ="aml "> Permitted values of the size of the offset are 0-4095.</ p > 87 88</ td ></ tr ></ table ></ div >< div class ="syntax-notes "> 89< p class ="aml "> The instruction aliases permit the addition or subtraction of the offset and the immediate offset to be specified separately, including permitting a subtraction of 0 that cannot be specified using the normal syntax. For more information, see< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BABGCIBA "> Use of labels in UAL instruction syntax</ a > .</ p > 90</ div >< h3 class ="aliastable "id =""> Alias Conditions</ h3 >< table class ="aliastable ">< thead >< tr >< th > Alias</ th >< th > Of variant</ th >< th > Is preferred when</ th ></ tr ></ thead >< tbody >< tr >< td >< a href ="add_adr.html "title ="Add to PC "> ADD (immediate, to PC)</ a ></ td >< td class ="notfirst "/>< td class ="notfirst ">< span class ="pseudocode "> Never</ span ></ td ></ tr >< tr >< td >< a href ="sub_adr.html "title ="Subtract from PC "> SUB (immediate, from PC)</ a ></ td >< td class ="notfirst "> T2</ td >< td class ="notfirst ">< span class ="pseudocode "> i:imm3:imm8 == '000000000000'</ span ></ td ></ tr >< tr >< td >< a href ="sub_adr.html "title ="Subtract from PC "> SUB (immediate, from PC)</ a ></ td >< td class ="notfirst "> A2</ td >< td class ="notfirst ">< span class ="pseudocode "> imm12 == '000000000000'</ span ></ td ></ tr ></ tbody ></ table > 91< div class ="ps ">< a id ="execute "/>< h3 class ="pseudocode "> Operation</ h3 > 92< p class ="pseudocode "> if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 93 EncodingSpecificOperations(); 94 constant result = if add then (< a href ="shared_pseudocode.html#impl-shared.Align.2 "title ="function: integer Align(integer x, integer y) "> Align</ a > (< a href ="shared_pseudocode.html#impl-aarch32.PC32.read.none "title ="accessor: bits(32) PC32 "> PC32</ a > ,4) + imm32) else (< a href ="shared_pseudocode.html#impl-shared.Align.2 "title ="function: integer Align(integer x, integer y) "> Align</ a > (< a href ="shared_pseudocode.html#impl-aarch32.PC32.read.none "title ="accessor: bits(32) PC32 "> PC32</ a > ,4) - imm32); 95 if d == 15 then // Can only occur for A32 encodings 96< a href ="shared_pseudocode.html#impl-aarch32.ALUWritePC.1 "title ="function: ALUWritePC(bits(32) address) "> ALUWritePC</ a > (result); 97 else 98< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] = result;</ p > 99</ div > 100< 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 "> 101 Internal version only: isa v01_31, pseudocode v2024-09_rel 102 ; Build timestamp: 2024-09-26T13:26 103</ p >< p class ="copyconf "> 104 Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. 105 This document is Non-Confidential. 106</ p ></ body ></ html >