From f30d11ccd712a7e06803dfe6224eb468de054de7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Zieli=C5=84ski?= <michal.zielinski@posteo.net>
Date: Thu, 17 Oct 2024 20:48:50 +0200
Subject: mb/hp: Add HP Compaq 8300 Elite SFF
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add initial board commit based on HP 8200 SFF and HP Z220 SFF.
* Add documentation.

Tested on HP 8300 SFF.

Change-Id: Ib5322acc0210f000b53954e2925549358f86d5c8
Signed-off-by: Michał Zieliński <michal.zielinski@posteo.net>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/67666
Reviewed-by: Felix Singer <service+coreboot-gerrit@felixsinger.de>
Reviewed-by: David Hendricks <david.hendricks@gmail.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Alicja Michalska <ahplka19@gmail.com>
---
 Documentation/mainboard/hp/compaq_8300_sff.md | 73 +++++++++++++++++++++++++++
 Documentation/mainboard/index.md              |  1 +
 2 files changed, 74 insertions(+)
 create mode 100644 Documentation/mainboard/hp/compaq_8300_sff.md

(limited to 'Documentation/mainboard')

diff --git a/Documentation/mainboard/hp/compaq_8300_sff.md b/Documentation/mainboard/hp/compaq_8300_sff.md
new file mode 100644
index 0000000000..03ee88c2f1
--- /dev/null
+++ b/Documentation/mainboard/hp/compaq_8300_sff.md
@@ -0,0 +1,73 @@
+# HP Compaq 8300 Elite SFF
+
+This page describes how to run coreboot on the [Compaq 8300 Elite SFF] desktop
+from [HP].
+
+## TODO
+
+The following things are still missing from this coreboot port:
+
+- Extended HWM reporting
+- Advanced LED control
+- Advanced power configuration in S3
+
+## Flashing coreboot
+
+```{eval-rst}
++---------------------+------------+
+| Type                | Value      |
++=====================+============+
+| Socketed flash      | no         |
++---------------------+------------+
+| Model               | MT25QL128  |
++---------------------+------------+
+| Size                | 16 MiB     |
++---------------------+------------+
+| In circuit flashing | yes        |
++---------------------+------------+
+| Package             | SOIC-16    |
++---------------------+------------+
+| Write protection    | Yes        |
++---------------------+------------+
+| Dual BIOS feature   | No         |
++---------------------+------------+
+| Internal flashing   | yes        |
++---------------------+------------+
+```
+
+### Internal programming
+
+Internal flashing is possible. The SPI flash can be accessed using [flashrom],
+but you have to short the FDO pins located near the rear USB3 ports on the
+motherboard using a jumper, to temporarily disable write protections while on the
+stock firmware. Once the coreboot rom is flashed, one should remove the jumper.
+
+### External programming
+
+External programming with an SPI adapter and [flashrom] does work, but it powers the
+whole southbridge complex. You need to supply enough current through the programming adapter.
+
+If you want to use a SOIC pomona test clip, you have to cut the 2nd DRAM DIMM holder,
+as otherwise there's not enough space near the flash.
+
+## Technology
+
+```{eval-rst}
++------------------+--------------------------------------------------+
+| Northbridge      | :doc:`../../northbridge/intel/sandybridge/index` |
++------------------+--------------------------------------------------+
+| Southbridge      | bd82x6x                                          |
++------------------+--------------------------------------------------+
+| CPU              | model_206ax                                      |
++------------------+--------------------------------------------------+
+| SuperIO          | :doc:`../../superio/nuvoton/npcd378`             |
++------------------+--------------------------------------------------+
+| EC               |                                                  |
++------------------+--------------------------------------------------+
+| Coprocessor      | Intel ME                                         |
++------------------+--------------------------------------------------+
+```
+
+[Compaq 8300 Elite SFF]: https://support.hp.com/us-en/document/c03345460
+[HP]: https://www.hp.com/
+[flashrom]: https://flashrom.org/Flashrom
diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md
index ce51f4eda9..1bbacaf328 100644
--- a/Documentation/mainboard/index.md
+++ b/Documentation/mainboard/index.md
@@ -129,6 +129,7 @@ GA-H61M-S2PV <gigabyte/ga-h61m-s2pv.md>
 :maxdepth: 1
 
 Compaq 8200 Elite SFF <hp/compaq_8200_sff.md>
+Compaq 8300 Elite SFF <hp/compaq_8300_sff.md>
 Compaq Elite 8300 USDT <hp/compaq_8300_usdt.md>
 Pro 3500 Series <hp/pro_3500_series.md>
 Z220 Workstation SFF <hp/z220_sff.md>
-- 
cgit v1.2.3