lm63.rst 3.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. Kernel driver lm63
  2. ==================
  3. Supported chips:
  4. * National Semiconductor LM63
  5. Prefix: 'lm63'
  6. Addresses scanned: I2C 0x4c
  7. Datasheet: Publicly available at the National Semiconductor website
  8. http://www.national.com/pf/LM/LM63.html
  9. * National Semiconductor LM64
  10. Prefix: 'lm64'
  11. Addresses scanned: I2C 0x18 and 0x4e
  12. Datasheet: Publicly available at the National Semiconductor website
  13. http://www.national.com/pf/LM/LM64.html
  14. * National Semiconductor LM96163
  15. Prefix: 'lm96163'
  16. Addresses scanned: I2C 0x4c
  17. Datasheet: Publicly available at the National Semiconductor website
  18. http://www.national.com/pf/LM/LM96163.html
  19. Author: Jean Delvare <jdelvare@suse.de>
  20. Thanks go to Tyan and especially Alex Buckingham for setting up a remote
  21. access to their S4882 test platform for this driver.
  22. https://www.tyan.com/
  23. Description
  24. -----------
  25. The LM63 is a digital temperature sensor with integrated fan monitoring
  26. and control.
  27. The LM63 is basically an LM86 with fan speed monitoring and control
  28. capabilities added. It misses some of the LM86 features though:
  29. - No low limit for local temperature.
  30. - No critical limit for local temperature.
  31. - Critical limit for remote temperature can be changed only once. We
  32. will consider that the critical limit is read-only.
  33. The datasheet isn't very clear about what the tachometer reading is.
  34. An explanation from National Semiconductor: The two lower bits of the read
  35. value have to be masked out. The value is still 16 bit in width.
  36. All temperature values are given in degrees Celsius. Resolution is 1.0
  37. degree for the local temperature, 0.125 degree for the remote temperature.
  38. The fan speed is measured using a tachometer. Contrary to most chips which
  39. store the value in an 8-bit register and have a selectable clock divider
  40. to make sure that the result will fit in the register, the LM63 uses 16-bit
  41. value for measuring the speed of the fan. It can measure fan speeds down to
  42. 83 RPM, at least in theory.
  43. Note that the pin used for fan monitoring is shared with an alert out
  44. function. Depending on how the board designer wanted to use the chip, fan
  45. speed monitoring will or will not be possible. The proper chip configuration
  46. is left to the BIOS, and the driver will blindly trust it. Only the original
  47. LM63 suffers from this limitation, the LM64 and LM96163 have separate pins
  48. for fan monitoring and alert out. On the LM64, monitoring is always enabled;
  49. on the LM96163 it can be disabled.
  50. A PWM output can be used to control the speed of the fan. The LM63 has two
  51. PWM modes: manual and automatic. Automatic mode is not fully implemented yet
  52. (you cannot define your custom PWM/temperature curve), and mode change isn't
  53. supported either.
  54. The lm63 driver will not update its values more frequently than configured with
  55. the update_interval sysfs attribute; reading them more often will do no harm,
  56. but will return 'old' values. Values in the automatic fan control lookup table
  57. (attributes pwm1_auto_*) have their own independent lifetime of 5 seconds.
  58. The LM64 is effectively an LM63 with GPIO lines. The driver does not
  59. support these GPIO lines at present.
  60. The LM96163 is an enhanced version of LM63 with improved temperature accuracy
  61. and better PWM resolution. For LM96163, the external temperature sensor type is
  62. configurable as CPU embedded diode(1) or 3904 transistor(2).