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

Jonathan Dönszelmannwebsite start885cc4e

main
12.9 KiB104 linesraw
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>SSAT -- 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&amp;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">SSAT</h2>
4      <p class="aml">Signed Saturate saturates an optionally-shifted signed value to a selectable signed 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">0</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="SSAT_A1_ASR"/><p class="asm-code">SSAT{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, #<a href="#sa_imm" title="Bit position for saturation [1-32] (field &quot;sat_imm&quot;)">&lt;imm&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, ASR #<a href="#sa_amount_3" title="Shift amount [1-32 (field &quot;imm5&quot;)">&lt;amount&gt;</a></p></div><div class="encoding"><h4 class="encoding">Logical shift left<span class="bitdiff"> (sh == 0)</span></h4><a id="SSAT_A1_LSL"/><p class="asm-code">SSAT{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, #<a href="#sa_imm" title="Bit position for saturation [1-32] (field &quot;sat_imm&quot;)">&lt;imm&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a> {, LSL #<a href="#sa_amount_2" title="Optional shift amount [0-31], default 0 (field &quot;imm5&quot;)">&lt;amount&gt;</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)+1;
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">0</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 &amp;&amp; !(imm3 == 000 &amp;&amp; imm2 == 00))</span></h4><a id="SSAT_T1_ASR"/><p class="asm-code">SSAT{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, #<a href="#sa_imm" title="Bit position for saturation [1-32] (field &quot;sat_imm&quot;)">&lt;imm&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, ASR #<a href="#sa_amount_1" title="Shift amount [1-31 (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a></p></div><div class="encoding"><h4 class="encoding">Logical shift left<span class="bitdiff"> (sh == 0)</span></h4><a id="SSAT_T1_LSL"/><p class="asm-code">SSAT{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, #<a href="#sa_imm" title="Bit position for saturation [1-32] (field &quot;sat_imm&quot;)">&lt;imm&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a> {, LSL #<a href="#sa_amount" title="Optional shift amount [0-31], default 0 (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}</p></div><p class="pseudocode">if sh == '1' &amp;&amp; (imm3:imm2) == '00000' then SEE "SSAT16";
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)+1;
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>&lt;c&gt;</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>&lt;q&gt;</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>&lt;Rd&gt;</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>&lt;imm&gt;</td><td><a id="sa_imm"/>
41        
42          <p class="aml">Is the bit position for saturation, in the range 1 to 32, encoded in the "sat_imm" field as &lt;imm&gt;-1.</p>
43        
44      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rn&gt;</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>&lt;amount&gt;</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 &lt;amount&gt; 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 &lt;amount&gt;.</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.SignedSatQ.2" title="function: (bits(N), boolean) SignedSatQ(integer i, integer N)">SignedSatQ</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.SignExtend.2" title="function: bits(N) SignExtend(bits(M) x, integer N)">SignExtend</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&amp;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>