17ebd8b66SMauro Carvalho ChehabKernel driver nct6683
27ebd8b66SMauro Carvalho Chehab=====================
37ebd8b66SMauro Carvalho Chehab
47ebd8b66SMauro Carvalho ChehabSupported chips:
57ebd8b66SMauro Carvalho Chehab
6daf4feddSDavid Bartley  * Nuvoton NCT6683D/NCT6687D
77ebd8b66SMauro Carvalho Chehab
87ebd8b66SMauro Carvalho Chehab    Prefix: 'nct6683'
97ebd8b66SMauro Carvalho Chehab
107ebd8b66SMauro Carvalho Chehab    Addresses scanned: ISA address retrieved from Super I/O registers
117ebd8b66SMauro Carvalho Chehab
127ebd8b66SMauro Carvalho Chehab    Datasheet: Available from Nuvoton upon request
137ebd8b66SMauro Carvalho Chehab
147ebd8b66SMauro Carvalho ChehabAuthors:
157ebd8b66SMauro Carvalho Chehab
167ebd8b66SMauro Carvalho Chehab	Guenter Roeck <linux@roeck-us.net>
177ebd8b66SMauro Carvalho Chehab
187ebd8b66SMauro Carvalho ChehabDescription
197ebd8b66SMauro Carvalho Chehab-----------
207ebd8b66SMauro Carvalho Chehab
217ebd8b66SMauro Carvalho ChehabThis driver implements support for the Nuvoton NCT6683D eSIO chip.
227ebd8b66SMauro Carvalho Chehab
237ebd8b66SMauro Carvalho ChehabThe chips implement up to shared 32 temperature and voltage sensors.
247ebd8b66SMauro Carvalho ChehabIt supports up to 16 fan rotation sensors and up to 8 fan control engines.
257ebd8b66SMauro Carvalho Chehab
267ebd8b66SMauro Carvalho ChehabTemperatures are measured in degrees Celsius. Measurement resolution is
277ebd8b66SMauro Carvalho Chehab0.5 degrees C.
287ebd8b66SMauro Carvalho Chehab
297ebd8b66SMauro Carvalho ChehabVoltage sensors (also known as IN sensors) report their values in millivolts.
307ebd8b66SMauro Carvalho Chehab
317ebd8b66SMauro Carvalho ChehabFan rotation speeds are reported in RPM (rotations per minute).
327ebd8b66SMauro Carvalho Chehab
337ebd8b66SMauro Carvalho ChehabUsage Note
347ebd8b66SMauro Carvalho Chehab----------
357ebd8b66SMauro Carvalho Chehab
367ebd8b66SMauro Carvalho ChehabLimit register locations on Intel boards with EC firmware version 1.0
377ebd8b66SMauro Carvalho Chehabbuild date 04/03/13 do not match the register locations in the Nuvoton
387ebd8b66SMauro Carvalho Chehabdatasheet. Nuvoton confirms that Intel uses a special firmware version
397ebd8b66SMauro Carvalho Chehabwith different register addresses. The specification describing the Intel
407ebd8b66SMauro Carvalho Chehabfirmware is held under NDA by Nuvoton and Intel and not available
417ebd8b66SMauro Carvalho Chehabto the public.
427ebd8b66SMauro Carvalho Chehab
437ebd8b66SMauro Carvalho ChehabSome of the register locations can be reverse engineered; others are too
447ebd8b66SMauro Carvalho Chehabwell hidden. Given this, writing any values from the operating system is
457ebd8b66SMauro Carvalho Chehabconsidered too risky with this firmware and has been disabled. All limits
467ebd8b66SMauro Carvalho Chehabmust all be written from the BIOS.
477ebd8b66SMauro Carvalho Chehab
487ebd8b66SMauro Carvalho ChehabThe driver has only been tested with the Intel firmware, and by default
497ebd8b66SMauro Carvalho Chehabonly instantiates on Intel boards. To enable it on non-Intel boards,
507ebd8b66SMauro Carvalho Chehabset the 'force' module parameter to 1.
517ebd8b66SMauro Carvalho Chehab
527ebd8b66SMauro Carvalho ChehabTested Boards and Firmware Versions
537ebd8b66SMauro Carvalho Chehab-----------------------------------
547ebd8b66SMauro Carvalho Chehab
557ebd8b66SMauro Carvalho ChehabThe driver has been reported to work with the following boards and
567ebd8b66SMauro Carvalho Chehabfirmware versions.
577ebd8b66SMauro Carvalho Chehab
587ebd8b66SMauro Carvalho Chehab=============== ===============================================
597ebd8b66SMauro Carvalho ChehabBoard		Firmware version
607ebd8b66SMauro Carvalho Chehab=============== ===============================================
617ebd8b66SMauro Carvalho ChehabIntel DH87RL	NCT6683D EC firmware version 1.0 build 04/03/13
627ebd8b66SMauro Carvalho ChehabIntel DH87MC	NCT6683D EC firmware version 1.0 build 04/03/13
637ebd8b66SMauro Carvalho ChehabIntel DB85FL	NCT6683D EC firmware version 1.0 build 04/03/13
64*bd433537SBlaž HrastnikASRock X570	NCT6683D EC firmware version 1.0 build 06/28/19
65daf4feddSDavid BartleyMSI B550	NCT6687D EC firmware version 1.0 build 05/07/20
667ebd8b66SMauro Carvalho Chehab=============== ===============================================
67