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