<?xml version="1.0" ?><?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-2026 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="VCADD" title="VCADD -- AArch32" type="instruction">
  <docvars>
    <docvar key="instr-class" value="fpsimd"/>
    <docvar key="mnemonic" value="VCADD"/>
  </docvars>
  <heading>VCADD</heading>
  <desc>
    <brief>
      <para>Vector Complex Add</para>
    </brief>
    <authored>
      <para>Vector Complex Add.</para>
      <para>This instruction operates on complex numbers that are represented in SIMD&amp;FP registers as pairs of
elements, with the more significant element holding the imaginary part of the number and the less
significant element holding the real part of the number. Each element holds a floating-point
value. It performs the following calculation on the corresponding complex number element pairs
from the two source registers:</para>
      <list type="unordered">
        <listitem>
          <content>Considering the complex number from the second source register on an Argand diagram, the number is rotated counterclockwise by 90 or 270 degrees.</content>
        </listitem>
        <listitem>
          <content>The rotated complex number is added to the complex number from the first source register.</content>
        </listitem>
      </list>
      <para>Depending on settings in the <xref linkend="ARMARM_AArch32.cpacr">CPACR</xref>,
<xref linkend="ARMARM_AArch32.nsacr">NSACR</xref>, and
<xref linkend="ARMARM_AArch32.hcptr">HCPTR</xref> registers, and the Security
state and PE mode in which the instruction is executed, an attempt to
execute the instruction might be <arm-defined-word>UNDEFINED</arm-defined-word>, or
trapped to Hyp mode.
For more information see <xref linkend="ARMARM_CIHIDDFF">Enabling Advanced
SIMD and floating-point support</xref>.</para>
    </authored>
  </desc>
  <alias_list howmany="0"/>
  <classes>
    <classesintro count="2">
      <txt>It has encodings from the following instruction sets:</txt>
      <txt> A32 (</txt>
      <a href="#iclass_a1">A1</a>
      <txt>)</txt>
      <txt> and </txt>
      <txt> T32 (</txt>
      <a href="#iclass_t1">T1</a>
      <txt>)</txt>
      <txt>.</txt>
    </classesintro>
    <iclass name="A1" oneof="2" id="iclass_a1" no_encodings="2" isa="A32">
      <docvars>
        <docvar key="armarmheading" value="A1"/>
        <docvar key="instr-class" value="fpsimd"/>
        <docvar key="isa" value="A32"/>
        <docvar key="mnemonic" value="VCADD"/>
      </docvars>
      <iclassintro count="2"/>
      <arch_variants>
        <arch_variant feature="FEAT_FCMA" name="v8Ap3"/>
      </arch_variants>
      <regdiagram form="32" psname="A32.cops_as.advsimdext.simd3reg_sameext.VCADD_A1_D" tworows="1">
        <box hibit="31" width="7" settings="7">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>0</c>
        </box>
        <box hibit="24" width="1" name="rot" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="23" width="1" settings="1">
          <c>1</c>
        </box>
        <box hibit="22" width="1" name="D" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="21" width="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="20" width="1" name="S" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="19" width="4" name="Vn" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="15" width="4" name="Vd" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="11" width="1" settings="1">
          <c>1</c>
        </box>
        <box hibit="10" name="op3" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="9" width="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="8" name="op4" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="7" width="1" name="N" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="6" width="1" name="Q" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="5" width="1" name="M" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="4" name="U" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="3" width="4" name="Vm" usename="1">
          <c colspan="4"/>
        </box>
      </regdiagram>
      <encoding name="VCADD_A1_D" oneofinclass="2" oneof="4" label="64-bit SIMD vector" bitdiffs="Q == 0">
        <docvars>
          <docvar key="armarmheading" value="A1"/>
          <docvar key="instr-class" value="fpsimd"/>
          <docvar key="isa" value="A32"/>
          <docvar key="simdvectorsize" value="double"/>
          <docvar key="mnemonic" value="VCADD"/>
        </docvars>
        <box hibit="6" width="1" name="Q">
          <c>0</c>
        </box>
        <asmtemplate><text>VCADD{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}.</text><a hover="Is the data type for the elements of the vectors, " link="dt_option__3">&lt;dt&gt;</a><text>  </text><a hover="Is the 64-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field." link="D_Vd">&lt;Dd&gt;</a><text>, </text><a hover="Is the 64-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field." link="N_Vn">&lt;Dn&gt;</a><text>, </text><a hover="Is the 64-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field." link="M_Vm">&lt;Dm&gt;</a><text>, #</text><a hover="Is the rotation to be applied to elements in the second SIMD&amp;FP source register, " link="rotate_option__4">&lt;rotate&gt;</a></asmtemplate>
      </encoding>
      <encoding name="VCADD_A1_Q" oneofinclass="2" oneof="4" label="128-bit SIMD vector" bitdiffs="Q == 1">
        <docvars>
          <docvar key="armarmheading" value="A1"/>
          <docvar key="instr-class" value="fpsimd"/>
          <docvar key="isa" value="A32"/>
          <docvar key="simdvectorsize" value="quad"/>
          <docvar key="mnemonic" value="VCADD"/>
        </docvars>
        <box hibit="6" width="1" name="Q">
          <c>1</c>
        </box>
        <asmtemplate><text>VCADD{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}.</text><a hover="Is the data type for the elements of the vectors, " link="dt_option__3">&lt;dt&gt;</a><text>  </text><a hover="Is the 128-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field as &lt;Qd&gt;*2." link="D_Vd__4">&lt;Qd&gt;</a><text>, </text><a hover="Is the 128-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field as &lt;Qn&gt;*2." link="N_Vn__2">&lt;Qn&gt;</a><text>, </text><a hover="Is the 128-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field as &lt;Qm&gt;*2." link="M_Vm__5">&lt;Qm&gt;</a><text>, #</text><a hover="Is the rotation to be applied to elements in the second SIMD&amp;FP source register, " link="rotate_option__4">&lt;rotate&gt;</a></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="A32.cops_as.advsimdext.simd3reg_sameext.VCADD_A1_D" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">if !IsFeatureImplemented(FEAT_FCMA) then Undefined(); end;
