xref: /linux/Documentation/hwmon/vt7505.rst (revision 7acf90feab8b009fde7def08ff2c622d0f10e99f) 
1*97c1723aSGeorgi Vlaev.. SPDX-License-Identifier: GPL-2.0
2*97c1723aSGeorgi Vlaev
3*97c1723aSGeorgi VlaevKernel driver vt7505
4*97c1723aSGeorgi Vlaev====================
5*97c1723aSGeorgi Vlaev
6*97c1723aSGeorgi VlaevSupported chips:
7*97c1723aSGeorgi Vlaev
8*97c1723aSGeorgi Vlaev  * Analog Devices MAX16545
9*97c1723aSGeorgi Vlaev
10*97c1723aSGeorgi Vlaev    Prefix: 'max16545'
11*97c1723aSGeorgi Vlaev
12*97c1723aSGeorgi Vlaev    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max16545b-max16545c.pdf
13*97c1723aSGeorgi Vlaev
14*97c1723aSGeorgi Vlaev  * Analog Devices MAX16550
15*97c1723aSGeorgi Vlaev
16*97c1723aSGeorgi Vlaev    Prefix: 'max16550'
17*97c1723aSGeorgi Vlaev
18*97c1723aSGeorgi Vlaev    Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max16550.pdf
19*97c1723aSGeorgi Vlaev
20*97c1723aSGeorgi Vlaev  * Volterra VT7505
21*97c1723aSGeorgi Vlaev
22*97c1723aSGeorgi Vlaev    Prefix: 'vt7505'
23*97c1723aSGeorgi Vlaev
24*97c1723aSGeorgi Vlaev    Datasheet: Not publicly available; register-compatible with the MAX16545.
25*97c1723aSGeorgi Vlaev
26*97c1723aSGeorgi VlaevAuthor: Georgi Vlaev <gvlaev@juniper.net>
27*97c1723aSGeorgi Vlaev
28*97c1723aSGeorgi VlaevDescription
29*97c1723aSGeorgi Vlaev-----------
30*97c1723aSGeorgi Vlaev
31*97c1723aSGeorgi VlaevThis driver supports hardware monitoring for the Analog Devices MAX16545 and
32*97c1723aSGeorgi VlaevMAX16550, and the Volterra VT7505 PMBus controllers.
33*97c1723aSGeorgi Vlaev
34*97c1723aSGeorgi VlaevThe devices report input and output voltage, input and output current,
35*97c1723aSGeorgi Vlaevinput power, and temperature. All values use the PMBus direct data format.
36*97c1723aSGeorgi VlaevPeak (maximum) values for input voltage, output voltage, output current,
37*97c1723aSGeorgi Vlaevinput power and temperature are exposed and can be reset. Writing to any
38*97c1723aSGeorgi Vlaev``*_reset_history`` attribute clears all of the device's peak values.
39*97c1723aSGeorgi Vlaev
40*97c1723aSGeorgi VlaevThe reported current and power values depend on the resistance of the
41*97c1723aSGeorgi Vlaevexternal current-report resistor connected between the ILOAD pin and
42*97c1723aSGeorgi Vlaevground. This resistance can be provided via the ``adi,rload-ohms``
43*97c1723aSGeorgi Vlaevdevice tree property; a default of 4750 ohms is used when it is absent.
44*97c1723aSGeorgi Vlaev
45*97c1723aSGeorgi VlaevSysfs entries
46*97c1723aSGeorgi Vlaev-------------
47*97c1723aSGeorgi Vlaev
48*97c1723aSGeorgi VlaevThe limit and alarm attributes are created by the PMBus core for the limit
49*97c1723aSGeorgi Vlaevregisters that the device implements. See
50*97c1723aSGeorgi VlaevDocumentation/hwmon/sysfs-interface.rst for the meaning of each attribute.
51*97c1723aSGeorgi Vlaev
52*97c1723aSGeorgi Vlaev======================= ========================================================
53*97c1723aSGeorgi Vlaevin1_label               "vin"
54*97c1723aSGeorgi Vlaevin1_input               Measured input voltage.
55*97c1723aSGeorgi Vlaevin1_min                 Input undervoltage warning limit.
56*97c1723aSGeorgi Vlaevin1_min_alarm           Input undervoltage warning alarm.
57*97c1723aSGeorgi Vlaevin1_lcrit               Input undervoltage fault limit.
58*97c1723aSGeorgi Vlaevin1_lcrit_alarm         Input undervoltage fault alarm.
59*97c1723aSGeorgi Vlaevin1_highest             Historical maximum input voltage.
60*97c1723aSGeorgi Vlaevin1_reset_history       Write to reset all peak values.
61*97c1723aSGeorgi Vlaevin2_label               "vout1"
62*97c1723aSGeorgi Vlaevin2_input               Measured output voltage.
63*97c1723aSGeorgi Vlaevin2_min                 Output undervoltage warning limit.
64*97c1723aSGeorgi Vlaevin2_min_alarm           Output undervoltage warning alarm.
65*97c1723aSGeorgi Vlaevin2_highest             Historical maximum output voltage.
66*97c1723aSGeorgi Vlaevin2_reset_history       Write to reset all peak values.
67*97c1723aSGeorgi Vlaevcurr1_label             "iin"
68*97c1723aSGeorgi Vlaevcurr1_input             Measured input current.
69*97c1723aSGeorgi Vlaevcurr1_alarm             Input current alarm.
70*97c1723aSGeorgi Vlaevcurr2_label             "iout1"
71*97c1723aSGeorgi Vlaevcurr2_input             Measured output current.
72*97c1723aSGeorgi Vlaevcurr2_max               Output overcurrent warning limit.
73*97c1723aSGeorgi Vlaevcurr2_max_alarm         Output overcurrent warning alarm.
74*97c1723aSGeorgi Vlaevcurr2_highest           Historical maximum output current.
75*97c1723aSGeorgi Vlaevcurr2_reset_history     Write to reset all peak values.
76*97c1723aSGeorgi Vlaevpower1_label            "pin"
77*97c1723aSGeorgi Vlaevpower1_input            Measured input power.
78*97c1723aSGeorgi Vlaevpower1_max              Input overpower warning limit.
79*97c1723aSGeorgi Vlaevpower1_alarm            Input overpower warning alarm.
80*97c1723aSGeorgi Vlaevpower1_input_highest    Historical maximum input power.
81*97c1723aSGeorgi Vlaevpower1_reset_history    Write to reset all peak values.
82*97c1723aSGeorgi Vlaevtemp1_input             Measured temperature.
83*97c1723aSGeorgi Vlaevtemp1_max               Overtemperature warning limit.
84*97c1723aSGeorgi Vlaevtemp1_max_alarm         Overtemperature warning alarm.
85*97c1723aSGeorgi Vlaevtemp1_crit              Overtemperature fault limit.
86*97c1723aSGeorgi Vlaevtemp1_crit_alarm        Overtemperature fault alarm.
87*97c1723aSGeorgi Vlaevtemp1_highest           Historical maximum temperature.
88*97c1723aSGeorgi Vlaevtemp1_reset_history     Write to reset all peak values.
89*97c1723aSGeorgi Vlaev======================= ========================================================
90