xref: /linux/Documentation/hwmon/sq24860.rst (revision 7acf90feab8b009fde7def08ff2c622d0f10e99f)
1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver sq24860
4=====================
5
6Supported chips:
7
8  * Silergy SQ24860
9
10    Prefix: 'sq24860'
11
12Author:
13
14	Ziming Zhu <ziming.zhu@silergycorp.com>
15
16Description
17------------
18
19This driver implements support for the Silergy SQ24860 eFuse. The device is an
20integrated circuit protection and power management device with a PMBus
21interface.
22
23The device supports direct format for reading input voltage, output voltage,
24auxiliary voltage, input current, input power, and temperature.
25
26The current and power measurement scale depends on the resistor connected
27between the IMON pin and ground. The resistor value can be configured with the
28``silergy,rimon-micro-ohms`` device tree property. See
29``Documentation/devicetree/bindings/hwmon/pmbus/silergy,sq24860.yaml`` for details.
30
31Due to the specificities of the chip, all history reset attributes are tied
32together. Resetting the history of one sensor resets the history of all sensors.
33
34Sysfs entries
35-------------
36
37The following attributes are supported. Limits are read-write; all other
38attributes are read-only.
39
40======================= ======================================================
41in1_label               "vin"
42in1_input               Measured input voltage.
43in1_average             Average measured input voltage.
44in1_min                 Minimum input voltage limit.
45in1_lcrit               Critical low input voltage limit.
46in1_max                 Maximum input voltage limit.
47in1_crit                Critical high input voltage limit.
48in1_min_alarm           Input voltage low warning alarm.
49in1_lcrit_alarm         Input voltage low fault alarm.
50in1_max_alarm           Input voltage high warning alarm.
51in1_crit_alarm          Input voltage high fault alarm.
52in1_highest             Historical maximum input voltage.
53in1_lowest              Historical minimum input voltage.
54in1_reset_history       Write any value to reset history.
55
56in2_label               "vmon"
57in2_input               Measured auxiliary input voltage.
58
59in3_label               "vout1"
60in3_input               Measured output voltage.
61in3_average             Average measured output voltage.
62in3_min                 Minimum output voltage limit.
63in3_min_alarm           Output voltage low alarm.
64in3_lowest              Historical minimum output voltage.
65in3_reset_history       Write any value to reset history.
66
67curr1_label             "iin"
68curr1_input             Measured input current.
69curr1_average           Average measured input current.
70curr1_max               Maximum input current warning limit.
71curr1_crit              Critical input over-current fault limit.
72curr1_max_alarm         Input current warning alarm.
73curr1_crit_alarm        Input over-current fault alarm.
74curr1_highest           Historical maximum input current.
75curr1_reset_history     Write any value to reset history.
76
77power1_label            "pin"
78power1_input            Measured input power.
79power1_average          Average measured input power.
80power1_max              Maximum input power warning limit.
81power1_alarm            Input power warning alarm.
82power1_input_highest    Historical maximum input power.
83power1_reset_history    Write any value to reset history.
84
85temp1_input             Measured temperature.
86temp1_average           Average measured temperature.
87temp1_max               Maximum temperature warning limit.
88temp1_crit              Critical temperature fault limit.
89temp1_max_alarm         Temperature warning alarm.
90temp1_crit_alarm        Temperature fault alarm.
91temp1_highest           Historical maximum temperature.
92temp1_reset_history     Write any value to reset history.
93
94samples                 Number of samples used for average values.
95======================= ======================================================
96
97