xref: /linux/Documentation/hwmon/sq24860.rst (revision 7acf90feab8b009fde7def08ff2c622d0f10e99f)
1*efd053e3SZiming Zhu.. SPDX-License-Identifier: GPL-2.0
2*efd053e3SZiming Zhu
3*efd053e3SZiming ZhuKernel driver sq24860
4*efd053e3SZiming Zhu=====================
5*efd053e3SZiming Zhu
6*efd053e3SZiming ZhuSupported chips:
7*efd053e3SZiming Zhu
8*efd053e3SZiming Zhu  * Silergy SQ24860
9*efd053e3SZiming Zhu
10*efd053e3SZiming Zhu    Prefix: 'sq24860'
11*efd053e3SZiming Zhu
12*efd053e3SZiming ZhuAuthor:
13*efd053e3SZiming Zhu
14*efd053e3SZiming Zhu	Ziming Zhu <ziming.zhu@silergycorp.com>
15*efd053e3SZiming Zhu
16*efd053e3SZiming ZhuDescription
17*efd053e3SZiming Zhu------------
18*efd053e3SZiming Zhu
19*efd053e3SZiming ZhuThis driver implements support for the Silergy SQ24860 eFuse. The device is an
20*efd053e3SZiming Zhuintegrated circuit protection and power management device with a PMBus
21*efd053e3SZiming Zhuinterface.
22*efd053e3SZiming Zhu
23*efd053e3SZiming ZhuThe device supports direct format for reading input voltage, output voltage,
24*efd053e3SZiming Zhuauxiliary voltage, input current, input power, and temperature.
25*efd053e3SZiming Zhu
26*efd053e3SZiming ZhuThe current and power measurement scale depends on the resistor connected
27*efd053e3SZiming Zhubetween the IMON pin and ground. The resistor value can be configured with the
28*efd053e3SZiming Zhu``silergy,rimon-micro-ohms`` device tree property. See
29*efd053e3SZiming Zhu``Documentation/devicetree/bindings/hwmon/pmbus/silergy,sq24860.yaml`` for details.
30*efd053e3SZiming Zhu
31*efd053e3SZiming ZhuDue to the specificities of the chip, all history reset attributes are tied
32*efd053e3SZiming Zhutogether. Resetting the history of one sensor resets the history of all sensors.
33*efd053e3SZiming Zhu
34*efd053e3SZiming ZhuSysfs entries
35*efd053e3SZiming Zhu-------------
36*efd053e3SZiming Zhu
37*efd053e3SZiming ZhuThe following attributes are supported. Limits are read-write; all other
38*efd053e3SZiming Zhuattributes are read-only.
39*efd053e3SZiming Zhu
40*efd053e3SZiming Zhu======================= ======================================================
41*efd053e3SZiming Zhuin1_label               "vin"
42*efd053e3SZiming Zhuin1_input               Measured input voltage.
43*efd053e3SZiming Zhuin1_average             Average measured input voltage.
44*efd053e3SZiming Zhuin1_min                 Minimum input voltage limit.
45*efd053e3SZiming Zhuin1_lcrit               Critical low input voltage limit.
46*efd053e3SZiming Zhuin1_max                 Maximum input voltage limit.
47*efd053e3SZiming Zhuin1_crit                Critical high input voltage limit.
48*efd053e3SZiming Zhuin1_min_alarm           Input voltage low warning alarm.
49*efd053e3SZiming Zhuin1_lcrit_alarm         Input voltage low fault alarm.
50*efd053e3SZiming Zhuin1_max_alarm           Input voltage high warning alarm.
51*efd053e3SZiming Zhuin1_crit_alarm          Input voltage high fault alarm.
52*efd053e3SZiming Zhuin1_highest             Historical maximum input voltage.
53*efd053e3SZiming Zhuin1_lowest              Historical minimum input voltage.
54*efd053e3SZiming Zhuin1_reset_history       Write any value to reset history.
55*efd053e3SZiming Zhu
56*efd053e3SZiming Zhuin2_label               "vmon"
57*efd053e3SZiming Zhuin2_input               Measured auxiliary input voltage.
58*efd053e3SZiming Zhu
59*efd053e3SZiming Zhuin3_label               "vout1"
60*efd053e3SZiming Zhuin3_input               Measured output voltage.
61*efd053e3SZiming Zhuin3_average             Average measured output voltage.
62*efd053e3SZiming Zhuin3_min                 Minimum output voltage limit.
63*efd053e3SZiming Zhuin3_min_alarm           Output voltage low alarm.
64*efd053e3SZiming Zhuin3_lowest              Historical minimum output voltage.
65*efd053e3SZiming Zhuin3_reset_history       Write any value to reset history.
66*efd053e3SZiming Zhu
67*efd053e3SZiming Zhucurr1_label             "iin"
68*efd053e3SZiming Zhucurr1_input             Measured input current.
69*efd053e3SZiming Zhucurr1_average           Average measured input current.
70*efd053e3SZiming Zhucurr1_max               Maximum input current warning limit.
71*efd053e3SZiming Zhucurr1_crit              Critical input over-current fault limit.
72*efd053e3SZiming Zhucurr1_max_alarm         Input current warning alarm.
73*efd053e3SZiming Zhucurr1_crit_alarm        Input over-current fault alarm.
74*efd053e3SZiming Zhucurr1_highest           Historical maximum input current.
75*efd053e3SZiming Zhucurr1_reset_history     Write any value to reset history.
76*efd053e3SZiming Zhu
77*efd053e3SZiming Zhupower1_label            "pin"
78*efd053e3SZiming Zhupower1_input            Measured input power.
79*efd053e3SZiming Zhupower1_average          Average measured input power.
80*efd053e3SZiming Zhupower1_max              Maximum input power warning limit.
81*efd053e3SZiming Zhupower1_alarm            Input power warning alarm.
82*efd053e3SZiming Zhupower1_input_highest    Historical maximum input power.
83*efd053e3SZiming Zhupower1_reset_history    Write any value to reset history.
84*efd053e3SZiming Zhu
85*efd053e3SZiming Zhutemp1_input             Measured temperature.
86*efd053e3SZiming Zhutemp1_average           Average measured temperature.
87*efd053e3SZiming Zhutemp1_max               Maximum temperature warning limit.
88*efd053e3SZiming Zhutemp1_crit              Critical temperature fault limit.
89*efd053e3SZiming Zhutemp1_max_alarm         Temperature warning alarm.
90*efd053e3SZiming Zhutemp1_crit_alarm        Temperature fault alarm.
91*efd053e3SZiming Zhutemp1_highest           Historical maximum temperature.
92*efd053e3SZiming Zhutemp1_reset_history     Write any value to reset history.
93*efd053e3SZiming Zhu
94*efd053e3SZiming Zhusamples                 Number of samples used for average values.
95*efd053e3SZiming Zhu======================= ======================================================
96*efd053e3SZiming Zhu
97