0001 Kernel driver abituguru3
0002 ========================
0003
0004 Supported chips:
0005 * Abit uGuru revision 3 (Hardware Monitor part, reading only)
0006
0007 Prefix: 'abituguru3'
0008
0009 Addresses scanned: ISA 0x0E0
0010
0011 Datasheet: Not available, this driver is based on reverse engineering.
0012
0013 Note:
0014 The uGuru is a microcontroller with onboard firmware which programs
0015 it to behave as a hwmon IC. There are many different revisions of the
0016 firmware and thus effectively many different revisions of the uGuru.
0017 Below is an incomplete list with which revisions are used for which
0018 Motherboards:
0019
0020 - uGuru 1.00 ~ 1.24 (AI7, KV8-MAX3, AN7)
0021 - uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
0022 - uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
0023 - uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
0024 - uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
0025 AW9D-MAX)
0026
0027 The abituguru3 driver is only for revision 3.0.x.x motherboards,
0028 this driver will not work on older motherboards. For older
0029 motherboards use the abituguru (without the 3 !) driver.
0030
0031 Authors:
0032 - Hans de Goede <j.w.r.degoede@hhs.nl>,
0033 - (Initial reverse engineering done by Louis Kruger)
0034
0035
0036 Module Parameters
0037 -----------------
0038
0039 * force: bool
0040 Force detection. Note this parameter only causes the
0041 detection to be skipped, and thus the insmod to
0042 succeed. If the uGuru can't be read the actual hwmon
0043 driver will not load and thus no hwmon device will get
0044 registered.
0045 * verbose: bool
0046 Should the driver be verbose?
0047
0048 * 0/off/false normal output
0049 * 1/on/true + verbose error reporting (default)
0050
0051 Default: 1 (the driver is still in the testing phase)
0052
0053 Description
0054 -----------
0055
0056 This driver supports the hardware monitoring features of the third revision of
0057 the Abit uGuru chip, found on recent Abit uGuru featuring motherboards.
0058
0059 The 3rd revision of the uGuru chip in reality is a Winbond W83L951G.
0060 Unfortunately this doesn't help since the W83L951G is a generic microcontroller
0061 with a custom Abit application running on it.
0062
0063 Despite Abit not releasing any information regarding the uGuru revision 3,
0064 Louis Kruger has managed to reverse engineer the sensor part of the uGuru.
0065 Without his work this driver would not have been possible.
0066
0067 Known Issues
0068 ------------
0069
0070 The voltage and frequency control parts of the Abit uGuru are not supported,
0071 neither is writing any of the sensor settings and writing / reading the
0072 fanspeed control registers (FanEQ)
0073
0074 If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
0075 include the output of: `dmesg | grep abituguru`
