tps53679.rst

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