1*7ebd8b66SMauro Carvalho ChehabKernel driver lm80 2*7ebd8b66SMauro Carvalho Chehab================== 3*7ebd8b66SMauro Carvalho Chehab 4*7ebd8b66SMauro Carvalho ChehabSupported chips: 5*7ebd8b66SMauro Carvalho Chehab 6*7ebd8b66SMauro Carvalho Chehab * National Semiconductor LM80 7*7ebd8b66SMauro Carvalho Chehab 8*7ebd8b66SMauro Carvalho Chehab Prefix: 'lm80' 9*7ebd8b66SMauro Carvalho Chehab 10*7ebd8b66SMauro Carvalho Chehab Addresses scanned: I2C 0x28 - 0x2f 11*7ebd8b66SMauro Carvalho Chehab 12*7ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at the National Semiconductor website 13*7ebd8b66SMauro Carvalho Chehab 14*7ebd8b66SMauro Carvalho Chehab http://www.national.com/ 15*7ebd8b66SMauro Carvalho Chehab 16*7ebd8b66SMauro Carvalho Chehab * National Semiconductor LM96080 17*7ebd8b66SMauro Carvalho Chehab 18*7ebd8b66SMauro Carvalho Chehab Prefix: 'lm96080' 19*7ebd8b66SMauro Carvalho Chehab 20*7ebd8b66SMauro Carvalho Chehab Addresses scanned: I2C 0x28 - 0x2f 21*7ebd8b66SMauro Carvalho Chehab 22*7ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at the National Semiconductor website 23*7ebd8b66SMauro Carvalho Chehab 24*7ebd8b66SMauro Carvalho Chehab http://www.national.com/ 25*7ebd8b66SMauro Carvalho Chehab 26*7ebd8b66SMauro Carvalho Chehab 27*7ebd8b66SMauro Carvalho ChehabAuthors: 28*7ebd8b66SMauro Carvalho Chehab - Frodo Looijaard <frodol@dds.nl>, 29*7ebd8b66SMauro Carvalho Chehab - Philip Edelbrock <phil@netroedge.com> 30*7ebd8b66SMauro Carvalho Chehab 31*7ebd8b66SMauro Carvalho ChehabDescription 32*7ebd8b66SMauro Carvalho Chehab----------- 33*7ebd8b66SMauro Carvalho Chehab 34*7ebd8b66SMauro Carvalho ChehabThis driver implements support for the National Semiconductor LM80. 35*7ebd8b66SMauro Carvalho ChehabIt is described as a 'Serial Interface ACPI-Compatible Microprocessor 36*7ebd8b66SMauro Carvalho ChehabSystem Hardware Monitor'. The LM96080 is a more recent incarnation, 37*7ebd8b66SMauro Carvalho Chehabit is pin and register compatible, with a few additional features not 38*7ebd8b66SMauro Carvalho Chehabyet supported by the driver. 39*7ebd8b66SMauro Carvalho Chehab 40*7ebd8b66SMauro Carvalho ChehabThe LM80 implements one temperature sensor, two fan rotation speed sensors, 41*7ebd8b66SMauro Carvalho Chehabseven voltage sensors, alarms, and some miscellaneous stuff. 42*7ebd8b66SMauro Carvalho Chehab 43*7ebd8b66SMauro Carvalho ChehabTemperatures are measured in degrees Celsius. There are two sets of limits 44*7ebd8b66SMauro Carvalho Chehabwhich operate independently. When the HOT Temperature Limit is crossed, 45*7ebd8b66SMauro Carvalho Chehabthis will cause an alarm that will be reasserted until the temperature 46*7ebd8b66SMauro Carvalho Chehabdrops below the HOT Hysteresis. The Overtemperature Shutdown (OS) limits 47*7ebd8b66SMauro Carvalho Chehabshould work in the same way (but this must be checked; the datasheet 48*7ebd8b66SMauro Carvalho Chehabis unclear about this). Measurements are guaranteed between -55 and 49*7ebd8b66SMauro Carvalho Chehab+125 degrees. The current temperature measurement has a resolution of 50*7ebd8b66SMauro Carvalho Chehab0.0625 degrees; the limits have a resolution of 1 degree. 51*7ebd8b66SMauro Carvalho Chehab 52*7ebd8b66SMauro Carvalho ChehabFan rotation speeds are reported in RPM (rotations per minute). An alarm is 53*7ebd8b66SMauro Carvalho Chehabtriggered if the rotation speed has dropped below a programmable limit. Fan 54*7ebd8b66SMauro Carvalho Chehabreadings can be divided by a programmable divider (1, 2, 4 or 8) to give 55*7ebd8b66SMauro Carvalho Chehabthe readings more range or accuracy. Not all RPM values can accurately be 56*7ebd8b66SMauro Carvalho Chehabrepresented, so some rounding is done. With a divider of 2, the lowest 57*7ebd8b66SMauro Carvalho Chehabrepresentable value is around 2600 RPM. 58*7ebd8b66SMauro Carvalho Chehab 59*7ebd8b66SMauro Carvalho ChehabVoltage sensors (also known as IN sensors) report their values in volts. 60*7ebd8b66SMauro Carvalho ChehabAn alarm is triggered if the voltage has crossed a programmable minimum 61*7ebd8b66SMauro Carvalho Chehabor maximum limit. Note that minimum in this case always means 'closest to 62*7ebd8b66SMauro Carvalho Chehabzero'; this is important for negative voltage measurements. All voltage 63*7ebd8b66SMauro Carvalho Chehabinputs can measure voltages between 0 and 2.55 volts, with a resolution 64*7ebd8b66SMauro Carvalho Chehabof 0.01 volt. 65*7ebd8b66SMauro Carvalho Chehab 66*7ebd8b66SMauro Carvalho ChehabIf an alarm triggers, it will remain triggered until the hardware register 67*7ebd8b66SMauro Carvalho Chehabis read at least once. This means that the cause for the alarm may 68*7ebd8b66SMauro Carvalho Chehabalready have disappeared! Note that in the current implementation, all 69*7ebd8b66SMauro Carvalho Chehabhardware registers are read whenever any data is read (unless it is less 70*7ebd8b66SMauro Carvalho Chehabthan 2.0 seconds since the last update). This means that you can easily 71*7ebd8b66SMauro Carvalho Chehabmiss once-only alarms. 72*7ebd8b66SMauro Carvalho Chehab 73*7ebd8b66SMauro Carvalho ChehabThe LM80 only updates its values each 1.5 seconds; reading it more often 74*7ebd8b66SMauro Carvalho Chehabwill do no harm, but will return 'old' values. 75