<?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-2025 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="LDR_l" title="LDR (literal) -- AArch32" type="instruction">
  <docvars>
    <docvar key="address-form" value="literal"/>
    <docvar key="instr-class" value="general"/>
    <docvar key="mnemonic" value="LDR"/>
  </docvars>
  <heading>LDR (literal)</heading>
  <desc>
    <brief>
      <para>Load Register (literal)</para>
    </brief>
    <authored>
      <para>Load Register (literal) calculates an address from the PC value and
an immediate offset, loads a word from memory, and writes it to a
register. For information about memory accesses see
<xref linkend="ARMARM_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="ARMARM_CJAEGDJC">Architectural Constraints on UNPREDICTABLE behaviors</xref>.</para>
    </encodingnotes>
    <syntaxnotes>
      <para>The alternative syntax permits the addition or subtraction of the offset and the immediate offset to be specified separately, including permitting a subtraction of 0 that cannot be specified using the normal syntax. For more information, see <xref linkend="ARMARM_BABGCIBA">Use of labels in UAL instruction syntax</xref>.</para>
    </syntaxnotes>
  </desc>
  <operationalnotes>
    <operationalnote>
      <operationalnote_content>
        <para>This instruction is a data-independent-time instruction as described in <xref linkend="ARMARM_BEIIDCEG">About the DIT bit</xref>.</para>
      </operationalnote_content>
    </operationalnote>
  </operationalnotes>
  <alias_list howmany="0"/>
  <classes>
    <classesintro count="3">
      <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> and </txt>
      <a href="#iclass_t2">T2</a>
      <txt>)</txt>
      <txt>.</txt>
    </classesintro>
    <iclass name="A1" oneof="3" id="iclass_a1" no_encodings="1" isa="A32">
      <docvars>
        <docvar key="address-form" value="literal"/>
        <docvar key="armarmheading" value="A1"/>
        <docvar key="instr-class" value="general"/>
        <docvar key="isa" value="A32"/>
        <docvar key="mnemonic" value="LDR"/>
      </docvars>
      <iclassintro count="1"/>
      <regdiagram form="32" psname="A32.ldstimm.LDR_l_A1" 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>1</c>
          <c>0</c>
        </box>
        <box hibit="24" width="1" name="P" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="23" width="1" name="U" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="22" name="op2" usename="1" settings="1" psbits="x">
          <c>0</c>
        </box>
        <box hibit="21" width="1" name="W" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="20" name="op1" usename="1" settings="1" psbits="x">
          <c>1</c>
        </box>
        <box hibit="19" width="4" name="Rn" usename="1" settings="4" psbits="xxxx">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
        </box>
        <box hibit="15" width="4" name="Rt" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="11" width="12" name="imm12" usename="1">
          <c colspan="12"/>
        </box>
      </regdiagram>
      <encoding name="LDR_l_A1" oneofinclass="1" oneof="3" label="" bitdiffs="!(P == 0 &amp;&amp; W == 1)">
        <docvars>
          <docvar key="address-form" value="literal"/>
          <docvar key="armarmheading" value="A1"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="A32"/>
          <docvar key="mnemonic" value="LDR"/>
        </docvars>
        <asmtemplate comment="Normal form"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&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="For the &quot;A1&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field. The PC can be used. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see x[Pseudocode description of operations on the AArch32 general-purpose registers and the PC](BEICJFEH)." link="Rt__5">&lt;Rt&gt;</a><text>, </text><a hover="For the &quot;A1&quot; and &quot;T2&quot; variants: the label of the literal data item that is to be loaded into &lt;Rt&gt;. The assembler calculates the required value of the offset from the Align(PC, 4) value of the instruction to this label. Permitted values of the offset are -4095 to 4095." link="imm__24">&lt;label&gt;</a></asmtemplate>
        <asmtemplate comment="Alternative form"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&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="For the &quot;A1&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field. The PC can be used. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see x[Pseudocode description of operations on the AArch32 general-purpose registers and the PC](BEICJFEH)." link="Rt__5">&lt;Rt&gt;</a><text>, [PC, #{</text><a hover="Specifies the offset is added to or subtracted from the base register, defaulting to + if omitted and " link="plus_or_minus_option">+/-</a><text>}</text><a hover="For the &quot;A1&quot; variant: is the 12-bit unsigned immediate byte offset, in the range 0 to 4095, defaulting to 0 if omitted, and encoded in the &quot;imm12&quot; field." link="imm__25">&lt;imm&gt;</a><text>]</text></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="A32.ldstimm.LDR_l_A1" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">if P == '0' &amp;&amp; W == '1' then See("LDRT"); end;
let t : integer = UInt(Rt);
let imm32 : bits(32) = ZeroExtend{}(imm12);
let add : boolean = (U == '1');
let wback : boolean = (P == '0') || (W == '1');
if wback then UnpredictableProcedure(); end;</pstext></ps>
      </ps_section>
      <constrained_unpredictables encoding="A1" ps_block="Decode">
        <cu_case>
          <cu_cause>
            <pstext mayhavelinks="1">wback</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="wback = FALSE;"/>
          </cu_type>
          <cu_type>
            <cu_type_text>The instruction treats bit[24] as the P bit, and bit[21] as the writeback (W) bit, and uses the same addressing mode as described in <xref linkend="A32T32-base.instructions.LDR_i">LDR (immediate)</xref>. The instruction uses post-indexed addressing when P == '0' and uses pre-indexed addressing otherwise. The instruction is handled as described in <xref linkend="CEGHJGEF">Using R15</xref>.</cu_type_text>
          </cu_type>
        </cu_case>
      </constrained_unpredictables>
    </iclass>
    <iclass name="T1" oneof="3" id="iclass_t1" no_encodings="1" isa="T32">
      <docvars>
        <docvar key="address-form" value="literal"/>
        <docvar key="armarmheading" value="T1"/>
        <docvar key="instr-class" value="general"/>
        <docvar key="isa" value="T32"/>
        <docvar key="mnemonic" value="LDR"/>
      </docvars>
      <iclassintro count="1"/>
      <regdiagram form="16" psname="T32.n.ldlit16.LDR_l_T1">
        <box hibit="15" width="5" settings="5">
          <c>0</c>
          <c>1</c>
          <c>0</c>
          <c>0</c>
          <c>1</c>
        </box>
        <box hibit="10" width="3" name="Rt" usename="1">
          <c colspan="3"/>
        </box>
        <box hibit="7" width="8" name="imm8" usename="1">
          <c colspan="8"/>
        </box>
      </regdiagram>
      <encoding name="LDR_l_T1" oneofinclass="1" oneof="3" label="">
        <docvars>
          <docvar key="address-form" value="literal"/>
          <docvar key="armarmheading" value="T1"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="T32"/>
          <docvar key="mnemonic" value="LDR"/>
        </docvars>
        <asmtemplate comment="Normal form"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&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="For the &quot;T1&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field." link="Rt__8">&lt;Rt&gt;</a><text>, </text><a hover="For the &quot;T1&quot; variant: the label of the literal data item that is to be loaded into &lt;Rt&gt;. The assembler calculates the required value of the offset from the Align(PC, 4) value of the instruction to this label. Permitted values of the offset are Multiples of four in the range 0 to 1020." link="imm__119">&lt;label&gt;</a></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="T32.n.ldlit16.LDR_l_T1" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">let t : integer = UInt(Rt);
let imm32 : bits(32) = ZeroExtend{}(imm8::'00');
let add : boolean = TRUE;</pstext></ps>
      </ps_section>
    </iclass>
    <iclass name="T2" oneof="3" id="iclass_t2" no_encodings="1" isa="T32">
      <docvars>
        <docvar key="address-form" value="literal"/>
        <docvar key="armarmheading" value="T2"/>
        <docvar key="instr-class" value="general"/>
        <docvar key="isa" value="T32"/>
        <docvar key="mnemonic" value="LDR"/>
      </docvars>
      <iclassintro count="1"/>
      <regdiagram form="16x2" psname="T32.w.ldst.ldlit_unsigned.LDR_l_T2" 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="1" settings="1">
          <c>0</c>
        </box>
        <box hibit="23" width="1" name="U" usename="1">
          <c colspan="1"/>
        </box>
        <box hibit="22" width="2" name="size" usename="1" settings="2" psbits="xx">
          <c>1</c>
          <c>0</c>
        </box>
        <box hibit="20" name="L" usename="1" settings="1" psbits="x">
          <c>1</c>
        </box>
        <box hibit="19" width="4" settings="4">
          <c>1</c>
          <c>1</c>
          <c>1</c>
          <c>1</c>
        </box>
        <box hibit="15" width="4" name="Rt" usename="1">
          <c colspan="4"/>
        </box>
        <box hibit="11" width="12" name="imm12" usename="1">
          <c colspan="12"/>
        </box>
      </regdiagram>
      <encoding name="LDR_l_T2" oneofinclass="1" oneof="3" label="">
        <docvars>
          <docvar key="address-form" value="literal"/>
          <docvar key="armarmheading" value="T2"/>
          <docvar key="instr-class" value="general"/>
          <docvar key="isa" value="T32"/>
          <docvar key="mnemonic" value="LDR"/>
        </docvars>
        <asmtemplate comment="Preferred syntax"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&lt;c&gt;</a><text>}.W  </text><a hover="For the &quot;T2&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field. The SP can be used. The PC can be used, provided the instruction is either outside an IT block or the last instruction of an IT block. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see x[Pseudocode description of operations on the AArch32 general-purpose registers and the PC](BEICJFEH)." link="Rt__20">&lt;Rt&gt;</a><text>, </text><a hover="For the &quot;A1&quot; and &quot;T2&quot; variants: the label of the literal data item that is to be loaded into &lt;Rt&gt;. The assembler calculates the required value of the offset from the Align(PC, 4) value of the instruction to this label. Permitted values of the offset are -4095 to 4095." link="imm__24">&lt;label&gt;</a></asmtemplate>
        <asmtemplate comment="Preferred syntax, and &lt;Rt&gt;, &lt;label&gt; can be represented in T1"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&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="For the &quot;T2&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field. The SP can be used. The PC can be used, provided the instruction is either outside an IT block or the last instruction of an IT block. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see x[Pseudocode description of operations on the AArch32 general-purpose registers and the PC](BEICJFEH)." link="Rt__20">&lt;Rt&gt;</a><text>, </text><a hover="For the &quot;A1&quot; and &quot;T2&quot; variants: the label of the literal data item that is to be loaded into &lt;Rt&gt;. The assembler calculates the required value of the offset from the Align(PC, 4) value of the instruction to this label. Permitted values of the offset are -4095 to 4095." link="imm__24">&lt;label&gt;</a></asmtemplate>
        <asmtemplate comment="Alternative syntax"><text>LDR{</text><a hover="See x[Standard assembler syntax fields](Babbefhf)." link="cond__2">&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="For the &quot;T2&quot; variant: is the general-purpose register to be transferred, encoded in the &quot;Rt&quot; field. The SP can be used. The PC can be used, provided the instruction is either outside an IT block or the last instruction of an IT block. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see x[Pseudocode description of operations on the AArch32 general-purpose registers and the PC](BEICJFEH)." link="Rt__20">&lt;Rt&gt;</a><text>, [PC, #{</text><a hover="Specifies the offset is added to or subtracted from the base register, defaulting to + if omitted and " link="plus_or_minus_option">+/-</a><text>}</text><a hover="For the &quot;T2&quot; variant: is a 12-bit unsigned immediate byte offset, in the range 0 to 4095, encoded in the &quot;imm12&quot; field." link="imm__133">&lt;imm&gt;</a><text>]</text></asmtemplate>
      </encoding>
      <ps_section howmany="1">
        <ps name="T32.w.ldst.ldlit_unsigned.LDR_l_T2" sections="1" secttype="noheading">
          <pstext mayhavelinks="1" section="Decode" rep_section="decode">let t : integer = UInt(Rt);
let imm32 : bits(32) = ZeroExtend{}(imm12);
let add : boolean = (U == '1');
if t == 15 &amp;&amp; InITBlock() &amp;&amp; !LastInITBlock() then UnpredictableProcedure(); end;</pstext></ps>
      </ps_section>
    </iclass>
  </classes>
  <explanations scope="all">
    <explanation enclist="LDR_l_A1, A1B_LDR_l_A1, LDR_l_T1, LDR_l_T2, T2B_LDR_l_T2, T2C_LDR_l_T2" symboldefcount="1">
      <symbol link="cond__2">&lt;c&gt;</symbol>
      <account encodedin="cond">
        <intro>
          <para>See <xref linkend="Babbefhf">Standard assembler syntax fields</xref>.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="LDR_l_A1, A1B_LDR_l_A1, LDR_l_T1, T2B_LDR_l_T2, T2C_LDR_l_T2" 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="LDR_l_A1, A1B_LDR_l_A1" symboldefcount="1">
      <symbol link="Rt__5">&lt;Rt&gt;</symbol>
      <account encodedin="Rt">
        <intro>
          <para>For the "A1" variant: is the general-purpose register to be transferred, encoded in the "Rt" field. The PC can be used. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see <xref linkend="BEICJFEH">Pseudocode description of operations on the AArch32 general-purpose registers and the PC</xref>.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="LDR_l_T1" symboldefcount="2">
      <symbol link="Rt__8">&lt;Rt&gt;</symbol>
      <account encodedin="Rt">
        <intro>
          <para>For the "T1" variant: is the general-purpose register to be transferred, encoded in the "Rt" field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="LDR_l_T2, T2B_LDR_l_T2, T2C_LDR_l_T2" symboldefcount="3">
      <symbol link="Rt__20">&lt;Rt&gt;</symbol>
      <account encodedin="Rt">
        <intro>
          <para>For the "T2" variant: is the general-purpose register to be transferred, encoded in the "Rt" field. The SP can be used. The PC can be used, provided the instruction is either outside an IT block or the last instruction of an IT block. If the PC is used, the instruction branches to the address (data) loaded to the PC. This is an interworking branch, see <xref linkend="BEICJFEH">Pseudocode description of operations on the AArch32 general-purpose registers and the PC</xref>.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="LDR_l_A1, LDR_l_T2, T2B_LDR_l_T2" symboldefcount="1">
      <symbol link="imm__24">&lt;label&gt;</symbol>
      <account encodedin="imm12">
        <intro>
          <para>For the "A1" and "T2" variants: the label of the literal data item that is to be loaded into <syntax>&lt;Rt&gt;</syntax>. The assembler calculates the required value of the offset from the <function>Align(PC, 4)</function> value of the instruction to this label. Permitted values of the offset are -4095 to 4095.</para>
          <para>If the offset is zero or positive, <field>imm32</field> is equal to the offset and <field>add</field> == <enumvalue>TRUE</enumvalue>, encoded as U == 1.</para>
          <para>If the offset is negative, <field>imm32</field> is equal to minus the offset and <field>add</field> == <enumvalue>FALSE</enumvalue>, encoded as U == 0.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="LDR_l_T1" symboldefcount="2">
      <symbol link="imm__119">&lt;label&gt;</symbol>
      <account encodedin="imm8">
        <intro>
          <para>For the "T1" variant: the label of the literal data item that is to be loaded into <syntax>&lt;Rt&gt;</syntax>. The assembler calculates the required value of the offset from the <function>Align(PC, 4)</function> value of the instruction to this label. Permitted values of the offset are Multiples of four in the range 0 to 1020.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="A1B_LDR_l_A1, T2C_LDR_l_T2" symboldefcount="1">
      <symbol link="plus_or_minus_option">+/-</symbol>
      <definition encodedin="U">
        <intro>Specifies the offset 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="A1B_LDR_l_A1" symboldefcount="1">
      <symbol link="imm__25">&lt;imm&gt;</symbol>
      <account encodedin="imm12">
        <intro>
          <para>For the "A1" variant: is the 12-bit unsigned immediate byte offset, in the range 0 to 4095, defaulting to 0 if omitted, and encoded in the "imm12" field.</para>
        </intro>
      </account>
    </explanation>
    <explanation enclist="T2C_LDR_l_T2" symboldefcount="2">
      <symbol link="imm__133">&lt;imm&gt;</symbol>
      <account encodedin="imm12">
        <intro>
          <para>For the "T2" variant: is a 12-bit unsigned immediate byte offset, in the range 0 to 4095, encoded in the "imm12" field.</para>
        </intro>
      </account>
    </explanation>
  </explanations>
  <ps_section howmany="1">
    <ps name="A32.ldstimm.LDR_l_A1" sections="1" secttype="Operation">
      <pstext mayhavelinks="1" section="Execute" rep_section="execute">if ConditionPassed() then
    EncodingSpecificOperations();
    let base : bits(32) = AlignDownSize(PC32(),4);
    let address : bits(32) = if add then (base + imm32) else (base - imm32);
    let data : bits(32) = MemU{32}(address);
    if t == 15 then
        if address[1:0] == '00' then
            LoadWritePC(data);
        else
            UnpredictableProcedure();
        end;
    else
        R(t) = data;
    end;
end;</pstext></ps>
  </ps_section>
  <timestamp>2026-03-12 12:23:09</timestamp>
  <commit_id>2025-09_rel_asl1</commit_id>
</instructionsection>
