deploy: b00bed7

Author: vstehle

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 9bb47a28bfcebe77ea5e5f4766082e53
+config: e4272c91b8a52b04a1327efafa151a45
 tags: 33eac41acc08762151beb8f3b7b86c8f

_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: 'v2.3.0-33-g452fd1b',
+    VERSION: 'v2.3.0-34-gb00bed7',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'singlehtml',

index.html

@@ -5,11 +5,11 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Embedded Base Boot Requirements (EBBR) Specification v2.3.0-33-g452fd1b documentation</title>
+    <title>Embedded Base Boot Requirements (EBBR) Specification v2.3.0-34-gb00bed7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="_static/basic.css?v=b08954a9" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css?v=27fed22d" />
-    <script src="_static/documentation_options.js?v=4758643d"></script>
+    <script src="_static/documentation_options.js?v=7e88a772"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -1397,18 +1397,26 @@ <h4><span class="section-number">3.2.1. </span>AArch64 Multiprocessor Startup Pr
 conform to the Power State Coordination Interface specification <a class="reference internal" href="#document-references#psci" id="id1"><span>[PSCI]</span></a> and to
 the SMC Calling Convention <a class="reference internal" href="#document-references#smccc" id="id2"><span>[SMCCC]</span></a>.</p>
 <p>Platforms without EL3 must implement PSCI and SMCCC at EL2 (leaving only EL1
-available to an operating system).</p>
+available to an operating system). <a class="footnote-reference brackets" href="#conduitnote" id="id3" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a></p>
+<aside class="footnote-list brackets">
+<aside class="footnote brackets" id="conduitnote" role="doc-footnote">
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id3">1</a><span class="fn-bracket">]</span></span>
+<p>Refer to <a class="reference internal" href="#document-references#smccc" id="id4"><span>[SMCCC]</span></a> § 2.5.3 Conduits for details on the conduit
+instructions (SMC &amp; HVC) and their dependence on Exception Levels (EL3 &amp;
+EL2).</p>
+</aside>
+</aside>
 <p>It is recommended that firmware implements PSCI version 1.0 or later
-<a class="footnote-reference brackets" href="#pscinote" id="id3" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a> and SMCCC version 1.1 or later <a class="footnote-reference brackets" href="#smcccnote" id="id4" role="doc-noteref"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></a>.</p>
+<a class="footnote-reference brackets" href="#pscinote" id="id5" role="doc-noteref"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></a> and SMCCC version 1.1 or later <a class="footnote-reference brackets" href="#smcccnote" id="id6" role="doc-noteref"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></a>.</p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="pscinote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id3">1</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id5">2</a><span class="fn-bracket">]</span></span>
 <p>PSCI version 1.0 is considered as an errata fix release for
 version 0.2, where functions interfaces have been stabilized.
 It also introduced the <cite>PSCI_FEATURES</cite> function, for standardized discovery.</p>
 </aside>
 <aside class="footnote brackets" id="smcccnote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id4">2</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id6">3</a><span class="fn-bracket">]</span></span>
 <p>Starting with SMCCC version 1.1, support for the <cite>SMCCC_VERSION</cite>
 function is required, for standardized discovery.</p>
 </aside>
@@ -1423,18 +1431,18 @@ <h4><span class="section-number">3.2.1. </span>AArch64 Multiprocessor Startup Pr
 <h4><span class="section-number">3.2.2. </span>AArch64 Firmware Framework<a class="headerlink" href="#aarch64-firmware-framework" title="Link to this heading">¶</a></h4>
 <p>On AArch64 platforms, when privileged or secure firmware implements the Firmware
 Framework for A-profile (FF-A), it must conform to the Arm Firmware Framework
