| 1 | Kernel driver `lm63.o' |
|---|
| 2 | ====================== |
|---|
| 3 | |
|---|
| 4 | Status: Complete, lightly tested |
|---|
| 5 | |
|---|
| 6 | Supported chips: |
|---|
| 7 | * National Semiconductor LM63 |
|---|
| 8 | Prefix: 'lm63' |
|---|
| 9 | Addresses scanned: I2C 0x4c |
|---|
| 10 | Datasheet: Publicly available at the National Semiconductor website |
|---|
| 11 | http://www.national.com/pf/LM/LM63.html |
|---|
| 12 | |
|---|
| 13 | |
|---|
| 14 | Author: Jean Delvare <khali@linux-fr.org> |
|---|
| 15 | |
|---|
| 16 | Thanks go to Tyan and especially Alex Buckingham for setting up a remote |
|---|
| 17 | access to their S4882 test platform for this driver. |
|---|
| 18 | http://www.tyan.com/ |
|---|
| 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_lm63: short array (min = 1, max = 48) |
|---|
| 29 | List of adapter,address pairs which are unquestionably assumed to contain |
|---|
| 30 | a `lm63' 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 LM63 is a digital temperature sensor with integrated fan monitoring |
|---|
| 45 | and control. |
|---|
| 46 | |
|---|
| 47 | All temperature values are given in degrees Celsius. Resolution is 1.0 |
|---|
| 48 | degree for the local temperature, 0.125 degree for the remote temperature. |
|---|
| 49 | |
|---|
| 50 | The fan speed is measured using a tachometer. Contrary to most chips which |
|---|
| 51 | store the value in an 8-bit register and have a selectable clock divider |
|---|
| 52 | to make sure that the result will fit in the register, the LM63 uses 16-bit |
|---|
| 53 | value for measuring the speed of the fan. It can measure fan speeds down to |
|---|
| 54 | 83 RPM, at least in theory. |
|---|
| 55 | |
|---|
| 56 | Note that the pin used for fan monitoring is shared with an alert out |
|---|
| 57 | function. Depending on how the board designer wanted to use the chip, fan |
|---|
| 58 | speed monitoring will or will not be possible. The proper chip configuration |
|---|
| 59 | is left to the BIOS, and the driver will blindly trust it. |
|---|
| 60 | |
|---|
| 61 | A PWM output can be used to control the speed of the fan. The LM63 has two |
|---|
| 62 | PWM modes: manual and automatic. Automatic mode is not fully implemented yet |
|---|
| 63 | (you cannot define your custom pwm/temperature curve), and mode change isn't |
|---|
| 64 | supported either. |
|---|
| 65 | |
|---|
| 66 | The lm63 driver will not update its values more frequently than every |
|---|
| 67 | second; reading them more often will do no harm, but will return 'old' |
|---|
| 68 | values. |
|---|
| 69 | |
|---|
| 70 | |
|---|
| 71 | Chip Features |
|---|
| 72 | ------------- |
|---|
| 73 | |
|---|
| 74 | Chip 'lm63' |
|---|
| 75 | |
|---|
| 76 | LABEL LABEL CLASS COMPUTE CLASS MODE MAGN |
|---|
| 77 | temp1 - - R- 0 |
|---|
| 78 | temp1_high temp1 temp1 RW 0 |
|---|
| 79 | temp2 - - R- 3 |
|---|
| 80 | temp2_high temp2 temp2 RW 3 |
|---|
| 81 | temp2_low temp2 temp2 RW 3 |
|---|
| 82 | temp2_crit temp2 temp2 R- 0 |
|---|
| 83 | temp2_crit_hyst temp2 temp2 RW 0 |
|---|
| 84 | fan1 - - R- 0 |
|---|
| 85 | fan1_low fan1 fan1 RW 0 |
|---|
| 86 | pwm1 - - RW 0 |
|---|
| 87 | pwm1_enable pwm1 - R- 0 |
|---|
| 88 | alarms - - R- 0 |
|---|
| 89 | |
|---|
| 90 | LABEL FEATURE SYMBOL SYSCTL FILE:N |
|---|
| 91 | temp1 SENSORS_LM63_LOCAL_TEMP temp1:2 |
|---|
| 92 | temp1_high SENSORS_LM63_LOCAL_HIGH temp1:1 |
|---|
| 93 | temp2 SENSORS_LM63_REMOTE_TEMP temp2:3 |
|---|
| 94 | temp2_high SENSORS_LM63_REMOTE_HIGH temp2:1 |
|---|
| 95 | temp2_low SENSORS_LM63_REMOTE_LOW temp2:2 |
|---|
| 96 | temp2_crit SENSORS_LM63_REMOTE_TCRIT temp2_crit:1 |
|---|
| 97 | temp2_crit_hyst SENSORS_LM63_REMOTE_TCRIT_HYST temp2_crit_hyst:1 |
|---|
| 98 | fan1 SENSORS_LM63_FAN fan1:2 |
|---|
| 99 | fan1_low SENSORS_LM63_FAN_LOW fan1:1 |
|---|
| 100 | pwm1 SENSORS_LM63_PWM pwm1:1 |
|---|
| 101 | pwm1_enable SENSORS_LM63_PWM_ENABLE pwm1:2 |
|---|
| 102 | alarms SENSORS_LM63_ALARMS alarms:1 |
|---|
