Linux Audio

Check our new training course

Loading...
v6.8
  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 <robdclark@gmail.com>
  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/devfreq.h>
 15#include <linux/module.h>
 16#include <linux/component.h>
 17#include <linux/platform_device.h>
 18#include <linux/pm.h>
 19#include <linux/pm_runtime.h>
 20#include <linux/slab.h>
 21#include <linux/list.h>
 22#include <linux/iommu.h>
 23#include <linux/types.h>
 24#include <linux/of_graph.h>
 25#include <linux/of_device.h>
 26#include <linux/sizes.h>
 27#include <linux/kthread.h>
 28
 29#include <drm/drm_atomic.h>
 30#include <drm/drm_atomic_helper.h>
 
 31#include <drm/drm_probe_helper.h>
 32#include <drm/display/drm_dsc.h>
 33#include <drm/msm_drm.h>
 34#include <drm/drm_gem.h>
 35
 36#ifdef CONFIG_FAULT_INJECTION
 37extern struct fault_attr fail_gem_alloc;
 38extern struct fault_attr fail_gem_iova;
 39#else
 40#  define should_fail(attr, size) 0
 41#endif
 42
 43struct msm_kms;
 44struct msm_gpu;
 45struct msm_mmu;
 46struct msm_mdss;
 47struct msm_rd_state;
 48struct msm_perf_state;
 49struct msm_gem_submit;
 50struct msm_fence_context;
 51struct msm_gem_address_space;
 52struct msm_gem_vma;
 53struct msm_disp_state;
 54
 55#define MAX_CRTCS      8
 
 
 56#define MAX_BRIDGES    8
 
 57
 58#define FRAC_16_16(mult, div)    (((mult) << 16) / (div))
 59
 60enum msm_dp_controller {
 61	MSM_DP_CONTROLLER_0,
 62	MSM_DP_CONTROLLER_1,
 63	MSM_DP_CONTROLLER_2,
 64	MSM_DP_CONTROLLER_3,
 65	MSM_DP_CONTROLLER_COUNT,
 66};
 67
 68enum msm_dsi_controller {
 69	MSM_DSI_CONTROLLER_0,
 70	MSM_DSI_CONTROLLER_1,
 71	MSM_DSI_CONTROLLER_COUNT,
 
 72};
 73
 74#define MSM_GPU_MAX_RINGS 4
 75#define MAX_H_TILES_PER_DISPLAY 2
 76
 77/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 78 * enum msm_event_wait - type of HW events to wait for
 79 * @MSM_ENC_COMMIT_DONE - wait for the driver to flush the registers to HW
 80 * @MSM_ENC_TX_COMPLETE - wait for the HW to transfer the frame to panel
 
 81 */
 82enum msm_event_wait {
 83	MSM_ENC_COMMIT_DONE = 0,
 84	MSM_ENC_TX_COMPLETE,
 
 85};
 86
 87/**
 88 * struct msm_display_topology - defines a display topology pipeline
 89 * @num_lm:       number of layer mixers used
 
 90 * @num_intf:     number of interfaces the panel is mounted on
 91 * @num_dspp:     number of dspp blocks used
 92 * @num_dsc:      number of Display Stream Compression (DSC) blocks used
 93 * @needs_cdm:    indicates whether cdm block is needed for this display topology
 94 */
 95struct msm_display_topology {
 96	u32 num_lm;
 
 97	u32 num_intf;
 98	u32 num_dspp;
 99	u32 num_dsc;
100	bool needs_cdm;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
101};
102
103/* Commit/Event thread specific structure */
104struct msm_drm_thread {
105	struct drm_device *dev;
106	struct kthread_worker *worker;
 
 
107};
108
109struct msm_drm_private {
110
111	struct drm_device *dev;
112
113	struct msm_kms *kms;
114	int (*kms_init)(struct drm_device *dev);
115
116	/* subordinate devices, if present: */
117	struct platform_device *gpu_pdev;
118
 
 
 
119	/* possibly this should be in the kms component, but it is
120	 * shared by both mdp4 and mdp5..
121	 */
122	struct hdmi *hdmi;
123
124	/* DSI is shared by mdp4 and mdp5 */
125	struct msm_dsi *dsi[MSM_DSI_CONTROLLER_COUNT];
 
 
 
126
127	struct msm_dp *dp[MSM_DP_CONTROLLER_COUNT];
 
128
129	/* when we have more than one 'msm_gpu' these need to be an array: */
130	struct msm_gpu *gpu;
131
132	/* gpu is only set on open(), but we need this info earlier */
133	bool is_a2xx;
134	bool has_cached_coherent;
 
135
136	struct msm_rd_state *rd;       /* debugfs to dump all submits */
137	struct msm_rd_state *hangrd;   /* debugfs to dump hanging submits */
138	struct msm_perf_state *perf;
139
140	/**
141	 * List of all GEM objects (mainly for debugfs, protected by obj_lock
142	 * (acquire before per GEM object lock)
143	 */
144	struct list_head objects;
145	struct mutex obj_lock;
146
147	/**
148	 * lru:
149	 *
150	 * The various LRU's that a GEM object is in at various stages of
151	 * it's lifetime.  Objects start out in the unbacked LRU.  When
152	 * pinned (for scannout or permanently mapped GPU buffers, like
153	 * ringbuffer, memptr, fw, etc) it moves to the pinned LRU.  When
154	 * unpinned, it moves into willneed or dontneed LRU depending on
155	 * madvise state.  When backing pages are evicted (willneed) or
156	 * purged (dontneed) it moves back into the unbacked LRU.
157	 *
158	 * The dontneed LRU is considered by the shrinker for objects
159	 * that are candidate for purging, and the willneed LRU is
160	 * considered for objects that could be evicted.
161	 */
162	struct {
163		/**
164		 * unbacked:
165		 *
166		 * The LRU for GEM objects without backing pages allocated.
167		 * This mostly exists so that objects are always is one
168		 * LRU.
169		 */
170		struct drm_gem_lru unbacked;
171
172		/**
173		 * pinned:
174		 *
175		 * The LRU for pinned GEM objects
176		 */
177		struct drm_gem_lru pinned;
178
179		/**
180		 * willneed:
181		 *
182		 * The LRU for unpinned GEM objects which are in madvise
183		 * WILLNEED state (ie. can be evicted)
184		 */
185		struct drm_gem_lru willneed;
186
187		/**
188		 * dontneed:
189		 *
190		 * The LRU for unpinned GEM objects which are in madvise
191		 * DONTNEED state (ie. can be purged)
192		 */
193		struct drm_gem_lru dontneed;
194
195		/**
196		 * lock:
197		 *
198		 * Protects manipulation of all of the LRUs.
199		 */
200		struct mutex lock;
201	} lru;
202
203	struct workqueue_struct *wq;
 
204
205	unsigned int num_crtcs;
 
206
207	struct msm_drm_thread event_thread[MAX_CRTCS];
 
 
 
 
208
209	/* VRAM carveout, used when no IOMMU: */
210	struct {
211		unsigned long size;
212		dma_addr_t paddr;
213		/* NOTE: mm managed at the page level, size is in # of pages
214		 * and position mm_node->start is in # of pages:
215		 */
216		struct drm_mm mm;
217		spinlock_t lock; /* Protects drm_mm node allocation/removal */
218	} vram;
219
220	struct notifier_block vmap_notifier;
221	struct shrinker *shrinker;
222
223	struct drm_atomic_state *pm_state;
224
225	/**
226	 * hangcheck_period: For hang detection, in ms
227	 *
228	 * Note that in practice, a submit/job will get at least two hangcheck
229	 * periods, due to checking for progress being implemented as simply
230	 * "have the CP position registers changed since last time?"
231	 */
232	unsigned int hangcheck_period;
233
234	/** gpu_devfreq_config: Devfreq tuning config for the GPU. */
235	struct devfreq_simple_ondemand_data gpu_devfreq_config;
236
237	/**
238	 * gpu_clamp_to_idle: Enable clamping to idle freq when inactive
239	 */
240	bool gpu_clamp_to_idle;
241
242	/**
243	 * disable_err_irq:
244	 *
245	 * Disable handling of GPU hw error interrupts, to force fallback to
246	 * sw hangcheck timer.  Written (via debugfs) by igt tests to test
247	 * the sw hangcheck mechanism.
248	 */
249	bool disable_err_irq;
250};
251
252struct msm_format {
253	uint32_t pixel_format;
254};
255
256struct msm_pending_timer;
257
258int msm_atomic_init_pending_timer(struct msm_pending_timer *timer,
 
 
259		struct msm_kms *kms, int crtc_idx);
260void msm_atomic_destroy_pending_timer(struct msm_pending_timer *timer);
261void msm_atomic_commit_tail(struct drm_atomic_state *state);
262int msm_atomic_check(struct drm_device *dev, struct drm_atomic_state *state);
263struct drm_atomic_state *msm_atomic_state_alloc(struct drm_device *dev);
264void msm_atomic_state_clear(struct drm_atomic_state *state);
265void msm_atomic_state_free(struct drm_atomic_state *state);
266
267int msm_crtc_enable_vblank(struct drm_crtc *crtc);
268void msm_crtc_disable_vblank(struct drm_crtc *crtc);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
269
270int msm_register_mmu(struct drm_device *dev, struct msm_mmu *mmu);
271void msm_unregister_mmu(struct drm_device *dev, struct msm_mmu *mmu);
272
273struct msm_gem_address_space *msm_kms_init_aspace(struct drm_device *dev);
274bool msm_use_mmu(struct drm_device *dev);
275
 
