xref: /openbmc/linux/drivers/gpu/drm/msm/msm_drv.c (revision 70a59dd8)
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 #include <linux/dma-mapping.h>
9 #include <linux/kthread.h>
10 #include <linux/uaccess.h>
11 #include <uapi/linux/sched/types.h>
12 
13 #include <drm/drm_drv.h>
14 #include <drm/drm_file.h>
15 #include <drm/drm_ioctl.h>
16 #include <drm/drm_irq.h>
17 #include <drm/drm_prime.h>
18 #include <drm/drm_of.h>
19 #include <drm/drm_vblank.h>
20 
21 #include "msm_drv.h"
22 #include "msm_debugfs.h"
23 #include "msm_fence.h"
24 #include "msm_gem.h"
25 #include "msm_gpu.h"
26 #include "msm_kms.h"
27 #include "adreno/adreno_gpu.h"
28 
29 /*
30  * MSM driver version:
31  * - 1.0.0 - initial interface
32  * - 1.1.0 - adds madvise, and support for submits with > 4 cmd buffers
33  * - 1.2.0 - adds explicit fence support for submit ioctl
34  * - 1.3.0 - adds GMEM_BASE + NR_RINGS params, SUBMITQUEUE_NEW +
35  *           SUBMITQUEUE_CLOSE ioctls, and MSM_INFO_IOVA flag for
36  *           MSM_GEM_INFO ioctl.
37  * - 1.4.0 - softpin, MSM_RELOC_BO_DUMP, and GEM_INFO support to set/get
38  *           GEM object's debug name
39  * - 1.5.0 - Add SUBMITQUERY_QUERY ioctl
40  * - 1.6.0 - Syncobj support
41  */
42 #define MSM_VERSION_MAJOR	1
43 #define MSM_VERSION_MINOR	6
44 #define MSM_VERSION_PATCHLEVEL	0
45 
46 static const struct drm_mode_config_funcs mode_config_funcs = {
47 	.fb_create = msm_framebuffer_create,
48 	.output_poll_changed = drm_fb_helper_output_poll_changed,
49 	.atomic_check = drm_atomic_helper_check,
50 	.atomic_commit = drm_atomic_helper_commit,
51 };
52 
53 static const struct drm_mode_config_helper_funcs mode_config_helper_funcs = {
54 	.atomic_commit_tail = msm_atomic_commit_tail,
55 };
56 
57 #ifdef CONFIG_DRM_MSM_REGISTER_LOGGING
58 static bool reglog = false;
59 MODULE_PARM_DESC(reglog, "Enable register read/write logging");
60 module_param(reglog, bool, 0600);
61 #else
62 #define reglog 0
63 #endif
64 
65 #ifdef CONFIG_DRM_FBDEV_EMULATION
66 static bool fbdev = true;
67 MODULE_PARM_DESC(fbdev, "Enable fbdev compat layer");
68 module_param(fbdev, bool, 0600);
69 #endif
70 
71 static char *vram = "16m";
72 MODULE_PARM_DESC(vram, "Configure VRAM size (for devices without IOMMU/GPUMMU)");
73 module_param(vram, charp, 0);
74 
75 bool dumpstate = false;
76 MODULE_PARM_DESC(dumpstate, "Dump KMS state on errors");
77 module_param(dumpstate, bool, 0600);
78 
79 static bool modeset = true;
80 MODULE_PARM_DESC(modeset, "Use kernel modesetting [KMS] (1=on (default), 0=disable)");
81 module_param(modeset, bool, 0600);
82 
83 /*
84  * Util/helpers:
85  */
86 
87 struct clk *msm_clk_bulk_get_clock(struct clk_bulk_data *bulk, int count,
88 		const char *name)
89 {
90 	int i;
91 	char n[32];
92 
93 	snprintf(n, sizeof(n), "%s_clk", name);
94 
95 	for (i = 0; bulk && i < count; i++) {
96 		if (!strcmp(bulk[i].id, name) || !strcmp(bulk[i].id, n))
97 			return bulk[i].clk;
98 	}
99 
100 
101 	return NULL;
102 }
103 
104 struct clk *msm_clk_get(struct platform_device *pdev, const char *name)
105 {
106 	struct clk *clk;
107 	char name2[32];
108 
109 	clk = devm_clk_get(&pdev->dev, name);
110 	if (!IS_ERR(clk) || PTR_ERR(clk) == -EPROBE_DEFER)
111 		return clk;
112 
113 	snprintf(name2, sizeof(name2), "%s_clk", name);
114 
115 	clk = devm_clk_get(&pdev->dev, name2);
116 	if (!IS_ERR(clk))
117 		dev_warn(&pdev->dev, "Using legacy clk name binding.  Use "
118 				"\"%s\" instead of \"%s\"\n", name, name2);
119 
120 	return clk;
121 }
122 
123 void __iomem *_msm_ioremap(struct platform_device *pdev, const char *name,
124 			   const char *dbgname, bool quiet)
125 {
126 	struct resource *res;
127 	unsigned long size;
128 	void __iomem *ptr;
129 
130 	if (name)
131 		res = platform_get_resource_byname(pdev, IORESOURCE_MEM, name);
132 	else
133 		res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
134 
135 	if (!res) {
136 		if (!quiet)
137 			DRM_DEV_ERROR(&pdev->dev, "failed to get memory resource: %s\n", name);
138 		return ERR_PTR(-EINVAL);
139 	}
140 
141 	size = resource_size(res);
142 
143 	ptr = devm_ioremap(&pdev->dev, res->start, size);
144 	if (!ptr) {
145 		if (!quiet)
146 			DRM_DEV_ERROR(&pdev->dev, "failed to ioremap: %s\n", name);
147 		return ERR_PTR(-ENOMEM);
148 	}
149 
150 	if (reglog)
151 		printk(KERN_DEBUG "IO:region %s %p %08lx\n", dbgname, ptr, size);
152 
153 	return ptr;
154 }
155 
156 void __iomem *msm_ioremap(struct platform_device *pdev, const char *name,
157 			  const char *dbgname)
158 {
159 	return _msm_ioremap(pdev, name, dbgname, false);
160 }
161 
162 void __iomem *msm_ioremap_quiet(struct platform_device *pdev, const char *name,
163 				const char *dbgname)
164 {
165 	return _msm_ioremap(pdev, name, dbgname, true);
166 }
167 
168 void msm_writel(u32 data, void __iomem *addr)
169 {
170 	if (reglog)
171 		printk(KERN_DEBUG "IO:W %p %08x\n", addr, data);
172 	writel(data, addr);
173 }
174 
175 u32 msm_readl(const void __iomem *addr)
176 {
177 	u32 val = readl(addr);
178 	if (reglog)
179 		pr_err("IO:R %p %08x\n", addr, val);
180 	return val;
181 }
182 
183 struct msm_vblank_work {
184 	struct work_struct work;
185 	int crtc_id;
186 	bool enable;
187 	struct msm_drm_private *priv;
188 };
189 
190 static void vblank_ctrl_worker(struct work_struct *work)
191 {
192 	struct msm_vblank_work *vbl_work = container_of(work,
193 						struct msm_vblank_work, work);
194 	struct msm_drm_private *priv = vbl_work->priv;
195 	struct msm_kms *kms = priv->kms;
196 
197 	if (vbl_work->enable)
198 		kms->funcs->enable_vblank(kms, priv->crtcs[vbl_work->crtc_id]);
199 	else
200 		kms->funcs->disable_vblank(kms,	priv->crtcs[vbl_work->crtc_id]);
201 
202 	kfree(vbl_work);
203 }
204 
205 static int vblank_ctrl_queue_work(struct msm_drm_private *priv,
206 					int crtc_id, bool enable)
207 {
208 	struct msm_vblank_work *vbl_work;
209 
210 	vbl_work = kzalloc(sizeof(*vbl_work), GFP_ATOMIC);
211 	if (!vbl_work)
212 		return -ENOMEM;
213 
214 	INIT_WORK(&vbl_work->work, vblank_ctrl_worker);
215 
216 	vbl_work->crtc_id = crtc_id;
217 	vbl_work->enable = enable;
218 	vbl_work->priv = priv;
219 
220 	queue_work(priv->wq, &vbl_work->work);
221 
222 	return 0;
223 }
224 
225 static int msm_drm_uninit(struct device *dev)
226 {
227 	struct platform_device *pdev = to_platform_device(dev);
228 	struct drm_device *ddev = platform_get_drvdata(pdev);
229 	struct msm_drm_private *priv = ddev->dev_private;
230 	struct msm_kms *kms = priv->kms;
231 	struct msm_mdss *mdss = priv->mdss;
232 	int i;
233 
234 	/*
235 	 * Shutdown the hw if we're far enough along where things might be on.
236 	 * If we run this too early, we'll end up panicking in any variety of
237 	 * places. Since we don't register the drm device until late in
238 	 * msm_drm_init, drm_dev->registered is used as an indicator that the
239 	 * shutdown will be successful.
240 	 */
241 	if (ddev->registered) {
242 		drm_dev_unregister(ddev);
243 		drm_atomic_helper_shutdown(ddev);
244 	}
245 
246 	/* We must cancel and cleanup any pending vblank enable/disable
247 	 * work before drm_irq_uninstall() to avoid work re-enabling an
248 	 * irq after uninstall has disabled it.
249 	 */
250 
251 	flush_workqueue(priv->wq);
252 
253 	/* clean up event worker threads */
254 	for (i = 0; i < priv->num_crtcs; i++) {
255 		if (priv->event_thread[i].worker)
256 			kthread_destroy_worker(priv->event_thread[i].worker);
257 	}
258 
259 	msm_gem_shrinker_cleanup(ddev);
260 
261 	drm_kms_helper_poll_fini(ddev);
262 
263 	msm_perf_debugfs_cleanup(priv);
264 	msm_rd_debugfs_cleanup(priv);
265 
266 #ifdef CONFIG_DRM_FBDEV_EMULATION
267 	if (fbdev && priv->fbdev)
268 		msm_fbdev_free(ddev);
269 #endif
270 
271 	drm_mode_config_cleanup(ddev);
272 
273 	pm_runtime_get_sync(dev);
274 	drm_irq_uninstall(ddev);
275 	pm_runtime_put_sync(dev);
276 
277 	if (kms && kms->funcs)
278 		kms->funcs->destroy(kms);
279 
280 	if (priv->vram.paddr) {
281 		unsigned long attrs = DMA_ATTR_NO_KERNEL_MAPPING;
282 		drm_mm_takedown(&priv->vram.mm);
283 		dma_free_attrs(dev, priv->vram.size, NULL,
284 			       priv->vram.paddr, attrs);
285 	}
286 
287 	component_unbind_all(dev, ddev);
288 
289 	if (mdss && mdss->funcs)
290 		mdss->funcs->destroy(ddev);
291 
292 	ddev->dev_private = NULL;
293 	drm_dev_put(ddev);
294 
295 	destroy_workqueue(priv->wq);
296 	kfree(priv);
297 
298 	return 0;
299 }
300 
301 #define KMS_MDP4 4
302 #define KMS_MDP5 5
303 #define KMS_DPU  3
304 
305 static int get_mdp_ver(struct platform_device *pdev)
306 {
307 	struct device *dev = &pdev->dev;
308 
309 	return (int) (unsigned long) of_device_get_match_data(dev);
310 }
311 
312 #include <linux/of_address.h>
313 
314 bool msm_use_mmu(struct drm_device *dev)
315 {
316 	struct msm_drm_private *priv = dev->dev_private;
317 
318 	/* a2xx comes with its own MMU */
319 	return priv->is_a2xx || iommu_present(&platform_bus_type);
320 }
321 
322 static int msm_init_vram(struct drm_device *dev)
323 {
324 	struct msm_drm_private *priv = dev->dev_private;
325 	struct device_node *node;
326 	unsigned long size = 0;
327 	int ret = 0;
328 
329 	/* In the device-tree world, we could have a 'memory-region'
330 	 * phandle, which gives us a link to our "vram".  Allocating
331 	 * is all nicely abstracted behind the dma api, but we need
332 	 * to know the entire size to allocate it all in one go. There
333 	 * are two cases:
334 	 *  1) device with no IOMMU, in which case we need exclusive
335 	 *     access to a VRAM carveout big enough for all gpu
336 	 *     buffers
337 	 *  2) device with IOMMU, but where the bootloader puts up
338 	 *     a splash screen.  In this case, the VRAM carveout
339 	 *     need only be large enough for fbdev fb.  But we need
340 	 *     exclusive access to the buffer to avoid the kernel
341 	 *     using those pages for other purposes (which appears
342 	 *     as corruption on screen before we have a chance to
343 	 *     load and do initial modeset)
344 	 */
345 
346 	node = of_parse_phandle(dev->dev->of_node, "memory-region", 0);
347 	if (node) {
348 		struct resource r;
349 		ret = of_address_to_resource(node, 0, &r);
350 		of_node_put(node);
351 		if (ret)
352 			return ret;
353 		size = r.end - r.start;
354 		DRM_INFO("using VRAM carveout: %lx@%pa\n", size, &r.start);
355 
356 		/* if we have no IOMMU, then we need to use carveout allocator.
357 		 * Grab the entire CMA chunk carved out in early startup in
358 		 * mach-msm:
359 		 */
360 	} else if (!msm_use_mmu(dev)) {
361 		DRM_INFO("using %s VRAM carveout\n", vram);
362 		size = memparse(vram, NULL);
363 	}
364 
365 	if (size) {
366 		unsigned long attrs = 0;
367 		void *p;
368 
369 		priv->vram.size = size;
370 
371 		drm_mm_init(&priv->vram.mm, 0, (size >> PAGE_SHIFT) - 1);
372 		spin_lock_init(&priv->vram.lock);
373 
374 		attrs |= DMA_ATTR_NO_KERNEL_MAPPING;
375 		attrs |= DMA_ATTR_WRITE_COMBINE;
376 
377 		/* note that for no-kernel-mapping, the vaddr returned
378 		 * is bogus, but non-null if allocation succeeded:
379 		 */
380 		p = dma_alloc_attrs(dev->dev, size,
381 				&priv->vram.paddr, GFP_KERNEL, attrs);
382 		if (!p) {
383 			DRM_DEV_ERROR(dev->dev, "failed to allocate VRAM\n");
384 			priv->vram.paddr = 0;
385 			return -ENOMEM;
386 		}
387 
388 		DRM_DEV_INFO(dev->dev, "VRAM: %08x->%08x\n",
389 				(uint32_t)priv->vram.paddr,
390 				(uint32_t)(priv->vram.paddr + size));
391 	}
392 
393 	return ret;
394 }
395 
396 static int msm_drm_init(struct device *dev, const struct drm_driver *drv)
397 {
398 	struct platform_device *pdev = to_platform_device(dev);
399 	struct drm_device *ddev;
400 	struct msm_drm_private *priv;
401 	struct msm_kms *kms;
402 	struct msm_mdss *mdss;
403 	int ret, i;
404 
405 	ddev = drm_dev_alloc(drv, dev);
406 	if (IS_ERR(ddev)) {
407 		DRM_DEV_ERROR(dev, "failed to allocate drm_device\n");
408 		return PTR_ERR(ddev);
409 	}
410 
411 	platform_set_drvdata(pdev, ddev);
412 
413 	priv = kzalloc(sizeof(*priv), GFP_KERNEL);
414 	if (!priv) {
415 		ret = -ENOMEM;
416 		goto err_put_drm_dev;
417 	}
418 
419 	ddev->dev_private = priv;
420 	priv->dev = ddev;
421 
422 	switch (get_mdp_ver(pdev)) {
423 	case KMS_MDP5:
424 		ret = mdp5_mdss_init(ddev);
425 		break;
426 	case KMS_DPU:
427 		ret = dpu_mdss_init(ddev);
428 		break;
429 	default:
430 		ret = 0;
431 		break;
432 	}
433 	if (ret)
434 		goto err_free_priv;
435 
436 	mdss = priv->mdss;
437 
438 	priv->wq = alloc_ordered_workqueue("msm", 0);
439 
440 	INIT_WORK(&priv->free_work, msm_gem_free_work);
441 	init_llist_head(&priv->free_list);
442 
443 	INIT_LIST_HEAD(&priv->inactive_list);
444 
445 	drm_mode_config_init(ddev);
446 
447 	/* Bind all our sub-components: */
448 	ret = component_bind_all(dev, ddev);
449 	if (ret)
450 		goto err_destroy_mdss;
451 
452 	ret = msm_init_vram(ddev);
453 	if (ret)
454 		goto err_msm_uninit;
455 
456 	dma_set_max_seg_size(dev, UINT_MAX);
457 
458 	msm_gem_shrinker_init(ddev);
459 
460 	switch (get_mdp_ver(pdev)) {
461 	case KMS_MDP4:
462 		kms = mdp4_kms_init(ddev);
463 		priv->kms = kms;
464 		break;
465 	case KMS_MDP5:
466 		kms = mdp5_kms_init(ddev);
467 		break;
468 	case KMS_DPU:
469 		kms = dpu_kms_init(ddev);
470 		priv->kms = kms;
471 		break;
472 	default:
473 		/* valid only for the dummy headless case, where of_node=NULL */
474 		WARN_ON(dev->of_node);
475 		kms = NULL;
476 		break;
477 	}
478 
479 	if (IS_ERR(kms)) {
480 		DRM_DEV_ERROR(dev, "failed to load kms\n");
481 		ret = PTR_ERR(kms);
482 		priv->kms = NULL;
483 		goto err_msm_uninit;
484 	}
485 
486 	/* Enable normalization of plane zpos */
487 	ddev->mode_config.normalize_zpos = true;
488 
489 	if (kms) {
490 		kms->dev = ddev;
491 		ret = kms->funcs->hw_init(kms);
492 		if (ret) {
493 			DRM_DEV_ERROR(dev, "kms hw init failed: %d\n", ret);
494 			goto err_msm_uninit;
495 		}
496 	}
497 
498 	ddev->mode_config.funcs = &mode_config_funcs;
499 	ddev->mode_config.helper_private = &mode_config_helper_funcs;
500 
501 	for (i = 0; i < priv->num_crtcs; i++) {
502 		/* initialize event thread */
503 		priv->event_thread[i].crtc_id = priv->crtcs[i]->base.id;
504 		priv->event_thread[i].dev = ddev;
505 		priv->event_thread[i].worker = kthread_create_worker(0,
506 			"crtc_event:%d", priv->event_thread[i].crtc_id);
507 		if (IS_ERR(priv->event_thread[i].worker)) {
508 			DRM_DEV_ERROR(dev, "failed to create crtc_event kthread\n");
509 			goto err_msm_uninit;
510 		}
511 
512 		sched_set_fifo(priv->event_thread[i].worker->task);
513 	}
514 
515 	ret = drm_vblank_init(ddev, priv->num_crtcs);
516 	if (ret < 0) {
517 		DRM_DEV_ERROR(dev, "failed to initialize vblank\n");
518 		goto err_msm_uninit;
519 	}
520 
521 	if (kms) {
522 		pm_runtime_get_sync(dev);
523 		ret = drm_irq_install(ddev, kms->irq);
524 		pm_runtime_put_sync(dev);
525 		if (ret < 0) {
526 			DRM_DEV_ERROR(dev, "failed to install IRQ handler\n");
527 			goto err_msm_uninit;
528 		}
529 	}
530 
531 	ret = drm_dev_register(ddev, 0);
532 	if (ret)
533 		goto err_msm_uninit;
534 
535 	drm_mode_config_reset(ddev);
536 
537 #ifdef CONFIG_DRM_FBDEV_EMULATION
538 	if (kms && fbdev)
539 		priv->fbdev = msm_fbdev_init(ddev);
540 #endif
541 
542 	ret = msm_debugfs_late_init(ddev);
543 	if (ret)
544 		goto err_msm_uninit;
545 
546 	drm_kms_helper_poll_init(ddev);
547 
548 	return 0;
549 
550 err_msm_uninit:
551 	msm_drm_uninit(dev);
552 	return ret;
553 err_destroy_mdss:
554 	if (mdss && mdss->funcs)
555 		mdss->funcs->destroy(ddev);
556 err_free_priv:
557 	kfree(priv);
558 err_put_drm_dev:
559 	drm_dev_put(ddev);
560 	return ret;
561 }
562 
563 /*
564  * DRM operations:
565  */
566 
567 static void load_gpu(struct drm_device *dev)
568 {
569 	static DEFINE_MUTEX(init_lock);
570 	struct msm_drm_private *priv = dev->dev_private;
571 
572 	mutex_lock(&init_lock);
573 
574 	if (!priv->gpu)
575 		priv->gpu = adreno_load_gpu(dev);
576 
577 	mutex_unlock(&init_lock);
578 }
579 
580 static int context_init(struct drm_device *dev, struct drm_file *file)
581 {
582 	struct msm_drm_private *priv = dev->dev_private;
583 	struct msm_file_private *ctx;
584 
585 	ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
586 	if (!ctx)
587 		return -ENOMEM;
588 
589 	kref_init(&ctx->ref);
590 	msm_submitqueue_init(dev, ctx);
591 
592 	ctx->aspace = msm_gpu_create_private_address_space(priv->gpu, current);
593 	file->driver_priv = ctx;
594 
595 	return 0;
596 }
597 
598 static int msm_open(struct drm_device *dev, struct drm_file *file)
599 {
600 	/* For now, load gpu on open.. to avoid the requirement of having
601 	 * firmware in the initrd.
602 	 */
603 	load_gpu(dev);
604 
605 	return context_init(dev, file);
606 }
607 
608 static void context_close(struct msm_file_private *ctx)
609 {
610 	msm_submitqueue_close(ctx);
611 	msm_file_private_put(ctx);
612 }
613 
614 static void msm_postclose(struct drm_device *dev, struct drm_file *file)
615 {
616 	struct msm_drm_private *priv = dev->dev_private;
617 	struct msm_file_private *ctx = file->driver_priv;
618 
619 	mutex_lock(&dev->struct_mutex);
620 	if (ctx == priv->lastctx)
621 		priv->lastctx = NULL;
622 	mutex_unlock(&dev->struct_mutex);
623 
624 	context_close(ctx);
625 }
626 
627 static irqreturn_t msm_irq(int irq, void *arg)
628 {
629 	struct drm_device *dev = arg;
630 	struct msm_drm_private *priv = dev->dev_private;
631 	struct msm_kms *kms = priv->kms;
632 	BUG_ON(!kms);
633 	return kms->funcs->irq(kms);
634 }
635 
636 static void msm_irq_preinstall(struct drm_device *dev)
637 {
638 	struct msm_drm_private *priv = dev->dev_private;
639 	struct msm_kms *kms = priv->kms;
640 	BUG_ON(!kms);
641 	kms->funcs->irq_preinstall(kms);
642 }
643 
644 static int msm_irq_postinstall(struct drm_device *dev)
645 {
646 	struct msm_drm_private *priv = dev->dev_private;
647 	struct msm_kms *kms = priv->kms;
648 	BUG_ON(!kms);
649 
650 	if (kms->funcs->irq_postinstall)
651 		return kms->funcs->irq_postinstall(kms);
652 
653 	return 0;
654 }
655 
656 static void msm_irq_uninstall(struct drm_device *dev)
657 {
658 	struct msm_drm_private *priv = dev->dev_private;
659 	struct msm_kms *kms = priv->kms;
660 	BUG_ON(!kms);
661 	kms->funcs->irq_uninstall(kms);
662 }
663 
664 int msm_crtc_enable_vblank(struct drm_crtc *crtc)
665 {
666 	struct drm_device *dev = crtc->dev;
667 	unsigned int pipe = crtc->index;
668 	struct msm_drm_private *priv = dev->dev_private;
669 	struct msm_kms *kms = priv->kms;
670 	if (!kms)
671 		return -ENXIO;
672 	DBG("dev=%p, crtc=%u", dev, pipe);
673 	return vblank_ctrl_queue_work(priv, pipe, true);
674 }
675 
676 void msm_crtc_disable_vblank(struct drm_crtc *crtc)
677 {
678 	struct drm_device *dev = crtc->dev;
679 	unsigned int pipe = crtc->index;
680 	struct msm_drm_private *priv = dev->dev_private;
681 	struct msm_kms *kms = priv->kms;
682 	if (!kms)
683 		return;
684 	DBG("dev=%p, crtc=%u", dev, pipe);
685 	vblank_ctrl_queue_work(priv, pipe, false);
686 }
687 
688 /*
689  * DRM ioctls:
690  */
691 
692 static int msm_ioctl_get_param(struct drm_device *dev, void *data,
693 		struct drm_file *file)
694 {
695 	struct msm_drm_private *priv = dev->dev_private;
696 	struct drm_msm_param *args = data;
697 	struct msm_gpu *gpu;
698 
699 	/* for now, we just have 3d pipe.. eventually this would need to
700 	 * be more clever to dispatch to appropriate gpu module:
701 	 */
702 	if (args->pipe != MSM_PIPE_3D0)
703 		return -EINVAL;
704 
705 	gpu = priv->gpu;
706 
707 	if (!gpu)
708 		return -ENXIO;
709 
710 	return gpu->funcs->get_param(gpu, args->param, &args->value);
711 }
712 
713 static int msm_ioctl_gem_new(struct drm_device *dev, void *data,
714 		struct drm_file *file)
715 {
716 	struct drm_msm_gem_new *args = data;
717 
718 	if (args->flags & ~MSM_BO_FLAGS) {
719 		DRM_ERROR("invalid flags: %08x\n", args->flags);
720 		return -EINVAL;
721 	}
722 
723 	return msm_gem_new_handle(dev, file, args->size,
724 			args->flags, &args->handle, NULL);
725 }
726 
727 static inline ktime_t to_ktime(struct drm_msm_timespec timeout)
728 {
729 	return ktime_set(timeout.tv_sec, timeout.tv_nsec);
730 }
731 
732 static int msm_ioctl_gem_cpu_prep(struct drm_device *dev, void *data,
733 		struct drm_file *file)
734 {
735 	struct drm_msm_gem_cpu_prep *args = data;
736 	struct drm_gem_object *obj;
737 	ktime_t timeout = to_ktime(args->timeout);
738 	int ret;
739 
740 	if (args->op & ~MSM_PREP_FLAGS) {
741 		DRM_ERROR("invalid op: %08x\n", args->op);
742 		return -EINVAL;
743 	}
744 
745 	obj = drm_gem_object_lookup(file, args->handle);
746 	if (!obj)
747 		return -ENOENT;
748 
749 	ret = msm_gem_cpu_prep(obj, args->op, &timeout);
750 
751 	drm_gem_object_put(obj);
752 
753 	return ret;
754 }
755 
756 static int msm_ioctl_gem_cpu_fini(struct drm_device *dev, void *data,
757 		struct drm_file *file)
758 {
759 	struct drm_msm_gem_cpu_fini *args = data;
760 	struct drm_gem_object *obj;
761 	int ret;
762 
763 	obj = drm_gem_object_lookup(file, args->handle);
764 	if (!obj)
765 		return -ENOENT;
766 
767 	ret = msm_gem_cpu_fini(obj);
768 
769 	drm_gem_object_put(obj);
770 
771 	return ret;
772 }
773 
774 static int msm_ioctl_gem_info_iova(struct drm_device *dev,
775 		struct drm_file *file, struct drm_gem_object *obj,
776 		uint64_t *iova)
777 {
778 	struct msm_file_private *ctx = file->driver_priv;
779 
780 	if (!ctx->aspace)
781 		return -EINVAL;
782 
783 	/*
784 	 * Don't pin the memory here - just get an address so that userspace can
785 	 * be productive
786 	 */
787 	return msm_gem_get_iova(obj, ctx->aspace, iova);
788 }
789 
790 static int msm_ioctl_gem_info(struct drm_device *dev, void *data,
791 		struct drm_file *file)
792 {
793 	struct drm_msm_gem_info *args = data;
794 	struct drm_gem_object *obj;
795 	struct msm_gem_object *msm_obj;
796 	int i, ret = 0;
797 
798 	if (args->pad)
799 		return -EINVAL;
800 
801 	switch (args->info) {
802 	case MSM_INFO_GET_OFFSET:
803 	case MSM_INFO_GET_IOVA:
804 		/* value returned as immediate, not pointer, so len==0: */
805 		if (args->len)
806 			return -EINVAL;
807 		break;
808 	case MSM_INFO_SET_NAME:
809 	case MSM_INFO_GET_NAME:
810 		break;
811 	default:
812 		return -EINVAL;
813 	}
814 
815 	obj = drm_gem_object_lookup(file, args->handle);
816 	if (!obj)
817 		return -ENOENT;
818 
819 	msm_obj = to_msm_bo(obj);
820 
821 	switch (args->info) {
822 	case MSM_INFO_GET_OFFSET:
823 		args->value = msm_gem_mmap_offset(obj);
824 		break;
825 	case MSM_INFO_GET_IOVA:
826 		ret = msm_ioctl_gem_info_iova(dev, file, obj, &args->value);
827 		break;
828 	case MSM_INFO_SET_NAME:
829 		/* length check should leave room for terminating null: */
830 		if (args->len >= sizeof(msm_obj->name)) {
831 			ret = -EINVAL;
832 			break;
833 		}
834 		if (copy_from_user(msm_obj->name, u64_to_user_ptr(args->value),
835 				   args->len)) {
836 			msm_obj->name[0] = '\0';
837 			ret = -EFAULT;
838 			break;
839 		}
840 		msm_obj->name[args->len] = '\0';
841 		for (i = 0; i < args->len; i++) {
842 			if (!isprint(msm_obj->name[i])) {
843 				msm_obj->name[i] = '\0';
844 				break;
845 			}
846 		}
847 		break;
848 	case MSM_INFO_GET_NAME:
849 		if (args->value && (args->len < strlen(msm_obj->name))) {
850 			ret = -EINVAL;
851 			break;
852 		}
853 		args->len = strlen(msm_obj->name);
854 		if (args->value) {
855 			if (copy_to_user(u64_to_user_ptr(args->value),
856 					 msm_obj->name, args->len))
857 				ret = -EFAULT;
858 		}
859 		break;
860 	}
861 
862 	drm_gem_object_put(obj);
863 
864 	return ret;
865 }
866 
867 static int msm_ioctl_wait_fence(struct drm_device *dev, void *data,
868 		struct drm_file *file)
869 {
870 	struct msm_drm_private *priv = dev->dev_private;
871 	struct drm_msm_wait_fence *args = data;
872 	ktime_t timeout = to_ktime(args->timeout);
873 	struct msm_gpu_submitqueue *queue;
874 	struct msm_gpu *gpu = priv->gpu;
875 	int ret;
876 
877 	if (args->pad) {
878 		DRM_ERROR("invalid pad: %08x\n", args->pad);
879 		return -EINVAL;
880 	}
881 
882 	if (!gpu)
883 		return 0;
884 
885 	queue = msm_submitqueue_get(file->driver_priv, args->queueid);
886 	if (!queue)
887 		return -ENOENT;
888 
889 	ret = msm_wait_fence(gpu->rb[queue->prio]->fctx, args->fence, &timeout,
890 		true);
891 
892 	msm_submitqueue_put(queue);
893 	return ret;
894 }
895 
896 static int msm_ioctl_gem_madvise(struct drm_device *dev, void *data,
897 		struct drm_file *file)
898 {
899 	struct drm_msm_gem_madvise *args = data;
900 	struct drm_gem_object *obj;
901 	int ret;
902 
903 	switch (args->madv) {
904 	case MSM_MADV_DONTNEED:
905 	case MSM_MADV_WILLNEED:
906 		break;
907 	default:
908 		return -EINVAL;
909 	}
910 
911 	ret = mutex_lock_interruptible(&dev->struct_mutex);
912 	if (ret)
913 		return ret;
914 
915 	obj = drm_gem_object_lookup(file, args->handle);
916 	if (!obj) {
917 		ret = -ENOENT;
918 		goto unlock;
919 	}
920 
921 	ret = msm_gem_madvise(obj, args->madv);
922 	if (ret >= 0) {
923 		args->retained = ret;
924 		ret = 0;
925 	}
926 
927 	drm_gem_object_put_locked(obj);
928 
929 unlock:
930 	mutex_unlock(&dev->struct_mutex);
931 	return ret;
932 }
933 
934 
935 static int msm_ioctl_submitqueue_new(struct drm_device *dev, void *data,
936 		struct drm_file *file)
937 {
938 	struct drm_msm_submitqueue *args = data;
939 
940 	if (args->flags & ~MSM_SUBMITQUEUE_FLAGS)
941 		return -EINVAL;
942 
943 	return msm_submitqueue_create(dev, file->driver_priv, args->prio,
944 		args->flags, &args->id);
945 }
946 
947 static int msm_ioctl_submitqueue_query(struct drm_device *dev, void *data,
948 		struct drm_file *file)
949 {
950 	return msm_submitqueue_query(dev, file->driver_priv, data);
951 }
952 
953 static int msm_ioctl_submitqueue_close(struct drm_device *dev, void *data,
954 		struct drm_file *file)
955 {
956 	u32 id = *(u32 *) data;
957 
958 	return msm_submitqueue_remove(file->driver_priv, id);
959 }
960 
961 static const struct drm_ioctl_desc msm_ioctls[] = {
962 	DRM_IOCTL_DEF_DRV(MSM_GET_PARAM,    msm_ioctl_get_param,    DRM_RENDER_ALLOW),
963 	DRM_IOCTL_DEF_DRV(MSM_GEM_NEW,      msm_ioctl_gem_new,      DRM_RENDER_ALLOW),
964 	DRM_IOCTL_DEF_DRV(MSM_GEM_INFO,     msm_ioctl_gem_info,     DRM_RENDER_ALLOW),
965 	DRM_IOCTL_DEF_DRV(MSM_GEM_CPU_PREP, msm_ioctl_gem_cpu_prep, DRM_RENDER_ALLOW),
966 	DRM_IOCTL_DEF_DRV(MSM_GEM_CPU_FINI, msm_ioctl_gem_cpu_fini, DRM_RENDER_ALLOW),
967 	DRM_IOCTL_DEF_DRV(MSM_GEM_SUBMIT,   msm_ioctl_gem_submit,   DRM_RENDER_ALLOW),
968 	DRM_IOCTL_DEF_DRV(MSM_WAIT_FENCE,   msm_ioctl_wait_fence,   DRM_RENDER_ALLOW),
969 	DRM_IOCTL_DEF_DRV(MSM_GEM_MADVISE,  msm_ioctl_gem_madvise,  DRM_RENDER_ALLOW),
970 	DRM_IOCTL_DEF_DRV(MSM_SUBMITQUEUE_NEW,   msm_ioctl_submitqueue_new,   DRM_RENDER_ALLOW),
971 	DRM_IOCTL_DEF_DRV(MSM_SUBMITQUEUE_CLOSE, msm_ioctl_submitqueue_close, DRM_RENDER_ALLOW),
972 	DRM_IOCTL_DEF_DRV(MSM_SUBMITQUEUE_QUERY, msm_ioctl_submitqueue_query, DRM_RENDER_ALLOW),
973 };
974 
975 static const struct file_operations fops = {
976 	.owner              = THIS_MODULE,
977 	.open               = drm_open,
978 	.release            = drm_release,
979 	.unlocked_ioctl     = drm_ioctl,
980 	.compat_ioctl       = drm_compat_ioctl,
981 	.poll               = drm_poll,
982 	.read               = drm_read,
983 	.llseek             = no_llseek,
984 	.mmap               = msm_gem_mmap,
985 };
986 
987 static const struct drm_driver msm_driver = {
988 	.driver_features    = DRIVER_GEM |
989 				DRIVER_RENDER |
990 				DRIVER_ATOMIC |
991 				DRIVER_MODESET |
992 				DRIVER_SYNCOBJ,
993 	.open               = msm_open,
994 	.postclose           = msm_postclose,
995 	.lastclose          = drm_fb_helper_lastclose,
996 	.irq_handler        = msm_irq,
997 	.irq_preinstall     = msm_irq_preinstall,
998 	.irq_postinstall    = msm_irq_postinstall,
999 	.irq_uninstall      = msm_irq_uninstall,
1000 	.dumb_create        = msm_gem_dumb_create,
1001 	.dumb_map_offset    = msm_gem_dumb_map_offset,
1002 	.prime_handle_to_fd = drm_gem_prime_handle_to_fd,
1003 	.prime_fd_to_handle = drm_gem_prime_fd_to_handle,
1004 	.gem_prime_import_sg_table = msm_gem_prime_import_sg_table,
1005 	.gem_prime_mmap     = msm_gem_prime_mmap,
1006 #ifdef CONFIG_DEBUG_FS
1007 	.debugfs_init       = msm_debugfs_init,
1008 #endif
1009 	.ioctls             = msm_ioctls,
1010 	.num_ioctls         = ARRAY_SIZE(msm_ioctls),
1011 	.fops               = &fops,
1012 	.name               = "msm",
1013 	.desc               = "MSM Snapdragon DRM",
1014 	.date               = "20130625",
1015 	.major              = MSM_VERSION_MAJOR,
1016 	.minor              = MSM_VERSION_MINOR,
1017 	.patchlevel         = MSM_VERSION_PATCHLEVEL,
1018 };
1019 
1020 static int __maybe_unused msm_runtime_suspend(struct device *dev)
1021 {
1022 	struct drm_device *ddev = dev_get_drvdata(dev);
1023 	struct msm_drm_private *priv = ddev->dev_private;
1024 	struct msm_mdss *mdss = priv->mdss;
1025 
1026 	DBG("");
1027 
1028 	if (mdss && mdss->funcs)
1029 		return mdss->funcs->disable(mdss);
1030 
1031 	return 0;
1032 }
1033 
1034 static int __maybe_unused msm_runtime_resume(struct device *dev)
1035 {
1036 	struct drm_device *ddev = dev_get_drvdata(dev);
1037 	struct msm_drm_private *priv = ddev->dev_private;
1038 	struct msm_mdss *mdss = priv->mdss;
1039 
1040 	DBG("");
1041 
1042 	if (mdss && mdss->funcs)
1043 		return mdss->funcs->enable(mdss);
1044 
1045 	return 0;
1046 }
1047 
1048 static int __maybe_unused msm_pm_suspend(struct device *dev)
1049 {
1050 
1051 	if (pm_runtime_suspended(dev))
1052 		return 0;
1053 
1054 	return msm_runtime_suspend(dev);
1055 }
1056 
1057 static int __maybe_unused msm_pm_resume(struct device *dev)
1058 {
1059 	if (pm_runtime_suspended(dev))
1060 		return 0;
1061 
1062 	return msm_runtime_resume(dev);
1063 }
1064 
1065 static int __maybe_unused msm_pm_prepare(struct device *dev)
1066 {
1067 	struct drm_device *ddev = dev_get_drvdata(dev);
1068 
1069 	return drm_mode_config_helper_suspend(ddev);
1070 }
1071 
1072 static void __maybe_unused msm_pm_complete(struct device *dev)
1073 {
1074 	struct drm_device *ddev = dev_get_drvdata(dev);
1075 
1076 	drm_mode_config_helper_resume(ddev);
1077 }
1078 
1079 static const struct dev_pm_ops msm_pm_ops = {
1080 	SET_SYSTEM_SLEEP_PM_OPS(msm_pm_suspend, msm_pm_resume)
1081 	SET_RUNTIME_PM_OPS(msm_runtime_suspend, msm_runtime_resume, NULL)
1082 	.prepare = msm_pm_prepare,
1083 	.complete = msm_pm_complete,
1084 };
1085 
1086 /*
1087  * Componentized driver support:
1088  */
1089 
1090 /*
1091  * NOTE: duplication of the same code as exynos or imx (or probably any other).
1092  * so probably some room for some helpers
1093  */
1094 static int compare_of(struct device *dev, void *data)
1095 {
1096 	return dev->of_node == data;
1097 }
1098 
1099 /*
1100  * Identify what components need to be added by parsing what remote-endpoints
1101  * our MDP output ports are connected to. In the case of LVDS on MDP4, there
1102  * is no external component that we need to add since LVDS is within MDP4
1103  * itself.
1104  */
1105 static int add_components_mdp(struct device *mdp_dev,
1106 			      struct component_match **matchptr)
1107 {
1108 	struct device_node *np = mdp_dev->of_node;
1109 	struct device_node *ep_node;
1110 	struct device *master_dev;
1111 
1112 	/*
1113 	 * on MDP4 based platforms, the MDP platform device is the component
1114 	 * master that adds other display interface components to itself.
1115 	 *
1116 	 * on MDP5 based platforms, the MDSS platform device is the component
1117 	 * master that adds MDP5 and other display interface components to
1118 	 * itself.
1119 	 */
1120 	if (of_device_is_compatible(np, "qcom,mdp4"))
1121 		master_dev = mdp_dev;
1122 	else
1123 		master_dev = mdp_dev->parent;
1124 
1125 	for_each_endpoint_of_node(np, ep_node) {
1126 		struct device_node *intf;
1127 		struct of_endpoint ep;
1128 		int ret;
1129 
1130 		ret = of_graph_parse_endpoint(ep_node, &ep);
1131 		if (ret) {
1132 			DRM_DEV_ERROR(mdp_dev, "unable to parse port endpoint\n");
1133 			of_node_put(ep_node);
1134 			return ret;
1135 		}
1136 
1137 		/*
1138 		 * The LCDC/LVDS port on MDP4 is a speacial case where the
1139 		 * remote-endpoint isn't a component that we need to add
1140 		 */
1141 		if (of_device_is_compatible(np, "qcom,mdp4") &&
1142 		    ep.port == 0)
1143 			continue;
1144 
1145 		/*
1146 		 * It's okay if some of the ports don't have a remote endpoint
1147 		 * specified. It just means that the port isn't connected to
1148 		 * any external interface.
1149 		 */
1150 		intf = of_graph_get_remote_port_parent(ep_node);
1151 		if (!intf)
1152 			continue;
1153 
1154 		if (of_device_is_available(intf))
1155 			drm_of_component_match_add(master_dev, matchptr,
1156 						   compare_of, intf);
1157 
1158 		of_node_put(intf);
1159 	}
1160 
1161 	return 0;
1162 }
1163 
1164 static int compare_name_mdp(struct device *dev, void *data)
1165 {
1166 	return (strstr(dev_name(dev), "mdp") != NULL);
1167 }
1168 
1169 static int add_display_components(struct device *dev,
1170 				  struct component_match **matchptr)
1171 {
1172 	struct device *mdp_dev;
1173 	int ret;
1174 
1175 	/*
1176 	 * MDP5/DPU based devices don't have a flat hierarchy. There is a top
1177 	 * level parent: MDSS, and children: MDP5/DPU, DSI, HDMI, eDP etc.
1178 	 * Populate the children devices, find the MDP5/DPU node, and then add
1179 	 * the interfaces to our components list.
1180 	 */
1181 	if (of_device_is_compatible(dev->of_node, "qcom,mdss") ||
1182 	    of_device_is_compatible(dev->of_node, "qcom,sdm845-mdss") ||
1183 	    of_device_is_compatible(dev->of_node, "qcom,sc7180-mdss")) {
1184 		ret = of_platform_populate(dev->of_node, NULL, NULL, dev);
1185 		if (ret) {
1186 			DRM_DEV_ERROR(dev, "failed to populate children devices\n");
1187 			return ret;
1188 		}
1189 
1190 		mdp_dev = device_find_child(dev, NULL, compare_name_mdp);
1191 		if (!mdp_dev) {
1192 			DRM_DEV_ERROR(dev, "failed to find MDSS MDP node\n");
1193 			of_platform_depopulate(dev);
1194 			return -ENODEV;
1195 		}
1196 
1197 		put_device(mdp_dev);
1198 
1199 		/* add the MDP component itself */
1200 		drm_of_component_match_add(dev, matchptr, compare_of,
1201 					   mdp_dev->of_node);
1202 	} else {
1203 		/* MDP4 */
1204 		mdp_dev = dev;
1205 	}
1206 
1207 	ret = add_components_mdp(mdp_dev, matchptr);
1208 	if (ret)
1209 		of_platform_depopulate(dev);
1210 
1211 	return ret;
1212 }
1213 
1214 /*
1215  * We don't know what's the best binding to link the gpu with the drm device.
1216  * Fow now, we just hunt for all the possible gpus that we support, and add them
1217  * as components.
1218  */
1219 static const struct of_device_id msm_gpu_match[] = {
1220 	{ .compatible = "qcom,adreno" },
1221 	{ .compatible = "qcom,adreno-3xx" },
1222 	{ .compatible = "amd,imageon" },
1223 	{ .compatible = "qcom,kgsl-3d0" },
1224 	{ },
1225 };
1226 
1227 static int add_gpu_components(struct device *dev,
1228 			      struct component_match **matchptr)
1229 {
1230 	struct device_node *np;
1231 
1232 	np = of_find_matching_node(NULL, msm_gpu_match);
1233 	if (!np)
1234 		return 0;
1235 
1236 	if (of_device_is_available(np))
1237 		drm_of_component_match_add(dev, matchptr, compare_of, np);
1238 
1239 	of_node_put(np);
1240 
1241 	return 0;
1242 }
1243 
1244 static int msm_drm_bind(struct device *dev)
1245 {
1246 	return msm_drm_init(dev, &msm_driver);
1247 }
1248 
1249 static void msm_drm_unbind(struct device *dev)
1250 {
1251 	msm_drm_uninit(dev);
1252 }
1253 
1254 static const struct component_master_ops msm_drm_ops = {
1255 	.bind = msm_drm_bind,
1256 	.unbind = msm_drm_unbind,
1257 };
1258 
1259 /*
1260  * Platform driver:
1261  */
1262 
1263 static int msm_pdev_probe(struct platform_device *pdev)
1264 {
1265 	struct component_match *match = NULL;
1266 	int ret;
1267 
1268 	if (get_mdp_ver(pdev)) {
1269 		ret = add_display_components(&pdev->dev, &match);
1270 		if (ret)
1271 			return ret;
1272 	}
1273 
1274 	ret = add_gpu_components(&pdev->dev, &match);
1275 	if (ret)
1276 		goto fail;
1277 
1278 	/* on all devices that I am aware of, iommu's which can map
1279 	 * any address the cpu can see are used:
1280 	 */
1281 	ret = dma_set_mask_and_coherent(&pdev->dev, ~0);
1282 	if (ret)
1283 		goto fail;
1284 
1285 	ret = component_master_add_with_match(&pdev->dev, &msm_drm_ops, match);
1286 	if (ret)
1287 		goto fail;
1288 
1289 	return 0;
1290 
1291 fail:
1292 	of_platform_depopulate(&pdev->dev);
1293 	return ret;
1294 }
1295 
1296 static int msm_pdev_remove(struct platform_device *pdev)
1297 {
1298 	component_master_del(&pdev->dev, &msm_drm_ops);
1299 	of_platform_depopulate(&pdev->dev);
1300 
1301 	return 0;
1302 }
1303 
1304 static void msm_pdev_shutdown(struct platform_device *pdev)
1305 {
1306 	struct drm_device *drm = platform_get_drvdata(pdev);
1307 
1308 	drm_atomic_helper_shutdown(drm);
1309 }
1310 
1311 static const struct of_device_id dt_match[] = {
1312 	{ .compatible = "qcom,mdp4", .data = (void *)KMS_MDP4 },
1313 	{ .compatible = "qcom,mdss", .data = (void *)KMS_MDP5 },
1314 	{ .compatible = "qcom,sdm845-mdss", .data = (void *)KMS_DPU },
1315 	{ .compatible = "qcom,sc7180-mdss", .data = (void *)KMS_DPU },
1316 	{}
1317 };
1318 MODULE_DEVICE_TABLE(of, dt_match);
1319 
1320 static struct platform_driver msm_platform_driver = {
1321 	.probe      = msm_pdev_probe,
1322 	.remove     = msm_pdev_remove,
1323 	.shutdown   = msm_pdev_shutdown,
1324 	.driver     = {
1325 		.name   = "msm",
1326 		.of_match_table = dt_match,
1327 		.pm     = &msm_pm_ops,
1328 	},
1329 };
1330 
1331 static int __init msm_drm_register(void)
1332 {
1333 	if (!modeset)
1334 		return -EINVAL;
1335 
1336 	DBG("init");
1337 	msm_mdp_register();
1338 	msm_dpu_register();
1339 	msm_dsi_register();
1340 	msm_edp_register();
1341 	msm_hdmi_register();
1342 	msm_dp_register();
1343 	adreno_register();
1344 	return platform_driver_register(&msm_platform_driver);
1345 }
1346 
1347 static void __exit msm_drm_unregister(void)
1348 {
1349 	DBG("fini");
1350 	platform_driver_unregister(&msm_platform_driver);
1351 	msm_dp_unregister();
1352 	msm_hdmi_unregister();
1353 	adreno_unregister();
1354 	msm_edp_unregister();
1355 	msm_dsi_unregister();
1356 	msm_mdp_unregister();
1357 	msm_dpu_unregister();
1358 }
1359 
1360 module_init(msm_drm_register);
1361 module_exit(msm_drm_unregister);
1362 
1363 MODULE_AUTHOR("Rob Clark <robdclark@gmail.com");
1364 MODULE_DESCRIPTION("MSM DRM Driver");
1365 MODULE_LICENSE("GPL");
1366