if Q == '1' &amp;&amp; (Vd[0] == '1' || Vn[0] == '1' || Vm[0] == '1') then Undefined(); end;
if S == '0' &amp;&amp; !IsFeatureImplemented(FEAT_FP16) then Undefined(); end;
let d : integer = UInt(D::Vd);
let n : integer = UInt(N::Vn);
let m : integer = UInt(M::Vm);
let esize : integer{} = 16 &lt;&lt; UInt(S);
let elements : integer = 64 DIV esize;
let regs : integer = if Q == '0' then 1 else 2;</pstext></ps>
      </ps_section>
    </iclass>
    <iclass name="T1" oneof="2" id="iclass_t1" no_encodings="2" isa="T32">
      <docvars>
        <docvar key="armarmheading" value="T1"/>
        <docvar key="instr-class" value="fpsimd"/>
        <docvar key="isa" value="T32"/>
        <docvar key="mnemonic" value="VCADD"/>
      </docvars>
      <iclassintro count="2"/>
      <arch_variants>
        <arch_variant feature="FEAT_FCMA" name="v8Ap3"/>
      </arch_variants>
      <regdiagram form="16x2" psname="T32.w.cpaf.advsimdext.simd_3sameext.VCADD_T1_D" tworows="1">
        <box hibit="31" width="7" settings="7">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>0</c>
        </box>
        <box hibit="24" width="1" name="rot" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="23" width="1" settings="1">
          <c>1</c>
        </box>
        <box hibit="22" width="1" name="D" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="21" width="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="20" width="1" name="S" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="19" width="4" name="Vn" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="15" width="4" name="Vd" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="11" width="1" settings="1">
          <c>1</c>
        </box>
        <box hibit="10" name="op3" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="9" width="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="8" name="op4" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="7" width="1" name="N" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="6" width="1" name="Q" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="5" width="1" name="M" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="4" name="U" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="3" width="4" name="Vm" usename="1">
          <c colspan="4"/>
        </box>
      </regdiagram>
      <encoding name="VCADD_T1_D" oneofinclass="2" oneof="4" label="64-bit SIMD vector" bitdiffs="Q == 0">
        <docvars>
          <docvar key="armarmheading" value="T1"/>
          <docvar key="instr-class" value="fpsimd"/>
          <docvar key="isa" value="T32"/>
          <docvar key="simdvectorsize" value="double"/>
          <docvar key="mnemonic" value="VCADD"/>
        </docvars>
        <box hibit="6" width="1" name="Q">
          <c>0</c>
        </box>
        <asmtemplate><text>VCADD{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}.</text><a hover="Is the data type for the elements of the vectors, " link="dt_option__3">&lt;dt&gt;</a><text>  </text><a hover="Is the 64-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field." link="D_Vd">&lt;Dd&gt;</a><text>, </text><a hover="Is the 64-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field." link="N_Vn">&lt;Dn&gt;</a><text>, </text><a hover="Is the 64-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field." link="M_Vm">&lt;Dm&gt;</a><text>, #</text><a hover="Is the rotation to be applied to elements in the second SIMD&amp;FP source register, " link="rotate_option__4">&lt;rotate&gt;</a></asmtemplate>
      </encoding>
      <encoding name="VCADD_T1_Q" oneofinclass="2" oneof="4" label="128-bit SIMD vector" bitdiffs="Q == 1">
        <docvars>
          <docvar key="armarmheading" value="T1"/>
          <docvar key="instr-class" value="fpsimd"/>
          <docvar key="isa" value="T32"/>
          <docvar key="simdvectorsize" value="quad"/>
          <docvar key="mnemonic" value="VCADD"/>
        </docvars>
        <box hibit="6" width="1" name="Q">
          <c>1</c>
        </box>
        <asmtemplate><text>VCADD{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}.</text><a hover="Is the data type for the elements of the vectors, " link="dt_option__3">&lt;dt&gt;</a><text>  </text><a hover="Is the 128-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field as &lt;Qd&gt;*2." link="D_Vd__4">&lt;Qd&gt;</a><text>, </text><a hover="Is the 128-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field as &lt;Qn&gt;*2." link="N_Vn__2">&lt;Qn&gt;</a><text>, </text><a hover="Is the 128-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field as &lt;Qm&gt;*2." link="M_Vm__5">&lt;Qm&gt;</a><text>, #</text><a hover="Is the rotation to be applied to elements in the second SIMD&amp;FP source register, " link="rotate_option__4">&lt;rotate&gt;</a></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="T32.w.cpaf.advsimdext.simd_3sameext.VCADD_T1_D" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">if <a link="func_InITBlock_0" file="shared_pseudocode.xml">InITBlock</a>() then UnpredictableProcedure(); end;