276int msm_ioctl_gem_submit(struct drm_device *dev, void *data,
277		struct drm_file *file);
278
279#ifdef CONFIG_DEBUG_FS
280unsigned long msm_gem_shrinker_shrink(struct drm_device *dev, unsigned long nr_to_scan);
281#endif
282
283int msm_gem_shrinker_init(struct drm_device *dev);
284void msm_gem_shrinker_cleanup(struct drm_device *dev);
285
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
286struct sg_table *msm_gem_prime_get_sg_table(struct drm_gem_object *obj);
287int msm_gem_prime_vmap(struct drm_gem_object *obj, struct iosys_map *map);
288void msm_gem_prime_vunmap(struct drm_gem_object *obj, struct iosys_map *map);
 
289struct drm_gem_object *msm_gem_prime_import_sg_table(struct drm_device *dev,
290		struct dma_buf_attachment *attach, struct sg_table *sg);
291int msm_gem_prime_pin(struct drm_gem_object *obj);
292void msm_gem_prime_unpin(struct drm_gem_object *obj);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
293
294int msm_framebuffer_prepare(struct drm_framebuffer *fb,
295		struct msm_gem_address_space *aspace, bool needs_dirtyfb);
296void msm_framebuffer_cleanup(struct drm_framebuffer *fb,
297		struct msm_gem_address_space *aspace, bool needed_dirtyfb);
298uint32_t msm_framebuffer_iova(struct drm_framebuffer *fb,
299		struct msm_gem_address_space *aspace, int plane);
300struct drm_gem_object *msm_framebuffer_bo(struct drm_framebuffer *fb, int plane);
301const struct msm_format *msm_framebuffer_format(struct drm_framebuffer *fb);
302struct drm_framebuffer *msm_framebuffer_create(struct drm_device *dev,
303		struct drm_file *file, const struct drm_mode_fb_cmd2 *mode_cmd);
304struct drm_framebuffer * msm_alloc_stolen_fb(struct drm_device *dev,
305		int w, int h, int p, uint32_t format);
306
307#ifdef CONFIG_DRM_FBDEV_EMULATION
308void msm_fbdev_setup(struct drm_device *dev);
309#else
310static inline void msm_fbdev_setup(struct drm_device *dev)
311{
312}
313#endif
314
315struct hdmi;
316#ifdef CONFIG_DRM_MSM_HDMI
317int msm_hdmi_modeset_init(struct hdmi *hdmi, struct drm_device *dev,
318		struct drm_encoder *encoder);
319void __init msm_hdmi_register(void);
320void __exit msm_hdmi_unregister(void);
321#else
322static inline int msm_hdmi_modeset_init(struct hdmi *hdmi, struct drm_device *dev,
323		struct drm_encoder *encoder)
324{
325	return -EINVAL;
326}
327static inline void __init msm_hdmi_register(void) {}
328static inline void __exit msm_hdmi_unregister(void) {}
329#endif
330
331struct msm_dsi;
332#ifdef CONFIG_DRM_MSM_DSI
333int dsi_dev_attach(struct platform_device *pdev);
334void dsi_dev_detach(struct platform_device *pdev);
335void __init msm_dsi_register(void);
336void __exit msm_dsi_unregister(void);
337int msm_dsi_modeset_init(struct msm_dsi *msm_dsi, struct drm_device *dev,
338			 struct drm_encoder *encoder);
339void msm_dsi_snapshot(struct msm_disp_state *disp_state, struct msm_dsi *msm_dsi);
340bool msm_dsi_is_cmd_mode(struct msm_dsi *msm_dsi);
341bool msm_dsi_is_bonded_dsi(struct msm_dsi *msm_dsi);
342bool msm_dsi_is_master_dsi(struct msm_dsi *msm_dsi);
343bool msm_dsi_wide_bus_enabled(struct msm_dsi *msm_dsi);
344struct drm_dsc_config *msm_dsi_get_dsc_config(struct msm_dsi *msm_dsi);
345#else
346static inline void __init msm_dsi_register(void)
347{
348}
349static inline void __exit msm_dsi_unregister(void)
350{
351}
352static inline int msm_dsi_modeset_init(struct msm_dsi *msm_dsi,
353				       struct drm_device *dev,
354				       struct drm_encoder *encoder)
355{
356	return -EINVAL;
357}
358static inline void msm_dsi_snapshot(struct msm_disp_state *disp_state, struct msm_dsi *msm_dsi)
359{
360}
361static inline bool msm_dsi_is_cmd_mode(struct msm_dsi *msm_dsi)
362{
363	return false;
364}
365static inline bool msm_dsi_is_bonded_dsi(struct msm_dsi *msm_dsi)
366{
367	return false;
368}
369static inline bool msm_dsi_is_master_dsi(struct msm_dsi *msm_dsi)
370{
371	return false;
372}
373static inline bool msm_dsi_wide_bus_enabled(struct msm_dsi *msm_dsi)
374{
375	return false;
376}
377
378static inline struct drm_dsc_config *msm_dsi_get_dsc_config(struct msm_dsi *msm_dsi)
379{
380	return NULL;
381}
382#endif
383
384#ifdef CONFIG_DRM_MSM_DP
385int __init msm_dp_register(void);
386void __exit msm_dp_unregister(void);
387int msm_dp_modeset_init(struct msm_dp *dp_display, struct drm_device *dev,
388			 struct drm_encoder *encoder);
389void msm_dp_snapshot(struct msm_disp_state *disp_state, struct msm_dp *dp_display);
390
391bool msm_dp_wide_bus_available(const struct msm_dp *dp_display);
392
393#else
394static inline int __init msm_dp_register(void)
395{
396	return -EINVAL;
397}
398static inline void __exit msm_dp_unregister(void)
399{
400}
401static inline int msm_dp_modeset_init(struct msm_dp *dp_display,
402				       struct drm_device *dev,
403				       struct drm_encoder *encoder)
404{
405	return -EINVAL;
406}
407
408static inline void msm_dp_snapshot(struct msm_disp_state *disp_state, struct msm_dp *dp_display)
409{
410}
411
412static inline bool msm_dp_wide_bus_available(const struct msm_dp *dp_display)
413{
414	return false;
415}
416
417#endif
418
419#ifdef CONFIG_DRM_MSM_MDP4
420void msm_mdp4_register(void);
421void msm_mdp4_unregister(void);
422#else
423static inline void msm_mdp4_register(void) {}
424static inline void msm_mdp4_unregister(void) {}
425#endif
426
427#ifdef CONFIG_DRM_MSM_MDP5
428void msm_mdp_register(void);
429void msm_mdp_unregister(void);
430#else
431static inline void msm_mdp_register(void) {}
432static inline void msm_mdp_unregister(void) {}
433#endif
434
435#ifdef CONFIG_DRM_MSM_DPU
436void msm_dpu_register(void);
437void msm_dpu_unregister(void);
438#else
439static inline void msm_dpu_register(void) {}
440static inline void msm_dpu_unregister(void) {}
441#endif
442
443#ifdef CONFIG_DRM_MSM_MDSS
444void msm_mdss_register(void);
445void msm_mdss_unregister(void);
446#else
447static inline void msm_mdss_register(void) {}
448static inline void msm_mdss_unregister(void) {}
449#endif
450
451#ifdef CONFIG_DEBUG_FS
 
 
452void msm_framebuffer_describe(struct drm_framebuffer *fb, struct seq_file *m);
453int msm_debugfs_late_init(struct drm_device *dev);
454int msm_rd_debugfs_init(struct drm_minor *minor);
455void msm_rd_debugfs_cleanup(struct msm_drm_private *priv);
456__printf(3, 4)
457void msm_rd_dump_submit(struct msm_rd_state *rd, struct msm_gem_submit *submit,
458		const char *fmt, ...);
459int msm_perf_debugfs_init(struct drm_minor *minor);
460void msm_perf_debugfs_cleanup(struct msm_drm_private *priv);
461#else
462static inline int msm_debugfs_late_init(struct drm_device *dev) { return 0; }
463__printf(3, 4)
464static inline void msm_rd_dump_submit(struct msm_rd_state *rd,
465			struct msm_gem_submit *submit,
466			const char *fmt, ...) {}
467static inline void msm_rd_debugfs_cleanup(struct msm_drm_private *priv) {}
468static inline void msm_perf_debugfs_cleanup(struct msm_drm_private *priv) {}
469#endif
470
471struct clk *msm_clk_get(struct platform_device *pdev, const char *name);
472
473struct clk *msm_clk_bulk_get_clock(struct clk_bulk_data *bulk, int count,
474	const char *name);
475void __iomem *msm_ioremap(struct platform_device *pdev, const char *name);
476void __iomem *msm_ioremap_size(struct platform_device *pdev, const char *name,
477		phys_addr_t *size);
478void __iomem *msm_ioremap_quiet(struct platform_device *pdev, const char *name);
 
 
 
 
 
 
 
 
 
 
 
