f71882fg.rst 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. Kernel driver f71882fg
  2. ======================
  3. Supported chips:
  4. * Fintek F71808E
  5. Prefix: 'f71808e'
  6. Addresses scanned: none, address read from Super I/O config space
  7. Datasheet: Not public
  8. * Fintek F71808A
  9. Prefix: 'f71808a'
  10. Addresses scanned: none, address read from Super I/O config space
  11. Datasheet: Not public
  12. * Fintek F71858FG
  13. Prefix: 'f71858fg'
  14. Addresses scanned: none, address read from Super I/O config space
  15. Datasheet: Available from the Fintek website
  16. * Fintek F71862FG and F71863FG
  17. Prefix: 'f71862fg'
  18. Addresses scanned: none, address read from Super I/O config space
  19. Datasheet: Available from the Fintek website
  20. * Fintek F71869F and F71869E
  21. Prefix: 'f71869'
  22. Addresses scanned: none, address read from Super I/O config space
  23. Datasheet: Available from the Fintek website
  24. * Fintek F71869A
  25. Prefix: 'f71869a'
  26. Addresses scanned: none, address read from Super I/O config space
  27. Datasheet: Not public
  28. * Fintek F71882FG and F71883FG
  29. Prefix: 'f71882fg'
  30. Addresses scanned: none, address read from Super I/O config space
  31. Datasheet: Available from the Fintek website
  32. * Fintek F71889FG
  33. Prefix: 'f71889fg'
  34. Addresses scanned: none, address read from Super I/O config space
  35. Datasheet: Available from the Fintek website
  36. * Fintek F71889ED
  37. Prefix: 'f71889ed'
  38. Addresses scanned: none, address read from Super I/O config space
  39. Datasheet: Should become available on the Fintek website soon
  40. * Fintek F71889A
  41. Prefix: 'f71889a'
  42. Addresses scanned: none, address read from Super I/O config space
  43. Datasheet: Should become available on the Fintek website soon
  44. * Fintek F8000
  45. Prefix: 'f8000'
  46. Addresses scanned: none, address read from Super I/O config space
  47. Datasheet: Not public
  48. * Fintek F81801U
  49. Prefix: 'f71889fg'
  50. Addresses scanned: none, address read from Super I/O config space
  51. Datasheet: Not public
  52. Note:
  53. This is the 64-pin variant of the F71889FG, they have the
  54. same device ID and are fully compatible as far as hardware
  55. monitoring is concerned.
  56. * Fintek F81865F
  57. Prefix: 'f81865f'
  58. Addresses scanned: none, address read from Super I/O config space
  59. Datasheet: Available from the Fintek website
  60. Author: Hans de Goede <hdegoede@redhat.com>
  61. Description
  62. -----------
  63. Fintek F718xx/F8000 Super I/O chips include complete hardware monitoring
  64. capabilities. They can monitor up to 9 voltages, 4 fans and 3 temperature
  65. sensors.
  66. These chips also have fan controlling features, using either DC or PWM, in
  67. three different modes (one manual, two automatic).
  68. The driver assumes that no more than one chip is present, which seems
  69. reasonable.
  70. Monitoring
  71. ----------
  72. The Voltage, Fan and Temperature Monitoring uses the standard sysfs
  73. interface as documented in sysfs-interface, without any exceptions.
  74. Fan Control
  75. -----------
  76. Both PWM (pulse-width modulation) and DC fan speed control methods are
  77. supported. The right one to use depends on external circuitry on the
  78. motherboard, so the driver assumes that the BIOS set the method
  79. properly.
  80. Note that the lowest numbered temperature zone trip point corresponds to
  81. the border between the highest and one but highest temperature zones, and
  82. vica versa. So the temperature zone trip points 1-4 (or 1-2) go from high temp
  83. to low temp! This is how things are implemented in the IC, and the driver
  84. mimics this.
  85. There are 2 modes to specify the speed of the fan, PWM duty cycle (or DC
  86. voltage) mode, where 0-100% duty cycle (0-100% of 12V) is specified. And RPM
  87. mode where the actual RPM of the fan (as measured) is controlled and the speed
  88. gets specified as 0-100% of the fan#_full_speed file.
  89. Since both modes work in a 0-100% (mapped to 0-255) scale, there isn't a
  90. whole lot of a difference when modifying fan control settings. The only
  91. important difference is that in RPM mode the 0-100% controls the fan speed
  92. between 0-100% of fan#_full_speed. It is assumed that if the BIOS programs
  93. RPM mode, it will also set fan#_full_speed properly, if it does not then
  94. fan control will not work properly, unless you set a sane fan#_full_speed
  95. value yourself.
  96. Switching between these modes requires re-initializing a whole bunch of
  97. registers, so the mode which the BIOS has set is kept. The mode is
  98. printed when loading the driver.
  99. Three different fan control modes are supported; the mode number is written
  100. to the pwm#_enable file. Note that not all modes are supported on all
  101. chips, and some modes may only be available in RPM / PWM mode.
  102. Writing an unsupported mode will result in an invalid parameter error.
  103. * 1: Manual mode
  104. You ask for a specific PWM duty cycle / DC voltage or a specific % of
  105. fan#_full_speed by writing to the pwm# file. This mode is only
  106. available on the F71858FG / F8000 if the fan channel is in RPM mode.
  107. * 2: Normal auto mode
  108. You can define a number of temperature/fan speed trip points, which % the
  109. fan should run at at this temp and which temp a fan should follow using the
  110. standard sysfs interface. The number and type of trip points is chip
  111. depended, see which files are available in sysfs.
  112. Fan/PWM channel 3 of the F8000 is always in this mode!
  113. * 3: Thermostat mode (Only available on the F8000 when in duty cycle mode)
  114. The fan speed is regulated to keep the temp the fan is mapped to between
  115. temp#_auto_point2_temp and temp#_auto_point3_temp.
  116. All of the automatic modes require that pwm1 corresponds to fan1, pwm2 to
  117. fan2 and pwm3 to fan3.