2019-05-27 06:55:01 +00:00
|
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
2016-06-10 14:55:59 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2016 Noralf Trønnes
|
|
|
|
*/
|
|
|
|
|
2019-05-26 17:35:35 +00:00
|
|
|
#include <linux/module.h>
|
|
|
|
#include <linux/slab.h>
|
|
|
|
|
2016-06-10 14:55:59 +00:00
|
|
|
#include <drm/drm_atomic.h>
|
|
|
|
#include <drm/drm_atomic_helper.h>
|
2019-08-26 15:26:29 +00:00
|
|
|
#include <drm/drm_bridge.h>
|
2016-06-10 14:55:59 +00:00
|
|
|
#include <drm/drm_plane_helper.h>
|
2019-01-17 21:03:34 +00:00
|
|
|
#include <drm/drm_probe_helper.h>
|
2016-06-10 14:55:59 +00:00
|
|
|
#include <drm/drm_simple_kms_helper.h>
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DOC: overview
|
|
|
|
*
|
|
|
|
* This helper library provides helpers for drivers for simple display
|
|
|
|
* hardware.
|
|
|
|
*
|
|
|
|
* drm_simple_display_pipe_init() initializes a simple display pipeline
|
|
|
|
* which has only one full-screen scanout buffer feeding one output. The
|
2016-12-29 20:48:26 +00:00
|
|
|
* pipeline is represented by &struct drm_simple_display_pipe and binds
|
2016-06-10 14:55:59 +00:00
|
|
|
* together &drm_plane, &drm_crtc and &drm_encoder structures into one fixed
|
|
|
|
* entity. Some flexibility for code reuse is provided through a separately
|
|
|
|
* allocated &drm_connector object and supporting optional &drm_bridge
|
|
|
|
* encoder drivers.
|
|
|
|
*/
|
|
|
|
|
|
|
|
static const struct drm_encoder_funcs drm_simple_kms_encoder_funcs = {
|
|
|
|
.destroy = drm_encoder_cleanup,
|
|
|
|
};
|
|
|
|
|
2018-02-20 07:28:59 +00:00
|
|
|
static enum drm_mode_status
|
|
|
|
drm_simple_kms_crtc_mode_valid(struct drm_crtc *crtc,
|
|
|
|
const struct drm_display_mode *mode)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(crtc, struct drm_simple_display_pipe, crtc);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->mode_valid)
|
|
|
|
/* Anything goes */
|
|
|
|
return MODE_OK;
|
|
|
|
|
2019-10-23 10:12:56 +00:00
|
|
|
return pipe->funcs->mode_valid(pipe, mode);
|
2018-02-20 07:28:59 +00:00
|
|
|
}
|
|
|
|
|
2016-08-23 06:25:40 +00:00
|
|
|
static int drm_simple_kms_crtc_check(struct drm_crtc *crtc,
|
|
|
|
struct drm_crtc_state *state)
|
|
|
|
{
|
2017-07-12 08:13:29 +00:00
|
|
|
bool has_primary = state->plane_mask &
|
2018-06-26 19:47:07 +00:00
|
|
|
drm_plane_mask(crtc->primary);
|
2017-07-12 08:13:29 +00:00
|
|
|
|
|
|
|
/* We always want to have an active plane with an active CRTC */
|
|
|
|
if (has_primary != state->enable)
|
|
|
|
return -EINVAL;
|
|
|
|
|
2016-08-23 06:25:40 +00:00
|
|
|
return drm_atomic_add_affected_planes(state->state, crtc);
|
|
|
|
}
|
|
|
|
|
2017-06-30 09:36:44 +00:00
|
|
|
static void drm_simple_kms_crtc_enable(struct drm_crtc *crtc,
|
|
|
|
struct drm_crtc_state *old_state)
|
2016-06-10 14:55:59 +00:00
|
|
|
{
|
2018-03-22 20:27:37 +00:00
|
|
|
struct drm_plane *plane;
|
2016-06-10 14:55:59 +00:00
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(crtc, struct drm_simple_display_pipe, crtc);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->enable)
|
|
|
|
return;
|
|
|
|
|
2018-03-22 20:27:37 +00:00
|
|
|
plane = &pipe->plane;
|
|
|
|
pipe->funcs->enable(pipe, crtc->state, plane->state);
|
2016-06-10 14:55:59 +00:00
|
|
|
}
|
|
|
|
|
2017-06-30 09:36:45 +00:00
|
|
|
static void drm_simple_kms_crtc_disable(struct drm_crtc *crtc,
|
|
|
|
struct drm_crtc_state *old_state)
|
2016-06-10 14:55:59 +00:00
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(crtc, struct drm_simple_display_pipe, crtc);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->disable)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pipe->funcs->disable(pipe);
|
|
|
|
}
|
|
|
|
|
|
|
|
static const struct drm_crtc_helper_funcs drm_simple_kms_crtc_helper_funcs = {
|
2018-02-20 07:28:59 +00:00
|
|
|
.mode_valid = drm_simple_kms_crtc_mode_valid,
|
2016-08-23 06:25:40 +00:00
|
|
|
.atomic_check = drm_simple_kms_crtc_check,
|
2017-06-30 09:36:44 +00:00
|
|
|
.atomic_enable = drm_simple_kms_crtc_enable,
|
2017-06-30 09:36:45 +00:00
|
|
|
.atomic_disable = drm_simple_kms_crtc_disable,
|
2016-06-10 14:55:59 +00:00
|
|
|
};
|
|
|
|
|
2018-02-12 08:52:51 +00:00
|
|
|
static int drm_simple_kms_crtc_enable_vblank(struct drm_crtc *crtc)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(crtc, struct drm_simple_display_pipe, crtc);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->enable_vblank)
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
return pipe->funcs->enable_vblank(pipe);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void drm_simple_kms_crtc_disable_vblank(struct drm_crtc *crtc)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(crtc, struct drm_simple_display_pipe, crtc);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->disable_vblank)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pipe->funcs->disable_vblank(pipe);
|
|
|
|
}
|
|
|
|
|
2016-06-10 14:55:59 +00:00
|
|
|
static const struct drm_crtc_funcs drm_simple_kms_crtc_funcs = {
|
|
|
|
.reset = drm_atomic_helper_crtc_reset,
|
|
|
|
.destroy = drm_crtc_cleanup,
|
|
|
|
.set_config = drm_atomic_helper_set_config,
|
|
|
|
.page_flip = drm_atomic_helper_page_flip,
|
|
|
|
.atomic_duplicate_state = drm_atomic_helper_crtc_duplicate_state,
|
|
|
|
.atomic_destroy_state = drm_atomic_helper_crtc_destroy_state,
|
2018-02-12 08:52:51 +00:00
|
|
|
.enable_vblank = drm_simple_kms_crtc_enable_vblank,
|
|
|
|
.disable_vblank = drm_simple_kms_crtc_disable_vblank,
|
2016-06-10 14:55:59 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
static int drm_simple_kms_plane_atomic_check(struct drm_plane *plane,
|
|
|
|
struct drm_plane_state *plane_state)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
struct drm_crtc_state *crtc_state;
|
|
|
|
int ret;
|
|
|
|
|
|
|
|
pipe = container_of(plane, struct drm_simple_display_pipe, plane);
|
2017-03-01 09:22:10 +00:00
|
|
|
crtc_state = drm_atomic_get_new_crtc_state(plane_state->state,
|
|
|
|
&pipe->crtc);
|
2016-07-26 16:07:04 +00:00
|
|
|
|
2017-11-01 20:16:19 +00:00
|
|
|
ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
|
|
|
|
DRM_PLANE_HELPER_NO_SCALING,
|
|
|
|
DRM_PLANE_HELPER_NO_SCALING,
|
|
|
|
false, true);
|
2016-06-10 14:55:59 +00:00
|
|
|
if (ret)
|
|
|
|
return ret;
|
|
|
|
|
2016-07-26 16:07:04 +00:00
|
|
|
if (!plane_state->visible)
|
2018-02-22 06:09:19 +00:00
|
|
|
return 0;
|
|
|
|
|
2016-06-10 14:55:59 +00:00
|
|
|
if (!pipe->funcs || !pipe->funcs->check)
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
return pipe->funcs->check(pipe, plane_state, crtc_state);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void drm_simple_kms_plane_atomic_update(struct drm_plane *plane,
|
2017-03-20 23:36:15 +00:00
|
|
|
struct drm_plane_state *old_pstate)
|
2016-06-10 14:55:59 +00:00
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(plane, struct drm_simple_display_pipe, plane);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->update)
|
|
|
|
return;
|
|
|
|
|
2017-03-20 23:36:15 +00:00
|
|
|
pipe->funcs->update(pipe, old_pstate);
|
2016-06-10 14:55:59 +00:00
|
|
|
}
|
|
|
|
|
2016-10-02 17:01:24 +00:00
|
|
|
static int drm_simple_kms_plane_prepare_fb(struct drm_plane *plane,
|
|
|
|
struct drm_plane_state *state)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(plane, struct drm_simple_display_pipe, plane);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->prepare_fb)
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
return pipe->funcs->prepare_fb(pipe, state);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void drm_simple_kms_plane_cleanup_fb(struct drm_plane *plane,
|
|
|
|
struct drm_plane_state *state)
|
|
|
|
{
|
|
|
|
struct drm_simple_display_pipe *pipe;
|
|
|
|
|
|
|
|
pipe = container_of(plane, struct drm_simple_display_pipe, plane);
|
|
|
|
if (!pipe->funcs || !pipe->funcs->cleanup_fb)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pipe->funcs->cleanup_fb(pipe, state);
|
|
|
|
}
|
|
|
|
|
2018-10-25 16:26:35 +00:00
|
|
|
static bool drm_simple_kms_format_mod_supported(struct drm_plane *plane,
|
|
|
|
uint32_t format,
|
|
|
|
uint64_t modifier)
|
|
|
|
{
|
|
|
|
return modifier == DRM_FORMAT_MOD_LINEAR;
|
|
|
|
}
|
|
|
|
|
2016-06-10 14:55:59 +00:00
|
|
|
static const struct drm_plane_helper_funcs drm_simple_kms_plane_helper_funcs = {
|
2016-10-02 17:01:24 +00:00
|
|
|
.prepare_fb = drm_simple_kms_plane_prepare_fb,
|
|
|
|
.cleanup_fb = drm_simple_kms_plane_cleanup_fb,
|
2016-06-10 14:55:59 +00:00
|
|
|
.atomic_check = drm_simple_kms_plane_atomic_check,
|
|
|
|
.atomic_update = drm_simple_kms_plane_atomic_update,
|
|
|
|
};
|
|
|
|
|
|
|
|
static const struct drm_plane_funcs drm_simple_kms_plane_funcs = {
|
|
|
|
.update_plane = drm_atomic_helper_update_plane,
|
|
|
|
.disable_plane = drm_atomic_helper_disable_plane,
|
|
|
|
.destroy = drm_plane_cleanup,
|
|
|
|
.reset = drm_atomic_helper_plane_reset,
|
|
|
|
.atomic_duplicate_state = drm_atomic_helper_plane_duplicate_state,
|
|
|
|
.atomic_destroy_state = drm_atomic_helper_plane_destroy_state,
|
2018-10-25 16:26:35 +00:00
|
|
|
.format_mod_supported = drm_simple_kms_format_mod_supported,
|
2016-06-10 14:55:59 +00:00
|
|
|
};
|
|
|
|
|
2016-08-25 09:04:34 +00:00
|
|
|
/**
|
|
|
|
* drm_simple_display_pipe_attach_bridge - Attach a bridge to the display pipe
|
|
|
|
* @pipe: simple display pipe object
|
|
|
|
* @bridge: bridge to attach
|
|
|
|
*
|
|
|
|
* Makes it possible to still use the drm_simple_display_pipe helpers when
|
|
|
|
* a DRM bridge has to be used.
|
|
|
|
*
|
|
|
|
* Note that you probably want to initialize the pipe by passing a NULL
|
|
|
|
* connector to drm_simple_display_pipe_init().
|
|
|
|
*
|
|
|
|
* Returns:
|
|
|
|
* Zero on success, negative error code on failure.
|
|
|
|
*/
|
|
|
|
int drm_simple_display_pipe_attach_bridge(struct drm_simple_display_pipe *pipe,
|
|
|
|
struct drm_bridge *bridge)
|
|
|
|
{
|
drm/bridge: Extend bridge API to disable connector creation
Most bridge drivers create a DRM connector to model the connector at the
output of the bridge. This model is historical and has worked pretty
well so far, but causes several issues:
- It prevents supporting more complex display pipelines where DRM
connector operations are split over multiple components. For instance a
pipeline with a bridge connected to the DDC signals to read EDID data,
and another one connected to the HPD signal to detect connection and
disconnection, will not be possible to support through this model.
- It requires every bridge driver to implement similar connector
handling code, resulting in code duplication.
- It assumes that a bridge will either be wired to a connector or to
another bridge, but doesn't support bridges that can be used in both
positions very well (although there is some ad-hoc support for this in
the analogix_dp bridge driver).
In order to solve these issues, ownership of the connector should be
moved to the display controller driver (where it can be implemented
using helpers provided by the core).
Extend the bridge API to allow disabling connector creation in bridge
drivers as a first step towards the new model. The new flags argument to
the bridge .attach() operation allows instructing the bridge driver to
skip creating a connector. Unconditionally set the new flags argument to
0 for now to keep the existing behaviour, and modify all existing bridge
drivers to return an error when connector creation is not requested as
they don't support this feature yet.
The change is based on the following semantic patch, with manual review
and edits.
@ rule1 @
identifier funcs;
identifier fn;
@@
struct drm_bridge_funcs funcs = {
...,
.attach = fn
};
@ depends on rule1 @
identifier rule1.fn;
identifier bridge;
statement S, S1;
@@
int fn(
struct drm_bridge *bridge
+ , enum drm_bridge_attach_flags flags
)
{
... when != S
+ if (flags & DRM_BRIDGE_ATTACH_NO_CONNECTOR) {
+ DRM_ERROR("Fix bridge driver to make connector optional!");
+ return -EINVAL;
+ }
+
S1
...
}
@ depends on rule1 @
identifier rule1.fn;
identifier bridge, flags;
expression E1, E2, E3;
@@
int fn(
struct drm_bridge *bridge,
enum drm_bridge_attach_flags flags
) {
<...
drm_bridge_attach(E1, E2, E3
+ , flags
)
...>
}
@@
expression E1, E2, E3;
@@
drm_bridge_attach(E1, E2, E3
+ , 0
)
Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Boris Brezillon <boris.brezillon@collabora.com>
Acked-by: Sam Ravnborg <sam@ravnborg.org>
Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ti.com>
Tested-by: Sebastian Reichel <sebastian.reichel@collabora.com>
Reviewed-by: Sebastian Reichel <sebastian.reichel@collabora.com>
Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Tomi Valkeinen <tomi.valkeinen@ti.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20200226112514.12455-10-laurent.pinchart@ideasonboard.com
2020-02-26 11:24:29 +00:00
|
|
|
return drm_bridge_attach(&pipe->encoder, bridge, NULL, 0);
|
2016-08-25 09:04:34 +00:00
|
|
|
}
|
|
|
|
EXPORT_SYMBOL(drm_simple_display_pipe_attach_bridge);
|
|
|
|
|
2016-06-10 14:55:59 +00:00
|
|
|
/**
|
|
|
|
* drm_simple_display_pipe_init - Initialize a simple display pipeline
|
|
|
|
* @dev: DRM device
|
|
|
|
* @pipe: simple display pipe object to initialize
|
|
|
|
* @funcs: callbacks for the display pipe (optional)
|
2016-08-12 20:48:37 +00:00
|
|
|
* @formats: array of supported formats (DRM_FORMAT\_\*)
|
2016-06-10 14:55:59 +00:00
|
|
|
* @format_count: number of elements in @formats
|
2017-07-24 03:46:38 +00:00
|
|
|
* @format_modifiers: array of formats modifiers
|
2016-08-25 09:04:33 +00:00
|
|
|
* @connector: connector to attach and register (optional)
|
2016-06-10 14:55:59 +00:00
|
|
|
*
|
|
|
|
* Sets up a display pipeline which consist of a really simple
|
2016-08-25 09:04:33 +00:00
|
|
|
* plane-crtc-encoder pipe.
|
|
|
|
*
|
|
|
|
* If a connector is supplied, the pipe will be coupled with the provided
|
|
|
|
* connector. You may supply a NULL connector when using drm bridges, that
|
|
|
|
* handle connectors themselves (see drm_simple_display_pipe_attach_bridge()).
|
|
|
|
*
|
2016-06-10 14:55:59 +00:00
|
|
|
* Teardown of a simple display pipe is all handled automatically by the drm
|
|
|
|
* core through calling drm_mode_config_cleanup(). Drivers afterwards need to
|
|
|
|
* release the memory for the structure themselves.
|
|
|
|
*
|
|
|
|
* Returns:
|
|
|
|
* Zero on success, negative error code on failure.
|
|
|
|
*/
|
|
|
|
int drm_simple_display_pipe_init(struct drm_device *dev,
|
|
|
|
struct drm_simple_display_pipe *pipe,
|
|
|
|
const struct drm_simple_display_pipe_funcs *funcs,
|
|
|
|
const uint32_t *formats, unsigned int format_count,
|
2017-07-24 03:46:38 +00:00
|
|
|
const uint64_t *format_modifiers,
|
2016-06-10 14:55:59 +00:00
|
|
|
struct drm_connector *connector)
|
|
|
|
{
|
|
|
|
struct drm_encoder *encoder = &pipe->encoder;
|
|
|
|
struct drm_plane *plane = &pipe->plane;
|
|
|
|
struct drm_crtc *crtc = &pipe->crtc;
|
|
|
|
int ret;
|
|
|
|
|
|
|
|
pipe->connector = connector;
|
|
|
|
pipe->funcs = funcs;
|
|
|
|
|
|
|
|
drm_plane_helper_add(plane, &drm_simple_kms_plane_helper_funcs);
|
|
|
|
ret = drm_universal_plane_init(dev, plane, 0,
|
|
|
|
&drm_simple_kms_plane_funcs,
|
|
|
|
formats, format_count,
|
2017-07-24 03:46:38 +00:00
|
|
|
format_modifiers,
|
2016-06-10 14:55:59 +00:00
|
|
|
DRM_PLANE_TYPE_PRIMARY, NULL);
|
|
|
|
if (ret)
|
|
|
|
return ret;
|
|
|
|
|
|
|
|
drm_crtc_helper_add(crtc, &drm_simple_kms_crtc_helper_funcs);
|
|
|
|
ret = drm_crtc_init_with_planes(dev, crtc, plane, NULL,
|
|
|
|
&drm_simple_kms_crtc_funcs, NULL);
|
|
|
|
if (ret)
|
|
|
|
return ret;
|
|
|
|
|
2018-06-26 19:47:08 +00:00
|
|
|
encoder->possible_crtcs = drm_crtc_mask(crtc);
|
2016-06-10 14:55:59 +00:00
|
|
|
ret = drm_encoder_init(dev, encoder, &drm_simple_kms_encoder_funcs,
|
|
|
|
DRM_MODE_ENCODER_NONE, NULL);
|
2016-08-25 09:04:33 +00:00
|
|
|
if (ret || !connector)
|
2016-06-10 14:55:59 +00:00
|
|
|
return ret;
|
|
|
|
|
2018-07-09 08:40:07 +00:00
|
|
|
return drm_connector_attach_encoder(connector, encoder);
|
2016-06-10 14:55:59 +00:00
|
|
|
}
|
|
|
|
EXPORT_SYMBOL(drm_simple_display_pipe_init);
|
|
|
|
|
|
|
|
MODULE_LICENSE("GPL");
|