479
480struct icc_path *msm_icc_get(struct device *dev, const char *name);
481
482#define msm_writel(data, addr) writel((data), (addr))
483#define msm_readl(addr) readl((addr))
484
485static inline void msm_rmw(void __iomem *addr, u32 mask, u32 or)
486{
487	u32 val = msm_readl(addr);
488
489	val &= ~mask;
490	msm_writel(val | or, addr);
491}
492
493/**
494 * struct msm_hrtimer_work - a helper to combine an hrtimer with kthread_work
495 *
496 * @timer: hrtimer to control when the kthread work is triggered
497 * @work:  the kthread work
498 * @worker: the kthread worker the work will be scheduled on
499 */
500struct msm_hrtimer_work {
501	struct hrtimer timer;
502	struct kthread_work work;
503	struct kthread_worker *worker;
504};
505
506void msm_hrtimer_queue_work(struct msm_hrtimer_work *work,
507			    ktime_t wakeup_time,
508			    enum hrtimer_mode mode);
509void msm_hrtimer_work_init(struct msm_hrtimer_work *work,
510			   struct kthread_worker *worker,
511			   kthread_work_func_t fn,
512			   clockid_t clock_id,
513			   enum hrtimer_mode mode);
514
515#define DBG(fmt, ...) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
516#define VERB(fmt, ...) if (0) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
517
518static inline int align_pitch(int width, int bpp)
519{
520	int bytespp = (bpp + 7) / 8;
521	/* adreno needs pitch aligned to 32 pixels: */
522	return bytespp * ALIGN(width, 32);
523}
524
525/* for the generated headers: */
526#define INVALID_IDX(idx) ({BUG(); 0;})
527#define fui(x)                ({BUG(); 0;})
528#define _mesa_float_to_half(x) ({BUG(); 0;})
529
530
531#define FIELD(val, name) (((val) & name ## __MASK) >> name ## __SHIFT)
532
533/* for conditionally setting boolean flag(s): */
534#define COND(bool, val) ((bool) ? (val) : 0)
535
536static inline unsigned long timeout_to_jiffies(const ktime_t *timeout)
537{
538	ktime_t now = ktime_get();
539	s64 remaining_jiffies;
540
541	if (ktime_compare(*timeout, now) < 0) {
542		remaining_jiffies = 0;
543	} else {
544		ktime_t rem = ktime_sub(*timeout, now);
545		remaining_jiffies = ktime_divns(rem, NSEC_PER_SEC / HZ);
 
546	}
547
548	return clamp(remaining_jiffies, 1LL, (s64)INT_MAX);
549}
550
551/* Driver helpers */
552
553extern const struct component_master_ops msm_drm_ops;
554
555int msm_kms_pm_prepare(struct device *dev);
556void msm_kms_pm_complete(struct device *dev);
557
558int msm_drv_probe(struct device *dev,
559	int (*kms_init)(struct drm_device *dev),
560	struct msm_kms *kms);
561void msm_kms_shutdown(struct platform_device *pdev);
562
563
564#endif /* __MSM_DRV_H__ */
v5.4
  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 <robdclark@gmail.com>
  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
 
 
 
 
 
 
 
 36struct msm_kms;
 37struct msm_gpu;
 38struct msm_mmu;
 39struct msm_mdss;
 40struct msm_rd_state;
 41struct msm_perf_state;
 42struct msm_gem_submit;
 43struct msm_fence_context;
 44struct msm_gem_address_space;
 45struct 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
 55struct msm_file_private {
 56	rwlock_t queuelock;
 57	struct list_head submitqueues;
 58	int queueid;
 59	struct msm_gem_address_space *aspace;
 
 60};
 61
 62enum msm_mdp_plane_property {
 63	PLANE_PROP_ZPOS,
 64	PLANE_PROP_ALPHA,
 65	PLANE_PROP_PREMULTIPLIED,
 66	PLANE_PROP_MAX_NUM
 67};
 68
 69#define MSM_GPU_MAX_RINGS 4
 70#define MAX_H_TILES_PER_DISPLAY 2
 71
 72/**
 73 * enum msm_display_caps - features/capabilities supported by displays
 74 * @MSM_DISPLAY_CAP_VID_MODE:           Video or "active" mode supported
 75 * @MSM_DISPLAY_CAP_CMD_MODE:           Command mode supported
 76 * @MSM_DISPLAY_CAP_HOT_PLUG:           Hot plug detection supported
 77 * @MSM_DISPLAY_CAP_EDID:               EDID supported
 78 */
 79enum msm_display_caps {
 80	MSM_DISPLAY_CAP_VID_MODE	= BIT(0),
 81	MSM_DISPLAY_CAP_CMD_MODE	= BIT(1),
 82	MSM_DISPLAY_CAP_HOT_PLUG	= BIT(2),
 83	MSM_DISPLAY_CAP_EDID		= BIT(3),
 84};
 85
 86/**
 87 * enum msm_event_wait - type of HW events to wait for
 88 * @MSM_ENC_COMMIT_DONE - wait for the driver to flush the registers to HW
 89 * @MSM_ENC_TX_COMPLETE - wait for the HW to transfer the frame to panel
 90 * @MSM_ENC_VBLANK - wait for the HW VBLANK event (for driver-internal waiters)
 91 */
 92enum msm_event_wait {
 93	MSM_ENC_COMMIT_DONE = 0,
 94	MSM_ENC_TX_COMPLETE,
 95	MSM_ENC_VBLANK,
 96};
 97
 98/**
 99 * struct msm_display_topology - defines a display topology pipeline
100 * @num_lm:       number of layer mixers used
101 * @num_enc:      number of compression encoder blocks used
102 * @num_intf:     number of interfaces the panel is mounted on
 
 
 
103 */
104struct msm_display_topology {
105	u32 num_lm;
106	u32 num_enc;
107	u32 num_intf;
108};
109
110/**
111 * struct msm_display_info - defines display properties
112 * @intf_type:          DRM_MODE_ENCODER_ type
113 * @capabilities:       Bitmask of display flags
114 * @num_of_h_tiles:     Number of horizontal tiles in case of split interface
115 * @h_tile_instance:    Controller instance used per tile. Number of elements is
116 *                      based on num_of_h_tiles
117 * @is_te_using_watchdog_timer:  Boolean to indicate watchdog TE is
118 *				 used instead of panel TE in cmd mode panels
119 */
120struct msm_display_info {
121	int intf_type;
122	uint32_t capabilities;
123	uint32_t num_of_h_tiles;
124	uint32_t h_tile_instance[MAX_H_TILES_PER_DISPLAY];
125	bool is_te_using_watchdog_timer;
126};
127
128/* Commit/Event thread specific structure */
129struct msm_drm_thread {
130	struct drm_device *dev;
131	struct task_struct *thread;
132	unsigned int crtc_id;
133	struct kthread_worker worker;
134};
135
136struct msm_drm_private {
137
138	struct drm_device *dev;
139
140	struct msm_kms *kms;
 
141
142	/* subordinate devices, if present: */
143	struct platform_device *gpu_pdev;
144
145	/* top level MDSS wrapper device (for MDP5/DPU only) */
146	struct msm_mdss *mdss;
147
148	/* possibly this should be in the kms component, but it is
149	 * shared by both mdp4 and mdp5..
150	 */
151	struct hdmi *hdmi;
152
153	/* eDP is for mdp5 only, but kms has not been created
154	 * when edp_bind() and edp_init() are called. Here is the only
155	 * place to keep the edp instance.
156	 */
157	struct msm_edp *edp;
158
159	/* DSI is shared by mdp4 and mdp5 */
160	struct msm_dsi *dsi[2];
161
162	/* when we have more than one 'msm_gpu' these need to be an array: */
163	struct msm_gpu *gpu;
164	struct msm_file_private *lastctx;
165	/* gpu is only set on open(), but we need this info earlier */
166	bool is_a2xx;
167
168	struct drm_fb_helper *fbdev;
169
170	struct msm_rd_state *rd;       /* debugfs to dump all submits */
171	struct msm_rd_state *hangrd;   /* debugfs to dump hanging submits */
172	struct msm_perf_state *perf;
173
174	/* list of GEM objects: */
175	struct list_head inactive_list;
 
 
 
 
176
177	/* worker for delayed free of objects: */
178	struct work_struct free_work;
179	struct llist_head free_list;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
180
181	struct workqueue_struct *wq;
 
 
 
 
 
182
183	unsigned int num_planes;
184	struct drm_plane *planes[MAX_PLANES];
 
 
 
 
 
185
186	unsigned int num_crtcs;
187	struct drm_crtc *crtcs[MAX_CRTCS];
 
 
 
 
 
188
189	struct msm_drm_thread event_thread[MAX_CRTCS];
 
 
 
 
 
 
190
191	unsigned int num_encoders;
192	struct drm_encoder *encoders[MAX_ENCODERS];
193
194	unsigned int num_bridges;
195	struct drm_bridge *bridges[MAX_BRIDGES];
196
197	unsigned int num_connectors;
198	struct drm_connector *connectors[MAX_CONNECTORS];
199
200	/* Properties */
201	struct drm_property *plane_property[PLANE_PROP_MAX_NUM];
202
203	/* VRAM carveout, used when no IOMMU: */
204	struct {
205		unsigned long size;
206		dma_addr_t paddr;
207		/* NOTE: mm managed at the page level, size is in # of pages
208		 * and position mm_node->start is in # of pages:
209		 */
210		struct drm_mm mm;
211		spinlock_t lock; /* Protects drm_mm node allocation/removal */
212	} vram;
213
214	struct notifier_block vmap_notifier;
215	struct shrinker shrinker;
216
217	struct drm_atomic_state *pm_state;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
218};
219
220struct msm_format {
221	uint32_t pixel_format;
222};
223
224struct msm_pending_timer;
225
226int msm_atomic_prepare_fb(struct drm_plane *plane,
227			  struct drm_plane_state *new_state);
228void msm_atomic_init_pending_timer(struct msm_pending_timer *timer,
229		struct msm_kms *kms, int crtc_idx);
 
