]> Git Repo - linux.git/blob - drivers/gpu/drm/msm/msm_drv.h
Merge tag 'linux-watchdog-5.10-rc1' of git://www.linux-watchdog.org/linux-watchdog
[linux.git] / drivers / gpu / drm / msm / msm_drv.h
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (c) 2016-2018, The Linux Foundation. All rights reserved.
4  * Copyright (C) 2013 Red Hat
5  * Author: Rob Clark <[email protected]>
6  */
7
8 #ifndef __MSM_DRV_H__
9 #define __MSM_DRV_H__
10
11 #include <linux/kernel.h>
12 #include <linux/clk.h>
13 #include <linux/cpufreq.h>
14 #include <linux/module.h>
15 #include <linux/component.h>
16 #include <linux/platform_device.h>
17 #include <linux/pm.h>
18 #include <linux/pm_runtime.h>
19 #include <linux/slab.h>
20 #include <linux/list.h>
21 #include <linux/iommu.h>
22 #include <linux/types.h>
23 #include <linux/of_graph.h>
24 #include <linux/of_device.h>
25 #include <linux/sizes.h>
26 #include <linux/kthread.h>
27
28 #include <drm/drm_atomic.h>
29 #include <drm/drm_atomic_helper.h>
30 #include <drm/drm_plane_helper.h>
31 #include <drm/drm_probe_helper.h>
32 #include <drm/drm_fb_helper.h>
33 #include <drm/msm_drm.h>
34 #include <drm/drm_gem.h>
35
36 struct msm_kms;
37 struct msm_gpu;
38 struct msm_mmu;
39 struct msm_mdss;
40 struct msm_rd_state;
41 struct msm_perf_state;
42 struct msm_gem_submit;
43 struct msm_fence_context;
44 struct msm_gem_address_space;
45 struct msm_gem_vma;
46
47 #define MAX_CRTCS      8
48 #define MAX_PLANES     20
49 #define MAX_ENCODERS   8
50 #define MAX_BRIDGES    8
51 #define MAX_CONNECTORS 8
52
53 #define FRAC_16_16(mult, div)    (((mult) << 16) / (div))
54
55 struct msm_file_private {
56         rwlock_t queuelock;
57         struct list_head submitqueues;
58         int queueid;
59         struct msm_gem_address_space *aspace;
60         struct kref ref;
61 };
62
63 enum msm_mdp_plane_property {
64         PLANE_PROP_ZPOS,
65         PLANE_PROP_ALPHA,
66         PLANE_PROP_PREMULTIPLIED,
67         PLANE_PROP_MAX_NUM
68 };
69
70 #define MSM_GPU_MAX_RINGS 4
71 #define MAX_H_TILES_PER_DISPLAY 2
72
73 /**
74  * enum msm_display_caps - features/capabilities supported by displays
75  * @MSM_DISPLAY_CAP_VID_MODE:           Video or "active" mode supported
76  * @MSM_DISPLAY_CAP_CMD_MODE:           Command mode supported
77  * @MSM_DISPLAY_CAP_HOT_PLUG:           Hot plug detection supported
78  * @MSM_DISPLAY_CAP_EDID:               EDID supported
79  */
80 enum msm_display_caps {
81         MSM_DISPLAY_CAP_VID_MODE        = BIT(0),
82         MSM_DISPLAY_CAP_CMD_MODE        = BIT(1),
83         MSM_DISPLAY_CAP_HOT_PLUG        = BIT(2),
84         MSM_DISPLAY_CAP_EDID            = BIT(3),
85 };
86
87 /**
88  * enum msm_event_wait - type of HW events to wait for
89  * @MSM_ENC_COMMIT_DONE - wait for the driver to flush the registers to HW
90  * @MSM_ENC_TX_COMPLETE - wait for the HW to transfer the frame to panel
91  * @MSM_ENC_VBLANK - wait for the HW VBLANK event (for driver-internal waiters)
92  */
93 enum msm_event_wait {
94         MSM_ENC_COMMIT_DONE = 0,
95         MSM_ENC_TX_COMPLETE,
96         MSM_ENC_VBLANK,
97 };
98
99 /**
100  * struct msm_display_topology - defines a display topology pipeline
101  * @num_lm:       number of layer mixers used
102  * @num_enc:      number of compression encoder blocks used
103  * @num_intf:     number of interfaces the panel is mounted on
104  */
105 struct msm_display_topology {
106         u32 num_lm;
107         u32 num_enc;
108         u32 num_intf;
109         u32 num_dspp;
110 };
111
112 /**
113  * struct msm_display_info - defines display properties
114  * @intf_type:          DRM_MODE_ENCODER_ type
115  * @capabilities:       Bitmask of display flags
116  * @num_of_h_tiles:     Number of horizontal tiles in case of split interface
117  * @h_tile_instance:    Controller instance used per tile. Number of elements is
118  *                      based on num_of_h_tiles
119  * @is_te_using_watchdog_timer:  Boolean to indicate watchdog TE is
120  *                               used instead of panel TE in cmd mode panels
121  */
122 struct msm_display_info {
123         int intf_type;
124         uint32_t capabilities;
125         uint32_t num_of_h_tiles;
126         uint32_t h_tile_instance[MAX_H_TILES_PER_DISPLAY];
127         bool is_te_using_watchdog_timer;
128 };
129
130 /* Commit/Event thread specific structure */
131 struct msm_drm_thread {
132         struct drm_device *dev;
133         unsigned int crtc_id;
134         struct kthread_worker *worker;
135 };
136
137 struct msm_drm_private {
138
139         struct drm_device *dev;
140
141         struct msm_kms *kms;
142
143         /* subordinate devices, if present: */
144         struct platform_device *gpu_pdev;
145
146         /* top level MDSS wrapper device (for MDP5/DPU only) */
147         struct msm_mdss *mdss;
148
149         /* possibly this should be in the kms component, but it is
150          * shared by both mdp4 and mdp5..
151          */
152         struct hdmi *hdmi;
153
154         /* eDP is for mdp5 only, but kms has not been created
155          * when edp_bind() and edp_init() are called. Here is the only
156          * place to keep the edp instance.
157          */
158         struct msm_edp *edp;
159
160         /* DSI is shared by mdp4 and mdp5 */
161         struct msm_dsi *dsi[2];
162
163         struct msm_dp *dp;
164
165         /* when we have more than one 'msm_gpu' these need to be an array: */
166         struct msm_gpu *gpu;
167         struct msm_file_private *lastctx;
168         /* gpu is only set on open(), but we need this info earlier */
169         bool is_a2xx;
170
171         struct drm_fb_helper *fbdev;
172
173         struct msm_rd_state *rd;       /* debugfs to dump all submits */
174         struct msm_rd_state *hangrd;   /* debugfs to dump hanging submits */
175         struct msm_perf_state *perf;
176
177         /* list of GEM objects: */
178         struct list_head inactive_list;
179
180         /* worker for delayed free of objects: */
181         struct work_struct free_work;
182         struct llist_head free_list;
183
184         struct workqueue_struct *wq;
185
186         unsigned int num_planes;
187         struct drm_plane *planes[MAX_PLANES];
188
189         unsigned int num_crtcs;
190         struct drm_crtc *crtcs[MAX_CRTCS];
191
192         struct msm_drm_thread event_thread[MAX_CRTCS];
193
194         unsigned int num_encoders;
195         struct drm_encoder *encoders[MAX_ENCODERS];
196
197         unsigned int num_bridges;
198         struct drm_bridge *bridges[MAX_BRIDGES];
199
200         unsigned int num_connectors;
201         struct drm_connector *connectors[MAX_CONNECTORS];
202
203         /* Properties */
204         struct drm_property *plane_property[PLANE_PROP_MAX_NUM];
205
206         /* VRAM carveout, used when no IOMMU: */
207         struct {
208                 unsigned long size;
209                 dma_addr_t paddr;
210                 /* NOTE: mm managed at the page level, size is in # of pages
211                  * and position mm_node->start is in # of pages:
212                  */
213                 struct drm_mm mm;
214                 spinlock_t lock; /* Protects drm_mm node allocation/removal */
215         } vram;
216
217         struct notifier_block vmap_notifier;
218         struct shrinker shrinker;
219
220         struct drm_atomic_state *pm_state;
221 };
222
223 struct msm_format {
224         uint32_t pixel_format;
225 };
226
227 struct msm_pending_timer;
228
229 int msm_atomic_prepare_fb(struct drm_plane *plane,
230                           struct drm_plane_state *new_state);
231 void msm_atomic_init_pending_timer(struct msm_pending_timer *timer,
232                 struct msm_kms *kms, int crtc_idx);
233 void msm_atomic_commit_tail(struct drm_atomic_state *state);
234 struct drm_atomic_state *msm_atomic_state_alloc(struct drm_device *dev);
235 void msm_atomic_state_clear(struct drm_atomic_state *state);
236 void msm_atomic_state_free(struct drm_atomic_state *state);
237
238 int msm_crtc_enable_vblank(struct drm_crtc *crtc);
239 void msm_crtc_disable_vblank(struct drm_crtc *crtc);
240
241 int msm_gem_init_vma(struct msm_gem_address_space *aspace,
242                 struct msm_gem_vma *vma, int npages,
243                 u64 range_start, u64 range_end);
244 void msm_gem_purge_vma(struct msm_gem_address_space *aspace,
245                 struct msm_gem_vma *vma);
246 void msm_gem_unmap_vma(struct msm_gem_address_space *aspace,
247                 struct msm_gem_vma *vma);
248 int msm_gem_map_vma(struct msm_gem_address_space *aspace,
249                 struct msm_gem_vma *vma, int prot,
250                 struct sg_table *sgt, int npages);
251 void msm_gem_close_vma(struct msm_gem_address_space *aspace,
252                 struct msm_gem_vma *vma);
253
254
255 struct msm_gem_address_space *
256 msm_gem_address_space_get(struct msm_gem_address_space *aspace);
257
258 void msm_gem_address_space_put(struct msm_gem_address_space *aspace);
259
260 struct msm_gem_address_space *
261 msm_gem_address_space_create(struct msm_mmu *mmu, const char *name,
262                 u64 va_start, u64 size);
263
264 int msm_register_mmu(struct drm_device *dev, struct msm_mmu *mmu);
265 void msm_unregister_mmu(struct drm_device *dev, struct msm_mmu *mmu);
266
267 bool msm_use_mmu(struct drm_device *dev);
268
269 void msm_gem_submit_free(struct msm_gem_submit *submit);
270 int msm_ioctl_gem_submit(struct drm_device *dev, void *data,
271                 struct drm_file *file);
272
273 void msm_gem_shrinker_init(struct drm_device *dev);
274 void msm_gem_shrinker_cleanup(struct drm_device *dev);
275
276 int msm_gem_mmap_obj(struct drm_gem_object *obj,
277                         struct vm_area_struct *vma);
278 int msm_gem_mmap(struct file *filp, struct vm_area_struct *vma);
279 vm_fault_t msm_gem_fault(struct vm_fault *vmf);
280 uint64_t msm_gem_mmap_offset(struct drm_gem_object *obj);
281 int msm_gem_get_iova(struct drm_gem_object *obj,
282                 struct msm_gem_address_space *aspace, uint64_t *iova);
283 int msm_gem_get_and_pin_iova_range(struct drm_gem_object *obj,
284                 struct msm_gem_address_space *aspace, uint64_t *iova,
285                 u64 range_start, u64 range_end);
286 int msm_gem_get_and_pin_iova(struct drm_gem_object *obj,
287                 struct msm_gem_address_space *aspace, uint64_t *iova);
288 uint64_t msm_gem_iova(struct drm_gem_object *obj,
289                 struct msm_gem_address_space *aspace);
290 void msm_gem_unpin_iova(struct drm_gem_object *obj,
291                 struct msm_gem_address_space *aspace);
292 struct page **msm_gem_get_pages(struct drm_gem_object *obj);
293 void msm_gem_put_pages(struct drm_gem_object *obj);
294 int msm_gem_dumb_create(struct drm_file *file, struct drm_device *dev,
295                 struct drm_mode_create_dumb *args);
296 int msm_gem_dumb_map_offset(struct drm_file *file, struct drm_device *dev,
297                 uint32_t handle, uint64_t *offset);
298 struct sg_table *msm_gem_prime_get_sg_table(struct drm_gem_object *obj);
299 void *msm_gem_prime_vmap(struct drm_gem_object *obj);
300 void msm_gem_prime_vunmap(struct drm_gem_object *obj, void *vaddr);
301 int msm_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma);
302 struct drm_gem_object *msm_gem_prime_import_sg_table(struct drm_device *dev,
303                 struct dma_buf_attachment *attach, struct sg_table *sg);
304 int msm_gem_prime_pin(struct drm_gem_object *obj);
305 void msm_gem_prime_unpin(struct drm_gem_object *obj);
306 void *msm_gem_get_vaddr(struct drm_gem_object *obj);
307 void *msm_gem_get_vaddr_active(struct drm_gem_object *obj);
308 void msm_gem_put_vaddr(struct drm_gem_object *obj);
309 int msm_gem_madvise(struct drm_gem_object *obj, unsigned madv);
310 int msm_gem_sync_object(struct drm_gem_object *obj,
311                 struct msm_fence_context *fctx, bool exclusive);
312 void msm_gem_active_get(struct drm_gem_object *obj, struct msm_gpu *gpu);
313 void msm_gem_active_put(struct drm_gem_object *obj);
314 int msm_gem_cpu_prep(struct drm_gem_object *obj, uint32_t op, ktime_t *timeout);
315 int msm_gem_cpu_fini(struct drm_gem_object *obj);
316 void msm_gem_free_object(struct drm_gem_object *obj);
317 int msm_gem_new_handle(struct drm_device *dev, struct drm_file *file,
318                 uint32_t size, uint32_t flags, uint32_t *handle, char *name);
319 struct drm_gem_object *msm_gem_new(struct drm_device *dev,
320                 uint32_t size, uint32_t flags);
321 struct drm_gem_object *msm_gem_new_locked(struct drm_device *dev,
322                 uint32_t size, uint32_t flags);
323 void *msm_gem_kernel_new(struct drm_device *dev, uint32_t size,
324                 uint32_t flags, struct msm_gem_address_space *aspace,
325                 struct drm_gem_object **bo, uint64_t *iova);
326 void *msm_gem_kernel_new_locked(struct drm_device *dev, uint32_t size,
327                 uint32_t flags, struct msm_gem_address_space *aspace,
328                 struct drm_gem_object **bo, uint64_t *iova);
329 void msm_gem_kernel_put(struct drm_gem_object *bo,
330                 struct msm_gem_address_space *aspace, bool locked);
331 struct drm_gem_object *msm_gem_import(struct drm_device *dev,
332                 struct dma_buf *dmabuf, struct sg_table *sgt);
333 void msm_gem_free_work(struct work_struct *work);
334
335 __printf(2, 3)
336 void msm_gem_object_set_name(struct drm_gem_object *bo, const char *fmt, ...);
337
338 int msm_framebuffer_prepare(struct drm_framebuffer *fb,
339                 struct msm_gem_address_space *aspace);
340 void msm_framebuffer_cleanup(struct drm_framebuffer *fb,
341                 struct msm_gem_address_space *aspace);
342 uint32_t msm_framebuffer_iova(struct drm_framebuffer *fb,
343                 struct msm_gem_address_space *aspace, int plane);
344 struct drm_gem_object *msm_framebuffer_bo(struct drm_framebuffer *fb, int plane);
345 const struct msm_format *msm_framebuffer_format(struct drm_framebuffer *fb);
346 struct drm_framebuffer *msm_framebuffer_create(struct drm_device *dev,
347                 struct drm_file *file, const struct drm_mode_fb_cmd2 *mode_cmd);
348 struct drm_framebuffer * msm_alloc_stolen_fb(struct drm_device *dev,
349                 int w, int h, int p, uint32_t format);
350
351 struct drm_fb_helper *msm_fbdev_init(struct drm_device *dev);
352 void msm_fbdev_free(struct drm_device *dev);
353
354 struct hdmi;
355 int msm_hdmi_modeset_init(struct hdmi *hdmi, struct drm_device *dev,
356                 struct drm_encoder *encoder);
357 void __init msm_hdmi_register(void);
358 void __exit msm_hdmi_unregister(void);
359
360 struct msm_edp;
361 void __init msm_edp_register(void);
362 void __exit msm_edp_unregister(void);
363 int msm_edp_modeset_init(struct msm_edp *edp, struct drm_device *dev,
364                 struct drm_encoder *encoder);
365
366 struct msm_dsi;
367 #ifdef CONFIG_DRM_MSM_DSI
368 void __init msm_dsi_register(void);
369 void __exit msm_dsi_unregister(void);
370 int msm_dsi_modeset_init(struct msm_dsi *msm_dsi, struct drm_device *dev,
371                          struct drm_encoder *encoder);
372 #else
373 static inline void __init msm_dsi_register(void)
374 {
375 }
376 static inline void __exit msm_dsi_unregister(void)
377 {
378 }
379 static inline int msm_dsi_modeset_init(struct msm_dsi *msm_dsi,
380                                        struct drm_device *dev,
381                                        struct drm_encoder *encoder)
382 {
383         return -EINVAL;
384 }
385 #endif
386
387 #ifdef CONFIG_DRM_MSM_DP
388 int __init msm_dp_register(void);
389 void __exit msm_dp_unregister(void);
390 int msm_dp_modeset_init(struct msm_dp *dp_display, struct drm_device *dev,
391                          struct drm_encoder *encoder);
392 int msm_dp_display_enable(struct msm_dp *dp, struct drm_encoder *encoder);
393 int msm_dp_display_disable(struct msm_dp *dp, struct drm_encoder *encoder);
394 int msm_dp_display_pre_disable(struct msm_dp *dp, struct drm_encoder *encoder);
395 void msm_dp_display_mode_set(struct msm_dp *dp, struct drm_encoder *encoder,
396                                 struct drm_display_mode *mode,
397                                 struct drm_display_mode *adjusted_mode);
398 void msm_dp_irq_postinstall(struct msm_dp *dp_display);
399
400 void msm_dp_debugfs_init(struct msm_dp *dp_display, struct drm_minor *minor);
401
402 #else
403 static inline int __init msm_dp_register(void)
404 {
405         return -EINVAL;
406 }
407 static inline void __exit msm_dp_unregister(void)
408 {
409 }
410 static inline int msm_dp_modeset_init(struct msm_dp *dp_display,
411                                        struct drm_device *dev,
412                                        struct drm_encoder *encoder)
413 {
414         return -EINVAL;
415 }
416 static inline int msm_dp_display_enable(struct msm_dp *dp,
417                                         struct drm_encoder *encoder)
418 {
419         return -EINVAL;
420 }
421 static inline int msm_dp_display_disable(struct msm_dp *dp,
422                                         struct drm_encoder *encoder)
423 {
424         return -EINVAL;
425 }
426 static inline void msm_dp_display_mode_set(struct msm_dp *dp,
427                                 struct drm_encoder *encoder,
428                                 struct drm_display_mode *mode,
429                                 struct drm_display_mode *adjusted_mode)
430 {
431 }
432
433 static inline void msm_dp_irq_postinstall(struct msm_dp *dp_display)
434 {
435 }
436
437 static inline void msm_dp_debugfs_init(struct msm_dp *dp_display,
438                 struct drm_minor *minor)
439 {
440 }
441
442 #endif
443
444 void __init msm_mdp_register(void);
445 void __exit msm_mdp_unregister(void);
446 void __init msm_dpu_register(void);
447 void __exit msm_dpu_unregister(void);
448
449 #ifdef CONFIG_DEBUG_FS
450 void msm_gem_describe(struct drm_gem_object *obj, struct seq_file *m);
451 void msm_gem_describe_objects(struct list_head *list, struct seq_file *m);
452 void msm_framebuffer_describe(struct drm_framebuffer *fb, struct seq_file *m);
453 int msm_debugfs_late_init(struct drm_device *dev);
454 int msm_rd_debugfs_init(struct drm_minor *minor);
455 void msm_rd_debugfs_cleanup(struct msm_drm_private *priv);
456 __printf(3, 4)
457 void msm_rd_dump_submit(struct msm_rd_state *rd, struct msm_gem_submit *submit,
458                 const char *fmt, ...);
459 int msm_perf_debugfs_init(struct drm_minor *minor);
460 void msm_perf_debugfs_cleanup(struct msm_drm_private *priv);
461 #else
462 static inline int msm_debugfs_late_init(struct drm_device *dev) { return 0; }
463 __printf(3, 4)
464 static inline void msm_rd_dump_submit(struct msm_rd_state *rd,
465                         struct msm_gem_submit *submit,
466                         const char *fmt, ...) {}
467 static inline void msm_rd_debugfs_cleanup(struct msm_drm_private *priv) {}
468 static inline void msm_perf_debugfs_cleanup(struct msm_drm_private *priv) {}
469 #endif
470
471 struct clk *msm_clk_get(struct platform_device *pdev, const char *name);
472
473 struct clk *msm_clk_bulk_get_clock(struct clk_bulk_data *bulk, int count,
474         const char *name);
475 void __iomem *msm_ioremap(struct platform_device *pdev, const char *name,
476                 const char *dbgname);
477 void __iomem *msm_ioremap_quiet(struct platform_device *pdev, const char *name,
478                 const char *dbgname);
479 void msm_writel(u32 data, void __iomem *addr);
480 u32 msm_readl(const void __iomem *addr);
481
482 struct msm_gpu_submitqueue;
483 int msm_submitqueue_init(struct drm_device *drm, struct msm_file_private *ctx);
484 struct msm_gpu_submitqueue *msm_submitqueue_get(struct msm_file_private *ctx,
485                 u32 id);
486 int msm_submitqueue_create(struct drm_device *drm,
487                 struct msm_file_private *ctx,
488                 u32 prio, u32 flags, u32 *id);
489 int msm_submitqueue_query(struct drm_device *drm, struct msm_file_private *ctx,
490                 struct drm_msm_submitqueue_query *args);
491 int msm_submitqueue_remove(struct msm_file_private *ctx, u32 id);
492 void msm_submitqueue_close(struct msm_file_private *ctx);
493
494 void msm_submitqueue_destroy(struct kref *kref);
495
496 static inline void __msm_file_private_destroy(struct kref *kref)
497 {
498         struct msm_file_private *ctx = container_of(kref,
499                 struct msm_file_private, ref);
500
501         msm_gem_address_space_put(ctx->aspace);
502         kfree(ctx);
503 }
504
505 static inline void msm_file_private_put(struct msm_file_private *ctx)
506 {
507         kref_put(&ctx->ref, __msm_file_private_destroy);
508 }
509
510 static inline struct msm_file_private *msm_file_private_get(
511         struct msm_file_private *ctx)
512 {
513         kref_get(&ctx->ref);
514         return ctx;
515 }
516
517 #define DBG(fmt, ...) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
518 #define VERB(fmt, ...) if (0) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
519
520 static inline int align_pitch(int width, int bpp)
521 {
522         int bytespp = (bpp + 7) / 8;
523         /* adreno needs pitch aligned to 32 pixels: */
524         return bytespp * ALIGN(width, 32);
525 }
526
527 /* for the generated headers: */
528 #define INVALID_IDX(idx) ({BUG(); 0;})
529 #define fui(x)                ({BUG(); 0;})
530 #define util_float_to_half(x) ({BUG(); 0;})
531
532
533 #define FIELD(val, name) (((val) & name ## __MASK) >> name ## __SHIFT)
534
535 /* for conditionally setting boolean flag(s): */
536 #define COND(bool, val) ((bool) ? (val) : 0)
537
538 static inline unsigned long timeout_to_jiffies(const ktime_t *timeout)
539 {
540         ktime_t now = ktime_get();
541         unsigned long remaining_jiffies;
542
543         if (ktime_compare(*timeout, now) < 0) {
544                 remaining_jiffies = 0;
545         } else {
546                 ktime_t rem = ktime_sub(*timeout, now);
547                 remaining_jiffies = ktime_divns(rem, NSEC_PER_SEC / HZ);
548         }
549
550         return remaining_jiffies;
551 }
552
553 #endif /* __MSM_DRV_H__ */
This page took 0.062685 seconds and 4 git commands to generate.