xref: /linux/drivers/gpu/drm/virtio/virtgpu_drv.h (revision 547f574fd9d5e3925d47fd44decbf6ab6df94b0e)
1 /*
2  * Copyright (C) 2015 Red Hat, Inc.
3  * All Rights Reserved.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining
6  * a copy of this software and associated documentation files (the
7  * "Software"), to deal in the Software without restriction, including
8  * without limitation the rights to use, copy, modify, merge, publish,
9  * distribute, sublicense, and/or sell copies of the Software, and to
10  * permit persons to whom the Software is furnished to do so, subject to
11  * the following conditions:
12  *
13  * The above copyright notice and this permission notice (including the
14  * next paragraph) shall be included in all copies or substantial
15  * portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20  * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
21  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  */
25 
26 #ifndef VIRTIO_DRV_H
27 #define VIRTIO_DRV_H
28 
29 #include <linux/virtio.h>
30 #include <linux/virtio_ids.h>
31 #include <linux/virtio_config.h>
32 #include <linux/virtio_gpu.h>
33 
34 #include <drm/drm_atomic.h>
35 #include <drm/drm_drv.h>
36 #include <drm/drm_encoder.h>
37 #include <drm/drm_fb_helper.h>
38 #include <drm/drm_gem.h>
39 #include <drm/drm_gem_shmem_helper.h>
40 #include <drm/drm_ioctl.h>
41 #include <drm/drm_probe_helper.h>
42 #include <drm/virtgpu_drm.h>
43 
44 #define DRIVER_NAME "virtio_gpu"
45 #define DRIVER_DESC "virtio GPU"
46 #define DRIVER_DATE "0"
47 
48 #define DRIVER_MAJOR 0
49 #define DRIVER_MINOR 1
50 #define DRIVER_PATCHLEVEL 0
51 
52 #define UUID_INITIALIZING 0
53 #define UUID_INITIALIZED 1
54 #define UUID_INITIALIZATION_FAILED 2
55 
56 struct virtio_gpu_object_params {
57 	uint32_t format;
58 	uint32_t width;
59 	uint32_t height;
60 	unsigned long size;
61 	bool dumb;
62 	/* 3d */
63 	bool virgl;
64 	uint32_t target;
65 	uint32_t bind;
66 	uint32_t depth;
67 	uint32_t array_size;
68 	uint32_t last_level;
69 	uint32_t nr_samples;
70 	uint32_t flags;
71 };
72 
73 struct virtio_gpu_object {
74 	struct drm_gem_shmem_object base;
75 	uint32_t hw_res_handle;
76 	bool dumb;
77 	bool created;
78 
79 	int uuid_state;
80 	uuid_t uuid;
81 };
82 #define gem_to_virtio_gpu_obj(gobj) \
83 	container_of((gobj), struct virtio_gpu_object, base.base)
84 
85 struct virtio_gpu_object_shmem {
86 	struct virtio_gpu_object base;
87 	struct sg_table *pages;
88 	uint32_t mapped;
89 };
90 
91 #define to_virtio_gpu_shmem(virtio_gpu_object) \
92 	container_of((virtio_gpu_object), struct virtio_gpu_object_shmem, base)
93 
94 struct virtio_gpu_object_array {
95 	struct ww_acquire_ctx ticket;
96 	struct list_head next;
97 	u32 nents, total;
98 	struct drm_gem_object *objs[];
99 };
100 
101 struct virtio_gpu_vbuffer;
102 struct virtio_gpu_device;
103 
104 typedef void (*virtio_gpu_resp_cb)(struct virtio_gpu_device *vgdev,
105 				   struct virtio_gpu_vbuffer *vbuf);
106 
107 struct virtio_gpu_fence_driver {
108 	atomic64_t       last_seq;
109 	uint64_t         sync_seq;
110 	uint64_t         context;
111 	struct list_head fences;
112 	spinlock_t       lock;
113 };
114 
115 struct virtio_gpu_fence {
116 	struct dma_fence f;
117 	struct virtio_gpu_fence_driver *drv;
118 	struct list_head node;
119 };
120 
121 struct virtio_gpu_vbuffer {
122 	char *buf;
123 	int size;
124 
125 	void *data_buf;
126 	uint32_t data_size;
127 
128 	char *resp_buf;
129 	int resp_size;
130 	virtio_gpu_resp_cb resp_cb;
131 	void *resp_cb_data;
132 
133 	struct virtio_gpu_object_array *objs;
134 	struct list_head list;
135 };
136 
137 struct virtio_gpu_output {
138 	int index;
139 	struct drm_crtc crtc;
140 	struct drm_connector conn;
141 	struct drm_encoder enc;
142 	struct virtio_gpu_display_one info;
143 	struct virtio_gpu_update_cursor cursor;
144 	struct edid *edid;
145 	int cur_x;
146 	int cur_y;
147 	bool needs_modeset;
148 };
149 #define drm_crtc_to_virtio_gpu_output(x) \
150 	container_of(x, struct virtio_gpu_output, crtc)
151 
152 struct virtio_gpu_framebuffer {
153 	struct drm_framebuffer base;
154 	struct virtio_gpu_fence *fence;
155 };
156 #define to_virtio_gpu_framebuffer(x) \
157 	container_of(x, struct virtio_gpu_framebuffer, base)
158 
159 struct virtio_gpu_queue {
160 	struct virtqueue *vq;
161 	spinlock_t qlock;
162 	wait_queue_head_t ack_queue;
163 	struct work_struct dequeue_work;
164 };
165 
166 struct virtio_gpu_drv_capset {
167 	uint32_t id;
168 	uint32_t max_version;
169 	uint32_t max_size;
170 };
171 
172 struct virtio_gpu_drv_cap_cache {
173 	struct list_head head;
174 	void *caps_cache;
175 	uint32_t id;
176 	uint32_t version;
177 	uint32_t size;
178 	atomic_t is_valid;
179 };
180 
181 struct virtio_gpu_device {
182 	struct device *dev;
183 	struct drm_device *ddev;
184 
185 	struct virtio_device *vdev;
186 
187 	struct virtio_gpu_output outputs[VIRTIO_GPU_MAX_SCANOUTS];
188 	uint32_t num_scanouts;
189 
190 	struct virtio_gpu_queue ctrlq;
191 	struct virtio_gpu_queue cursorq;
192 	struct kmem_cache *vbufs;
193 
194 	atomic_t pending_commands;
195 
196 	struct ida	resource_ida;
197 
198 	wait_queue_head_t resp_wq;
199 	/* current display info */
200 	spinlock_t display_info_lock;
201 	bool display_info_pending;
202 
203 	struct virtio_gpu_fence_driver fence_drv;
204 
205 	struct ida	ctx_id_ida;
206 
207 	bool has_virgl_3d;
208 	bool has_edid;
209 	bool has_indirect;
210 	bool has_resource_assign_uuid;
211 
212 	struct work_struct config_changed_work;
213 
214 	struct work_struct obj_free_work;
215 	spinlock_t obj_free_lock;
216 	struct list_head obj_free_list;
217 
218 	struct virtio_gpu_drv_capset *capsets;
219 	uint32_t num_capsets;
220 	struct list_head cap_cache;
221 
222 	/* protects resource state when exporting */
223 	spinlock_t resource_export_lock;
224 };
225 
226 struct virtio_gpu_fpriv {
227 	uint32_t ctx_id;
228 	bool context_created;
229 	struct mutex context_lock;
230 };
231 
232 /* virtgpu_ioctl.c */
233 #define DRM_VIRTIO_NUM_IOCTLS 10
234 extern struct drm_ioctl_desc virtio_gpu_ioctls[DRM_VIRTIO_NUM_IOCTLS];
235 void virtio_gpu_create_context(struct drm_device *dev, struct drm_file *file);
236 
237 /* virtgpu_kms.c */
238 int virtio_gpu_init(struct drm_device *dev);
239 void virtio_gpu_deinit(struct drm_device *dev);
240 void virtio_gpu_release(struct drm_device *dev);
241 int virtio_gpu_driver_open(struct drm_device *dev, struct drm_file *file);
242 void virtio_gpu_driver_postclose(struct drm_device *dev, struct drm_file *file);
243 
244 /* virtgpu_gem.c */
245 int virtio_gpu_gem_object_open(struct drm_gem_object *obj,
246 			       struct drm_file *file);
247 void virtio_gpu_gem_object_close(struct drm_gem_object *obj,
248 				 struct drm_file *file);
249 int virtio_gpu_mode_dumb_create(struct drm_file *file_priv,
250 				struct drm_device *dev,
251 				struct drm_mode_create_dumb *args);
252 int virtio_gpu_mode_dumb_mmap(struct drm_file *file_priv,
253 			      struct drm_device *dev,
254 			      uint32_t handle, uint64_t *offset_p);
255 
256 struct virtio_gpu_object_array *virtio_gpu_array_alloc(u32 nents);
257 struct virtio_gpu_object_array*
258 virtio_gpu_array_from_handles(struct drm_file *drm_file, u32 *handles, u32 nents);
259 void virtio_gpu_array_add_obj(struct virtio_gpu_object_array *objs,
260 			      struct drm_gem_object *obj);
261 int virtio_gpu_array_lock_resv(struct virtio_gpu_object_array *objs);
262 void virtio_gpu_array_unlock_resv(struct virtio_gpu_object_array *objs);
263 void virtio_gpu_array_add_fence(struct virtio_gpu_object_array *objs,
264 				struct dma_fence *fence);
265 void virtio_gpu_array_put_free(struct virtio_gpu_object_array *objs);
266 void virtio_gpu_array_put_free_delayed(struct virtio_gpu_device *vgdev,
267 				       struct virtio_gpu_object_array *objs);
268 void virtio_gpu_array_put_free_work(struct work_struct *work);
269 
270 /* virtgpu_vq.c */
271 int virtio_gpu_alloc_vbufs(struct virtio_gpu_device *vgdev);
272 void virtio_gpu_free_vbufs(struct virtio_gpu_device *vgdev);
273 void virtio_gpu_cmd_create_resource(struct virtio_gpu_device *vgdev,
274 				    struct virtio_gpu_object *bo,
275 				    struct virtio_gpu_object_params *params,
276 				    struct virtio_gpu_object_array *objs,
277 				    struct virtio_gpu_fence *fence);
278 void virtio_gpu_cmd_unref_resource(struct virtio_gpu_device *vgdev,
279 				   struct virtio_gpu_object *bo);
280 void virtio_gpu_cmd_transfer_to_host_2d(struct virtio_gpu_device *vgdev,
281 					uint64_t offset,
282 					uint32_t width, uint32_t height,
283 					uint32_t x, uint32_t y,
284 					struct virtio_gpu_object_array *objs,
285 					struct virtio_gpu_fence *fence);
286 void virtio_gpu_cmd_resource_flush(struct virtio_gpu_device *vgdev,
287 				   uint32_t resource_id,
288 				   uint32_t x, uint32_t y,
289 				   uint32_t width, uint32_t height);
290 void virtio_gpu_cmd_set_scanout(struct virtio_gpu_device *vgdev,
291 				uint32_t scanout_id, uint32_t resource_id,
292 				uint32_t width, uint32_t height,
293 				uint32_t x, uint32_t y);
294 void virtio_gpu_object_attach(struct virtio_gpu_device *vgdev,
295 			      struct virtio_gpu_object *obj,
296 			      struct virtio_gpu_mem_entry *ents,
297 			      unsigned int nents);
298 int virtio_gpu_attach_status_page(struct virtio_gpu_device *vgdev);
299 int virtio_gpu_detach_status_page(struct virtio_gpu_device *vgdev);
300 void virtio_gpu_cursor_ping(struct virtio_gpu_device *vgdev,
301 			    struct virtio_gpu_output *output);
302 int virtio_gpu_cmd_get_display_info(struct virtio_gpu_device *vgdev);
303 int virtio_gpu_cmd_get_capset_info(struct virtio_gpu_device *vgdev, int idx);
304 int virtio_gpu_cmd_get_capset(struct virtio_gpu_device *vgdev,
305 			      int idx, int version,
306 			      struct virtio_gpu_drv_cap_cache **cache_p);
307 int virtio_gpu_cmd_get_edids(struct virtio_gpu_device *vgdev);
308 void virtio_gpu_cmd_context_create(struct virtio_gpu_device *vgdev, uint32_t id,
309 				   uint32_t nlen, const char *name);
310 void virtio_gpu_cmd_context_destroy(struct virtio_gpu_device *vgdev,
311 				    uint32_t id);
312 void virtio_gpu_cmd_context_attach_resource(struct virtio_gpu_device *vgdev,
313 					    uint32_t ctx_id,
314 					    struct virtio_gpu_object_array *objs);
315 void virtio_gpu_cmd_context_detach_resource(struct virtio_gpu_device *vgdev,
316 					    uint32_t ctx_id,
317 					    struct virtio_gpu_object_array *objs);
318 void virtio_gpu_cmd_submit(struct virtio_gpu_device *vgdev,
319 			   void *data, uint32_t data_size,
320 			   uint32_t ctx_id,
321 			   struct virtio_gpu_object_array *objs,
322 			   struct virtio_gpu_fence *fence);
323 void virtio_gpu_cmd_transfer_from_host_3d(struct virtio_gpu_device *vgdev,
324 					  uint32_t ctx_id,
325 					  uint64_t offset, uint32_t level,
326 					  struct drm_virtgpu_3d_box *box,
327 					  struct virtio_gpu_object_array *objs,
328 					  struct virtio_gpu_fence *fence);
329 void virtio_gpu_cmd_transfer_to_host_3d(struct virtio_gpu_device *vgdev,
330 					uint32_t ctx_id,
331 					uint64_t offset, uint32_t level,
332 					struct drm_virtgpu_3d_box *box,
333 					struct virtio_gpu_object_array *objs,
334 					struct virtio_gpu_fence *fence);
335 void
336 virtio_gpu_cmd_resource_create_3d(struct virtio_gpu_device *vgdev,
337 				  struct virtio_gpu_object *bo,
338 				  struct virtio_gpu_object_params *params,
339 				  struct virtio_gpu_object_array *objs,
340 				  struct virtio_gpu_fence *fence);
341 void virtio_gpu_ctrl_ack(struct virtqueue *vq);
342 void virtio_gpu_cursor_ack(struct virtqueue *vq);
343 void virtio_gpu_fence_ack(struct virtqueue *vq);
344 void virtio_gpu_dequeue_ctrl_func(struct work_struct *work);
345 void virtio_gpu_dequeue_cursor_func(struct work_struct *work);
346 void virtio_gpu_dequeue_fence_func(struct work_struct *work);
347 
348 void virtio_gpu_notify(struct virtio_gpu_device *vgdev);
349 
350 int
351 virtio_gpu_cmd_resource_assign_uuid(struct virtio_gpu_device *vgdev,
352 				    struct virtio_gpu_object_array *objs);
353 
354 /* virtgpu_display.c */
355 int virtio_gpu_modeset_init(struct virtio_gpu_device *vgdev);
356 void virtio_gpu_modeset_fini(struct virtio_gpu_device *vgdev);
357 
358 /* virtgpu_plane.c */
359 uint32_t virtio_gpu_translate_format(uint32_t drm_fourcc);
360 struct drm_plane *virtio_gpu_plane_init(struct virtio_gpu_device *vgdev,
361 					enum drm_plane_type type,
362 					int index);
363 
364 /* virtgpu_fence.c */
365 struct virtio_gpu_fence *virtio_gpu_fence_alloc(
366 	struct virtio_gpu_device *vgdev);
367 void virtio_gpu_fence_emit(struct virtio_gpu_device *vgdev,
368 			  struct virtio_gpu_ctrl_hdr *cmd_hdr,
369 			  struct virtio_gpu_fence *fence);
370 void virtio_gpu_fence_event_process(struct virtio_gpu_device *vdev,
371 				    u64 last_seq);
372 
373 /* virtgpu_object.c */
374 void virtio_gpu_cleanup_object(struct virtio_gpu_object *bo);
375 struct drm_gem_object *virtio_gpu_create_object(struct drm_device *dev,
376 						size_t size);
377 int virtio_gpu_object_create(struct virtio_gpu_device *vgdev,
378 			     struct virtio_gpu_object_params *params,
379 			     struct virtio_gpu_object **bo_ptr,
380 			     struct virtio_gpu_fence *fence);
381 
382 bool virtio_gpu_is_shmem(struct virtio_gpu_object *bo);
383 
384 /* virtgpu_prime.c */
385 struct dma_buf *virtgpu_gem_prime_export(struct drm_gem_object *obj,
386 					 int flags);
387 struct drm_gem_object *virtgpu_gem_prime_import(struct drm_device *dev,
388 						struct dma_buf *buf);
389 int virtgpu_gem_prime_get_uuid(struct drm_gem_object *obj,
390 			       uuid_t *uuid);
391 struct drm_gem_object *virtgpu_gem_prime_import_sg_table(
392 	struct drm_device *dev, struct dma_buf_attachment *attach,
393 	struct sg_table *sgt);
394 
395 /* virtgpu_debugfs.c */
396 void virtio_gpu_debugfs_init(struct drm_minor *minor);
397 
398 #endif
399