[coreboot-gerrit] Change in coreboot[master]: Documentation: Add HP Compaq 8200 and NPCD378
Patrick Rudolph (Code Review)
gerrit at coreboot.org
Fri May 25 13:42:27 CEST 2018
Patrick Rudolph has uploaded this change for review. ( https://review.coreboot.org/26543
Change subject: Documentation: Add HP Compaq 8200 and NPCD378
......................................................................
Documentation: Add HP Compaq 8200 and NPCD378
Change-Id: I56db0cc11cfa5a1a537091553393542312d4f212
Signed-off-by: Patrick Rudolph <patrick.rudolph at 9elements.com>
---
M Documentation/index.md
A Documentation/mainboard/hp/compaq_8200_sff.md
A Documentation/mainboard/hp/compaq_8200_sff_flash1.jpg
A Documentation/mainboard/hp/compaq_8200_sff_flash2.jpg
M Documentation/mainboard/index.md
A Documentation/superio/index.md
A Documentation/superio/nuvoton/npcd378.md
7 files changed, 295 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/43/26543/1
diff --git a/Documentation/index.md b/Documentation/index.md
index 69fb7f5..a3cda52 100644
--- a/Documentation/index.md
+++ b/Documentation/index.md
@@ -20,3 +20,4 @@
* [Native Graphics Initialization with libgfxinit](gfx/libgfxinit.md)
* [Sandy Bridge Raminit](Intel/NativeRaminit/Sandybridge.md)
* [Mainboard-specific documentation](mainboard/index.md)
+* [SuperIO-specific documentation](superio/index.md)
diff --git a/Documentation/mainboard/hp/compaq_8200_sff.md b/Documentation/mainboard/hp/compaq_8200_sff.md
new file mode 100644
index 0000000..6052920
--- /dev/null
+++ b/Documentation/mainboard/hp/compaq_8200_sff.md
@@ -0,0 +1,158 @@
+# HP Compaq 8200 Elite SFF
+
+This page describes how to run coreboot on the [Compaq 8200 Elite SFF] desktop
+from [HP].
+
+## TODO
+
+The following things are still missing from this coreboot port:
+
+- Extended HWM reporting
+- Advanced LED control
+- Powerconfiguration in S3
+
+## Configuration
+
+Run `make menuconfig` and select _HP_/_Compaq 8200 Elite SFF_ in the _Mainboard_
+menu.
+
+## Flashing coreboot
+
+The Compaq 8200 Elite SFF has an 8 MiB SPI flash, that can be programmed from within
+Linux running on the board, or directly with an SPI programmer.
+
+### Internal programming
+
+The SPI flash can be accessed using [flashrom].
+
+### 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.
+
+**Position of SOIC-8 flash IC near 2nd DIMM holder**
+![][compaq_8200_flash1]
+
+[compaq_8200_flash1]: compaq_8200_sff_flash1.jpg
+
+**Closeup view of SOIC-8 flash IC**
+![][compaq_8200_flash2]
+
+[compaq_8200_flash2]: compaq_8200_sff_flash2.jpg
+
+## Technology
+
+```eval_rst
++------------------+--------------------------------------+
+| Northbridge | sandybridge |
++------------------+--------------------------------------+
+| Southbridge | bd82x6x |
++------------------+--------------------------------------+
+| CPU | model_206ax |
++------------------+--------------------------------------+
+| SuperIO | :doc:`../../superio/nuvoton/npcd378` |
++------------------+--------------------------------------+
+| EC | |
++------------------+--------------------------------------+
+| Coprocessor | Intel ME |
++------------------+--------------------------------------+
+```
+
+## Mainboard components
+
+### Vendor
+
+Intel
+
+### CPU
+
+```eval_rst
++---------------------+-----------------------------------+
+| Type | Value |
++=====================+===================================+
+| Socketed CPU | Yes |
++---------------------+-----------------------------------+
+| Model | Core i Series 2nd/3rd Generation |
++---------------------+-----------------------------------+
+```
+
+### DRAM
+
+```eval_rst
++-------------------------------+------------+
+| Type | Value |
++===============================+============+
+| Number of DRAM DIMMs | 4 |
++-------------------------------+------------+
+| Max supported DDR speed (Mhz) | 800 |
++-------------------------------+------------+
+```
+
+### Flash
+
+```eval_rst
++---------------------+------------+
+| Type | Value |
++=====================+============+
+| Socketed flash | no |
++---------------------+------------+
+| Model | MX25L6406E |
++---------------------+------------+
+| Size | 8 MiB |
++---------------------+------------+
+| In circuit flashing | yes |
++---------------------+------------+
+| Internal flashing | yes |
++---------------------+------------+
+```
+
+### Internal slots
+
+```eval_rst
++----------------+--------+
+| Type | Count |
++================+========+
+| PCIe x16 Gen3 | 1 |
++----------------+--------+
+| PCIe x4 Gen2 | 1 |
++----------------+--------+
+| PCI | 1 |
++----------------+--------+
+| SATA Gen3 | 4 |
++----------------+--------+
+```
+
+### Ports
+
+```eval_rst
++------------------+--------+
+| Type | Count |
++==================+========+
+| PS/2 | 2 |
++------------------+--------+
+| DSUB-9 serial | 1 |
++------------------+--------+
+| DSUB-25 LPT | 1 |
++------------------+--------+
+| VGA | 1 |
++------------------+--------+
+| Displayport | 1 |
++------------------+--------+
+| Audio | 3 |
++------------------+--------+
+| USB Gen2 | 10 |
++------------------+--------+
+| Gigabit Ethernet | 1 |
++------------------+--------+
+```
+
+```eval_rst
+:doc:`../../superio/nuvoton/npcd378`
+```
+
+[Compaq 8200 Elite SFF]: https://support.hp.com/us-en/document/c03414707
+[HP]: https://www.hp.com/
+[flashrom]: https://flashrom.org/Flashrom
diff --git a/Documentation/mainboard/hp/compaq_8200_sff_flash1.jpg b/Documentation/mainboard/hp/compaq_8200_sff_flash1.jpg
new file mode 100644
index 0000000..67aeedf
--- /dev/null
+++ b/Documentation/mainboard/hp/compaq_8200_sff_flash1.jpg
Binary files differ
diff --git a/Documentation/mainboard/hp/compaq_8200_sff_flash2.jpg b/Documentation/mainboard/hp/compaq_8200_sff_flash2.jpg
new file mode 100644
index 0000000..c406d98
--- /dev/null
+++ b/Documentation/mainboard/hp/compaq_8200_sff_flash2.jpg
Binary files differ
diff --git a/Documentation/mainboard/index.md b/Documentation/mainboard/index.md
index b62ad67..23e1ed2 100644
--- a/Documentation/mainboard/index.md
+++ b/Documentation/mainboard/index.md
@@ -5,3 +5,7 @@
## SiFive
- [SiFive HiFive Unleashed](sifive/hifive-unleashed.md)
+
+## HP
+
+- [Compaq 8200 Elite SFF](hp/compaq_8200_sff.md)
diff --git a/Documentation/superio/index.md b/Documentation/superio/index.md
new file mode 100644
index 0000000..eef4d57
--- /dev/null
+++ b/Documentation/superio/index.md
@@ -0,0 +1,7 @@
+# SuperIO-specific documentation
+
+This section contains documentation about coreboot on specific SuperIOs.
+
+## Nuvoton
+
+- [NPCD378](nuvoton/npcd378.md)
diff --git a/Documentation/superio/nuvoton/npcd378.md b/Documentation/superio/nuvoton/npcd378.md
new file mode 100644
index 0000000..54023d9
--- /dev/null
+++ b/Documentation/superio/nuvoton/npcd378.md
@@ -0,0 +1,125 @@
+# NPCD378
+
+This page describes the [Nuvoton] SuperIO chip that can be found on various [HP]
+mainboards.
+
+As no Datasheet is available most of the functions have been reverse engineered and
+might be inacurate or wrong.
+
+## LDNs
+
+```eval_rst
++-------+---------------------------+
+| LDN # | Function |
++=======+===========================+
+| 0 | FDC |
++-------+---------------------------+
+| 1 | Parallel Port |
++-------+---------------------------+
+| 2 | Com1 |
++-------+---------------------------+
+| 3 | Com2 / IR |
++-------+---------------------------+
+| 4 | LED and PWR button CTRL |
++-------+---------------------------+
+| 5 | PS/2 AUX |
++-------+---------------------------+
+| 6 | PS/2 KB |
++-------+---------------------------+
+| 7 | WDT1 |
++-------+---------------------------+
+| 8 | HWM |
++-------+---------------------------+
+| 0xf | GPIO |
++-------+---------------------------+
+| 0x15 | I2C ? |
++-------+---------------------------+
+| 0x1e | SUSPEND CTL ? |
++-------+---------------------------+
+| 0x1c | GPIO ? |
++-------+---------------------------+
+```
+
+### LDN0
+
+Follows [Nuvoton]'s default FDC register set. See [NCT6102D] for more details.
+
+### LDN1
+
+Follows [Nuvoton]'s default LPT register set. See [NCT6102D] for more details.
+
+### LDN2
+
+Follows [Nuvoton]'s default COM1 register set. See [NCT6102D] for more details.
+
+### LDN3
+
+Follows [Nuvoton]'s default COM2 register set. See [NCT6102D] for more details.
+
+### LDN4
+
+On most SuperIOs the use of LDN4 is forbidden. That's not the case on NPCD378.
+
+It exposes 16 byte of IO config space to control the front LEDs PWM duty cycle
+and power button behaviour on normal / during S3 resume.
+
+### LDN5
+
+A custom PS/2 AUX port.
+
+### LDN6
+
+Follows [Nuvoton]'s default KBC register set. See [NCT6102D] for more details.
+
+### LDN7
+
+Looks like a WDT.
+
+### LDN8
+
+Custom HWM space. It exposes 256 byte of IO config space.
+See [HWM](#HWM) for more details.
+
+## HWM
+
+### Register
+
+The registers are accessible via IO space and are located at LDN8's IOBASE.
+
+```eval_rst
++---------------+-----------------------+
+| IOBASE offset | Register |
++---------------+-----------------------+
+| 0x4 | Host Write CTRL |
++---------------+-----------------------+
+| 0x10 - 0xfe | HWM Page # |
++---------------+-----------------------+
+| 0xff | Page index select |
++---------------+-----------------------+
+```
+
+### Host Write CTRL
+Bit 0 must be cleared prior to writing any of the HWM register and it must be
+set after writing to HWM register to signal the SuperIO that data has changed.
+Reading register is possible at any time and doesn't need special locking.
+
+### HWM Page
+The SuperIO exposes 16 different pages. Nearly all registers are unknown.
+
+**Page 1**
+
+```eval_rst
++---------------+-----------------------+
+| IOBASE offset | Register |
++---------------+-----------------------+
+| 0x98 | PSU fan PWM |
++---------------+-----------------------+
+```
+
+### Page index
+The 4 LSB of the page index register selects which HWM page is active.
+A write takes effect immediately.
+
+[NCT6102D]: https://www.nuvoton.com/resource-files/NCT6102D_NCT6106D_Datasheet_V1_0.pdf
+[Nuvoton]: http://www.nuvoton.com/hq/
+[HP]: https://www.hp.com/
--
To view, visit https://review.coreboot.org/26543
To unsubscribe, or for help writing mail filters, visit https://review.coreboot.org/settings
Gerrit-Project: coreboot
Gerrit-Branch: master
Gerrit-MessageType: newchange
Gerrit-Change-Id: I56db0cc11cfa5a1a537091553393542312d4f212
Gerrit-Change-Number: 26543
Gerrit-PatchSet: 1
Gerrit-Owner: Patrick Rudolph <patrick.rudolph at 9elements.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.coreboot.org/pipermail/coreboot-gerrit/attachments/20180525/2589c71c/attachment-0001.html>
More information about the coreboot-gerrit
mailing list