Gitiles
Code Review Sign In
review.shift-gmbh.com / SHIFTPHONES / mainline / linux / 754e0b0e35608ed5206d6a67a791563c631cec07 / . / Documentation / hwmon / tps53679.rst
blob: 3b9561648c24f508fb65c47e939c68c2c379b79e [file] [log] [blame]
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]1Kernel driver tps53679
2======================
3
4Supported chips:
5
6 * Texas Instruments TPS53647
7
8 Prefix: 'tps53647'
9
10 Addresses scanned: -
11
Alexander A. Klimovad736c12020-07-19 19:55:12 +0200[diff] [blame]12 Datasheet: https://www.ti.com/lit/gpn/tps53647
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]13
14 * Texas Instruments TPS53667
15
16 Prefix: 'tps53667'
17
18 Addresses scanned: -
19
Alexander A. Klimovad736c12020-07-19 19:55:12 +0200[diff] [blame]20 Datasheet: https://www.ti.com/lit/gpn/TPS53667
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]21
Erik Rosencb3d37b2021-03-22 20:37:34 +0100[diff] [blame]22 * Texas Instruments TPS53676
23
24 Prefix: 'tps53676'
25
26 Addresses scanned: -
27
28 Datasheet: https://www.ti.com/lit/gpn/TPS53676
29
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]30 * Texas Instruments TPS53679
31
32 Prefix: 'tps53679'
33
34 Addresses scanned: -
35
Alexander A. Klimovad736c12020-07-19 19:55:12 +0200[diff] [blame]36 Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version)
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]37
38 * Texas Instruments TPS53681
39
40 Prefix: 'tps53681'
41
42 Addresses scanned: -
43
Alexander A. Klimovad736c12020-07-19 19:55:12 +0200[diff] [blame]44 Datasheet: https://www.ti.com/lit/gpn/TPS53681
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]45
46 * Texas Instruments TPS53688
47
48 Prefix: 'tps53688'
49
50 Addresses scanned: -
51
52 Datasheet: Available under NDA
53
54
55Authors:
56 Vadim Pasternak <vadimp@mellanox.com>
57 Guenter Roeck <linux@roeck-us.net>
58
59
60Description
61-----------
62
63Chips in this series are multi-phase step-down converters with one or two
64output channels and up to 8 phases per channel.
65
66
67Usage Notes
68-----------
69
70This driver does not probe for PMBus devices. You will have to instantiate
71devices explicitly.
72
73Example: the following commands will load the driver for an TPS53681 at address
740x60 on I2C bus #1::
75
76 # modprobe tps53679
77 # echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
78
79
80Sysfs attributes
81----------------
82
83======================= ========================================================
84in1_label "vin"
85
86in1_input Measured input voltage.
87
88in1_lcrit Critical minimum input voltage
89
90 TPS53679, TPS53681, TPS53688 only.
91
92in1_lcrit_alarm Input voltage critical low alarm.
93
94 TPS53679, TPS53681, TPS53688 only.
95
96in1_crit Critical maximum input voltage.
97
98in1_crit_alarm Input voltage critical high alarm.
99
100in[N]_label "vout[1-2]"
101
102 - TPS53647, TPS53667: N=2
103 - TPS53679, TPS53588: N=2,3
104
105in[N]_input Measured output voltage.
106
107in[N]_lcrit Critical minimum input voltage.
108
109 TPS53679, TPS53681, TPS53688 only.
110
111in[N]_lcrit_alarm Critical minimum voltage alarm.
112
113 TPS53679, TPS53681, TPS53688 only.
114
115in[N]_alarm Output voltage alarm.
116
117 TPS53647, TPS53667 only.
118
119in[N]_crit Critical maximum output voltage.
120
121 TPS53679, TPS53681, TPS53688 only.
122
123in[N]_crit_alarm Output voltage critical high alarm.
124
125 TPS53679, TPS53681, TPS53688 only.
126
127temp[N]_input Measured temperature.
128
129 - TPS53647, TPS53667: N=1
130 - TPS53679, TPS53681, TPS53588: N=1,2
131
132temp[N]_max Maximum temperature.
133
134temp[N]_crit Critical high temperature.
135
136temp[N]_max_alarm Temperature high alarm.
137
138temp[N]_crit_alarm Temperature critical high alarm.
139
140power1_label "pin".
141
142power1_input Measured input power.
143
144power[N]_label "pout[1-2]".
145
146 - TPS53647, TPS53667: N=2
Erik Rosencb3d37b2021-03-22 20:37:34 +0100[diff] [blame]147 - TPS53676, TPS53679, TPS53681, TPS53588: N=2,3
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]148
149power[N]_input Measured output power.
150
151curr1_label "iin".
152
153curr1_input Measured input current.
154
155curr1_max Maximum input current.
156
157curr1_max_alarm Input current high alarm.
158
159curr1_crit Critical input current.
160
161curr1_crit_alarm Input current critical alarm.
162
163curr[N]_label "iout[1-2]" or "iout1.[0-5]".
164
165 The first digit is the output channel, the second
166 digit is the phase within the channel. Per-phase
Erik Rosencb3d37b2021-03-22 20:37:34 +0100[diff] [blame]167 telemetry supported on TPS53676 and TPS53681 only.
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]168
169 - TPS53647, TPS53667: N=2
170 - TPS53679, TPS53588: N=2,3
Erik Rosencb3d37b2021-03-22 20:37:34 +0100[diff] [blame]171 - TPS53676: N=2-8
Guenter Roeck6f4a0da2020-02-01 08:24:47 -0800[diff] [blame]172 - TPS53681: N=2-9
173
174curr[N]_input Measured output current.
175
176curr[N]_max Maximum output current.
177
178curr[N]_crit Critical high output current.
179
180curr[N]_max_alarm Output current high alarm.
181
182curr[N]_crit_alarm Output current critical high alarm.
183
184 Limit and alarm attributes are only available for
185 non-phase telemetry (iout1, iout2).
186
187======================= ========================================================