if !IsFeatureImplemented(FEAT_FCMA) then Undefined(); end;
if Q == '1' &amp;&amp; (Vd[0] == '1' || Vn[0] == '1' || Vm[0] == '1') then Undefined(); end;
if S == '0' &amp;&amp; !IsFeatureImplemented(FEAT_FP16) then Undefined(); end;
let esize : integer{} = 16 &lt;&lt; UInt(S);
let d : integer = UInt(D::Vd);
let n : integer = UInt(N::Vn);
let m : integer = UInt(M::Vm);
let elements : integer = 64 DIV esize;
let regs : integer = if Q == '0' then 1 else 2;</pstext></ps>
      </ps_section>
    </iclass>
  </classes>
  <explanations scope="all">
    <explanation enclist="VCADD_A1_D, VCADD_A1_Q, VCADD_T1_D, VCADD_T1_Q" symboldefcount="1">
      <symbol link="qw_option">&lt;q&gt;</symbol>
      <account encodedin="">
        <intro>
          <para>See <xref linkend="Babbefhf">Standard assembler syntax fields</xref>.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_D, VCADD_A1_Q, VCADD_T1_D, VCADD_T1_Q" symboldefcount="1">
      <symbol link="dt_option__3">&lt;dt&gt;</symbol>
      <definition encodedin="S">
        <intro>Is the data type for the elements of the vectors, </intro>
        <table class="valuetable">
          <tgroup cols="2">
            <thead>
              <row>
                <entry class="bitfield">S</entry>
                <entry class="symbol">&lt;dt&gt;</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry class="bitfield">0</entry>
                <entry class="symbol">F16</entry>
              </row>
              <row>
                <entry class="bitfield">1</entry>
                <entry class="symbol">F32</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </definition>
    </explanation>
    <explanation enclist="VCADD_A1_D, VCADD_T1_D" symboldefcount="1">
      <symbol link="D_Vd">&lt;Dd&gt;</symbol>
      <account encodedin="(D :: Vd)">
        <intro>
          <para>Is the 64-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_D, VCADD_T1_D" symboldefcount="1">
      <symbol link="N_Vn">&lt;Dn&gt;</symbol>
      <account encodedin="(N :: Vn)">
        <intro>
          <para>Is the 64-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_D, VCADD_T1_D" symboldefcount="1">
      <symbol link="M_Vm">&lt;Dm&gt;</symbol>
      <account encodedin="(M :: Vm)">
        <intro>
          <para>Is the 64-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_D, VCADD_A1_Q, VCADD_T1_D, VCADD_T1_Q" symboldefcount="1">
      <symbol link="rotate_option__4">&lt;rotate&gt;</symbol>
      <definition encodedin="rot">
        <intro>Is the rotation to be applied to elements in the second SIMD&amp;FP source register, </intro>
        <table class="valuetable">
          <tgroup cols="2">
            <thead>
              <row>
                <entry class="bitfield">rot</entry>
                <entry class="symbol">&lt;rotate&gt;</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry class="bitfield">0</entry>
                <entry class="symbol">90</entry>
              </row>
              <row>
                <entry class="bitfield">1</entry>
                <entry class="symbol">270</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </definition>
    </explanation>
    <explanation enclist="VCADD_A1_Q, VCADD_T1_Q" symboldefcount="1">
      <symbol link="D_Vd__4">&lt;Qd&gt;</symbol>
      <account encodedin="(D :: Vd)">
        <intro>
          <para>Is the 128-bit name of the SIMD&amp;FP destination register, encoded in the &quot;D:Vd&quot; field as &lt;Qd&gt;*2.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_Q, VCADD_T1_Q" symboldefcount="1">
      <symbol link="N_Vn__2">&lt;Qn&gt;</symbol>
      <account encodedin="(N :: Vn)">
        <intro>
          <para>Is the 128-bit name of the first SIMD&amp;FP source register, encoded in the &quot;N:Vn&quot; field as &lt;Qn&gt;*2.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="VCADD_A1_Q, VCADD_T1_Q" symboldefcount="1">
      <symbol link="M_Vm__5">&lt;Qm&gt;</symbol>
      <account encodedin="(M :: Vm)">
        <intro>
          <para>Is the 128-bit name of the second SIMD&amp;FP source register, encoded in the &quot;M:Vm&quot; field as &lt;Qm&gt;*2.</para>
        </intro>
      </account>
    </explanation>
  </explanations>
  <ps_section howmany="1">
    <ps name="A32.cops_as.advsimdext.simd3reg_sameext.VCADD_A1_D" sections="1" secttype="Operation">
      <pstext mayhavelinks="1" section="Execute" rep_section="execute">EncodingSpecificOperations();
