| 1 | Kernel driver `via686a.o' |
|---|
| 2 | ========================= |
|---|
| 3 | |
|---|
| 4 | Status: Stable. |
|---|
| 5 | |
|---|
| 6 | Supported chips: |
|---|
| 7 | * Via VT82C686A, VT82C686B Southbridge Integrated Hardware Monitor |
|---|
| 8 | Prefix: 'via686a' |
|---|
| 9 | Addresses scanned: ISA in PCI-space encoded address |
|---|
| 10 | Datasheet: On request through web form |
|---|
| 11 | (http://www.via.com.tw/en/support/datasheets/) |
|---|
| 12 | |
|---|
| 13 | Authors: Kyösti Mälkki <kmalkki@cc.hut.fi>, |
|---|
| 14 | Mark D. Studebaker <mdsxyz123@yahoo.com> |
|---|
| 15 | Bob Dougherty <bobd@stanford.edu> |
|---|
| 16 | (Some conversion-factor data were contributed by |
|---|
| 17 | Jonathan Teh Soon Yew <j.teh@iname.com> |
|---|
| 18 | and Alex van Kaam <darkside@chello.nl>.) |
|---|
| 19 | |
|---|
| 20 | Module Parameters |
|---|
| 21 | ----------------- |
|---|
| 22 | |
|---|
| 23 | force_addr=0xaddr Set the I/O base address. Useful for boards that |
|---|
| 24 | don't set the address in the BIOS. Look for a BIOS |
|---|
| 25 | upgrade before resorting to this. Does not do a |
|---|
| 26 | PCI force; the via686a must still be present in lspci. |
|---|
| 27 | Don't use this unless the driver complains that the |
|---|
| 28 | base address is not set. |
|---|
| 29 | Example: 'modprobe via686a force_addr=0x6000' |
|---|
| 30 | |
|---|
| 31 | |
|---|
| 32 | Description |
|---|
| 33 | ----------- |
|---|
| 34 | |
|---|
| 35 | The driver does not distinguish between the chips and reports |
|---|
| 36 | all as a 686A. |
|---|
| 37 | |
|---|
| 38 | The Via 686a southbridge has integrated hardware monitor functionality. |
|---|
| 39 | It also has an I2C bus, but this driver only supports the hardware monitor. |
|---|
| 40 | For the I2C bus driver, see ../busses/i2c-viapro. |
|---|
| 41 | |
|---|
| 42 | The Via 686a implements three temperature sensors, two fan rotation speed |
|---|
| 43 | sensors, five voltage sensors and alarms. |
|---|
| 44 | |
|---|
| 45 | Temperatures are measured in degrees Celsius. An alarm is triggered once |
|---|
| 46 | when the Overtemperature Shutdown limit is crossed; it is triggered again |
|---|
| 47 | as soon as it drops below the hysteresis value. |
|---|
| 48 | |
|---|
| 49 | Fan rotation speeds are reported in RPM (rotations per minute). An alarm is |
|---|
| 50 | triggered if the rotation speed has dropped below a programmable limit. Fan |
|---|
| 51 | readings can be divided by a programmable divider (1, 2, 4 or 8) to give |
|---|
| 52 | the readings more range or accuracy. Not all RPM values can accurately be |
|---|
| 53 | represented, so some rounding is done. With a divider of 2, the lowest |
|---|
| 54 | representable value is around 2600 RPM. |
|---|
| 55 | |
|---|
| 56 | Voltage sensors (also known as IN sensors) report their values in volts. |
|---|
| 57 | An alarm is triggered if the voltage has crossed a programmable minimum |
|---|
| 58 | or maximum limit. Voltages are internally scalled, so each voltage channel |
|---|
| 59 | has a different resolution and range. |
|---|
| 60 | |
|---|
| 61 | If an alarm triggers, it will remain triggered until the hardware register |
|---|
| 62 | is read at least once. This means that the cause for the alarm may |
|---|
| 63 | already have disappeared! Note that in the current implementation, all |
|---|
| 64 | hardware registers are read whenever any data is read (unless it is less |
|---|
| 65 | than 1.5 seconds since the last update). This means that you can easily |
|---|
| 66 | miss once-only alarms. |
|---|
| 67 | |
|---|
| 68 | The driver only updates its values each 1.5 seconds; reading it more often |
|---|
| 69 | will do no harm, but will return 'old' values. |
|---|
| 70 | |
|---|
| 71 | |
|---|
| 72 | Known Issues |
|---|
| 73 | ------------ |
|---|
| 74 | |
|---|
| 75 | This driver handles sensors integrated in some VIA south bridges. It is |
|---|
| 76 | possible that a motherboard maker used a VT82C686A/B chip as part of a |
|---|
| 77 | product design but was not interested in its hardware monitoring features, |
|---|
| 78 | in which case the sensor inputs will not be wired. This is the case of |
|---|
| 79 | the Asus K7V, A7V and A7V133 motherboards, to name only a few of them. |
|---|
| 80 | So, if you need the force_addr parameter, and end up with values which |
|---|
| 81 | don't seem to make any sense, don't look any further: your chip is simply |
|---|
| 82 | not wired for hardware monitoring. |
|---|
| 83 | |
|---|
| 84 | |
|---|
| 85 | Chip Features |
|---|
| 86 | ------------- |
|---|
| 87 | |
|---|
| 88 | Chip `via686a' |
|---|
| 89 | LABEL LABEL CLASS COMPUTE CLASS ACCESS MAGNITUDE |
|---|
| 90 | in0 NONE NONE R 2 |
|---|
| 91 | in1 NONE NONE R 2 |
|---|
| 92 | in2 NONE NONE R 2 |
|---|
| 93 | in3 NONE NONE R 2 |
|---|
| 94 | in4 NONE NONE R 2 |
|---|
| 95 | in0_min in0 in0 RW 2 |
|---|
| 96 | in1_min in1 in1 RW 2 |
|---|
| 97 | in2_min in2 in2 RW 2 |
|---|
| 98 | in3_min in3 in3 RW 2 |
|---|
| 99 | in4_min in3 in3 RW 2 |
|---|
| 100 | in0_max in0 in0 RW 2 |
|---|
| 101 | in1_max in1 in1 RW 2 |
|---|
| 102 | in2_max in2 in2 RW 2 |
|---|
| 103 | in3_max in3 in3 RW 2 |
|---|
| 104 | in4_max in3 in3 RW 2 |
|---|
| 105 | fan1 NONE NONE R 0 |
|---|
| 106 | fan2 NONE NONE R 0 |
|---|
| 107 | fan1_min fan1 fan1 RW 0 |
|---|
| 108 | fan2_min fan2 fan2 RW 0 |
|---|
| 109 | temp NONE NONE R 1 |
|---|
| 110 | temp_hyst temp temp RW 1 |
|---|
| 111 | temp_over temp temp RW 1 |
|---|
| 112 | temp2 NONE NONE R 1 |
|---|
| 113 | temp2_hyst temp temp RW 1 |
|---|
| 114 | temp2_over temp temp RW 1 |
|---|
| 115 | temp3 NONE NONE R 1 |
|---|
| 116 | temp3_hyst temp temp RW 1 |
|---|
| 117 | temp3_over temp temp RW 1 |
|---|
| 118 | fan1_div fan1 NONE RW 0 |
|---|
| 119 | fan2_div fan2 NONE RW 0 |
|---|
| 120 | alarms NONE NONE R 0 |
|---|
| 121 | |
|---|
| 122 | LABEL FEATURE SYMBOL SYSCTL FILE:NR |
|---|
| 123 | in0 SENSORS_VIA686A_IN0 in0:3 |
|---|
| 124 | in1 SENSORS_VIA686A_IN1 in1:3 |
|---|
| 125 | in2 SENSORS_VIA686A_IN2 in2:3 |
|---|
| 126 | in3 SENSORS_VIA686A_IN3 in3:3 |
|---|
| 127 | in4 SENSORS_VIA686A_IN4 in4:3 |
|---|
| 128 | in0_min SENSORS_VIA686A_IN0_MIN in0:1 |
|---|
| 129 | in1_min SENSORS_VIA686A_IN1_MIN in1:1 |
|---|
| 130 | in2_min SENSORS_VIA686A_IN2_MIN in2:1 |
|---|
| 131 | in3_min SENSORS_VIA686A_IN3_MIN in3:1 |
|---|
| 132 | in4_min SENSORS_VIA686A_IN4_MIN in4:1 |
|---|
| 133 | in0_max SENSORS_VIA686A_IN0_MAX in0:2 |
|---|
| 134 | in1_max SENSORS_VIA686A_IN1_MAX in1:2 |
|---|
| 135 | in2_max SENSORS_VIA686A_IN2_MAX in2:2 |
|---|
| 136 | in3_max SENSORS_VIA686A_IN3_MAX in3:2 |
|---|
| 137 | in4_max SENSORS_VIA686A_IN4_MAX in4:2 |
|---|
| 138 | fan1 SENSORS_VIA686A_FAN1 fan1:2 |
|---|
| 139 | fan2 SENSORS_VIA686A_FAN2 fan2:2 |
|---|
| 140 | fan1_min SENSORS_VIA686A_FAN1_MIN fan1:1 |
|---|
| 141 | fan2_min SENSORS_VIA686A_FAN2_MIN fan2:1 |
|---|
| 142 | temp SENSORS_VIA686A_TEMP temp:3 |
|---|
| 143 | temp_hyst SENSORS_VIA686A_TEMP_HYST temp:2 |
|---|
| 144 | temp_over SENSORS_VIA686A_TEMP_OVER temp:1 |
|---|
| 145 | temp2 SENSORS_VIA686A_TEMP2 temp2:3 |
|---|
| 146 | temp2_hyst SENSORS_VIA686A_TEMP2_HYST temp2:2 |
|---|
| 147 | temp2_over SENSORS_VIA686A_TEMP2_OVER temp2:1 |
|---|
| 148 | temp3 SENSORS_VIA686A_TEMP3 temp3:3 |
|---|
| 149 | temp3_hyst SENSORS_VIA686A_TEMP3_HYST temp3:2 |
|---|
| 150 | temp3_over SENSORS_VIA686A_TEMP3_OVER temp3:1 |
|---|
| 151 | fan1_div SENSORS_VIA686A_FAN1_DIV fan_div:1 |
|---|
| 152 | fan2_div SENSORS_VIA686A_FAN2_DIV fan_div:2 |
|---|
| 153 | alarms SENSORS_VIA686A_ALARMS alarms:1 |
|---|
| 154 | |
|---|
| 155 | |
|---|