u-boot/doc/board/ti/img/openocd-overview.svg
Jason Kacines effe50854a doc: board: ti: k3: Add a guide to debugging with OpenOCD
Bootloader debug usually tends to be a bit dicey prior to DDR and
serial port getting active in the system. JTAG typically remains the
only practical debug option during the initial bringup.

OpenOCD is one of the most popular environment for providing debug
capability via a GDB compatible interface for developers to work with.

Debugging U-Boot and bootloaders on K3 platform does have a bit of
tribal knowledge that is better documented in our common platform
documentation.

Signed-off-by: Jason Kacines <j-kacines@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2023-08-09 08:41:52 +02:00

580 lines
20 KiB
XML

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!--SPDX-License-Identifier: GPL-2.0-or-later OR BSD-3-Clause-->
<!--Copyright (C) 2023 Texas Instruments Incorporated - https://www.ti.com/-->
<svg
xmlns:xhtml="http://www.w3.org/1999/xhtml"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
version="1.1"
width="281px"
height="671px"
viewBox="-0.5 -0.5 281 671"
id="svg128"
sodipodi:docname="openocd-overview.svg"
inkscape:version="0.92.3 (2405546, 2018-03-11)">
<metadata
id="metadata132">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
</cc:Work>
</rdf:RDF>
</metadata>
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="3440"
inkscape:window-height="1391"
id="namedview130"
showgrid="false"
inkscape:zoom="1.4068554"
inkscape:cx="283.8637"
inkscape:cy="385.05999"
inkscape:window-x="0"
inkscape:window-y="25"
inkscape:window-maximized="1"
inkscape:current-layer="svg128" />
<defs
id="defs2" />
<g
id="g118">
<path
d="M 0 510 L 0 510 L 280 510 L 280 510"
fill="rgb(255, 255, 255)"
stroke="#ff0a1b"
stroke-miterlimit="10"
pointer-events="all"
id="path4" />
<path
d="M 0 510 L 0 670 L 280 670 L 280 510"
fill="none"
stroke="#ff0a1b"
stroke-miterlimit="10"
pointer-events="none"
id="path6" />
<rect
x="10"
y="590"
width="100"
height="70"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect8" />
<path
d="M 20 590 L 20 660 M 100 590 L 100 660"
fill="none"
stroke="#b85450"
stroke-miterlimit="10"
pointer-events="none"
id="path10" />
<g
transform="translate(-0.5 -0.5)"
id="g16">
<switch
id="switch14">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 78px; height: 1px; padding-top: 625px; margin-left: 21px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">Cortex-R</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="60"
y="629"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text12">Cortex-R</text>
</switch>
</g>
<rect
x="170"
y="590"
width="100"
height="70"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect18" />
<path
d="M 180 590 L 180 660 M 260 590 L 260 660"
fill="none"
stroke="#b85450"
stroke-miterlimit="10"
pointer-events="none"
id="path20" />
<g
transform="translate(-0.5 -0.5)"
id="g26">
<switch
id="switch24">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 78px; height: 1px; padding-top: 625px; margin-left: 181px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">Cortex-A</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="220"
y="629"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text22">Cortex-A</text>
</switch>
</g>
<g
transform="translate(-0.5 -0.5)"
id="g32">
<switch
id="switch30">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 530px; margin-left: 221px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">K3 SoC</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="250"
y="534"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text28">K3 SoC</text>
</switch>
</g>
<path
d="M 140 550 L 140 570 L 60 570 L 60 583.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path34" />
<path
d="M 60 588.88 L 56.5 581.88 L 60 583.63 L 63.5 581.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path36" />
<path
d="M 140 550 L 140 570 L 220 570 L 220 583.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path38" />
<path
d="M 220 588.88 L 216.5 581.88 L 220 583.63 L 223.5 581.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path40" />
<rect
x="90"
y="520"
width="100"
height="30"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect42" />
<g
transform="translate(-0.5 -0.5)"
id="g48">
<switch
id="switch46">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 535px; margin-left: 91px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">Debug SS</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="539"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text44">Debug SS</text>
</switch>
</g>
<path
d="M 140 470 L 140 503.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path50" />
<path
d="M 140 508.88 L 136.5 501.88 L 140 503.63 L 143.5 501.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path52" />
<rect
x="80"
y="410"
width="120"
height="60"
rx="9"
ry="9"
fill="#ffe6cc"
stroke="#d79b00"
pointer-events="none"
id="rect54" />
<g
transform="translate(-0.5 -0.5)"
id="g60">
<switch
id="switch58">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 440px; margin-left: 81px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">Jtag Interface<xhtml:br />
(XDS110, TUMPA..)</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="444"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text56">Jtag Interface...</text>
</switch>
</g>
<path
d="M 140 370 L 140 403.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path62" />
<path
d="M 140 408.88 L 136.5 401.88 L 140 403.63 L 143.5 401.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path64" />
<rect
x="80"
y="310"
width="120"
height="60"
fill="#f5f5f5"
stroke="#666666"
pointer-events="none"
id="rect66" />
<g
transform="translate(-0.5 -0.5)"
id="g72">
<switch
id="switch70">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 340px; margin-left: 81px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: #333333; ">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(51, 51, 51); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">PC</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="344"
fill="#333333"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text68">PC</text>
</switch>
</g>
<g
transform="translate(-0.5 -0.5)"
id="g78">
<switch
id="switch76">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 385px; margin-left: 141px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">USB</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="170"
y="389"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text74">USB</text>
</switch>
</g>
<g
transform="translate(-0.5 -0.5)"
id="g84">
<switch
id="switch82">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 485px; margin-left: 141px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">JTAG</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="170"
y="489"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text80">JTAG</text>
</switch>
</g>
<path
d="M 100 230 L 180 230 L 200 270 L 180 310 L 100 310 L 80 270 Z"
fill="#e1d5e7"
stroke="#9673a6"
stroke-miterlimit="10"
pointer-events="none"
id="path86" />
<g
transform="translate(-0.5 -0.5)"
id="g92">
<switch
id="switch90">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 270px; margin-left: 81px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">OpenOCD</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="274"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text88">OpenOCD</text>
</switch>
</g>
<path
d="M 140 200 L 140 220 L 140 210 L 140 223.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path94" />
<path
d="M 140 228.88 L 136.5 221.88 L 140 223.63 L 143.5 221.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path96" />
<path
d="M 100 120 L 180 120 L 200 160 L 180 200 L 100 200 L 80 160 Z"
fill="#e1d5e7"
stroke="#9673a6"
stroke-miterlimit="10"
pointer-events="none"
id="path98" />
<g
transform="translate(-0.5 -0.5)"
id="g104">
<switch
id="switch102">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 160px; margin-left: 81px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">GDB</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="164"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text100">GDB</text>
</switch>
</g>
<path
d="M 140 80 L 140 113.63"
fill="none"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path106" />
<path
d="M 140 118.88 L 136.5 111.88 L 140 113.63 L 143.5 111.88 Z"
fill="rgb(0, 0, 0)"
stroke="rgb(0, 0, 0)"
stroke-miterlimit="10"
pointer-events="none"
id="path108" />
<path
d="M 80 0 L 200 0 L 200 68 Q 170 46.4 140 68 Q 110 89.6 80 68 L 80 12 Z"
fill="#e1d5e7"
stroke="#9673a6"
stroke-miterlimit="10"
pointer-events="none"
id="path110" />
<g
transform="translate(-0.5 -0.5)"
id="g116">
<switch
id="switch114">
<foreignObject
style="overflow: visible; text-align: left;"
pointer-events="none"
width="100%"
height="100%"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 28px; margin-left: 81px;">
<xhtml:div
style="box-sizing: border-box; font-size: 0px; text-align: center;"
data-drawio-colors="color: rgb(0, 0, 0); ">
<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;">IDE debugging code</xhtml:div>
</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="140"
y="32"
fill="rgb(0, 0, 0)"
font-family="Helvetica"
font-size="12px"
text-anchor="middle"
id="text112">IDE debugging code</text>
</switch>
</g>
</g>
</svg>