230void msm_atomic_commit_tail(struct drm_atomic_state *state);
 
231struct drm_atomic_state *msm_atomic_state_alloc(struct drm_device *dev);
232void msm_atomic_state_clear(struct drm_atomic_state *state);
233void msm_atomic_state_free(struct drm_atomic_state *state);
234
235int msm_gem_init_vma(struct msm_gem_address_space *aspace,
236		struct msm_gem_vma *vma, int npages);
237void msm_gem_purge_vma(struct msm_gem_address_space *aspace,
238		struct msm_gem_vma *vma);
239void msm_gem_unmap_vma(struct msm_gem_address_space *aspace,
240		struct msm_gem_vma *vma);
241int msm_gem_map_vma(struct msm_gem_address_space *aspace,
242		struct msm_gem_vma *vma, int prot,
243		struct sg_table *sgt, int npages);
244void msm_gem_close_vma(struct msm_gem_address_space *aspace,
245		struct msm_gem_vma *vma);
246
247void msm_gem_address_space_put(struct msm_gem_address_space *aspace);
248
249struct msm_gem_address_space *
250msm_gem_address_space_create(struct device *dev, struct iommu_domain *domain,
251		const char *name);
252
253struct msm_gem_address_space *
254msm_gem_address_space_create_a2xx(struct device *dev, struct msm_gpu *gpu,
255		const char *name, uint64_t va_start, uint64_t va_end);
256
257int msm_register_mmu(struct drm_device *dev, struct msm_mmu *mmu);
258void msm_unregister_mmu(struct drm_device *dev, struct msm_mmu *mmu);
259
 
