1 /* SPDX-License-Identifier: GPL-2.0+ */
2 
3 #ifndef _VKMS_DRV_H_
4 #define _VKMS_DRV_H_
5 
6 #include <linux/hrtimer.h>
7 
8 #include <drm/drm.h>
9 #include <drm/drm_framebuffer.h>
10 #include <drm/drm_gem.h>
11 #include <drm/drm_gem_atomic_helper.h>
12 #include <drm/drm_encoder.h>
13 #include <drm/drm_writeback.h>
14 
15 #define XRES_MIN    20
16 #define YRES_MIN    20
17 
18 #define XRES_DEF  1024
19 #define YRES_DEF   768
20 
21 #define XRES_MAX  8192
22 #define YRES_MAX  8192
23 
24 #define NUM_OVERLAY_PLANES 8
25 
26 struct vkms_frame_info {
27 	struct drm_framebuffer *fb;
28 	struct drm_rect src, dst;
29 	struct iosys_map map[DRM_FORMAT_MAX_PLANES];
30 	unsigned int offset;
31 	unsigned int pitch;
32 	unsigned int cpp;
33 };
34 
35 struct pixel_argb_u16 {
36 	u16 a, r, g, b;
37 };
38 
39 struct line_buffer {
40 	size_t n_pixels;
41 	struct pixel_argb_u16 *pixels;
42 };
43 
44 struct vkms_writeback_job {
45 	struct iosys_map data[DRM_FORMAT_MAX_PLANES];
46 	struct vkms_frame_info wb_frame_info;
47 	void (*wb_write)(struct vkms_frame_info *frame_info,
48 			 const struct line_buffer *buffer, int y);
49 };
50 
51 /**
52  * vkms_plane_state - Driver specific plane state
53  * @base: base plane state
54  * @frame_info: data required for composing computation
55  */
56 struct vkms_plane_state {
57 	struct drm_shadow_plane_state base;
58 	struct vkms_frame_info *frame_info;
59 	void (*plane_read)(struct line_buffer *buffer,
60 			   const struct vkms_frame_info *frame_info, int y);
61 };
62 
63 struct vkms_plane {
64 	struct drm_plane base;
65 };
66 
67 /**
68  * vkms_crtc_state - Driver specific CRTC state
69  * @base: base CRTC state
70  * @composer_work: work struct to compose and add CRC entries
71  * @n_frame_start: start frame number for computed CRC
72  * @n_frame_end: end frame number for computed CRC
73  */
74 struct vkms_crtc_state {
75 	struct drm_crtc_state base;
76 	struct work_struct composer_work;
77 
78 	int num_active_planes;
79 	/* stack of active planes for crc computation, should be in z order */
80 	struct vkms_plane_state **active_planes;
81 	struct vkms_writeback_job *active_writeback;
82 
83 	/* below four are protected by vkms_output.composer_lock */
84 	bool crc_pending;
85 	bool wb_pending;
86 	u64 frame_start;
87 	u64 frame_end;
88 };
89 
90 struct vkms_output {
91 	struct drm_crtc crtc;
92 	struct drm_encoder encoder;
93 	struct drm_connector connector;
94 	struct drm_writeback_connector wb_connector;
95 	struct hrtimer vblank_hrtimer;
96 	ktime_t period_ns;
97 	struct drm_pending_vblank_event *event;
98 	/* ordered wq for composer_work */
99 	struct workqueue_struct *composer_workq;
100 	/* protects concurrent access to composer */
101 	spinlock_t lock;
102 
103 	/* protected by @lock */
104 	bool composer_enabled;
105 	struct vkms_crtc_state *composer_state;
106 
107 	spinlock_t composer_lock;
108 };
109 
110 struct vkms_device;
111 
112 struct vkms_config {
113 	bool writeback;
114 	bool cursor;
115 	bool overlay;
116 	/* only set when instantiated */
117 	struct vkms_device *dev;
118 };
119 
120 struct vkms_device {
121 	struct drm_device drm;
122 	struct platform_device *platform;
123 	struct vkms_output output;
124 	const struct vkms_config *config;
125 };
126 
127 #define drm_crtc_to_vkms_output(target) \
128 	container_of(target, struct vkms_output, crtc)
129 
130 #define drm_device_to_vkms_device(target) \
131 	container_of(target, struct vkms_device, drm)
132 
133 #define to_vkms_crtc_state(target)\
134 	container_of(target, struct vkms_crtc_state, base)
135 
136 #define to_vkms_plane_state(target)\
137 	container_of(target, struct vkms_plane_state, base.base)
138 
139 /* CRTC */
140 int vkms_crtc_init(struct drm_device *dev, struct drm_crtc *crtc,
141 		   struct drm_plane *primary, struct drm_plane *cursor);
142 
143 int vkms_output_init(struct vkms_device *vkmsdev, int index);
144 
145 struct vkms_plane *vkms_plane_init(struct vkms_device *vkmsdev,
146 				   enum drm_plane_type type, int index);
147 
148 /* CRC Support */
149 const char *const *vkms_get_crc_sources(struct drm_crtc *crtc,
150 					size_t *count);
151 int vkms_set_crc_source(struct drm_crtc *crtc, const char *src_name);
152 int vkms_verify_crc_source(struct drm_crtc *crtc, const char *source_name,
153 			   size_t *values_cnt);
154 
155 /* Composer Support */
156 void vkms_composer_worker(struct work_struct *work);
157 void vkms_set_composer(struct vkms_output *out, bool enabled);
158 
159 /* Writeback */
160 int vkms_enable_writeback_connector(struct vkms_device *vkmsdev);
161 
162 #endif /* _VKMS_DRV_H_ */
163