Files
system76-coreboot/Documentation/superio/nuvoton/npcd378.md
Nicholas Chin cf2bf984f0 Docs: Fix broken header references
MyST Parser automatically generates label "slugs" for headers which
should be used to reference them from links [1]. These labels are in
"slug-case", i.e. the original header text in lower case separated by
dashes, with punctuation removed. This fixes a few "cross-reference
target not found" warnings.

[1] https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#anchor-slug-structure

Change-Id: Ia6970d03b961bde6d7cd0fa3297f8d84b75d3b34
Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/83976
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
2024-08-21 16:18:23 +00:00

3.5 KiB

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 inaccurate or wrong.

LDNs

+-------+---------------------------+
| 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 for more details.

HWM

Register

The registers are accessible via IO space and are located at LDN8's IOBASE.

+---------------+-----------------------+
| 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

+---------------+-----------------------+
| 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.