aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorHans de Goede <j.w.r.degoede@hhs.nl>2007-06-16 18:28:45 -0400
committerMark M. Hoffman <mhoffman@lightlink.com>2007-07-19 14:22:16 -0400
commit3faa1ffb4f4be7d10715f4b003ff7b27d14eae26 (patch)
tree30e61e56fbe0b4889aea672a615c8d17e6a8cf1a /Documentation
parentaba5073d3f4c928c89c483d85f8cff7cc9aa3312 (diff)
hwmon: Add support for newer uGuru's
This patch adds a new driver for the hardware monitoring features of the third revision of the Abit uGuru chip, found on recent Abit motherboards. This is an entirely different beast then the first and second revision (its again a winbond microcontroller, but the "protocol" to talk to it and the bank addresses are very different. Signed-off-by: Hans de Goede <j.w.r.degoede@hhs.nl> Signed-off-by: Mark M. Hoffman <mhoffman@lightlink.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/hwmon/abituguru31
-rw-r--r--Documentation/hwmon/abituguru365
2 files changed, 83 insertions, 13 deletions
diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru
index b2c0d61b39a2..87ffa0f5ec70 100644
--- a/Documentation/hwmon/abituguru
+++ b/Documentation/hwmon/abituguru
@@ -2,7 +2,7 @@ Kernel driver abituguru
2======================= 2=======================
3 3
4Supported chips: 4Supported chips:
5 * Abit uGuru revision 1-3 (Hardware Monitor part only) 5 * Abit uGuru revision 1 & 2 (Hardware Monitor part only)
6 Prefix: 'abituguru' 6 Prefix: 'abituguru'
7 Addresses scanned: ISA 0x0E0 7 Addresses scanned: ISA 0x0E0
8 Datasheet: Not available, this driver is based on reverse engineering. 8 Datasheet: Not available, this driver is based on reverse engineering.
@@ -20,8 +20,8 @@ Supported chips:
20 uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8) 20 uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
21 uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty) 21 uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty)
22 uGuru 2.3.0.0 ~ 2.3.0.9 (AN8) 22 uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
23 uGuru 3.0.0.0 ~ 3.0.1.2 (AW8, AL8, NI8) 23 uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
24 uGuru 4.xxxxx? (AT8 32X) (2) 24 AW9D-MAX) (2)
25 1) For revisions 2 and 3 uGuru's the driver can autodetect the 25 1) For revisions 2 and 3 uGuru's the driver can autodetect the
26 sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's 26 sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's
27 this doesnot always work. For these uGuru's the autodection can 27 this doesnot always work. For these uGuru's the autodection can
@@ -30,8 +30,9 @@ Supported chips:
30 bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1 30 bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1
31 You may also need to specify the fan_sensors option for these boards 31 You may also need to specify the fan_sensors option for these boards
32 fan_sensors=5 32 fan_sensors=5
33 2) The current version of the abituguru driver is known to NOT work 33 2) There is a seperate abituguru3 driver for these motherboards,
34 on these Motherboards 34 the abituguru (without the 3 !) driver will not work on these
35 motherboards (and visa versa)!
35 36
36Authors: 37Authors:
37 Hans de Goede <j.w.r.degoede@hhs.nl>, 38 Hans de Goede <j.w.r.degoede@hhs.nl>,
@@ -43,8 +44,10 @@ Module Parameters
43----------------- 44-----------------
44 45
45* force: bool Force detection. Note this parameter only causes the 46* force: bool Force detection. Note this parameter only causes the
46 detection to be skipped, if the uGuru can't be read 47 detection to be skipped, and thus the insmod to
47 the module initialization (insmod) will still fail. 48 succeed. If the uGuru can't be read the actual hwmon
49 driver will not load and thus no hwmon device will get
50 registered.
48* bank1_types: int[] Bank1 sensortype autodetection override: 51* bank1_types: int[] Bank1 sensortype autodetection override:
49 -1 autodetect (default) 52 -1 autodetect (default)
50 0 volt sensor 53 0 volt sensor
@@ -69,13 +72,15 @@ dmesg | grep abituguru
69Description 72Description
70----------- 73-----------
71 74
72This driver supports the hardware monitoring features of the Abit uGuru chip 75This driver supports the hardware monitoring features of the first and
73found on Abit uGuru featuring motherboards (most modern Abit motherboards). 76second revision of the Abit uGuru chip found on Abit uGuru featuring
77motherboards (most modern Abit motherboards).
74 78
75The uGuru chip in reality is a Winbond W83L950D in disguise (despite Abit 79The first and second revision of the uGuru chip in reality is a Winbond
76claiming it is "a new microprocessor designed by the ABIT Engineers"). 80W83L950D in disguise (despite Abit claiming it is "a new microprocessor
77Unfortunatly this doesn't help since the W83L950D is a generic 81designed by the ABIT Engineers"). Unfortunatly this doesn't help since the
78microcontroller with a custom Abit application running on it. 82W83L950D is a generic microcontroller with a custom Abit application running
83on it.
79 84
80Despite Abit not releasing any information regarding the uGuru, Olle 85Despite Abit not releasing any information regarding the uGuru, Olle
81Sandberg <ollebull@gmail.com> has managed to reverse engineer the sensor part 86Sandberg <ollebull@gmail.com> has managed to reverse engineer the sensor part
diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3
new file mode 100644
index 000000000000..fa598aac22fa
--- /dev/null
+++ b/Documentation/hwmon/abituguru3
@@ -0,0 +1,65 @@
1Kernel driver abituguru3
2========================
3
4Supported chips:
5 * Abit uGuru revision 3 (Hardware Monitor part, reading only)
6 Prefix: 'abituguru3'
7 Addresses scanned: ISA 0x0E0
8 Datasheet: Not available, this driver is based on reverse engineering.
9 Note:
10 The uGuru is a microcontroller with onboard firmware which programs
11 it to behave as a hwmon IC. There are many different revisions of the
12 firmware and thus effectivly many different revisions of the uGuru.
13 Below is an incomplete list with which revisions are used for which
14 Motherboards:
15 uGuru 1.00 ~ 1.24 (AI7, KV8-MAX3, AN7)
16 uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
17 uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
18 uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
19 uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
20 AW9D-MAX)
21 The abituguru3 driver is only for revison 3.0.x.x motherboards,
22 this driver will not work on older motherboards. For older
23 motherboards use the abituguru (without the 3 !) driver.
24
25Authors:
26 Hans de Goede <j.w.r.degoede@hhs.nl>,
27 (Initial reverse engineering done by Louis Kruger)
28
29
30Module Parameters
31-----------------
32
33* force: bool Force detection. Note this parameter only causes the
34 detection to be skipped, and thus the insmod to
35 succeed. If the uGuru can't be read the actual hwmon
36 driver will not load and thus no hwmon device will get
37 registered.
38* verbose: bool Should the driver be verbose?
39 0/off/false normal output
40 1/on/true + verbose error reporting (default)
41 Default: 1 (the driver is still in the testing phase)
42
43Description
44-----------
45
46This driver supports the hardware monitoring features of the third revision of
47the Abit uGuru chip, found on recent Abit uGuru featuring motherboards.
48
49The 3rd revision of the uGuru chip in reality is a Winbond W83L951G.
50Unfortunatly this doesn't help since the W83L951G is a generic microcontroller
51with a custom Abit application running on it.
52
53Despite Abit not releasing any information regarding the uGuru revision 3,
54Louis Kruger has managed to reverse engineer the sensor part of the uGuru.
55Without his work this driver would not have been possible.
56
57Known Issues
58------------
59
60The voltage and frequency control parts of the Abit uGuru are not supported,
61neither is writing any of the sensor settings and writing / reading the
62fanspeed control registers (FanEQ)
63
64If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
65include the output of: "dmesg | grep abituguru"