mb/hp/snb_ivb_laptops: Add HP EliteBook 2170p as 2570p variant

Most of the code is taken from 2570p, adjusted with autoport, SuperIO
from 8470p and inteltool, GPIO config from inteltool via autoport.

The laptop works well under coreboot with SeaBIOS 1.16.1 payload,
running Debian GNU/Linux with kernel 6.1.15.

Signed-off-by: Bill XIE <persmule@hardenedlinux.org>
Change-Id: I854104516d5b6fbd78ee2989197000a7dbb85136
Reviewed-on: https://review.coreboot.org/c/coreboot/+/73856
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>

3 files changed, 92 insertions, 0 deletions

diff --git a/Documentation/mainboard/hp/2170p.md b/Documentation/mainboard/hp/2170p.md
new file mode 100644
index 000000000000..5f67c38b1182
--- /dev/null
+++ b/Documentation/mainboard/hp/2170p.md
@@ -0,0 +1,91 @@
+# HP EliteBook 2170p
+
+This page is about the notebook [HP EliteBook 2170p].
+
+## Release status
+
+HP EliteBook 2170p was released in 2012 and is now end of life.
+It can be bought from a secondhand market like Taobao or eBay.
+
+## Required proprietary blobs
+
+The following blobs are required to operate the hardware:
+1. EC firmware
+2. Intel ME firmware
+
+EC firmware can be retrieved from the HP firmware update image, or the firmware
+backup of the laptop. EC Firmware is part of the coreboot build process.
+The guide on extracting EC firmware and using it to build coreboot is in
+document [HP Laptops with KBC1126 Embedded Controller](hp_kbc1126_laptops).
+
+Intel ME firmware is in the flash chip. It is not needed when building coreboot.
+
+## Programming
+
+The flash chip is located between the memory slots, WWAN card and CPU,
+covered by the base enclosure, which needs to be removed according to
+the [Maintenance and Service Guide] to access the flash chip. Unlike
+other variants, the flash chip on 2170p is socketed, so it can be taken
+off and operated with an external programmer.
+
+Pin 1 of the flash chip is at the side near the CPU.
+
+![Flash Chip in 2170p](2170p_flash.jpg)
+
+For more details have a look at the general [flashing tutorial].
+
+## Debugging
+
+The board can be debugged with serial port on the dock or EHCI debug.
+The EHCI debug port is the left USB3 port.
+
+## Test status
+
+### Known issues
+
+- GRUB payload freezes if at_keyboard module is in the GRUB image
+  ([bug #141])
+
+### Untested
+
+- Fingerprint Reader
+- Dock: Parallel port, PS/2 mouse, S-Video port
+
+### Working
+
+- Integrated graphics init with libgfxinit
+- SATA
+- Audio: speaker and microphone
+- Ethernet
+- WLAN
+- WWAN
+- Bluetooth
+- SD Card Reader
+- SmartCard Reader
+- USB
+- DisplayPort
+- Keyboard, touchpad and trackpoint
+- EC ACPI support and thermal control
+- Dock: all USB ports, DVI-D, Serial debug, PS/2 keyboard
+- TPM
+- Internal flashing when IFD is unlocked
+- Using `me_cleaner`
+
+
+## Technology
+
+```eval_rst
++------------------+--------------------------------------------------+
+| CPU              | Intel Sandy/Ivy Bridge (FCPGA988)                |
++------------------+--------------------------------------------------+
+| PCH              | Intel Panther Point QM77                         |
++------------------+--------------------------------------------------+
+| EC               | SMSC KBC1126                                     |
++------------------+--------------------------------------------------+
+| Coprocessor      | Intel Management Engine                          |
++------------------+--------------------------------------------------+
+```
+
+[HP EliteBook 2170p]: https://support.hp.com/us-en/product/hp-elitebook-2170p-notebook-pc/5245427
+[Maintenance and Service Guide]: http://h10032.www1.hp.com/ctg/Manual/c03387961.pdf
+[flashing tutorial]: ../../tutorial/flashing_firmware/ext_power.md
diff --git a/Documentation/mainboard/hp/2170p_flash.jpg b/Documentation/mainboard/hp/2170p_flash.jpg
new file mode 100644
index 000000000000..16cef8adc3e5
--- /dev/null
+++ b/Documentation/mainboard/hp/2170p_flash.jpg
diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md
index 9a2660a8cb3d..eac31ccb125a 100644
--- a/Documentation/mainboard/index.md
+++ b/Documentation/mainboard/index.md
@@ -78,6 +78,7 @@ The boards in this section are not real mainboards, but emulators.
 
 - [HP Laptops with KBC1126 EC](hp/hp_kbc1126_laptops.md)
 - [HP Sure Start](hp/hp_sure_start.md)
+- [EliteBook 2170p](hp/2170p.md)
 - [EliteBook 2560p](hp/2560p.md)
 - [EliteBook 8760w](hp/8760w.md)
 - [EliteBook Folio 9480m](hp/folio_9480m.md)