<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE register_page SYSTEM "registers.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. -->
<!--The data contained in this document is preliminary and subject to change or correction following further review. -->
<?xml-stylesheet href="one_register.xsl" type="text/xsl" ?>







<register_page>
  <registers>
  
    <register execution_state="AArch32" is_register="True" is_internal="True" is_stub_entry="False">
      <reg_short_name>ICH_AP0R&lt;n&gt;</reg_short_name>
        
        <reg_long_name>Interrupt Controller Hyp Active Priorities Group 0 Registers</reg_long_name>



      
            <reg_condition otherwise="UNDEFINED">when FEAT_AA32EL2 is implemented, GICv3 is implemented, and (EL2 is implemented or EL3 is implemented)</reg_condition>
          <reg_array>
              <reg_array_start>0</reg_array_start>
              <reg_array_end>3</reg_array_end>
         </reg_array>
      




          <reg_reset_value></reg_reset_value>

      <reg_mappings>
        



    
      
      <reg_mapping>
        
  

    

  

    <mapped_name filename="AArch64-ich_ap0rn_el2.xml">ICH_AP0R&lt;n&gt;_EL2</mapped_name>
  <mapped_type>Architectural</mapped_type>
      <mapped_execution_state>AArch64</mapped_execution_state>
    <mapped_from_startbit>31</mapped_from_startbit>
    <mapped_from_endbit>0</mapped_from_endbit>
    <mapped_to_startbit>31</mapped_to_startbit>
    <mapped_to_endbit>0</mapped_to_endbit>
    <mapped_from_rangeset output="31:0">
      <range>
        <msb>31</msb>
        <lsb>0</lsb>
      </range>
    </mapped_from_rangeset>
    <mapped_to_rangeset output="31:0">
      <range>
        <msb>31</msb>
        <lsb>0</lsb>
      </range>
    </mapped_to_rangeset>

      </reg_mapping>

      </reg_mappings>

        <reg_purpose>
          
    
      <purpose_text>
        <para>Provides information about Group 0 active priorities for EL2.</para>
      </purpose_text>

        </reg_purpose>

      <reg_groups>
            <reg_group>GIC</reg_group>
            <reg_group>GIC Host Interface Control Registers</reg_group>
            <reg_group>Virt</reg_group>
      </reg_groups>
      <reg_configuration>
        
    
      <configuration_text>
        <para>If EL2 is not implemented, this register is <arm-defined-word>RES0</arm-defined-word> from EL3.</para>
      </configuration_text>

      </reg_configuration>
      
      
        
      <reg_attributes>
          
    
      <attributes_text>
        <para>ICH_AP0R&lt;n&gt; is a 32-bit register.</para>
      </attributes_text>

      </reg_attributes>
      <reg_fieldsets>
        






<fields id="fieldset_0" length="32">
  <text_before_fields/>
  <field id="fieldset_0-31_0" has_partial_fieldset="False" is_linked_to_partial_fieldset="False" is_access_restriction_possible="False" is_variable_length="False" is_constant_value="False" is_partial_field="False" is_conditional_field_name="False">
    <field_name>P&lt;x&gt;</field_name>
    <field_msb>31</field_msb>
    <field_lsb>0</field_lsb>
    <rel_range>31:0</rel_range>
    <field_description order="before">
      <para>Provides the access to the virtual active priorities for Group 0 interrupts. Possible values of each bit are:</para>
    </field_description>
    <field_description order="after"><para>The correspondence between priority levels and bits depends on the number of bits of priority that are implemented.</para>
