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 > USAT -- 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 "> USAT</ h2 > 4< p class ="aml "> Unsigned Saturate saturates an optionally-shifted signed value to a selected unsigned range.</ p > 5< p class ="aml "> This instruction sets< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="BEIDIGBH "> PSTATE</ a > .Q to 1 if the operation saturates.</ p > 6 7< p class ="desc "> 8 It has encodings from the following instruction sets: 9 A32 ( 10< a href ="#iclass_a1 "> A1</ a > 11 ) 12 and 13 T32 ( 14< a href ="#iclass_t1 "> T1</ a > 15 ) 16 . 17</ p > 18< 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 > 1</ td >< td > 1</ td >< td > 0</ td >< td class ="r "> 1</ td >< td class ="lr "> 1</ td >< td class ="lr "> 1</ td >< td colspan ="5 "class ="lr "> sat_imm</ td >< td colspan ="4 "class ="lr "> Rd</ td >< td colspan ="5 "class ="lr "> imm5</ td >< td class ="lr "> sh</ td >< td class ="l "> 0</ td >< td class ="r "> 1</ td >< td colspan ="4 "class ="lr "> Rn</ td ></ tr >< tr class ="secondrow ">< td colspan ="4 "class ="droppedname "> cond</ td >< td colspan ="5 "/>< td />< td />< td colspan ="5 "/>< td colspan ="4 "/>< td colspan ="5 "/>< td />< td colspan ="2 "/>< td colspan ="4 "/></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> Arithmetic shift right< span class ="bitdiff "> (sh == 1)</ span ></ h4 >< a id ="USAT_A1_ASR "/>< p class ="asm-code "> USAT{< 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_imm "title ="Bit position for saturation [0-31] (field "sat_imm") "> <imm></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > , ASR #< a href ="#sa_amount_3 "title ="Shift amount [1-32 (field "imm5") "> <amount></ a ></ p ></ div >< div class ="encoding ">< h4 class ="encoding "> Logical shift left< span class ="bitdiff "> (sh == 0)</ span ></ h4 >< a id ="USAT_A1_LSL "/>< p class ="asm-code "> USAT{< 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_imm "title ="Bit position for saturation [0-31] (field "sat_imm") "> <imm></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > {, LSL #< a href ="#sa_amount_2 "title ="Optional shift amount [0-31], default 0 (field "imm5") "> <amount></ 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 n =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (Rn); constant saturate_to =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (sat_imm); 19constant (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 > (sh:'0', imm5); 20if d == 15 || n == 15 then UNPREDICTABLE;</ p > 21< h3 class ="classheading ">< a id ="iclass_t1 "/> T1</ 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 "> (0)</ td >< td class ="l "> 1</ td >< td class ="r "> 1</ td >< td class ="l "> 1</ td >< td class ="r "> 0</ td >< td class ="lr "> sh</ td >< td class ="lr "> 0</ td >< td colspan ="4 "class ="lr "> Rn</ 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 class ="lr "> (0)</ td >< td colspan ="5 "class ="lr "> sat_imm</ td ></ tr ></ tbody ></ table ></ div >< div class ="encoding ">< h4 class ="encoding "> Arithmetic shift right< span class ="bitdiff "> (sh == 1 && !(imm3 == 000 && imm2 == 00))</ span ></ h4 >< a id ="USAT_T1_ASR "/>< p class ="asm-code "> USAT{< 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_imm "title ="Bit position for saturation [0-31] (field "sat_imm") "> <imm></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > , ASR #< a href ="#sa_amount_1 "title ="Shift amount [1-31 (field "imm3:imm2") "> <amount></ a ></ p ></ div >< div class ="encoding ">< h4 class ="encoding "> Logical shift left< span class ="bitdiff "> (sh == 0)</ span ></ h4 >< a id ="USAT_T1_LSL "/>< p class ="asm-code "> USAT{< 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_imm "title ="Bit position for saturation [0-31] (field "sat_imm") "> <imm></ a > ,< a href ="#sa_rn "title ="General-purpose source register (field "Rn") "> <Rn></ a > {, LSL #< a href ="#sa_amount "title ="Optional shift amount [0-31], default 0 (field "imm3:imm2") "> <amount></ a > }</ p ></ div >< p class ="pseudocode "> if sh == '1' && (imm3:imm2) == '00000' then SEE "USAT16"; 22constant 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 saturate_to =< a href ="shared_pseudocode.html#impl-shared.UInt.1 "title ="function: integer UInt(bits(N) x) "> UInt</ a > (sat_imm); 23constant (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 > (sh:'0', imm3:imm2); 24// Armv8-A removes UNPREDICTABLE for R13 25if d == 15 || n == 15 then UNPREDICTABLE;</ p > 26< div class ="encoding-notes "> 27< 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 > .</ p > 28</ 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 "/> 29 30< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 31 32</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <q></ td >< td >< a id ="sa_q "/> 33 34< p class ="aml "> See< a class ="armarm-xref "title ="Reference to Armv8 ARM section "data-linkend ="Babbefhf "> Standard assembler syntax fields</ a > .</ p > 35 36</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rd></ td >< td >< a id ="sa_rd "/> 37 38< p class ="aml "> Is the general-purpose destination register, encoded in the "Rd" field.</ p > 39 40</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <imm></ td >< td >< a id ="sa_imm "/> 41 42< p class ="aml "> Is the bit position for saturation, in the range 0 to 31, encoded in the "sat_imm" field.</ p > 43 44</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <Rn></ td >< td >< a id ="sa_rn "/> 45 46< p class ="aml "> Is the general-purpose source register, encoded in the "Rn" field.</ p > 47 48</ td ></ tr ></ table >< table >< col class ="asyn-l "/>< col class ="asyn-r "/>< tr >< td > <amount></ td >< td >< a id ="sa_amount_2 "/> 49 50 51 52 53 54 55 56< p class ="aml "> For encoding A1: is the optional shift amount, in the range 0 to 31, defaulting to 0 and encoded in the "imm5" field.</ p > 57 58</ td ></ tr >< tr >< td />< td >< a id ="sa_amount_3 "/> 59 60 61 62 63 64 65 66< p class ="aml "> For encoding A1: is the shift amount, in the range 1 to 32 encoded in the "imm5" field as <amount> modulo 32.</ p > 67 68</ td ></ tr >< tr >< td />< td >< a id ="sa_amount "/> 69 70 71 72 73 74 75 76< p class ="aml "> For encoding T1: is the optional shift amount, in the range 0 to 31, defaulting to 0 and encoded in the "imm3:imm2" field.</ p > 77 78</ td ></ tr >< tr >< td />< td >< a id ="sa_amount_1 "/> 79 80 81 82 83 84 85 86< p class ="aml "> For encoding T1: is the shift amount, in the range 1 to 31 encoded in the "imm3:imm2" field as <amount>.</ p > 87 88</ td ></ tr ></ table ></ div >< div class ="syntax-notes "/> 89< div class ="ps ">< a id ="execute "/>< h3 class ="pseudocode "> Operation</ h3 > 90< p class ="pseudocode "> if< a href ="shared_pseudocode.html#impl-aarch32.ConditionPassed.0 "title ="function: boolean ConditionPassed() "> ConditionPassed</ a > () then 91 EncodingSpecificOperations(); 92 constant operand =< 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 > [n], shift_t, shift_n, PSTATE.C); // PSTATE.C ignored 93 constant (result, sat) =< a href ="shared_pseudocode.html#impl-shared.UnsignedSatQ.2 "title ="function: (bits(N), boolean) UnsignedSatQ(integer i, integer N) "> UnsignedSatQ</ a > (< a href ="shared_pseudocode.html#impl-shared.SInt.1 "title ="function: integer SInt(bits(N) x) "> SInt</ a > (operand), saturate_to); 94< a href ="shared_pseudocode.html#impl-aarch32.R.write.1 "title ="accessor: R[integer n] = bits(32) value "> R</ a > [d] =< a href ="shared_pseudocode.html#impl-shared.ZeroExtend.2 "title ="function: bits(N) ZeroExtend(bits(M) x, integer N) "> ZeroExtend</ a > (result, 32); 95 if sat then 96 PSTATE.Q = '1';</ p > 97</ div > 98< 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 "> 99 Internal version only: isa v01_31, pseudocode v2024-09_rel 100 ; Build timestamp: 2024-09-26T13:26 101</ p >< p class ="copyconf "> 102 Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved. 103 This document is Non-Confidential. 104</ p ></ body ></ html >