<?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="PLI_r" title="PLI (register) -- AArch32" type="instruction">
  <docvars>
    <docvar key="instr-class" value="general"/>
    <docvar key="mnemonic" value="PLI"/>
  </docvars>
  <heading>PLI (register)</heading>
  <desc>
    <brief>
      <para>Preload Instruction (register)</para>
    </brief>
    <authored>
      <para>Preload Instruction signals the memory system that instruction
memory accesses from a specified address are likely in the near
future. The memory system can respond by taking actions that are
expected to speed up the memory accesses when they do occur, such
as pre-loading the cache line containing the specified address into
the instruction cache.</para>
      <para>The effect of a <instruction>PLI</instruction> instruction
is <arm-defined-word>IMPLEMENTATION DEFINED</arm-defined-word>.
For more information, see <xref linkend="ARMARM_CEGJJFCA">Preloading caches</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="ARMARM_CJAEGDJC">Architectural Constraints on UNPREDICTABLE behaviors</xref>.</para>
    </encodingnotes>
  </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="general"/>
        <docvar key="isa" value="A32"/>
        <docvar key="mnemonic" value="PLI"/>
      </docvars>
      <iclassintro count="2"/>
      <regdiagram form="32" psname="A32.uncond_as.uncondhints.preload_reg.PLI_r_A1_RRX" tworows="1">
        <box hibit="31" width="7" settings="7">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>0</c>
          <c>1</c>
          <c>1</c>
        </box>
        <box hibit="24" name="D" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="23" width="1" name="U" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="22" name="o2" usename="1" settings="1" psbits="x">
          <c>1</c>
        </box>
        <box hibit="21" width="2" settings="2">
          <c>0</c>
          <c>1</c>
        </box>
        <box hibit="19" width="4" name="Rn" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="15" width="4" settings="4">
          <c>(1)</c>
          <c>(1)</c>
          <c>(1)</c>
          <c>(1)</c>
        </box>
        <box hibit="11" width="5" name="imm5" usename="1">
          <c colspan="5"/>
        </box>
        <box hibit="6" width="2" name="stype" usename="1">
          <c colspan="2"/>
        </box>
        <box hibit="4" width="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="3" width="4" name="Rm" usename="1">
          <c colspan="4"/>
        </box>
      </regdiagram>
      <encoding name="PLI_r_A1_RRX" oneofinclass="2" oneof="3" label="Rotate right with extend" bitdiffs="imm5 == 00000 &amp;&amp; stype == 11">
        <docvars>
          <docvar key="armarmheading" value="A1"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="A32"/>
          <docvar key="mnemonic" value="PLI"/>
          <docvar key="mnemonic-shift-type" value="PLI-rrx"/>
          <docvar key="shift-type" value="rrx"/>
        </docvars>
        <box hibit="11" width="5" name="imm5">
          <c>0</c>
          <c>0</c>
          <c>0</c>
          <c>0</c>
          <c>0</c>
        </box>
        <box hibit="6" width="2" name="stype">
          <c>1</c>
          <c>1</c>
        </box>
        <asmtemplate><text>PLI{</text><a hover="For the &quot;Rotate right with extend&quot; and &quot;Shift or rotate by value&quot; variants: see x[Standard assembler syntax fields](Babbefhf). &lt;c&gt; must be AL or omitted." link="AL_option">&lt;c&gt;</a><text>}{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}  [</text><a hover="Is the general-purpose base register, encoded in the &quot;Rn&quot; field." link="Rn__12">&lt;Rn&gt;</a><text>, {</text><a hover="Specifies the index register is added to or subtracted from the base register, defaulting to + if omitted and " link="plus_or_minus_option__3">+/-</a><text>}</text><a hover="Is the general-purpose index register, encoded in the &quot;Rm&quot; field." link="Rm__16">&lt;Rm&gt;</a><text> , RRX]</text></asmtemplate>
      </encoding>
      <encoding name="PLI_r_A1" oneofinclass="2" oneof="3" label="Shift or rotate by value" bitdiffs="!(imm5 == 00000 &amp;&amp; stype == 11)">
        <docvars>
          <docvar key="armarmheading" value="A1"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="A32"/>
          <docvar key="mnemonic" value="PLI"/>
          <docvar key="mnemonic-shift-type" value="PLI-shift-no-rrx"/>
          <docvar key="shift-type" value="shift-no-rrx"/>
        </docvars>
        <asmtemplate><text>PLI{</text><a hover="For the &quot;Rotate right with extend&quot; and &quot;Shift or rotate by value&quot; variants: see x[Standard assembler syntax fields](Babbefhf). &lt;c&gt; must be AL or omitted." link="AL_option">&lt;c&gt;</a><text>}{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}  [</text><a hover="Is the general-purpose base register, encoded in the &quot;Rn&quot; field." link="Rn__12">&lt;Rn&gt;</a><text>, {</text><a hover="Specifies the index register is added to or subtracted from the base register, defaulting to + if omitted and " link="plus_or_minus_option__3">+/-</a><text>}</text><a hover="Is the general-purpose index register, encoded in the &quot;Rm&quot; field." link="Rm__16">&lt;Rm&gt;</a><text> {, </text><a hover="Is the type of shift to be applied to the index register, " link="shift_option__9">&lt;shift&gt;</a><text> #</text><a hover="For the &quot;Shift or rotate by value&quot; variant: 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 &quot;imm5&quot; field as &lt;amount&gt; modulo 32." link="amount__2">&lt;amount&gt;</a><text>}]</text></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="A32.uncond_as.uncondhints.preload_reg.PLI_r_A1_RRX" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">let n : integer = UInt(Rn);
let m : integer = UInt(Rm);
let add : boolean = (U == '1');
let (shift_t, shift_n) : (<a link="type_SRType" file="shared_pseudocode.xml">SRType</a>, integer) = <a link="func_DecodeImmShift_2" file="shared_pseudocode.xml">DecodeImmShift</a>(stype, imm5);
if m == 15 then UnpredictableProcedure(); end;</pstext></ps>
      </ps_section>
    </iclass>
    <iclass name="T1" oneof="2" id="iclass_t1" no_encodings="1" isa="T32">
      <docvars>
        <docvar key="address-form" value="register-offset"/>
        <docvar key="armarmheading" value="T1"/>
        <docvar key="instr-class" value="general"/>
        <docvar key="isa" value="T32"/>
        <docvar key="mnemonic" value="PLI"/>
      </docvars>
      <iclassintro count="1"/>
      <regdiagram form="16x2" psname="T32.w.ldst.ldst_signed_reg.PLI_r_T1" tworows="1">
        <box hibit="31" width="3" settings="3">
          <c>1</c>
          <c>1</c>
          <c>1</c>
        </box>
        <box hibit="28" width="4" settings="4">
          <c>1</c>
          <c>1</c>
          <c>0</c>
          <c>0</c>
        </box>
        <box hibit="24" width="2" settings="2">
          <c>1</c>
          <c>0</c>
        </box>
        <box hibit="22" width="2" name="size" usename="1" settings="2" psbits="xx">
          <c>0</c>
          <c>0</c>
        </box>
        <box hibit="20" width="1" settings="1">
          <c>1</c>
        </box>
        <box hibit="19" width="4" name="Rn" usename="1" settings="4" constraint="!= 1111">
          <c colspan="4">!= 1111</c>
        </box>
        <box hibit="15" width="4" name="Rt" usename="1" settings="4" psbits="xxxx">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
        </box>
        <box hibit="11" width="6" settings="6">
          <c>0</c>
          <c>0</c>
          <c>0</c>
          <c>0</c>
          <c>0</c>
          <c>0</c>
        </box>
        <box hibit="5" width="2" name="imm2" usename="1">
          <c colspan="2"/>
        </box>
        <box hibit="3" width="4" name="Rm" usename="1">
          <c colspan="4"/>
        </box>
      </regdiagram>
      <encoding name="PLI_r_T1" oneofinclass="1" oneof="3" label="">
        <docvars>
          <docvar key="address-form" value="register-offset"/>
          <docvar key="armarmheading" value="T1"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="T32"/>
          <docvar key="mnemonic" value="PLI"/>
        </docvars>
        <asmtemplate><text>PLI{</text><a hover="For the &quot;T1&quot; variant: see x[Standard assembler syntax fields](Babbefhf)." link="AL_option__6">&lt;c&gt;</a><text>}{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="qw_option">&lt;q&gt;</a><text>}  [</text><a hover="Is the general-purpose base register, encoded in the &quot;Rn&quot; field." link="Rn__12">&lt;Rn&gt;</a><text>, {</text><a hover="Specifies the index register is added to the base register." link="opt_plus">+</a><text>}</text><a hover="Is the general-purpose index register, encoded in the &quot;Rm&quot; field." link="Rm__16">&lt;Rm&gt;</a><text> {, LSL #</text><a hover="For the &quot;T1&quot; variant: is the shift amount, in the range 0 to 3, defaulting to 0 and encoded in the &quot;imm2&quot; field." link="amount__16">&lt;amount&gt;</a><text>}]</text></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="T32.w.ldst.ldst_signed_reg.PLI_r_T1" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">if Rn == '1111' then See(&quot;PLI (immediate, literal)&quot;); end;
let n : integer = UInt(Rn);
let m : integer = UInt(Rm);
let add : boolean = TRUE;
let shift_t : <a link="type_SRType" file="shared_pseudocode.xml">SRType</a> = <a link="enum_SRType_LSL" file="shared_pseudocode.xml">SRType_LSL</a>;
let shift_n : integer = UInt(imm2);
// Armv8-A removes UNPREDICTABLE for R13
if m == 15 then UnpredictableProcedure(); end;</pstext></ps>
      </ps_section>
    </iclass>
  </classes>
  <explanations scope="all">
    <explanation enclist="PLI_r_A1_RRX, PLI_r_A1" symboldefcount="1">
      <symbol link="AL_option">&lt;c&gt;</symbol>
      <account encodedin="">
        <intro>
          <para>For the &quot;Rotate right with extend&quot; and &quot;Shift or rotate by value&quot; variants: see <xref linkend="Babbefhf">Standard assembler syntax fields</xref>. <syntax>&lt;c&gt;</syntax> must be <value>AL</value> or omitted.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_T1" symboldefcount="2">
      <symbol link="AL_option__6">&lt;c&gt;</symbol>
      <account encodedin="">
        <intro>
          <para>For the &quot;T1&quot; variant: see <xref linkend="Babbefhf">Standard assembler syntax fields</xref>.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_A1_RRX, PLI_r_A1, PLI_r_T1" 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="PLI_r_A1_RRX, PLI_r_A1, PLI_r_T1" symboldefcount="1">
      <symbol link="Rn__12">&lt;Rn&gt;</symbol>
      <account encodedin="Rn">
        <intro>
          <para>Is the general-purpose base register, encoded in the &quot;Rn&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_A1_RRX, PLI_r_A1" symboldefcount="1">
      <symbol link="plus_or_minus_option__3">+/-</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="PLI_r_A1_RRX, PLI_r_A1, PLI_r_T1" symboldefcount="1">
      <symbol link="Rm__16">&lt;Rm&gt;</symbol>
      <account encodedin="Rm">
        <intro>
          <para>Is the general-purpose index register, encoded in the &quot;Rm&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_A1" symboldefcount="1">
      <symbol link="shift_option__9">&lt;shift&gt;</symbol>
      <definition encodedin="stype">
        <intro>Is the type of shift to be applied to the index register, </intro>
        <table class="valuetable">
          <tgroup cols="2">
            <thead>
              <row>
                <entry class="bitfield">stype</entry>
                <entry class="symbol">&lt;shift&gt;</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry class="bitfield">00</entry>
                <entry class="symbol">LSL</entry>
              </row>
              <row>
                <entry class="bitfield">01</entry>
                <entry class="symbol">LSR</entry>
              </row>
              <row>
                <entry class="bitfield">10</entry>
                <entry class="symbol">ASR</entry>
              </row>
              <row>
                <entry class="bitfield">11</entry>
                <entry class="symbol">ROR</entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </definition>
    </explanation>
    <explanation enclist="PLI_r_A1" symboldefcount="1">
      <symbol link="amount__2">&lt;amount&gt;</symbol>
      <account encodedin="imm5">
        <intro>
          <para>For the &quot;Shift or rotate by value&quot; variant: 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 &quot;imm5&quot; field as &lt;amount&gt; modulo 32.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_T1" symboldefcount="2">
      <symbol link="amount__16">&lt;amount&gt;</symbol>
      <account encodedin="imm2">
        <intro>
          <para>For the &quot;T1&quot; variant: is the shift amount, in the range 0 to 3, defaulting to 0 and encoded in the &quot;imm2&quot; field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="PLI_r_T1" symboldefcount="1">
      <symbol link="opt_plus">+</symbol>
      <account encodedin="">
        <intro>
          <para>Specifies the index register is added to the base register.</para>
        </intro>
      </account>
    </explanation>
  </explanations>
  <ps_section howmany="1">
    <ps name="A32.uncond_as.uncondhints.preload_reg.PLI_r_A1_RRX" sections="1" secttype="Operation">
      <pstext mayhavelinks="1" section="Execute" rep_section="execute">if <a link="func_ConditionPassed_0" file="shared_pseudocode.xml">ConditionPassed</a>() then
    EncodingSpecificOperations();
    let offset : bits(32) = Shift{}(<a link="accessor_R_1" file="shared_pseudocode.xml">R</a>(m), shift_t, shift_n, <a link="global_PSTATE" file="shared_pseudocode.xml">PSTATE</a>.C);
    let address : bits(32) = if add then (<a link="accessor_R_1" file="shared_pseudocode.xml">R</a>(n) + offset) else (<a link="accessor_R_1" file="shared_pseudocode.xml">R</a>(n) - offset);
    Hint_PreloadInstr(address);
end;</pstext></ps>
  </ps_section>
  <timestamp>2026-03-26 20:27:25</timestamp>
  <commit_id>2026-03_rel</commit_id>
</instructionsection>