gl518sm 3.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. Kernel driver gl518sm
  2. =====================
  3. Supported chips:
  4. * Genesys Logic GL518SM release 0x00
  5. Prefix: 'gl518sm'
  6. Addresses scanned: I2C 0x2c and 0x2d
  7. Datasheet: http://www.genesyslogic.com/pdf
  8. * Genesys Logic GL518SM release 0x80
  9. Prefix: 'gl518sm'
  10. Addresses scanned: I2C 0x2c and 0x2d
  11. Datasheet: http://www.genesyslogic.com/pdf
  12. Authors:
  13. Frodo Looijaard <frodol@dds.nl>,
  14. Kyösti Mälkki <kmalkki@cc.hut.fi>
  15. Hong-Gunn Chew <hglinux@gunnet.org>
  16. Jean Delvare <khali@linux-fr.org>
  17. Description
  18. -----------
  19. IMPORTANT:
  20. For the revision 0x00 chip, the in0, in1, and in2 values (+5V, +3V,
  21. and +12V) CANNOT be read. This is a limitation of the chip, not the driver.
  22. This driver supports the Genesys Logic GL518SM chip. There are at least
  23. two revision of this chip, which we call revision 0x00 and 0x80. Revision
  24. 0x80 chips support the reading of all voltages and revision 0x00 only
  25. for VIN3.
  26. The GL518SM implements one temperature sensor, two fan rotation speed
  27. sensors, and four voltage sensors. It can report alarms through the
  28. computer speakers.
  29. Temperatures are measured in degrees Celsius. An alarm goes off while the
  30. temperature is above the over temperature limit, and has not yet dropped
  31. below the hysteresis limit. The alarm always reflects the current
  32. situation. Measurements are guaranteed between -10 degrees and +110
  33. degrees, with a accuracy of +/-3 degrees.
  34. Rotation speeds are reported in RPM (rotations per minute). An alarm is
  35. triggered if the rotation speed has dropped below a programmable limit. In
  36. case when you have selected to turn fan1 off, no fan1 alarm is triggered.
  37. Fan readings can be divided by a programmable divider (1, 2, 4 or 8) to
  38. give the readings more range or accuracy. Not all RPM values can
  39. accurately be represented, so some rounding is done. With a divider
  40. of 2, the lowest representable value is around 1900 RPM.
  41. Voltage sensors (also known as VIN sensors) report their values in volts.
  42. An alarm is triggered if the voltage has crossed a programmable minimum or
  43. maximum limit. Note that minimum in this case always means 'closest to
  44. zero'; this is important for negative voltage measurements. The VDD input
  45. measures voltages between 0.000 and 5.865 volt, with a resolution of 0.023
  46. volt. The other inputs measure voltages between 0.000 and 4.845 volt, with
  47. a resolution of 0.019 volt. Note that revision 0x00 chips do not support
  48. reading the current voltage of any input except for VIN3; limit setting and
  49. alarms work fine, though.
  50. When an alarm is triggered, you can be warned by a beeping signal through your
  51. computer speaker. It is possible to enable all beeping globally, or only the
  52. beeping for some alarms.
  53. If an alarm triggers, it will remain triggered until the hardware register
  54. is read at least once (except for temperature alarms). This means that the
  55. cause for the alarm may already have disappeared! Note that in the current
  56. implementation, all hardware registers are read whenever any data is read
  57. (unless it is less than 1.5 seconds since the last update). This means that
  58. you can easily miss once-only alarms.
  59. The GL518SM only updates its values each 1.5 seconds; reading it more often
  60. will do no harm, but will return 'old' values.