<para>If 5 bits of preemption are implemented (bits [7:3] of priority), then there are 32 preemption levels, and the active state of these preemption levels are held in ICH_AP0R0 in the bits corresponding to Priority[7:3].</para>
<para>If 6 bits of preemption are implemented (bits [7:2] of priority), then there are 64 preemption levels, and:</para>
<list type="unordered">
<listitem><content>The active state of preemption levels 0 - 124 are held in ICH_AP0R0 in the bits corresponding to 0:Priority[6:2].</content>
</listitem><listitem><content>The active state of preemption levels 128 - 252 are held in ICH_AP0R1 in the bits corresponding to 1:Priority[6:2].</content>
</listitem></list>
<para>If 7 bits of preemption are implemented (bits [7:1] of priority), then there are 128 preemption levels, and:</para>
<list type="unordered">
<listitem><content>The active state of preemption levels 0 - 62 are held in ICH_AP0R0 in the bits corresponding to 00:Priority[5:1].</content>
</listitem><listitem><content>The active state of preemption levels 64 - 126 are held in ICH_AP0R1 in the bits corresponding to 01:Priority[5:1].</content>
</listitem><listitem><content>The active state of preemption levels 128 - 190 are held in ICH_AP0R2 in the bits corresponding to 10:Priority[5:1].</content>
</listitem><listitem><content>The active state of preemption levels 192 - 254 are held in ICH_AP0R3 in the bits corresponding to 11:Priority[5:1].</content>
</listitem></list>
<note><para>Having the bit corresponding to a priority set to 1 in both ICH_AP0R&lt;n&gt; and <register_link state="AArch32" id="AArch32-ich_ap1rn.xml">ICH_AP1R&lt;n&gt;</register_link> might result in <arm-defined-word>UNPREDICTABLE</arm-defined-word> behavior of the interrupt prioritization system for virtual interrupts.</para></note></field_description>
    <field_array_indexes index_variable="x" element_size="1" range_specifier="x">
      <field_array_index>
        <field_array_start>31</field_array_start>
        <field_array_end>0</field_array_end>
      </field_array_index>
    </field_array_indexes>
    <field_values impdef="False">
      <field_value_instance>
        <field_value>0b0</field_value>
        <field_value_description>
          <para>There is no Group 0 interrupt active at the priority corresponding to that bit.</para>
        </field_value_description>
      </field_value_instance>
      <field_value_instance>
        <field_value>0b1</field_value>
        <field_value_description>
          <para>There is a Group 0 interrupt active at the priority corresponding to that bit.</para>
        </field_value_description>
      </field_value_instance>
    </field_values>
    <field_resets>
      <field_reset reset_type="Warm">
        <field_reset_expression>0x00000000</field_reset_expression>
      </field_reset>
    </field_resets>
  </field>
  <text_after_fields/>
</fields>




<reg_fieldset length="32">
  <fieldat id="fieldset_0-31_0" label="P31" msb="31" lsb="31"/>
  <fieldat id="fieldset_0-31_0" label="P30" msb="30" lsb="30"/>
  <fieldat id="fieldset_0-31_0" label="P29" msb="29" lsb="29"/>
  <fieldat id="fieldset_0-31_0" label="P28" msb="28" lsb="28"/>
  <fieldat id="fieldset_0-31_0" label="P27" msb="27" lsb="27"/>
  <fieldat id="fieldset_0-31_0" label="P26" msb="26" lsb="26"/>
  <fieldat id="fieldset_0-31_0" label="P25" msb="25" lsb="25"/>
  <fieldat id="fieldset_0-31_0" label="P24" msb="24" lsb="24"/>
  <fieldat id="fieldset_0-31_0" label="P23" msb="23" lsb="23"/>
  <fieldat id="fieldset_0-31_0" label="P22" msb="22" lsb="22"/>
  <fieldat id="fieldset_0-31_0" label="P21" msb="21" lsb="21"/>
  <fieldat id="fieldset_0-31_0" label="P20" msb="20" lsb="20"/>
  <fieldat id="fieldset_0-31_0" label="P19" msb="19" lsb="19"/>
  <fieldat id="fieldset_0-31_0" label="P18" msb="18" lsb="18"/>
  <fieldat id="fieldset_0-31_0" label="P17" msb="17" lsb="17"/>
  <fieldat id="fieldset_0-31_0" label="P16" msb="16" lsb="16"/>
  <fieldat id="fieldset_0-31_0" label="P15" msb="15" lsb="15"/>
  <fieldat id="fieldset_0-31_0" label="P14" msb="14" lsb="14"/>
  <fieldat id="fieldset_0-31_0" label="P13" msb="13" lsb="13"/>
  <fieldat id="fieldset_0-31_0" label="P12" msb="12" lsb="12"/>
  <fieldat id="fieldset_0-31_0" label="P11" msb="11" lsb="11"/>
  <fieldat id="fieldset_0-31_0" label="P10" msb="10" lsb="10"/>
  <fieldat id="fieldset_0-31_0" label="P9" msb="9" lsb="9"/>
  <fieldat id="fieldset_0-31_0" label="P8" msb="8" lsb="8"/>
  <fieldat id="fieldset_0-31_0" label="P7" msb="7" lsb="7"/>
  <fieldat id="fieldset_0-31_0" label="P6" msb="6" lsb="6"/>
  <fieldat id="fieldset_0-31_0" label="P5" msb="5" lsb="5"/>
  <fieldat id="fieldset_0-31_0" label="P4" msb="4" lsb="4"/>
  <fieldat id="fieldset_0-31_0" label="P3" msb="3" lsb="3"/>
  <fieldat id="fieldset_0-31_0" label="P2" msb="2" lsb="2"/>
  <fieldat id="fieldset_0-31_0" label="P1" msb="1" lsb="1"/>
  <fieldat id="fieldset_0-31_0" label="P0" msb="0" lsb="0"/>
