blob: 1c4d6746f90ca620f174baa5695fd37e8624a603 [file] [log] [blame]
Dave Airlief453ba02008-11-07 14:05:41 -08001/*
2 * Copyright (c) 2006-2008 Intel Corporation
3 * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
4 *
5 * DRM core CRTC related functions
6 *
7 * Permission to use, copy, modify, distribute, and sell this software and its
8 * documentation for any purpose is hereby granted without fee, provided that
9 * the above copyright notice appear in all copies and that both that copyright
10 * notice and this permission notice appear in supporting documentation, and
11 * that the name of the copyright holders not be used in advertising or
12 * publicity pertaining to distribution of the software without specific,
13 * written prior permission. The copyright holders make no representations
14 * about the suitability of this software for any purpose. It is provided "as
15 * is" without express or implied warranty.
16 *
17 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
18 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
19 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
20 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
21 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
22 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
23 * OF THIS SOFTWARE.
24 *
25 * Authors:
26 * Keith Packard
27 * Eric Anholt <eric@anholt.net>
28 * Dave Airlie <airlied@linux.ie>
29 * Jesse Barnes <jesse.barnes@intel.com>
30 */
31
Sergei Antonovba6f5822014-05-12 00:30:48 +020032#include <linux/kernel.h>
Paul Gortmaker2d1a8a42011-08-30 18:16:33 -040033#include <linux/export.h>
Paul Gortmaker0603ba12011-08-31 11:29:09 -040034#include <linux/moduleparam.h>
Paul Gortmaker2d1a8a42011-08-30 18:16:33 -040035
David Howells760285e2012-10-02 18:01:07 +010036#include <drm/drmP.h>
Daniel Vetter321ebf02014-11-04 22:57:27 +010037#include <drm/drm_atomic.h>
David Howells760285e2012-10-02 18:01:07 +010038#include <drm/drm_crtc.h>
39#include <drm/drm_fourcc.h>
40#include <drm/drm_crtc_helper.h>
41#include <drm/drm_fb_helper.h>
Daniel Vetter2f324b42014-10-29 11:13:47 +010042#include <drm/drm_plane_helper.h>
Daniel Vetter321ebf02014-11-04 22:57:27 +010043#include <drm/drm_atomic_helper.h>
David Howells760285e2012-10-02 18:01:07 +010044#include <drm/drm_edid.h>
Dave Airlief453ba02008-11-07 14:05:41 -080045
Daniel Vetter3150c7d2014-11-06 20:53:29 +010046/**
47 * DOC: overview
48 *
49 * The CRTC modeset helper library provides a default set_config implementation
50 * in drm_crtc_helper_set_config(). Plus a few other convenience functions using
51 * the same callbacks which drivers can use to e.g. restore the modeset
52 * configuration on resume with drm_helper_resume_force_mode().
53 *
Daniel Vetter2be94972015-12-04 09:45:46 +010054 * Note that this helper library doesn't track the current power state of CRTCs
55 * and encoders. It can call callbacks like ->dpms() even though the hardware is
56 * already in the desired state. This deficiency has been fixed in the atomic
57 * helpers.
58 *
Daniel Vetter3150c7d2014-11-06 20:53:29 +010059 * The driver callbacks are mostly compatible with the atomic modeset helpers,
60 * except for the handling of the primary plane: Atomic helpers require that the
61 * primary plane is implemented as a real standalone plane and not directly tied
62 * to the CRTC state. For easier transition this library provides functions to
63 * implement the old semantics required by the CRTC helpers using the new plane
64 * and atomic helper callbacks.
65 *
66 * Drivers are strongly urged to convert to the atomic helpers (by way of first
67 * converting to the plane helpers). New drivers must not use these functions
68 * but need to implement the atomic interface instead, potentially using the
69 * atomic helpers for that.
Daniel Vetter092d01d2015-12-04 09:45:44 +010070 *
71 * These legacy modeset helpers use the same function table structures as
72 * all other modesetting helpers. See the documentation for struct
73 * &drm_crtc_helper_funcs, struct &drm_encoder_helper_funcs and struct
74 * &drm_connector_helper_funcs.
Daniel Vetter3150c7d2014-11-06 20:53:29 +010075 */
Daniel Vetter92b6f892013-10-08 17:44:47 +020076
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +010077/**
78 * drm_helper_move_panel_connectors_to_head() - move panels to the front in the
79 * connector list
80 * @dev: drm device to operate on
81 *
82 * Some userspace presumes that the first connected connector is the main
83 * display, where it's supposed to display e.g. the login screen. For
84 * laptops, this should be the main panel. Use this function to sort all
85 * (eDP/LVDS) panels to the front of the connector list, instead of
86 * painstakingly trying to initialize them in the right order.
87 */
Daniel Vettercfc1a062012-10-27 15:52:04 +020088void drm_helper_move_panel_connectors_to_head(struct drm_device *dev)
89{
90 struct drm_connector *connector, *tmp;
91 struct list_head panel_list;
92
93 INIT_LIST_HEAD(&panel_list);
94
95 list_for_each_entry_safe(connector, tmp,
96 &dev->mode_config.connector_list, head) {
97 if (connector->connector_type == DRM_MODE_CONNECTOR_LVDS ||
98 connector->connector_type == DRM_MODE_CONNECTOR_eDP)
99 list_move_tail(&connector->head, &panel_list);
100 }
101
102 list_splice(&panel_list, &dev->mode_config.connector_list);
103}
104EXPORT_SYMBOL(drm_helper_move_panel_connectors_to_head);
105
Dave Airlief453ba02008-11-07 14:05:41 -0800106/**
Keith Packardc9fb15f2009-05-30 20:42:28 -0700107 * drm_helper_encoder_in_use - check if a given encoder is in use
108 * @encoder: encoder to check
109 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100110 * Checks whether @encoder is with the current mode setting output configuration
111 * in use by any connector. This doesn't mean that it is actually enabled since
112 * the DPMS state is tracked separately.
Keith Packardc9fb15f2009-05-30 20:42:28 -0700113 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100114 * Returns:
115 * True if @encoder is used, false otherwise.
Keith Packardc9fb15f2009-05-30 20:42:28 -0700116 */
117bool drm_helper_encoder_in_use(struct drm_encoder *encoder)
118{
119 struct drm_connector *connector;
120 struct drm_device *dev = encoder->dev;
Daniel Vetter62ff94a2014-01-23 22:18:47 +0100121
Sergei Antonovba6f5822014-05-12 00:30:48 +0200122 /*
123 * We can expect this mutex to be locked if we are not panicking.
124 * Locking is currently fubar in the panic handler.
125 */
Dave Airlie8d4ad9d2014-06-05 20:28:59 +1000126 if (!oops_in_progress) {
Sergei Antonovba6f5822014-05-12 00:30:48 +0200127 WARN_ON(!mutex_is_locked(&dev->mode_config.mutex));
Dave Airlie8d4ad9d2014-06-05 20:28:59 +1000128 WARN_ON(!drm_modeset_is_locked(&dev->mode_config.connection_mutex));
129 }
Sergei Antonovba6f5822014-05-12 00:30:48 +0200130
Daniel Vetter9a9f5ce2015-07-09 23:44:34 +0200131 drm_for_each_connector(connector, dev)
Keith Packardc9fb15f2009-05-30 20:42:28 -0700132 if (connector->encoder == encoder)
133 return true;
134 return false;
135}
136EXPORT_SYMBOL(drm_helper_encoder_in_use);
137
138/**
Dave Airlief453ba02008-11-07 14:05:41 -0800139 * drm_helper_crtc_in_use - check if a given CRTC is in a mode_config
140 * @crtc: CRTC to check
141 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100142 * Checks whether @crtc is with the current mode setting output configuration
143 * in use by any connector. This doesn't mean that it is actually enabled since
144 * the DPMS state is tracked separately.
Dave Airlief453ba02008-11-07 14:05:41 -0800145 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100146 * Returns:
147 * True if @crtc is used, false otherwise.
Dave Airlief453ba02008-11-07 14:05:41 -0800148 */
149bool drm_helper_crtc_in_use(struct drm_crtc *crtc)
150{
151 struct drm_encoder *encoder;
152 struct drm_device *dev = crtc->dev;
Daniel Vetter62ff94a2014-01-23 22:18:47 +0100153
Sergei Antonovba6f5822014-05-12 00:30:48 +0200154 /*
155 * We can expect this mutex to be locked if we are not panicking.
156 * Locking is currently fubar in the panic handler.
157 */
158 if (!oops_in_progress)
159 WARN_ON(!mutex_is_locked(&dev->mode_config.mutex));
160
Daniel Vettere4f62542015-07-09 23:44:35 +0200161 drm_for_each_encoder(encoder, dev)
Keith Packardc9fb15f2009-05-30 20:42:28 -0700162 if (encoder->crtc == crtc && drm_helper_encoder_in_use(encoder))
Dave Airlief453ba02008-11-07 14:05:41 -0800163 return true;
164 return false;
165}
166EXPORT_SYMBOL(drm_helper_crtc_in_use);
167
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000168static void
169drm_encoder_disable(struct drm_encoder *encoder)
170{
Jani Nikulabe26a662015-03-11 11:51:06 +0200171 const struct drm_encoder_helper_funcs *encoder_funcs = encoder->helper_private;
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000172
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200173 if (!encoder_funcs)
174 return;
175
Archit Taneja862e6862015-05-21 11:03:16 +0530176 drm_bridge_disable(encoder->bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400177
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000178 if (encoder_funcs->disable)
179 (*encoder_funcs->disable)(encoder);
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200180 else if (encoder_funcs->dpms)
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000181 (*encoder_funcs->dpms)(encoder, DRM_MODE_DPMS_OFF);
Sean Paul3b336ec2013-08-14 16:47:37 -0400182
Archit Taneja862e6862015-05-21 11:03:16 +0530183 drm_bridge_post_disable(encoder->bridge);
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000184}
185
Daniel Vetterb182cc52014-03-20 14:26:34 +0100186static void __drm_helper_disable_unused_functions(struct drm_device *dev)
Dave Airlief453ba02008-11-07 14:05:41 -0800187{
188 struct drm_encoder *encoder;
Dave Airlief453ba02008-11-07 14:05:41 -0800189 struct drm_crtc *crtc;
190
Daniel Vetter62ff94a2014-01-23 22:18:47 +0100191 drm_warn_on_modeset_not_all_locked(dev);
192
Daniel Vetter6295d602015-07-09 23:44:25 +0200193 drm_for_each_encoder(encoder, dev) {
Dave Airlie929710212010-12-21 12:47:56 +1000194 if (!drm_helper_encoder_in_use(encoder)) {
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000195 drm_encoder_disable(encoder);
Rob Clarkb5e6c1d2014-05-24 14:30:10 -0400196 /* disconnect encoder from any connector */
Dave Airlie9c552dd2009-09-02 14:00:11 +1000197 encoder->crtc = NULL;
Dave Airliea3a05442009-08-31 15:16:30 +1000198 }
Dave Airlief453ba02008-11-07 14:05:41 -0800199 }
200
Daniel Vetter6295d602015-07-09 23:44:25 +0200201 drm_for_each_crtc(crtc, dev) {
Jani Nikulabe26a662015-03-11 11:51:06 +0200202 const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800203 crtc->enabled = drm_helper_crtc_in_use(crtc);
204 if (!crtc->enabled) {
Alex Deucher5c8d7172010-06-11 17:04:35 -0400205 if (crtc_funcs->disable)
206 (*crtc_funcs->disable)(crtc);
207 else
208 (*crtc_funcs->dpms)(crtc, DRM_MODE_DPMS_OFF);
Matt Roperf4510a22014-04-01 15:22:40 -0700209 crtc->primary->fb = NULL;
Dave Airlief453ba02008-11-07 14:05:41 -0800210 }
211 }
212}
Daniel Vetterb182cc52014-03-20 14:26:34 +0100213
214/**
215 * drm_helper_disable_unused_functions - disable unused objects
216 * @dev: DRM device
217 *
218 * This function walks through the entire mode setting configuration of @dev. It
Daniel Vetter2be94972015-12-04 09:45:46 +0100219 * will remove any CRTC links of unused encoders and encoder links of
220 * disconnected connectors. Then it will disable all unused encoders and CRTCs
Daniel Vetterb182cc52014-03-20 14:26:34 +0100221 * either by calling their disable callback if available or by calling their
222 * dpms callback with DRM_MODE_DPMS_OFF.
Daniel Vetter09859d22016-01-13 15:31:16 +0100223 *
224 * NOTE:
225 *
226 * This function is part of the legacy modeset helper library and will cause
227 * major confusion with atomic drivers. This is because atomic helpers guarantee
228 * to never call ->disable() hooks on a disabled function, or ->enable() hooks
229 * on an enabled functions. drm_helper_disable_unused_functions() on the other
230 * hand throws such guarantees into the wind and calls disable hooks
231 * unconditionally on unused functions.
Daniel Vetterb182cc52014-03-20 14:26:34 +0100232 */
233void drm_helper_disable_unused_functions(struct drm_device *dev)
234{
235 drm_modeset_lock_all(dev);
236 __drm_helper_disable_unused_functions(dev);
237 drm_modeset_unlock_all(dev);
238}
Dave Airlief453ba02008-11-07 14:05:41 -0800239EXPORT_SYMBOL(drm_helper_disable_unused_functions);
240
Jesse Barnes7bec7562009-02-23 16:09:34 -0800241/*
242 * Check the CRTC we're going to map each output to vs. its current
243 * CRTC. If they don't match, we have to disable the output and the CRTC
244 * since the driver will have to re-route things.
245 */
246static void
247drm_crtc_prepare_encoders(struct drm_device *dev)
248{
Jani Nikulabe26a662015-03-11 11:51:06 +0200249 const struct drm_encoder_helper_funcs *encoder_funcs;
Jesse Barnes7bec7562009-02-23 16:09:34 -0800250 struct drm_encoder *encoder;
251
Daniel Vetter6295d602015-07-09 23:44:25 +0200252 drm_for_each_encoder(encoder, dev) {
Jesse Barnes7bec7562009-02-23 16:09:34 -0800253 encoder_funcs = encoder->helper_private;
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200254 if (!encoder_funcs)
255 continue;
256
Jesse Barnes7bec7562009-02-23 16:09:34 -0800257 /* Disable unused encoders */
258 if (encoder->crtc == NULL)
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000259 drm_encoder_disable(encoder);
Jesse Barnes7bec7562009-02-23 16:09:34 -0800260 /* Disable encoders whose CRTC is about to change */
261 if (encoder_funcs->get_crtc &&
262 encoder->crtc != (*encoder_funcs->get_crtc)(encoder))
Ben Skeggs86a1b9d2010-07-01 16:49:57 +1000263 drm_encoder_disable(encoder);
Jesse Barnes7bec7562009-02-23 16:09:34 -0800264 }
265}
266
Dave Airlief453ba02008-11-07 14:05:41 -0800267/**
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100268 * drm_crtc_helper_set_mode - internal helper to set a mode
Dave Airlief453ba02008-11-07 14:05:41 -0800269 * @crtc: CRTC to program
270 * @mode: mode to use
Alex Deucher4c9287c2012-11-09 17:26:32 +0000271 * @x: horizontal offset into the surface
272 * @y: vertical offset into the surface
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100273 * @old_fb: old framebuffer, for cleanup
Dave Airlief453ba02008-11-07 14:05:41 -0800274 *
Dave Airlief453ba02008-11-07 14:05:41 -0800275 * Try to set @mode on @crtc. Give @crtc and its associated connectors a chance
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100276 * to fixup or reject the mode prior to trying to set it. This is an internal
277 * helper that drivers could e.g. use to update properties that require the
278 * entire output pipe to be disabled and re-enabled in a new configuration. For
279 * example for changing whether audio is enabled on a hdmi link or for changing
280 * panel fitter or dither attributes. It is also called by the
281 * drm_crtc_helper_set_config() helper function to drive the mode setting
282 * sequence.
Dave Airlief453ba02008-11-07 14:05:41 -0800283 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100284 * Returns:
285 * True if the mode was set successfully, false otherwise.
Dave Airlief453ba02008-11-07 14:05:41 -0800286 */
287bool drm_crtc_helper_set_mode(struct drm_crtc *crtc,
288 struct drm_display_mode *mode,
Kristian Høgsberg3c4fdcf2008-12-17 22:14:46 -0500289 int x, int y,
290 struct drm_framebuffer *old_fb)
Dave Airlief453ba02008-11-07 14:05:41 -0800291{
292 struct drm_device *dev = crtc->dev;
Daniel Stone5a275282015-03-19 04:33:03 +0000293 struct drm_display_mode *adjusted_mode, saved_mode, saved_hwmode;
Jani Nikulabe26a662015-03-11 11:51:06 +0200294 const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
295 const struct drm_encoder_helper_funcs *encoder_funcs;
Dave Airlief453ba02008-11-07 14:05:41 -0800296 int saved_x, saved_y;
Ilija Hadzic7e99acd2013-10-29 11:09:44 -0400297 bool saved_enabled;
Dave Airlief453ba02008-11-07 14:05:41 -0800298 struct drm_encoder *encoder;
299 bool ret = true;
300
Daniel Vetter62ff94a2014-01-23 22:18:47 +0100301 drm_warn_on_modeset_not_all_locked(dev);
302
Ilija Hadzic7e99acd2013-10-29 11:09:44 -0400303 saved_enabled = crtc->enabled;
Dave Airlief453ba02008-11-07 14:05:41 -0800304 crtc->enabled = drm_helper_crtc_in_use(crtc);
Dave Airlief453ba02008-11-07 14:05:41 -0800305 if (!crtc->enabled)
306 return true;
307
Chris Wilson021a8452011-01-28 11:31:56 +0000308 adjusted_mode = drm_mode_duplicate(dev, mode);
Ilija Hadzic7e99acd2013-10-29 11:09:44 -0400309 if (!adjusted_mode) {
310 crtc->enabled = saved_enabled;
Ville Syrjälä6bfc56a2012-03-13 12:35:48 +0200311 return false;
Ilija Hadzic7e99acd2013-10-29 11:09:44 -0400312 }
Chris Wilson021a8452011-01-28 11:31:56 +0000313
Dave Airlief453ba02008-11-07 14:05:41 -0800314 saved_mode = crtc->mode;
Daniel Stone5a275282015-03-19 04:33:03 +0000315 saved_hwmode = crtc->hwmode;
Dave Airlief453ba02008-11-07 14:05:41 -0800316 saved_x = crtc->x;
317 saved_y = crtc->y;
318
319 /* Update crtc values up front so the driver can rely on them for mode
320 * setting.
321 */
322 crtc->mode = *mode;
323 crtc->x = x;
324 crtc->y = y;
325
Dave Airlief453ba02008-11-07 14:05:41 -0800326 /* Pass our mode to the connectors and the CRTC to give them a chance to
327 * adjust it according to limitations or connector properties, and also
328 * a chance to reject the mode entirely.
329 */
Daniel Vetter6295d602015-07-09 23:44:25 +0200330 drm_for_each_encoder(encoder, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800331
332 if (encoder->crtc != crtc)
333 continue;
Sean Paul3b336ec2013-08-14 16:47:37 -0400334
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200335 encoder_funcs = encoder->helper_private;
336 if (!encoder_funcs)
337 continue;
338
Archit Taneja862e6862015-05-21 11:03:16 +0530339 ret = drm_bridge_mode_fixup(encoder->bridge,
340 mode, adjusted_mode);
341 if (!ret) {
342 DRM_DEBUG_KMS("Bridge fixup failed\n");
343 goto done;
Sean Paul3b336ec2013-08-14 16:47:37 -0400344 }
345
Dave Airlief453ba02008-11-07 14:05:41 -0800346 encoder_funcs = encoder->helper_private;
Carlos Palminha3c5b2672016-02-10 12:15:22 +0000347 if (encoder_funcs->mode_fixup) {
348 if (!(ret = encoder_funcs->mode_fixup(encoder, mode,
349 adjusted_mode))) {
350 DRM_DEBUG_KMS("Encoder fixup failed\n");
351 goto done;
352 }
Dave Airlief453ba02008-11-07 14:05:41 -0800353 }
354 }
355
Carlos Palminha49f718c2016-02-16 14:10:03 +0000356 if (crtc_funcs->mode_fixup) {
357 if (!(ret = crtc_funcs->mode_fixup(crtc, mode,
358 adjusted_mode))) {
359 DRM_DEBUG_KMS("CRTC fixup failed\n");
360 goto done;
361 }
Dave Airlief453ba02008-11-07 14:05:41 -0800362 }
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200363 DRM_DEBUG_KMS("[CRTC:%d:%s]\n", crtc->base.id, crtc->name);
Dave Airlief453ba02008-11-07 14:05:41 -0800364
Daniel Stone5a275282015-03-19 04:33:03 +0000365 crtc->hwmode = *adjusted_mode;
366
Dave Airlief453ba02008-11-07 14:05:41 -0800367 /* Prepare the encoders and CRTCs before setting the mode. */
Daniel Vetter6295d602015-07-09 23:44:25 +0200368 drm_for_each_encoder(encoder, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800369
370 if (encoder->crtc != crtc)
371 continue;
Sean Paul3b336ec2013-08-14 16:47:37 -0400372
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200373 encoder_funcs = encoder->helper_private;
374 if (!encoder_funcs)
375 continue;
376
Archit Taneja862e6862015-05-21 11:03:16 +0530377 drm_bridge_disable(encoder->bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400378
Dave Airlief453ba02008-11-07 14:05:41 -0800379 /* Disable the encoders as the first thing we do. */
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200380 if (encoder_funcs->prepare)
381 encoder_funcs->prepare(encoder);
Sean Paul3b336ec2013-08-14 16:47:37 -0400382
Archit Taneja862e6862015-05-21 11:03:16 +0530383 drm_bridge_post_disable(encoder->bridge);
Dave Airlief453ba02008-11-07 14:05:41 -0800384 }
385
Jesse Barnes7bec7562009-02-23 16:09:34 -0800386 drm_crtc_prepare_encoders(dev);
387
Dave Airlief453ba02008-11-07 14:05:41 -0800388 crtc_funcs->prepare(crtc);
389
390 /* Set up the DPLL and any encoders state that needs to adjust or depend
391 * on the DPLL.
392 */
Chris Wilson5c3b82e2009-02-11 13:25:09 +0000393 ret = !crtc_funcs->mode_set(crtc, mode, adjusted_mode, x, y, old_fb);
394 if (!ret)
395 goto done;
Dave Airlief453ba02008-11-07 14:05:41 -0800396
Daniel Vetter6295d602015-07-09 23:44:25 +0200397 drm_for_each_encoder(encoder, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800398
399 if (encoder->crtc != crtc)
400 continue;
401
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200402 encoder_funcs = encoder->helper_private;
403 if (!encoder_funcs)
404 continue;
405
Jerome Glisse94401062010-07-15 15:43:25 -0400406 DRM_DEBUG_KMS("[ENCODER:%d:%s] set [MODE:%d:%s]\n",
Jani Nikula83a8cfd2014-06-03 14:56:22 +0300407 encoder->base.id, encoder->name,
Jerome Glisse94401062010-07-15 15:43:25 -0400408 mode->base.id, mode->name);
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200409 if (encoder_funcs->mode_set)
410 encoder_funcs->mode_set(encoder, mode, adjusted_mode);
Sean Paul3b336ec2013-08-14 16:47:37 -0400411
Archit Taneja862e6862015-05-21 11:03:16 +0530412 drm_bridge_mode_set(encoder->bridge, mode, adjusted_mode);
Dave Airlief453ba02008-11-07 14:05:41 -0800413 }
414
415 /* Now enable the clocks, plane, pipe, and connectors that we set up. */
416 crtc_funcs->commit(crtc);
417
Daniel Vetter6295d602015-07-09 23:44:25 +0200418 drm_for_each_encoder(encoder, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800419
420 if (encoder->crtc != crtc)
421 continue;
422
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200423 encoder_funcs = encoder->helper_private;
424 if (!encoder_funcs)
425 continue;
426
Archit Taneja862e6862015-05-21 11:03:16 +0530427 drm_bridge_pre_enable(encoder->bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400428
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200429 if (encoder_funcs->commit)
430 encoder_funcs->commit(encoder);
Dave Airlief453ba02008-11-07 14:05:41 -0800431
Archit Taneja862e6862015-05-21 11:03:16 +0530432 drm_bridge_enable(encoder->bridge);
Dave Airlief453ba02008-11-07 14:05:41 -0800433 }
434
Mario Kleiner27641c32010-10-23 04:20:23 +0200435 /* Calculate and store various constants which
436 * are later needed by vblank and swap-completion
437 * timestamping. They are derived from true hwmode.
438 */
Ville Syrjälä545cdd52013-10-26 17:16:30 +0300439 drm_calc_timestamping_constants(crtc, &crtc->hwmode);
Mario Kleiner27641c32010-10-23 04:20:23 +0200440
Dave Airlief453ba02008-11-07 14:05:41 -0800441 /* FIXME: add subpixel order */
442done:
Chris Wilson021a8452011-01-28 11:31:56 +0000443 drm_mode_destroy(dev, adjusted_mode);
Dave Airlief453ba02008-11-07 14:05:41 -0800444 if (!ret) {
Ilija Hadzic7e99acd2013-10-29 11:09:44 -0400445 crtc->enabled = saved_enabled;
Dave Airlief453ba02008-11-07 14:05:41 -0800446 crtc->mode = saved_mode;
Daniel Stone5a275282015-03-19 04:33:03 +0000447 crtc->hwmode = saved_hwmode;
Dave Airlief453ba02008-11-07 14:05:41 -0800448 crtc->x = saved_x;
449 crtc->y = saved_y;
450 }
451
452 return ret;
453}
454EXPORT_SYMBOL(drm_crtc_helper_set_mode);
455
Thierry Redinga74591d2014-04-29 11:44:39 +0200456static void
Chris Wilson6eebd6b2011-11-28 21:10:05 +0000457drm_crtc_helper_disable(struct drm_crtc *crtc)
458{
459 struct drm_device *dev = crtc->dev;
460 struct drm_connector *connector;
461 struct drm_encoder *encoder;
462
463 /* Decouple all encoders and their attached connectors from this crtc */
Daniel Vetter6295d602015-07-09 23:44:25 +0200464 drm_for_each_encoder(encoder, dev) {
Chris Wilson6eebd6b2011-11-28 21:10:05 +0000465 if (encoder->crtc != crtc)
466 continue;
467
Daniel Vetter6295d602015-07-09 23:44:25 +0200468 drm_for_each_connector(connector, dev) {
Chris Wilson6eebd6b2011-11-28 21:10:05 +0000469 if (connector->encoder != encoder)
470 continue;
471
472 connector->encoder = NULL;
Thierry Redinga6ad6232013-10-02 15:50:06 +0200473
474 /*
475 * drm_helper_disable_unused_functions() ought to be
476 * doing this, but since we've decoupled the encoder
477 * from the connector above, the required connection
478 * between them is henceforth no longer available.
479 */
480 connector->dpms = DRM_MODE_DPMS_OFF;
Dave Airlie0955c122016-04-27 11:27:54 +1000481
482 /* we keep a reference while the encoder is bound */
483 drm_connector_unreference(connector);
Chris Wilson6eebd6b2011-11-28 21:10:05 +0000484 }
485 }
486
Daniel Vetterb182cc52014-03-20 14:26:34 +0100487 __drm_helper_disable_unused_functions(dev);
Chris Wilson6eebd6b2011-11-28 21:10:05 +0000488}
489
Dave Airlief453ba02008-11-07 14:05:41 -0800490/**
491 * drm_crtc_helper_set_config - set a new config from userspace
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100492 * @set: mode set configuration
Dave Airlief453ba02008-11-07 14:05:41 -0800493 *
Daniel Vetter2be94972015-12-04 09:45:46 +0100494 * The drm_crtc_helper_set_config() helper function implements the set_config
495 * callback of struct &drm_crtc_funcs for drivers using the legacy CRTC helpers.
496 *
497 * It first tries to locate the best encoder for each connector by calling the
498 * connector ->best_encoder() (struct &drm_connector_helper_funcs) helper
499 * operation.
500 *
501 * After locating the appropriate encoders, the helper function will call the
502 * mode_fixup encoder and CRTC helper operations to adjust the requested mode,
503 * or reject it completely in which case an error will be returned to the
504 * application. If the new configuration after mode adjustment is identical to
505 * the current configuration the helper function will return without performing
506 * any other operation.
507 *
508 * If the adjusted mode is identical to the current mode but changes to the
509 * frame buffer need to be applied, the drm_crtc_helper_set_config() function
510 * will call the CRTC ->mode_set_base() (struct &drm_crtc_helper_funcs) helper
511 * operation.
512 *
513 * If the adjusted mode differs from the current mode, or if the
514 * ->mode_set_base() helper operation is not provided, the helper function
515 * performs a full mode set sequence by calling the ->prepare(), ->mode_set()
516 * and ->commit() CRTC and encoder helper operations, in that order.
517 * Alternatively it can also use the dpms and disable helper operations. For
518 * details see struct &drm_crtc_helper_funcs and struct
519 * &drm_encoder_helper_funcs.
520 *
521 * This function is deprecated. New drivers must implement atomic modeset
522 * support, for which this function is unsuitable. Instead drivers should use
523 * drm_atomic_helper_set_config().
Dave Airlief453ba02008-11-07 14:05:41 -0800524 *
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100525 * Returns:
526 * Returns 0 on success, negative errno numbers on failure.
Dave Airlief453ba02008-11-07 14:05:41 -0800527 */
528int drm_crtc_helper_set_config(struct drm_mode_set *set)
529{
530 struct drm_device *dev;
Ilija Hadzic02ee4e92013-10-29 11:09:46 -0400531 struct drm_crtc *new_crtc;
Maarten Maathuise67aae72009-08-27 10:18:29 +0200532 struct drm_encoder *save_encoders, *new_encoder, *encoder;
Jakob Bornecrantz4cb72b12009-08-03 13:43:59 +0100533 bool mode_changed = false; /* if true do a full mode set */
534 bool fb_changed = false; /* if true and !mode_changed just do a flip */
Maarten Maathuise67aae72009-08-27 10:18:29 +0200535 struct drm_connector *save_connectors, *connector;
Dave Airlief453ba02008-11-07 14:05:41 -0800536 int count = 0, ro, fail = 0;
Jani Nikulabe26a662015-03-11 11:51:06 +0200537 const struct drm_crtc_helper_funcs *crtc_funcs;
Jesse Barnesc5006cfe2011-11-07 10:39:57 -0800538 struct drm_mode_set save_set;
Laurent Pinchart4a1b0712012-05-17 13:27:21 +0200539 int ret;
Keith Packardbf9dc102010-11-26 10:45:58 -0800540 int i;
Dave Airlief453ba02008-11-07 14:05:41 -0800541
Zhao Yakui58367ed2009-07-20 13:48:07 +0800542 DRM_DEBUG_KMS("\n");
Dave Airlief453ba02008-11-07 14:05:41 -0800543
Daniel Vettere58de882013-06-15 00:13:11 +0200544 BUG_ON(!set);
545 BUG_ON(!set->crtc);
546 BUG_ON(!set->crtc->helper_private);
Dave Airlief453ba02008-11-07 14:05:41 -0800547
Daniel Vettere58de882013-06-15 00:13:11 +0200548 /* Enforce sane interface api - has been abused by the fb helper. */
549 BUG_ON(!set->mode && set->fb);
550 BUG_ON(set->fb && set->num_connectors == 0);
Dave Airlief453ba02008-11-07 14:05:41 -0800551
552 crtc_funcs = set->crtc->helper_private;
553
Chris Wilsonede3ff52011-01-31 11:16:33 +0000554 if (!set->mode)
555 set->fb = NULL;
556
Jerome Glisse94401062010-07-15 15:43:25 -0400557 if (set->fb) {
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200558 DRM_DEBUG_KMS("[CRTC:%d:%s] [FB:%d] #connectors=%d (x y) (%i %i)\n",
559 set->crtc->base.id, set->crtc->name,
560 set->fb->base.id,
561 (int)set->num_connectors, set->x, set->y);
Jerome Glisse94401062010-07-15 15:43:25 -0400562 } else {
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200563 DRM_DEBUG_KMS("[CRTC:%d:%s] [NOFB]\n",
564 set->crtc->base.id, set->crtc->name);
Thierry Redinga74591d2014-04-29 11:44:39 +0200565 drm_crtc_helper_disable(set->crtc);
566 return 0;
Jerome Glisse94401062010-07-15 15:43:25 -0400567 }
Dave Airlief453ba02008-11-07 14:05:41 -0800568
569 dev = set->crtc->dev;
570
Daniel Vetter62ff94a2014-01-23 22:18:47 +0100571 drm_warn_on_modeset_not_all_locked(dev);
572
Ilija Hadzic02ee4e92013-10-29 11:09:46 -0400573 /*
574 * Allocate space for the backup of all (non-pointer) encoder and
575 * connector data.
576 */
Maarten Maathuise67aae72009-08-27 10:18:29 +0200577 save_encoders = kzalloc(dev->mode_config.num_encoder *
578 sizeof(struct drm_encoder), GFP_KERNEL);
Ilija Hadzic02ee4e92013-10-29 11:09:46 -0400579 if (!save_encoders)
Dave Airlief453ba02008-11-07 14:05:41 -0800580 return -ENOMEM;
Dave Airlief453ba02008-11-07 14:05:41 -0800581
Maarten Maathuise67aae72009-08-27 10:18:29 +0200582 save_connectors = kzalloc(dev->mode_config.num_connector *
583 sizeof(struct drm_connector), GFP_KERNEL);
584 if (!save_connectors) {
Maarten Maathuise67aae72009-08-27 10:18:29 +0200585 kfree(save_encoders);
586 return -ENOMEM;
587 }
588
Ilija Hadzic02ee4e92013-10-29 11:09:46 -0400589 /*
590 * Copy data. Note that driver private data is not affected.
Maarten Maathuise67aae72009-08-27 10:18:29 +0200591 * Should anything bad happen only the expected state is
592 * restored, not the drivers personal bookkeeping.
593 */
594 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200595 drm_for_each_encoder(encoder, dev) {
Maarten Maathuise67aae72009-08-27 10:18:29 +0200596 save_encoders[count++] = *encoder;
597 }
598
599 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200600 drm_for_each_connector(connector, dev) {
Maarten Maathuise67aae72009-08-27 10:18:29 +0200601 save_connectors[count++] = *connector;
602 }
603
Jesse Barnesc5006cfe2011-11-07 10:39:57 -0800604 save_set.crtc = set->crtc;
605 save_set.mode = &set->crtc->mode;
606 save_set.x = set->crtc->x;
607 save_set.y = set->crtc->y;
Matt Roperf4510a22014-04-01 15:22:40 -0700608 save_set.fb = set->crtc->primary->fb;
Jesse Barnesc5006cfe2011-11-07 10:39:57 -0800609
Dave Airlief453ba02008-11-07 14:05:41 -0800610 /* We should be able to check here if the fb has the same properties
611 * and then just flip_or_move it */
Matt Roperf4510a22014-04-01 15:22:40 -0700612 if (set->crtc->primary->fb != set->fb) {
Jesse Barnes712531b2009-01-09 13:56:14 -0800613 /* If we have no fb then treat it as a full mode set */
Matt Roperf4510a22014-04-01 15:22:40 -0700614 if (set->crtc->primary->fb == NULL) {
Zhao Yakui58367ed2009-07-20 13:48:07 +0800615 DRM_DEBUG_KMS("crtc has no fb, full mode set\n");
Jesse Barnes712531b2009-01-09 13:56:14 -0800616 mode_changed = true;
Laurent Pinchartce83adf2013-04-22 01:38:47 +0200617 } else if (set->fb->pixel_format !=
Matt Roperf4510a22014-04-01 15:22:40 -0700618 set->crtc->primary->fb->pixel_format) {
Laurent Pinchartce83adf2013-04-22 01:38:47 +0200619 mode_changed = true;
Dave Airlie8dff4742010-02-11 14:28:58 +1000620 } else
Jesse Barnes712531b2009-01-09 13:56:14 -0800621 fb_changed = true;
Dave Airlief453ba02008-11-07 14:05:41 -0800622 }
623
624 if (set->x != set->crtc->x || set->y != set->crtc->y)
Jesse Barnes712531b2009-01-09 13:56:14 -0800625 fb_changed = true;
Dave Airlief453ba02008-11-07 14:05:41 -0800626
Liu Ying2deafc72016-01-14 14:00:10 +0800627 if (!drm_mode_equal(set->mode, &set->crtc->mode)) {
Zhao Yakui58367ed2009-07-20 13:48:07 +0800628 DRM_DEBUG_KMS("modes are different, full mode set\n");
Dave Airlief453ba02008-11-07 14:05:41 -0800629 drm_mode_debug_printmodeline(&set->crtc->mode);
630 drm_mode_debug_printmodeline(set->mode);
Jesse Barnes712531b2009-01-09 13:56:14 -0800631 mode_changed = true;
Dave Airlief453ba02008-11-07 14:05:41 -0800632 }
633
Philipp Zabelfffc5f52016-06-02 19:27:51 +0200634 /* take a reference on all unbound connectors in set, reuse the
635 * already taken reference for bound connectors
636 */
Dave Airlie0955c122016-04-27 11:27:54 +1000637 for (ro = 0; ro < set->num_connectors; ro++) {
Philipp Zabelfffc5f52016-06-02 19:27:51 +0200638 if (set->connectors[ro]->encoder)
639 continue;
Dave Airlie0955c122016-04-27 11:27:54 +1000640 drm_connector_reference(set->connectors[ro]);
641 }
642
Dave Airlief453ba02008-11-07 14:05:41 -0800643 /* a) traverse passed in connector list and get encoders for them */
644 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200645 drm_for_each_connector(connector, dev) {
Jani Nikulabe26a662015-03-11 11:51:06 +0200646 const struct drm_connector_helper_funcs *connector_funcs =
Dave Airlief453ba02008-11-07 14:05:41 -0800647 connector->helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800648 new_encoder = connector->encoder;
649 for (ro = 0; ro < set->num_connectors; ro++) {
650 if (set->connectors[ro] == connector) {
651 new_encoder = connector_funcs->best_encoder(connector);
652 /* if we can't get an encoder for a connector
653 we are setting now - then fail */
654 if (new_encoder == NULL)
655 /* don't break so fail path works correct */
656 fail = 1;
Daniel Vetter25f397a2013-07-19 18:57:11 +0200657
658 if (connector->dpms != DRM_MODE_DPMS_ON) {
659 DRM_DEBUG_KMS("connector dpms not on, full mode switch\n");
660 mode_changed = true;
661 }
Daniel Vetter177cf922014-04-01 22:14:59 +0200662
663 break;
Dave Airlief453ba02008-11-07 14:05:41 -0800664 }
665 }
666
667 if (new_encoder != connector->encoder) {
Zhao Yakui58367ed2009-07-20 13:48:07 +0800668 DRM_DEBUG_KMS("encoder changed, full mode switch\n");
Jesse Barnes712531b2009-01-09 13:56:14 -0800669 mode_changed = true;
Maarten Maathuisff846ab2009-08-19 00:56:45 +0200670 /* If the encoder is reused for another connector, then
671 * the appropriate crtc will be set later.
672 */
Maarten Maathuisff6fdbe2009-09-01 03:39:04 +0200673 if (connector->encoder)
674 connector->encoder->crtc = NULL;
Dave Airlief453ba02008-11-07 14:05:41 -0800675 connector->encoder = new_encoder;
676 }
677 }
678
679 if (fail) {
680 ret = -EINVAL;
Maarten Maathuise67aae72009-08-27 10:18:29 +0200681 goto fail;
Dave Airlief453ba02008-11-07 14:05:41 -0800682 }
683
684 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200685 drm_for_each_connector(connector, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800686 if (!connector->encoder)
687 continue;
688
Dave Airlief453ba02008-11-07 14:05:41 -0800689 if (connector->encoder->crtc == set->crtc)
690 new_crtc = NULL;
691 else
692 new_crtc = connector->encoder->crtc;
693
694 for (ro = 0; ro < set->num_connectors; ro++) {
695 if (set->connectors[ro] == connector)
696 new_crtc = set->crtc;
697 }
Jesse Barnes7bec7562009-02-23 16:09:34 -0800698
699 /* Make sure the new CRTC will work with the encoder */
700 if (new_crtc &&
701 !drm_encoder_crtc_ok(connector->encoder, new_crtc)) {
702 ret = -EINVAL;
Maarten Maathuise67aae72009-08-27 10:18:29 +0200703 goto fail;
Jesse Barnes7bec7562009-02-23 16:09:34 -0800704 }
Dave Airlief453ba02008-11-07 14:05:41 -0800705 if (new_crtc != connector->encoder->crtc) {
Zhao Yakui58367ed2009-07-20 13:48:07 +0800706 DRM_DEBUG_KMS("crtc changed, full mode switch\n");
Jesse Barnes712531b2009-01-09 13:56:14 -0800707 mode_changed = true;
Dave Airlief453ba02008-11-07 14:05:41 -0800708 connector->encoder->crtc = new_crtc;
709 }
Jerome Glisse94401062010-07-15 15:43:25 -0400710 if (new_crtc) {
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200711 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] to [CRTC:%d:%s]\n",
712 connector->base.id, connector->name,
713 new_crtc->base.id, new_crtc->name);
Jerome Glisse94401062010-07-15 15:43:25 -0400714 } else {
715 DRM_DEBUG_KMS("[CONNECTOR:%d:%s] to [NOCRTC]\n",
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200716 connector->base.id, connector->name);
Jerome Glisse94401062010-07-15 15:43:25 -0400717 }
Dave Airlief453ba02008-11-07 14:05:41 -0800718 }
719
720 /* mode_set_base is not a required function */
Jesse Barnes712531b2009-01-09 13:56:14 -0800721 if (fb_changed && !crtc_funcs->mode_set_base)
722 mode_changed = true;
Dave Airlief453ba02008-11-07 14:05:41 -0800723
Jesse Barnes712531b2009-01-09 13:56:14 -0800724 if (mode_changed) {
Ilija Hadzic48b1f5d2013-10-29 11:09:45 -0400725 if (drm_helper_crtc_in_use(set->crtc)) {
Zhao Yakui58367ed2009-07-20 13:48:07 +0800726 DRM_DEBUG_KMS("attempting to set mode from"
727 " userspace\n");
Dave Airlief453ba02008-11-07 14:05:41 -0800728 drm_mode_debug_printmodeline(set->mode);
Matt Roperf4510a22014-04-01 15:22:40 -0700729 set->crtc->primary->fb = set->fb;
Dave Airlief453ba02008-11-07 14:05:41 -0800730 if (!drm_crtc_helper_set_mode(set->crtc, set->mode,
Kristian Høgsberg3c4fdcf2008-12-17 22:14:46 -0500731 set->x, set->y,
Ilija Hadzicbec2eac2013-10-29 11:09:42 -0400732 save_set.fb)) {
Ville Syrjäläfa3ab4c2015-12-08 18:41:53 +0200733 DRM_ERROR("failed to set mode on [CRTC:%d:%s]\n",
734 set->crtc->base.id, set->crtc->name);
Matt Roperf4510a22014-04-01 15:22:40 -0700735 set->crtc->primary->fb = save_set.fb;
Dave Airlief453ba02008-11-07 14:05:41 -0800736 ret = -EINVAL;
Maarten Maathuise67aae72009-08-27 10:18:29 +0200737 goto fail;
Dave Airlief453ba02008-11-07 14:05:41 -0800738 }
Daniel Vetter25f397a2013-07-19 18:57:11 +0200739 DRM_DEBUG_KMS("Setting connector DPMS state to on\n");
740 for (i = 0; i < set->num_connectors; i++) {
741 DRM_DEBUG_KMS("\t[CONNECTOR:%d:%s] set DPMS on\n", set->connectors[i]->base.id,
Jani Nikula25933822014-06-03 14:56:20 +0300742 set->connectors[i]->name);
Daniel Vetter25f397a2013-07-19 18:57:11 +0200743 set->connectors[i]->funcs->dpms(set->connectors[i], DRM_MODE_DPMS_ON);
744 }
Dave Airlief453ba02008-11-07 14:05:41 -0800745 }
Daniel Vetterb182cc52014-03-20 14:26:34 +0100746 __drm_helper_disable_unused_functions(dev);
Jesse Barnes712531b2009-01-09 13:56:14 -0800747 } else if (fb_changed) {
Ben Skeggs9b1596a2009-09-18 10:43:52 +1000748 set->crtc->x = set->x;
749 set->crtc->y = set->y;
Matt Roperf4510a22014-04-01 15:22:40 -0700750 set->crtc->primary->fb = set->fb;
Chris Wilson5c3b82e2009-02-11 13:25:09 +0000751 ret = crtc_funcs->mode_set_base(set->crtc,
Ilija Hadzicbec2eac2013-10-29 11:09:42 -0400752 set->x, set->y, save_set.fb);
Chris Wilson0ba41e42011-01-08 15:10:41 +0000753 if (ret != 0) {
Ilija Hadzicfbce4062013-10-29 11:09:43 -0400754 set->crtc->x = save_set.x;
755 set->crtc->y = save_set.y;
Matt Roperf4510a22014-04-01 15:22:40 -0700756 set->crtc->primary->fb = save_set.fb;
Maarten Maathuise67aae72009-08-27 10:18:29 +0200757 goto fail;
Chris Wilson0ba41e42011-01-08 15:10:41 +0000758 }
Dave Airlief453ba02008-11-07 14:05:41 -0800759 }
760
Maarten Maathuise67aae72009-08-27 10:18:29 +0200761 kfree(save_connectors);
Dave Airlief453ba02008-11-07 14:05:41 -0800762 kfree(save_encoders);
Dave Airlief453ba02008-11-07 14:05:41 -0800763 return 0;
764
Maarten Maathuise67aae72009-08-27 10:18:29 +0200765fail:
766 /* Restore all previous data. */
Dave Airlief453ba02008-11-07 14:05:41 -0800767 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200768 drm_for_each_encoder(encoder, dev) {
Maarten Maathuise67aae72009-08-27 10:18:29 +0200769 *encoder = save_encoders[count++];
Chris Wilsone62fb642009-02-11 16:39:21 +0000770 }
Maarten Maathuise67aae72009-08-27 10:18:29 +0200771
Dave Airlief453ba02008-11-07 14:05:41 -0800772 count = 0;
Daniel Vetter6295d602015-07-09 23:44:25 +0200773 drm_for_each_connector(connector, dev) {
Maarten Maathuise67aae72009-08-27 10:18:29 +0200774 *connector = save_connectors[count++];
Dave Airlief453ba02008-11-07 14:05:41 -0800775 }
Maarten Maathuise67aae72009-08-27 10:18:29 +0200776
Philipp Zabelfffc5f52016-06-02 19:27:51 +0200777 /* after fail drop reference on all unbound connectors in set, let
778 * bound connectors keep their reference
779 */
Dave Airlie0955c122016-04-27 11:27:54 +1000780 for (ro = 0; ro < set->num_connectors; ro++) {
Philipp Zabelfffc5f52016-06-02 19:27:51 +0200781 if (set->connectors[ro]->encoder)
782 continue;
Dave Airlie0955c122016-04-27 11:27:54 +1000783 drm_connector_unreference(set->connectors[ro]);
784 }
785
Jesse Barnesc5006cfe2011-11-07 10:39:57 -0800786 /* Try to restore the config */
787 if (mode_changed &&
788 !drm_crtc_helper_set_mode(save_set.crtc, save_set.mode, save_set.x,
789 save_set.y, save_set.fb))
790 DRM_ERROR("failed to restore config after modeset failure\n");
791
Maarten Maathuise67aae72009-08-27 10:18:29 +0200792 kfree(save_connectors);
Dave Airlief453ba02008-11-07 14:05:41 -0800793 kfree(save_encoders);
794 return ret;
795}
796EXPORT_SYMBOL(drm_crtc_helper_set_config);
797
Keith Packardc9fb15f2009-05-30 20:42:28 -0700798static int drm_helper_choose_encoder_dpms(struct drm_encoder *encoder)
799{
800 int dpms = DRM_MODE_DPMS_OFF;
801 struct drm_connector *connector;
802 struct drm_device *dev = encoder->dev;
803
Daniel Vetter9a9f5ce2015-07-09 23:44:34 +0200804 drm_for_each_connector(connector, dev)
Keith Packardc9fb15f2009-05-30 20:42:28 -0700805 if (connector->encoder == encoder)
806 if (connector->dpms < dpms)
807 dpms = connector->dpms;
808 return dpms;
809}
810
Sean Paul3b336ec2013-08-14 16:47:37 -0400811/* Helper which handles bridge ordering around encoder dpms */
812static void drm_helper_encoder_dpms(struct drm_encoder *encoder, int mode)
813{
814 struct drm_bridge *bridge = encoder->bridge;
Jani Nikulabe26a662015-03-11 11:51:06 +0200815 const struct drm_encoder_helper_funcs *encoder_funcs;
Sean Paul3b336ec2013-08-14 16:47:37 -0400816
Noralf Trønnes75229ec2016-05-05 15:24:32 +0200817 encoder_funcs = encoder->helper_private;
818 if (!encoder_funcs)
819 return;
820
Archit Taneja862e6862015-05-21 11:03:16 +0530821 if (mode == DRM_MODE_DPMS_ON)
822 drm_bridge_pre_enable(bridge);
823 else
824 drm_bridge_disable(bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400825
Sean Paul3b336ec2013-08-14 16:47:37 -0400826 if (encoder_funcs->dpms)
827 encoder_funcs->dpms(encoder, mode);
828
Archit Taneja862e6862015-05-21 11:03:16 +0530829 if (mode == DRM_MODE_DPMS_ON)
830 drm_bridge_enable(bridge);
831 else
832 drm_bridge_post_disable(bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400833}
834
Keith Packardc9fb15f2009-05-30 20:42:28 -0700835static int drm_helper_choose_crtc_dpms(struct drm_crtc *crtc)
836{
837 int dpms = DRM_MODE_DPMS_OFF;
838 struct drm_connector *connector;
839 struct drm_device *dev = crtc->dev;
840
Daniel Vetter9a9f5ce2015-07-09 23:44:34 +0200841 drm_for_each_connector(connector, dev)
Keith Packardc9fb15f2009-05-30 20:42:28 -0700842 if (connector->encoder && connector->encoder->crtc == crtc)
843 if (connector->dpms < dpms)
844 dpms = connector->dpms;
845 return dpms;
846}
847
848/**
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100849 * drm_helper_connector_dpms() - connector dpms helper implementation
850 * @connector: affected connector
851 * @mode: DPMS mode
Keith Packardc9fb15f2009-05-30 20:42:28 -0700852 *
Daniel Vetter2be94972015-12-04 09:45:46 +0100853 * The drm_helper_connector_dpms() helper function implements the ->dpms()
854 * callback of struct &drm_connector_funcs for drivers using the legacy CRTC helpers.
855 *
856 * This is the main helper function provided by the CRTC helper framework for
Daniel Vetter0d4ed4c2012-11-01 14:45:16 +0100857 * implementing the DPMS connector attribute. It computes the new desired DPMS
Daniel Vetter2be94972015-12-04 09:45:46 +0100858 * state for all encoders and CRTCs in the output mesh and calls the ->dpms()
859 * callbacks provided by the driver in struct &drm_crtc_helper_funcs and struct
860 * &drm_encoder_helper_funcs appropriately.
861 *
862 * This function is deprecated. New drivers must implement atomic modeset
863 * support, for which this function is unsuitable. Instead drivers should use
864 * drm_atomic_helper_connector_dpms().
Maarten Lankhorst9a69a9a2015-07-21 11:34:55 +0200865 *
866 * Returns:
867 * Always returns 0.
Keith Packardc9fb15f2009-05-30 20:42:28 -0700868 */
Maarten Lankhorst9a69a9a2015-07-21 11:34:55 +0200869int drm_helper_connector_dpms(struct drm_connector *connector, int mode)
Keith Packardc9fb15f2009-05-30 20:42:28 -0700870{
871 struct drm_encoder *encoder = connector->encoder;
872 struct drm_crtc *crtc = encoder ? encoder->crtc : NULL;
Sean Paul3b336ec2013-08-14 16:47:37 -0400873 int old_dpms, encoder_dpms = DRM_MODE_DPMS_OFF;
Keith Packardc9fb15f2009-05-30 20:42:28 -0700874
875 if (mode == connector->dpms)
Maarten Lankhorst9a69a9a2015-07-21 11:34:55 +0200876 return 0;
Keith Packardc9fb15f2009-05-30 20:42:28 -0700877
878 old_dpms = connector->dpms;
879 connector->dpms = mode;
880
Sean Paul3b336ec2013-08-14 16:47:37 -0400881 if (encoder)
882 encoder_dpms = drm_helper_choose_encoder_dpms(encoder);
883
Keith Packardc9fb15f2009-05-30 20:42:28 -0700884 /* from off to on, do crtc then encoder */
885 if (mode < old_dpms) {
886 if (crtc) {
Jani Nikulabe26a662015-03-11 11:51:06 +0200887 const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
Keith Packardc9fb15f2009-05-30 20:42:28 -0700888 if (crtc_funcs->dpms)
889 (*crtc_funcs->dpms) (crtc,
890 drm_helper_choose_crtc_dpms(crtc));
891 }
Sean Paul3b336ec2013-08-14 16:47:37 -0400892 if (encoder)
893 drm_helper_encoder_dpms(encoder, encoder_dpms);
Keith Packardc9fb15f2009-05-30 20:42:28 -0700894 }
895
896 /* from on to off, do encoder then crtc */
897 if (mode > old_dpms) {
Sean Paul3b336ec2013-08-14 16:47:37 -0400898 if (encoder)
899 drm_helper_encoder_dpms(encoder, encoder_dpms);
Keith Packardc9fb15f2009-05-30 20:42:28 -0700900 if (crtc) {
Jani Nikulabe26a662015-03-11 11:51:06 +0200901 const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
Keith Packardc9fb15f2009-05-30 20:42:28 -0700902 if (crtc_funcs->dpms)
903 (*crtc_funcs->dpms) (crtc,
904 drm_helper_choose_crtc_dpms(crtc));
905 }
906 }
907
Maarten Lankhorst9a69a9a2015-07-21 11:34:55 +0200908 return 0;
Keith Packardc9fb15f2009-05-30 20:42:28 -0700909}
910EXPORT_SYMBOL(drm_helper_connector_dpms);
911
Daniel Vetter3fcc42e2014-01-23 22:58:26 +0100912/**
913 * drm_helper_mode_fill_fb_struct - fill out framebuffer metadata
914 * @fb: drm_framebuffer object to fill out
915 * @mode_cmd: metadata from the userspace fb creation request
916 *
917 * This helper can be used in a drivers fb_create callback to pre-fill the fb's
918 * metadata fields.
919 */
Daniel Vetter9fd93782014-01-23 22:16:24 +0100920void drm_helper_mode_fill_fb_struct(struct drm_framebuffer *fb,
Ville Syrjälä1eb83452015-11-11 19:11:29 +0200921 const struct drm_mode_fb_cmd2 *mode_cmd)
Dave Airlief453ba02008-11-07 14:05:41 -0800922{
Ville Syrjälä01f2c772011-12-20 00:06:49 +0200923 int i;
924
Dave Airlief453ba02008-11-07 14:05:41 -0800925 fb->width = mode_cmd->width;
926 fb->height = mode_cmd->height;
Ville Syrjälä01f2c772011-12-20 00:06:49 +0200927 for (i = 0; i < 4; i++) {
928 fb->pitches[i] = mode_cmd->pitches[i];
929 fb->offsets[i] = mode_cmd->offsets[i];
Rob Clarke3eb3252015-02-05 14:41:52 +0000930 fb->modifier[i] = mode_cmd->modifier[i];
Ville Syrjälä01f2c772011-12-20 00:06:49 +0200931 }
Dave Airlie248dbc22011-11-29 20:02:54 +0000932 drm_fb_get_bpp_depth(mode_cmd->pixel_format, &fb->depth,
Jesse Barnes308e5bc2011-11-14 14:51:28 -0800933 &fb->bits_per_pixel);
934 fb->pixel_format = mode_cmd->pixel_format;
Fabien DESSENNEd980b182014-07-01 14:40:42 +0200935 fb->flags = mode_cmd->flags;
Dave Airlief453ba02008-11-07 14:05:41 -0800936}
937EXPORT_SYMBOL(drm_helper_mode_fill_fb_struct);
938
Daniel Vetteraa4cd912014-01-22 16:42:02 +0100939/**
940 * drm_helper_resume_force_mode - force-restore mode setting configuration
941 * @dev: drm_device which should be restored
942 *
943 * Drivers which use the mode setting helpers can use this function to
944 * force-restore the mode setting configuration e.g. on resume or when something
945 * else might have trampled over the hw state (like some overzealous old BIOSen
946 * tended to do).
Daniel Vetter00d762c2014-01-23 22:28:30 +0100947 *
948 * This helper doesn't provide a error return value since restoring the old
949 * config should never fail due to resource allocation issues since the driver
950 * has successfully set the restored configuration already. Hence this should
951 * boil down to the equivalent of a few dpms on calls, which also don't provide
952 * an error code.
953 *
954 * Drivers where simply restoring an old configuration again might fail (e.g.
955 * due to slight differences in allocating shared resources when the
956 * configuration is restored in a different order than when userspace set it up)
957 * need to use their own restore logic.
Thierry Reding14942762015-12-02 17:50:04 +0100958 *
959 * This function is deprecated. New drivers should implement atomic mode-
960 * setting and use the atomic suspend/resume helpers.
961 *
962 * See also:
963 * drm_atomic_helper_suspend(), drm_atomic_helper_resume()
Daniel Vetteraa4cd912014-01-22 16:42:02 +0100964 */
Daniel Vetter00d762c2014-01-23 22:28:30 +0100965void drm_helper_resume_force_mode(struct drm_device *dev)
Dave Airlief453ba02008-11-07 14:05:41 -0800966{
967 struct drm_crtc *crtc;
David John89347bb2009-12-31 12:00:46 +0530968 struct drm_encoder *encoder;
Jani Nikulabe26a662015-03-11 11:51:06 +0200969 const struct drm_crtc_helper_funcs *crtc_funcs;
Daniel Vetter00d762c2014-01-23 22:28:30 +0100970 int encoder_dpms;
971 bool ret;
Dave Airlief453ba02008-11-07 14:05:41 -0800972
Dave Airlie3ea87852014-03-21 10:45:40 +1000973 drm_modeset_lock_all(dev);
Daniel Vetter6295d602015-07-09 23:44:25 +0200974 drm_for_each_crtc(crtc, dev) {
Dave Airlief453ba02008-11-07 14:05:41 -0800975
976 if (!crtc->enabled)
977 continue;
978
Kristian Høgsberg3c4fdcf2008-12-17 22:14:46 -0500979 ret = drm_crtc_helper_set_mode(crtc, &crtc->mode,
Matt Roperf4510a22014-04-01 15:22:40 -0700980 crtc->x, crtc->y, crtc->primary->fb);
Dave Airlief453ba02008-11-07 14:05:41 -0800981
Daniel Vetter00d762c2014-01-23 22:28:30 +0100982 /* Restoring the old config should never fail! */
Dave Airlief453ba02008-11-07 14:05:41 -0800983 if (ret == false)
984 DRM_ERROR("failed to set mode on crtc %p\n", crtc);
David John89347bb2009-12-31 12:00:46 +0530985
986 /* Turn off outputs that were already powered off */
987 if (drm_helper_choose_crtc_dpms(crtc)) {
Daniel Vetter6295d602015-07-09 23:44:25 +0200988 drm_for_each_encoder(encoder, dev) {
David John89347bb2009-12-31 12:00:46 +0530989
990 if(encoder->crtc != crtc)
991 continue;
992
Sean Paul3b336ec2013-08-14 16:47:37 -0400993 encoder_dpms = drm_helper_choose_encoder_dpms(
994 encoder);
995
996 drm_helper_encoder_dpms(encoder, encoder_dpms);
David John89347bb2009-12-31 12:00:46 +0530997 }
Chris Wilson817e6312010-08-06 15:03:31 +0100998
999 crtc_funcs = crtc->helper_private;
1000 if (crtc_funcs->dpms)
1001 (*crtc_funcs->dpms) (crtc,
1002 drm_helper_choose_crtc_dpms(crtc));
David John89347bb2009-12-31 12:00:46 +05301003 }
Dave Airlief453ba02008-11-07 14:05:41 -08001004 }
Daniel Vetter00d762c2014-01-23 22:28:30 +01001005
Zhao Yakuiaf4fcb52009-07-08 14:13:13 +08001006 /* disable the unused connectors while restoring the modesetting */
Daniel Vetterb182cc52014-03-20 14:26:34 +01001007 __drm_helper_disable_unused_functions(dev);
Dave Airlie3ea87852014-03-21 10:45:40 +10001008 drm_modeset_unlock_all(dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001009}
1010EXPORT_SYMBOL(drm_helper_resume_force_mode);
Daniel Vetter2f324b42014-10-29 11:13:47 +01001011
1012/**
1013 * drm_helper_crtc_mode_set - mode_set implementation for atomic plane helpers
1014 * @crtc: DRM CRTC
1015 * @mode: DRM display mode which userspace requested
1016 * @adjusted_mode: DRM display mode adjusted by ->mode_fixup callbacks
1017 * @x: x offset of the CRTC scanout area on the underlying framebuffer
1018 * @y: y offset of the CRTC scanout area on the underlying framebuffer
1019 * @old_fb: previous framebuffer
1020 *
1021 * This function implements a callback useable as the ->mode_set callback
Daniel Vetter2be94972015-12-04 09:45:46 +01001022 * required by the CRTC helpers. Besides the atomic plane helper functions for
Daniel Vetter2f324b42014-10-29 11:13:47 +01001023 * the primary plane the driver must also provide the ->mode_set_nofb callback
Daniel Vetter2be94972015-12-04 09:45:46 +01001024 * to set up the CRTC.
Daniel Vetter2f324b42014-10-29 11:13:47 +01001025 *
1026 * This is a transitional helper useful for converting drivers to the atomic
1027 * interfaces.
1028 */
1029int drm_helper_crtc_mode_set(struct drm_crtc *crtc, struct drm_display_mode *mode,
1030 struct drm_display_mode *adjusted_mode, int x, int y,
1031 struct drm_framebuffer *old_fb)
1032{
1033 struct drm_crtc_state *crtc_state;
Jani Nikulabe26a662015-03-11 11:51:06 +02001034 const struct drm_crtc_helper_funcs *crtc_funcs = crtc->helper_private;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001035 int ret;
1036
1037 if (crtc->funcs->atomic_duplicate_state)
1038 crtc_state = crtc->funcs->atomic_duplicate_state(crtc);
Daniel Vettere4f31ad2015-07-02 16:33:53 +02001039 else {
1040 if (!crtc->state)
1041 drm_atomic_helper_crtc_reset(crtc);
1042
Daniel Vetterce14ec22015-07-02 15:16:39 +02001043 crtc_state = drm_atomic_helper_crtc_duplicate_state(crtc);
Daniel Vettere4f31ad2015-07-02 16:33:53 +02001044 }
Daniel Vetterce14ec22015-07-02 15:16:39 +02001045
1046 if (!crtc_state)
1047 return -ENOMEM;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001048
Daniel Vetter2f324b42014-10-29 11:13:47 +01001049 crtc_state->planes_changed = true;
Daniel Vetter623369e2014-09-16 17:50:47 +02001050 crtc_state->mode_changed = true;
Daniel Stone819364d2015-05-26 14:36:48 +01001051 ret = drm_atomic_set_mode_for_crtc(crtc_state, mode);
1052 if (ret)
1053 goto out;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001054 drm_mode_copy(&crtc_state->adjusted_mode, adjusted_mode);
1055
1056 if (crtc_funcs->atomic_check) {
1057 ret = crtc_funcs->atomic_check(crtc, crtc_state);
Daniel Stone9f658b72015-05-22 13:34:45 +01001058 if (ret)
1059 goto out;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001060 }
1061
1062 swap(crtc->state, crtc_state);
1063
1064 crtc_funcs->mode_set_nofb(crtc);
1065
Daniel Stone9f658b72015-05-22 13:34:45 +01001066 ret = drm_helper_crtc_mode_set_base(crtc, x, y, old_fb);
1067
1068out:
Daniel Vetterce14ec22015-07-02 15:16:39 +02001069 if (crtc_state) {
1070 if (crtc->funcs->atomic_destroy_state)
1071 crtc->funcs->atomic_destroy_state(crtc, crtc_state);
1072 else
1073 drm_atomic_helper_crtc_destroy_state(crtc, crtc_state);
Daniel Vetter2f324b42014-10-29 11:13:47 +01001074 }
1075
Daniel Stone9f658b72015-05-22 13:34:45 +01001076 return ret;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001077}
1078EXPORT_SYMBOL(drm_helper_crtc_mode_set);
1079
1080/**
1081 * drm_helper_crtc_mode_set_base - mode_set_base implementation for atomic plane helpers
1082 * @crtc: DRM CRTC
1083 * @x: x offset of the CRTC scanout area on the underlying framebuffer
1084 * @y: y offset of the CRTC scanout area on the underlying framebuffer
1085 * @old_fb: previous framebuffer
1086 *
1087 * This function implements a callback useable as the ->mode_set_base used
Daniel Vetter2be94972015-12-04 09:45:46 +01001088 * required by the CRTC helpers. The driver must provide the atomic plane helper
Daniel Vetter2f324b42014-10-29 11:13:47 +01001089 * functions for the primary plane.
1090 *
1091 * This is a transitional helper useful for converting drivers to the atomic
1092 * interfaces.
1093 */
1094int drm_helper_crtc_mode_set_base(struct drm_crtc *crtc, int x, int y,
1095 struct drm_framebuffer *old_fb)
1096{
1097 struct drm_plane_state *plane_state;
1098 struct drm_plane *plane = crtc->primary;
1099
1100 if (plane->funcs->atomic_duplicate_state)
1101 plane_state = plane->funcs->atomic_duplicate_state(plane);
Liu Ying6c148382016-04-05 16:50:39 +08001102 else {
1103 if (!plane->state)
1104 drm_atomic_helper_plane_reset(plane);
1105
Daniel Vetter321ebf02014-11-04 22:57:27 +01001106 plane_state = drm_atomic_helper_plane_duplicate_state(plane);
Liu Ying6c148382016-04-05 16:50:39 +08001107 }
Daniel Vetter2f324b42014-10-29 11:13:47 +01001108 if (!plane_state)
1109 return -ENOMEM;
Daniel Vetter07cc0ef2014-11-27 15:49:39 +01001110 plane_state->plane = plane;
Daniel Vetter2f324b42014-10-29 11:13:47 +01001111
1112 plane_state->crtc = crtc;
Daniel Vetter321ebf02014-11-04 22:57:27 +01001113 drm_atomic_set_fb_for_plane(plane_state, crtc->primary->fb);
Daniel Vetter2f324b42014-10-29 11:13:47 +01001114 plane_state->crtc_x = 0;
1115 plane_state->crtc_y = 0;
1116 plane_state->crtc_h = crtc->mode.vdisplay;
1117 plane_state->crtc_w = crtc->mode.hdisplay;
1118 plane_state->src_x = x << 16;
1119 plane_state->src_y = y << 16;
1120 plane_state->src_h = crtc->mode.vdisplay << 16;
1121 plane_state->src_w = crtc->mode.hdisplay << 16;
1122
1123 return drm_plane_helper_commit(plane, plane_state, old_fb);
1124}
1125EXPORT_SYMBOL(drm_helper_crtc_mode_set_base);
Lionel Landwerlin5488dc12016-02-26 17:05:00 +00001126
1127/**
1128 * drm_helper_crtc_enable_color_mgmt - enable color management properties
1129 * @crtc: DRM CRTC
1130 * @degamma_lut_size: the size of the degamma lut (before CSC)
1131 * @gamma_lut_size: the size of the gamma lut (after CSC)
1132 *
1133 * This function lets the driver enable the color correction properties on a
1134 * CRTC. This includes 3 degamma, csc and gamma properties that userspace can
1135 * set and 2 size properties to inform the userspace of the lut sizes.
1136 */
1137void drm_helper_crtc_enable_color_mgmt(struct drm_crtc *crtc,
1138 int degamma_lut_size,
1139 int gamma_lut_size)
1140{
1141 struct drm_device *dev = crtc->dev;
1142 struct drm_mode_config *config = &dev->mode_config;
1143
1144 drm_object_attach_property(&crtc->base,
1145 config->degamma_lut_property, 0);
1146 drm_object_attach_property(&crtc->base,
1147 config->ctm_property, 0);
1148 drm_object_attach_property(&crtc->base,
1149 config->gamma_lut_property, 0);
1150
1151 drm_object_attach_property(&crtc->base,
1152 config->degamma_lut_size_property,
1153 degamma_lut_size);
1154 drm_object_attach_property(&crtc->base,
1155 config->gamma_lut_size_property,
1156 gamma_lut_size);
1157}
1158EXPORT_SYMBOL(drm_helper_crtc_enable_color_mgmt);