2 * Copyright (C) 2014 Red Hat
3 * Copyright (C) 2014 Intel Corp.
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21 * OTHER DEALINGS IN THE SOFTWARE.
24 * Rob Clark <robdclark@gmail.com>
25 * Daniel Vetter <daniel.vetter@ffwll.ch>
30 #include <drm/drm_atomic.h>
31 #include <drm/drm_atomic_uapi.h>
32 #include <drm/drm_mode.h>
33 #include <drm/drm_print.h>
34 #include <drm/drm_writeback.h>
35 #include <linux/sync_file.h>
37 #include "drm_crtc_internal.h"
38 #include "drm_internal.h"
40 void __drm_crtc_commit_free(struct kref *kref)
42 struct drm_crtc_commit *commit =
43 container_of(kref, struct drm_crtc_commit, ref);
47 EXPORT_SYMBOL(__drm_crtc_commit_free);
50 * drm_atomic_state_default_release -
51 * release memory initialized by drm_atomic_state_init
52 * @state: atomic state
54 * Free all the memory allocated by drm_atomic_state_init.
55 * This should only be used by drivers which are still subclassing
56 * &drm_atomic_state and haven't switched to &drm_private_state yet.
58 void drm_atomic_state_default_release(struct drm_atomic_state *state)
60 kfree(state->connectors);
63 kfree(state->private_objs);
65 EXPORT_SYMBOL(drm_atomic_state_default_release);
68 * drm_atomic_state_init - init new atomic state
70 * @state: atomic state
72 * Default implementation for filling in a new atomic state.
73 * This should only be used by drivers which are still subclassing
74 * &drm_atomic_state and haven't switched to &drm_private_state yet.
77 drm_atomic_state_init(struct drm_device *dev, struct drm_atomic_state *state)
79 kref_init(&state->ref);
81 /* TODO legacy paths should maybe do a better job about
82 * setting this appropriately?
84 state->allow_modeset = true;
86 state->crtcs = kcalloc(dev->mode_config.num_crtc,
87 sizeof(*state->crtcs), GFP_KERNEL);
90 state->planes = kcalloc(dev->mode_config.num_total_plane,
91 sizeof(*state->planes), GFP_KERNEL);
97 DRM_DEBUG_ATOMIC("Allocated atomic state %p\n", state);
101 drm_atomic_state_default_release(state);
104 EXPORT_SYMBOL(drm_atomic_state_init);
107 * drm_atomic_state_alloc - allocate atomic state
110 * This allocates an empty atomic state to track updates.
112 struct drm_atomic_state *
113 drm_atomic_state_alloc(struct drm_device *dev)
115 struct drm_mode_config *config = &dev->mode_config;
117 if (!config->funcs->atomic_state_alloc) {
118 struct drm_atomic_state *state;
120 state = kzalloc(sizeof(*state), GFP_KERNEL);
123 if (drm_atomic_state_init(dev, state) < 0) {
130 return config->funcs->atomic_state_alloc(dev);
132 EXPORT_SYMBOL(drm_atomic_state_alloc);
135 * drm_atomic_state_default_clear - clear base atomic state
136 * @state: atomic state
138 * Default implementation for clearing atomic state.
139 * This should only be used by drivers which are still subclassing
140 * &drm_atomic_state and haven't switched to &drm_private_state yet.
142 void drm_atomic_state_default_clear(struct drm_atomic_state *state)
144 struct drm_device *dev = state->dev;
145 struct drm_mode_config *config = &dev->mode_config;
148 DRM_DEBUG_ATOMIC("Clearing atomic state %p\n", state);
150 for (i = 0; i < state->num_connector; i++) {
151 struct drm_connector *connector = state->connectors[i].ptr;
156 connector->funcs->atomic_destroy_state(connector,
157 state->connectors[i].state);
158 state->connectors[i].ptr = NULL;
159 state->connectors[i].state = NULL;
160 state->connectors[i].old_state = NULL;
161 state->connectors[i].new_state = NULL;
162 drm_connector_put(connector);
165 for (i = 0; i < config->num_crtc; i++) {
166 struct drm_crtc *crtc = state->crtcs[i].ptr;
171 crtc->funcs->atomic_destroy_state(crtc,
172 state->crtcs[i].state);
174 state->crtcs[i].ptr = NULL;
175 state->crtcs[i].state = NULL;
176 state->crtcs[i].old_state = NULL;
177 state->crtcs[i].new_state = NULL;
179 if (state->crtcs[i].commit) {
180 drm_crtc_commit_put(state->crtcs[i].commit);
181 state->crtcs[i].commit = NULL;
185 for (i = 0; i < config->num_total_plane; i++) {
186 struct drm_plane *plane = state->planes[i].ptr;
191 plane->funcs->atomic_destroy_state(plane,
192 state->planes[i].state);
193 state->planes[i].ptr = NULL;
194 state->planes[i].state = NULL;
195 state->planes[i].old_state = NULL;
196 state->planes[i].new_state = NULL;
199 for (i = 0; i < state->num_private_objs; i++) {
200 struct drm_private_obj *obj = state->private_objs[i].ptr;
202 obj->funcs->atomic_destroy_state(obj,
203 state->private_objs[i].state);
204 state->private_objs[i].ptr = NULL;
205 state->private_objs[i].state = NULL;
206 state->private_objs[i].old_state = NULL;
207 state->private_objs[i].new_state = NULL;
209 state->num_private_objs = 0;
211 if (state->fake_commit) {
212 drm_crtc_commit_put(state->fake_commit);
213 state->fake_commit = NULL;
216 EXPORT_SYMBOL(drm_atomic_state_default_clear);
219 * drm_atomic_state_clear - clear state object
220 * @state: atomic state
222 * When the w/w mutex algorithm detects a deadlock we need to back off and drop
223 * all locks. So someone else could sneak in and change the current modeset
224 * configuration. Which means that all the state assembled in @state is no
225 * longer an atomic update to the current state, but to some arbitrary earlier
226 * state. Which could break assumptions the driver's
227 * &drm_mode_config_funcs.atomic_check likely relies on.
229 * Hence we must clear all cached state and completely start over, using this
232 void drm_atomic_state_clear(struct drm_atomic_state *state)
234 struct drm_device *dev = state->dev;
235 struct drm_mode_config *config = &dev->mode_config;
237 if (config->funcs->atomic_state_clear)
238 config->funcs->atomic_state_clear(state);
240 drm_atomic_state_default_clear(state);
242 EXPORT_SYMBOL(drm_atomic_state_clear);
245 * __drm_atomic_state_free - free all memory for an atomic state
246 * @ref: This atomic state to deallocate
248 * This frees all memory associated with an atomic state, including all the
249 * per-object state for planes, crtcs and connectors.
251 void __drm_atomic_state_free(struct kref *ref)
253 struct drm_atomic_state *state = container_of(ref, typeof(*state), ref);
254 struct drm_mode_config *config = &state->dev->mode_config;
256 drm_atomic_state_clear(state);
258 DRM_DEBUG_ATOMIC("Freeing atomic state %p\n", state);
260 if (config->funcs->atomic_state_free) {
261 config->funcs->atomic_state_free(state);
263 drm_atomic_state_default_release(state);
267 EXPORT_SYMBOL(__drm_atomic_state_free);
270 * drm_atomic_get_crtc_state - get crtc state
271 * @state: global atomic state object
272 * @crtc: crtc to get state object for
274 * This function returns the crtc state for the given crtc, allocating it if
275 * needed. It will also grab the relevant crtc lock to make sure that the state
280 * Either the allocated state or the error code encoded into the pointer. When
281 * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
282 * entire atomic sequence must be restarted. All other errors are fatal.
284 struct drm_crtc_state *
285 drm_atomic_get_crtc_state(struct drm_atomic_state *state,
286 struct drm_crtc *crtc)
288 int ret, index = drm_crtc_index(crtc);
289 struct drm_crtc_state *crtc_state;
291 WARN_ON(!state->acquire_ctx);
293 crtc_state = drm_atomic_get_existing_crtc_state(state, crtc);
297 ret = drm_modeset_lock(&crtc->mutex, state->acquire_ctx);
301 crtc_state = crtc->funcs->atomic_duplicate_state(crtc);
303 return ERR_PTR(-ENOMEM);
305 state->crtcs[index].state = crtc_state;
306 state->crtcs[index].old_state = crtc->state;
307 state->crtcs[index].new_state = crtc_state;
308 state->crtcs[index].ptr = crtc;
309 crtc_state->state = state;
311 DRM_DEBUG_ATOMIC("Added [CRTC:%d:%s] %p state to %p\n",
312 crtc->base.id, crtc->name, crtc_state, state);
316 EXPORT_SYMBOL(drm_atomic_get_crtc_state);
318 static int drm_atomic_crtc_check(struct drm_crtc *crtc,
319 struct drm_crtc_state *state)
321 /* NOTE: we explicitly don't enforce constraints such as primary
322 * layer covering entire screen, since that is something we want
323 * to allow (on hw that supports it). For hw that does not, it
324 * should be checked in driver's crtc->atomic_check() vfunc.
326 * TODO: Add generic modeset state checks once we support those.
329 if (state->active && !state->enable) {
330 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] active without enabled\n",
331 crtc->base.id, crtc->name);
335 /* The state->enable vs. state->mode_blob checks can be WARN_ON,
336 * as this is a kernel-internal detail that userspace should never
337 * be able to trigger. */
338 if (drm_core_check_feature(crtc->dev, DRIVER_ATOMIC) &&
339 WARN_ON(state->enable && !state->mode_blob)) {
340 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] enabled without mode blob\n",
341 crtc->base.id, crtc->name);
345 if (drm_core_check_feature(crtc->dev, DRIVER_ATOMIC) &&
346 WARN_ON(!state->enable && state->mode_blob)) {
347 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] disabled with mode blob\n",
348 crtc->base.id, crtc->name);
353 * Reject event generation for when a CRTC is off and stays off.
354 * It wouldn't be hard to implement this, but userspace has a track
355 * record of happily burning through 100% cpu (or worse, crash) when the
356 * display pipe is suspended. To avoid all that fun just reject updates
357 * that ask for events since likely that indicates a bug in the
358 * compositor's drawing loop. This is consistent with the vblank IOCTL
359 * and legacy page_flip IOCTL which also reject service on a disabled
362 if (state->event && !state->active && !crtc->state->active) {
363 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] requesting event but off\n",
364 crtc->base.id, crtc->name);
371 static void drm_atomic_crtc_print_state(struct drm_printer *p,
372 const struct drm_crtc_state *state)
374 struct drm_crtc *crtc = state->crtc;
376 drm_printf(p, "crtc[%u]: %s\n", crtc->base.id, crtc->name);
377 drm_printf(p, "\tenable=%d\n", state->enable);
378 drm_printf(p, "\tactive=%d\n", state->active);
379 drm_printf(p, "\tplanes_changed=%d\n", state->planes_changed);
380 drm_printf(p, "\tmode_changed=%d\n", state->mode_changed);
381 drm_printf(p, "\tactive_changed=%d\n", state->active_changed);
382 drm_printf(p, "\tconnectors_changed=%d\n", state->connectors_changed);
383 drm_printf(p, "\tcolor_mgmt_changed=%d\n", state->color_mgmt_changed);
384 drm_printf(p, "\tplane_mask=%x\n", state->plane_mask);
385 drm_printf(p, "\tconnector_mask=%x\n", state->connector_mask);
386 drm_printf(p, "\tencoder_mask=%x\n", state->encoder_mask);
387 drm_printf(p, "\tmode: " DRM_MODE_FMT "\n", DRM_MODE_ARG(&state->mode));
389 if (crtc->funcs->atomic_print_state)
390 crtc->funcs->atomic_print_state(p, state);
393 static int drm_atomic_connector_check(struct drm_connector *connector,
394 struct drm_connector_state *state)
396 struct drm_crtc_state *crtc_state;
397 struct drm_writeback_job *writeback_job = state->writeback_job;
398 const struct drm_display_info *info = &connector->display_info;
400 state->max_bpc = info->bpc ? info->bpc : 8;
401 if (connector->max_bpc_property)
402 state->max_bpc = min(state->max_bpc, state->max_requested_bpc);
404 if ((connector->connector_type != DRM_MODE_CONNECTOR_WRITEBACK) || !writeback_job)
407 if (writeback_job->fb && !state->crtc) {
408 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] framebuffer without CRTC\n",
409 connector->base.id, connector->name);
414 crtc_state = drm_atomic_get_existing_crtc_state(state->state,
417 if (writeback_job->fb && !crtc_state->active) {
418 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] has framebuffer, but [CRTC:%d] is off\n",
419 connector->base.id, connector->name,
420 state->crtc->base.id);
424 if (writeback_job->out_fence && !writeback_job->fb) {
425 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] requesting out-fence without framebuffer\n",
426 connector->base.id, connector->name);
434 * drm_atomic_get_plane_state - get plane state
435 * @state: global atomic state object
436 * @plane: plane to get state object for
438 * This function returns the plane state for the given plane, allocating it if
439 * needed. It will also grab the relevant plane lock to make sure that the state
444 * Either the allocated state or the error code encoded into the pointer. When
445 * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
446 * entire atomic sequence must be restarted. All other errors are fatal.
448 struct drm_plane_state *
449 drm_atomic_get_plane_state(struct drm_atomic_state *state,
450 struct drm_plane *plane)
452 int ret, index = drm_plane_index(plane);
453 struct drm_plane_state *plane_state;
455 WARN_ON(!state->acquire_ctx);
457 /* the legacy pointers should never be set */
459 WARN_ON(plane->old_fb);
460 WARN_ON(plane->crtc);
462 plane_state = drm_atomic_get_existing_plane_state(state, plane);
466 ret = drm_modeset_lock(&plane->mutex, state->acquire_ctx);
470 plane_state = plane->funcs->atomic_duplicate_state(plane);
472 return ERR_PTR(-ENOMEM);
474 state->planes[index].state = plane_state;
475 state->planes[index].ptr = plane;
476 state->planes[index].old_state = plane->state;
477 state->planes[index].new_state = plane_state;
478 plane_state->state = state;
480 DRM_DEBUG_ATOMIC("Added [PLANE:%d:%s] %p state to %p\n",
481 plane->base.id, plane->name, plane_state, state);
483 if (plane_state->crtc) {
484 struct drm_crtc_state *crtc_state;
486 crtc_state = drm_atomic_get_crtc_state(state,
488 if (IS_ERR(crtc_state))
489 return ERR_CAST(crtc_state);
494 EXPORT_SYMBOL(drm_atomic_get_plane_state);
497 plane_switching_crtc(struct drm_atomic_state *state,
498 struct drm_plane *plane,
499 struct drm_plane_state *plane_state)
501 if (!plane->state->crtc || !plane_state->crtc)
504 if (plane->state->crtc == plane_state->crtc)
507 /* This could be refined, but currently there's no helper or driver code
508 * to implement direct switching of active planes nor userspace to take
509 * advantage of more direct plane switching without the intermediate
516 * drm_atomic_plane_check - check plane state
517 * @plane: plane to check
518 * @state: plane state to check
520 * Provides core sanity checks for plane state.
523 * Zero on success, error code on failure
525 static int drm_atomic_plane_check(struct drm_plane *plane,
526 struct drm_plane_state *state)
528 unsigned int fb_width, fb_height;
531 /* either *both* CRTC and FB must be set, or neither */
532 if (state->crtc && !state->fb) {
533 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] CRTC set but no FB\n",
534 plane->base.id, plane->name);
536 } else if (state->fb && !state->crtc) {
537 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] FB set but no CRTC\n",
538 plane->base.id, plane->name);
542 /* if disabled, we don't care about the rest of the state: */
546 /* Check whether this plane is usable on this CRTC */
547 if (!(plane->possible_crtcs & drm_crtc_mask(state->crtc))) {
548 DRM_DEBUG_ATOMIC("Invalid [CRTC:%d:%s] for [PLANE:%d:%s]\n",
549 state->crtc->base.id, state->crtc->name,
550 plane->base.id, plane->name);
554 /* Check whether this plane supports the fb pixel format. */
555 ret = drm_plane_check_pixel_format(plane, state->fb->format->format,
556 state->fb->modifier);
558 struct drm_format_name_buf format_name;
559 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] invalid pixel format %s, modifier 0x%llx\n",
560 plane->base.id, plane->name,
561 drm_get_format_name(state->fb->format->format,
563 state->fb->modifier);
567 /* Give drivers some help against integer overflows */
568 if (state->crtc_w > INT_MAX ||
569 state->crtc_x > INT_MAX - (int32_t) state->crtc_w ||
570 state->crtc_h > INT_MAX ||
571 state->crtc_y > INT_MAX - (int32_t) state->crtc_h) {
572 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] invalid CRTC coordinates %ux%u+%d+%d\n",
573 plane->base.id, plane->name,
574 state->crtc_w, state->crtc_h,
575 state->crtc_x, state->crtc_y);
579 fb_width = state->fb->width << 16;
580 fb_height = state->fb->height << 16;
582 /* Make sure source coordinates are inside the fb. */
583 if (state->src_w > fb_width ||
584 state->src_x > fb_width - state->src_w ||
585 state->src_h > fb_height ||
586 state->src_y > fb_height - state->src_h) {
587 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] invalid source coordinates "
588 "%u.%06ux%u.%06u+%u.%06u+%u.%06u (fb %ux%u)\n",
589 plane->base.id, plane->name,
590 state->src_w >> 16, ((state->src_w & 0xffff) * 15625) >> 10,
591 state->src_h >> 16, ((state->src_h & 0xffff) * 15625) >> 10,
592 state->src_x >> 16, ((state->src_x & 0xffff) * 15625) >> 10,
593 state->src_y >> 16, ((state->src_y & 0xffff) * 15625) >> 10,
594 state->fb->width, state->fb->height);
598 if (plane_switching_crtc(state->state, plane, state)) {
599 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] switching CRTC directly\n",
600 plane->base.id, plane->name);
607 static void drm_atomic_plane_print_state(struct drm_printer *p,
608 const struct drm_plane_state *state)
610 struct drm_plane *plane = state->plane;
611 struct drm_rect src = drm_plane_state_src(state);
612 struct drm_rect dest = drm_plane_state_dest(state);
614 drm_printf(p, "plane[%u]: %s\n", plane->base.id, plane->name);
615 drm_printf(p, "\tcrtc=%s\n", state->crtc ? state->crtc->name : "(null)");
616 drm_printf(p, "\tfb=%u\n", state->fb ? state->fb->base.id : 0);
618 drm_framebuffer_print_info(p, 2, state->fb);
619 drm_printf(p, "\tcrtc-pos=" DRM_RECT_FMT "\n", DRM_RECT_ARG(&dest));
620 drm_printf(p, "\tsrc-pos=" DRM_RECT_FP_FMT "\n", DRM_RECT_FP_ARG(&src));
621 drm_printf(p, "\trotation=%x\n", state->rotation);
622 drm_printf(p, "\tnormalized-zpos=%x\n", state->normalized_zpos);
623 drm_printf(p, "\tcolor-encoding=%s\n",
624 drm_get_color_encoding_name(state->color_encoding));
625 drm_printf(p, "\tcolor-range=%s\n",
626 drm_get_color_range_name(state->color_range));
628 if (plane->funcs->atomic_print_state)
629 plane->funcs->atomic_print_state(p, state);
633 * DOC: handling driver private state
635 * Very often the DRM objects exposed to userspace in the atomic modeset api
636 * (&drm_connector, &drm_crtc and &drm_plane) do not map neatly to the
637 * underlying hardware. Especially for any kind of shared resources (e.g. shared
638 * clocks, scaler units, bandwidth and fifo limits shared among a group of
639 * planes or CRTCs, and so on) it makes sense to model these as independent
640 * objects. Drivers then need to do similar state tracking and commit ordering for
641 * such private (since not exposed to userpace) objects as the atomic core and
642 * helpers already provide for connectors, planes and CRTCs.
644 * To make this easier on drivers the atomic core provides some support to track
645 * driver private state objects using struct &drm_private_obj, with the
646 * associated state struct &drm_private_state.
648 * Similar to userspace-exposed objects, private state structures can be
649 * acquired by calling drm_atomic_get_private_obj_state(). Since this function
650 * does not take care of locking, drivers should wrap it for each type of
651 * private state object they have with the required call to drm_modeset_lock()
652 * for the corresponding &drm_modeset_lock.
654 * All private state structures contained in a &drm_atomic_state update can be
655 * iterated using for_each_oldnew_private_obj_in_state(),
656 * for_each_new_private_obj_in_state() and for_each_old_private_obj_in_state().
657 * Drivers are recommended to wrap these for each type of driver private state
658 * object they have, filtering on &drm_private_obj.funcs using for_each_if(), at
659 * least if they want to iterate over all objects of a given type.
661 * An earlier way to handle driver private state was by subclassing struct
662 * &drm_atomic_state. But since that encourages non-standard ways to implement
663 * the check/commit split atomic requires (by using e.g. "check and rollback or
664 * commit instead" of "duplicate state, check, then either commit or release
665 * duplicated state) it is deprecated in favour of using &drm_private_state.
669 * drm_atomic_private_obj_init - initialize private object
670 * @obj: private object
671 * @state: initial private object state
672 * @funcs: pointer to the struct of function pointers that identify the object
675 * Initialize the private object, which can be embedded into any
676 * driver private object that needs its own atomic state.
679 drm_atomic_private_obj_init(struct drm_private_obj *obj,
680 struct drm_private_state *state,
681 const struct drm_private_state_funcs *funcs)
683 memset(obj, 0, sizeof(*obj));
688 EXPORT_SYMBOL(drm_atomic_private_obj_init);
691 * drm_atomic_private_obj_fini - finalize private object
692 * @obj: private object
694 * Finalize the private object.
697 drm_atomic_private_obj_fini(struct drm_private_obj *obj)
699 obj->funcs->atomic_destroy_state(obj, obj->state);
701 EXPORT_SYMBOL(drm_atomic_private_obj_fini);
704 * drm_atomic_get_private_obj_state - get private object state
705 * @state: global atomic state
706 * @obj: private object to get the state for
708 * This function returns the private object state for the given private object,
709 * allocating the state if needed. It does not grab any locks as the caller is
710 * expected to care of any required locking.
714 * Either the allocated state or the error code encoded into a pointer.
716 struct drm_private_state *
717 drm_atomic_get_private_obj_state(struct drm_atomic_state *state,
718 struct drm_private_obj *obj)
720 int index, num_objs, i;
722 struct __drm_private_objs_state *arr;
723 struct drm_private_state *obj_state;
725 for (i = 0; i < state->num_private_objs; i++)
726 if (obj == state->private_objs[i].ptr)
727 return state->private_objs[i].state;
729 num_objs = state->num_private_objs + 1;
730 size = sizeof(*state->private_objs) * num_objs;
731 arr = krealloc(state->private_objs, size, GFP_KERNEL);
733 return ERR_PTR(-ENOMEM);
735 state->private_objs = arr;
736 index = state->num_private_objs;
737 memset(&state->private_objs[index], 0, sizeof(*state->private_objs));
739 obj_state = obj->funcs->atomic_duplicate_state(obj);
741 return ERR_PTR(-ENOMEM);
743 state->private_objs[index].state = obj_state;
744 state->private_objs[index].old_state = obj->state;
745 state->private_objs[index].new_state = obj_state;
746 state->private_objs[index].ptr = obj;
747 obj_state->state = state;
749 state->num_private_objs = num_objs;
751 DRM_DEBUG_ATOMIC("Added new private object %p state %p to %p\n",
752 obj, obj_state, state);
756 EXPORT_SYMBOL(drm_atomic_get_private_obj_state);
759 * drm_atomic_get_connector_state - get connector state
760 * @state: global atomic state object
761 * @connector: connector to get state object for
763 * This function returns the connector state for the given connector,
764 * allocating it if needed. It will also grab the relevant connector lock to
765 * make sure that the state is consistent.
769 * Either the allocated state or the error code encoded into the pointer. When
770 * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
771 * entire atomic sequence must be restarted. All other errors are fatal.
773 struct drm_connector_state *
774 drm_atomic_get_connector_state(struct drm_atomic_state *state,
775 struct drm_connector *connector)
778 struct drm_mode_config *config = &connector->dev->mode_config;
779 struct drm_connector_state *connector_state;
781 WARN_ON(!state->acquire_ctx);
783 ret = drm_modeset_lock(&config->connection_mutex, state->acquire_ctx);
787 index = drm_connector_index(connector);
789 if (index >= state->num_connector) {
790 struct __drm_connnectors_state *c;
791 int alloc = max(index + 1, config->num_connector);
793 c = krealloc(state->connectors, alloc * sizeof(*state->connectors), GFP_KERNEL);
795 return ERR_PTR(-ENOMEM);
797 state->connectors = c;
798 memset(&state->connectors[state->num_connector], 0,
799 sizeof(*state->connectors) * (alloc - state->num_connector));
801 state->num_connector = alloc;
804 if (state->connectors[index].state)
805 return state->connectors[index].state;
807 connector_state = connector->funcs->atomic_duplicate_state(connector);
808 if (!connector_state)
809 return ERR_PTR(-ENOMEM);
811 drm_connector_get(connector);
812 state->connectors[index].state = connector_state;
813 state->connectors[index].old_state = connector->state;
814 state->connectors[index].new_state = connector_state;
815 state->connectors[index].ptr = connector;
816 connector_state->state = state;
818 DRM_DEBUG_ATOMIC("Added [CONNECTOR:%d:%s] %p state to %p\n",
819 connector->base.id, connector->name,
820 connector_state, state);
822 if (connector_state->crtc) {
823 struct drm_crtc_state *crtc_state;
825 crtc_state = drm_atomic_get_crtc_state(state,
826 connector_state->crtc);
827 if (IS_ERR(crtc_state))
828 return ERR_CAST(crtc_state);
831 return connector_state;
833 EXPORT_SYMBOL(drm_atomic_get_connector_state);
835 static void drm_atomic_connector_print_state(struct drm_printer *p,
836 const struct drm_connector_state *state)
838 struct drm_connector *connector = state->connector;
840 drm_printf(p, "connector[%u]: %s\n", connector->base.id, connector->name);
841 drm_printf(p, "\tcrtc=%s\n", state->crtc ? state->crtc->name : "(null)");
843 if (connector->connector_type == DRM_MODE_CONNECTOR_WRITEBACK)
844 if (state->writeback_job && state->writeback_job->fb)
845 drm_printf(p, "\tfb=%d\n", state->writeback_job->fb->base.id);
847 if (connector->funcs->atomic_print_state)
848 connector->funcs->atomic_print_state(p, state);
852 * drm_atomic_add_affected_connectors - add connectors for crtc
853 * @state: atomic state
856 * This function walks the current configuration and adds all connectors
857 * currently using @crtc to the atomic configuration @state. Note that this
858 * function must acquire the connection mutex. This can potentially cause
859 * unneeded seralization if the update is just for the planes on one crtc. Hence
860 * drivers and helpers should only call this when really needed (e.g. when a
861 * full modeset needs to happen due to some change).
864 * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
865 * then the w/w mutex code has detected a deadlock and the entire atomic
866 * sequence must be restarted. All other errors are fatal.
869 drm_atomic_add_affected_connectors(struct drm_atomic_state *state,
870 struct drm_crtc *crtc)
872 struct drm_mode_config *config = &state->dev->mode_config;
873 struct drm_connector *connector;
874 struct drm_connector_state *conn_state;
875 struct drm_connector_list_iter conn_iter;
876 struct drm_crtc_state *crtc_state;
879 crtc_state = drm_atomic_get_crtc_state(state, crtc);
880 if (IS_ERR(crtc_state))
881 return PTR_ERR(crtc_state);
883 ret = drm_modeset_lock(&config->connection_mutex, state->acquire_ctx);
887 DRM_DEBUG_ATOMIC("Adding all current connectors for [CRTC:%d:%s] to %p\n",
888 crtc->base.id, crtc->name, state);
891 * Changed connectors are already in @state, so only need to look
892 * at the connector_mask in crtc_state.
894 drm_connector_list_iter_begin(state->dev, &conn_iter);
895 drm_for_each_connector_iter(connector, &conn_iter) {
896 if (!(crtc_state->connector_mask & drm_connector_mask(connector)))
899 conn_state = drm_atomic_get_connector_state(state, connector);
900 if (IS_ERR(conn_state)) {
901 drm_connector_list_iter_end(&conn_iter);
902 return PTR_ERR(conn_state);
905 drm_connector_list_iter_end(&conn_iter);
909 EXPORT_SYMBOL(drm_atomic_add_affected_connectors);
912 * drm_atomic_add_affected_planes - add planes for crtc
913 * @state: atomic state
916 * This function walks the current configuration and adds all planes
917 * currently used by @crtc to the atomic configuration @state. This is useful
918 * when an atomic commit also needs to check all currently enabled plane on
919 * @crtc, e.g. when changing the mode. It's also useful when re-enabling a CRTC
920 * to avoid special code to force-enable all planes.
922 * Since acquiring a plane state will always also acquire the w/w mutex of the
923 * current CRTC for that plane (if there is any) adding all the plane states for
924 * a CRTC will not reduce parallism of atomic updates.
927 * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
928 * then the w/w mutex code has detected a deadlock and the entire atomic
929 * sequence must be restarted. All other errors are fatal.
932 drm_atomic_add_affected_planes(struct drm_atomic_state *state,
933 struct drm_crtc *crtc)
935 struct drm_plane *plane;
937 WARN_ON(!drm_atomic_get_new_crtc_state(state, crtc));
939 DRM_DEBUG_ATOMIC("Adding all current planes for [CRTC:%d:%s] to %p\n",
940 crtc->base.id, crtc->name, state);
942 drm_for_each_plane_mask(plane, state->dev, crtc->state->plane_mask) {
943 struct drm_plane_state *plane_state =
944 drm_atomic_get_plane_state(state, plane);
946 if (IS_ERR(plane_state))
947 return PTR_ERR(plane_state);
951 EXPORT_SYMBOL(drm_atomic_add_affected_planes);
954 * drm_atomic_check_only - check whether a given config would work
955 * @state: atomic configuration to check
957 * Note that this function can return -EDEADLK if the driver needed to acquire
958 * more locks but encountered a deadlock. The caller must then do the usual w/w
959 * backoff dance and restart. All other errors are fatal.
962 * 0 on success, negative error code on failure.
964 int drm_atomic_check_only(struct drm_atomic_state *state)
966 struct drm_device *dev = state->dev;
967 struct drm_mode_config *config = &dev->mode_config;
968 struct drm_plane *plane;
969 struct drm_plane_state *plane_state;
970 struct drm_crtc *crtc;
971 struct drm_crtc_state *crtc_state;
972 struct drm_connector *conn;
973 struct drm_connector_state *conn_state;
976 DRM_DEBUG_ATOMIC("checking %p\n", state);
978 for_each_new_plane_in_state(state, plane, plane_state, i) {
979 ret = drm_atomic_plane_check(plane, plane_state);
981 DRM_DEBUG_ATOMIC("[PLANE:%d:%s] atomic core check failed\n",
982 plane->base.id, plane->name);
987 for_each_new_crtc_in_state(state, crtc, crtc_state, i) {
988 ret = drm_atomic_crtc_check(crtc, crtc_state);
990 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] atomic core check failed\n",
991 crtc->base.id, crtc->name);
996 for_each_new_connector_in_state(state, conn, conn_state, i) {
997 ret = drm_atomic_connector_check(conn, conn_state);
999 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] atomic core check failed\n",
1000 conn->base.id, conn->name);
1005 if (config->funcs->atomic_check) {
1006 ret = config->funcs->atomic_check(state->dev, state);
1009 DRM_DEBUG_ATOMIC("atomic driver check for %p failed: %d\n",
1015 if (!state->allow_modeset) {
1016 for_each_new_crtc_in_state(state, crtc, crtc_state, i) {
1017 if (drm_atomic_crtc_needs_modeset(crtc_state)) {
1018 DRM_DEBUG_ATOMIC("[CRTC:%d:%s] requires full modeset\n",
1019 crtc->base.id, crtc->name);
1027 EXPORT_SYMBOL(drm_atomic_check_only);
1030 * drm_atomic_commit - commit configuration atomically
1031 * @state: atomic configuration to check
1033 * Note that this function can return -EDEADLK if the driver needed to acquire
1034 * more locks but encountered a deadlock. The caller must then do the usual w/w
1035 * backoff dance and restart. All other errors are fatal.
1037 * This function will take its own reference on @state.
1038 * Callers should always release their reference with drm_atomic_state_put().
1041 * 0 on success, negative error code on failure.
1043 int drm_atomic_commit(struct drm_atomic_state *state)
1045 struct drm_mode_config *config = &state->dev->mode_config;
1048 ret = drm_atomic_check_only(state);
1052 DRM_DEBUG_ATOMIC("committing %p\n", state);
1054 return config->funcs->atomic_commit(state->dev, state, false);
1056 EXPORT_SYMBOL(drm_atomic_commit);
1059 * drm_atomic_nonblocking_commit - atomic nonblocking commit
1060 * @state: atomic configuration to check
1062 * Note that this function can return -EDEADLK if the driver needed to acquire
1063 * more locks but encountered a deadlock. The caller must then do the usual w/w
1064 * backoff dance and restart. All other errors are fatal.
1066 * This function will take its own reference on @state.
1067 * Callers should always release their reference with drm_atomic_state_put().
1070 * 0 on success, negative error code on failure.
1072 int drm_atomic_nonblocking_commit(struct drm_atomic_state *state)
1074 struct drm_mode_config *config = &state->dev->mode_config;
1077 ret = drm_atomic_check_only(state);
1081 DRM_DEBUG_ATOMIC("committing %p nonblocking\n", state);
1083 return config->funcs->atomic_commit(state->dev, state, true);
1085 EXPORT_SYMBOL(drm_atomic_nonblocking_commit);
1087 void drm_atomic_print_state(const struct drm_atomic_state *state)
1089 struct drm_printer p = drm_info_printer(state->dev->dev);
1090 struct drm_plane *plane;
1091 struct drm_plane_state *plane_state;
1092 struct drm_crtc *crtc;
1093 struct drm_crtc_state *crtc_state;
1094 struct drm_connector *connector;
1095 struct drm_connector_state *connector_state;
1098 DRM_DEBUG_ATOMIC("checking %p\n", state);
1100 for_each_new_plane_in_state(state, plane, plane_state, i)
1101 drm_atomic_plane_print_state(&p, plane_state);
1103 for_each_new_crtc_in_state(state, crtc, crtc_state, i)
1104 drm_atomic_crtc_print_state(&p, crtc_state);
1106 for_each_new_connector_in_state(state, connector, connector_state, i)
1107 drm_atomic_connector_print_state(&p, connector_state);
1110 static void __drm_state_dump(struct drm_device *dev, struct drm_printer *p,
1113 struct drm_mode_config *config = &dev->mode_config;
1114 struct drm_plane *plane;
1115 struct drm_crtc *crtc;
1116 struct drm_connector *connector;
1117 struct drm_connector_list_iter conn_iter;
1119 if (!drm_drv_uses_atomic_modeset(dev))
1122 list_for_each_entry(plane, &config->plane_list, head) {
1124 drm_modeset_lock(&plane->mutex, NULL);
1125 drm_atomic_plane_print_state(p, plane->state);
1127 drm_modeset_unlock(&plane->mutex);
1130 list_for_each_entry(crtc, &config->crtc_list, head) {
1132 drm_modeset_lock(&crtc->mutex, NULL);
1133 drm_atomic_crtc_print_state(p, crtc->state);
1135 drm_modeset_unlock(&crtc->mutex);
1138 drm_connector_list_iter_begin(dev, &conn_iter);
1140 drm_modeset_lock(&dev->mode_config.connection_mutex, NULL);
1141 drm_for_each_connector_iter(connector, &conn_iter)
1142 drm_atomic_connector_print_state(p, connector->state);
1144 drm_modeset_unlock(&dev->mode_config.connection_mutex);
1145 drm_connector_list_iter_end(&conn_iter);
1149 * drm_state_dump - dump entire device atomic state
1150 * @dev: the drm device
1151 * @p: where to print the state to
1153 * Just for debugging. Drivers might want an option to dump state
1154 * to dmesg in case of error irq's. (Hint, you probably want to
1157 * The caller must drm_modeset_lock_all(), or if this is called
1158 * from error irq handler, it should not be enabled by default.
1159 * (Ie. if you are debugging errors you might not care that this
1160 * is racey. But calling this without all modeset locks held is
1161 * not inherently safe.)
1163 void drm_state_dump(struct drm_device *dev, struct drm_printer *p)
1165 __drm_state_dump(dev, p, false);
1167 EXPORT_SYMBOL(drm_state_dump);
1169 #ifdef CONFIG_DEBUG_FS
1170 static int drm_state_info(struct seq_file *m, void *data)
1172 struct drm_info_node *node = (struct drm_info_node *) m->private;
1173 struct drm_device *dev = node->minor->dev;
1174 struct drm_printer p = drm_seq_file_printer(m);
1176 __drm_state_dump(dev, &p, true);
1181 /* any use in debugfs files to dump individual planes/crtc/etc? */
1182 static const struct drm_info_list drm_atomic_debugfs_list[] = {
1183 {"state", drm_state_info, 0},
1186 int drm_atomic_debugfs_init(struct drm_minor *minor)
1188 return drm_debugfs_create_files(drm_atomic_debugfs_list,
1189 ARRAY_SIZE(drm_atomic_debugfs_list),
1190 minor->debugfs_root, minor);