</reg_fieldset>


      </reg_fieldsets>
        <reg_variables>
              <reg_variable variable="n" max="3"/>
        </reg_variables>

      <access_mechanisms>
          


  
    
      <access_permission_text>
        <para>ICH_AP0R1 is implemented only in implementations that support 6 or more bits of preemption. ICH_AP0R2 and ICH_AP0R3 are implemented only in implementations that support 7 bits of preemption. Unimplemented registers are <arm-defined-word>UNDEFINED</arm-defined-word>.</para>

      </access_permission_text>
      <access_permission_text>
        <note><para>The number of bits of preemption is indicated by <register_link state="AArch32" id="AArch32-ich_vtr.xml">ICH_VTR</register_link>.PREbits</para></note>
      </access_permission_text>
      <access_permission_text>
        <para>Writing to the active priority registers in any order other than the following order will result in <arm-defined-word>UNPREDICTABLE</arm-defined-word> behavior:</para>

      </access_permission_text>
      <access_permission_text>
        <list type="unordered">
<listitem><content>ICH_AP0R&lt;n&gt;</content>
</listitem><listitem><content><register_link state="AArch32" id="AArch32-ich_ap1rn.xml">ICH_AP1R&lt;n&gt;</register_link></content>
</listitem></list>
      </access_permission_text>





    
        
        <access_mechanism accessor="MRC ICH_AP0R&lt;m&gt;" type="SystemAccessor">
            <encoding>
                
                <acc_array var="m">
                    <acc_array_range>0-3</acc_array_range>
                </acc_array>
            <access_instruction>MRC{&lt;c&gt;}{&lt;q&gt;} &lt;coproc&gt;, {#}&lt;opc1&gt;, &lt;Rt&gt;, &lt;CRn&gt;, &lt;CRm&gt;{, {#}&lt;opc2&gt;}</access_instruction>
                
                <enc n="coproc" v="0b1111"/>
                
                <enc n="opc1" v="0b100"/>
                
                <enc n="CRn" v="0b1100"/>
                
                <enc n="CRm" v="0b1000"/>
                
                <enc n="opc2" v="0b0:m[1:0]"/>
            </encoding>
            <access_permission>
                <ps name="MRC" sections="1" secttype="access_permission">
                <pstext>
let m:integer = UInt(opc2[1:0]);

if !(IsFeatureImplemented(FEAT_AA32EL2) &amp;&amp; IsFeatureImplemented(FEAT_GICv3) &amp;&amp; (HaveEL(EL2) || HaveEL(EL3))) then
    Undefined();
elsif m == 1 &amp;&amp; NUM_GIC_PREEMPTION_BITS &lt; 6 then
    Undefined();
elsif (m == 2 || m == 3) &amp;&amp; NUM_GIC_PREEMPTION_BITS &lt; 7 then
    Undefined();
elsif PSTATE.EL == EL0 then
    Undefined();
elsif PSTATE.EL == EL1 then
    if EL2Enabled() &amp;&amp; IsFeatureImplemented(FEAT_AA64EL2) &amp;&amp; !ELUsingAArch32(EL2) &amp;&amp; HSTR_EL2().T12 == '1' then
        AArch64_AArch32SystemAccessTrap(EL2, 0x03);
    elsif EL2Enabled() &amp;&amp; IsFeatureImplemented(FEAT_AA32EL2) &amp;&amp; ELUsingAArch32(EL2) &amp;&amp; HSTR().T12 == '1' then
        AArch32_TakeHypTrapException(0x03);
    else
        Undefined();
    end;
elsif PSTATE.EL == EL2 then
    if ICC_HSRE().SRE == '0' then
        Undefined();
    else
        R(t) = ICH_AP0R(m);
    end;
elsif PSTATE.EL == EL3 then
    if ICC_MSRE().SRE == '0' then
        Undefined();
    else
        R(t) = ICH_AP0R(m);
    end;
end;
                </pstext>
                </ps>
            </access_permission>
        </access_mechanism>
    
        
        <access_mechanism accessor="MCR ICH_AP0R&lt;m&gt;" type="SystemAccessor">
            <encoding>
                
                <acc_array var="m">
                    <acc_array_range>0-3</acc_array_range>
                </acc_array>
            <access_instruction>MCR{&lt;c&gt;}{&lt;q&gt;} &lt;coproc&gt;, {#}&lt;opc1&gt;, &lt;Rt&gt;, &lt;CRn&gt;, &lt;CRm&gt;{, {#}&lt;opc2&gt;}</access_instruction>
                
                <enc n="coproc" v="0b1111"/>
                
                <enc n="opc1" v="0b100"/>
                
                <enc n="CRn" v="0b1100"/>
                
                <enc n="CRm" v="0b1000"/>
                
                <enc n="opc2" v="0b0:m[1:0]"/>
            </encoding>
            <access_permission>
                <ps name="MCR" sections="1" secttype="access_permission">
                <pstext>
let m:integer = UInt(opc2[1:0]);

if !(IsFeatureImplemented(FEAT_AA32EL2) &amp;&amp; IsFeatureImplemented(FEAT_GICv3) &amp;&amp; (HaveEL(EL2) || HaveEL(EL3))) then
    Undefined();
elsif m == 1 &amp;&amp; NUM_GIC_PREEMPTION_BITS &lt; 6 then
    Undefined();
elsif (m == 2 || m == 3) &amp;&amp; NUM_GIC_PREEMPTION_BITS &lt; 7 then
    Undefined();
elsif PSTATE.EL == EL0 then
    Undefined();
elsif PSTATE.EL == EL1 then
    if EL2Enabled() &amp;&amp; IsFeatureImplemented(FEAT_AA64EL2) &amp;&amp; !ELUsingAArch32(EL2) &amp;&amp; HSTR_EL2().T12 == '1' then
        AArch64_AArch32SystemAccessTrap(EL2, 0x03);
    elsif EL2Enabled() &amp;&amp; IsFeatureImplemented(FEAT_AA32EL2) &amp;&amp; ELUsingAArch32(EL2) &amp;&amp; HSTR().T12 == '1' then
        AArch32_TakeHypTrapException(0x03);
    else
        Undefined();
    end;
elsif PSTATE.EL == EL2 then
    if ICC_HSRE().SRE == '0' then
        Undefined();
    else
        ICH_AP0R(m) = R(t);
    end;
elsif PSTATE.EL == EL3 then
    if ICC_MSRE().SRE == '0' then
        Undefined();
    else
        ICH_AP0R(m) = R(t);
    end;
end;
                </pstext>
                </ps>
            </access_permission>
        </access_mechanism>

      </access_mechanisms>

      <arch_variants>
      </arch_variants>
  </register>
</registers>
<timestamp>2026-03-26 20:27:25</timestamp>
<commit_id>2026-03_rel</commit_id>
</register_page>