summaryrefslogtreecommitdiff
path: root/Documentation/hwmon/tps53679.rst
blob: c7c589e4978918ef8cfa555d6293001422e1cb28 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
Kernel driver tps53679
======================

Supported chips:

  * Texas Instruments TPS53647

    Prefix: 'tps53647'

    Addresses scanned: -

    Datasheet: https://www.ti.com/lit/gpn/tps53647

  * Texas Instruments TPS53667

    Prefix: 'tps53667'

    Addresses scanned: -

    Datasheet: https://www.ti.com/lit/gpn/TPS53667

  * Texas Instruments TPS53679

    Prefix: 'tps53679'

    Addresses scanned: -

    Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version)

  * Texas Instruments TPS53681

    Prefix: 'tps53681'

    Addresses scanned: -

    Datasheet: https://www.ti.com/lit/gpn/TPS53681

  * Texas Instruments TPS53688

    Prefix: 'tps53688'

    Addresses scanned: -

    Datasheet: Available under NDA


Authors:
	Vadim Pasternak <vadimp@mellanox.com>
	Guenter Roeck <linux@roeck-us.net>


Description
-----------

Chips in this series are multi-phase step-down converters with one or two
output channels and up to 8 phases per channel.


Usage Notes
-----------

This driver does not probe for PMBus devices. You will have to instantiate
devices explicitly.

Example: the following commands will load the driver for an TPS53681 at address
0x60 on I2C bus #1::

	# modprobe tps53679
	# echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device


Sysfs attributes
----------------

======================= ========================================================
in1_label		"vin"

in1_input		Measured input voltage.

in1_lcrit		Critical minimum input voltage

			TPS53679, TPS53681, TPS53688 only.

in1_lcrit_alarm		Input voltage critical low alarm.

			TPS53679, TPS53681, TPS53688 only.

in1_crit		Critical maximum input voltage.

in1_crit_alarm		Input voltage critical high alarm.

in[N]_label		"vout[1-2]"

			- TPS53647, TPS53667: N=2
			- TPS53679, TPS53588: N=2,3

in[N]_input		Measured output voltage.

in[N]_lcrit		Critical minimum input voltage.

			TPS53679, TPS53681, TPS53688 only.

in[N]_lcrit_alarm	Critical minimum voltage alarm.

			TPS53679, TPS53681, TPS53688 only.

in[N]_alarm		Output voltage alarm.

			TPS53647, TPS53667 only.

in[N]_crit		Critical maximum output voltage.

			TPS53679, TPS53681, TPS53688 only.

in[N]_crit_alarm	Output voltage critical high alarm.

			TPS53679, TPS53681, TPS53688 only.

temp[N]_input		Measured temperature.

			- TPS53647, TPS53667: N=1
			- TPS53679, TPS53681, TPS53588: N=1,2

temp[N]_max		Maximum temperature.

temp[N]_crit		Critical high temperature.

temp[N]_max_alarm	Temperature high alarm.

temp[N]_crit_alarm	Temperature critical high alarm.

power1_label		"pin".

power1_input		Measured input power.

power[N]_label		"pout[1-2]".

			- TPS53647, TPS53667: N=2
			- TPS53679, TPS53681, TPS53588: N=2,3

power[N]_input		Measured output power.

curr1_label		"iin".

curr1_input		Measured input current.

curr1_max		Maximum input current.

curr1_max_alarm		Input current high alarm.

curr1_crit		Critical input current.

curr1_crit_alarm	Input current critical alarm.

curr[N]_label		"iout[1-2]" or "iout1.[0-5]".

			The first digit is the output channel, the second
			digit is the phase within the channel. Per-phase
			telemetry supported on TPS53681 only.

			- TPS53647, TPS53667: N=2
			- TPS53679, TPS53588: N=2,3
			- TPS53681: N=2-9

curr[N]_input		Measured output current.

curr[N]_max		Maximum output current.

curr[N]_crit		Critical high output current.

curr[N]_max_alarm	Output current high alarm.

curr[N]_crit_alarm	Output current critical high alarm.

			Limit and alarm attributes are only available for
			non-phase telemetry (iout1, iout2).

======================= ========================================================