€•áŒ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_documents/cmake_framework”Œ 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ŒTF-A CMake buildsystem”h]”hŒTF-A CMake buildsystem”…””}”(hj•h!j“hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefid”Œid1”uh1j‘h!jŽhhhAŒa/home/test/workspace/code/optee_3.16/trusted-firmware-a/docs/design_documents/cmake_framework.rst”hCKubh Œ field_list”“”)”}”(hhh]”(h Œfield”“”)”}”(hhh]”(h Œ field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hj²h!j°ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j®h!j«hAj£hCKubh Œ field_body”“”)”}”(hŒBalint Dobszay”h]”h Œ paragraph”“”)”}”(hjÂh]”hŒBalint Dobszay”…””}”(hjÂh!jÆubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jÀubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾h!j«ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j©hAj£hCKh!j¦hhubjª)”}”(hhh]”(j¯)”}”(hŒOrganization”h]”hŒOrganization”…””}”(hjäh!jâubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j®h!jßhAj£hCKubj¿)”}”(hŒArm Limited”h]”jÅ)”}”(hjòh]”hŒArm Limited”…””}”(hjòh!jôubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jðubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾h!jßubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j©hAj£hCKh!j¦hhubjª)”}”(hhh]”(j¯)”}”(hŒContact”h]”hŒContact”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j®h!j hAj£hCKubj¿)”}”(hŒ'Balint Dobszay ”h]”jÅ)”}”(hj h]”(hŒBalint Dobszay <”…””}”(hŒBalint Dobszay <”h!j"ubh Œ reference”“”)”}”(hŒbalint.dobszay@arm.com”h]”hŒbalint.dobszay@arm.com”…””}”(hhh!j,ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefuri”Œmailto:balint.dobszay@arm.com”uh1j*h!j"ubhŒ>”…””}”(hŒ>”h!j"ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾h!j ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j©hAj£hCKh!j¦hhubjª)”}”(hhh]”(j¯)”}”(hŒStatus”h]”hŒStatus”…””}”(hjXh!jVubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j®h!jShAj£hCKubj¿)”}”(hŒ Accepted ”h]”jÅ)”}”(hŒAccepted”h]”hŒAccepted”…””}”(hjjh!jhubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jdubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¾h!jSubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j©hAj£hCKh!j¦hhubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¤h!jŽhhhAj£hCKubh Œtopic”“”)”}”(hhh]”(j’)”}”(hŒTable of Contents”h]”hŒTable of Contents”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jŠhAj£hCK ubh Œbullet_list”“”)”}”(hhh]”h Œ list_item”“”)”}”(hhh]”(jÅ)”}”(hhh]”j+)”}”(hhh]”hŒTF-A CMake buildsystem”…””}”(hj•h!j¨ubah"}”(h$]”j¢ah&]”h+]”h-]”h/]”Œrefid”Œtf-a-cmake-buildsystem”uh1j*h!j¥ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!j¢ubjœ)”}”(hhh]”(j¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒAbstract”…””}”(hŒAbstract”h!jÆubah"}”(h$]”Œid2”ah&]”h+]”h-]”h/]”Œrefid”Œabstract”uh1j*h!jÃubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!jÀubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j½ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒIntroduction”…””}”(hŒIntroduction”h!jéubah"}”(h$]”Œid3”ah&]”h+]”h-]”h/]”Œrefid”Œintroduction”uh1j*h!jæubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!jãubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j½ubj¡)”}”(hhh]”(jÅ)”}”(hhh]”j+)”}”(hhh]”hŒ Main features”…””}”(hŒ Main features”h!j ubah"}”(h$]”Œid4”ah&]”h+]”h-]”h/]”Œrefid”Œ main-features”uh1j*h!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!j ubjœ)”}”(hhh]”(j¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒ$Structured configuration description”…””}”(hŒ$Structured configuration description”h!j, ubah"}”(h$]”Œid5”ah&]”h+]”h-]”h/]”Œrefid”Œ$structured-configuration-description”uh1j*h!j) ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!j& ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j# ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒTarget description”…””}”(hŒTarget description”h!jO ubah"}”(h$]”Œid6”ah&]”h+]”h-]”h/]”Œrefid”Œtarget-description”uh1j*h!jL ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!jI ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j# ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒCompiler abstraction”…””}”(hŒCompiler abstraction”h!jr ubah"}”(h$]”Œid7”ah&]”h+]”h-]”h/]”Œrefid”Œcompiler-abstraction”uh1j*h!jo ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!jl ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j# ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒExternal tools”…””}”(hŒExternal tools”h!j• ubah"}”(h$]”Œid8”ah&]”h+]”h-]”h/]”Œrefid”Œexternal-tools”uh1j*h!j’ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j# ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j›h!j ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j½ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒWorkflow”…””}”(hŒWorkflow”h!jÄ ubah"}”(h$]”Œid9”ah&]”h+]”h-]”h/]”Œrefid”Œworkflow”uh1j*h!jÁ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!j¾ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j½ubj¡)”}”(hhh]”jÅ)”}”(hhh]”j+)”}”(hhh]”hŒExample”…””}”(hŒExample”h!jç ubah"}”(h$]”Œid10”ah&]”h+]”h-]”h/]”Œrefid”Œexample”uh1j*h!jä ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄh!já ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j½ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j›h!j¢ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j›h!jŠhhhANhCNubeh"}”(h$]”Œtable-of-contents”ah&]”Œcontents”ah+]”Œtable of contents”ah-]”h/]”uh1jˆhAj£hCK h!jŽhhubj)”}”(hhh]”(j’)”}”(hjÍh]”hŒAbstract”…””}”(hjÍh!j"hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jÐuh1j‘h!jhhhAj£hCKubjÅ)”}”(hX˜This document presents a proposal for a new buildsystem for TF-A using CMake, and as part of this a reusable CMake framework for embedded projects. For a summary about the proposal, please see the `Phabricator wiki page `_. As mentioned there, the proposal consists of two phases. The subject of this document is the first phase only.”h]”(hŒÅThis document presents a proposal for a new buildsystem for TF-A using CMake, and as part of this a reusable CMake framework for embedded projects. For a summary about the proposal, please see the ”…””}”(hŒÅThis document presents a proposal for a new buildsystem for TF-A using CMake, and as part of this a reusable CMake framework for embedded projects. For a summary about the proposal, please see the ”h!j/hhhANhCNubj+)”}”(hŒc`Phabricator wiki page `_”h]”hŒPhabricator wiki page”…””}”(hŒPhabricator wiki page”h!j8ubah"}”(h$]”h&]”h+]”h-]”h/]”Œname”ŒPhabricator wiki page”Œrefuri”ŒHhttps://developer.trustedfirmware.org/w/tf_a/cmake-buildsystem-proposal/”uh1j*h!j/ubh Œtarget”“”)”}”(hŒK ”h]”h"}”(h$]”Œphabricator-wiki-page”ah&]”h+]”Œphabricator wiki page”ah-]”h/]”Œrefuri”jJuh1jKŒ referenced”Kh!j/ubhŒp. As mentioned there, the proposal consists of two phases. The subject of this document is the first phase only.”…””}”(hŒp. As mentioned there, the proposal consists of two phases. The subject of this document is the first phase only.”h!j/hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK h!jhhubeh"}”(h$]”jÖah&]”h+]”Œabstract”ah-]”h/]”uh1jŒh!jŽhhhAj£hCKubj)”}”(hhh]”(j’)”}”(hjðh]”hŒIntroduction”…””}”(hjðh!jphhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jóuh1j‘h!jmhhhAj£hCKubjÅ)”}”(hXThe current Makefile based buildsystem of TF-A has become complicated and hard to maintain, there is a need for a new, more flexible solution. The proposal is to use CMake language for the new buildsystem. The main reasons of this decision are the following:”h]”hXThe current Makefile based buildsystem of TF-A has become complicated and hard to maintain, there is a need for a new, more flexible solution. The proposal is to use CMake language for the new buildsystem. The main reasons of this decision are the following:”…””}”(hjh!j}hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jmhhubjœ)”}”(hhh]”(j¡)”}”(hŒOIt is a well-established, mature tool, widely accepted by open-source projects.”h]”jÅ)”}”(hŒOIt is a well-established, mature tool, widely accepted by open-source projects.”h]”hŒOIt is a well-established, mature tool, widely accepted by open-source projects.”…””}”(hj”h!j’ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!jŽubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j‹hhhAj£hCNubj¡)”}”(hŒZTF-M is already using CMake, reducing fragmentation for tf.org projects can be beneficial.”h]”jÅ)”}”(hŒZTF-M is already using CMake, reducing fragmentation for tf.org projects can be beneficial.”h]”hŒZTF-M is already using CMake, reducing fragmentation for tf.org projects can be beneficial.”…””}”(hj¬h!jªubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!j¦ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j‹hhhAj£hCNubj¡)”}”(hXCCMake has various advantages over Make, e.g.: * Host and target system agnostic project. * CMake project is scalable, supports project modularization. * Supports software integration. * Out-of-the-box support for integration with several tools (e.g. project generation for various IDEs, integration with cppcheck, etc). ”h]”(jÅ)”}”(hŒ-CMake has various advantages over Make, e.g.:”h]”hŒ-CMake has various advantages over Make, e.g.:”…””}”(hjÄh!jÂubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKh!j¾ubjœ)”}”(hhh]”(j¡)”}”(hŒ(Host and target system agnostic project.”h]”jÅ)”}”(hjÕh]”hŒ(Host and target system agnostic project.”…””}”(hjÕh!j×ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK!h!jÓubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jÐubj¡)”}”(hŒ;CMake project is scalable, supports project modularization.”h]”jÅ)”}”(hjìh]”hŒ;CMake project is scalable, supports project modularization.”…””}”(hjìh!jîubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK"h!jêubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jÐubj¡)”}”(hŒSupports software integration.”h]”jÅ)”}”(hjh]”hŒSupports software integration.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK#h!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jÐubj¡)”}”(hŒ†Out-of-the-box support for integration with several tools (e.g. project generation for various IDEs, integration with cppcheck, etc). ”h]”jÅ)”}”(hŒ…Out-of-the-box support for integration with several tools (e.g. project generation for various IDEs, integration with cppcheck, etc).”h]”hŒ…Out-of-the-box support for integration with several tools (e.g. project generation for various IDEs, integration with cppcheck, etc).”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK$h!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jÐubeh"}”(h$]”h&]”h+]”h-]”h/]”Œbullet”Œ*”uh1j›hAj£hCK!h!j¾ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!j‹hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”j6j7uh1j›hAj£hCKh!jmhhubjÅ)”}”(hŒ"Of course there are drawbacks too:”h]”hŒ"Of course there are drawbacks too:”…””}”(hjFh!jDhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK'h!jmhhubjœ)”}”(hhh]”(j¡)”}”(hŒ.Language is problematic (e.g. variable scope).”h]”jÅ)”}”(hjWh]”hŒ.Language is problematic (e.g. variable scope).”…””}”(hjWh!jYubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK)h!jUubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jRhhhAj£hCNubj¡)”}”(hŒNot embedded approach. ”h]”jÅ)”}”(hŒNot embedded approach.”h]”hŒNot embedded approach.”…””}”(hjrh!jpubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK*h!jlubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jRhhhAj£hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”j6j7uh1j›hAj£hCK)h!jmhhubjÅ)”}”(hXhTo overcome these and other problems, we need to create workarounds for some tasks, wrap CMake functions, etc. Since this functionality can be useful in other embedded projects too, it is beneficial to collect the new code into a reusable framework and store this in a separate repository. The following diagram provides an overview of the framework structure:”h]”hXhTo overcome these and other problems, we need to create workarounds for some tasks, wrap CMake functions, etc. Since this functionality can be useful in other embedded projects too, it is beneficial to collect the new code into a reusable framework and store this in a separate repository. The following diagram provides an overview of the framework structure:”…””}”(hjŒh!jŠhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK,h!jmhhubjÅ)”}”(hŒ|Framework structure|”h]”h Œimage”“”)”}”(hŒNimage:: ../resources/diagrams/cmake_framework_structure.png :width: 75 %”h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”ŒFramework structure”Œwidth”Œ75%”Œuri”Œ0resources/diagrams/cmake_framework_structure.png”Œ candidates”}”j7jsuh1jœhAj£hCKœh!j˜hhubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK2h!jmhhubeh"}”(h$]”jùah&]”h+]”Œintroduction”ah-]”h/]”uh1jŒh!jŽhhhAj£hCKubj)”}”(hhh]”(j’)”}”(hj h]”hŒ Main features”…””}”(hj h!jÀhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡j uh1j‘h!j½hhhAj£hCK5ubj)”}”(hhh]”(j’)”}”(hj3 h]”hŒ$Structured configuration description”…””}”(hj3 h!jÐhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡j6 uh1j‘h!jÍhhhAj£hCK8ubjÅ)”}”(hŒîIn the current Makefile system the build configuration description, validation, processing, and the target creation, source file description are mixed and spread across several files. One of the goals of the framework is to organize this.”h]”hŒîIn the current Makefile system the build configuration description, validation, processing, and the target creation, source file description are mixed and spread across several files. One of the goals of the framework is to organize this.”…””}”(hjßh!jÝhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK9h!jÍhhubjÅ)”}”(hŒžThe framework provides a solution to describe the input build parameters, flags, macros, etc. in a structured way. It contains two utilities for this purpose:”h]”hŒžThe framework provides a solution to describe the input build parameters, flags, macros, etc. in a structured way. It contains two utilities for this purpose:”…””}”(hjíh!jëhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK>h!jÍhhubjœ)”}”(hhh]”(j¡)”}”(hŒ*Map: simple key-value pair implementation.”h]”jÅ)”}”(hjþh]”hŒ*Map: simple key-value pair implementation.”…””}”(hjþh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKAh!jüubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jùhhhAj£hCNubj¡)”}”(hŒ#Group: collection of related maps. ”h]”jÅ)”}”(hŒ"Group: collection of related maps.”h]”hŒ"Group: collection of related maps.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKBh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jùhhhAj£hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”j6j7uh1j›hAj£hCKAh!jÍhhubjÅ)”}”(hXºThe related parameters shall be packed into a group (or "setting group"). The setting groups shall be defined and filled with content in config files. Currently the config files are created and edited manually, but later a configuration management tool (e.g. Kconfig) shall be used to generate these files. Therefore, the framework does not contain parameter validation and conflict checking, these shall be handled by the configuration tool.”h]”hX¾The related parameters shall be packed into a group (or â€œsetting groupâ€). The setting groups shall be defined and filled with content in config files. Currently the config files are created and edited manually, but later a configuration management tool (e.g. Kconfig) shall be used to generate these files. Therefore, the framework does not contain parameter validation and conflict checking, these shall be handled by the configuration tool.”…””}”(hj3h!j1hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKDh!jÍhhubeh"}”(h$]”j< ah&]”h+]”Œ$structured configuration description”ah-]”h/]”uh1jŒh!j½hhhAj£hCK8ubj)”}”(hhh]”(j’)”}”(hjV h]”hŒTarget description”…””}”(hjV h!jIhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jY uh1j‘h!jFhhhAj£hCKLubjÅ)”}”(hXOThe framework provides an API called STGT ('simple target') to describe the targets, i.e. what is the build output, what source files are used, what libraries are linked, etc. The API wraps the CMake target functions, and also extends the built-in functionality, it can use the setting groups described in the previous section. A group can be applied onto a target, i.e. a collection of macros, flags, etc. can be applied onto the given output executable/library. This provides a more granular way than the current Makefile system where most of these are global and applied onto each target.”h]”hXSThe framework provides an API called STGT (â€˜simple targetâ€™) to describe the targets, i.e. what is the build output, what source files are used, what libraries are linked, etc. The API wraps the CMake target functions, and also extends the built-in functionality, it can use the setting groups described in the previous section. A group can be applied onto a target, i.e. a collection of macros, flags, etc. can be applied onto the given output executable/library. This provides a more granular way than the current Makefile system where most of these are global and applied onto each target.”…””}”(hjXh!jVhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKMh!jFhhubeh"}”(h$]”j_ ah&]”h+]”Œtarget description”ah-]”h/]”uh1jŒh!j½hhhAj£hCKLubj)”}”(hhh]”(j’)”}”(hjy h]”hŒCompiler abstraction”…””}”(hjy h!jnhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡j| uh1j‘h!jkhhhAj£hCKWubjÅ)”}”(hXApart from the built-in CMake usage of the compiler, there are some common tasks that CMake does not solve (e.g. preprocessing a file). For these tasks the framework uses wrapper functions instead of direct calls to the compiler. This way it is not tied to one specific compiler.”h]”hXApart from the built-in CMake usage of the compiler, there are some common tasks that CMake does not solve (e.g. preprocessing a file). For these tasks the framework uses wrapper functions instead of direct calls to the compiler. This way it is not tied to one specific compiler.”…””}”(hj}h!j{hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKXh!jkhhubeh"}”(h$]”j‚ ah&]”h+]”Œcompiler abstraction”ah-]”h/]”uh1jŒh!j½hhhAj£hCKWubj)”}”(hhh]”(j’)”}”(hjœ h]”hŒExternal tools”…””}”(hjœ h!j“hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jŸ uh1j‘h!jhhhAj£hCK^ubjÅ)”}”(hXIn the TF-A buildsystem some external tools are used, e.g. fiptool for image generation or dtc for device tree compilation. These tools have to be found and/or built by the framework. For this, the CMake find_package functionality is used, any other necessary tools can be added later.”h]”hXIn the TF-A buildsystem some external tools are used, e.g. fiptool for image generation or dtc for device tree compilation. These tools have to be found and/or built by the framework. For this, the CMake find_package functionality is used, any other necessary tools can be added later.”…””}”(hj¢h!j hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK_h!jhhubeh"}”(h$]”j¥ ah&]”h+]”Œexternal tools”ah-]”h/]”uh1jŒh!j½hhhAj£hCK^ubeh"}”(h$]”j ah&]”h+]”Œ main features”ah-]”h/]”uh1jŒh!jŽhhhAj£hCK5ubj)”}”(hhh]”(j’)”}”(hjË h]”hŒWorkflow”…””}”(hjË h!j¿hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jÎ uh1j‘h!j¼hhhAj£hCKeubjÅ)”}”(hŒPThe following diagram demonstrates the development workflow using the framework:”h]”hŒPThe following diagram demonstrates the development workflow using the framework:”…””}”(hjÎh!jÌhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKfh!j¼hhubjÅ)”}”(hŒ|Framework workflow|”h]”j)”}”(hŒ=image:: ../resources/diagrams/cmake_framework_workflow.png”h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”ŒFramework workflow”Œuri”Œ/resources/diagrams/cmake_framework_workflow.png”j®}”j7jësuh1jœhAj£hCK h!jÚhhubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKhh!j¼hhubjÅ)”}”(hŒ.The process can be split into two main phases:”h]”hŒ.The process can be split into two main phases:”…””}”(hjõh!jóhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKjh!j¼hhubjÅ)”}”(hŒÕIn the provisioning phase, first we have to obtain the necessary resources, i.e. clone the code repository and other dependencies. Next we have to do the configuration, preferably using a config tool like KConfig.”h]”hŒÕIn the provisioning phase, first we have to obtain the necessary resources, i.e. clone the code repository and other dependencies. Next we have to do the configuration, preferably using a config tool like KConfig.”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKlh!j¼hhubjÅ)”}”(hXIIn the development phase first we run CMake, which will generate the buildsystem using the selected generator backend (currently only the Makefile generator is supported). After this we run the selected build tool which in turn calls the compiler, linker, packaging tool, etc. Finally we can run and debug the output executables.”h]”hXIIn the development phase first we run CMake, which will generate the buildsystem using the selected generator backend (currently only the Makefile generator is supported). After this we run the selected build tool which in turn calls the compiler, linker, packaging tool, etc. Finally we can run and debug the output executables.”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKph!j¼hhubjÅ)”}”(hŒ˜Usually during development only the steps in this second phase have to be repeated, while the provisioning phase needs to be done only once (or rarely).”h]”hŒ˜Usually during development only the steps in this second phase have to be repeated, while the provisioning phase needs to be done only once (or rarely).”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCKvh!j¼hhubeh"}”(h$]”jÔ ah&]”h+]”Œworkflow”ah-]”h/]”uh1jŒh!jŽhhhAj£hCKeubj)”}”(hhh]”(j’)”}”(hjî h]”hŒExample”…””}”(hjî h!j5hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”j¡jñ uh1j‘h!j2hhhAj£hCKzubjÅ)”}”(hŒ6This is a short example for the basic framework usage.”h]”hŒ6This is a short example for the basic framework usage.”…””}”(hjDh!jBhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK{h!j2hhubjÅ)”}”(hŒïFirst, we create a setting group called *mem_conf* and fill it with several parameters. It is worth noting the difference between *CONFIG* and *DEFINE* types: the former is only a CMake domain option, the latter is only a C language macro.”h]”(hŒ(First, we create a setting group called ”…””}”(hŒ(First, we create a setting group called ”h!jPhhhANhCNubh Œemphasis”“”)”}”(hŒ *mem_conf*”h]”hŒmem_conf”…””}”(hhh!j[ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jPubhŒP and fill it with several parameters. It is worth noting the difference between ”…””}”(hŒP and fill it with several parameters. It is worth noting the difference between ”h!jPhhhANhCNubjZ)”}”(hŒ*CONFIG*”h]”hŒCONFIG”…””}”(hhh!jnubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jPubhŒ and ”…””}”(hŒ and ”h!jPhhhANhCNubjZ)”}”(hŒ*DEFINE*”h]”hŒDEFINE”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jPubhŒX types: the former is only a CMake domain option, the latter is only a C language macro.”…””}”(hŒX types: the former is only a CMake domain option, the latter is only a C language macro.”h!jPhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK}h!j2hhubjÅ)”}”(hXÉNext, we create a target called *fw1* and add the *mem_conf* setting group to it. This means that all source and header files used by the target will have all the parameters declared in the setting group. Then we set the target type to executable, and add some source files. Since the target has the parameters from the settings group, we can use it for conditionally adding source files. E.g. *dram_controller.c* will only be added if MEM_TYPE equals dram.”h]”(hŒ Next, we create a target called ”…””}”(hŒ Next, we create a target called ”h!jšhhhANhCNubjZ)”}”(hŒ*fw1*”h]”hŒfw1”…””}”(hhh!j£ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jšubhŒ and add the ”…””}”(hŒ and add the ”h!jšhhhANhCNubjZ)”}”(hŒ *mem_conf*”h]”hŒmem_conf”…””}”(hhh!j¶ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jšubhXN setting group to it. This means that all source and header files used by the target will have all the parameters declared in the setting group. Then we set the target type to executable, and add some source files. Since the target has the parameters from the settings group, we can use it for conditionally adding source files. E.g. ”…””}”(hXN setting group to it. This means that all source and header files used by the target will have all the parameters declared in the setting group. Then we set the target type to executable, and add some source files. Since the target has the parameters from the settings group, we can use it for conditionally adding source files. E.g. ”h!jšhhhANhCNubjZ)”}”(hŒ*dram_controller.c*”h]”hŒdram_controller.c”…””}”(hhh!jÉubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!jšubhŒ, will only be added if MEM_TYPE equals dram.”…””}”(hŒ, will only be added if MEM_TYPE equals dram.”h!jšhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK‚h!j2hhubh Œ literal_block”“”)”}”(hXÄgroup_new(NAME mem_conf) group_add(NAME mem_conf TYPE DEFINE KEY MEM_SIZE VAL 1024) group_add(NAME mem_conf TYPE CONFIG DEFINE KEY MEM_TYPE VAL dram) group_add(NAME mem_conf TYPE CFLAG KEY -Os) stgt_create(NAME fw1) stgt_add_setting(NAME fw1 GROUPS mem_conf) stgt_set_target(NAME fw1 TYPE exe) stgt_add_src(NAME fw1 SRC ${CMAKE_SOURCE_DIR}/main.c ) stgt_add_src_cond(NAME fw1 KEY MEM_TYPE VAL dram SRC ${CMAKE_SOURCE_DIR}/dram_controller.c )”h]”hXÄgroup_new(NAME mem_conf) group_add(NAME mem_conf TYPE DEFINE KEY MEM_SIZE VAL 1024) group_add(NAME mem_conf TYPE CONFIG DEFINE KEY MEM_TYPE VAL dram) group_add(NAME mem_conf TYPE CFLAG KEY -Os) stgt_create(NAME fw1) stgt_add_setting(NAME fw1 GROUPS mem_conf) stgt_set_target(NAME fw1 TYPE exe) stgt_add_src(NAME fw1 SRC ${CMAKE_SOURCE_DIR}/main.c ) stgt_add_src_cond(NAME fw1 KEY MEM_TYPE VAL dram SRC ${CMAKE_SOURCE_DIR}/dram_controller.c )”…””}”(hhh!jäubah"}”(h$]”h&]”h+]”h-]”h/]”Œ xml:space”Œpreserve”Œforce”‰Œlanguage”Œcmake”Œhighlight_args”}”uh1jâhAj£hCK‰h!j2hhubh)”}”(hŒh.. |Framework structure| image:: ../resources/diagrams/cmake_framework_structure.png :width: 75 % ”h]”j)”}”(hj h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”j©Œwidth”j«Œuri”Œ0resources/diagrams/cmake_framework_structure.png”j®}”j7j suh1jœh!jùhAj£hCKœubah"}”(h$]”h&]”h+]”j©ah-]”h/]”uh1h hAj£hCKœh!j2hhubh)”}”(hŒV.. |Framework workflow| image:: ../resources/diagrams/cmake_framework_workflow.png ”h]”j)”}”(hjàh]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”jéŒuri”Œ/resources/diagrams/cmake_framework_workflow.png”j®}”j7j suh1jœh!jhAj£hCK ubah"}”(h$]”h&]”h+]”jéah-]”h/]”uh1h hAj£hCK h!j2hhubh Œ transition”“”)”}”(hŒ--------------”h]”h"}”(h$]”h&]”h+]”h-]”h/]”uh1j(hAj£hCK£h!j2hhubjÅ)”}”(hŒM*Copyright (c) 2019-2020, Arm Limited and Contributors. All rights reserved.*”h]”jZ)”}”(hj6h]”hŒKCopyright (c) 2019-2020, Arm Limited and Contributors. All rights reserved.”…””}”(hhh!j8ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jYh!j4ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jÄhAj£hCK¥h!j2hhubeh"}”(h$]”j÷ ah&]”h+]”Œexample”ah-]”h/]”uh1jŒh!jŽhhhAj£hCKzubeh"}”(h$]”j¶ah&]”h+]”Œtf-a cmake buildsystem”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‰jaŒFramework structure”jùŒFramework workflow”juŒ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‰Œframework structure”j³Œframework workflow”j´uŒrefnames”}”Œrefids”}”Œnameids”}”(jVj¶jjjjjÖjVjSjºjùj¹j jCj< jhj_ jj‚ j²j¥ j/jÔ jOj÷ uŒ nametypes”}”(jVNjNjjNjVˆjºNj¹NjCNjhNjNj²Nj/NjONuh$}”(j¶jŽjjŠjÖjjSjMjùjmj j½j< jÍj_ jFj‚ jkj¥ jjÔ j¼j÷ j2j¢j¨jÐjÆjójéj j j6 j, jY jO j| jr jŸ j• jÎ jÄ jñ jç uŒ 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”“”}”jŠK s…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒ decoration”Nhhub.