€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œdocutils.nodes”Œsubstitution_definition”“”)”}”(hŒ&.. |AArch32| replace:: :term:`AArch32`”h]”hŒpending_xref”“”)”}”(hŒ:term:`AArch32`”h]”h Œinline”“”)”}”(hhh]”h ŒText”“”ŒAArch32”…””}”(hhŒparent”hubaŒ attributes”}”(Œids”]”Œclasses”]”(Œxref”Œstd”Œstd-term”eŒnames”]”Œdupnames”]”Œbackrefs”]”uŒtagname”hh!hubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”Œdesign/psci-pd-tree”Œ refdomain”h)Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆŒ reftarget”ŒAArch32”uh1hŒsource”Œ”Œline”Kh!hubah"}”(h$]”h&]”h+]”ŒAArch32”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ&.. |AArch64| replace:: :term:`AArch64`”h]”h)”}”(hŒ:term:`AArch64`”h]”h)”}”(hhQh]”hŒAArch64”…””}”(hhh!hSubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hOubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”h]Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAArch64”uh1hhAhBhCKh!hKubah"}”(h$]”h&]”h+]”ŒAArch64”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |AMU| replace:: :term:`AMU`”h]”h)”}”(hŒ:term:`AMU`”h]”h)”}”(hh|h]”hŒAMU”…””}”(hhh!h~ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hzubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”hˆŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAMU”uh1hhAhBhCKh!hvubah"}”(h$]”h&]”h+]”ŒAMU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ&.. |AMUs| replace:: :term:`AMUs `”h]”h)”}”(hŒ:term:`AMUs `”h]”h)”}”(hh§h]”hŒAMUs”…””}”(hhh!h©ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!h¥ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”h³Œreftype”Œterm”Œrefexplicit”ˆŒrefwarn”ˆh?ŒAMU”uh1hhAhBhCKh!h¡ubah"}”(h$]”h&]”h+]”ŒAMUs”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |API| replace:: :term:`API`”h]”h)”}”(hŒ:term:`API`”h]”h)”}”(hhÒh]”hŒAPI”…””}”(hhh!hÔubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hÐubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”hÞŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAPI”uh1hhAhBhCKh!hÌubah"}”(h$]”h&]”h+]”ŒAPI”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |BTI| replace:: :term:`BTI`”h]”h)”}”(hŒ:term:`BTI`”h]”h)”}”(hhýh]”hŒBTI”…””}”(hhh!hÿubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hûubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒBTI”uh1hhAhBhCKh!h÷ubah"}”(h$]”h&]”h+]”ŒBTI”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |CoT| replace:: :term:`CoT`”h]”h)”}”(hŒ:term:`CoT`”h]”h)”}”(hj(h]”hŒCoT”…””}”(hhh!j*ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j&ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j4Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCoT”uh1hhAhBhCKh!j"ubah"}”(h$]”h&]”h+]”ŒCoT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |COT| replace:: :term:`COT`”h]”h)”}”(hŒ:term:`COT`”h]”h)”}”(hjSh]”hŒCOT”…””}”(hhh!jUubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jQubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j_Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCOT”uh1hhAhBhCKh!jMubah"}”(h$]”h&]”h+]”ŒCOT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |CSS| replace:: :term:`CSS`”h]”h)”}”(hŒ:term:`CSS`”h]”h)”}”(hj~h]”hŒCSS”…””}”(hhh!j€ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j|ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŠŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCSS”uh1hhAhBhCK h!jxubah"}”(h$]”h&]”h+]”ŒCSS”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |CVE| replace:: :term:`CVE`”h]”h)”}”(hŒ:term:`CVE`”h]”h)”}”(hj©h]”hŒCVE”…””}”(hhh!j«ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j§ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jµŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCVE”uh1hhAhBhCK h!j£ubah"}”(h$]”h&]”h+]”ŒCVE”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |DTB| replace:: :term:`DTB`”h]”h)”}”(hŒ:term:`DTB`”h]”h)”}”(hjÔh]”hŒDTB”…””}”(hhh!jÖubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÒubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jàŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDTB”uh1hhAhBhCKh!jÎubah"}”(h$]”h&]”h+]”ŒDTB”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |DS-5| replace:: :term:`DS-5`”h]”h)”}”(hŒ:term:`DS-5`”h]”h)”}”(hjÿh]”hŒDS-5”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jýubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDS-5”uh1hhAhBhCKh!jùubah"}”(h$]”h&]”h+]”ŒDS-5”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |DSU| replace:: :term:`DSU`”h]”h)”}”(hŒ:term:`DSU`”h]”h)”}”(hj*h]”hŒDSU”…””}”(hhh!j,ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j(ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j6Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDSU”uh1hhAhBhCK h!j$ubah"}”(h$]”h&]”h+]”ŒDSU”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |DT| replace:: :term:`DT`”h]”h)”}”(hŒ :term:`DT`”h]”h)”}”(hjUh]”hŒDT”…””}”(hhh!jWubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jSubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jaŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDT”uh1hhAhBhCKh!jOubah"}”(h$]”h&]”h+]”ŒDT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |EL| replace:: :term:`EL`”h]”h)”}”(hŒ :term:`EL`”h]”h)”}”(hj€h]”hŒEL”…””}”(hhh!j‚ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j~ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒEL”uh1hhAhBhCKh!jzubah"}”(h$]”h&]”h+]”ŒEL”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |EHF| replace:: :term:`EHF`”h]”h)”}”(hŒ:term:`EHF`”h]”h)”}”(hj«h]”hŒEHF”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j©ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j·Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒEHF”uh1hhAhBhCKh!j¥ubah"}”(h$]”h&]”h+]”ŒEHF”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ".. |FCONF| replace:: :term:`FCONF`”h]”h)”}”(hŒ :term:`FCONF`”h]”h)”}”(hjÖh]”hŒFCONF”…””}”(hhh!jØubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÔubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jâŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFCONF”uh1hhAhBhCKh!jÐubah"}”(h$]”h&]”h+]”ŒFCONF”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FDT| replace:: :term:`FDT`”h]”h)”}”(hŒ:term:`FDT`”h]”h)”}”(hjh]”hŒFDT”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÿubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFDT”uh1hhAhBhCKh!jûubah"}”(h$]”h&]”h+]”ŒFDT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |FF-A| replace:: :term:`FF-A`”h]”h)”}”(hŒ:term:`FF-A`”h]”h)”}”(hj,h]”hŒFF-A”…””}”(hhh!j.ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j*ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j8Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFF-A”uh1hhAhBhCKh!j&ubah"}”(h$]”h&]”h+]”ŒFF-A”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FIP| replace:: :term:`FIP`”h]”h)”}”(hŒ:term:`FIP`”h]”h)”}”(hjWh]”hŒFIP”…””}”(hhh!jYubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jUubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jcŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFIP”uh1hhAhBhCKh!jQubah"}”(h$]”h&]”h+]”ŒFIP”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FVP| replace:: :term:`FVP`”h]”h)”}”(hŒ:term:`FVP`”h]”h)”}”(hj‚h]”hŒFVP”…””}”(hhh!j„ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j€ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŽŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFVP”uh1hhAhBhCKh!j|ubah"}”(h$]”h&]”h+]”ŒFVP”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FWU| replace:: :term:`FWU`”h]”h)”}”(hŒ:term:`FWU`”h]”h)”}”(hjh]”hŒFWU”…””}”(hhh!j¯ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j«ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j¹Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFWU”uh1hhAhBhCKh!j§ubah"}”(h$]”h&]”h+]”ŒFWU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |GIC| replace:: :term:`GIC`”h]”h)”}”(hŒ:term:`GIC`”h]”h)”}”(hjØh]”hŒGIC”…””}”(hhh!jÚubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÖubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jäŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒGIC”uh1hhAhBhCKh!jÒubah"}”(h$]”h&]”h+]”ŒGIC”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |ISA| replace:: :term:`ISA`”h]”h)”}”(hŒ:term:`ISA`”h]”h)”}”(hjh]”hŒISA”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒISA”uh1hhAhBhCKh!jýubah"}”(h$]”h&]”h+]”ŒISA”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ$.. |Linaro| replace:: :term:`Linaro`”h]”h)”}”(hŒ:term:`Linaro`”h]”h)”}”(hj.h]”hŒLinaro”…””}”(hhh!j0ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j,ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j:Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒLinaro”uh1hhAhBhCKh!j(ubah"}”(h$]”h&]”h+]”ŒLinaro”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |MMU| replace:: :term:`MMU`”h]”h)”}”(hŒ:term:`MMU`”h]”h)”}”(hjYh]”hŒMMU”…””}”(hhh!j[ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jWubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jeŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMMU”uh1hhAhBhCKh!jSubah"}”(h$]”h&]”h+]”ŒMMU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |MPAM| replace:: :term:`MPAM`”h]”h)”}”(hŒ:term:`MPAM`”h]”h)”}”(hj„h]”hŒMPAM”…””}”(hhh!j†ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j‚ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPAM”uh1hhAhBhCKh!j~ubah"}”(h$]”h&]”h+]”ŒMPAM”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |MPMM| replace:: :term:`MPMM`”h]”h)”}”(hŒ:term:`MPMM`”h]”h)”}”(hj¯h]”hŒMPMM”…””}”(hhh!j±ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j»Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPMM”uh1hhAhBhCKh!j©ubah"}”(h$]”h&]”h+]”ŒMPMM”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ".. |MPIDR| replace:: :term:`MPIDR`”h]”h)”}”(hŒ :term:`MPIDR`”h]”h)”}”(hjÚh]”hŒMPIDR”…””}”(hhh!jÜubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jØubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jæŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPIDR”uh1hhAhBhCKh!jÔubah"}”(h$]”h&]”h+]”ŒMPIDR”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |MTE| replace:: :term:`MTE`”h]”h)”}”(hŒ:term:`MTE`”h]”h)”}”(hjh]”hŒMTE”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMTE”uh1hhAhBhCKh!jÿubah"}”(h$]”h&]”h+]”ŒMTE”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |OEN| replace:: :term:`OEN`”h]”h)”}”(hŒ:term:`OEN`”h]”h)”}”(hj0h]”hŒOEN”…””}”(hhh!j2ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j.ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j<Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOEN”uh1hhAhBhCKh!j*ubah"}”(h$]”h&]”h+]”ŒOEN”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ$.. |OP-TEE| replace:: :term:`OP-TEE`”h]”h)”}”(hŒ:term:`OP-TEE`”h]”h)”}”(hj[h]”hŒOP-TEE”…””}”(hhh!j]ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jYubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jgŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOP-TEE”uh1hhAhBhCK h!jUubah"}”(h$]”h&]”h+]”ŒOP-TEE”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |OTE| replace:: :term:`OTE`”h]”h)”}”(hŒ:term:`OTE`”h]”h)”}”(hj†h]”hŒOTE”…””}”(hhh!jˆubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j„ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j’Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOTE”uh1hhAhBhCK!h!j€ubah"}”(h$]”h&]”h+]”ŒOTE”ah-]”h/]”uh1h hAhBhCK!h!hhhubh)”}”(hŒ.. |PDD| replace:: :term:`PDD`”h]”h)”}”(hŒ:term:`PDD`”h]”h)”}”(hj±h]”hŒPDD”…””}”(hhh!j³ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j¯ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j½Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPDD”uh1hhAhBhCK"h!j«ubah"}”(h$]”h&]”h+]”ŒPDD”ah-]”h/]”uh1h hAhBhCK"h!hhhubh)”}”(hŒ".. |PAUTH| replace:: :term:`PAUTH`”h]”h)”}”(hŒ :term:`PAUTH`”h]”h)”}”(hjÜh]”hŒPAUTH”…””}”(hhh!jÞubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÚubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jèŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPAUTH”uh1hhAhBhCK#h!jÖubah"}”(h$]”h&]”h+]”ŒPAUTH”ah-]”h/]”uh1h hAhBhCK#h!hhhubh)”}”(hŒ.. |PMF| replace:: :term:`PMF`”h]”h)”}”(hŒ:term:`PMF`”h]”h)”}”(hjh]”hŒPMF”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPMF”uh1hhAhBhCK$h!jubah"}”(h$]”h&]”h+]”ŒPMF”ah-]”h/]”uh1h hAhBhCK$h!hhhubh)”}”(hŒ .. |PSCI| replace:: :term:`PSCI`”h]”h)”}”(hŒ:term:`PSCI`”h]”h)”}”(hj2h]”hŒPSCI”…””}”(hhh!j4ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j0ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j>Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPSCI”uh1hhAhBhCK%h!j,ubah"}”(h$]”h&]”h+]”ŒPSCI”ah-]”h/]”uh1h hAhBhCK%h!hhhubh)”}”(hŒ.. |RAS| replace:: :term:`RAS`”h]”h)”}”(hŒ:term:`RAS`”h]”h)”}”(hj]h]”hŒRAS”…””}”(hhh!j_ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j[ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jiŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒRAS”uh1hhAhBhCK&h!jWubah"}”(h$]”h&]”h+]”ŒRAS”ah-]”h/]”uh1h hAhBhCK&h!hhhubh)”}”(hŒ.. |ROT| replace:: :term:`ROT`”h]”h)”}”(hŒ:term:`ROT`”h]”h)”}”(hjˆh]”hŒROT”…””}”(hhh!jŠubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j†ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j”Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒROT”uh1hhAhBhCK'h!j‚ubah"}”(h$]”h&]”h+]”ŒROT”ah-]”h/]”uh1h hAhBhCK'h!hhhubh)”}”(hŒ .. |SCMI| replace:: :term:`SCMI`”h]”h)”}”(hŒ:term:`SCMI`”h]”h)”}”(hj³h]”hŒSCMI”…””}”(hhh!jµubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j±ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j¿Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSCMI”uh1hhAhBhCK(h!jubah"}”(h$]”h&]”h+]”ŒSCMI”ah-]”h/]”uh1h hAhBhCK(h!hhhubh)”}”(hŒ.. |SCP| replace:: :term:`SCP`”h]”h)”}”(hŒ:term:`SCP`”h]”h)”}”(hjÞh]”hŒSCP”…””}”(hhh!jàubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÜubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jêŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSCP”uh1hhAhBhCK)h!jØubah"}”(h$]”h&]”h+]”ŒSCP”ah-]”h/]”uh1h hAhBhCK)h!hhhubh)”}”(hŒ .. |SDEI| replace:: :term:`SDEI`”h]”h)”}”(hŒ:term:`SDEI`”h]”h)”}”(hj h]”hŒSDEI”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSDEI”uh1hhAhBhCK*h!jubah"}”(h$]”h&]”h+]”ŒSDEI”ah-]”h/]”uh1h hAhBhCK*h!hhhubh)”}”(hŒ.. |SDS| replace:: :term:`SDS`”h]”h)”}”(hŒ:term:`SDS`”h]”h)”}”(hj4h]”hŒSDS”…””}”(hhh!j6ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j2ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j@Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSDS”uh1hhAhBhCK+h!j.ubah"}”(h$]”h&]”h+]”ŒSDS”ah-]”h/]”uh1h hAhBhCK+h!hhhubh)”}”(hŒ.. |SEA| replace:: :term:`SEA`”h]”h)”}”(hŒ:term:`SEA`”h]”h)”}”(hj_h]”hŒSEA”…””}”(hhh!jaubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j]ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jkŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSEA”uh1hhAhBhCK,h!jYubah"}”(h$]”h&]”h+]”ŒSEA”ah-]”h/]”uh1h hAhBhCK,h!hhhubh)”}”(hŒ.. |SiP| replace:: :term:`SiP`”h]”h)”}”(hŒ:term:`SiP`”h]”h)”}”(hjŠh]”hŒSiP”…””}”(hhh!jŒubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jˆubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j–Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSiP”uh1hhAhBhCK-h!j„ubah"}”(h$]”h&]”h+]”ŒSiP”ah-]”h/]”uh1h hAhBhCK-h!hhhubh)”}”(hŒ.. |SIP| replace:: :term:`SIP`”h]”h)”}”(hŒ:term:`SIP`”h]”h)”}”(hjµh]”hŒSIP”…””}”(hhh!j·ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j³ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÁŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSIP”uh1hhAhBhCK.h!j¯ubah"}”(h$]”h&]”h+]”ŒSIP”ah-]”h/]”uh1h hAhBhCK.h!hhhubh)”}”(hŒ.. |SMC| replace:: :term:`SMC`”h]”h)”}”(hŒ:term:`SMC`”h]”h)”}”(hjàh]”hŒSMC”…””}”(hhh!jâubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÞubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jìŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSMC”uh1hhAhBhCK/h!jÚubah"}”(h$]”h&]”h+]”ŒSMC”ah-]”h/]”uh1h hAhBhCK/h!hhhubh)”}”(hŒ".. |SMCCC| replace:: :term:`SMCCC`”h]”h)”}”(hŒ :term:`SMCCC`”h]”h)”}”(hjh]”hŒSMCCC”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSMCCC”uh1hhAhBhCK0h!jubah"}”(h$]”h&]”h+]”ŒSMCCC”ah-]”h/]”uh1h hAhBhCK0h!hhhubh)”}”(hŒ.. |SoC| replace:: :term:`SoC`”h]”h)”}”(hŒ:term:`SoC`”h]”h)”}”(hj6h]”hŒSoC”…””}”(hhh!j8ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j4ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jBŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSoC”uh1hhAhBhCK1h!j0ubah"}”(h$]”h&]”h+]”ŒSoC”ah-]”h/]”uh1h hAhBhCK1h!hhhubh)”}”(hŒ.. |SP| replace:: :term:`SP`”h]”h)”}”(hŒ :term:`SP`”h]”h)”}”(hjah]”hŒSP”…””}”(hhh!jcubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j_ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jmŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSP”uh1hhAhBhCK2h!j[ubah"}”(h$]”h&]”h+]”ŒSP”ah-]”h/]”uh1h hAhBhCK2h!hhhubh)”}”(hŒ.. |SPD| replace:: :term:`SPD`”h]”h)”}”(hŒ:term:`SPD`”h]”h)”}”(hjŒh]”hŒSPD”…””}”(hhh!jŽubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŠubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j˜Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSPD”uh1hhAhBhCK3h!j†ubah"}”(h$]”h&]”h+]”ŒSPD”ah-]”h/]”uh1h hAhBhCK3h!hhhubh)”}”(hŒ.. |SPM| replace:: :term:`SPM`”h]”h)”}”(hŒ:term:`SPM`”h]”h)”}”(hj·h]”hŒSPM”…””}”(hhh!j¹ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jµubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÃŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSPM”uh1hhAhBhCK4h!j±ubah"}”(h$]”h&]”h+]”ŒSPM”ah-]”h/]”uh1h hAhBhCK4h!hhhubh)”}”(hŒ .. |SSBS| replace:: :term:`SSBS`”h]”h)”}”(hŒ:term:`SSBS`”h]”h)”}”(hjâh]”hŒSSBS”…””}”(hhh!jäubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jàubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jîŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSSBS”uh1hhAhBhCK5h!jÜubah"}”(h$]”h&]”h+]”ŒSSBS”ah-]”h/]”uh1h hAhBhCK5h!hhhubh)”}”(hŒ.. |SVE| replace:: :term:`SVE`”h]”h)”}”(hŒ:term:`SVE`”h]”h)”}”(hj h]”hŒSVE”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSVE”uh1hhAhBhCK6h!j ubah"}”(h$]”h&]”h+]”ŒSVE”ah-]”h/]”uh1h hAhBhCK6h!hhhubh)”}”(hŒ.. |TBB| replace:: :term:`TBB`”h]”h)”}”(hŒ:term:`TBB`”h]”h)”}”(hj8 h]”hŒTBB”…””}”(hhh!j: ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j6 ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jD Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTBB”uh1hhAhBhCK7h!j2 ubah"}”(h$]”h&]”h+]”ŒTBB”ah-]”h/]”uh1h hAhBhCK7h!hhhubh)”}”(hŒ .. |TBBR| replace:: :term:`TBBR`”h]”h)”}”(hŒ:term:`TBBR`”h]”h)”}”(hjc h]”hŒTBBR”…””}”(hhh!je ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!ja ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jo Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTBBR”uh1hhAhBhCK8h!j] ubah"}”(h$]”h&]”h+]”ŒTBBR”ah-]”h/]”uh1h hAhBhCK8h!hhhubh)”}”(hŒ.. |TEE| replace:: :term:`TEE`”h]”h)”}”(hŒ:term:`TEE`”h]”h)”}”(hjŽ h]”hŒTEE”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŒ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jš Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTEE”uh1hhAhBhCK9h!jˆ ubah"}”(h$]”h&]”h+]”ŒTEE”ah-]”h/]”uh1h hAhBhCK9h!hhhubh)”}”(hŒ .. |TF-A| replace:: :term:`TF-A`”h]”h)”}”(hŒ:term:`TF-A`”h]”h)”}”(hj¹ h]”hŒTF-A”…””}”(hhh!j» ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j· ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÅ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTF-A”uh1hhAhBhCK:h!j³ ubah"}”(h$]”h&]”h+]”ŒTF-A”ah-]”h/]”uh1h hAhBhCK:h!hhhubh)”}”(hŒ .. |TF-M| replace:: :term:`TF-M`”h]”h)”}”(hŒ:term:`TF-M`”h]”h)”}”(hjä h]”hŒTF-M”…””}”(hhh!jæ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jâ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jð Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTF-M”uh1hhAhBhCK;h!jÞ ubah"}”(h$]”h&]”h+]”ŒTF-M”ah-]”h/]”uh1h hAhBhCK;h!hhhubh)”}”(hŒ.. |TLB| replace:: :term:`TLB`”h]”h)”}”(hŒ:term:`TLB`”h]”h)”}”(hj h]”hŒTLB”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTLB”uh1hhAhBhCKh!j_ ubah"}”(h$]”h&]”h+]”ŒTRNG”ah-]”h/]”uh1h hAhBhCK>h!hhhubh)”}”(hŒ.. |TSP| replace:: :term:`TSP`”h]”h)”}”(hŒ:term:`TSP`”h]”h)”}”(hj h]”hŒTSP”…””}”(hhh!j’ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŽ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jœ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTSP”uh1hhAhBhCK?h!jŠ ubah"}”(h$]”h&]”h+]”ŒTSP”ah-]”h/]”uh1h hAhBhCK?h!hhhubh)”}”(hŒ.. |TZC| replace:: :term:`TZC`”h]”h)”}”(hŒ:term:`TZC`”h]”h)”}”(hj» h]”hŒTZC”…””}”(hhh!j½ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j¹ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÇ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTZC”uh1hhAhBhCK@h!jµ ubah"}”(h$]”h&]”h+]”ŒTZC”ah-]”h/]”uh1h hAhBhCK@h!hhhubh)”}”(hŒ".. |UBSAN| replace:: :term:`UBSAN`”h]”h)”}”(hŒ :term:`UBSAN`”h]”h)”}”(hjæ h]”hŒUBSAN”…””}”(hhh!jè ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jä ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jò Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒUBSAN”uh1hhAhBhCKAh!jà ubah"}”(h$]”h&]”h+]”ŒUBSAN”ah-]”h/]”uh1h hAhBhCKAh!hhhubh)”}”(hŒ .. |UEFI| replace:: :term:`UEFI`”h]”h)”}”(hŒ:term:`UEFI`”h]”h)”}”(hjh]”hŒUEFI”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒUEFI”uh1hhAhBhCKBh!jubah"}”(h$]”h&]”h+]”ŒUEFI”ah-]”h/]”uh1h hAhBhCKBh!hhhubh)”}”(hŒ .. |WDOG| replace:: :term:`WDOG`”h]”h)”}”(hŒ:term:`WDOG`”h]”h)”}”(hj<h]”hŒWDOG”…””}”(hhh!j>ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j:ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jHŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒWDOG”uh1hhAhBhCKCh!j6ubah"}”(h$]”h&]”h+]”ŒWDOG”ah-]”h/]”uh1h hAhBhCKCh!hhhubh)”}”(hŒ!.. |XLAT| replace:: :term:`XLAT` ”h]”h)”}”(hŒ:term:`XLAT`”h]”h)”}”(hjgh]”hŒXLAT”…””}”(hhh!jiubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jeubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jsŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒXLAT”uh1hhAhBhCKDh!jaubah"}”(h$]”h&]”h+]”ŒXLAT”ah-]”h/]”uh1h hAhBhCKDh!hhhubh Œsection”“”)”}”(hhh]”(h Œtitle”“”)”}”(hŒ PSCI Power Domain Tree Structure”h]”hŒ PSCI Power Domain Tree Structure”…””}”(hj•h!j“hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jŽhhhAŒT/home/test/workspace/code/optee_3.16/trusted-firmware-a/docs/design/psci-pd-tree.rst”hCKubj)”}”(hhh]”(j’)”}”(hŒRequirements”h]”hŒRequirements”…””}”(hj§h!j¥hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j¢hhhAj¡hCKubh Œenumerated_list”“”)”}”(hhh]”(h Œ list_item”“”)”}”(hX„A platform must export the ``plat_get_aff_count()`` and ``plat_get_aff_state()`` APIs to enable the generic PSCI code to populate a tree that describes the hierarchy of power domains in the system. This approach is inflexible because a change to the topology requires a change in the code. It would be much simpler for the platform to describe its power domain tree in a data structure. ”h]”(h Œ paragraph”“”)”}”(hX!A platform must export the ``plat_get_aff_count()`` and ``plat_get_aff_state()`` APIs to enable the generic PSCI code to populate a tree that describes the hierarchy of power domains in the system. This approach is inflexible because a change to the topology requires a change in the code.”h]”(hŒA platform must export the ”…””}”(hŒA platform must export the ”h!jÀubh Œliteral”“”)”}”(hŒ``plat_get_aff_count()``”h]”hŒplat_get_aff_count()”…””}”(hhh!jËubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!jÀubhŒ and ”…””}”(hŒ and ”h!jÀubjÊ)”}”(hŒ``plat_get_aff_state()``”h]”hŒplat_get_aff_state()”…””}”(hhh!jÞubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!jÀubhŒÑ APIs to enable the generic PSCI code to populate a tree that describes the hierarchy of power domains in the system. This approach is inflexible because a change to the topology requires a change in the code.”…””}”(hŒÑ APIs to enable the generic PSCI code to populate a tree that describes the hierarchy of power domains in the system. This approach is inflexible because a change to the topology requires a change in the code.”h!jÀubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKh!jºubj¿)”}”(hŒ`It would be much simpler for the platform to describe its power domain tree in a data structure.”h]”hŒ`It would be much simpler for the platform to describe its power domain tree in a data structure.”…””}”(hjùh!j÷ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK h!jºubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jµhhhAj¡hCNubj¹)”}”(hX×The generic PSCI code generates MPIDRs in order to populate the power domain tree. It also uses an MPIDR to find a node in the tree. The assumption that a platform will use exactly the same MPIDRs as generated by the generic PSCI code is not scalable. The use of an MPIDR also restricts the number of levels in the power domain tree to four. Therefore, there is a need to decouple allocation of MPIDRs from the mechanism used to populate the power domain topology tree. ”h]”(j¿)”}”(hXUThe generic PSCI code generates MPIDRs in order to populate the power domain tree. It also uses an MPIDR to find a node in the tree. The assumption that a platform will use exactly the same MPIDRs as generated by the generic PSCI code is not scalable. The use of an MPIDR also restricts the number of levels in the power domain tree to four.”h]”hXUThe generic PSCI code generates MPIDRs in order to populate the power domain tree. It also uses an MPIDR to find a node in the tree. The assumption that a platform will use exactly the same MPIDRs as generated by the generic PSCI code is not scalable. The use of an MPIDR also restricts the number of levels in the power domain tree to four.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKh!jubj¿)”}”(hŒTherefore, there is a need to decouple allocation of MPIDRs from the mechanism used to populate the power domain topology tree.”h]”hŒTherefore, there is a need to decouple allocation of MPIDRs from the mechanism used to populate the power domain topology tree.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKh!jubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jµhhhAj¡hCNubj¹)”}”(hX<The current arrangement of the power domain tree requires a binary search over the sibling nodes at a particular level to find a specified power domain node. During a power management operation, the tree is traversed from a 'start' to an 'end' power level. The binary search is required to find the node at each level. The natural way to perform this traversal is to start from a leaf node and follow the parent node pointer to reach the end level. Therefore, there is a need to define data structures that implement the tree in a way which facilitates such a traversal. ”h]”(j¿)”}”(hXÀThe current arrangement of the power domain tree requires a binary search over the sibling nodes at a particular level to find a specified power domain node. During a power management operation, the tree is traversed from a 'start' to an 'end' power level. The binary search is required to find the node at each level. The natural way to perform this traversal is to start from a leaf node and follow the parent node pointer to reach the end level.”h]”hXÈThe current arrangement of the power domain tree requires a binary search over the sibling nodes at a particular level to find a specified power domain node. During a power management operation, the tree is traversed from a â€˜startâ€™ to an â€˜endâ€™ power level. The binary search is required to find the node at each level. The natural way to perform this traversal is to start from a leaf node and follow the parent node pointer to reach the end level.”…””}”(hj7h!j5ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKh!j1ubj¿)”}”(hŒyTherefore, there is a need to define data structures that implement the tree in a way which facilitates such a traversal.”h]”hŒyTherefore, there is a need to define data structures that implement the tree in a way which facilitates such a traversal.”…””}”(hjEh!jCubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK!h!j1ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jµhhhAj¡hCNubj¹)”}”(hXËThe attributes of a core power domain differ from the attributes of power domains at higher levels. For example, only a core power domain can be identified using an MPIDR. There is no requirement to perform state coordination while performing a power management operation on the core power domain. Therefore, there is a need to implement the tree in a way which facilitates this distinction between a leaf and non-leaf node and any associated optimizations. ”h]”(j¿)”}”(hX)The attributes of a core power domain differ from the attributes of power domains at higher levels. For example, only a core power domain can be identified using an MPIDR. There is no requirement to perform state coordination while performing a power management operation on the core power domain.”h]”hX)The attributes of a core power domain differ from the attributes of power domains at higher levels. For example, only a core power domain can be identified using an MPIDR. There is no requirement to perform state coordination while performing a power management operation on the core power domain.”…””}”(hj]h!j[ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK$h!jWubj¿)”}”(hŒŸTherefore, there is a need to implement the tree in a way which facilitates this distinction between a leaf and non-leaf node and any associated optimizations.”h]”hŒŸTherefore, there is a need to implement the tree in a way which facilitates this distinction between a leaf and non-leaf node and any associated optimizations.”…””}”(hjkh!jiubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK)h!jWubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jµhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j³h!j¢hhhAj¡hCKubeh"}”(h$]”Œrequirements”ah&]”h+]”Œrequirements”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCKubh Œ transition”“”)”}”(hŒ--------------”h]”h"}”(h$]”h&]”h+]”h-]”h/]”uh1jhAj¡hCK-h!jŽhhubj)”}”(hhh]”(j’)”}”(hŒDesign”h]”hŒDesign”…””}”(hj¡h!jŸhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jœhhhAj¡hCK0ubj)”}”(hhh]”(j’)”}”(hŒDescribing a power domain tree”h]”hŒDescribing a power domain tree”…””}”(hj²h!j°hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jhhhAj¡hCK3ubj¿)”}”(hŒ»To fulfill requirement 1., the existing platform APIs ``plat_get_aff_count()`` and ``plat_get_aff_state()`` have been removed. A platform must define an array of unsigned chars such that:”h]”(hŒ6To fulfill requirement 1., the existing platform APIs ”…””}”(hŒ6To fulfill requirement 1., the existing platform APIs ”h!j¾hhhANhCNubjÊ)”}”(hŒ``plat_get_aff_count()``”h]”hŒplat_get_aff_count()”…””}”(hhh!jÇubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j¾ubhŒ and ”…””}”(hŒ and ”h!j¾hhhANhCNubjÊ)”}”(hŒ``plat_get_aff_state()``”h]”hŒplat_get_aff_state()”…””}”(hhh!jÚubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j¾ubhŒP have been removed. A platform must define an array of unsigned chars such that:”…””}”(hŒP have been removed. A platform must define an array of unsigned chars such that:”h!j¾hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK5h!jhhubj´)”}”(hhh]”(j¹)”}”(hX The first entry in the array specifies the number of power domains at the highest power level implemented in the platform. This caters for platforms where the power domain tree does not have a single root node, for example, the FVP has two cluster power domains at the highest level (1). ”h]”j¿)”}”(hXThe first entry in the array specifies the number of power domains at the highest power level implemented in the platform. This caters for platforms where the power domain tree does not have a single root node, for example, the FVP has two cluster power domains at the highest level (1).”h]”hXThe first entry in the array specifies the number of power domains at the highest power level implemented in the platform. This caters for platforms where the power domain tree does not have a single root node, for example, the FVP has two cluster power domains at the highest level (1).”…””}”(hjüh!júubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK9h!jöubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jóhhhAj¡hCNubj¹)”}”(hŒ{Each subsequent entry corresponds to a power domain and contains the number of power domains that are its direct children. ”h]”j¿)”}”(hŒzEach subsequent entry corresponds to a power domain and contains the number of power domains that are its direct children.”h]”hŒzEach subsequent entry corresponds to a power domain and contains the number of power domains that are its direct children.”…””}”(hj h!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK>h!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jóhhhAj¡hCNubj¹)”}”(hŒcThe size of the array minus the first entry will be equal to the number of non-leaf power domains. ”h]”j¿)”}”(hŒbThe size of the array minus the first entry will be equal to the number of non-leaf power domains.”h]”hŒbThe size of the array minus the first entry will be equal to the number of non-leaf power domains.”…””}”(hj, h!j* ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKAh!j& ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jóhhhAj¡hCNubj¹)”}”(hŒôThe value in each entry in the array is used to find the number of entries to consider at the next level. The sum of the values (number of children) of all the entries at a level specifies the number of entries in the array for the next level. ”h]”j¿)”}”(hŒóThe value in each entry in the array is used to find the number of entries to consider at the next level. The sum of the values (number of children) of all the entries at a level specifies the number of entries in the array for the next level.”h]”hŒóThe value in each entry in the array is used to find the number of entries to consider at the next level. The sum of the values (number of children) of all the entries at a level specifies the number of entries in the array for the next level.”…””}”(hjD h!jB ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKDh!j> ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jóhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jƒj„j…hj†j‡uh1j³h!jhhhAj¡hCK9ubj¿)”}”(hŒ©The following example power domain topology tree will be used to describe the above text further. The leaf and non-leaf nodes in this tree have been numbered separately.”h]”hŒ©The following example power domain topology tree will be used to describe the above text further. The leaf and non-leaf nodes in this tree have been numbered separately.”…””}”(hj^ h!j\ hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKIh!jhhubh Œ literal_block”“”)”}”(hXÞ +-+ |0| +-+ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ +-+ +-+ |1| |2| +-+ +-+ / \ / \ / \ / \ / \ / \ / \ / \ +-+ +-+ +-+ +-+ |3| |4| |5| |6| +-+ +-+ +-+ +-+ +---+-----+ +----+----| +----+----+ +----+-----+-----+ | | | | | | | | | | | | | | | | | | | | | | | | | | v v v v v v v v v v v v v +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +--+ +--+ +--+ |0| |1| |2| |3| |4| |5| |6| |7| |8| |9| |10| |11| |12| +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +--+ +--+ +--+”h]”hXÞ +-+ |0| +-+ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ +-+ +-+ |1| |2| +-+ +-+ / \ / \ / \ / \ / \ / \ / \ / \ +-+ +-+ +-+ +-+ |3| |4| |5| |6| +-+ +-+ +-+ +-+ +---+-----+ +----+----| +----+----+ +----+-----+-----+ | | | | | | | | | | | | | | | | | | | | | | | | | | v v v v v v v v v v v v v +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +--+ +--+ +--+ |0| |1| |2| |3| |4| |5| |6| |7| |8| |9| |10| |11| |12| +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ +--+ +--+ +--+”…””}”(hhh!jl ubah"}”(h$]”h&]”h+]”h-]”h/]”Œ xml:space”Œpreserve”uh1jj hAj¡hCKOh!jhhubj¿)”}”(hŒMThis tree is defined by the platform as the array described above as follows:”h]”hŒMThis tree is defined by the platform as the array described above as follows:”…””}”(hj~ h!j| hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKnh!jhhubjk )”}”(hX#define PLAT_NUM_POWER_DOMAINS 20 #define PLATFORM_CORE_COUNT 13 #define PSCI_NUM_NON_CPU_PWR_DOMAINS \ (PLAT_NUM_POWER_DOMAINS - PLATFORM_CORE_COUNT) unsigned char plat_power_domain_tree_desc[] = { 1, 2, 2, 2, 3, 3, 3, 4};”h]”hX#define PLAT_NUM_POWER_DOMAINS 20 #define PLATFORM_CORE_COUNT 13 #define PSCI_NUM_NON_CPU_PWR_DOMAINS \ (PLAT_NUM_POWER_DOMAINS - PLATFORM_CORE_COUNT) unsigned char plat_power_domain_tree_desc[] = { 1, 2, 2, 2, 3, 3, 3, 4};”…””}”(hhh!jŠ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œforce”‰Œhighlight_args”}”jz j{ Œlanguage”Œc”uh1jj hAj¡hCKph!jhhubeh"}”(h$]”Œdescribing-a-power-domain-tree”ah&]”h+]”Œdescribing a power domain tree”ah-]”h/]”uh1jŒh!jœhhhAj¡hCK3ubj)”}”(hhh]”(j’)”}”(hŒ4Removing assumptions about MPIDRs used in a platform”h]”hŒ4Removing assumptions about MPIDRs used in a platform”…””}”(hjª h!j¨ hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j¥ hhhAj¡hCKzubj¿)”}”(hŒ÷To fulfill requirement 2., it is assumed that the platform assigns a unique number (core index) between ``0`` and ``PLAT_CORE_COUNT - 1`` to each core power domain. MPIDRs could be allocated in any manner and will not be used to populate the tree.”h]”(hŒhTo fulfill requirement 2., it is assumed that the platform assigns a unique number (core index) between ”…””}”(hŒhTo fulfill requirement 2., it is assumed that the platform assigns a unique number (core index) between ”h!j¶ hhhANhCNubjÊ)”}”(hŒ``0``”h]”hŒ0”…””}”(hhh!j¿ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j¶ ubhŒ and ”…””}”(hŒ and ”h!j¶ hhhANhCNubjÊ)”}”(hŒ``PLAT_CORE_COUNT - 1``”h]”hŒPLAT_CORE_COUNT - 1”…””}”(hhh!jÒ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j¶ ubhŒn to each core power domain. MPIDRs could be allocated in any manner and will not be used to populate the tree.”…””}”(hŒn to each core power domain. MPIDRs could be allocated in any manner and will not be used to populate the tree.”h!j¶ hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK|h!j¥ hhubj¿)”}”(hXb``plat_core_pos_by_mpidr(mpidr)`` will return the core index for the core corresponding to the MPIDR. It will return an error (-1) if an MPIDR is passed which is not allocated or corresponds to an absent core. The semantics of this platform API have changed since it is required to validate the passed MPIDR. It has been made a mandatory API as a result.”h]”(jÊ)”}”(hŒ!``plat_core_pos_by_mpidr(mpidr)``”h]”hŒplat_core_pos_by_mpidr(mpidr)”…””}”(hhh!jï ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!jë ubhXA will return the core index for the core corresponding to the MPIDR. It will return an error (-1) if an MPIDR is passed which is not allocated or corresponds to an absent core. The semantics of this platform API have changed since it is required to validate the passed MPIDR. It has been made a mandatory API as a result.”…””}”(hXA will return the core index for the core corresponding to the MPIDR. It will return an error (-1) if an MPIDR is passed which is not allocated or corresponds to an absent core. The semantics of this platform API have changed since it is required to validate the passed MPIDR. It has been made a mandatory API as a result.”h!jë hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKh!j¥ hhubj¿)”}”(hŒíAnother mandatory API, ``plat_my_core_pos()`` has been added to return the core index for the calling core. This API provides a more lightweight mechanism to get the index since there is no need to validate the MPIDR of the calling core.”h]”(hŒAnother mandatory API, ”…””}”(hŒAnother mandatory API, ”h!jhhhANhCNubjÊ)”}”(hŒ``plat_my_core_pos()``”h]”hŒplat_my_core_pos()”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!jubhŒÀ has been added to return the core index for the calling core. This API provides a more lightweight mechanism to get the index since there is no need to validate the MPIDR of the calling core.”…””}”(hŒÀ has been added to return the core index for the calling core. This API provides a more lightweight mechanism to get the index since there is no need to validate the MPIDR of the calling core.”h!jhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK‡h!j¥ hhubj¿)”}”(hXÿThe platform should assign the core indices (as illustrated in the diagram above) such that, if the core nodes are numbered from left to right, then the index for a core domain will be the same as the index returned by ``plat_core_pos_by_mpidr()`` or ``plat_my_core_pos()`` for that core. This relationship allows the core nodes to be allocated in a separate array (requirement 4.) during ``psci_setup()`` in such an order that the index of the core in the array is the same as the return value from these APIs.”h]”(hŒÛThe platform should assign the core indices (as illustrated in the diagram above) such that, if the core nodes are numbered from left to right, then the index for a core domain will be the same as the index returned by ”…””}”(hŒÛThe platform should assign the core indices (as illustrated in the diagram above) such that, if the core nodes are numbered from left to right, then the index for a core domain will be the same as the index returned by ”h!j*hhhANhCNubjÊ)”}”(hŒ``plat_core_pos_by_mpidr()``”h]”hŒplat_core_pos_by_mpidr()”…””}”(hhh!j3ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j*ubhŒ or ”…””}”(hŒ or ”h!j*hhhANhCNubjÊ)”}”(hŒ``plat_my_core_pos()``”h]”hŒplat_my_core_pos()”…””}”(hhh!jFubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j*ubhŒt for that core. This relationship allows the core nodes to be allocated in a separate array (requirement 4.) during ”…””}”(hŒt for that core. This relationship allows the core nodes to be allocated in a separate array (requirement 4.) during ”h!j*hhhANhCNubjÊ)”}”(hŒ``psci_setup()``”h]”hŒpsci_setup()”…””}”(hhh!jYubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j*ubhŒj in such an order that the index of the core in the array is the same as the return value from these APIs.”…””}”(hŒj in such an order that the index of the core in the array is the same as the return value from these APIs.”h!j*hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK‹h!j¥ hhubj)”}”(hhh]”(j’)”}”(hŒ&Dealing with holes in MPIDR allocation”h]”hŒ&Dealing with holes in MPIDR allocation”…””}”(hjwh!juhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jrhhhAj¡hCK”ubj¿)”}”(hXFor platforms where the number of allocated MPIDRs is equal to the number of core power domains, for example, Juno and FVPs, the logic to convert an MPIDR to a core index should remain unchanged. Both Juno and FVP use a simple collision proof hash function to do this.”h]”hXFor platforms where the number of allocated MPIDRs is equal to the number of core power domains, for example, Juno and FVPs, the logic to convert an MPIDR to a core index should remain unchanged. Both Juno and FVP use a simple collision proof hash function to do this.”…””}”(hj…h!jƒhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK–h!jrhhubj¿)”}”(hX+It is possible that on some platforms, the allocation of MPIDRs is not contiguous or certain cores have been disabled. This essentially means that the MPIDRs have been sparsely allocated, that is, the size of the range of MPIDRs used by the platform is not equal to the number of core power domains.”h]”hX+It is possible that on some platforms, the allocation of MPIDRs is not contiguous or certain cores have been disabled. This essentially means that the MPIDRs have been sparsely allocated, that is, the size of the range of MPIDRs used by the platform is not equal to the number of core power domains.”…””}”(hj“h!j‘hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK›h!jrhhubj¿)”}”(hŒTThe platform could adopt one of the following approaches to deal with this scenario:”h]”hŒTThe platform could adopt one of the following approaches to deal with this scenario:”…””}”(hj¡h!jŸhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK h!jrhhubj´)”}”(hhh]”(j¹)”}”(hX1Implement more complex logic to convert a valid MPIDR to a core index while maintaining the relationship described earlier. This means that the power domain tree descriptor will not describe any core power domains which are disabled or absent. Entries will not be allocated in the tree for these domains. ”h]”j¿)”}”(hX0Implement more complex logic to convert a valid MPIDR to a core index while maintaining the relationship described earlier. This means that the power domain tree descriptor will not describe any core power domains which are disabled or absent. Entries will not be allocated in the tree for these domains.”h]”hX0Implement more complex logic to convert a valid MPIDR to a core index while maintaining the relationship described earlier. This means that the power domain tree descriptor will not describe any core power domains which are disabled or absent. Entries will not be allocated in the tree for these domains.”…””}”(hj¶h!j´ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK£h!j°ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jhhhAj¡hCNubj¹)”}”(hXrTreat unallocated MPIDRs and disabled cores as absent but still describe them in the power domain descriptor, that is, the number of core nodes described is equal to the size of the range of MPIDRs allocated. This approach will lead to memory wastage since entries will be allocated in the tree but will allow use of a simpler logic to convert an MPIDR to a core index. ”h]”j¿)”}”(hXqTreat unallocated MPIDRs and disabled cores as absent but still describe them in the power domain descriptor, that is, the number of core nodes described is equal to the size of the range of MPIDRs allocated. This approach will lead to memory wastage since entries will be allocated in the tree but will allow use of a simpler logic to convert an MPIDR to a core index.”h]”hXqTreat unallocated MPIDRs and disabled cores as absent but still describe them in the power domain descriptor, that is, the number of core nodes described is equal to the size of the range of MPIDRs allocated. This approach will lead to memory wastage since entries will be allocated in the tree but will allow use of a simpler logic to convert an MPIDR to a core index.”…””}”(hjÎh!jÌubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK©h!jÈubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¸h!jhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jƒj„j…hj†j‡uh1j³h!jrhhhAj¡hCK£ubeh"}”(h$]”Œ&dealing-with-holes-in-mpidr-allocation”ah&]”h+]”Œ&dealing with holes in mpidr allocation”ah-]”h/]”uh1jŒh!j¥ hhhAj¡hCK”ubeh"}”(h$]”Œ4removing-assumptions-about-mpidrs-used-in-a-platform”ah&]”h+]”Œ4removing assumptions about mpidrs used in a platform”ah-]”h/]”uh1jŒh!jœhhhAj¡hCKzubj)”}”(hhh]”(j’)”}”(hŒMTraversing through and distinguishing between core and non-core power domains”h]”hŒMTraversing through and distinguishing between core and non-core power domains”…””}”(hjûh!jùhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jöhhhAj¡hCK°ubj¿)”}”(hŒ‰To fulfill requirement 3 and 4, separate data structures have been defined to represent leaf and non-leaf power domain nodes in the tree.”h]”hŒ‰To fulfill requirement 3 and 4, separate data structures have been defined to represent leaf and non-leaf power domain nodes in the tree.”…””}”(hj h!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCK²h!jöhhubjk )”}”(hXÕ/******************************************************************************* * The following two data structures implement the power domain tree. The tree * is used to track the state of all the nodes i.e. power domain instances * described by the platform. The tree consists of nodes that describe CPU power * domains i.e. leaf nodes and all other power domains which are parents of a * CPU power domain i.e. non-leaf nodes. ******************************************************************************/ typedef struct non_cpu_pwr_domain_node { /* * Index of the first CPU power domain node level 0 which has this node * as its parent. */ unsigned int cpu_start_idx; /* * Number of CPU power domains which are siblings of the domain indexed * by 'cpu_start_idx' i.e. all the domains in the range 'cpu_start_idx * -> cpu_start_idx + ncpus' have this node as their parent. */ unsigned int ncpus; /* Index of the parent power domain node */ unsigned int parent_node; ----- } non_cpu_pd_node_t; typedef struct cpu_pwr_domain_node { u_register_t mpidr; /* Index of the parent power domain node */ unsigned int parent_node; ----- } cpu_pd_node_t;”h]”hXÕ/******************************************************************************* * The following two data structures implement the power domain tree. The tree * is used to track the state of all the nodes i.e. power domain instances * described by the platform. The tree consists of nodes that describe CPU power * domains i.e. leaf nodes and all other power domains which are parents of a * CPU power domain i.e. non-leaf nodes. ******************************************************************************/ typedef struct non_cpu_pwr_domain_node { /* * Index of the first CPU power domain node level 0 which has this node * as its parent. */ unsigned int cpu_start_idx; /* * Number of CPU power domains which are siblings of the domain indexed * by 'cpu_start_idx' i.e. all the domains in the range 'cpu_start_idx * -> cpu_start_idx + ncpus' have this node as their parent. */ unsigned int ncpus; /* Index of the parent power domain node */ unsigned int parent_node; ----- } non_cpu_pd_node_t; typedef struct cpu_pwr_domain_node { u_register_t mpidr; /* Index of the parent power domain node */ unsigned int parent_node; ----- } cpu_pd_node_t;”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œforce”‰Œhighlight_args”}”jz j{ j› jœ uh1jj hAj¡hCKµh!jöhhubj¿)”}”(hŒWThe power domain tree is implemented as a combination of the following data structures.”h]”hŒWThe power domain tree is implemented as a combination of the following data structures.”…””}”(hj(h!j&hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKÛh!jöhhubjk )”}”(hŒ|non_cpu_pd_node_t psci_non_cpu_pd_nodes[PSCI_NUM_NON_CPU_PWR_DOMAINS]; cpu_pd_node_t psci_cpu_pd_nodes[PLATFORM_CORE_COUNT];”h]”hŒ|non_cpu_pd_node_t psci_non_cpu_pd_nodes[PSCI_NUM_NON_CPU_PWR_DOMAINS]; cpu_pd_node_t psci_cpu_pd_nodes[PLATFORM_CORE_COUNT];”…””}”(hhh!j4ubah"}”(h$]”h&]”h+]”h-]”h/]”Œforce”‰Œhighlight_args”}”jz j{ j› jœ uh1jj hAj¡hCKÞh!jöhhubeh"}”(h$]”ŒMtraversing-through-and-distinguishing-between-core-and-non-core-power-domains”ah&]”h+]”ŒMtraversing through and distinguishing between core and non-core power domains”ah-]”h/]”uh1jŒh!jœhhhAj¡hCK°ubj)”}”(hhh]”(j’)”}”(hŒ Populating the power domain tree”h]”hŒ Populating the power domain tree”…””}”(hjRh!jPhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jMhhhAj¡hCKäubj¿)”}”(hX{The ``populate_power_domain_tree()`` function in ``psci_setup.c`` implements the algorithm to parse the power domain descriptor exported by the platform to populate the two arrays. It is essentially a breadth-first-search. The nodes for each level starting from the root are laid out one after another in the ``psci_non_cpu_pd_nodes`` and ``psci_cpu_pd_nodes`` arrays as follows:”h]”(hŒThe ”…””}”(hŒThe ”h!j^hhhANhCNubjÊ)”}”(hŒ ``populate_power_domain_tree()``”h]”hŒpopulate_power_domain_tree()”…””}”(hhh!jgubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j^ubhŒ function in ”…””}”(hŒ function in ”h!j^hhhANhCNubjÊ)”}”(hŒ``psci_setup.c``”h]”hŒpsci_setup.c”…””}”(hhh!jzubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j^ubhŒô implements the algorithm to parse the power domain descriptor exported by the platform to populate the two arrays. It is essentially a breadth-first-search. The nodes for each level starting from the root are laid out one after another in the ”…””}”(hŒô implements the algorithm to parse the power domain descriptor exported by the platform to populate the two arrays. It is essentially a breadth-first-search. The nodes for each level starting from the root are laid out one after another in the ”h!j^hhhANhCNubjÊ)”}”(hŒ``psci_non_cpu_pd_nodes``”h]”hŒpsci_non_cpu_pd_nodes”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j^ubhŒ and ”…””}”(hŒ and ”h!j^hhhANhCNubjÊ)”}”(hŒ``psci_cpu_pd_nodes``”h]”hŒpsci_cpu_pd_nodes”…””}”(hhh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j^ubhŒ arrays as follows:”…””}”(hŒ arrays as follows:”h!j^hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKæh!jMhhubjk )”}”(hŒmpsci_non_cpu_pd_nodes -> [[Level 3 nodes][Level 2 nodes][Level 1 nodes]] psci_cpu_pd_nodes -> [Level 0 nodes]”h]”hŒmpsci_non_cpu_pd_nodes -> [[Level 3 nodes][Level 2 nodes][Level 1 nodes]] psci_cpu_pd_nodes -> [Level 0 nodes]”…””}”(hhh!j¹ubah"}”(h$]”h&]”h+]”h-]”h/]”jz j{ uh1jj hAj¡hCKîh!jMhhubj¿)”}”(hŒÔFor the example power domain tree illustrated above, the ``psci_cpu_pd_nodes`` will be populated as follows. The value in each entry is the index of the parent node. Other fields have been ignored for simplicity.”h]”(hŒ9For the example power domain tree illustrated above, the ”…””}”(hŒ9For the example power domain tree illustrated above, the ”h!jÇhhhANhCNubjÊ)”}”(hŒ``psci_cpu_pd_nodes``”h]”hŒpsci_cpu_pd_nodes”…””}”(hhh!jÐubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!jÇubhŒ† will be populated as follows. The value in each entry is the index of the parent node. Other fields have been ignored for simplicity.”…””}”(hŒ† will be populated as follows. The value in each entry is the index of the parent node. Other fields have been ignored for simplicity.”h!jÇhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCKñh!jMhhubjk )”}”(hX +-------------+ ^ CPU0 | 3 | | +-------------+ | CPU1 | 3 | | +-------------+ | CPU2 | 3 | | +-------------+ | CPU3 | 4 | | +-------------+ | CPU4 | 4 | | +-------------+ | CPU5 | 4 | | PLATFORM_CORE_COUNT +-------------+ | CPU6 | 5 | | +-------------+ | CPU7 | 5 | | +-------------+ | CPU8 | 5 | | +-------------+ | CPU9 | 6 | | +-------------+ | CPU10 | 6 | | +-------------+ | CPU11 | 6 | | +-------------+ | CPU12 | 6 | v +-------------+”h]”hX +-------------+ ^ CPU0 | 3 | | +-------------+ | CPU1 | 3 | | +-------------+ | CPU2 | 3 | | +-------------+ | CPU3 | 4 | | +-------------+ | CPU4 | 4 | | +-------------+ | CPU5 | 4 | | PLATFORM_CORE_COUNT +-------------+ | CPU6 | 5 | | +-------------+ | CPU7 | 5 | | +-------------+ | CPU8 | 5 | | +-------------+ | CPU9 | 6 | | +-------------+ | CPU10 | 6 | | +-------------+ | CPU11 | 6 | | +-------------+ | CPU12 | 6 | v +-------------+”…””}”(hhh!jéubah"}”(h$]”h&]”h+]”h-]”h/]”jz j{ uh1jj hAj¡hCK÷h!jMhhubj¿)”}”(hŒzThe ``psci_non_cpu_pd_nodes`` array will be populated as follows. The value in each entry is the index of the parent node.”h]”(hŒThe ”…””}”(hŒThe ”h!j÷hhhANhCNubjÊ)”}”(hŒ``psci_non_cpu_pd_nodes``”h]”hŒpsci_non_cpu_pd_nodes”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j÷ubhŒ] array will be populated as follows. The value in each entry is the index of the parent node.”…””}”(hŒ] array will be populated as follows. The value in each entry is the index of the parent node.”h!j÷hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCMh!jMhhubjk )”}”(hXÐ +-------------+ ^ PD0 | -1 | | +-------------+ | PD1 | 0 | | +-------------+ | PD2 | 0 | | +-------------+ | PD3 | 1 | | PLAT_NUM_POWER_DOMAINS - +-------------+ | PLATFORM_CORE_COUNT PD4 | 1 | | +-------------+ | PD5 | 2 | | +-------------+ | PD6 | 2 | | +-------------+ v”h]”hXÐ +-------------+ ^ PD0 | -1 | | +-------------+ | PD1 | 0 | | +-------------+ | PD2 | 0 | | +-------------+ | PD3 | 1 | | PLAT_NUM_POWER_DOMAINS - +-------------+ | PLATFORM_CORE_COUNT PD4 | 1 | | +-------------+ | PD5 | 2 | | +-------------+ | PD6 | 2 | | +-------------+ v”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”jz j{ uh1jj hAj¡hCMh!jMhhubj¿)”}”(hXbEach core can find its node in the ``psci_cpu_pd_nodes`` array using the ``plat_my_core_pos()`` function. When a core is turned on, the normal world provides an MPIDR. The ``plat_core_pos_by_mpidr()`` function is used to validate the MPIDR before using it to find the corresponding core node. The non-core power domain nodes do not need to be identified.”h]”(hŒ#Each core can find its node in the ”…””}”(hŒ#Each core can find its node in the ”h!j'hhhANhCNubjÊ)”}”(hŒ``psci_cpu_pd_nodes``”h]”hŒpsci_cpu_pd_nodes”…””}”(hhh!j0ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j'ubhŒ array using the ”…””}”(hŒ array using the ”h!j'hhhANhCNubjÊ)”}”(hŒ``plat_my_core_pos()``”h]”hŒplat_my_core_pos()”…””}”(hhh!jCubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j'ubhŒM function. When a core is turned on, the normal world provides an MPIDR. The ”…””}”(hŒM function. When a core is turned on, the normal world provides an MPIDR. The ”h!j'hhhANhCNubjÊ)”}”(hŒ``plat_core_pos_by_mpidr()``”h]”hŒplat_core_pos_by_mpidr()”…””}”(hhh!jVubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÉh!j'ubhŒš function is used to validate the MPIDR before using it to find the corresponding core node. The non-core power domain nodes do not need to be identified.”…””}”(hŒš function is used to validate the MPIDR before using it to find the corresponding core node. The non-core power domain nodes do not need to be identified.”h!j'hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCM(h!jMhhubj‘)”}”(hŒ--------------”h]”h"}”(h$]”h&]”h+]”h-]”h/]”uh1jhAj¡hCM.h!jMhhubj¿)”}”(hŒM*Copyright (c) 2017-2018, Arm Limited and Contributors. All rights reserved.*”h]”h Œemphasis”“”)”}”(hj{h]”hŒKCopyright (c) 2017-2018, Arm Limited and Contributors. All rights reserved.”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j}h!jyubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾hAj¡hCM0h!jMhhubeh"}”(h$]”Œ populating-the-power-domain-tree”ah&]”h+]”Œ populating the power domain tree”ah-]”h/]”uh1jŒh!jœhhhAj¡hCKäubeh"}”(h$]”Œdesign”ah&]”h+]”Œdesign”ah-]”h/]”uh1jŒh!jŽ•ï hhhAj¡hCK0ubeh"}”(h$]”Œ psci-power-domain-tree-structure”ah&]”h+]”Œ psci power domain tree structure”ah-]”h/]”uh1jŒh!hhhhAj¡hCKubeh"}”(h$]”h&]”h+]”h-]”h/]”Œsource”j¡uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(j‘NŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÍŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”j¡Œ_destination”NŒ _config_files”]”Œpep_references”NŒpep_base_url”Œ https://www.python.org/dev/peps/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œhttps://tools.ietf.org/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”(hHhhshKhžhvhÉh¡hôhÌjh÷jJj"jujMj jxjËj£jöjÎj!jùjLj$jwjOj¢jzjÍj¥jøjÐj#jûjNj&jyjQj¤j|jÏj§jújÒj%jýjPj(j{jSj¦j~jÑj©jüjÔj'jÿjRj*j}jUj¨j€jÓj«jþjÖj)jjTj,jjWjªj‚jÕjjjØj+jjVj.jjYj¬j„j×j¯jjÚj-jjXj0jƒj[j®j†jÙj±j jÜj/ j jZ j2 j… j] j° jˆ jÛ j³ j jÞ j1 j j\ j4 j‡ j_ j² jŠ jÝ jµ jjà j3jj^j6j‰jauŒsubstitution_names”}”(Œaarch32”hHŒaarch64”hsŒamu”hžŒamus”hÉŒapi”hôŒbti”jŒcot”juŒcss”j Œcve”jËŒdtb”jöŒds-5”j!Œdsu”jLŒdt”jwŒel”j¢Œehf”jÍŒfconf”jøŒfdt”j#Œff-a”jNŒfip”jyŒfvp”j¤Œfwu”jÏŒgic”júŒisa”j%Œlinaro”jPŒmmu”j{Œmpam”j¦Œmpmm”jÑŒmpidr”jüŒmte”j'Œoen”jRŒop-tee”j}Œote”j¨Œpdd”jÓŒpauth”jþŒpmf”j)Œpsci”jTŒras”jŒrot”jªŒscmi”jÕŒscp”jŒsdei”j+Œsds”jVŒsea”jŒsip”j×Œsmc”jŒsmccc”j-Œsoc”jXŒsp”jƒŒspd”j®Œspm”jÙŒssbs”j Œsve”j/ Œtbb”jZ Œtbbr”j… Œtee”j° Œtf-a”jÛ Œtf-m”j Œtlb”j1 Œtlk”j\ Œtrng”j‡ Œtsp”j² Œtzc”jÝ Œubsan”jŒuefi”j3Œwdog”j^Œxlat”j‰uŒrefnames”}”Œrefids”}”Œnameids”}”(j§j¤jjŠjŸjœj¢ jŸ jójðjëjèjJjGj—j”uŒ nametypes”}”(j§NjNjŸNj¢ NjóNjëNjJNj—Nuh$}”(j¤jŽjŠj¢jœjœjŸ jjðj¥ jèjrjGjöj”jMuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒ decoration”Nhhub.