| 1 | Kernel driver `lm83.o' |
|---|
| 2 | ===================== |
|---|
| 3 | |
|---|
| 4 | Status: Complete and lightly tested |
|---|
| 5 | |
|---|
| 6 | Supported chips: |
|---|
| 7 | * National Semiconductor LM83 |
|---|
| 8 | Prefix: 'lm83' |
|---|
| 9 | Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e |
|---|
| 10 | Datasheet: Publicly available at the National Semiconductor website |
|---|
| 11 | http://www.national.com/pf/LM/LM83.html |
|---|
| 12 | * National Semiconductor LM82 |
|---|
| 13 | Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e |
|---|
| 14 | Datasheet: Publicly available at the National Semiconductor website |
|---|
| 15 | http://www.national.com/pf/LM/LM82.html |
|---|
| 16 | |
|---|
| 17 | |
|---|
| 18 | Author: Jean Delvare <khali@linux-fr.org> |
|---|
| 19 | |
|---|
| 20 | License: GPL |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | Module Parameters |
|---|
| 24 | ----------------- |
|---|
| 25 | |
|---|
| 26 | * force: short array (min = 1, max = 48) |
|---|
| 27 | List of adapter,address pairs to boldly assume to be present |
|---|
| 28 | * force_lm83: short array (min = 1, max = 48) |
|---|
| 29 | List of adapter,address pairs which are unquestionably assumed to contain |
|---|
| 30 | a `lm83' chip |
|---|
| 31 | * probe: short array (min = 1, max = 48) |
|---|
| 32 | List of adapter,address pairs to scan additionally |
|---|
| 33 | * probe_range: short array (min = 1, max = 48) |
|---|
| 34 | List of adapter,start-addr,end-addr triples to scan additionally |
|---|
| 35 | * ignore: short array (min = 1, max = 48) |
|---|
| 36 | List of adapter,address pairs not to scan |
|---|
| 37 | * ignore_range: short array (min = 1, max = 48) |
|---|
| 38 | List of adapter,start-addr,end-addr triples not to scan |
|---|
| 39 | |
|---|
| 40 | |
|---|
| 41 | Description |
|---|
| 42 | ----------- |
|---|
| 43 | |
|---|
| 44 | The LM83 is a digital temperature sensor. It senses its own temperature as |
|---|
| 45 | well as the temperature of up to three external diodes. The LM82 is |
|---|
| 46 | a stripped down version of the LM83 that only supports one external diode. |
|---|
| 47 | Both are compatible with many other devices such as the LM84 and all |
|---|
| 48 | other ADM1021 clones. The main difference between the LM83 and the LM84 |
|---|
| 49 | in that the later can only sense the temperature of one external diode. |
|---|
| 50 | |
|---|
| 51 | Using the adm1021 driver for a LM83 should work, but only two temperatures |
|---|
| 52 | will be reported instead of four. |
|---|
| 53 | |
|---|
| 54 | The LM83 is only found on a handful of motherboards. Both a confirmed |
|---|
| 55 | list and an unconfirmed list follow. If you can confirm or infirm the |
|---|
| 56 | fact that any of these motherboards do actually have an LM83, please |
|---|
| 57 | contact us. Note that the LM90 can easily be misdetected as a LM83. |
|---|
| 58 | |
|---|
| 59 | Confirmed motherboards: |
|---|
| 60 | SBS P014 |
|---|
| 61 | SBS PSL09 |
|---|
| 62 | |
|---|
| 63 | Unconfirmed motherboards: |
|---|
| 64 | Gigabyte GA-8IK1100 |
|---|
| 65 | Iwill MPX2 |
|---|
| 66 | Soltek SL-75DRV5 |
|---|
| 67 | |
|---|
| 68 | The LM82 is confirmed to have been found on most AMD Geode reference |
|---|
| 69 | designs and test platforms. |
|---|
| 70 | |
|---|
| 71 | The driver has been successfully tested by Magnus Forsström, who I'd |
|---|
| 72 | like to thank here. More testers will be of course welcome. |
|---|
| 73 | |
|---|
| 74 | The fact that the LM83 is only scarcely used can be easily explained. |
|---|
| 75 | Most motherboards come with more than just temperature sensors for |
|---|
| 76 | health monitoring. They also have voltage and fan rotation speed |
|---|
| 77 | sensors. This means that temperature-only chips are usually used as |
|---|
| 78 | secondary chips coupled with another chip such as an IT8705F or similar |
|---|
| 79 | chip, which provides more features. Since systems usually need three |
|---|
| 80 | temperature sensors (motherboard, processor, power supply) and primary |
|---|
| 81 | chips provide some temperature sensors, the secondary chip, if needed, |
|---|
| 82 | won't have to handle more than two temperatures. Thus, ADM1021 clones |
|---|
| 83 | are sufficent, and there is no need for a four temperatures sensor |
|---|
| 84 | chip such as the LM83. The only case where using an LM83 would make |
|---|
| 85 | sense is on SMP systems, such as the above-mentioned Iwill MPX2, |
|---|
| 86 | because you want an additional temperature sensor for each additional |
|---|
| 87 | CPU. |
|---|
| 88 | |
|---|
| 89 | On the SBS P014, this is different, since the LM83 is the only hardware |
|---|
| 90 | monitoring chipset. One temperature sensor is used for the motherboard |
|---|
| 91 | (actually measuring the LM83's own temperature), one is used for the |
|---|
| 92 | CPU. The two other sensors must be used to measure the temperature of |
|---|
| 93 | two other points of the motherboard. We suspect these points to be the |
|---|
| 94 | north and south bridges, but this couldn't be confirmed. |
|---|
| 95 | |
|---|
| 96 | All temperature values are given in degrees Celsius. Local temperature |
|---|
| 97 | is given within a range of 0 to +85 degrees. Remote temperatures are |
|---|
| 98 | given within a range of 0 to +125 degrees. Resolution is 1.0 degree, |
|---|
| 99 | accuracy is guaranteed to 3.0 degrees (see the datasheet for more |
|---|
| 100 | details). |
|---|
| 101 | |
|---|
| 102 | Each sensor has its own high limit, but the critical limit is common to |
|---|
| 103 | all four sensors. There is no hysteresis mechanism as found on most |
|---|
| 104 | recent temperature sensors. |
|---|
| 105 | |
|---|
| 106 | The lm83 driver will not update its values more frequently than every |
|---|
| 107 | other second; reading them more often will do no harm, but will return |
|---|
| 108 | 'old' values. |
|---|
| 109 | |
|---|
| 110 | |
|---|
| 111 | Chip Features |
|---|
| 112 | ------------- |
|---|
| 113 | |
|---|
| 114 | Chip 'lm83' |
|---|
| 115 | |
|---|
| 116 | LABEL LABEL CLASS COMPUTE CLASS MODE MAGN |
|---|
| 117 | temp1 - - R- 0 |
|---|
| 118 | temp1_high temp1 temp1 RW 0 |
|---|
| 119 | temp2 - - R- 0 |
|---|
| 120 | temp2_high temp2 temp2 RW 0 |
|---|
| 121 | temp3 - - R- 0 |
|---|
| 122 | temp3_high temp3 temp3 RW 0 |
|---|
| 123 | temp4 - - R- 0 |
|---|
| 124 | temp4_high temp4 temp4 RW 0 |
|---|
| 125 | tcrit - - RW 0 |
|---|
| 126 | alarms - - R- 0 |
|---|
| 127 | |
|---|
| 128 | LABEL FEATURE SYMBOL SYSCTL FILE:N |
|---|
| 129 | temp1 SENSORS_LM83_LOCAL_TEMP temp1:2 |
|---|
| 130 | temp1_high SENSORS_LM83_LOCAL_HIGH temp1:1 |
|---|
| 131 | temp2 SENSORS_LM83_REMOTE1_TEMP temp2:2 |
|---|
| 132 | temp2_high SENSORS_LM83_REMOTE1_HIGH temp2:1 |
|---|
| 133 | temp3 SENSORS_LM83_REMOTE2_TEMP temp3:2 |
|---|
| 134 | temp3_high SENSORS_LM83_REMOTE2_HIGH temp3:1 |
|---|
| 135 | temp4 SENSORS_LM83_REMOTE3_TEMP temp4:2 |
|---|
| 136 | temp4_high SENSORS_LM83_REMOTE3_HIGH temp4:1 |
|---|
| 137 | tcrit SENSORS_LM83_TCRIT tcrit:1 |
|---|
| 138 | alarms SENSORS_LM83_ALARMS alarms:1 |
|---|
| 139 | |
|---|
| 140 | Chip 'lm82' |
|---|
| 141 | |
|---|
| 142 | LABEL LABEL CLASS COMPUTE CLASS MODE MAGN |
|---|
| 143 | temp1 - - R- 0 |
|---|
| 144 | temp1_high temp1 temp1 RW 0 |
|---|
| 145 | temp3 - - R- 0 |
|---|
| 146 | temp3_high temp3 temp3 RW 0 |
|---|
| 147 | tcrit - - RW 0 |
|---|
| 148 | alarms - - R- 0 |
|---|
| 149 | |
|---|
| 150 | LABEL FEATURE SYMBOL SYSCTL FILE:N |
|---|
| 151 | temp1 SENSORS_LM83_LOCAL_TEMP temp1:2 |
|---|
| 152 | temp1_high SENSORS_LM83_LOCAL_HIGH temp1:1 |
|---|
| 153 | temp3 SENSORS_LM83_REMOTE2_TEMP temp3:2 |
|---|
| 154 | temp3_high SENSORS_LM83_REMOTE2_HIGH temp3:1 |
|---|
| 155 | tcrit SENSORS_LM83_TCRIT tcrit:1 |
|---|
| 156 | alarms SENSORS_LM83_ALARMS alarms:1 |
|---|
