^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver max31785
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) ======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Maxim MAX31785, MAX31785A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefix: 'max31785' or 'max31785a'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31785.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Author: Andrew Jeffery <andrew@aj.id.au>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) The Maxim MAX31785 is a PMBus device providing closed-loop, multi-channel fan
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) management with temperature and remote voltage sensing. Various fan control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) features are provided, including PWM frequency control, temperature hysteresis,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) dual tachometer measurements, and fan health monitoring.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) For dual-rotor configurations the MAX31785A exposes the second rotor tachometer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) readings in attributes fan[5-8]_input. By contrast the MAX31785 only exposes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) the slowest rotor measurement, and does so in the fan[1-4]_input attributes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) This driver does not probe for PMBus devices. You will have to instantiate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) devices explicitly.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Sysfs attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) ----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) fan[1-4]_alarm Fan alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) fan[1-4]_fault Fan fault.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) fan[1-8]_input Fan RPM. On the MAX31785A, inputs 5-8 correspond to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) second rotor of fans 1-4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) fan[1-4]_target Fan input target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) in[1-6]_crit Critical maximum output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) in[1-6]_crit_alarm Output voltage critical high alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) in[1-6]_input Measured output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) in[1-6]_label "vout[18-23]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) in[1-6]_lcrit Critical minimum output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) in[1-6]_lcrit_alarm Output voltage critical low alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) in[1-6]_max Maximum output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) in[1-6]_max_alarm Output voltage high alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) in[1-6]_min Minimum output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) in[1-6]_min_alarm Output voltage low alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) pwm[1-4] Fan target duty cycle (0..255)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) pwm[1-4]_enable 0: Full-speed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 1: Manual PWM control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 2: Automatic PWM (tach-feedback RPM fan-control)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 3: Automatic closed-loop (temp-feedback fan-control)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) temp[1-11]_crit Critical high temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) temp[1-11]_crit_alarm Chip temperature critical high alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) temp[1-11]_input Measured temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) temp[1-11]_max Maximum temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) temp[1-11]_max_alarm Chip temperature high alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) ======================= =======================================================