xref: /openbmc/linux/Documentation/hwmon/lt7182s.rst (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1*e10d9e4cSGuenter Roeck.. SPDX-License-Identifier: GPL-2.0
2*e10d9e4cSGuenter Roeck
3*e10d9e4cSGuenter RoeckKernel driver lt7182s
4*e10d9e4cSGuenter Roeck=====================
5*e10d9e4cSGuenter Roeck
6*e10d9e4cSGuenter RoeckSupported chips:
7*e10d9e4cSGuenter Roeck
8*e10d9e4cSGuenter Roeck  * ADI LT7182S
9*e10d9e4cSGuenter Roeck
10*e10d9e4cSGuenter Roeck    Prefix: 'lt7182s'
11*e10d9e4cSGuenter Roeck
12*e10d9e4cSGuenter Roeck    Addresses scanned: -
13*e10d9e4cSGuenter Roeck
14*e10d9e4cSGuenter Roeck    Datasheet: https://www.analog.com/en/products/lt7182s.html
15*e10d9e4cSGuenter Roeck
16*e10d9e4cSGuenter RoeckAuthor: Guenter Roeck <linux@roeck-us.net>
17*e10d9e4cSGuenter Roeck
18*e10d9e4cSGuenter Roeck
19*e10d9e4cSGuenter RoeckDescription
20*e10d9e4cSGuenter Roeck-----------
21*e10d9e4cSGuenter Roeck
22*e10d9e4cSGuenter RoeckLT7182S is a Dual Channel 6A, 20V PolyPhase Step-Down Silent Switcher with
23*e10d9e4cSGuenter RoeckDigital Power System Management support.
24*e10d9e4cSGuenter Roeck
25*e10d9e4cSGuenter Roeck
26*e10d9e4cSGuenter RoeckUsage Notes
27*e10d9e4cSGuenter Roeck-----------
28*e10d9e4cSGuenter Roeck
29*e10d9e4cSGuenter RoeckThis driver does not probe for PMBus devices. You will have to instantiate
30*e10d9e4cSGuenter Roeckdevices explicitly.
31*e10d9e4cSGuenter Roeck
32*e10d9e4cSGuenter RoeckExample: the following commands will load the driver for a LT7182S
33*e10d9e4cSGuenter Roeckat address 0x4f on I2C bus #4::
34*e10d9e4cSGuenter Roeck
35*e10d9e4cSGuenter Roeck    # modprobe lt7182s
36*e10d9e4cSGuenter Roeck    # echo lt7182s 0x4f > /sys/bus/i2c/devices/i2c-4/new_device
37*e10d9e4cSGuenter Roeck
38*e10d9e4cSGuenter RoeckIt can also be instantiated by declaring an entry in device tree.
39*e10d9e4cSGuenter Roeck
40*e10d9e4cSGuenter Roeck
41*e10d9e4cSGuenter RoeckSysfs attributes
42*e10d9e4cSGuenter Roeck----------------
43*e10d9e4cSGuenter Roeck
44*e10d9e4cSGuenter Roeck======================= ====================================
45*e10d9e4cSGuenter Roeckcurr[1-2]_label		"iin[12]"
46*e10d9e4cSGuenter Roeckcurr[1-2]_input		Measured input current
47*e10d9e4cSGuenter Roeckcurr[1-2]_max		Maximum input current
48*e10d9e4cSGuenter Roeckcurr[1-2]_max_alarm	Current high alarm
49*e10d9e4cSGuenter Roeck
50*e10d9e4cSGuenter Roeckcurr[3-4]_label		"iout[1-2]"
51*e10d9e4cSGuenter Roeckcurr[3-4]_input		Measured output current
52*e10d9e4cSGuenter Roeckcurr[3-4]_highest	Highest measured output current
53*e10d9e4cSGuenter Roeckcurr[3-4]_max		Maximum output current
54*e10d9e4cSGuenter Roeckcurr[3-4]_max_alarm	Output current high alarm
55*e10d9e4cSGuenter Roeck
56*e10d9e4cSGuenter Roeckin[1-2]_label		"vin[12]"
57*e10d9e4cSGuenter Roeckin[1-2]_input		Measured input voltage
58*e10d9e4cSGuenter Roeckin[1-2]_highest		Highest measured input voltage
59*e10d9e4cSGuenter Roeckin[1-2]_crit		Critical maximum input voltage
60*e10d9e4cSGuenter Roeckin[1-2]_crit_alarm	Input voltage critical high alarm
61*e10d9e4cSGuenter Roeckin[1-2]_min		Minimum input voltage
62*e10d9e4cSGuenter Roeckin[1-2]_min_alarm	Input voltage low alarm
63*e10d9e4cSGuenter Roeckin[1-2]_rated_min	Rated minimum input voltage
64*e10d9e4cSGuenter Roeckin[1-2]_rated_max	Rated maximum input voltage
65*e10d9e4cSGuenter Roeckin1_reset_history	Write to reset history for all attributes
66*e10d9e4cSGuenter Roeck
67*e10d9e4cSGuenter Roeckin[3-5]_label		"vmon[1-3]"
68*e10d9e4cSGuenter Roeckin[3-5]_input		Measured voltage on ITH1/ITH2/EXTVCC pins
69*e10d9e4cSGuenter Roeck			Only available if enabled with MFR_ADC_CONTROL_LT7182S
70*e10d9e4cSGuenter Roeck			command.
71*e10d9e4cSGuenter Roeck
72*e10d9e4cSGuenter Roeckin[3-4|6-7]_label	"vout[1-2]"
73*e10d9e4cSGuenter Roeckin[3-4|6-7]_input	Measured output voltage
74*e10d9e4cSGuenter Roeckin[3-4|6-7]_highest	Highest measured output voltage
75*e10d9e4cSGuenter Roeckin[3-4|6-7]_lcrit	Critical minimum output voltage
76*e10d9e4cSGuenter Roeckin[3-4|6-7]_lcrit_alarm	Output voltage critical low alarm
77*e10d9e4cSGuenter Roeckin[3-4|6-7]_min		Minimum output voltage
78*e10d9e4cSGuenter Roeckin[3-4|6-7]_max_alarm	Output voltage low alarm
79*e10d9e4cSGuenter Roeckin[3-4|6-7]_max		Maximum output voltage
80*e10d9e4cSGuenter Roeckin[3-4|6-7]_max_alarm	Output voltage high alarm
81*e10d9e4cSGuenter Roeckin[3-4|6-7]_crit	Critical maximum output voltage
82*e10d9e4cSGuenter Roeckin[3-4|6-7]_crit_alarm	Output voltage critical high alarm
83*e10d9e4cSGuenter Roeck
84*e10d9e4cSGuenter Roeckpower[1-2]_label	"pout[1-2]"
85*e10d9e4cSGuenter Roeckpower[1-2]_input	Measured output power
86*e10d9e4cSGuenter Roeck
87*e10d9e4cSGuenter Roecktemp1_input		Measured temperature
88*e10d9e4cSGuenter Roecktemp1_crit		Critical high temperature
89*e10d9e4cSGuenter Roecktemp1_crit_alarm	Chip temperature critical high alarm
90*e10d9e4cSGuenter Roecktemp1_max		Maximum temperature
91*e10d9e4cSGuenter Roecktemp1_max_alarm		Chip temperature high alarm
92*e10d9e4cSGuenter Roeck======================= ====================================
93