-for Arm A-profile specification <a class="reference internal" href="#document-references#ffa" id="id5"><span>[FFA]</span></a> and it must support at least one callee
-version compatible with caller version 1.2. <a class="footnote-reference brackets" href="#ffanote" id="id6" role="doc-noteref"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></a></p>
+for Arm A-profile specification <a class="reference internal" href="#document-references#ffa" id="id7"><span>[FFA]</span></a> and it must support at least one callee
+version compatible with caller version 1.2. <a class="footnote-reference brackets" href="#ffanote" id="id8" role="doc-noteref"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></a></p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="ffanote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id6">3</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id8">4</a><span class="fn-bracket">]</span></span>
 <p>FF-A is an Arm software architecture describing interfaces that
 standardize communication between software images and firmware, in the Secure
 world and the Normal world.
 FF-A v1.2 introduced support for multiple services UUIDs in a partition,
 which eases services discovery, as well as the supporting
 <cite>FFA_MSG_SEND_DIRECT_REQ2</cite> ABI.
-As per the FF-A specification <a class="reference internal" href="#document-references#ffa" id="id7"><span>[FFA]</span></a> § 13.2 FFA_VERSION, all callee versions
+As per the FF-A specification <a class="reference internal" href="#document-references#ffa" id="id9"><span>[FFA]</span></a> § 13.2 FFA_VERSION, all callee versions
 1.x, with x &gt;= 2, are compatible with caller versions 1.0 to 1.x, which
 includes caller version 1.2.</p>
 </aside>
@@ -1444,11 +1452,11 @@ <h4><span class="section-number">3.2.2. </span>AArch64 Firmware Framework<a clas
 <h4><span class="section-number">3.2.3. </span>AArch64 Platform Fault Detection<a class="headerlink" href="#aarch64-platform-fault-detection" title="Link to this heading">¶</a></h4>
 <p>On AArch64 platforms, when privileged or secure firmware implements the Platform
 Fault Detection Interface (PFDI), it must be compliant with the requirements
-defined in <a class="reference internal" href="#document-references#pfdi" id="id8"><span>[PFDI]</span></a> § 5 Compliance Requirements, and it must support a version
-1.0 client. <a class="footnote-reference brackets" href="#pfdinote" id="id9" role="doc-noteref"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></a></p>
+defined in <a class="reference internal" href="#document-references#pfdi" id="id10"><span>[PFDI]</span></a> § 5 Compliance Requirements, and it must support a version
+1.0 client. <a class="footnote-reference brackets" href="#pfdinote" id="id11" role="doc-noteref"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></a></p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="pfdinote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id9">4</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id11">5</a><span class="fn-bracket">]</span></span>
 <p>PFDI is an Arm standard interface that enables System Software to
 request fault detection checks from Platform Firmware.
 At the time of writing, only PFDI version 1.0 is defined.</p>
@@ -1459,19 +1467,19 @@ <h4><span class="section-number">3.2.3. </span>AArch64 Platform Fault Detection<
 <h4><span class="section-number">3.2.4. </span>AArch64 System Control and Management<a class="headerlink" href="#aarch64-system-control-and-management" title="Link to this heading">¶</a></h4>
 <p>On AArch64 platforms, when the System Control and Management Interface (SCMI) is
 described in the ACPI table or the Devicetree, it must conform to the Arm System
-Control and Management Interface specification <a class="reference internal" href="#document-references#scmi" id="id10"><span>[SCMI]</span></a> and the following
-implementation requirements take precedence. <a class="footnote-reference brackets" href="#scminote" id="id11" role="doc-noteref"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></a></p>
+Control and Management Interface specification <a class="reference internal" href="#document-references#scmi" id="id12"><span>[SCMI]</span></a> and the following
+implementation requirements take precedence. <a class="footnote-reference brackets" href="#scminote" id="id13" role="doc-noteref"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span></a></p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="scminote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id11">5</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id13">6</a><span class="fn-bracket">]</span></span>
 <p>SCMI is a set of software interfaces defined by Arm, used for
 system management.
 It can be implemented by privileged or secure firmware, or by another
 processor.</p>
 </aside>
 </aside>
