hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
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).
 
======================= ========================================================