mb/supermicro/x11-lga1151-series: rework documentation

This splits the x11-lga1151-series' documentation into a generic and a
board specific section as a preparation for CB:35427.

Additionally this adds some more information on the x11ssh board.

Signed-off-by: Michael Niewöhner <foss@mniewoehner.de>
Change-Id: I40ddd0b5cce0b1a3306eae22fc0a0bc6b2a6263c
Reviewed-on: https://review.coreboot.org/c/coreboot/+/35547
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Patrick Rudolph <siro@das-labor.org>

1 files changed, 61 insertions, 0 deletions

diff --git a/Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md b/Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md
new file mode 100644
index 0000000000..6a613e77d1
--- /dev/null
+++ b/Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md
@@ -0,0 +1,61 @@
+# X11 LGA1151 series
+
+The [Supermicro X11 LGA1151 series] are mostly the same boards with some minor differences in
+internal and external interfaces like available PCIe slots, NICs (1 GbE, 10 GbE), IPMI, RAID
+Controller etc.
+
+## Supported boards
+
+- [X11SSH-TF](x11ssh-tf/x11ssh-tf.md)
+
+## Required proprietary blobs
+
+- [Intel FSP2.0]
+- Intel ME
+
+## De-blobbing
+
+- [Intel FSP2.0] can not be removed as long as there is no free replacement
+- Intel ME can be cleaned using me_cleaner (~4.5 MB more free space)
+- Intel Ethernet Controller Firmware can be removed when it's extended functionality is not
+  needed. For more details refer to the respective datasheet (e.g 333016-008 for I210).
+- Boards with [AST2400] BMC/IPMI: Firmware can be replaced by [OpenBMC]
+
+## Flashing coreboot
+
+Look at the [flashing tutorial] and the board-specific section.
+
+## Known issues
+
+These issues apply to all boards. Have a look at the board-specific issues, too.
+
+- Intel SGX causes secondary APs to crash (disabled for now) when HT is enabled (Fix is WIP CB:35312)
+- TianoCore doesn't work with Aspeed NGI, as it's text mode only (Fix is WIP CB:35726)
+
+## ToDo
+
+- Fix issues above
+- Fix issues in board specific sections
+- Fix TODOs mentioned in code
+- Add more boards! :-)
+
+## Technology
+
+```eval_rst
++------------------+--------------------------------------------------+
+| CPU              | Intel Kaby Lake                                  |
++------------------+--------------------------------------------------+
+| PCH              | Intel C232/C236                                  |
++------------------+--------------------------------------------------+
+| Coprocessor      | Intel SPS (server version of the ME)             |
++------------------+--------------------------------------------------+
+```
+
+## Extra links
+
+[Supermicro X11 LGA1151 series]: https://www.supermicro.com/products/motherboard/Xeon3000/#1151
+[OpenBMC]: https://www.openbmc.org/
+[flashrom]: https://flashrom.org/Flashrom
+[flashing tutorial]: ../../../../flash_tutorial/ext_power.md
+[Intel FSP2.0]: ../../../../soc/intel/fsp/index.md
+[AST2400]: https://www.aspeedtech.com/products.php?fPath=20&rId=376