mb/supermicro/x11-lga1151-series: add x11ssm-f board

This adds another x11 series board, the X11SSM-F, which is similiar to
X11SSH-TF but differs in PCIe interfaces/devices, GPIO settings and
Ethernet interfaces.

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

2 files changed, 95 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
index 8c99527319..3ba4c3f3fa 100644
--- a/Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md
+++ b/Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md
@@ -7,6 +7,7 @@ Controller etc.
 ## Supported boards
 
 - [X11SSH-TF](x11ssh-tf/x11ssh-tf.md)
+- [X11SSM-F](x11ssh-tf/x11ssm-f.md)
 
 ## Required proprietary blobs
 
@@ -30,6 +31,7 @@ Look at the [flashing tutorial] and the board-specific section.
 These issues apply to all boards. Have a look at the board-specific issues, too.
 
 - TianoCore doesn't work with Aspeed NGI, as it's text mode only (Fix is WIP CB:35726)
+- MRC caching does not work with cold boot
 
 ## ToDo
 
diff --git a/Documentation/mainboard/supermicro/x11-lga1151-series/x11ssm-f/x11ssm-f.md b/Documentation/mainboard/supermicro/x11-lga1151-series/x11ssm-f/x11ssm-f.md
new file mode 100644
index 0000000000..5213bce6de
--- /dev/null
+++ b/Documentation/mainboard/supermicro/x11-lga1151-series/x11ssm-f/x11ssm-f.md
@@ -0,0 +1,93 @@
+# Supermicro X11SSM-F
+
+This section details how to run coreboot on the [Supermicro X11SSM-F].
+
+## Flashing coreboot
+
+The board can be flashed externally. FTDI FT2232H and FT232H based programmers worked.
+
+The flash IC [MX25L12873F] can be found near PCH PCIe Slot 4. It is socketed on retail boards.
+
+For doing ISP (In-System-Programming) one needs to add a diode between VCC and the flash chip.
+
+## BMC (IPMI)
+
+This board has an ASPEED [AST2400], which has BMC/[IPMI] functionality. The BMC firmware resides in a
+32 MiB SOIC-16 chip in the corner of the mainboard near the PCH PCIe Slot 4. This chip is a
+[MX25L25635F].
+
+## Tested and working
+
+- GRUB2 payload with Debian testing and kernel 5.2
+- ECC ram (Linux' ie31200 driver works)
+- USB ports
+- Ethernet
+- SATA ports
+- RS232 external
+- PCIe slots
+- BMC (IPMI)
+- VGA on Aspeed
+- TPM on TPM expansion header
+
+## Known issues
+
+- See general issue section
+- "only partially covers this bridge" info from Linux kernel (what does that mean?)
+- LNXTHERM missing
+- S3 resume not working
+
+## ToDo
+
+- Fix TODOs mentioned in code
+
+## Technology
+
+```eval_rst
++------------------+--------------------------------------------------+
+| CPU              | Intel Kaby Lake                                  |
++------------------+--------------------------------------------------+
+| PCH              | Intel C236                                       |
++------------------+--------------------------------------------------+
+| Coprocessor      | Intel SPS (server version of the ME)             |
++------------------+--------------------------------------------------+
+| Super I/O        | ASPEED AST2400                                   |
++------------------+--------------------------------------------------+
+| Ethernet         | 2x Intel I210-AT 1 GbE                           |
+|                  | 1x dedicated BMC                                 |
++------------------+--------------------------------------------------+
+| PCIe slots       | 1x 3.0 x8                                        |
+|                  | 1x 3.0 x8 (in x16)                               |
+|                  | 2x 3.0 x4 (in x8)                                |
++------------------+--------------------------------------------------+
+| USB slots        | 2x USB 2.0 (ext)                                 |
+|                  | 2x USB 3.0 (ext)                                 |
+|                  | 1x USB 3.0 (int)                                 |
+|                  | 1x dual USB 3.0 header                           |
+|                  | 2x dual USB 2.0 header                           |
++------------------+--------------------------------------------------+
+| SATA slots       | 8x S-ATA III                                     |
++------------------+--------------------------------------------------+
+| Other slots      | 1x RS232 (ext)                                   |
+|                  | 1x RS232 header                                  |
+|                  | 1x TPM header                                    |
+|                  | 1x Power SMB header                              |
+|                  | 5x PWM Fan connector                             |
+|                  | 2x I-SGPIO                                       |
+|                  | 2x S-ATA DOM Power connector                     |
+|                  | 1x XDP Port                                      |
+|                  | 1x External BMC I2C Header (for IPMI card)       |
+|                  | 1x Chassis Intrusion Header                      |
++------------------+--------------------------------------------------+
+```
+
+## Extra links
+
+- [Supermicro X11SSM-F]
+- [Board manual]
+
+[Supermicro X11SSM-F]: https://www.supermicro.com/en/products/motherboard/X11SSM-F
+[Board manual]: https://www.supermicro.com/manuals/motherboard/C236/MNL-1785.pdf
+[AST2400]: https://www.aspeedtech.com/products.php?fPath=20&rId=376
+[IPMI]: ../../../../drivers/ipmi_kcs.md
+[MX25L25635F]: https://media.digikey.com/pdf/Data%20Sheets/Macronix/MX25L25635F.pdf
+[MX25L12873F]: https://media.digikey.com/pdf/Data%20Sheets/Macronix/MX25L12873F.pdf