260bool msm_use_mmu(struct drm_device *dev);
261
262void msm_gem_submit_free(struct msm_gem_submit *submit);
263int msm_ioctl_gem_submit(struct drm_device *dev, void *data,
264		struct drm_file *file);
265
266void msm_gem_shrinker_init(struct drm_device *dev);
 
 
 
 
267void msm_gem_shrinker_cleanup(struct drm_device *dev);
268
269int msm_gem_mmap_obj(struct drm_gem_object *obj,
270			struct vm_area_struct *vma);
271int msm_gem_mmap(struct file *filp, struct vm_area_struct *vma);
272vm_fault_t msm_gem_fault(struct vm_fault *vmf);
273uint64_t msm_gem_mmap_offset(struct drm_gem_object *obj);
274int msm_gem_get_iova(struct drm_gem_object *obj,
275		struct msm_gem_address_space *aspace, uint64_t *iova);
276int msm_gem_get_and_pin_iova(struct drm_gem_object *obj,
277		struct msm_gem_address_space *aspace, uint64_t *iova);
278uint64_t msm_gem_iova(struct drm_gem_object *obj,
279		struct msm_gem_address_space *aspace);
280void msm_gem_unpin_iova(struct drm_gem_object *obj,
281		struct msm_gem_address_space *aspace);
282struct page **msm_gem_get_pages(struct drm_gem_object *obj);
283void msm_gem_put_pages(struct drm_gem_object *obj);
284int msm_gem_dumb_create(struct drm_file *file, struct drm_device *dev,
285		struct drm_mode_create_dumb *args);
286int msm_gem_dumb_map_offset(struct drm_file *file, struct drm_device *dev,
287		uint32_t handle, uint64_t *offset);
288struct sg_table *msm_gem_prime_get_sg_table(struct drm_gem_object *obj);
289void *msm_gem_prime_vmap(struct drm_gem_object *obj);
290void msm_gem_prime_vunmap(struct drm_gem_object *obj, void *vaddr);
291int msm_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma);
292struct drm_gem_object *msm_gem_prime_import_sg_table(struct drm_device *dev,
293		struct dma_buf_attachment *attach, struct sg_table *sg);
294int msm_gem_prime_pin(struct drm_gem_object *obj);
295void msm_gem_prime_unpin(struct drm_gem_object *obj);
296void *msm_gem_get_vaddr(struct drm_gem_object *obj);
297void *msm_gem_get_vaddr_active(struct drm_gem_object *obj);
298void msm_gem_put_vaddr(struct drm_gem_object *obj);
299int msm_gem_madvise(struct drm_gem_object *obj, unsigned madv);
300int msm_gem_sync_object(struct drm_gem_object *obj,
301		struct msm_fence_context *fctx, bool exclusive);
302void msm_gem_move_to_active(struct drm_gem_object *obj,
303		struct msm_gpu *gpu, bool exclusive, struct dma_fence *fence);
304void msm_gem_move_to_inactive(struct drm_gem_object *obj);
305int msm_gem_cpu_prep(struct drm_gem_object *obj, uint32_t op, ktime_t *timeout);
306int msm_gem_cpu_fini(struct drm_gem_object *obj);
307void msm_gem_free_object(struct drm_gem_object *obj);
308int msm_gem_new_handle(struct drm_device *dev, struct drm_file *file,
309		uint32_t size, uint32_t flags, uint32_t *handle, char *name);
310struct drm_gem_object *msm_gem_new(struct drm_device *dev,
311		uint32_t size, uint32_t flags);
312struct drm_gem_object *msm_gem_new_locked(struct drm_device *dev,
313		uint32_t size, uint32_t flags);
314void *msm_gem_kernel_new(struct drm_device *dev, uint32_t size,
315		uint32_t flags, struct msm_gem_address_space *aspace,
316		struct drm_gem_object **bo, uint64_t *iova);
317void *msm_gem_kernel_new_locked(struct drm_device *dev, uint32_t size,
318		uint32_t flags, struct msm_gem_address_space *aspace,
319		struct drm_gem_object **bo, uint64_t *iova);
320void msm_gem_kernel_put(struct drm_gem_object *bo,
321		struct msm_gem_address_space *aspace, bool locked);
322struct drm_gem_object *msm_gem_import(struct drm_device *dev,
323		struct dma_buf *dmabuf, struct sg_table *sgt);
324void msm_gem_free_work(struct work_struct *work);
325
326__printf(2, 3)
327void msm_gem_object_set_name(struct drm_gem_object *bo, const char *fmt, ...);
328
329int msm_framebuffer_prepare(struct drm_framebuffer *fb,
330		struct msm_gem_address_space *aspace);
331void msm_framebuffer_cleanup(struct drm_framebuffer *fb,
332		struct msm_gem_address_space *aspace);
333uint32_t msm_framebuffer_iova(struct drm_framebuffer *fb,
334		struct msm_gem_address_space *aspace, int plane);
335struct drm_gem_object *msm_framebuffer_bo(struct drm_framebuffer *fb, int plane);
336const struct msm_format *msm_framebuffer_format(struct drm_framebuffer *fb);
337struct drm_framebuffer *msm_framebuffer_create(struct drm_device *dev,
338		struct drm_file *file, const struct drm_mode_fb_cmd2 *mode_cmd);
339struct drm_framebuffer * msm_alloc_stolen_fb(struct drm_device *dev,
340		int w, int h, int p, uint32_t format);
341
342struct drm_fb_helper *msm_fbdev_init(struct drm_device *dev);
343void msm_fbdev_free(struct drm_device *dev);
 
 
 
 
 
