€•Œ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”Œcomponents/firmware-update”Œ 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ŒFirmware Update (FWU)”h]”hŒFirmware Update (FWU)”…””}”(hj•h!j“hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jŽhhhAŒ[/home/test/workspace/code/optee_3.16/trusted-firmware-a/docs/components/firmware-update.rst”hCKubj)”}”(hhh]”(j’)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hj§h!j¥hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j¢hhhAj¡hCKubh Œ paragraph”“”)”}”(hX This document describes the design of the Firmware Update (FWU) feature, which enables authenticated firmware to update firmware images from external interfaces such as USB, UART, SD-eMMC, NAND, NOR or Ethernet to SoC Non-Volatile memories such as NAND Flash, LPDDR2-NVM or any memory determined by the platform. This feature functions even when the current firmware in the system is corrupt or missing; it therefore may be used as a recovery mode. It may also be complemented by other, higher level firmware update software.”h]”hX This document describes the design of the Firmware Update (FWU) feature, which enables authenticated firmware to update firmware images from external interfaces such as USB, UART, SD-eMMC, NAND, NOR or Ethernet to SoC Non-Volatile memories such as NAND Flash, LPDDR2-NVM or any memory determined by the platform. This feature functions even when the current firmware in the system is corrupt or missing; it therefore may be used as a recovery mode. It may also be complemented by other, higher level firmware update software.”…””}”(hj·h!jµhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKh!j¢hhubj´)”}”(hX%FWU implements a specific part of the Trusted Board Boot Requirements (TBBR) specification, Arm DEN0006C-1. It should be used in conjunction with the :ref:`Trusted Board Boot` design document, which describes the image authentication parts of the Trusted Firmware-A (TF-A) TBBR implementation.”h]”(hŒ–FWU implements a specific part of the Trusted Board Boot Requirements (TBBR) specification, Arm DEN0006C-1. It should be used in conjunction with the ”…””}”(hŒ–FWU implements a specific part of the Trusted Board Boot Requirements (TBBR) specification, Arm DEN0006C-1. It should be used in conjunction with the ”h!jÃhhhANhCNubh)”}”(hŒ:ref:`Trusted Board Boot`”h]”h)”}”(hjÎh]”hŒTrusted Board Boot”…””}”(hhh!jÐubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!jÌubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÚŒreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆh?Œtrusted board boot”uh1hhAj¡hCKh!jÃubhŒv design document, which describes the image authentication parts of the Trusted Firmware-A (TF-A) TBBR implementation.”…””}”(hŒv design document, which describes the image authentication parts of the Trusted Firmware-A (TF-A) TBBR implementation.”h!jÃhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKh!j¢hhubj)”}”(hhh]”(j’)”}”(hŒScope”h]”hŒScope”…””}”(hjüh!júhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j÷hhhAj¡hCKubj´)”}”(hŒöThis document describes the secure world FWU design. It is beyond its scope to describe how normal world FWU images should operate. To implement normal world FWU images, please refer to the "Non-Trusted Firmware Updater" requirements in the TBBR.”h]”hŒúThis document describes the secure world FWU design. It is beyond its scope to describe how normal world FWU images should operate. To implement normal world FWU images, please refer to the â€œNon-Trusted Firmware Updaterâ€ requirements in the TBBR.”…””}”(hj h!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKh!j÷hhubeh"}”(h$]”Œscope”ah&]”h+]”Œscope”ah-]”h/]”uh1jŒh!j¢hhhAj¡hCKubeh"}”(h$]”Œintroduction”ah&]”h+]”Œintroduction”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCKubj)”}”(hhh]”(j’)”}”(hŒFWU Overview”h]”hŒFWU Overview”…””}”(hj+h!j)hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j&hhhAj¡hCKubj´)”}”(hXNThe FWU boot flow is primarily mediated by BL1. Since BL1 executes in ROM, and it is usually desirable to minimize the amount of ROM code, the design allows some parts of FWU to be implemented in other secure and normal world images. Platform code may choose which parts are implemented in which images but the general expectation is:”h]”hXNThe FWU boot flow is primarily mediated by BL1. Since BL1 executes in ROM, and it is usually desirable to minimize the amount of ROM code, the design allows some parts of FWU to be implemented in other secure and normal world images. Platform code may choose which parts are implemented in which images but the general expectation is:”…””}”(hj9h!j7hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKh!j&hhubh Œbullet_list”“”)”}”(hhh]”(h Œ list_item”“”)”}”(hŒãBL1 handles: - Detection and initiation of the FWU boot flow. - Copying images from non-secure to secure memory - FWU image authentication - Context switching between the normal and secure world during the FWU process. ”h]”(j´)”}”(hŒBL1 handles:”h]”hŒBL1 handles:”…””}”(hjRh!jPubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK%h!jLubjF)”}”(hhh]”(jK)”}”(hŒ.Detection and initiation of the FWU boot flow.”h]”j´)”}”(hjch]”hŒ.Detection and initiation of the FWU boot flow.”…””}”(hjch!jeubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK'h!jaubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j^ubjK)”}”(hŒ/Copying images from non-secure to secure memory”h]”j´)”}”(hjzh]”hŒ/Copying images from non-secure to secure memory”…””}”(hjzh!j|ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK(h!jxubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j^ubjK)”}”(hŒFWU image authentication”h]”j´)”}”(hj‘h]”hŒFWU image authentication”…””}”(hj‘h!j“ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK)h!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j^ubjK)”}”(hŒNContext switching between the normal and secure world during the FWU process. ”h]”j´)”}”(hŒMContext switching between the normal and secure world during the FWU process.”h]”hŒMContext switching between the normal and secure world during the FWU process.”…””}”(hj¬h!jªubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK*h!j¦ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j^ubeh"}”(h$]”h&]”h+]”h-]”h/]”Œbullet”Œ-”uh1jEhAj¡hCK'h!jLubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jGhhhANhCNubjK)”}”(hŒYOther secure world FWU images handle platform initialization required by the FWU process.”h]”j´)”}”(hŒYOther secure world FWU images handle platform initialization required by the FWU process.”h]”hŒYOther secure world FWU images handle platform initialization required by the FWU process.”…””}”(hjÒh!jÐubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK-h!jÌubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jGhhhAj¡hCNubjK)”}”(hŒiNormal world FWU images handle loading of firmware images from external interfaces to non-secure memory. ”h]”j´)”}”(hŒhNormal world FWU images handle loading of firmware images from external interfaces to non-secure memory.”h]”hŒhNormal world FWU images handle loading of firmware images from external interfaces to non-secure memory.”…””}”(hjêh!jèubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK/h!jäubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jGhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jÄjÅuh1jEhAj¡hCK%h!j&hhubj´)”}”(hŒ0The primary requirements of the FWU feature are:”h]”hŒ0The primary requirements of the FWU feature are:”…””}”(hj h!j hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK2h!j&hhubh Œenumerated_list”“”)”}”(hhh]”(jK)”}”(hŒeExport a BL1 SMC interface to interoperate with other FWU images executing at other Exception Levels.”h]”j´)”}”(hŒeExport a BL1 SMC interface to interoperate with other FWU images executing at other Exception Levels.”h]”hŒeExport a BL1 SMC interface to interoperate with other FWU images executing at other Exception Levels.”…””}”(hj h!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK4h!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j hhhAj¡hCNubjK)”}”(hŒÅExport a platform interface to provide FWU common code with the information it needs, and to enable platform specific FWU functionality. See the :ref:`Porting Guide` for details of this interface. ”h]”j´)”}”(hŒÄExport a platform interface to provide FWU common code with the information it needs, and to enable platform specific FWU functionality. See the :ref:`Porting Guide` for details of this interface.”h]”(hŒ‘Export a platform interface to provide FWU common code with the information it needs, and to enable platform specific FWU functionality. See the ”…””}”(hŒ‘Export a platform interface to provide FWU common code with the information it needs, and to enable platform specific FWU functionality. See the ”h!j1 ubh)”}”(hŒ:ref:`Porting Guide`”h]”h)”}”(hj< h]”hŒ Porting Guide”…””}”(hhh!j> ubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!j: ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jH Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆh?Œ porting guide”uh1hhAj¡hCK6h!j1 ubhŒ for details of this interface.”…””}”(hŒ for details of this interface.”h!j1 ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK6h!j- ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!j hhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j h!j&hhhAj¡hCK4ubj´)”}”(hŒŸTF-A uses abbreviated image terminology for FWU images like for other TF-A images. See the :ref:`Image Terminology` document for an explanation of these terms.”h]”(hŒ[TF-A uses abbreviated image terminology for FWU images like for other TF-A images. See the ”…””}”(hŒ[TF-A uses abbreviated image terminology for FWU images like for other TF-A images. See the ”h!jv hhhANhCNubh)”}”(hŒ:ref:`Image Terminology`”h]”h)”}”(hj h]”hŒImage Terminology”…””}”(hhh!jƒ ubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆh?Œimage terminology”uh1hhAj¡hCK:h!jv ubhŒ, document for an explanation of these terms.”…””}”(hŒ, document for an explanation of these terms.”h!jv hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK:h!j&hhubj´)”}”(hŒàThe following diagram shows the FWU boot flow for Arm development platforms. Arm CSS platforms like Juno have a System Control Processor (SCP), and these use all defined FWU images. Other platforms may use a subset of these.”h]”hŒàThe following diagram shows the FWU boot flow for Arm development platforms. Arm CSS platforms like Juno have a System Control Processor (SCP), and these use all defined FWU images. Other platforms may use a subset of these.”…””}”(hj¬ h!jª hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCK>h!j&hhubj´)”}”(hŒ|Flow Diagram|”h]”h Œimage”“”)”}”(hŒ*image:: ../resources/diagrams/fwu_flow.png”h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”ŒFlow Diagram”Œuri”Œresources/diagrams/fwu_flow.png”Œ candidates”}”Œ*”jË suh1j¼ hAj¡hCMh!j¸ hhubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKBh!j&hhubeh"}”(h$]”Œfwu-overview”ah&]”h+]”Œfwu overview”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCKubj)”}”(hhh]”(j’)”}”(hŒImage Identification”h]”hŒImage Identification”…””}”(hjâ h!jà hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jÝ hhhAj¡hCKEubj´)”}”(hXWEach FWU image and certificate is identified by a unique ID, defined by the platform, which BL1 uses to fetch an image descriptor (``image_desc_t``) via a call to ``bl1_plat_get_image_desc()``. The same ID is also used to prepare the Chain of Trust (Refer to the :ref:`Authentication Framework & Chain of Trust` document for more information).”h]”(hŒƒEach FWU image and certificate is identified by a unique ID, defined by the platform, which BL1 uses to fetch an image descriptor (”…””}”(hŒƒEach FWU image and certificate is identified by a unique ID, defined by the platform, which BL1 uses to fetch an image descriptor (”h!jî hhhANhCNubh Œliteral”“”)”}”(hŒ``image_desc_t``”h]”hŒimage_desc_t”…””}”(hhh!jù ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jî ubhŒ) via a call to ”…””}”(hŒ) via a call to ”h!jî hhhANhCNubjø )”}”(hŒ``bl1_plat_get_image_desc()``”h]”hŒbl1_plat_get_image_desc()”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jî ubhŒG. The same ID is also used to prepare the Chain of Trust (Refer to the ”…””}”(hŒG. The same ID is also used to prepare the Chain of Trust (Refer to the ”h!jî hhhANhCNubh)”}”(hŒ0:ref:`Authentication Framework & Chain of Trust`”h]”h)”}”(hj!h]”hŒ)Authentication Framework & Chain of Trust”…””}”(hhh!j#ubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j-Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆh?Œ)authentication framework & chain of trust”uh1hhAj¡hCKGh!jî ubhŒ document for more information).”…””}”(hŒ document for more information).”h!jî hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKGh!jÝ hhubj´)”}”(hŒ8The image descriptor includes the following information:”h]”hŒ8The image descriptor includes the following information:”…””}”(hjLh!jJhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKMh!jÝ hhubjF)”}”(hhh]”(jK)”}”(hŒôExecutable or non-executable image. This indicates whether the normal world is permitted to request execution of a secure world FWU image (after authentication). Secure world certificates and non-AP images are examples of non-executable images.”h]”j´)”}”(hŒôExecutable or non-executable image. This indicates whether the normal world is permitted to request execution of a secure world FWU image (after authentication). Secure world certificates and non-AP images are examples of non-executable images.”h]”hŒôExecutable or non-executable image. This indicates whether the normal world is permitted to request execution of a secure world FWU image (after authentication). Secure world certificates and non-AP images are examples of non-executable images.”…””}”(hjah!j_ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKOh!j[ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jXhhhAj¡hCNubjK)”}”(hŒvSecure or non-secure image. This indicates whether the image is authenticated/executed in secure or non-secure memory.”h]”j´)”}”(hŒvSecure or non-secure image. This indicates whether the image is authenticated/executed in secure or non-secure memory.”h]”hŒvSecure or non-secure image. This indicates whether the image is authenticated/executed in secure or non-secure memory.”…””}”(hjyh!jwubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKSh!jsubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jXhhhAj¡hCNubjK)”}”(hŒImage base address and size.”h]”j´)”}”(hjh]”hŒImage base address and size.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKUh!j‹ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jJh!jXhhhAj¡hCNubjK)”}”(hŒ free secure memory) return -ENOMEM if (image overlaps another image) return -EPERM”h]”hXArguments: uint32_t function ID : 0x10 unsigned int image_id uintptr_t image_addr unsigned int block_size unsigned int image_size Return: int : 0 (Success) : -ENOMEM : -EPERM Pre-conditions: if (image_id is invalid) return -EPERM if (image_id is non-secure image) return -EPERM if (image_id state is not (RESET or COPYING)) return -EPERM if (secure world caller) return -EPERM if (image_addr + block_size overflows) return -ENOMEM if (image destination address + image_size overflows) return -ENOMEM if (source block is in secure memory) return -ENOMEM if (source block is not mapped into BL1) return -ENOMEM if (image_size > free secure memory) return -ENOMEM if (image overlaps another image) return -EPERM”…””}”(hhh!jtubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCKÅh!jchhubj´)”}”(hX‚This SMC copies the secure image indicated by ``image_id`` from non-secure memory to secure memory for later authentication. The image may be copied in a single block or multiple blocks. In either case, the total size of the image must be provided in ``image_size`` when invoking this SMC for the first time for each image; it is ignored in subsequent calls (if any) for the same image.”h]”(hŒ.This SMC copies the secure image indicated by ”…””}”(hŒ.This SMC copies the secure image indicated by ”h!j‚hhhANhCNubjø )”}”(hŒ``image_id``”h]”hŒimage_id”…””}”(hhh!j‹ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j‚ubhŒÁ from non-secure memory to secure memory for later authentication. The image may be copied in a single block or multiple blocks. In either case, the total size of the image must be provided in ”…””}”(hŒÁ from non-secure memory to secure memory for later authentication. The image may be copied in a single block or multiple blocks. In either case, the total size of the image must be provided in ”h!j‚hhhANhCNubjø )”}”(hŒ``image_size``”h]”hŒ image_size”…””}”(hhh!jžubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j‚ubhŒy when invoking this SMC for the first time for each image; it is ignored in subsequent calls (if any) for the same image.”…””}”(hŒy when invoking this SMC for the first time for each image; it is ignored in subsequent calls (if any) for the same image.”h!j‚hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKÝh!jchhubj´)”}”(hŒThe ``image_addr`` and ``block_size`` specify the source memory block to copy from. The destination address is provided by the platform code.”h]”(hŒThe ”…””}”(hŒThe ”h!j·hhhANhCNubjø )”}”(hŒ``image_addr``”h]”hŒ image_addr”…””}”(hhh!jÀubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j·ubhŒ and ”…””}”(hŒ and ”h!j·hhhANhCNubjø )”}”(hŒ``block_size``”h]”hŒ block_size”…””}”(hhh!jÓubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j·ubhŒh specify the source memory block to copy from. The destination address is provided by the platform code.”…””}”(hŒh specify the source memory block to copy from. The destination address is provided by the platform code.”h!j·hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKãh!jchhubj´)”}”(hXwIf ``block_size`` is greater than the amount of remaining bytes to copy for this image then the former is truncated to the latter. The copy operation is then considered as complete and the FWU state machine transitions to the "COPIED" state. If there is still more to copy, the FWU state machine stays in or transitions to the COPYING state (depending on the previous state).”h]”(hŒIf ”…””}”(hŒIf ”h!jìhhhANhCNubjø )”}”(hŒ``block_size``”h]”hŒ block_size”…””}”(hhh!jõubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jìubhXj is greater than the amount of remaining bytes to copy for this image then the former is truncated to the latter. The copy operation is then considered as complete and the FWU state machine transitions to the â€œCOPIEDâ€ state. If there is still more to copy, the FWU state machine stays in or transitions to the COPYING state (depending on the previous state).”…””}”(hXf is greater than the amount of remaining bytes to copy for this image then the former is truncated to the latter. The copy operation is then considered as complete and the FWU state machine transitions to the "COPIED" state. If there is still more to copy, the FWU state machine stays in or transitions to the COPYING state (depending on the previous state).”h!jìhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKæh!jchhubj´)”}”(hŒaWhen using multiple blocks, the source blocks do not necessarily need to be in contiguous memory.”h]”hŒaWhen using multiple blocks, the source blocks do not necessarily need to be in contiguous memory.”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKìh!jchhubj´)”}”(hŒOOnce the SMC is handled, BL1 returns from exception to the normal world caller.”h]”hŒOOnce the SMC is handled, BL1 returns from exception to the normal world caller.”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCKïh!jchhubeh"}”(h$]”Œfwu-smc-image-copy”ah&]”h+]”Œfwu_smc_image_copy”ah-]”h/]”uh1jŒh!jJhhhAj¡hCKÁubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_IMAGE_AUTH”h]”hŒFWU_SMC_IMAGE_AUTH”…””}”(hj7h!j5hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j2hhhAj¡hCKòubjm)”}”(hX*Arguments: uint32_t function ID : 0x11 unsigned int image_id uintptr_t image_addr unsigned int image_size Return: int : 0 (Success) : -ENOMEM : -EPERM : -EAUTH Pre-conditions: if (image_id is invalid) return -EPERM if (secure world caller) if (image_id state is not RESET) return -EPERM if (image_addr/image_size is not mapped into BL1) return -ENOMEM else // normal world caller if (image_id is secure image) if (image_id state is not COPIED) return -EPERM else // image_id is non-secure image if (image_id state is not RESET) return -EPERM if (image_addr/image_size is in secure memory) return -ENOMEM if (image_addr/image_size not mapped into BL1) return -ENOMEM”h]”hX*Arguments: uint32_t function ID : 0x11 unsigned int image_id uintptr_t image_addr unsigned int image_size Return: int : 0 (Success) : -ENOMEM : -EPERM : -EAUTH Pre-conditions: if (image_id is invalid) return -EPERM if (secure world caller) if (image_id state is not RESET) return -EPERM if (image_addr/image_size is not mapped into BL1) return -ENOMEM else // normal world caller if (image_id is secure image) if (image_id state is not COPIED) return -EPERM else // image_id is non-secure image if (image_id state is not RESET) return -EPERM if (image_addr/image_size is in secure memory) return -ENOMEM if (image_addr/image_size not mapped into BL1) return -ENOMEM”…””}”(hhh!jCubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCKöh!j2hhubj´)”}”(hXLThis SMC authenticates the image specified by ``image_id``. If the image is in the RESET state, BL1 authenticates the image in place using the provided ``image_addr`` and ``image_size``. If the image is a secure image in the COPIED state, BL1 authenticates the image from the secure memory that BL1 previously copied the image into.”h]”(hŒ.This SMC authenticates the image specified by ”…””}”(hŒ.This SMC authenticates the image specified by ”h!jQhhhANhCNubjø )”}”(hŒ``image_id``”h]”hŒimage_id”…””}”(hhh!jZubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jQubhŒ^. If the image is in the RESET state, BL1 authenticates the image in place using the provided ”…””}”(hŒ^. If the image is in the RESET state, BL1 authenticates the image in place using the provided ”h!jQhhhANhCNubjø )”}”(hŒ``image_addr``”h]”hŒ image_addr”…””}”(hhh!jmubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jQubhŒ and ”…””}”(hŒ and ”h!jQhhhANhCNubjø )”}”(hŒ``image_size``”h]”hŒ image_size”…””}”(hhh!j€ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jQubhŒ“. If the image is a secure image in the COPIED state, BL1 authenticates the image from the secure memory that BL1 previously copied the image into.”…””}”(hŒ“. If the image is a secure image in the COPIED state, BL1 authenticates the image from the secure memory that BL1 previously copied the image into.”h!jQhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMh!j2hhubj´)”}”(hŒÖBL1 returns from exception to the caller. If authentication succeeds then BL1 sets the image state to AUTHENTICATED. If authentication fails then BL1 returns the -EAUTH error and sets the image state back to RESET.”h]”hŒÖBL1 returns from exception to the caller. If authentication succeeds then BL1 sets the image state to AUTHENTICATED. If authentication fails then BL1 returns the -EAUTH error and sets the image state back to RESET.”…””}”(hj›h!j™hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMh!j2hhubeh"}”(h$]”Œfwu-smc-image-auth”ah&]”h+]”Œfwu_smc_image_auth”ah-]”h/]”uh1jŒh!jJhhhAj¡hCKòubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_IMAGE_EXECUTE”h]”hŒFWU_SMC_IMAGE_EXECUTE”…””}”(hj´h!j²hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j¯hhhAj¡hCMubjm)”}”(hX†Arguments: uint32_t function ID : 0x12 unsigned int image_id Return: int : 0 (Success) : -EPERM Pre-conditions: if (image_id is invalid) return -EPERM if (secure world caller) return -EPERM if (image_id is non-secure image) return -EPERM if (image_id is non-executable image) return -EPERM if (image_id state is not AUTHENTICATED) return -EPERM”h]”hX†Arguments: uint32_t function ID : 0x12 unsigned int image_id Return: int : 0 (Success) : -EPERM Pre-conditions: if (image_id is invalid) return -EPERM if (secure world caller) return -EPERM if (image_id is non-secure image) return -EPERM if (image_id is non-executable image) return -EPERM if (image_id state is not AUTHENTICATED) return -EPERM”…””}”(hhh!jÀubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCMh!j¯hhubj´)”}”(hŒòThis SMC initiates execution of a previously authenticated image specified by ``image_id``, in the other security world to the caller. The current implementation only supports normal world callers initiating execution of a secure world image.”h]”(hŒNThis SMC initiates execution of a previously authenticated image specified by ”…””}”(hŒNThis SMC initiates execution of a previously authenticated image specified by ”h!jÎhhhANhCNubjø )”}”(hŒ``image_id``”h]”hŒimage_id”…””}”(hhh!j×ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!jÎubhŒ˜, in the other security world to the caller. The current implementation only supports normal world callers initiating execution of a secure world image.”…””}”(hŒ˜, in the other security world to the caller. The current implementation only supports normal world callers initiating execution of a secure world image.”h!jÎhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCM-h!j¯hhubj´)”}”(hŒ…BL1 saves the normal world caller's context, sets the secure image state to EXECUTED, and returns from exception to the secure image.”h]”hŒ‡BL1 saves the normal world callerâ€™s context, sets the secure image state to EXECUTED, and returns from exception to the secure image.”…””}”(hjòh!jðhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCM2h!j¯hhubeh"}”(h$]”Œfwu-smc-image-execute”ah&]”h+]”Œfwu_smc_image_execute”ah-]”h/]”uh1jŒh!jJhhhAj¡hCMubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_IMAGE_RESUME”• 1h]”hŒFWU_SMC_IMAGE_RESUME”…””}”(hjh!j hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jhhhAj¡hCM6ubjm)”}”(hŒëArguments: uint32_t function ID : 0x13 register_t image_param Return: register_t : image_param (Success) : -EPERM Pre-conditions: if (normal world caller and no INTERRUPTED secure image) return -EPERM”h]”hŒëArguments: uint32_t function ID : 0x13 register_t image_param Return: register_t : image_param (Success) : -EPERM Pre-conditions: if (normal world caller and no INTERRUPTED secure image) return -EPERM”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCM:h!jhhubj´)”}”(hŒwThis SMC resumes execution in the other security world while there is a secure image in the EXECUTED/INTERRUPTED state.”h]”hŒwThis SMC resumes execution in the other security world while there is a secure image in the EXECUTED/INTERRUPTED state.”…””}”(hj'h!j%hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMEh!jhhubj´)”}”(hXåFor normal world callers, BL1 sets the previously interrupted secure image state to EXECUTED. For secure world callers, BL1 sets the previously executing secure image state to INTERRUPTED. In either case, BL1 saves the calling world's context, restores the resuming world's context and returns from exception into the resuming world. If the call is successful then the caller provided ``image_param`` is returned to the resumed world, otherwise an error code is returned to the caller.”h]”(hX…For normal world callers, BL1 sets the previously interrupted secure image state to EXECUTED. For secure world callers, BL1 sets the previously executing secure image state to INTERRUPTED. In either case, BL1 saves the calling worldâ€™s context, restores the resuming worldâ€™s context and returns from exception into the resuming world. If the call is successful then the caller provided ”…””}”(hXFor normal world callers, BL1 sets the previously interrupted secure image state to EXECUTED. For secure world callers, BL1 sets the previously executing secure image state to INTERRUPTED. In either case, BL1 saves the calling world's context, restores the resuming world's context and returns from exception into the resuming world. If the call is successful then the caller provided ”h!j3hhhANhCNubjø )”}”(hŒ``image_param``”h]”hŒimage_param”…””}”(hhh!j<ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j3ubhŒU is returned to the resumed world, otherwise an error code is returned to the caller.”…””}”(hŒU is returned to the resumed world, otherwise an error code is returned to the caller.”h!j3hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMHh!jhhubeh"}”(h$]”Œfwu-smc-image-resume”ah&]”h+]”Œfwu_smc_image_resume”ah-]”h/]”uh1jŒh!jJhhhAj¡hCM6ubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_SEC_IMAGE_DONE”h]”hŒFWU_SMC_SEC_IMAGE_DONE”…””}”(hjbh!j`hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j]hhhAj¡hCMQubjm)”}”(hŒ–Arguments: uint32_t function ID : 0x14 Return: int : 0 (Success) : -EPERM Pre-conditions: if (normal world caller) return -EPERM”h]”hŒ–Arguments: uint32_t function ID : 0x14 Return: int : 0 (Success) : -EPERM Pre-conditions: if (normal world caller) return -EPERM”…””}”(hhh!jnubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCMUh!j]hhubj´)”}”(hŒEThis SMC indicates completion of a previously executing secure image.”h]”hŒEThis SMC indicates completion of a previously executing secure image.”…””}”(hj~h!j|hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCM_h!j]hhubj´)”}”(hŒœBL1 sets the previously executing secure image state to the RESET state, restores the normal world context and returns from exception into the normal world.”h]”hŒœBL1 sets the previously executing secure image state to the RESET state, restores the normal world context and returns from exception into the normal world.”…””}”(hjŒh!jŠhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMah!j]hhubeh"}”(h$]”Œfwu-smc-sec-image-done”ah&]”h+]”Œfwu_smc_sec_image_done”ah-]”h/]”uh1jŒh!jJhhhAj¡hCMQubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_UPDATE_DONE”h]”hŒFWU_SMC_UPDATE_DONE”…””}”(hj¥h!j£hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j hhhAj¡hCMfubjm)”}”(hŒZArguments: uint32_t function ID : 0x15 register_t client_cookie Return: N/A”h]”hŒZArguments: uint32_t function ID : 0x15 register_t client_cookie Return: N/A”…””}”(hhh!j±ubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCMjh!j hhubj´)”}”(hŒÉThis SMC completes the firmware update process. BL1 calls the platform specific function ``bl1_plat_fwu_done``, passing the optional argument ``client_cookie`` as a ``void *``. The SMC does not return.”h]”(hŒYThis SMC completes the firmware update process. BL1 calls the platform specific function ”…””}”(hŒYThis SMC completes the firmware update process. BL1 calls the platform specific function ”h!j¿hhhANhCNubjø )”}”(hŒ``bl1_plat_fwu_done``”h]”hŒbl1_plat_fwu_done”…””}”(hhh!jÈubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j¿ubhŒ , passing the optional argument ”…””}”(hŒ , passing the optional argument ”h!j¿hhhANhCNubjø )”}”(hŒ``client_cookie``”h]”hŒ client_cookie”…””}”(hhh!jÛubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j¿ubhŒ as a ”…””}”(hŒ as a ”h!j¿hhhANhCNubjø )”}”(hŒ ``void *``”h]”hŒvoid *”…””}”(hhh!jîubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j÷ h!j¿ubhŒ. The SMC does not return.”…””}”(hŒ. The SMC does not return.”h!j¿hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMqh!j hhubeh"}”(h$]”Œfwu-smc-update-done”ah&]”h+]”Œfwu_smc_update_done”ah-]”h/]”uh1jŒh!jJhhhAj¡hCMfubj)”}”(hhh]”(j’)”}”(hŒFWU_SMC_IMAGE_RESET”h]”hŒFWU_SMC_IMAGE_RESET”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jhhhAj¡hCMvubjm)”}”(hŒÝArguments: uint32_t function ID : 0x16 unsigned int image_id Return: int : 0 (Success) : -EPERM Pre-conditions: if (secure world caller) return -EPERM if (image in EXECUTED) return -EPERM”h]”hŒÝArguments: uint32_t function ID : 0x16 unsigned int image_id Return: int : 0 (Success) : -EPERM Pre-conditions: if (secure world caller) return -EPERM if (image in EXECUTED) return -EPERM”…””}”(hhh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”j|j}uh1jlhAj¡hCMzh!jhhubj´)”}”(hŒNThis SMC sets the state of an image to RESET and zeroes the memory used by it.”h]”hŒNThis SMC sets the state of an image to RESET and zeroes the memory used by it.”…””}”(hj0h!j.hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCM†h!jhhubj´)”}”(hŒ8This is only allowed if the image is not being executed.”h]”hŒ8This is only allowed if the image is not being executed.”…””}”(hj>h!j<hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMˆh!jhhubh Œ transition”“”)”}”(hŒ--------------”h]”h"}”(h$]”h&]”h+]”h-]”h/]”uh1jJhAj¡hCMŠh!jhhubj´)”}”(hŒM*Copyright (c) 2015-2019, Arm Limited and Contributors. All rights reserved.*”h]”h Œemphasis”“”)”}”(hjXh]”hŒKCopyright (c) 2015-2019, Arm Limited and Contributors. All rights reserved.”…””}”(hhh!j\ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jZh!jVubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j³hAj¡hCMŒh!jhhubh Œtarget”“”)”}”(hŒI.. _Universally Unique Identifier: https://tools.ietf.org/rfc/rfc4122.txt”h]”h"}”(h$]”Œuniversally-unique-identifier”ah&]”h+]”Œuniversally unique identifier”ah-]”h/]”jÏjÐuh1johCMÓh!jhhhAj¡Œ referenced”Kubh)”}”(hŒ<.. |Flow Diagram| image:: ../resources/diagrams/fwu_flow.png”h]”j½ )”}”(hjÀ h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”jÉ Œuri”Œresources/diagrams/fwu_flow.png”jÌ }”jÎ jsuh1j¼ h!j~hAj¡hCMubah"}”(h$]”h&]”h+]”jÉ ah-]”h/]”uh1h hAj¡hCMh!jhhubh)”}”(hŒC.. |FWU state machine| image:: ../resources/diagrams/fwu_states.png”h]”j½ )”}”(hjuh]”h"}”(h$]”h&]”h+]”h-]”h/]”Œalt”j~Œuri”Œ!resources/diagrams/fwu_states.png”jÌ }”jÎ j¤suh1j¼ h!j•hAj¡hCMubah"}”(h$]”h&]”h+]”j~ah-]”h/]”uh1h hAj¡hCMh!jhhubeh"}”(h$]”Œfwu-smc-image-reset”ah&]”h+]”Œfwu_smc_image_reset”ah-]”h/]”uh1jŒh!jJhhhAj¡hCMvubeh"}”(h$]”Œbl1-smc-interface”ah&]”h+]”Œbl1 smc interface”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCKubeh"}”(h$]”Œfirmware-update-fwu”ah&]”h+]”Œfirmware update (fwu)”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ŒFlow Diagram”j~ŒFWU state machine”j•uŒ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‰Œflow diagram”jŒfwu state machine”juŒrefnames”}”Œuniversally unique identifier”]”j¾asŒrefids”}”Œnameids”}”(jÁj¾j#j jjjÚ j× jMjJjGjDj¹j¶j‘jŽjâjßjjj`j]j/j,j¬j©jjjZjWjjšjj j±j®jzjwuŒ nametypes”}”(jÁNj#NjNjÚ NjMNjGNj¹Nj‘NjâNjNj`Nj/Nj¬NjNjZNjNjNj±Njzˆuh$}”(j¾jŽj j¢jj÷j× j&jJjÝ jDjPj¶jJjŽj[jßj”jjåj]jj,jcj©j2jj¯jWjjšj]j j j®jjwjquŒ 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.