kfan.rst 1.3 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. .. SPDX-License-Identifier: GPL-2.0
  2. Kernel driver kfan
  3. ==================
  4. Supported chips:
  5. * KEBA fan controller (IP core in FPGA)
  6. Prefix: 'kfan'
  7. Authors:
  8. Gerhard Engleder <eg@keba.com>
  9. Petar Bojanic <boja@keba.com>
  10. Description
  11. -----------
  12. The KEBA fan controller is an IP core for FPGAs, which monitors the health
  13. and controls the speed of a fan. The fan is typically used to cool the CPU
  14. and the whole device. E.g., the CP500 FPGA includes this IP core to monitor
  15. and control the fan of PLCs and the corresponding cp500 driver creates an
  16. auxiliary device for the kfan driver.
  17. This driver provides information about the fan health to user space.
  18. The user space shall be informed if the fan is removed or blocked.
  19. Additionally, the speed in RPM is reported for fans with tacho signal.
  20. For fan control PWM is supported. For PWM 255 equals 100%. None-regulable
  21. fans can be turned on with PWM 255 and turned off with PWM 0.
  22. ====================== ==== ===================================================
  23. Attribute R/W Contents
  24. ====================== ==== ===================================================
  25. fan1_fault R Fan fault
  26. fan1_input R Fan tachometer input (in RPM)
  27. pwm1 RW Fan target duty cycle (0..255)
  28. ====================== ==== ===================================================