^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver nct6683
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) =====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Nuvoton NCT6683D
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefix: 'nct6683'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Datasheet: Available from Nuvoton upon request
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Authors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) This driver implements support for the Nuvoton NCT6683D eSIO chip.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) The chips implement up to shared 32 temperature and voltage sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) It supports up to 16 fan rotation sensors and up to 8 fan control engines.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Temperatures are measured in degrees Celsius. Measurement resolution is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 0.5 degrees C.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Voltage sensors (also known as IN sensors) report their values in millivolts.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Fan rotation speeds are reported in RPM (rotations per minute).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Usage Note
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) ----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Limit register locations on Intel boards with EC firmware version 1.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) build date 04/03/13 do not match the register locations in the Nuvoton
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) datasheet. Nuvoton confirms that Intel uses a special firmware version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) with different register addresses. The specification describing the Intel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) firmware is held under NDA by Nuvoton and Intel and not available
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) to the public.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Some of the register locations can be reverse engineered; others are too
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) well hidden. Given this, writing any values from the operating system is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) considered too risky with this firmware and has been disabled. All limits
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) must all be written from the BIOS.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) The driver has only been tested with the Intel firmware, and by default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) only instantiates on Intel boards. To enable it on non-Intel boards,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) set the 'force' module parameter to 1.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Tested Boards and Firmware Versions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) -----------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) The driver has been reported to work with the following boards and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) firmware versions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) =============== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Board Firmware version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) =============== ===============================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Intel DH87RL NCT6683D EC firmware version 1.0 build 04/03/13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) Intel DH87MC NCT6683D EC firmware version 1.0 build 04/03/13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) Intel DB85FL NCT6683D EC firmware version 1.0 build 04/03/13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) =============== ===============================================