Commit | Line | Data |
---|---|---|
3faa1ffb HG |
1 | Kernel driver abituguru3 |
2 | ======================== | |
3 | ||
4 | Supported chips: | |
5 | * Abit uGuru revision 3 (Hardware Monitor part, reading only) | |
b04f2f7d | 6 | |
3faa1ffb | 7 | Prefix: 'abituguru3' |
b04f2f7d | 8 | |
3faa1ffb | 9 | Addresses scanned: ISA 0x0E0 |
b04f2f7d | 10 | |
3faa1ffb | 11 | Datasheet: Not available, this driver is based on reverse engineering. |
b04f2f7d | 12 | |
3faa1ffb HG |
13 | Note: |
14 | The uGuru is a microcontroller with onboard firmware which programs | |
15 | it to behave as a hwmon IC. There are many different revisions of the | |
16 | firmware and thus effectivly many different revisions of the uGuru. | |
17 | Below is an incomplete list with which revisions are used for which | |
18 | Motherboards: | |
b04f2f7d MCC |
19 | |
20 | - uGuru 1.00 ~ 1.24 (AI7, KV8-MAX3, AN7) | |
21 | - uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO) | |
22 | - uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8) | |
23 | - uGuru 2.3.0.0 ~ 2.3.0.9 (AN8) | |
24 | - uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X, | |
25 | AW9D-MAX) | |
26 | ||
3faa1ffb HG |
27 | The abituguru3 driver is only for revison 3.0.x.x motherboards, |
28 | this driver will not work on older motherboards. For older | |
29 | motherboards use the abituguru (without the 3 !) driver. | |
30 | ||
31 | Authors: | |
b04f2f7d MCC |
32 | - Hans de Goede <j.w.r.degoede@hhs.nl>, |
33 | - (Initial reverse engineering done by Louis Kruger) | |
3faa1ffb HG |
34 | |
35 | ||
36 | Module Parameters | |
37 | ----------------- | |
38 | ||
b04f2f7d MCC |
39 | * force: bool |
40 | Force detection. Note this parameter only causes the | |
3faa1ffb HG |
41 | detection to be skipped, and thus the insmod to |
42 | succeed. If the uGuru can't be read the actual hwmon | |
43 | driver will not load and thus no hwmon device will get | |
44 | registered. | |
b04f2f7d MCC |
45 | * verbose: bool |
46 | Should the driver be verbose? | |
47 | ||
48 | * 0/off/false normal output | |
49 | * 1/on/true + verbose error reporting (default) | |
50 | ||
3faa1ffb HG |
51 | Default: 1 (the driver is still in the testing phase) |
52 | ||
53 | Description | |
54 | ----------- | |
55 | ||
56 | This driver supports the hardware monitoring features of the third revision of | |
57 | the Abit uGuru chip, found on recent Abit uGuru featuring motherboards. | |
58 | ||
59 | The 3rd revision of the uGuru chip in reality is a Winbond W83L951G. | |
25985edc | 60 | Unfortunately this doesn't help since the W83L951G is a generic microcontroller |
3faa1ffb HG |
61 | with a custom Abit application running on it. |
62 | ||
63 | Despite Abit not releasing any information regarding the uGuru revision 3, | |
64 | Louis Kruger has managed to reverse engineer the sensor part of the uGuru. | |
65 | Without his work this driver would not have been possible. | |
66 | ||
67 | Known Issues | |
68 | ------------ | |
69 | ||
70 | The voltage and frequency control parts of the Abit uGuru are not supported, | |
71 | neither is writing any of the sensor settings and writing / reading the | |
72 | fanspeed control registers (FanEQ) | |
73 | ||
74 | If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and | |
b04f2f7d | 75 | include the output of: `dmesg | grep abituguru` |