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