xref: /linux/Documentation/hwmon/vt7505.rst (revision 7acf90feab8b009fde7def08ff2c622d0f10e99f)
1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver vt7505
4====================
5
6Supported chips:
7
8  * Analog Devices MAX16545
9
10    Prefix: 'max16545'
11
12    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max16545b-max16545c.pdf
13
14  * Analog Devices MAX16550
15
16    Prefix: 'max16550'
17
18    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max16550.pdf
19
20  * Volterra VT7505
21
22    Prefix: 'vt7505'
23
24    Datasheet: Not publicly available; register-compatible with the MAX16545.
25
26Author: Georgi Vlaev <gvlaev@juniper.net>
27
28Description
29-----------
30
31This driver supports hardware monitoring for the Analog Devices MAX16545 and
32MAX16550, and the Volterra VT7505 PMBus controllers.
33
34The devices report input and output voltage, input and output current,
35input power, and temperature. All values use the PMBus direct data format.
36Peak (maximum) values for input voltage, output voltage, output current,
37input power and temperature are exposed and can be reset. Writing to any
38``*_reset_history`` attribute clears all of the device's peak values.
39
40The reported current and power values depend on the resistance of the
41external current-report resistor connected between the ILOAD pin and
42ground. This resistance can be provided via the ``adi,rload-ohms``
43device tree property; a default of 4750 ohms is used when it is absent.
44
45Sysfs entries
46-------------
47
48The limit and alarm attributes are created by the PMBus core for the limit
49registers that the device implements. See
50Documentation/hwmon/sysfs-interface.rst for the meaning of each attribute.
51
52======================= ========================================================
53in1_label               "vin"
54in1_input               Measured input voltage.
55in1_min                 Input undervoltage warning limit.
56in1_min_alarm           Input undervoltage warning alarm.
57in1_lcrit               Input undervoltage fault limit.
58in1_lcrit_alarm         Input undervoltage fault alarm.
59in1_highest             Historical maximum input voltage.
60in1_reset_history       Write to reset all peak values.
61in2_label               "vout1"
62in2_input               Measured output voltage.
63in2_min                 Output undervoltage warning limit.
64in2_min_alarm           Output undervoltage warning alarm.
65in2_highest             Historical maximum output voltage.
66in2_reset_history       Write to reset all peak values.
67curr1_label             "iin"
68curr1_input             Measured input current.
69curr1_alarm             Input current alarm.
70curr2_label             "iout1"
71curr2_input             Measured output current.
72curr2_max               Output overcurrent warning limit.
73curr2_max_alarm         Output overcurrent warning alarm.
74curr2_highest           Historical maximum output current.
75curr2_reset_history     Write to reset all peak values.
76power1_label            "pin"
77power1_input            Measured input power.
78power1_max              Input overpower warning limit.
79power1_alarm            Input overpower warning alarm.
80power1_input_highest    Historical maximum input power.
81power1_reset_history    Write to reset all peak values.
82temp1_input             Measured temperature.
83temp1_max               Overtemperature warning limit.
84temp1_max_alarm         Overtemperature warning alarm.
85temp1_crit              Overtemperature fault limit.
86temp1_crit_alarm        Overtemperature fault alarm.
87temp1_highest           Historical maximum temperature.
88temp1_reset_history     Write to reset all peak values.
89======================= ========================================================
90