1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (C) 2015 Free Electrons
4 * Copyright (C) 2015 NextThing Co
6 * Maxime Ripard <maxime.ripard@free-electrons.com>
9 #include <linux/component.h>
10 #include <linux/kfifo.h>
11 #include <linux/module.h>
12 #include <linux/of_graph.h>
13 #include <linux/of_reserved_mem.h>
14 #include <linux/platform_device.h>
16 #include <drm/drm_atomic_helper.h>
17 #include <drm/drm_drv.h>
18 #include <drm/drm_fb_cma_helper.h>
19 #include <drm/drm_fb_helper.h>
20 #include <drm/drm_gem_cma_helper.h>
21 #include <drm/drm_of.h>
22 #include <drm/drm_probe_helper.h>
23 #include <drm/drm_vblank.h>
25 #include "sun4i_drv.h"
26 #include "sun4i_frontend.h"
27 #include "sun4i_framebuffer.h"
28 #include "sun4i_tcon.h"
29 #include "sun8i_tcon_top.h"
31 static int drm_sun4i_gem_dumb_create(struct drm_file
*file_priv
,
32 struct drm_device
*drm
,
33 struct drm_mode_create_dumb
*args
)
35 /* The hardware only allows even pitches for YUV buffers. */
36 args
->pitch
= ALIGN(DIV_ROUND_UP(args
->width
* args
->bpp
, 8), 2);
38 return drm_gem_cma_dumb_create_internal(file_priv
, drm
, args
);
41 DEFINE_DRM_GEM_CMA_FOPS(sun4i_drv_fops
);
43 static struct drm_driver sun4i_drv_driver
= {
44 .driver_features
= DRIVER_GEM
| DRIVER_MODESET
| DRIVER_ATOMIC
,
46 /* Generic Operations */
47 .fops
= &sun4i_drv_fops
,
49 .desc
= "Allwinner sun4i Display Engine",
55 DRM_GEM_CMA_VMAP_DRIVER_OPS
,
56 .dumb_create
= drm_sun4i_gem_dumb_create
,
59 static int sun4i_drv_bind(struct device
*dev
)
61 struct drm_device
*drm
;
62 struct sun4i_drv
*drv
;
65 drm
= drm_dev_alloc(&sun4i_drv_driver
, dev
);
69 drv
= devm_kzalloc(dev
, sizeof(*drv
), GFP_KERNEL
);
75 dev_set_drvdata(dev
, drm
);
76 drm
->dev_private
= drv
;
77 INIT_LIST_HEAD(&drv
->frontend_list
);
78 INIT_LIST_HEAD(&drv
->engine_list
);
79 INIT_LIST_HEAD(&drv
->tcon_list
);
81 ret
= of_reserved_mem_device_init(dev
);
82 if (ret
&& ret
!= -ENODEV
) {
83 dev_err(drm
->dev
, "Couldn't claim our memory region\n");
87 drm_mode_config_init(drm
);
88 drm
->mode_config
.allow_fb_modifiers
= true;
90 ret
= component_bind_all(drm
->dev
, drm
);
92 dev_err(drm
->dev
, "Couldn't bind all pipelines components\n");
93 goto cleanup_mode_config
;
96 /* drm_vblank_init calls kcalloc, which can fail */
97 ret
= drm_vblank_init(drm
, drm
->mode_config
.num_crtc
);
99 goto cleanup_mode_config
;
101 drm
->irq_enabled
= true;
103 /* Remove early framebuffers (ie. simplefb) */
104 drm_fb_helper_remove_conflicting_framebuffers(NULL
, "sun4i-drm-fb", false);
106 sun4i_framebuffer_init(drm
);
108 /* Enable connectors polling */
109 drm_kms_helper_poll_init(drm
);
111 ret
= drm_dev_register(drm
, 0);
115 drm_fbdev_generic_setup(drm
, 32);
120 drm_kms_helper_poll_fini(drm
);
122 drm_mode_config_cleanup(drm
);
123 of_reserved_mem_device_release(dev
);
129 static void sun4i_drv_unbind(struct device
*dev
)
131 struct drm_device
*drm
= dev_get_drvdata(dev
);
133 drm_dev_unregister(drm
);
134 drm_kms_helper_poll_fini(drm
);
135 drm_atomic_helper_shutdown(drm
);
136 drm_mode_config_cleanup(drm
);
138 component_unbind_all(dev
, NULL
);
139 of_reserved_mem_device_release(dev
);
144 static const struct component_master_ops sun4i_drv_master_ops
= {
145 .bind
= sun4i_drv_bind
,
146 .unbind
= sun4i_drv_unbind
,
149 static bool sun4i_drv_node_is_connector(struct device_node
*node
)
151 return of_device_is_compatible(node
, "hdmi-connector");
154 static bool sun4i_drv_node_is_frontend(struct device_node
*node
)
156 return of_device_is_compatible(node
, "allwinner,sun4i-a10-display-frontend") ||
157 of_device_is_compatible(node
, "allwinner,sun5i-a13-display-frontend") ||
158 of_device_is_compatible(node
, "allwinner,sun6i-a31-display-frontend") ||
159 of_device_is_compatible(node
, "allwinner,sun7i-a20-display-frontend") ||
160 of_device_is_compatible(node
, "allwinner,sun8i-a23-display-frontend") ||
161 of_device_is_compatible(node
, "allwinner,sun8i-a33-display-frontend") ||
162 of_device_is_compatible(node
, "allwinner,sun9i-a80-display-frontend");
165 static bool sun4i_drv_node_is_deu(struct device_node
*node
)
167 return of_device_is_compatible(node
, "allwinner,sun9i-a80-deu");
170 static bool sun4i_drv_node_is_supported_frontend(struct device_node
*node
)
172 if (IS_ENABLED(CONFIG_DRM_SUN4I_BACKEND
))
173 return !!of_match_node(sun4i_frontend_of_table
, node
);
178 static bool sun4i_drv_node_is_tcon(struct device_node
*node
)
180 return !!of_match_node(sun4i_tcon_of_table
, node
);
183 static bool sun4i_drv_node_is_tcon_with_ch0(struct device_node
*node
)
185 const struct of_device_id
*match
;
187 match
= of_match_node(sun4i_tcon_of_table
, node
);
189 struct sun4i_tcon_quirks
*quirks
;
191 quirks
= (struct sun4i_tcon_quirks
*)match
->data
;
193 return quirks
->has_channel_0
;
199 static bool sun4i_drv_node_is_tcon_top(struct device_node
*node
)
201 return IS_ENABLED(CONFIG_DRM_SUN8I_TCON_TOP
) &&
202 !!of_match_node(sun8i_tcon_top_of_table
, node
);
205 static int compare_of(struct device
*dev
, void *data
)
207 DRM_DEBUG_DRIVER("Comparing of node %pOF with %pOF\n",
211 return dev
->of_node
== data
;
215 * The encoder drivers use drm_of_find_possible_crtcs to get upstream
216 * crtcs from the device tree using of_graph. For the results to be
217 * correct, encoders must be probed/bound after _all_ crtcs have been
218 * created. The existing code uses a depth first recursive traversal
219 * of the of_graph, which means the encoders downstream of the TCON
220 * get add right after the first TCON. The second TCON or CRTC will
221 * never be properly associated with encoders connected to it.
223 * Also, in a dual display pipeline setup, both frontends can feed
224 * either backend, and both backends can feed either TCON, we want
225 * all components of the same type to be added before the next type
226 * in the pipeline. Fortunately, the pipelines are perfectly symmetric,
227 * i.e. components of the same type are at the same depth when counted
228 * from the frontend. The only exception is the third pipeline in
229 * the A80 SoC, which we do not support anyway.
231 * Hence we can use a breadth first search traversal order to add
232 * components. We do not need to check for duplicates. The component
233 * matching system handles this for us.
235 struct endpoint_list
{
236 DECLARE_KFIFO(fifo
, struct device_node
*, 16);
239 static void sun4i_drv_traverse_endpoints(struct endpoint_list
*list
,
240 struct device_node
*node
,
243 struct device_node
*ep
, *remote
, *port
;
245 port
= of_graph_get_port_by_id(node
, port_id
);
247 DRM_DEBUG_DRIVER("No output to bind on port %d\n", port_id
);
251 for_each_available_child_of_node(port
, ep
) {
252 remote
= of_graph_get_remote_port_parent(ep
);
254 DRM_DEBUG_DRIVER("Error retrieving the output node\n");
258 if (sun4i_drv_node_is_tcon(node
)) {
260 * TCON TOP is always probed before TCON. However, TCON
261 * points back to TCON TOP when it is source for HDMI.
262 * We have to skip it here to prevent infinite looping
263 * between TCON TOP and TCON.
265 if (sun4i_drv_node_is_tcon_top(remote
)) {
266 DRM_DEBUG_DRIVER("TCON output endpoint is TCON TOP... skipping\n");
272 * If the node is our TCON with channel 0, the first
273 * port is used for panel or bridges, and will not be
274 * part of the component framework.
276 if (sun4i_drv_node_is_tcon_with_ch0(node
)) {
277 struct of_endpoint endpoint
;
279 if (of_graph_parse_endpoint(ep
, &endpoint
)) {
280 DRM_DEBUG_DRIVER("Couldn't parse endpoint\n");
286 DRM_DEBUG_DRIVER("Endpoint is our panel... skipping\n");
293 kfifo_put(&list
->fifo
, remote
);
297 static int sun4i_drv_add_endpoints(struct device
*dev
,
298 struct endpoint_list
*list
,
299 struct component_match
**match
,
300 struct device_node
*node
)
305 * The frontend has been disabled in some of our old device
306 * trees. If we find a node that is the frontend and is
307 * disabled, we should just follow through and parse its
308 * child, but without adding it to the component list.
309 * Otherwise, we obviously want to add it to the list.
311 if (!sun4i_drv_node_is_frontend(node
) &&
312 !of_device_is_available(node
))
316 * The connectors will be the last nodes in our pipeline, we
319 if (sun4i_drv_node_is_connector(node
))
323 * If the device is either just a regular device, or an
324 * enabled frontend supported by the driver, we add it to our
327 if (!(sun4i_drv_node_is_frontend(node
) ||
328 sun4i_drv_node_is_deu(node
)) ||
329 (sun4i_drv_node_is_supported_frontend(node
) &&
330 of_device_is_available(node
))) {
331 /* Add current component */
332 DRM_DEBUG_DRIVER("Adding component %pOF\n", node
);
333 drm_of_component_match_add(dev
, match
, compare_of
, node
);
337 /* each node has at least one output */
338 sun4i_drv_traverse_endpoints(list
, node
, 1);
340 /* TCON TOP has second and third output */
341 if (sun4i_drv_node_is_tcon_top(node
)) {
342 sun4i_drv_traverse_endpoints(list
, node
, 3);
343 sun4i_drv_traverse_endpoints(list
, node
, 5);
349 #ifdef CONFIG_PM_SLEEP
350 static int sun4i_drv_drm_sys_suspend(struct device
*dev
)
352 struct drm_device
*drm
= dev_get_drvdata(dev
);
354 return drm_mode_config_helper_suspend(drm
);
357 static int sun4i_drv_drm_sys_resume(struct device
*dev
)
359 struct drm_device
*drm
= dev_get_drvdata(dev
);
361 return drm_mode_config_helper_resume(drm
);
365 static const struct dev_pm_ops sun4i_drv_drm_pm_ops
= {
366 SET_SYSTEM_SLEEP_PM_OPS(sun4i_drv_drm_sys_suspend
,
367 sun4i_drv_drm_sys_resume
)
370 static int sun4i_drv_probe(struct platform_device
*pdev
)
372 struct component_match
*match
= NULL
;
373 struct device_node
*np
= pdev
->dev
.of_node
, *endpoint
;
374 struct endpoint_list list
;
375 int i
, ret
, count
= 0;
377 INIT_KFIFO(list
.fifo
);
380 struct device_node
*pipeline
= of_parse_phandle(np
,
381 "allwinner,pipelines",
386 kfifo_put(&list
.fifo
, pipeline
);
389 while (kfifo_get(&list
.fifo
, &endpoint
)) {
390 /* process this endpoint */
391 ret
= sun4i_drv_add_endpoints(&pdev
->dev
, &list
, &match
,
394 /* sun4i_drv_add_endpoints can fail to allocate memory */
402 return component_master_add_with_match(&pdev
->dev
,
403 &sun4i_drv_master_ops
,
409 static int sun4i_drv_remove(struct platform_device
*pdev
)
411 component_master_del(&pdev
->dev
, &sun4i_drv_master_ops
);
416 static const struct of_device_id sun4i_drv_of_table
[] = {
417 { .compatible
= "allwinner,sun4i-a10-display-engine" },
418 { .compatible
= "allwinner,sun5i-a10s-display-engine" },
419 { .compatible
= "allwinner,sun5i-a13-display-engine" },
420 { .compatible
= "allwinner,sun6i-a31-display-engine" },
421 { .compatible
= "allwinner,sun6i-a31s-display-engine" },
422 { .compatible
= "allwinner,sun7i-a20-display-engine" },
423 { .compatible
= "allwinner,sun8i-a23-display-engine" },
424 { .compatible
= "allwinner,sun8i-a33-display-engine" },
425 { .compatible
= "allwinner,sun8i-a83t-display-engine" },
426 { .compatible
= "allwinner,sun8i-h3-display-engine" },
427 { .compatible
= "allwinner,sun8i-r40-display-engine" },
428 { .compatible
= "allwinner,sun8i-v3s-display-engine" },
429 { .compatible
= "allwinner,sun9i-a80-display-engine" },
430 { .compatible
= "allwinner,sun50i-a64-display-engine" },
431 { .compatible
= "allwinner,sun50i-h6-display-engine" },
434 MODULE_DEVICE_TABLE(of
, sun4i_drv_of_table
);
436 static struct platform_driver sun4i_drv_platform_driver
= {
437 .probe
= sun4i_drv_probe
,
438 .remove
= sun4i_drv_remove
,
441 .of_match_table
= sun4i_drv_of_table
,
442 .pm
= &sun4i_drv_drm_pm_ops
,
445 module_platform_driver(sun4i_drv_platform_driver
);
447 MODULE_AUTHOR("Boris Brezillon <boris.brezillon@free-electrons.com>");
448 MODULE_AUTHOR("Maxime Ripard <maxime.ripard@free-electrons.com>");
449 MODULE_DESCRIPTION("Allwinner A10 Display Engine DRM/KMS Driver");
450 MODULE_LICENSE("GPL");