-<table class="docutils align-default" id="id16">
-<caption><span class="caption-number">Table 3.1 </span><span class="caption-text">SCMI Implementation Requirements</span><a class="headerlink" href="#id16" title="Link to this table">¶</a></caption>
+<table class="docutils align-default" id="id18">
+<caption><span class="caption-number">Table 3.1 </span><span class="caption-text">SCMI Implementation Requirements</span><a class="headerlink" href="#id18" title="Link to this table">¶</a></caption>
 <colgroup>
 <col style="width: 33.3%" />
 <col style="width: 33.3%" />
@@ -1480,7 +1488,7 @@ <h4><span class="section-number">3.2.4. </span>AArch64 System Control and Manage
 <thead>
 <tr class="row-odd"><th class="head"><p>SCMI Protocol</p></th>
 <th class="head"><p>Minimum required version (when implemented)</p></th>
-<th class="head"><p>Minimum recommended version (when implemented) <a class="footnote-reference brackets" href="#scmirecomnote" id="id12" role="doc-noteref"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span></a></p></th>
+<th class="head"><p>Minimum recommended version (when implemented) <a class="footnote-reference brackets" href="#scmirecomnote" id="id14" role="doc-noteref"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></a></p></th>
 </tr>
 </thead>
 <tbody>
@@ -1528,7 +1536,7 @@ <h4><span class="section-number">3.2.4. </span>AArch64 System Control and Manage
 </table>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="scmirecomnote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id12">6</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id14">7</a><span class="fn-bracket">]</span></span>
 <p>SCMI specification v3.2 introduced version negotiation,
 which eases agents and platforms interoperability, and this is therefore the
 recommended implementation.</p>
@@ -1539,10 +1547,10 @@ <h4><span class="section-number">3.2.4. </span>AArch64 System Control and Manage
 <h4><span class="section-number">3.2.5. </span>AArch64 Random Number Generator<a class="headerlink" href="#aarch64-random-number-generator" title="Link to this heading">¶</a></h4>
 <p>On AArch64 platforms, if the platform has a hardware entropy source it is
 recommended that privileged or secure firmware implements the True Random Number
-Generator Firmware Interface version 1.0, as defined in <a class="reference internal" href="#document-references#trng" id="id13"><span>[TRNG]</span></a>. <a class="footnote-reference brackets" href="#trngnote" id="id14" role="doc-noteref"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></a></p>
+Generator Firmware Interface version 1.0, as defined in <a class="reference internal" href="#document-references#trng" id="id15"><span>[TRNG]</span></a>. <a class="footnote-reference brackets" href="#trngnote" id="id16" role="doc-noteref"><span class="fn-bracket">[</span>8<span class="fn-bracket">]</span></a></p>
 <aside class="footnote-list brackets">
 <aside class="footnote brackets" id="trngnote" role="doc-footnote">
-<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id14">7</a><span class="fn-bracket">]</span></span>
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id16">8</a><span class="fn-bracket">]</span></span>
 <p>The firmware TRNG is complementary to the <cite>EFI_RNG_PROTOCOL</cite> as
 it can be used at runtime.
 The TRNG interface requires SMCCC version 1.1 or later.</p>
@@ -1553,7 +1561,7 @@ <h4><span class="section-number">3.2.5. </span>AArch64 Random Number Generator<a
 <section id="risc-v-multiprocessor-startup-protocol">
 <h3><span class="section-number">3.3. </span>RISC-V Multiprocessor Startup Protocol<a class="headerlink" href="#risc-v-multiprocessor-startup-protocol" title="Link to this heading">¶</a></h3>
 <p>The resident firmware in M mode or hypervisor running in HS mode must implement
-and conform to at least SBI <a class="reference internal" href="#document-references#rvsbispc" id="id15"><span>[RVSBISPC]</span></a> v2.0 with at least these extensions:</p>
+and conform to at least SBI <a class="reference internal" href="#document-references#rvsbispc" id="id17"><span>[RVSBISPC]</span></a> v2.0 with at least these extensions:</p>
 <ul class="simple">
 <li><p>Base Extension</p></li>
 <li><p>HART State Management Extension (HSM)</p></li>