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
30.9 KiB254 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>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&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">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 &lt;Rd&gt; 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_&lt;current_mode&gt;.</li><li>The PE checks SPSR_&lt;current_mode&gt; 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 &amp;&amp; imm5 == 00000 &amp;&amp; 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}}">&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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm_2" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">ADD, shift or rotate by value<span class="bitdiff"> (S == 0 &amp;&amp; !(imm5 == 00000 &amp;&amp; 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}}">&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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm_2" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to second source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR) (field &quot;imm5&quot;)">&lt;amount&gt;</a>}</p></div><div class="encoding"><h4 class="encoding">ADDS, rotate right with extend<span class="bitdiff"> (S == 1 &amp;&amp; imm5 == 00000 &amp;&amp; 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}}">&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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm_2" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">ADDS, shift or rotate by value<span class="bitdiff"> (S == 1 &amp;&amp; !(imm5 == 00000 &amp;&amp; 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}}">&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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm_2" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to second source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR) (field &quot;imm5&quot;)">&lt;amount&gt;</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}}">&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_rn" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</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}}">&lt;q&gt;</a>} {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</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 &amp;&amp; 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}}">&lt;c&gt;</a>{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;DN:Rdn&quot;)">&lt;Rdn&gt;</a>, <a href="#sa_rm_1" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</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}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rdn" title="General-purpose source and destination register (field &quot;DN:Rdn&quot;)">&lt;Rdn&gt;</a>,} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;DN:Rdn&quot;)">&lt;Rdn&gt;</a>, <a href="#sa_rm_1" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</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 &amp;&amp; m == 15 then UNPREDICTABLE;
50if d == 15 &amp;&amp; <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>() &amp;&amp; !<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 &amp;&amp; imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; 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}}">&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_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">ADD, shift or rotate by value<span class="bitdiff"> (S == 0 &amp;&amp; !(imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; 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}}">&lt;c&gt;</a>.W {<a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>
52        //
53      
54        (Inside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;Rm&gt; 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}}">&lt;c&gt;</a>}.W {<a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>
56        //
57      
58        (&lt;Rd&gt; == &lt;Rn&gt;, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;Rm&gt; 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}}">&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_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to second source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}</p></div><div class="encoding"><h4 class="encoding">ADDS, rotate right with extend<span class="bitdiff"> (S == 1 &amp;&amp; imm3 == 000 &amp;&amp; Rd != 1111 &amp;&amp; imm2 == 00 &amp;&amp; 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}}">&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_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">ADDS, shift or rotate by value<span class="bitdiff"> (S == 1 &amp;&amp; !(imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; stype == 11) &amp;&amp; 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 &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>
60        //
61      
62        (Outside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;Rm&gt; 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}}">&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_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="First general-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, <a href="#sa_rm" title="Second general-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to second source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}</p></div><p class="pseudocode">if Rd == '1111' &amp;&amp; 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 &amp;&amp; !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>&lt;c&gt;</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>&lt;q&gt;</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>&lt;Rdn&gt;</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 &lt;Rdn&gt; to be specified once or twice in the assembler syntax. When used inside an IT block, and &lt;Rdn&gt; and &lt;Rm&gt; are in the range R0 to R7, &lt;Rdn&gt; must be specified once so that encoding T2 is preferred to encoding T1. In all other cases there is no difference in behavior when &lt;Rdn&gt; is specified once or twice.</p>
84        
85      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rd&gt;</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 &lt;Rn&gt;. 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_&lt;current_mode&gt;. 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, &lt;Rd&gt; must be specified. When used outside an IT block, &lt;Rd&gt; is optional, and:</p>
107          <ul>
108            <li>If omitted, this register is the same as &lt;Rn&gt;.</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 &lt;Rn&gt;.</p>
121        
122      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rn&gt;</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>&lt;Rm&gt;</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>&lt;shift&gt;</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">&lt;shift&gt;</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>&lt;amount&gt;</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 &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR) encoded in the "imm5" field as &lt;amount&gt; 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 &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR), encoded in the "imm3:imm2" field as &lt;amount&gt; modulo 32.</p>
223        
224      </td></tr></table></div><div class="syntax-notes">
225      <p class="aml">Inside an IT block, if ADD&lt;c&gt; &lt;Rd&gt;, &lt;Rn&gt;, &lt;Rd&gt; cannot be assembled using encoding T1, it is assembled using encoding T2 as though ADD&lt;c&gt; &lt;Rd&gt;, &lt;Rn&gt; 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.&lt;N,Z,C,V&gt; = 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&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">
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>