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
27.0 KiB210 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 (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&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 (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 &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      , 
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 &amp;&amp; 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}}">&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_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const_1" title="An immediate value">&lt;const&gt;</a></p></div><div class="encoding"><h4 class="encoding">ADDS<span class="bitdiff"> (S == 1 &amp;&amp; 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}}">&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_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const_1" title="An immediate value">&lt;const&gt;</a></p></div><p class="pseudocode">if Rn == '1111' &amp;&amp; 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}}">&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="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm3" title="3-bit unsigned immediate [0-7] (field &quot;imm3&quot;)">&lt;imm3&gt;</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}}">&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="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm3" title="3-bit unsigned immediate [0-7] (field &quot;imm3&quot;)">&lt;imm3&gt;</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}}">&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;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
44        //
45      
46        (Inside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; 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}}">&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;Rdn&quot;)">&lt;Rdn&gt;</a>,} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
48        //
49      
50        (Inside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; 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}}">&lt;q&gt;</a>} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
52        //
53      
54        (Outside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; 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}}">&lt;q&gt;</a>} {<a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>,} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
56        //
57      
58        (Outside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; 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}}">&lt;c&gt;</a>.W {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a>
62        //
63      
64        (Inside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;const&gt; 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}}">&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_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a></p></div><div class="encoding"><h4 class="encoding">ADDS<span class="bitdiff"> (S == 1 &amp;&amp; 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 &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a>
66        //
67      
68        (Outside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;const&gt; 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}}">&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_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a></p></div><p class="pseudocode">if Rd == '1111' &amp;&amp; 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 &amp;&amp; !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}}">&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_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm12" title="12-bit unsigned immediate [0-4095] (field &quot;i:imm3:imm8&quot;)">&lt;imm12&gt;</a>
76        //
77      
78        (&lt;imm12&gt; 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}}">&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_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm12" title="12-bit unsigned immediate [0-4095] (field &quot;i:imm3:imm8&quot;)">&lt;imm12&gt;</a>
80        //
81      
82        (&lt;imm12&gt; 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>&lt;c&gt;</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>&lt;q&gt;</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>&lt;Rdn&gt;</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>&lt;imm8&gt;</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>&lt;Rd&gt;</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 &lt;Rn&gt;. 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_&lt;current_mode&gt;. 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 &lt;Rn&gt;.</p>
126        
127      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rn&gt;</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>&lt;imm3&gt;</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>&lt;imm12&gt;</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>&lt;const&gt;</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 &lt;Rd&gt; is specified and encoding T2 is preferred to encoding T1 if &lt;Rd&gt; 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.&lt;N,Z,C,V&gt; = 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.&lt;N,Z,C,V&gt; = 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&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">
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>