^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver w83627hf
^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) * Winbond W83627HF (ISA accesses ONLY)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Prefix: 'w83627hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) * Winbond W83627THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Prefix: 'w83627thf'
^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) * Winbond W83697HF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Prefix: 'w83697hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) * Winbond W83637HF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Prefix: 'w83637hf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * Winbond W83687THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Prefix: 'w83687thf'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Addresses scanned: ISA address retrieved from Super I/O registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Authors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Frodo Looijaard <frodol@dds.nl>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Philip Edelbrock <phil@netroedge.com>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Mark Studebaker <mdsxyz123@yahoo.com>,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Bernhard C. Schrenk <clemy@clemy.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Module Parameters
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * force_i2c: int
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Initialize the I2C address of the sensors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) * init: int
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) (default is 1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Use 'init=0' to bypass initializing the chip.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Try this if your computer crashes when you load the module.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) This driver implements support for ISA accesses *only* for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) the Winbond W83627HF, W83627THF, W83697HF and W83637HF Super I/O chips.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) We will refer to them collectively as Winbond chips.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) This driver supports ISA accesses, which should be more reliable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) than i2c accesses. Also, for Tyan boards which contain both a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Super I/O chip and a second i2c-only Winbond chip (often a W83782D),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) using this driver will avoid i2c address conflicts and complex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) initialization that were required in the w83781d driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) If you really want i2c accesses for these Super I/O chips,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) use the w83781d driver. However this is not the preferred method
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) now that this ISA driver has been developed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) VID reading. However the two chips have the identical 128 pin package. So,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) it is possible or even likely for a w83627thf to have the VID signals routed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) to these pins despite their not being labeled for that purpose. Therefore,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) the w83627thf driver interprets these as VID. If the VID on your board
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) doesn't work, first see doc/vid in the lm_sensors package[1]. If that still
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) doesn't help, you may just ignore the bogus VID reading with no harm done.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) For further information on this driver see the w83781d driver documentation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) [1] http://www.lm-sensors.org/browser/lm-sensors/trunk/doc/vid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Forcing the address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) -------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) The driver used to have a module parameter named force_addr, which could
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) be used to force the base I/O address of the hardware monitoring block.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) This was meant as a workaround for mainboards with a broken BIOS. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) module parameter is gone for technical reasons. If you need this feature,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) you can obtain the same result by using the isaset tool (part of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) lm-sensors) before loading the driver:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) # Enter the Super I/O config space::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) isaset -y -f 0x2e 0x87
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) isaset -y -f 0x2e 0x87
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) # Select the hwmon logical device::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) isaset -y 0x2e 0x2f 0x07 0x0b
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) # Set the base I/O address (to 0x290 in this example)::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) isaset -y 0x2e 0x2f 0x60 0x02
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) isaset -y 0x2e 0x2f 0x61 0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) # Exit the Super-I/O config space::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) isaset -y -f 0x2e 0xaa
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) 0x4e/0x4f is also possible.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) Voltage pin mapping
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) -------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Here is a summary of the voltage pin mapping for the W83627THF. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) can be useful to convert data provided by board manufacturers into
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) working libsensors configuration statements:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - W83627THF
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Pin Name Register Sysfs attribute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) 100 CPUVCORE 20h in0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) 99 VIN0 21h in1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 98 VIN1 22h in2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) 97 VIN2 24h in4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) 114 AVCC 23h in3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) 61 5VSB 50h (bank 5) in7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) 74 VBAT 51h (bank 5) in8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) ======== =============== =============== ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) For other supported devices, you'll have to take the hard path and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) look up the information in the datasheet yourself (and then add it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) to this document please.)