344
345struct hdmi;
 
346int msm_hdmi_modeset_init(struct hdmi *hdmi, struct drm_device *dev,
347		struct drm_encoder *encoder);
348void __init msm_hdmi_register(void);
349void __exit msm_hdmi_unregister(void);
350
351struct msm_edp;
352void __init msm_edp_register(void);
353void __exit msm_edp_unregister(void);
354int msm_edp_modeset_init(struct msm_edp *edp, struct drm_device *dev,
355		struct drm_encoder *encoder);
 
 
 
356
357struct msm_dsi;
358#ifdef CONFIG_DRM_MSM_DSI
 
 
359void __init msm_dsi_register(void);
360void __exit msm_dsi_unregister(void);
361int msm_dsi_modeset_init(struct msm_dsi *msm_dsi, struct drm_device *dev,
362			 struct drm_encoder *encoder);
 
 
 
 
 
 
363#else
364static inline void __init msm_dsi_register(void)
365{
366}
367static inline void __exit msm_dsi_unregister(void)
368{
369}
370static inline int msm_dsi_modeset_init(struct msm_dsi *msm_dsi,
371				       struct drm_device *dev,
372				       struct drm_encoder *encoder)
373{
374	return -EINVAL;
375}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
376#endif
377
378void __init msm_mdp_register(void);
379void __exit msm_mdp_unregister(void);
380void __init msm_dpu_register(void);
381void __exit msm_dpu_unregister(void);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
382
383#ifdef CONFIG_DEBUG_FS
384void msm_gem_describe(struct drm_gem_object *obj, struct seq_file *m);
385void msm_gem_describe_objects(struct list_head *list, struct seq_file *m);
386void msm_framebuffer_describe(struct drm_framebuffer *fb, struct seq_file *m);
387int msm_debugfs_late_init(struct drm_device *dev);
388int msm_rd_debugfs_init(struct drm_minor *minor);
389void msm_rd_debugfs_cleanup(struct msm_drm_private *priv);
390__printf(3, 4)
391void msm_rd_dump_submit(struct msm_rd_state *rd, struct msm_gem_submit *submit,
392		const char *fmt, ...);
393int msm_perf_debugfs_init(struct drm_minor *minor);
394void msm_perf_debugfs_cleanup(struct msm_drm_private *priv);
395#else
396static inline int msm_debugfs_late_init(struct drm_device *dev) { return 0; }
397__printf(3, 4)
398static inline void msm_rd_dump_submit(struct msm_rd_state *rd, struct msm_gem_submit *submit,
399		const char *fmt, ...) {}
 
