Documentation/flashing_firmware: Add info about SPI flash header

Some mainboards have a header connected to the SPI bus, which can be
used to connect a second flash chip and override the onboard flash. This
allows one to boot coreboot on the system without ever having to flash
the onboard flash. HP boards with this header all seem to use the same
2x8 or 2x10 header layout, so document the pinout.

Change-Id: Ic2bf1244adfb78872340f212519c6ab33e26646a
Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/67818
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>

3 files changed, 149 insertions, 0 deletions

diff --git a/Documentation/tutorial/flashing_firmware/ext_standalone.md b/Documentation/tutorial/flashing_firmware/ext_standalone.md
index 3a676ce47ca4..1cb03e1cc134 100644
--- a/Documentation/tutorial/flashing_firmware/ext_standalone.md
+++ b/Documentation/tutorial/flashing_firmware/ext_standalone.md
@@ -19,5 +19,45 @@ It is possible to set the onboard flash on hold and use another flash chip.
 Connect all lines one-to-one, except /HOLD. Pull /HOLD of the soldered flash IC
 low, and /HOLD of your replacement flash IC high.
 
+### SPI header
+Some boards feature a pin header which is connected to the SPI bus. This can
+also be used to connect a secondary flash chip.
+
+#### HP boards
+Many HP desktop mainboards have a 2x8 or 2x10 block of header pins which
+can be used to connect a second flash chip. One pin is connected to the
+onboard flash's /CS pin, and another is connected to the chipset's /CS
+pin. Normally a jumper cap is placed between these pins, allowing the
+chipset to access the onboard flash. To use this header, remove this
+jumper and connect all lines except /CS one-to-one with the
+corresponding pin on the header. The secondary flash chip's /CS line
+should be connected to the chipset /CS pin on the header. By doing this
+the secondary SPI flash, rather than the onboard flash, will respond to
+accesses from the chipset.
+
+![][hp_spi_header_pinout]
+
+![][hp_spi_header_mainboard]
+
+Note that on boards where this header is unpopulated, a jumper resistor
+will be populated nearby which serves the purpose of the jumper cap. One
+end should have continuity with the /CS pin on the flash, and the other
+end should have continuity with the chipset /CS pin on the unpopulated
+header. It may also be possible to find this resistor through visual
+inspection of the traces on the /CS pins. This resistor should be
+desoldered if you wish to solder a pin header to the board and connect a
+secondary flash, otherwise the onboard flash will always respond to
+accesses.
+
+#### Other boards
+Other boards may have similar headers, but will likely use a different
+pinout than the ones explicitly mentioned here. Usually such a header
+will be located near the onboard SPI flash. If schematics are available,
+the pinout for the header will likely be found in it, but it could also
+be determined using a multimeter in continuity mode to map out the
+connections between the SPI flash and the header.
+
 
 [EM100Pro]: https://www.dediprog.com/product/EM100Pro
+[hp_spi_header_pinout]: hp_spi_header.svg
+[hp_spi_header_mainboard]: hp_spi_header_mb.jpg
diff --git a/Documentation/tutorial/flashing_firmware/hp_spi_header.svg b/Documentation/tutorial/flashing_firmware/hp_spi_header.svg
new file mode 100644
index 000000000000..c29a444604e5
--- /dev/null
+++ b/Documentation/tutorial/flashing_firmware/hp_spi_header.svg
@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+
+<svg
+   width="40.266247mm"
+   height="20.267391mm"
+   viewBox="0 0 40.266247 20.267391"
+   version="1.1"
+   id="svg5"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs2" />
+  <g
+     id="layer1"
+     transform="translate(0.1322915,0.1322915)">
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.264583"
+       d="M 0,0 C 0,6.6676027 0,13.335205 0,20.002808"
+       id="path500" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.264583"
+       d="m 0,20.002808 c 13.333889,0 26.667777,0 40.001666,0 0,-6.667603 0,-13.3352053 0,-20.002808 -6.665673,0 -13.331347,0 -19.99702,0 0,6.6676027 0,13.335205 0,20.002808"
+       id="path506" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.264583"
+       d="m 0,0 c 3.3327445,0 6.6654889,0 9.9982334,0 0,6.6676027 0,13.335205 0,20.002808"
+       id="path508" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.264583"
+       d="m 0,10.001404 c 13.333889,0 26.667777,0 40.001666,0"
+       id="path510" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.264583"
+       d="m 30.003154,0 c 0,6.6676027 0,13.335205 0,20.002808"
+       id="path512" />
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="22.156124"
+       y="6.3107877"
+       id="text676"><tspan
+         x="22.156124"
+         y="6.3107877">VCC</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="31.972855"
+       y="6.3107877"
+       id="text730"><tspan
+         id="tspan728"
+         x="31.972855"
+         y="6.3107877">GND</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="32.398666"
+       y="16.285427"
+       id="text734"><tspan
+         id="tspan732"
+         x="32.398666"
+         y="16.285427">CLK</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="22.770041"
+       y="16.285427"
+       id="text738"><tspan
+         id="tspan736"
+         x="22.770041"
+         y="16.285427">DO</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="13.605446"
+       y="16.286804"
+       id="text742"><tspan
+         id="tspan740"
+         x="13.605446"
+         y="16.286804">DI</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.82222px"
+       style="fill: #000000;text-anchor:start;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="2.5204566"
+       y="6.1998558"
+       id="text746"><tspan
+         id="tspan744"
+         x="2.5204566"
+         y="6.1998558">/CS</tspan></text>
+    <text
+       xml:space="preserve"
+       font-size="2.5px"
+       style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal"
+       x="5.0321894"
+       y="14.500522"
+       id="text750"><tspan
+         id="tspan748"
+         x="5.0321894"
+         y="14.500522">/CS</tspan><tspan
+         x="5.0321894"
+         y="17.146358"
+         id="tspan752">chipset</tspan></text>
+  </g>
+</svg>
diff --git a/Documentation/tutorial/flashing_firmware/hp_spi_header_mb.jpg b/Documentation/tutorial/flashing_firmware/hp_spi_header_mb.jpg
new file mode 100644
index 000000000000..b9edd734b855
--- /dev/null
+++ b/Documentation/tutorial/flashing_firmware/hp_spi_header_mb.jpg