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