400static inline void msm_rd_debugfs_cleanup(struct msm_drm_private *priv) {}
401static inline void msm_perf_debugfs_cleanup(struct msm_drm_private *priv) {}
402#endif
403
404struct clk *msm_clk_get(struct platform_device *pdev, const char *name);
405
406struct clk *msm_clk_bulk_get_clock(struct clk_bulk_data *bulk, int count,
407	const char *name);
408void __iomem *msm_ioremap(struct platform_device *pdev, const char *name,
409		const char *dbgname);
410void msm_writel(u32 data, void __iomem *addr);
411u32 msm_readl(const void __iomem *addr);
412
413struct msm_gpu_submitqueue;
414int msm_submitqueue_init(struct drm_device *drm, struct msm_file_private *ctx);
415struct msm_gpu_submitqueue *msm_submitqueue_get(struct msm_file_private *ctx,
416		u32 id);
417int msm_submitqueue_create(struct drm_device *drm, struct msm_file_private *ctx,
418		u32 prio, u32 flags, u32 *id);
419int msm_submitqueue_query(struct drm_device *drm, struct msm_file_private *ctx,
420		struct drm_msm_submitqueue_query *args);
421int msm_submitqueue_remove(struct msm_file_private *ctx, u32 id);
422void msm_submitqueue_close(struct msm_file_private *ctx);
423
424void msm_submitqueue_destroy(struct kref *kref);
425
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
426
427#define DBG(fmt, ...) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
428#define VERB(fmt, ...) if (0) DRM_DEBUG_DRIVER(fmt"\n", ##__VA_ARGS__)
429
430static inline int align_pitch(int width, int bpp)
431{
432	int bytespp = (bpp + 7) / 8;
433	/* adreno needs pitch aligned to 32 pixels: */
434	return bytespp * ALIGN(width, 32);
435}
436
437/* for the generated headers: */
438#define INVALID_IDX(idx) ({BUG(); 0;})
439#define fui(x)                ({BUG(); 0;})
440#define util_float_to_half(x) ({BUG(); 0;})
441
442
443#define FIELD(val, name) (((val) & name ## __MASK) >> name ## __SHIFT)
444
445/* for conditionally setting boolean flag(s): */
446#define COND(bool, val) ((bool) ? (val) : 0)
447
448static inline unsigned long timeout_to_jiffies(const ktime_t *timeout)
449{
450	ktime_t now = ktime_get();
451	unsigned long remaining_jiffies;
452
453	if (ktime_compare(*timeout, now) < 0) {
454		remaining_jiffies = 0;
455	} else {
456		ktime_t rem = ktime_sub(*timeout, now);
457		struct timespec ts = ktime_to_timespec(rem);
458		remaining_jiffies = timespec_to_jiffies(&ts);
459	}
460
461	return remaining_jiffies;
462}
 
 
 
 
 
 
 
 
 
 
 
 
 
463
464#endif /* __MSM_DRV_H__ */