From 6e8fa0611f19824e200fe4725f18bce7e2000071 Mon Sep 17 00:00:00 2001 From: Nishanth Menon <nm@ti.com> Date: Thu, 27 Jul 2023 13:59:02 -0500 Subject: [PATCH] board: ti: k3: Convert boot flow ascii flow to svg Replace the ascii flow diagram with svg. Signed-off-by: Nishanth Menon <nm@ti.com> --- doc/board/ti/img/boot_flow_01.svg | 220 +++++++++++ doc/board/ti/img/boot_flow_02.svg | 459 +++++++++++++++++++++++ doc/board/ti/img/boot_flow_03.svg | 583 ++++++++++++++++++++++++++++++ doc/board/ti/k3.rst | 15 +- 4 files changed, 1265 insertions(+), 12 deletions(-) create mode 100644 doc/board/ti/img/boot_flow_01.svg create mode 100644 doc/board/ti/img/boot_flow_02.svg create mode 100644 doc/board/ti/img/boot_flow_03.svg diff --git a/doc/board/ti/img/boot_flow_01.svg b/doc/board/ti/img/boot_flow_01.svg new file mode 100644 index 0000000000..b5bd0ac277 --- /dev/null +++ b/doc/board/ti/img/boot_flow_01.svg @@ -0,0 +1,220 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<svg + version="1.1" + width="296px" + height="302px" + viewBox="-0.5 -0.5 296 302" + id="svg50" + sodipodi:docname="boot_flow_01.svg" + inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns="http://www.w3.org/2000/svg" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:xhtml="http://www.w3.org/1999/xhtml"> + <sodipodi:namedview + id="namedview52" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageshadow="2" + inkscape:pageopacity="0.0" + inkscape:pagecheckerboard="0" + showgrid="false" + inkscape:zoom="2.2582781" + inkscape:cx="144.35777" + inkscape:cy="151" + inkscape:window-width="3440" + inkscape:window-height="1416" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="1" + inkscape:current-layer="svg50" /> + <defs + id="defs2" /> + <g + id="g40"> + <path + d="M 0 23 L 0 0 L 295 0 L 295 23" + fill="#ffe6cc" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="all" + id="path4" /> + <path + d="M 0 23 L 0 300 L 295 300 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path6" /> + <path + d="M 0 23 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path8" /> + <g + transform="translate(-0.5 -0.5)" + id="g14"> + <switch + id="switch12"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 293px; height: 1px; padding-top: 12px; margin-left: 1px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;">WKUP Domain</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="148" + y="15" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + font-weight="bold" + id="text10">WKUP Domain</text> + </switch> + </g> + <rect + x="25" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect16" /> + <path + d="M 75 90 L 75 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path18" /> + <g + transform="translate(-0.5 -0.5)" + id="g24"> + <switch + id="switch22"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 26px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">ROM</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="75" + y="74" + fill="#000000" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text20">ROM</text> + </switch> + </g> + <rect + x="165" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect26" /> + <path + d="M 215 90 L 215 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path28" /> + <g + transform="translate(-0.5 -0.5)" + id="g34"> + <switch + id="switch32"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 166px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">WKUP SPL</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="215" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text30">WKUP SPL</text> + </switch> + </g> + <path + d="M 74.67 130 L 150 130 L 208.13 130" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path36" /> + <path + d="M 213.38 130 L 206.38 133.5 L 208.13 130 L 206.38 126.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path38" /> + </g> + <switch + id="switch48"> + <g + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + id="g42" /> + <a + transform="translate(0,-5)" + xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems" + target="_blank" + id="a46"> + <text + text-anchor="middle" + font-size="10px" + x="50%" + y="100%" + id="text44">Text is not SVG - cannot display</text> + </a> + </switch> +</svg> diff --git a/doc/board/ti/img/boot_flow_02.svg b/doc/board/ti/img/boot_flow_02.svg new file mode 100644 index 0000000000..4e282d8baf --- /dev/null +++ b/doc/board/ti/img/boot_flow_02.svg @@ -0,0 +1,459 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<svg + version="1.1" + width="751px" + height="301px" + viewBox="-0.5 -0.5 751 301" + id="svg104" + sodipodi:docname="boot_flow_02.svg" + inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns="http://www.w3.org/2000/svg" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:xhtml="http://www.w3.org/1999/xhtml"> + <sodipodi:namedview + id="namedview106" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageshadow="2" + inkscape:pageopacity="0.0" + inkscape:pagecheckerboard="0" + showgrid="false" + inkscape:zoom="1.4993342" + inkscape:cx="370.1643" + inkscape:cy="150.73357" + inkscape:window-width="3440" + inkscape:window-height="1416" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="1" + inkscape:current-layer="svg104" /> + <defs + id="defs2" /> + <g + id="g94"> + <path + d="M 0 23 L 0 0 L 295 0 L 295 23" + fill="#ffe6cc" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="all" + id="path4" /> + <path + d="M 0 23 L 0 300 L 295 300 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path6" /> + <path + d="M 0 23 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path8" /> + <g + transform="translate(-0.5 -0.5)" + id="g14"> + <switch + id="switch12"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 293px; height: 1px; padding-top: 12px; margin-left: 1px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;">WKUP Domain</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="148" + y="15" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + font-weight="bold" + id="text10">WKUP Domain</text> + </switch> + </g> + <rect + x="25" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect16" /> + <path + d="M 75 90 L 75 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path18" /> + <g + transform="translate(-0.5 -0.5)" + id="g24"> + <switch + id="switch22"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 26px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">ROM</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="75" + y="74" + fill="#000000" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text20">ROM</text> + </switch> + </g> + <rect + x="165" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect26" /> + <path + d="M 215 90 L 215 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path28" /> + <g + transform="translate(-0.5 -0.5)" + id="g34"> + <switch + id="switch32"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 166px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">WKUP SPL</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="215" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text30">WKUP SPL</text> + </switch> + </g> + <path + d="M 74.5 130 L 150 130 L 208.13 130" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path36" /> + <path + d="M 213.38 130 L 206.38 133.5 L 208.13 130 L 206.38 126.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path38" /> + <path + d="M 310 23 L 310 0 L 750 0 L 750 23" + fill="#d5e8d4" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path40" /> + <path + d="M 310 23 L 310 300 L 750 300 L 750 23" + fill="none" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path42" /> + <path + d="M 310 23 L 750 23" + fill="none" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path44" /> + <g + transform="translate(-0.5 -0.5)" + id="g50"> + <switch + id="switch48"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 438px; height: 1px; padding-top: 12px; margin-left: 311px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;">Main Domain</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="530" + y="15" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + font-weight="bold" + id="text46">Main Domain</text> + </switch> + </g> + <rect + x="335" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect52" /> + <path + d="M 385 90 L 385 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path54" /> + <g + transform="translate(-0.5 -0.5)" + id="g60"> + <switch + id="switch58"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 336px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">TF-A</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="385" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text56">TF-A</text> + </switch> + </g> + <rect + x="475" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect62" /> + <path + d="M 525 90 L 525 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path64" /> + <g + transform="translate(-0.5 -0.5)" + id="g70"> + <switch + id="switch68"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 476px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">OP-TEE</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="525" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text66">OP-TEE</text> + </switch> + </g> + <path + d="M 384.5 180 L 420 180 L 518.13 180" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path72" /> + <path + d="M 523.38 180 L 516.38 183.5 L 518.13 180 L 516.38 176.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path74" /> + <rect + x="620" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect76" /> + <path + d="M 670 90 L 670 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path78" /> + <g + transform="translate(-0.5 -0.5)" + id="g84"> + <switch + id="switch82"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 621px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">Main SPL</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="670" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text80">Main SPL</text> + </switch> + </g> + <path + d="M 524.5 201 L 565.5 201 L 663.13 201" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path86" /> + <path + d="M 668.38 201 L 661.38 204.5 L 663.13 201 L 661.38 197.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path88" /> + <path + d="M 214.5 160 L 315.5 160 L 378.13 160" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path90" /> + <path + d="M 383.38 160 L 376.38 163.5 L 378.13 160 L 376.38 156.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path92" /> + </g> + <switch + id="switch102"> + <g + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + id="g96" /> + <a + transform="translate(0,-5)" + xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems" + target="_blank" + id="a100"> + <text + text-anchor="middle" + font-size="10px" + x="50%" + y="100%" + id="text98">Text is not SVG - cannot display</text> + </a> + </switch> +</svg> diff --git a/doc/board/ti/img/boot_flow_03.svg b/doc/board/ti/img/boot_flow_03.svg new file mode 100644 index 0000000000..b77d679926 --- /dev/null +++ b/doc/board/ti/img/boot_flow_03.svg @@ -0,0 +1,583 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<svg + version="1.1" + width="1031px" + height="301px" + viewBox="-0.5 -0.5 1031 301" + id="svg132" + sodipodi:docname="boot_flow_03.svg" + inkscape:version="1.1.2 (0a00cf5339, 2022-02-04)" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns="http://www.w3.org/2000/svg" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns:xhtml="http://www.w3.org/1999/xhtml"> + <sodipodi:namedview + id="namedview134" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageshadow="2" + inkscape:pageopacity="0.0" + inkscape:pagecheckerboard="0" + showgrid="false" + inkscape:zoom="1.0921435" + inkscape:cx="508.17496" + inkscape:cy="150.16341" + inkscape:window-width="3440" + inkscape:window-height="1416" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="1" + inkscape:current-layer="svg132" /> + <defs + id="defs2" /> + <g + id="g122"> + <path + d="M 0 23 L 0 0 L 295 0 L 295 23" + fill="#ffe6cc" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="all" + id="path4" /> + <path + d="M 0 23 L 0 300 L 295 300 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path6" /> + <path + d="M 0 23 L 295 23" + fill="none" + stroke="#d79b00" + stroke-miterlimit="10" + pointer-events="none" + id="path8" /> + <g + transform="translate(-0.5 -0.5)" + id="g14"> + <switch + id="switch12"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 293px; height: 1px; padding-top: 12px; margin-left: 1px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;">WKUP Domain</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="148" + y="15" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + font-weight="bold" + id="text10">WKUP Domain</text> + </switch> + </g> + <rect + x="25" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect16" /> + <path + d="M 75 90 L 75 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path18" /> + <g + transform="translate(-0.5 -0.5)" + id="g24"> + <switch + id="switch22"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 26px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">ROM</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="75" + y="74" + fill="#000000" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text20">ROM</text> + </switch> + </g> + <rect + x="165" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect26" /> + <path + d="M 215 90 L 215 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path28" /> + <g + transform="translate(-0.5 -0.5)" + id="g34"> + <switch + id="switch32"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 166px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">WKUP SPL</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="215" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text30">WKUP SPL</text> + </switch> + </g> + <path + d="M 74.5 130 L 150 130 L 208.13 130" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path36" /> + <path + d="M 213.38 130 L 206.38 133.5 L 208.13 130 L 206.38 126.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path38" /> + <path + d="M 310 23 L 310 0 L 1030 0 L 1030 23" + fill="#d5e8d4" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path40" /> + <path + d="M 310 23 L 310 300 L 1030 300 L 1030 23" + fill="none" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path42" /> + <path + d="M 310 23 L 1030 23" + fill="none" + stroke="#82b366" + stroke-miterlimit="10" + pointer-events="none" + id="path44" /> + <g + transform="translate(-0.5 -0.5)" + id="g50"> + <switch + id="switch48"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 718px; height: 1px; padding-top: 12px; margin-left: 311px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;">Main Domain</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="670" + y="15" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + font-weight="bold" + id="text46">Main Domain</text> + </switch> + </g> + <rect + x="335" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect52" /> + <path + d="M 385 90 L 385 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path54" /> + <g + transform="translate(-0.5 -0.5)" + id="g60"> + <switch + id="switch58"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 336px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">TF-A</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="385" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text56">TF-A</text> + </switch> + </g> + <rect + x="475" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect62" /> + <path + d="M 525 90 L 525 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path64" /> + <g + transform="translate(-0.5 -0.5)" + id="g70"> + <switch + id="switch68"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 476px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">OP-TEE</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="525" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text66">OP-TEE</text> + </switch> + </g> + <path + d="M 384.5 180 L 420 180 L 518.13 180" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path72" /> + <path + d="M 523.38 180 L 516.38 183.5 L 518.13 180 L 516.38 176.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path74" /> + <rect + x="620" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect76" /> + <path + d="M 670 90 L 670 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path78" /> + <g + transform="translate(-0.5 -0.5)" + id="g84"> + <switch + id="switch82"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 621px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">Main SPL</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="670" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text80">Main SPL</text> + </switch> + </g> + <path + d="M 524.5 201 L 565.5 201 L 663.13 201" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path86" /> + <path + d="M 668.38 201 L 661.38 204.5 L 663.13 201 L 661.38 197.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path88" /> + <rect + x="765" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect90" /> + <path + d="M 815 90 L 815 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path92" /> + <g + transform="translate(-0.5 -0.5)" + id="g98"> + <switch + id="switch96"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 766px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">U-Boot</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="815" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text94">U-Boot</text> + </switch> + </g> + <rect + x="900" + y="50" + width="100" + height="40" + fill="rgb(255, 255, 255)" + stroke="rgb(0, 0, 0)" + pointer-events="none" + id="rect100" /> + <path + d="M 950 90 L 950 280" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + stroke-dasharray="3 3" + pointer-events="none" + id="path102" /> + <g + transform="translate(-0.5 -0.5)" + id="g108"> + <switch + id="switch106"> + <foreignObject + pointer-events="none" + width="100%" + height="100%" + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + style="overflow: visible; text-align: left;"> + <xhtml:div + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 70px; margin-left: 901px;"> + <xhtml:div + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + <xhtml:div + style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">Linux</xhtml:div> + </xhtml:div> + </xhtml:div> + </foreignObject> + <text + x="950" + y="74" + fill="rgb(0, 0, 0)" + font-family="Helvetica" + font-size="12px" + text-anchor="middle" + id="text104">Linux</text> + </switch> + </g> + <path + d="M 669.5 220 L 711 220 L 808.13 220" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path110" /> + <path + d="M 813.38 220 L 806.38 223.5 L 808.13 220 L 806.38 216.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path112" /> + <path + d="M 814.5 240 L 851.5 240 L 943.13 240" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path114" /> + <path + d="M 948.38 240 L 941.38 243.5 L 943.13 240 L 941.38 236.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path116" /> + <path + d="M 214.5 160 L 315.5 160 L 378.13 160" + fill="none" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path118" /> + <path + d="M 383.38 160 L 376.38 163.5 L 378.13 160 L 376.38 156.5 Z" + fill="rgb(0, 0, 0)" + stroke="rgb(0, 0, 0)" + stroke-miterlimit="10" + pointer-events="none" + id="path120" /> + </g> + <switch + id="switch130"> + <g + requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" + id="g124" /> + <a + transform="translate(0,-5)" + xlink:href="https://www.diagrams.net/doc/faq/svg-export-text-problems" + target="_blank" + id="a128"> + <text + text-anchor="middle" + font-size="10px" + x="50%" + y="100%" + id="text126">Text is not SVG - cannot display</text> + </a> + </switch> +</svg> diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst index eb1896b06c..9d40675b60 100644 --- a/doc/board/ti/k3.rst +++ b/doc/board/ti/k3.rst @@ -45,10 +45,7 @@ boot media needed to load the binaries packaged inside `tiboot3.bin`, including a 32bit U-Boot SPL, (called the wakup SPL) that ROM will jump to after it has finished loading everything into internal SRAM. -.. code-block:: text - - | WKUP Domain - ROM -> WKUP SPL -> +.. image:: img/boot_flow_01.svg The wakeup SPL, running on a wakeup domain core, will initialize DDR and any peripherals needed load the larger binaries inside the `tispl.bin` @@ -57,10 +54,7 @@ application cores inside the main domain to initialize the main domain, starting with Trusted Firmware-A (TF-A), before moving on to start OP-TEE and the main domain's U-Boot SPL. -.. code-block:: text - - | WKUP Domain | Main Domain -> - ROM -> WKUP SPL -> TF-A -> OP-TEE -> Main SPL +.. image:: img/boot_flow_02.svg The main domain's SPL, running on a 64bit application core, has virtually unlimited space (billions of bytes now that DDR is working) to @@ -68,10 +62,7 @@ initialize even more peripherals needed to load in the `u-boot.img` which loads more firmware into the micro-controller & wakeup domains and finally prepare the main domain to run Linux. -.. code-block:: text - - | WKUP Domain | Main Domain -> - ROM -> WKUP SPL -> TF-A -> OP-TEE -> Main SPL -> UBoot -> Linux +.. image:: img/boot_flow_03.svg This is the typical boot flow for all K3 based SoCs, however this flow offers quite a lot in the terms of flexibility, especially on High