<a link="func_CheckAdvSIMDEnabled_0" file="shared_pseudocode.xml">CheckAdvSIMDEnabled</a>();
for r = 0 to regs-1 do
    let operand1 : bits(64) = <a link="accessor_D_1" file="shared_pseudocode.xml">D</a>(n+r);
    let operand2 : bits(64) = <a link="accessor_D_1" file="shared_pseudocode.xml">D</a>(m+r);
    let fpcr : FPCR_Type = <a link="func_StandardFPCR_0" file="shared_pseudocode.xml">StandardFPCR</a>();
    for e = 0 to (elements DIV 2)-1 do
        var element1 : bits(esize);
        var element3 : bits(esize);
        case rot of
            when '0' =&gt;
                element1 = <a link="func_FPNeg_3" file="shared_pseudocode.xml">FPNeg</a>{esize}(operand2[(e*2+1)*:esize], fpcr);
                element3 = operand2[(e*2)*:esize];
            when '1' =&gt;
                element1 = operand2[(e*2+1)*:esize];
                element3 = <a link="func_FPNeg_3" file="shared_pseudocode.xml">FPNeg</a>{esize}(operand2[(e*2)*:esize], fpcr);
        end;
        let result1 : bits(esize) = FPAdd{}(operand1[(e*2)*:esize],element1,fpcr);
        let result2 : bits(esize) = FPAdd{}(operand1[(e*2+1)*:esize],element3,fpcr);
        <a link="accessor_D_1" file="shared_pseudocode.xml">D</a>(d+r)[(e*2)*:esize] = result1;
        <a link="accessor_D_1" file="shared_pseudocode.xml">D</a>(d+r)[(e*2+1)*:esize] = result2;
    end;
end;</pstext></ps>
  </ps_section>
  <timestamp>2026-03-26 20:27:25</timestamp>
  <commit_id>2026-03_rel</commit_id>
</instructionsection>