Files
archived-ballistic/spec/arm64_xml/asr_sbfm.xml
Ronald Caesar 26a677f8b4 decoder: Add ARM specification docs
Signed-off-by: Ronald Caesar <github43132@proton.me>
2025-12-12 18:11:36 -04:00

198 lines
9.3 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="ASR_SBFM" title="ASR (immediate) -- A64" type="alias">
<docvars>
<docvar key="alias_mnemonic" value="ASR" />
<docvar key="bitfield-fill" value="signed-fill" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A64" />
<docvar key="mnemonic" value="SBFM" />
<docvar key="source-type" value="src-is-immediate" />
</docvars>
<heading>ASR (immediate)</heading>
<desc>
<brief>
<para>Arithmetic Shift Right (immediate)</para>
</brief>
<authored>
<para>Arithmetic Shift Right (immediate) shifts a register value right by an immediate number of bits, shifting in copies of the sign bit in the upper bits and zeros in the lower bits, and writes the result to the destination register.</para>
</authored>
</desc>
<operationalnotes>
<para>If PSTATE.DIT is 1:</para>
<list type="unordered">
<listitem><content>The execution time of this instruction is independent of:<list type="unordered"><listitem><content>The values of the data supplied in any of its registers.</content></listitem><listitem><content>The values of the NZCV flags.</content></listitem></list></content></listitem>
<listitem><content>The response of this instruction to asynchronous exceptions does not vary based on:<list type="unordered"><listitem><content>The values of the data supplied in any of its registers.</content></listitem><listitem><content>The values of the NZCV flags.</content></listitem></list></content></listitem>
</list>
</operationalnotes>
<aliasto refiform="sbfm.xml" iformid="SBFM">SBFM</aliasto>
<classes>
<iclass name="With sign replication to left and zeros to right" oneof="1" id="iclass_signed_fill" no_encodings="2" isa="A64">
<docvars>
<docvar key="bitfield-fill" value="signed-fill" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A64" />
<docvar key="mnemonic" value="SBFM" />
</docvars>
<iclassintro count="2"></iclassintro>
<regdiagram form="32" psname="aarch64/instrs/integer/bitfield" tworows="1">
<box hibit="31" name="sf" usename="1">
<c></c>
</box>
<box hibit="30" width="2" name="opc" usename="1" settings="2" psbits="xx">
<c>0</c>
<c>0</c>
</box>
<box hibit="28" width="6" settings="6">
<c>1</c>
<c>0</c>
<c>0</c>
<c>1</c>
<c>1</c>
<c>0</c>
</box>
<box hibit="22" name="N" usename="1">
<c></c>
</box>
<box hibit="21" width="6" name="immr" usename="1">
<c colspan="6"></c>
</box>
<box hibit="15" width="6" name="imms" usename="1" settings="5" psbits="xxxxxx">
<c>x</c>
<c>1</c>
<c>1</c>
<c>1</c>
<c>1</c>
<c>1</c>
</box>
<box hibit="9" width="5" name="Rn" usename="1">
<c colspan="5"></c>
</box>
<box hibit="4" width="5" name="Rd" usename="1">
<c colspan="5"></c>
</box>
</regdiagram>
<encoding name="ASR_SBFM_32M_bitfield" oneofinclass="2" oneof="2" label="32-bit" bitdiffs="sf == 0 &amp;&amp; N == 0 &amp;&amp; imms == 011111">
<docvars>
<docvar key="alias_mnemonic" value="ASR" />
<docvar key="bitfield-fill" value="signed-fill" />
<docvar key="datatype" value="32" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A64" />
<docvar key="mnemonic" value="SBFM" />
<docvar key="source-type" value="src-is-immediate" />
</docvars>
<box hibit="31" width="1" name="sf">
<c>0</c>
</box>
<box hibit="22" width="1" name="N">
<c>0</c>
</box>
<box hibit="15" width="6" name="imms">
<c>0</c>
<c></c>
<c></c>
<c></c>
<c></c>
<c></c>
</box>
<asmtemplate><text>ASR </text><a link="sa_wd" hover="32-bit general-purpose destination register (field &quot;Rd&quot;)">&lt;Wd&gt;</a><text>, </text><a link="sa_wn" hover="32-bit general-purpose source register (field &quot;Rn&quot;)">&lt;Wn&gt;</a><text>, #</text><a link="sa_shift" hover="Shift amount [0-31] (field &quot;immr&quot;)">&lt;shift&gt;</a></asmtemplate>
<equivalent_to>
<asmtemplate><a href="sbfm.xml#SBFM_32M_bitfield">SBFM</a><text> </text><a link="sa_wd" hover="32-bit general-purpose destination register (field &quot;Rd&quot;)">&lt;Wd&gt;</a><text>, </text><a link="sa_wn" hover="32-bit general-purpose source register (field &quot;Rn&quot;)">&lt;Wn&gt;</a><text>, #</text><a link="sa_shift" hover="Shift amount [0-31] (field &quot;immr&quot;)">&lt;shift&gt;</a><text>, #31</text></asmtemplate>
<aliascond>Unconditionally</aliascond>
</equivalent_to>
</encoding>
<encoding name="ASR_SBFM_64M_bitfield" oneofinclass="2" oneof="2" label="64-bit" bitdiffs="sf == 1 &amp;&amp; N == 1 &amp;&amp; imms == 111111">
<docvars>
<docvar key="alias_mnemonic" value="ASR" />
<docvar key="bitfield-fill" value="signed-fill" />
<docvar key="datatype" value="64" />
<docvar key="instr-class" value="general" />
<docvar key="isa" value="A64" />
<docvar key="mnemonic" value="SBFM" />
<docvar key="source-type" value="src-is-immediate" />
</docvars>
<box hibit="31" width="1" name="sf">
<c>1</c>
</box>
<box hibit="22" width="1" name="N">
<c>1</c>
</box>
<box hibit="15" width="6" name="imms">
<c>1</c>
<c></c>
<c></c>
<c></c>
<c></c>
<c></c>
</box>
<asmtemplate><text>ASR </text><a link="sa_xd" hover="64-bit general-purpose destination register (field &quot;Rd&quot;)">&lt;Xd&gt;</a><text>, </text><a link="sa_xn" hover="64-bit general-purpose source register (field &quot;Rn&quot;)">&lt;Xn&gt;</a><text>, #</text><a link="sa_shift_1" hover="Shift amount [0-63] (field &quot;immr&quot;)">&lt;shift&gt;</a></asmtemplate>
<equivalent_to>
<asmtemplate><a href="sbfm.xml#SBFM_64M_bitfield">SBFM</a><text> </text><a link="sa_xd" hover="64-bit general-purpose destination register (field &quot;Rd&quot;)">&lt;Xd&gt;</a><text>, </text><a link="sa_xn" hover="64-bit general-purpose source register (field &quot;Rn&quot;)">&lt;Xn&gt;</a><text>, #</text><a link="sa_shift_1" hover="Shift amount [0-63] (field &quot;immr&quot;)">&lt;shift&gt;</a><text>, #63</text></asmtemplate>
<aliascond>Unconditionally</aliascond>
</equivalent_to>
</encoding>
</iclass>
</classes>
<explanations scope="all">
<explanation enclist="ASR_SBFM_32M_bitfield" symboldefcount="1">
<symbol link="sa_wd">&lt;Wd&gt;</symbol>
<account encodedin="Rd">
<intro>
<para>Is the 32-bit name of the general-purpose destination register, encoded in the "Rd" field.</para>
</intro>
</account>
</explanation>
<explanation enclist="ASR_SBFM_32M_bitfield" symboldefcount="1">
<symbol link="sa_wn">&lt;Wn&gt;</symbol>
<account encodedin="Rn">
<intro>
<para>Is the 32-bit name of the general-purpose source register, encoded in the "Rn" field.</para>
</intro>
</account>
</explanation>
<explanation enclist="ASR_SBFM_64M_bitfield" symboldefcount="1">
<symbol link="sa_xd">&lt;Xd&gt;</symbol>
<account encodedin="Rd">
<intro>
<para>Is the 64-bit name of the general-purpose destination register, encoded in the "Rd" field.</para>
</intro>
</account>
</explanation>
<explanation enclist="ASR_SBFM_64M_bitfield" symboldefcount="1">
<symbol link="sa_xn">&lt;Xn&gt;</symbol>
<account encodedin="Rn">
<intro>
<para>Is the 64-bit name of the general-purpose source register, encoded in the "Rn" field.</para>
</intro>
</account>
</explanation>
<explanation enclist="ASR_SBFM_32M_bitfield" symboldefcount="1">
<symbol link="sa_shift">&lt;shift&gt;</symbol>
<account encodedin="immr">
<docvars>
<docvar key="datatype" value="32" />
</docvars>
<intro>
<para>For the 32-bit variant: is the shift amount, in the range 0 to 31, encoded in the "immr" field.</para>
</intro>
</account>
</explanation>
<explanation enclist="ASR_SBFM_64M_bitfield" symboldefcount="2">
<symbol link="sa_shift_1">&lt;shift&gt;</symbol>
<account encodedin="immr">
<docvars>
<docvar key="datatype" value="64" />
</docvars>
<intro>
<para>For the 64-bit variant: is the shift amount, in the range 0 to 63, encoded in the "immr" field.</para>
</intro>
</account>
</explanation>
</explanations>
</instructionsection>