slonik/specs/strd_r.xml

316 lines
18 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" encoding="UTF-8" href="iform.xsl" version="1.0"?>
<!DOCTYPE instructionsection PUBLIC "-//ARM//DTD instructionsection //EN" "iform-p.dtd">
<!-- Copyright (c) 2010-2022 Arm Limited or its affiliates. All rights reserved. -->
<!-- This document is Non-Confidential. This document may only be used and distributed in accordance with the terms of the agreement entered into by Arm and the party that Arm delivered this document to. -->
<instructionsection id="STRD_r" title="STRD (register) -- AArch32" type="instruction">
<docvars>
<docvar key="armarmheading" value="A1" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A32" />
<docvar key="mnemonic" value="STRD" />
</docvars>
<heading>STRD (register)</heading>
<desc>
<brief>
<para>Store Register Dual (register)</para>
</brief>
<authored>
<para>Store Register Dual (register) calculates an address from a base register value and a register offset, and stores two words from two registers to memory. It can use offset, post-indexed, or pre-indexed addressing. For information about memory accesses see <xref linkend="Chddjfjf">Memory accesses</xref>.</para>
</authored>
<encodingnotes>
<para>For more information about the <arm-defined-word>constrained unpredictable</arm-defined-word> behavior of this instruction, see <xref linkend="CJAEGDJC">Architectural Constraints on UNPREDICTABLE behaviors</xref>.</para>
</encodingnotes>
</desc>
<operationalnotes>
<para>If CPSR.DIT is 1, the timing of this instruction is insensitive to the value of the data being loaded or stored.</para>
</operationalnotes>
<alias_list howmany="0"></alias_list>
<classes>
<iclass name="A1" oneof="1" id="iclass_a1" no_encodings="3" isa="A32">
<docvars>
<docvar key="armarmheading" value="A1" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A32" />
<docvar key="mnemonic" value="STRD" />
</docvars>
<iclassintro count="3"></iclassintro>
<regdiagram form="32" psname="aarch32/instrs/STRD_r/A1_A.txt" tworows="1">
<box hibit="31" width="4" name="cond" usename="1" settings="4" constraint="!= 1111">
<c colspan="4">!= 1111</c>
</box>
<box hibit="27" width="3" settings="3">
<c>0</c>
<c>0</c>
<c>0</c>
</box>
<box hibit="24" name="P" usename="1">
<c></c>
</box>
<box hibit="23" name="U" usename="1">
<c></c>
</box>
<box hibit="22" settings="1">
<c>0</c>
</box>
<box hibit="21" name="W" usename="1">
<c></c>
</box>
<box hibit="20" name="o1" settings="1">
<c>0</c>
</box>
<box hibit="19" width="4" name="Rn" usename="1">
<c colspan="4"></c>
</box>
<box hibit="15" width="4" name="Rt" usename="1">
<c colspan="4"></c>
</box>
<box hibit="11" settings="1">
<c>(0)</c>
</box>
<box hibit="10" settings="1">
<c>(0)</c>
</box>
<box hibit="9" settings="1">
<c>(0)</c>
</box>
<box hibit="8" settings="1">
<c>(0)</c>
</box>
<box hibit="7" settings="1">
<c>1</c>
</box>
<box hibit="6" width="2" name="op2" settings="2">
<c>1</c>
<c>1</c>
</box>
<box hibit="4" settings="1">
<c>1</c>
</box>
<box hibit="3" width="4" name="Rm" usename="1">
<c colspan="4"></c>
</box>
</regdiagram>
<encoding name="STRD_r_A1_off" oneofinclass="3" oneof="3" label="Offset" bitdiffs="P == 1 &amp;&amp; W == 0">
<docvars>
<docvar key="address-form" value="base-plus-offset" />
<docvar key="address-offset" value="signed-offset" />
<docvar key="armarmheading" value="A1" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A32" />
<docvar key="mnemonic" value="STRD" />
</docvars>
<box hibit="24" width="1" name="P">
<c>1</c>
</box>
<box hibit="21" width="1" name="W">
<c>0</c>
</box>
<asmtemplate><text>STRD</text><text>{</text><a link="sa_c" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a><text>}</text><text>{</text><a link="sa_q" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a><text>}</text><text> </text><a link="sa_rt" hover="First general-purpose register to be transferred (field &quot;Rt&quot;)">&lt;Rt&gt;</a><text>, </text><a link="sa_rt2" hover="Second general-purpose register to be transferred">&lt;Rt2&gt;</a><text>, [</text><a link="sa_rn" hover="General-purpose base register (field &quot;Rn&quot;)">&lt;Rn&gt;</a><text>, </text><a link="sa__plusminus_" hover="Specifies the index register is added to or subtracted from the base register (field &quot;U&quot;) [+,-]">{+/-}</a><a link="sa_rm" hover="General-purpose index register (field &quot;Rm&quot;)">&lt;Rm&gt;</a><text>]</text></asmtemplate>
</encoding>
<encoding name="STRD_r_A1_post" oneofinclass="3" oneof="3" label="Post-indexed" bitdiffs="P == 0 &amp;&amp; W == 0">
<docvars>
<docvar key="address-form" value="post-indexed" />
<docvar key="armarmheading" value="A1" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A32" />
<docvar key="mnemonic" value="STRD" />
</docvars>
<box hibit="24" width="1" name="P">
<c>0</c>
</box>
<box hibit="21" width="1" name="W">
<c>0</c>
</box>
<asmtemplate><text>STRD</text><text>{</text><a link="sa_c" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a><text>}</text><text>{</text><a link="sa_q" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a><text>}</text><text> </text><a link="sa_rt" hover="First general-purpose register to be transferred (field &quot;Rt&quot;)">&lt;Rt&gt;</a><text>, </text><a link="sa_rt2" hover="Second general-purpose register to be transferred">&lt;Rt2&gt;</a><text>, [</text><a link="sa_rn" hover="General-purpose base register (field &quot;Rn&quot;)">&lt;Rn&gt;</a><text>], </text><a link="sa__plusminus_" hover="Specifies the index register is added to or subtracted from the base register (field &quot;U&quot;) [+,-]">{+/-}</a><a link="sa_rm" hover="General-purpose index register (field &quot;Rm&quot;)">&lt;Rm&gt;</a></asmtemplate>
</encoding>
<encoding name="STRD_r_A1_pre" oneofinclass="3" oneof="3" label="Pre-indexed" bitdiffs="P == 1 &amp;&amp; W == 1">
<docvars>
<docvar key="address-form" value="pre-indexed" />
<docvar key="armarmheading" value="A1" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A32" />
<docvar key="mnemonic" value="STRD" />
</docvars>
<box hibit="24" width="1" name="P">
<c>1</c>
</box>
<box hibit="21" width="1" name="W">
<c>1</c>
</box>
<asmtemplate><text>STRD</text><text>{</text><a link="sa_c" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a><text>}</text><text>{</text><a link="sa_q" hover="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a><text>}</text><text> </text><a link="sa_rt" hover="First general-purpose register to be transferred (field &quot;Rt&quot;)">&lt;Rt&gt;</a><text>, </text><a link="sa_rt2" hover="Second general-purpose register to be transferred">&lt;Rt2&gt;</a><text>, [</text><a link="sa_rn" hover="General-purpose base register (field &quot;Rn&quot;)">&lt;Rn&gt;</a><text>, </text><a link="sa__plusminus_" hover="Specifies the index register is added to or subtracted from the base register (field &quot;U&quot;) [+,-]">{+/-}</a><a link="sa_rm" hover="General-purpose index register (field &quot;Rm&quot;)">&lt;Rm&gt;</a><text>]!</text></asmtemplate>
</encoding>
<ps_section howmany="1">
<ps name="aarch32/instrs/STRD_r/A1_A.txt" mylink="aarch32.instrs.STRD_r.A1_A.txt" enclabels="" sections="1" secttype="noheading">
<pstext mayhavelinks="1" section="Decode" rep_section="decode">if Rt&lt;0&gt; == '1' then UNPREDICTABLE;
t = <a link="impl-shared.UInt.1" file="shared_pseudocode.xml" hover="function: integer UInt(bits(N) x)">UInt</a>(Rt); t2 = t+1; n = <a link="impl-shared.UInt.1" file="shared_pseudocode.xml" hover="function: integer UInt(bits(N) x)">UInt</a>(Rn); m = <a link="impl-shared.UInt.1" file="shared_pseudocode.xml" hover="function: integer UInt(bits(N) x)">UInt</a>(Rm);
index = (P == '1'); add = (U == '1'); wback = (P == '0') || (W == '1');
if P == '0' &amp;&amp; W == '1' then UNPREDICTABLE;
if t2 == 15 || m == 15 then UNPREDICTABLE;
if wback &amp;&amp; (n == 15 || n == t || n == t2) then UNPREDICTABLE;</pstext>
</ps>
</ps_section>
<constrained_unpredictables encoding="A1" ps_block="Decode">
<cu_case>
<cu_cause>
<pstext mayhavelinks="1">t == 15 || t2 == 15</pstext>
</cu_cause>
<cu_type constraint="Constraint_UNDEF" />
<cu_type constraint="Constraint_NOP" />
<cu_type>
<cu_type_text>The store instruction performs the store using the specified addressing mode but the value corresponding to R15 is <arm-defined-word>unknown</arm-defined-word>.</cu_type_text>
</cu_type>
</cu_case>
<cu_case>
<cu_cause>
<pstext mayhavelinks="1">wback &amp;&amp; (n == t || n == t2)</pstext>
</cu_cause>
<cu_type constraint="Constraint_UNDEF" />
<cu_type constraint="Constraint_NOP" />
<cu_type constraint="Constraint_STUNKNOWN" />
</cu_case>
<cu_case>
<cu_cause>
<pstext mayhavelinks="1">wback &amp;&amp; n == 15</pstext>
</cu_cause>
<cu_type constraint="Constraint_UNDEF" />
<cu_type constraint="Constraint_NOP" />
<cu_type constraint="Constraint_WBSUPPRESS" />
<cu_type>
<cu_type_text>The instruction uses the addressing mode described in the equivalent immediate offset instruction.</cu_type_text>
</cu_type>
</cu_case>
<cu_case>
<cu_cause>
<pstext mayhavelinks="1">Rt&lt;0&gt; == '1'</pstext>
</cu_cause>
<cu_type constraint="Constraint_UNDEF" />
<cu_type constraint="Constraint_NOP" />
<cu_type constraint="Constraint_ADDITIONAL_DECODE">
<cu_type_variable name="pseudocode" value="t&lt;0&gt; = '0'" />
</cu_type>
<cu_type constraint="Constraint_ADDITIONAL_DECODE">
<cu_type_variable name="pseudocode" value="t2 = t" />
</cu_type>
<cu_type>
<cu_type_text>The instruction executes as described, with no change to its behavior and no additional side-effects. This does not apply when Rt == '1111'.</cu_type_text>
</cu_type>
</cu_case>
<cu_case>
<cu_cause>
<pstext mayhavelinks="1">P == '0' &amp;&amp; W == '1'</pstext>
</cu_cause>
<cu_type constraint="Constraint_UNDEF" />
<cu_type constraint="Constraint_NOP" />
<cu_type constraint="Constraint_ADDITIONAL_DECODE">
<cu_type_variable name="pseudocode" value="P = '1'; W = '0'" />
</cu_type>
<cu_type constraint="Constraint_ADDITIONAL_DECODE">
<cu_type_variable name="pseudocode" value="P = '1'; W = '1'" />
</cu_type>
<cu_type constraint="Constraint_ADDITIONAL_DECODE">
<cu_type_variable name="pseudocode" value="P = '0'; W = '0'" />
</cu_type>
</cu_case>
</constrained_unpredictables>
</iclass>
</classes>
<explanations scope="all">
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_c">&lt;c&gt;</symbol>
<account encodedin="">
<intro>
<para>See <xref linkend="Babbefhf">Standard assembler syntax fields</xref>.</para>
</intro>
</account>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_q">&lt;q&gt;</symbol>
<account encodedin="">
<intro>
<para>See <xref linkend="Babbefhf">Standard assembler syntax fields</xref>.</para>
</intro>
</account>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_rt">&lt;Rt&gt;</symbol>
<account encodedin="Rt">
<intro>
<para>Is the first general-purpose register to be transferred, encoded in the "Rt" field. This register must be even-numbered and not R14.</para>
</intro>
</account>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_rt2">&lt;Rt2&gt;</symbol>
<account encodedin="">
<intro>
<para>Is the second general-purpose register to be transferred. This register must be <syntax>&lt;R(t+1)&gt;</syntax>.</para>
</intro>
</account>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_rn">&lt;Rn&gt;</symbol>
<account encodedin="Rn">
<intro>
<para>Is the general-purpose base register, encoded in the "Rn" field. The PC can be used in the offset variant, but this is deprecated.</para>
</intro>
</account>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa__plusminus_">+/-</symbol>
<definition encodedin="U">
<intro>Specifies the index register is added to or subtracted from the base register, defaulting to + if omitted and </intro>
<table class="valuetable">
<tgroup cols="2">
<thead>
<row>
<entry class="bitfield">U</entry>
<entry class="symbol">+/-</entry>
</row>
</thead>
<tbody>
<row>
<entry class="bitfield">0</entry>
<entry class="symbol">-</entry>
</row>
<row>
<entry class="bitfield">1</entry>
<entry class="symbol">+</entry>
</row>
</tbody>
</tgroup>
</table>
</definition>
</explanation>
<explanation enclist="STRD_r_A1_off" symboldefcount="1">
<symbol link="sa_rm">&lt;Rm&gt;</symbol>
<account encodedin="Rm">
<intro>
<para>Is the general-purpose index register, encoded in the "Rm" field.</para>
</intro>
</account>
</explanation>
</explanations>
<ps_section howmany="1">
<ps name="aarch32/instrs/STRD_r/Op_A.txt" mylink="execute" enclabels="" sections="1" secttype="Operation">
<pstext mayhavelinks="1" section="Execute" rep_section="execute">if <a link="impl-aarch32.ConditionPassed.0" file="shared_pseudocode.xml" hover="function: boolean ConditionPassed()">ConditionPassed</a>() then
EncodingSpecificOperations();
offset_addr = if add then (<a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[n] + <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[m]) else (<a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[n] - <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[m]);
address = if index then offset_addr else <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[n];
if <a link="impl-shared.IsAligned.2" file="shared_pseudocode.xml" hover="function: boolean IsAligned(integer x, integer y)">IsAligned</a>(address, 8) then
bits(64) data;
if <a link="impl-shared.BigEndian.1" file="shared_pseudocode.xml" hover="function: boolean BigEndian(AccessType acctype)">BigEndian</a>(<a link="AccessType_GPR" file="shared_pseudocode.xml" hover="enumeration AccessType { AccessType_IFETCH, AccessType_GPR, AccessType_ASIMD, AccessType_SVE, AccessType_SME, AccessType_IC, AccessType_DC, AccessType_DCZero, AccessType_AT, AccessType_NV2, AccessType_SPE, AccessType_GCS, AccessType_TRBE, AccessType_GPTW, AccessType_TTW }">AccessType_GPR</a>) then
data&lt;63:32&gt; = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t];
data&lt;31:0&gt; = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t2];
else
data&lt;31:0&gt; = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t];
data&lt;63:32&gt; = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t2];
<a link="impl-aarch32.MemA.write.2" file="shared_pseudocode.xml" hover="accessor: MemA[bits(32) address, integer size] = bits(8*size) value">MemA</a>[address,8] = data;
else
<a link="impl-aarch32.MemA.write.2" file="shared_pseudocode.xml" hover="accessor: MemA[bits(32) address, integer size] = bits(8*size) value">MemA</a>[address,4] = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t];
<a link="impl-aarch32.MemA.write.2" file="shared_pseudocode.xml" hover="accessor: MemA[bits(32) address, integer size] = bits(8*size) value">MemA</a>[address+4,4] = <a link="impl-aarch32.R.read.1" file="shared_pseudocode.xml" hover="accessor: bits(32) R[integer n]">R</a>[t2];
if wback then <a link="impl-aarch32.R.write.1" file="shared_pseudocode.xml" hover="accessor: R[integer n] = bits(32) value">R</a>[n] = offset_addr;</pstext>
</ps>
</ps_section>
</instructionsection>