]>
Commit | Line | Data |
---|---|---|
ad7f8a1f DA |
1 | /* |
2 | * Copyright © 2014 Red Hat. | |
3 | * | |
4 | * Permission to use, copy, modify, distribute, and sell this software and its | |
5 | * documentation for any purpose is hereby granted without fee, provided that | |
6 | * the above copyright notice appear in all copies and that both that copyright | |
7 | * notice and this permission notice appear in supporting documentation, and | |
8 | * that the name of the copyright holders not be used in advertising or | |
9 | * publicity pertaining to distribution of the software without specific, | |
10 | * written prior permission. The copyright holders make no representations | |
11 | * about the suitability of this software for any purpose. It is provided "as | |
12 | * is" without express or implied warranty. | |
13 | * | |
14 | * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, | |
15 | * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO | |
16 | * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR | |
17 | * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, | |
18 | * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER | |
19 | * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE | |
20 | * OF THIS SOFTWARE. | |
21 | */ | |
22 | #ifndef _DRM_DP_MST_HELPER_H_ | |
23 | #define _DRM_DP_MST_HELPER_H_ | |
24 | ||
25 | #include <linux/types.h> | |
26 | #include <drm/drm_dp_helper.h> | |
3f3353b7 | 27 | #include <drm/drm_atomic.h> |
ad7f8a1f | 28 | |
12a280c7 LP |
29 | #if IS_ENABLED(CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS) |
30 | #include <linux/stackdepot.h> | |
31 | #include <linux/timekeeping.h> | |
32 | ||
33 | enum drm_dp_mst_topology_ref_type { | |
34 | DRM_DP_MST_TOPOLOGY_REF_GET, | |
35 | DRM_DP_MST_TOPOLOGY_REF_PUT, | |
36 | }; | |
37 | ||
38 | struct drm_dp_mst_topology_ref_history { | |
39 | struct drm_dp_mst_topology_ref_entry { | |
40 | enum drm_dp_mst_topology_ref_type type; | |
41 | int count; | |
42 | ktime_t ts_nsec; | |
43 | depot_stack_handle_t backtrace; | |
44 | } *entries; | |
45 | int len; | |
46 | }; | |
47 | #endif /* IS_ENABLED(CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS) */ | |
48 | ||
ad7f8a1f DA |
49 | struct drm_dp_mst_branch; |
50 | ||
51 | /** | |
32197aab | 52 | * struct drm_dp_vcpi - Virtual Channel Payload Identifier |
ad7f8a1f DA |
53 | * @vcpi: Virtual channel ID. |
54 | * @pbn: Payload Bandwidth Number for this channel | |
55 | * @aligned_pbn: PBN aligned with slot size | |
56 | * @num_slots: number of slots for this PBN | |
57 | */ | |
58 | struct drm_dp_vcpi { | |
59 | int vcpi; | |
60 | int pbn; | |
61 | int aligned_pbn; | |
62 | int num_slots; | |
63 | }; | |
64 | ||
65 | /** | |
66 | * struct drm_dp_mst_port - MST port | |
ad7f8a1f | 67 | * @port_num: port number |
3f9b3f02 LP |
68 | * @input: if this port is an input port. Protected by |
69 | * &drm_dp_mst_topology_mgr.base.lock. | |
70 | * @mcs: message capability status - DP 1.2 spec. Protected by | |
71 | * &drm_dp_mst_topology_mgr.base.lock. | |
72 | * @ddps: DisplayPort Device Plug Status - DP 1.2. Protected by | |
73 | * &drm_dp_mst_topology_mgr.base.lock. | |
74 | * @pdt: Peer Device Type. Protected by | |
75 | * &drm_dp_mst_topology_mgr.base.lock. | |
76 | * @ldps: Legacy Device Plug Status. Protected by | |
77 | * &drm_dp_mst_topology_mgr.base.lock. | |
78 | * @dpcd_rev: DPCD revision of device on this port. Protected by | |
79 | * &drm_dp_mst_topology_mgr.base.lock. | |
80 | * @num_sdp_streams: Number of simultaneous streams. Protected by | |
81 | * &drm_dp_mst_topology_mgr.base.lock. | |
82 | * @num_sdp_stream_sinks: Number of stream sinks. Protected by | |
83 | * &drm_dp_mst_topology_mgr.base.lock. | |
84 | * @available_pbn: Available bandwidth for this port. Protected by | |
85 | * &drm_dp_mst_topology_mgr.base.lock. | |
ad7f8a1f | 86 | * @next: link to next port on this branch device |
c485e2c9 | 87 | * @aux: i2c aux transport to talk to device connected to this port, protected |
3f9b3f02 | 88 | * by &drm_dp_mst_topology_mgr.base.lock. |
ad7f8a1f DA |
89 | * @parent: branch device parent of this port |
90 | * @vcpi: Virtual Channel Payload info for this port. | |
3f9b3f02 LP |
91 | * @connector: DRM connector this port is connected to. Protected by |
92 | * &drm_dp_mst_topology_mgr.base.lock. | |
ad7f8a1f DA |
93 | * @mgr: topology manager this port lives under. |
94 | * | |
95 | * This structure represents an MST port endpoint on a device somewhere | |
96 | * in the MST topology. | |
97 | */ | |
98 | struct drm_dp_mst_port { | |
ebcc0e6b LP |
99 | /** |
100 | * @topology_kref: refcount for this port's lifetime in the topology, | |
101 | * only the DP MST helpers should need to touch this | |
102 | */ | |
103 | struct kref topology_kref; | |
104 | ||
105 | /** | |
106 | * @malloc_kref: refcount for the memory allocation containing this | |
107 | * structure. See drm_dp_mst_get_port_malloc() and | |
108 | * drm_dp_mst_put_port_malloc(). | |
109 | */ | |
110 | struct kref malloc_kref; | |
ad7f8a1f | 111 | |
12a280c7 LP |
112 | #if IS_ENABLED(CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS) |
113 | /** | |
114 | * @topology_ref_history: A history of each topology | |
115 | * reference/dereference. See CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS. | |
116 | */ | |
117 | struct drm_dp_mst_topology_ref_history topology_ref_history; | |
118 | #endif | |
119 | ||
ad7f8a1f DA |
120 | u8 port_num; |
121 | bool input; | |
122 | bool mcs; | |
123 | bool ddps; | |
124 | u8 pdt; | |
125 | bool ldps; | |
126 | u8 dpcd_rev; | |
127 | u8 num_sdp_streams; | |
128 | u8 num_sdp_stream_sinks; | |
129 | uint16_t available_pbn; | |
130 | struct list_head next; | |
14692a36 LP |
131 | /** |
132 | * @mstb: the branch device connected to this port, if there is one. | |
133 | * This should be considered protected for reading by | |
134 | * &drm_dp_mst_topology_mgr.lock. There are two exceptions to this: | |
135 | * &drm_dp_mst_topology_mgr.up_req_work and | |
136 | * &drm_dp_mst_topology_mgr.work, which do not grab | |
137 | * &drm_dp_mst_topology_mgr.lock during reads but are the only | |
138 | * updaters of this list and are protected from writing concurrently | |
139 | * by &drm_dp_mst_topology_mgr.probe_lock. | |
140 | */ | |
141 | struct drm_dp_mst_branch *mstb; | |
ad7f8a1f DA |
142 | struct drm_dp_aux aux; /* i2c bus for this port? */ |
143 | struct drm_dp_mst_branch *parent; | |
144 | ||
145 | struct drm_dp_vcpi vcpi; | |
146 | struct drm_connector *connector; | |
147 | struct drm_dp_mst_topology_mgr *mgr; | |
c6a0aed4 | 148 | |
132d49d7 DV |
149 | /** |
150 | * @cached_edid: for DP logical ports - make tiling work by ensuring | |
151 | * that the EDID for all connectors is read immediately. | |
152 | */ | |
153 | struct edid *cached_edid; | |
154 | /** | |
155 | * @has_audio: Tracks whether the sink connector to this port is | |
156 | * audio-capable. | |
157 | */ | |
ef8f9bea | 158 | bool has_audio; |
a3c2b0ff DF |
159 | |
160 | bool fec_capable; | |
ad7f8a1f DA |
161 | }; |
162 | ||
163 | /** | |
164 | * struct drm_dp_mst_branch - MST branch device. | |
ad7f8a1f DA |
165 | * @rad: Relative Address to talk to this branch device. |
166 | * @lct: Link count total to talk to this branch device. | |
167 | * @num_ports: number of ports on the branch. | |
168 | * @msg_slots: one bit per transmitted msg slot. | |
ad7f8a1f DA |
169 | * @port_parent: pointer to the port parent, NULL if toplevel. |
170 | * @mgr: topology manager for this branch device. | |
171 | * @tx_slots: transmission slots for this device. | |
172 | * @last_seqno: last sequence number used to talk to this. | |
173 | * @link_address_sent: if a link address message has been sent to this device yet. | |
5e93b820 HW |
174 | * @guid: guid for DP 1.2 branch device. port under this branch can be |
175 | * identified by port #. | |
ad7f8a1f DA |
176 | * |
177 | * This structure represents an MST branch device, there is one | |
5e93b820 HW |
178 | * primary branch device at the root, along with any other branches connected |
179 | * to downstream port of parent branches. | |
ad7f8a1f DA |
180 | */ |
181 | struct drm_dp_mst_branch { | |
ebcc0e6b LP |
182 | /** |
183 | * @topology_kref: refcount for this branch device's lifetime in the | |
184 | * topology, only the DP MST helpers should need to touch this | |
185 | */ | |
186 | struct kref topology_kref; | |
187 | ||
188 | /** | |
189 | * @malloc_kref: refcount for the memory allocation containing this | |
190 | * structure. See drm_dp_mst_get_mstb_malloc() and | |
191 | * drm_dp_mst_put_mstb_malloc(). | |
192 | */ | |
193 | struct kref malloc_kref; | |
194 | ||
12a280c7 LP |
195 | #if IS_ENABLED(CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS) |
196 | /** | |
197 | * @topology_ref_history: A history of each topology | |
198 | * reference/dereference. See CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS. | |
199 | */ | |
200 | struct drm_dp_mst_topology_ref_history topology_ref_history; | |
201 | #endif | |
202 | ||
7cb12d48 LP |
203 | /** |
204 | * @destroy_next: linked-list entry used by | |
205 | * drm_dp_delayed_destroy_work() | |
206 | */ | |
207 | struct list_head destroy_next; | |
208 | ||
ad7f8a1f DA |
209 | u8 rad[8]; |
210 | u8 lct; | |
211 | int num_ports; | |
212 | ||
213 | int msg_slots; | |
14692a36 LP |
214 | /** |
215 | * @ports: the list of ports on this branch device. This should be | |
216 | * considered protected for reading by &drm_dp_mst_topology_mgr.lock. | |
217 | * There are two exceptions to this: | |
218 | * &drm_dp_mst_topology_mgr.up_req_work and | |
219 | * &drm_dp_mst_topology_mgr.work, which do not grab | |
220 | * &drm_dp_mst_topology_mgr.lock during reads but are the only | |
221 | * updaters of this list and are protected from updating the list | |
222 | * concurrently by @drm_dp_mst_topology_mgr.probe_lock | |
223 | */ | |
ad7f8a1f DA |
224 | struct list_head ports; |
225 | ||
226 | /* list of tx ops queue for this port */ | |
227 | struct drm_dp_mst_port *port_parent; | |
228 | struct drm_dp_mst_topology_mgr *mgr; | |
229 | ||
230 | /* slots are protected by mstb->mgr->qlock */ | |
231 | struct drm_dp_sideband_msg_tx *tx_slots[2]; | |
232 | int last_seqno; | |
233 | bool link_address_sent; | |
5e93b820 HW |
234 | |
235 | /* global unique identifier to identify branch devices */ | |
236 | u8 guid[16]; | |
ad7f8a1f DA |
237 | }; |
238 | ||
239 | ||
240 | /* sideband msg header - not bit struct */ | |
241 | struct drm_dp_sideband_msg_hdr { | |
242 | u8 lct; | |
243 | u8 lcr; | |
244 | u8 rad[8]; | |
245 | bool broadcast; | |
246 | bool path_msg; | |
247 | u8 msg_len; | |
248 | bool somt; | |
249 | bool eomt; | |
250 | bool seqno; | |
251 | }; | |
252 | ||
253 | struct drm_dp_nak_reply { | |
254 | u8 guid[16]; | |
255 | u8 reason; | |
256 | u8 nak_data; | |
257 | }; | |
258 | ||
259 | struct drm_dp_link_address_ack_reply { | |
260 | u8 guid[16]; | |
261 | u8 nports; | |
262 | struct drm_dp_link_addr_reply_port { | |
263 | bool input_port; | |
264 | u8 peer_device_type; | |
265 | u8 port_number; | |
266 | bool mcs; | |
267 | bool ddps; | |
268 | bool legacy_device_plug_status; | |
269 | u8 dpcd_revision; | |
270 | u8 peer_guid[16]; | |
271 | u8 num_sdp_streams; | |
272 | u8 num_sdp_stream_sinks; | |
273 | } ports[16]; | |
274 | }; | |
275 | ||
276 | struct drm_dp_remote_dpcd_read_ack_reply { | |
277 | u8 port_number; | |
278 | u8 num_bytes; | |
279 | u8 bytes[255]; | |
280 | }; | |
281 | ||
282 | struct drm_dp_remote_dpcd_write_ack_reply { | |
283 | u8 port_number; | |
284 | }; | |
285 | ||
286 | struct drm_dp_remote_dpcd_write_nak_reply { | |
287 | u8 port_number; | |
288 | u8 reason; | |
289 | u8 bytes_written_before_failure; | |
290 | }; | |
291 | ||
292 | struct drm_dp_remote_i2c_read_ack_reply { | |
293 | u8 port_number; | |
294 | u8 num_bytes; | |
295 | u8 bytes[255]; | |
296 | }; | |
297 | ||
298 | struct drm_dp_remote_i2c_read_nak_reply { | |
299 | u8 port_number; | |
300 | u8 nak_reason; | |
301 | u8 i2c_nak_transaction; | |
302 | }; | |
303 | ||
304 | struct drm_dp_remote_i2c_write_ack_reply { | |
305 | u8 port_number; | |
306 | }; | |
307 | ||
308 | ||
309 | struct drm_dp_sideband_msg_rx { | |
310 | u8 chunk[48]; | |
311 | u8 msg[256]; | |
312 | u8 curchunk_len; | |
313 | u8 curchunk_idx; /* chunk we are parsing now */ | |
314 | u8 curchunk_hdrlen; | |
315 | u8 curlen; /* total length of the msg */ | |
316 | bool have_somt; | |
317 | bool have_eomt; | |
318 | struct drm_dp_sideband_msg_hdr initial_hdr; | |
319 | }; | |
320 | ||
ef8f9bea | 321 | #define DRM_DP_MAX_SDP_STREAMS 16 |
ad7f8a1f DA |
322 | struct drm_dp_allocate_payload { |
323 | u8 port_number; | |
324 | u8 number_sdp_streams; | |
325 | u8 vcpi; | |
326 | u16 pbn; | |
ef8f9bea | 327 | u8 sdp_stream_sink[DRM_DP_MAX_SDP_STREAMS]; |
ad7f8a1f DA |
328 | }; |
329 | ||
330 | struct drm_dp_allocate_payload_ack_reply { | |
331 | u8 port_number; | |
332 | u8 vcpi; | |
333 | u16 allocated_pbn; | |
334 | }; | |
335 | ||
336 | struct drm_dp_connection_status_notify { | |
337 | u8 guid[16]; | |
338 | u8 port_number; | |
339 | bool legacy_device_plug_status; | |
340 | bool displayport_device_plug_status; | |
341 | bool message_capability_status; | |
342 | bool input_port; | |
343 | u8 peer_device_type; | |
344 | }; | |
345 | ||
346 | struct drm_dp_remote_dpcd_read { | |
347 | u8 port_number; | |
348 | u32 dpcd_address; | |
349 | u8 num_bytes; | |
350 | }; | |
351 | ||
352 | struct drm_dp_remote_dpcd_write { | |
353 | u8 port_number; | |
354 | u32 dpcd_address; | |
355 | u8 num_bytes; | |
356 | u8 *bytes; | |
357 | }; | |
358 | ||
ae491542 | 359 | #define DP_REMOTE_I2C_READ_MAX_TRANSACTIONS 4 |
ad7f8a1f DA |
360 | struct drm_dp_remote_i2c_read { |
361 | u8 num_transactions; | |
362 | u8 port_number; | |
2f015ec6 | 363 | struct drm_dp_remote_i2c_read_tx { |
ad7f8a1f DA |
364 | u8 i2c_dev_id; |
365 | u8 num_bytes; | |
366 | u8 *bytes; | |
367 | u8 no_stop_bit; | |
368 | u8 i2c_transaction_delay; | |
ae491542 | 369 | } transactions[DP_REMOTE_I2C_READ_MAX_TRANSACTIONS]; |
ad7f8a1f DA |
370 | u8 read_i2c_device_id; |
371 | u8 num_bytes_read; | |
372 | }; | |
373 | ||
374 | struct drm_dp_remote_i2c_write { | |
375 | u8 port_number; | |
376 | u8 write_i2c_device_id; | |
377 | u8 num_bytes; | |
378 | u8 *bytes; | |
379 | }; | |
380 | ||
381 | /* this covers ENUM_RESOURCES, POWER_DOWN_PHY, POWER_UP_PHY */ | |
382 | struct drm_dp_port_number_req { | |
383 | u8 port_number; | |
384 | }; | |
385 | ||
386 | struct drm_dp_enum_path_resources_ack_reply { | |
387 | u8 port_number; | |
a3c2b0ff | 388 | bool fec_capable; |
ad7f8a1f DA |
389 | u16 full_payload_bw_number; |
390 | u16 avail_payload_bw_number; | |
391 | }; | |
392 | ||
393 | /* covers POWER_DOWN_PHY, POWER_UP_PHY */ | |
394 | struct drm_dp_port_number_rep { | |
395 | u8 port_number; | |
396 | }; | |
397 | ||
398 | struct drm_dp_query_payload { | |
399 | u8 port_number; | |
400 | u8 vcpi; | |
401 | }; | |
402 | ||
403 | struct drm_dp_resource_status_notify { | |
404 | u8 port_number; | |
405 | u8 guid[16]; | |
406 | u16 available_pbn; | |
407 | }; | |
408 | ||
409 | struct drm_dp_query_payload_ack_reply { | |
410 | u8 port_number; | |
268de653 | 411 | u16 allocated_pbn; |
ad7f8a1f DA |
412 | }; |
413 | ||
414 | struct drm_dp_sideband_msg_req_body { | |
415 | u8 req_type; | |
416 | union ack_req { | |
417 | struct drm_dp_connection_status_notify conn_stat; | |
418 | struct drm_dp_port_number_req port_num; | |
419 | struct drm_dp_resource_status_notify resource_stat; | |
420 | ||
421 | struct drm_dp_query_payload query_payload; | |
422 | struct drm_dp_allocate_payload allocate_payload; | |
423 | ||
424 | struct drm_dp_remote_dpcd_read dpcd_read; | |
425 | struct drm_dp_remote_dpcd_write dpcd_write; | |
426 | ||
427 | struct drm_dp_remote_i2c_read i2c_read; | |
428 | struct drm_dp_remote_i2c_write i2c_write; | |
429 | } u; | |
430 | }; | |
431 | ||
432 | struct drm_dp_sideband_msg_reply_body { | |
433 | u8 reply_type; | |
434 | u8 req_type; | |
435 | union ack_replies { | |
436 | struct drm_dp_nak_reply nak; | |
437 | struct drm_dp_link_address_ack_reply link_addr; | |
438 | struct drm_dp_port_number_rep port_number; | |
439 | ||
440 | struct drm_dp_enum_path_resources_ack_reply path_resources; | |
441 | struct drm_dp_allocate_payload_ack_reply allocate_payload; | |
442 | struct drm_dp_query_payload_ack_reply query_payload; | |
443 | ||
444 | struct drm_dp_remote_dpcd_read_ack_reply remote_dpcd_read_ack; | |
445 | struct drm_dp_remote_dpcd_write_ack_reply remote_dpcd_write_ack; | |
446 | struct drm_dp_remote_dpcd_write_nak_reply remote_dpcd_write_nack; | |
447 | ||
448 | struct drm_dp_remote_i2c_read_ack_reply remote_i2c_read_ack; | |
449 | struct drm_dp_remote_i2c_read_nak_reply remote_i2c_read_nack; | |
450 | struct drm_dp_remote_i2c_write_ack_reply remote_i2c_write_ack; | |
451 | } u; | |
452 | }; | |
453 | ||
454 | /* msg is queued to be put into a slot */ | |
455 | #define DRM_DP_SIDEBAND_TX_QUEUED 0 | |
456 | /* msg has started transmitting on a slot - still on msgq */ | |
457 | #define DRM_DP_SIDEBAND_TX_START_SEND 1 | |
458 | /* msg has finished transmitting on a slot - removed from msgq only in slot */ | |
459 | #define DRM_DP_SIDEBAND_TX_SENT 2 | |
460 | /* msg has received a response - removed from slot */ | |
461 | #define DRM_DP_SIDEBAND_TX_RX 3 | |
462 | #define DRM_DP_SIDEBAND_TX_TIMEOUT 4 | |
463 | ||
464 | struct drm_dp_sideband_msg_tx { | |
465 | u8 msg[256]; | |
466 | u8 chunk[48]; | |
467 | u8 cur_offset; | |
468 | u8 cur_len; | |
469 | struct drm_dp_mst_branch *dst; | |
470 | struct list_head next; | |
471 | int seqno; | |
472 | int state; | |
473 | bool path_msg; | |
474 | struct drm_dp_sideband_msg_reply_body reply; | |
475 | }; | |
476 | ||
477 | /* sideband msg handler */ | |
478 | struct drm_dp_mst_topology_mgr; | |
479 | struct drm_dp_mst_topology_cbs { | |
480 | /* create a connector for a port */ | |
12e6cecd | 481 | struct drm_connector *(*add_connector)(struct drm_dp_mst_topology_mgr *mgr, struct drm_dp_mst_port *port, const char *path); |
d9515c5e | 482 | void (*register_connector)(struct drm_connector *connector); |
ad7f8a1f DA |
483 | void (*destroy_connector)(struct drm_dp_mst_topology_mgr *mgr, |
484 | struct drm_connector *connector); | |
ad7f8a1f DA |
485 | }; |
486 | ||
487 | #define DP_MAX_PAYLOAD (sizeof(unsigned long) * 8) | |
488 | ||
489 | #define DP_PAYLOAD_LOCAL 1 | |
490 | #define DP_PAYLOAD_REMOTE 2 | |
491 | #define DP_PAYLOAD_DELETE_LOCAL 3 | |
492 | ||
493 | struct drm_dp_payload { | |
494 | int payload_state; | |
495 | int start_slot; | |
496 | int num_slots; | |
dfda0df3 | 497 | int vcpi; |
ad7f8a1f DA |
498 | }; |
499 | ||
a4370c77 VS |
500 | #define to_dp_mst_topology_state(x) container_of(x, struct drm_dp_mst_topology_state, base) |
501 | ||
eceae147 LP |
502 | struct drm_dp_vcpi_allocation { |
503 | struct drm_dp_mst_port *port; | |
504 | int vcpi; | |
8afb7e6a | 505 | bool dsc_enabled; |
eceae147 LP |
506 | struct list_head next; |
507 | }; | |
508 | ||
3f3353b7 | 509 | struct drm_dp_mst_topology_state { |
a4370c77 | 510 | struct drm_private_state base; |
eceae147 | 511 | struct list_head vcpis; |
3f3353b7 PD |
512 | struct drm_dp_mst_topology_mgr *mgr; |
513 | }; | |
514 | ||
a4370c77 VS |
515 | #define to_dp_mst_topology_mgr(x) container_of(x, struct drm_dp_mst_topology_mgr, base) |
516 | ||
ad7f8a1f DA |
517 | /** |
518 | * struct drm_dp_mst_topology_mgr - DisplayPort MST manager | |
ad7f8a1f DA |
519 | * |
520 | * This struct represents the toplevel displayport MST topology manager. | |
521 | * There should be one instance of this for every MST capable DP connector | |
522 | * on the GPU. | |
523 | */ | |
524 | struct drm_dp_mst_topology_mgr { | |
a4370c77 VS |
525 | /** |
526 | * @base: Base private object for atomic | |
527 | */ | |
528 | struct drm_private_obj base; | |
529 | ||
132d49d7 DV |
530 | /** |
531 | * @dev: device pointer for adding i2c devices etc. | |
532 | */ | |
7b0a89a6 | 533 | struct drm_device *dev; |
132d49d7 DV |
534 | /** |
535 | * @cbs: callbacks for connector addition and destruction. | |
536 | */ | |
69a0f89c | 537 | const struct drm_dp_mst_topology_cbs *cbs; |
132d49d7 DV |
538 | /** |
539 | * @max_dpcd_transaction_bytes: maximum number of bytes to read/write | |
540 | * in one go. | |
541 | */ | |
ad7f8a1f | 542 | int max_dpcd_transaction_bytes; |
132d49d7 DV |
543 | /** |
544 | * @aux: AUX channel for the DP MST connector this topolgy mgr is | |
545 | * controlling. | |
546 | */ | |
547 | struct drm_dp_aux *aux; | |
548 | /** | |
549 | * @max_payloads: maximum number of payloads the GPU can generate. | |
550 | */ | |
ad7f8a1f | 551 | int max_payloads; |
132d49d7 DV |
552 | /** |
553 | * @conn_base_id: DRM connector ID this mgr is connected to. Only used | |
554 | * to build the MST connector path value. | |
555 | */ | |
ad7f8a1f DA |
556 | int conn_base_id; |
557 | ||
132d49d7 | 558 | /** |
85783369 | 559 | * @down_rep_recv: Message receiver state for down replies. |
132d49d7 | 560 | */ |
ad7f8a1f | 561 | struct drm_dp_sideband_msg_rx down_rep_recv; |
132d49d7 | 562 | /** |
85783369 | 563 | * @up_req_recv: Message receiver state for up requests. |
132d49d7 | 564 | */ |
ad7f8a1f DA |
565 | struct drm_dp_sideband_msg_rx up_req_recv; |
566 | ||
132d49d7 | 567 | /** |
f7948907 SP |
568 | * @lock: protects @mst_state, @mst_primary, @dpcd, and |
569 | * @payload_id_table_cleared. | |
132d49d7 DV |
570 | */ |
571 | struct mutex lock; | |
ad7f8a1f | 572 | |
14692a36 LP |
573 | /** |
574 | * @probe_lock: Prevents @work and @up_req_work, the only writers of | |
575 | * &drm_dp_mst_port.mstb and &drm_dp_mst_branch.ports, from racing | |
576 | * while they update the topology. | |
577 | */ | |
578 | struct mutex probe_lock; | |
579 | ||
132d49d7 DV |
580 | /** |
581 | * @mst_state: If this manager is enabled for an MST capable port. False | |
582 | * if no MST sink/branch devices is connected. | |
583 | */ | |
f7948907 SP |
584 | bool mst_state : 1; |
585 | ||
586 | /** | |
587 | * @payload_id_table_cleared: Whether or not we've cleared the payload | |
588 | * ID table for @mst_primary. Protected by @lock. | |
589 | */ | |
590 | bool payload_id_table_cleared : 1; | |
591 | ||
132d49d7 DV |
592 | /** |
593 | * @mst_primary: Pointer to the primary/first branch device. | |
594 | */ | |
ad7f8a1f | 595 | struct drm_dp_mst_branch *mst_primary; |
5e93b820 | 596 | |
132d49d7 DV |
597 | /** |
598 | * @dpcd: Cache of DPCD for primary port. | |
599 | */ | |
ad7f8a1f | 600 | u8 dpcd[DP_RECEIVER_CAP_SIZE]; |
132d49d7 DV |
601 | /** |
602 | * @sink_count: Sink count from DEVICE_SERVICE_IRQ_VECTOR_ESI0. | |
603 | */ | |
ad7f8a1f | 604 | u8 sink_count; |
132d49d7 DV |
605 | /** |
606 | * @pbn_div: PBN to slots divisor. | |
607 | */ | |
ad7f8a1f | 608 | int pbn_div; |
a538d613 | 609 | |
3f3353b7 PD |
610 | /** |
611 | * @funcs: Atomic helper callbacks | |
612 | */ | |
613 | const struct drm_private_state_funcs *funcs; | |
614 | ||
132d49d7 | 615 | /** |
6806cdf9 DV |
616 | * @qlock: protects @tx_msg_downq, the &drm_dp_mst_branch.txslost and |
617 | * &drm_dp_sideband_msg_tx.state once they are queued | |
132d49d7 | 618 | */ |
ad7f8a1f | 619 | struct mutex qlock; |
132d49d7 DV |
620 | /** |
621 | * @tx_msg_downq: List of pending down replies. | |
622 | */ | |
ad7f8a1f | 623 | struct list_head tx_msg_downq; |
ad7f8a1f | 624 | |
132d49d7 DV |
625 | /** |
626 | * @payload_lock: Protect payload information. | |
627 | */ | |
ad7f8a1f | 628 | struct mutex payload_lock; |
132d49d7 DV |
629 | /** |
630 | * @proposed_vcpis: Array of pointers for the new VCPI allocation. The | |
6806cdf9 | 631 | * VCPI structure itself is &drm_dp_mst_port.vcpi. |
132d49d7 | 632 | */ |
ad7f8a1f | 633 | struct drm_dp_vcpi **proposed_vcpis; |
132d49d7 DV |
634 | /** |
635 | * @payloads: Array of payloads. | |
636 | */ | |
ad7f8a1f | 637 | struct drm_dp_payload *payloads; |
132d49d7 DV |
638 | /** |
639 | * @payload_mask: Elements of @payloads actually in use. Since | |
640 | * reallocation of active outputs isn't possible gaps can be created by | |
641 | * disabling outputs out of order compared to how they've been enabled. | |
642 | */ | |
ad7f8a1f | 643 | unsigned long payload_mask; |
132d49d7 DV |
644 | /** |
645 | * @vcpi_mask: Similar to @payload_mask, but for @proposed_vcpis. | |
646 | */ | |
dfda0df3 | 647 | unsigned long vcpi_mask; |
ad7f8a1f | 648 | |
132d49d7 DV |
649 | /** |
650 | * @tx_waitq: Wait to queue stall for the tx worker. | |
651 | */ | |
ad7f8a1f | 652 | wait_queue_head_t tx_waitq; |
132d49d7 DV |
653 | /** |
654 | * @work: Probe work. | |
655 | */ | |
ad7f8a1f | 656 | struct work_struct work; |
132d49d7 DV |
657 | /** |
658 | * @tx_work: Sideband transmit worker. This can nest within the main | |
659 | * @work worker for each transaction @work launches. | |
660 | */ | |
ad7f8a1f | 661 | struct work_struct tx_work; |
6b8eeca6 | 662 | |
132d49d7 | 663 | /** |
7cb12d48 LP |
664 | * @destroy_port_list: List of to be destroyed connectors. |
665 | */ | |
666 | struct list_head destroy_port_list; | |
667 | /** | |
668 | * @destroy_branch_device_list: List of to be destroyed branch | |
669 | * devices. | |
132d49d7 | 670 | */ |
7cb12d48 | 671 | struct list_head destroy_branch_device_list; |
132d49d7 | 672 | /** |
7cb12d48 LP |
673 | * @delayed_destroy_lock: Protects @destroy_port_list and |
674 | * @destroy_branch_device_list. | |
132d49d7 | 675 | */ |
7cb12d48 | 676 | struct mutex delayed_destroy_lock; |
132d49d7 | 677 | /** |
7cb12d48 LP |
678 | * @delayed_destroy_work: Work item to destroy MST port and branch |
679 | * devices, needed to avoid locking inversion. | |
132d49d7 | 680 | */ |
7cb12d48 | 681 | struct work_struct delayed_destroy_work; |
9408cc94 LP |
682 | |
683 | /** | |
684 | * @up_req_list: List of pending up requests from the topology that | |
685 | * need to be processed, in chronological order. | |
686 | */ | |
687 | struct list_head up_req_list; | |
688 | /** | |
689 | * @up_req_lock: Protects @up_req_list | |
690 | */ | |
691 | struct mutex up_req_lock; | |
692 | /** | |
693 | * @up_req_work: Work item to process up requests received from the | |
694 | * topology. Needed to avoid blocking hotplug handling and sideband | |
695 | * transmissions. | |
696 | */ | |
697 | struct work_struct up_req_work; | |
12a280c7 LP |
698 | |
699 | #if IS_ENABLED(CONFIG_DRM_DEBUG_DP_MST_TOPOLOGY_REFS) | |
700 | /** | |
701 | * @topology_ref_history_lock: protects | |
702 | * &drm_dp_mst_port.topology_ref_history and | |
703 | * &drm_dp_mst_branch.topology_ref_history. | |
704 | */ | |
705 | struct mutex topology_ref_history_lock; | |
706 | #endif | |
ad7f8a1f DA |
707 | }; |
708 | ||
7b0a89a6 DP |
709 | int drm_dp_mst_topology_mgr_init(struct drm_dp_mst_topology_mgr *mgr, |
710 | struct drm_device *dev, struct drm_dp_aux *aux, | |
711 | int max_dpcd_transaction_bytes, | |
712 | int max_payloads, int conn_base_id); | |
ad7f8a1f DA |
713 | |
714 | void drm_dp_mst_topology_mgr_destroy(struct drm_dp_mst_topology_mgr *mgr); | |
715 | ||
716 | ||
717 | int drm_dp_mst_topology_mgr_set_mst(struct drm_dp_mst_topology_mgr *mgr, bool mst_state); | |
718 | ||
719 | ||
720 | int drm_dp_mst_hpd_irq(struct drm_dp_mst_topology_mgr *mgr, u8 *esi, bool *handled); | |
721 | ||
722 | ||
3f9b3f02 LP |
723 | int |
724 | drm_dp_mst_detect_port(struct drm_connector *connector, | |
725 | struct drm_modeset_acquire_ctx *ctx, | |
726 | struct drm_dp_mst_topology_mgr *mgr, | |
727 | struct drm_dp_mst_port *port); | |
ad7f8a1f | 728 | |
ef8f9bea LY |
729 | bool drm_dp_mst_port_has_audio(struct drm_dp_mst_topology_mgr *mgr, |
730 | struct drm_dp_mst_port *port); | |
ad7f8a1f DA |
731 | struct edid *drm_dp_mst_get_edid(struct drm_connector *connector, struct drm_dp_mst_topology_mgr *mgr, struct drm_dp_mst_port *port); |
732 | ||
733 | ||
dc48529f | 734 | int drm_dp_calc_pbn_mode(int clock, int bpp, bool dsc); |
ad7f8a1f | 735 | |
1e797f55 PD |
736 | bool drm_dp_mst_allocate_vcpi(struct drm_dp_mst_topology_mgr *mgr, |
737 | struct drm_dp_mst_port *port, int pbn, int slots); | |
ad7f8a1f | 738 | |
87f5942d DA |
739 | int drm_dp_mst_get_vcpi_slots(struct drm_dp_mst_topology_mgr *mgr, struct drm_dp_mst_port *port); |
740 | ||
ad7f8a1f DA |
741 | |
742 | void drm_dp_mst_reset_vcpi_slots(struct drm_dp_mst_topology_mgr *mgr, struct drm_dp_mst_port *port); | |
743 | ||
744 | ||
745 | void drm_dp_mst_deallocate_vcpi(struct drm_dp_mst_topology_mgr *mgr, | |
746 | struct drm_dp_mst_port *port); | |
747 | ||
748 | ||
749 | int drm_dp_find_vcpi_slots(struct drm_dp_mst_topology_mgr *mgr, | |
750 | int pbn); | |
751 | ||
752 | ||
753 | int drm_dp_update_payload_part1(struct drm_dp_mst_topology_mgr *mgr); | |
754 | ||
755 | ||
756 | int drm_dp_update_payload_part2(struct drm_dp_mst_topology_mgr *mgr); | |
757 | ||
758 | int drm_dp_check_act_status(struct drm_dp_mst_topology_mgr *mgr); | |
759 | ||
760 | void drm_dp_mst_dump_topology(struct seq_file *m, | |
761 | struct drm_dp_mst_topology_mgr *mgr); | |
762 | ||
763 | void drm_dp_mst_topology_mgr_suspend(struct drm_dp_mst_topology_mgr *mgr); | |
c235316d | 764 | int __must_check |
6f85f738 LP |
765 | drm_dp_mst_topology_mgr_resume(struct drm_dp_mst_topology_mgr *mgr, |
766 | bool sync); | |
562836a2 VS |
767 | |
768 | ssize_t drm_dp_mst_dpcd_read(struct drm_dp_aux *aux, | |
769 | unsigned int offset, void *buffer, size_t size); | |
770 | ssize_t drm_dp_mst_dpcd_write(struct drm_dp_aux *aux, | |
771 | unsigned int offset, void *buffer, size_t size); | |
772 | ||
773 | int drm_dp_mst_connector_late_register(struct drm_connector *connector, | |
774 | struct drm_dp_mst_port *port); | |
775 | void drm_dp_mst_connector_early_unregister(struct drm_connector *connector, | |
776 | struct drm_dp_mst_port *port); | |
777 | ||
3f3353b7 PD |
778 | struct drm_dp_mst_topology_state *drm_atomic_get_mst_topology_state(struct drm_atomic_state *state, |
779 | struct drm_dp_mst_topology_mgr *mgr); | |
eceae147 LP |
780 | int __must_check |
781 | drm_dp_atomic_find_vcpi_slots(struct drm_atomic_state *state, | |
782 | struct drm_dp_mst_topology_mgr *mgr, | |
1c6c1cb5 ML |
783 | struct drm_dp_mst_port *port, int pbn, |
784 | int pbn_div); | |
8afb7e6a ML |
785 | int drm_dp_mst_atomic_enable_dsc(struct drm_atomic_state *state, |
786 | struct drm_dp_mst_port *port, | |
787 | int pbn, int pbn_div, | |
788 | bool enable); | |
eceae147 LP |
789 | int __must_check |
790 | drm_dp_atomic_release_vcpi_slots(struct drm_atomic_state *state, | |
791 | struct drm_dp_mst_topology_mgr *mgr, | |
792 | struct drm_dp_mst_port *port); | |
0bb9c2b2 DP |
793 | int drm_dp_send_power_updown_phy(struct drm_dp_mst_topology_mgr *mgr, |
794 | struct drm_dp_mst_port *port, bool power_up); | |
eceae147 | 795 | int __must_check drm_dp_mst_atomic_check(struct drm_atomic_state *state); |
3f3353b7 | 796 | |
ebcc0e6b LP |
797 | void drm_dp_mst_get_port_malloc(struct drm_dp_mst_port *port); |
798 | void drm_dp_mst_put_port_malloc(struct drm_dp_mst_port *port); | |
799 | ||
c2bc1b6e DF |
800 | struct drm_dp_aux *drm_dp_mst_dsc_aux_for_port(struct drm_dp_mst_port *port); |
801 | ||
bea5c38f LP |
802 | extern const struct drm_private_state_funcs drm_dp_mst_topology_state_funcs; |
803 | ||
804 | /** | |
805 | * __drm_dp_mst_state_iter_get - private atomic state iterator function for | |
806 | * macro-internal use | |
807 | * @state: &struct drm_atomic_state pointer | |
808 | * @mgr: pointer to the &struct drm_dp_mst_topology_mgr iteration cursor | |
809 | * @old_state: optional pointer to the old &struct drm_dp_mst_topology_state | |
810 | * iteration cursor | |
811 | * @new_state: optional pointer to the new &struct drm_dp_mst_topology_state | |
812 | * iteration cursor | |
813 | * @i: int iteration cursor, for macro-internal use | |
814 | * | |
815 | * Used by for_each_oldnew_mst_mgr_in_state(), | |
816 | * for_each_old_mst_mgr_in_state(), and for_each_new_mst_mgr_in_state(). Don't | |
817 | * call this directly. | |
818 | * | |
819 | * Returns: | |
820 | * True if the current &struct drm_private_obj is a &struct | |
821 | * drm_dp_mst_topology_mgr, false otherwise. | |
822 | */ | |
823 | static inline bool | |
824 | __drm_dp_mst_state_iter_get(struct drm_atomic_state *state, | |
825 | struct drm_dp_mst_topology_mgr **mgr, | |
826 | struct drm_dp_mst_topology_state **old_state, | |
827 | struct drm_dp_mst_topology_state **new_state, | |
828 | int i) | |
829 | { | |
830 | struct __drm_private_objs_state *objs_state = &state->private_objs[i]; | |
831 | ||
832 | if (objs_state->ptr->funcs != &drm_dp_mst_topology_state_funcs) | |
833 | return false; | |
834 | ||
835 | *mgr = to_dp_mst_topology_mgr(objs_state->ptr); | |
836 | if (old_state) | |
837 | *old_state = to_dp_mst_topology_state(objs_state->old_state); | |
838 | if (new_state) | |
839 | *new_state = to_dp_mst_topology_state(objs_state->new_state); | |
840 | ||
841 | return true; | |
842 | } | |
843 | ||
844 | /** | |
845 | * for_each_oldnew_mst_mgr_in_state - iterate over all DP MST topology | |
846 | * managers in an atomic update | |
847 | * @__state: &struct drm_atomic_state pointer | |
848 | * @mgr: &struct drm_dp_mst_topology_mgr iteration cursor | |
849 | * @old_state: &struct drm_dp_mst_topology_state iteration cursor for the old | |
850 | * state | |
851 | * @new_state: &struct drm_dp_mst_topology_state iteration cursor for the new | |
852 | * state | |
853 | * @__i: int iteration cursor, for macro-internal use | |
854 | * | |
855 | * This iterates over all DRM DP MST topology managers in an atomic update, | |
856 | * tracking both old and new state. This is useful in places where the state | |
857 | * delta needs to be considered, for example in atomic check functions. | |
858 | */ | |
859 | #define for_each_oldnew_mst_mgr_in_state(__state, mgr, old_state, new_state, __i) \ | |
860 | for ((__i) = 0; (__i) < (__state)->num_private_objs; (__i)++) \ | |
861 | for_each_if(__drm_dp_mst_state_iter_get((__state), &(mgr), &(old_state), &(new_state), (__i))) | |
862 | ||
863 | /** | |
864 | * for_each_old_mst_mgr_in_state - iterate over all DP MST topology managers | |
865 | * in an atomic update | |
866 | * @__state: &struct drm_atomic_state pointer | |
867 | * @mgr: &struct drm_dp_mst_topology_mgr iteration cursor | |
868 | * @old_state: &struct drm_dp_mst_topology_state iteration cursor for the old | |
869 | * state | |
870 | * @__i: int iteration cursor, for macro-internal use | |
871 | * | |
872 | * This iterates over all DRM DP MST topology managers in an atomic update, | |
873 | * tracking only the old state. This is useful in disable functions, where we | |
874 | * need the old state the hardware is still in. | |
875 | */ | |
876 | #define for_each_old_mst_mgr_in_state(__state, mgr, old_state, __i) \ | |
877 | for ((__i) = 0; (__i) < (__state)->num_private_objs; (__i)++) \ | |
878 | for_each_if(__drm_dp_mst_state_iter_get((__state), &(mgr), &(old_state), NULL, (__i))) | |
879 | ||
880 | /** | |
881 | * for_each_new_mst_mgr_in_state - iterate over all DP MST topology managers | |
882 | * in an atomic update | |
883 | * @__state: &struct drm_atomic_state pointer | |
884 | * @mgr: &struct drm_dp_mst_topology_mgr iteration cursor | |
885 | * @new_state: &struct drm_dp_mst_topology_state iteration cursor for the new | |
886 | * state | |
887 | * @__i: int iteration cursor, for macro-internal use | |
888 | * | |
889 | * This iterates over all DRM DP MST topology managers in an atomic update, | |
890 | * tracking only the new state. This is useful in enable functions, where we | |
891 | * need the new state the hardware should be in when the atomic commit | |
892 | * operation has completed. | |
893 | */ | |
894 | #define for_each_new_mst_mgr_in_state(__state, mgr, new_state, __i) \ | |
895 | for ((__i) = 0; (__i) < (__state)->num_private_objs; (__i)++) \ | |
896 | for_each_if(__drm_dp_mst_state_iter_get((__state), &(mgr), NULL, &(new_state), (__i))) | |
897 | ||
ad7f8a1f | 898 | #endif |