1 /* 2 * Copyright (C) 2014 Red Hat 3 * Copyright (C) 2014 Intel Corp. 4 * 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: 11 * 12 * The above copyright notice and this permission notice shall be included in 13 * all copies or substantial portions of the Software. 14 * 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. 22 * 23 * Authors: 24 * Rob Clark <robdclark@gmail.com> 25 * Daniel Vetter <daniel.vetter@ffwll.ch> 26 */ 27 28 #include <drm/drmP.h> 29 #include <drm/drm_atomic.h> 30 #include <drm/drm_plane_helper.h> 31 #include <drm/drm_crtc_helper.h> 32 #include <drm/drm_atomic_helper.h> 33 #include <linux/fence.h> 34 35 /** 36 * DOC: overview 37 * 38 * This helper library provides implementations of check and commit functions on 39 * top of the CRTC modeset helper callbacks and the plane helper callbacks. It 40 * also provides convenience implementations for the atomic state handling 41 * callbacks for drivers which don't need to subclass the drm core structures to 42 * add their own additional internal state. 43 * 44 * This library also provides default implementations for the check callback in 45 * drm_atomic_helper_check() and for the commit callback with 46 * drm_atomic_helper_commit(). But the individual stages and callbacks are 47 * exposed to allow drivers to mix and match and e.g. use the plane helpers only 48 * together with a driver private modeset implementation. 49 * 50 * This library also provides implementations for all the legacy driver 51 * interfaces on top of the atomic interface. See drm_atomic_helper_set_config(), 52 * drm_atomic_helper_disable_plane(), drm_atomic_helper_disable_plane() and the 53 * various functions to implement set_property callbacks. New drivers must not 54 * implement these functions themselves but must use the provided helpers. 55 */ 56 static void 57 drm_atomic_helper_plane_changed(struct drm_atomic_state *state, 58 struct drm_plane_state *plane_state, 59 struct drm_plane *plane) 60 { 61 struct drm_crtc_state *crtc_state; 62 63 if (plane->state->crtc) { 64 crtc_state = state->crtc_states[drm_crtc_index(plane->state->crtc)]; 65 66 if (WARN_ON(!crtc_state)) 67 return; 68 69 crtc_state->planes_changed = true; 70 } 71 72 if (plane_state->crtc) { 73 crtc_state = 74 state->crtc_states[drm_crtc_index(plane_state->crtc)]; 75 76 if (WARN_ON(!crtc_state)) 77 return; 78 79 crtc_state->planes_changed = true; 80 } 81 } 82 83 static struct drm_crtc * 84 get_current_crtc_for_encoder(struct drm_device *dev, 85 struct drm_encoder *encoder) 86 { 87 struct drm_mode_config *config = &dev->mode_config; 88 struct drm_connector *connector; 89 90 WARN_ON(!drm_modeset_is_locked(&config->connection_mutex)); 91 92 drm_for_each_connector(connector, dev) { 93 if (connector->state->best_encoder != encoder) 94 continue; 95 96 return connector->state->crtc; 97 } 98 99 return NULL; 100 } 101 102 static int 103 steal_encoder(struct drm_atomic_state *state, 104 struct drm_encoder *encoder, 105 struct drm_crtc *encoder_crtc) 106 { 107 struct drm_mode_config *config = &state->dev->mode_config; 108 struct drm_crtc_state *crtc_state; 109 struct drm_connector *connector; 110 struct drm_connector_state *connector_state; 111 int ret; 112 113 /* 114 * We can only steal an encoder coming from a connector, which means we 115 * must already hold the connection_mutex. 116 */ 117 WARN_ON(!drm_modeset_is_locked(&config->connection_mutex)); 118 119 DRM_DEBUG_ATOMIC("[ENCODER:%d:%s] in use on [CRTC:%d], stealing it\n", 120 encoder->base.id, encoder->name, 121 encoder_crtc->base.id); 122 123 crtc_state = drm_atomic_get_crtc_state(state, encoder_crtc); 124 if (IS_ERR(crtc_state)) 125 return PTR_ERR(crtc_state); 126 127 crtc_state->connectors_changed = true; 128 129 list_for_each_entry(connector, &config->connector_list, head) { 130 if (connector->state->best_encoder != encoder) 131 continue; 132 133 DRM_DEBUG_ATOMIC("Stealing encoder from [CONNECTOR:%d:%s]\n", 134 connector->base.id, 135 connector->name); 136 137 connector_state = drm_atomic_get_connector_state(state, 138 connector); 139 if (IS_ERR(connector_state)) 140 return PTR_ERR(connector_state); 141 142 ret = drm_atomic_set_crtc_for_connector(connector_state, NULL); 143 if (ret) 144 return ret; 145 connector_state->best_encoder = NULL; 146 } 147 148 return 0; 149 } 150 151 static int 152 update_connector_routing(struct drm_atomic_state *state, int conn_idx) 153 { 154 const struct drm_connector_helper_funcs *funcs; 155 struct drm_encoder *new_encoder; 156 struct drm_crtc *encoder_crtc; 157 struct drm_connector *connector; 158 struct drm_connector_state *connector_state; 159 struct drm_crtc_state *crtc_state; 160 int idx, ret; 161 162 connector = state->connectors[conn_idx]; 163 connector_state = state->connector_states[conn_idx]; 164 165 if (!connector) 166 return 0; 167 168 DRM_DEBUG_ATOMIC("Updating routing for [CONNECTOR:%d:%s]\n", 169 connector->base.id, 170 connector->name); 171 172 if (connector->state->crtc != connector_state->crtc) { 173 if (connector->state->crtc) { 174 idx = drm_crtc_index(connector->state->crtc); 175 176 crtc_state = state->crtc_states[idx]; 177 crtc_state->connectors_changed = true; 178 } 179 180 if (connector_state->crtc) { 181 idx = drm_crtc_index(connector_state->crtc); 182 183 crtc_state = state->crtc_states[idx]; 184 crtc_state->connectors_changed = true; 185 } 186 } 187 188 if (!connector_state->crtc) { 189 DRM_DEBUG_ATOMIC("Disabling [CONNECTOR:%d:%s]\n", 190 connector->base.id, 191 connector->name); 192 193 connector_state->best_encoder = NULL; 194 195 return 0; 196 } 197 198 funcs = connector->helper_private; 199 200 if (funcs->atomic_best_encoder) 201 new_encoder = funcs->atomic_best_encoder(connector, 202 connector_state); 203 else 204 new_encoder = funcs->best_encoder(connector); 205 206 if (!new_encoder) { 207 DRM_DEBUG_ATOMIC("No suitable encoder found for [CONNECTOR:%d:%s]\n", 208 connector->base.id, 209 connector->name); 210 return -EINVAL; 211 } 212 213 if (!drm_encoder_crtc_ok(new_encoder, connector_state->crtc)) { 214 DRM_DEBUG_ATOMIC("[ENCODER:%d:%s] incompatible with [CRTC:%d]\n", 215 new_encoder->base.id, 216 new_encoder->name, 217 connector_state->crtc->base.id); 218 return -EINVAL; 219 } 220 221 if (new_encoder == connector_state->best_encoder) { 222 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] keeps [ENCODER:%d:%s], now on [CRTC:%d]\n", 223 connector->base.id, 224 connector->name, 225 new_encoder->base.id, 226 new_encoder->name, 227 connector_state->crtc->base.id); 228 229 return 0; 230 } 231 232 encoder_crtc = get_current_crtc_for_encoder(state->dev, 233 new_encoder); 234 235 if (encoder_crtc) { 236 ret = steal_encoder(state, new_encoder, encoder_crtc); 237 if (ret) { 238 DRM_DEBUG_ATOMIC("Encoder stealing failed for [CONNECTOR:%d:%s]\n", 239 connector->base.id, 240 connector->name); 241 return ret; 242 } 243 } 244 245 if (WARN_ON(!connector_state->crtc)) 246 return -EINVAL; 247 248 connector_state->best_encoder = new_encoder; 249 idx = drm_crtc_index(connector_state->crtc); 250 251 crtc_state = state->crtc_states[idx]; 252 crtc_state->connectors_changed = true; 253 254 DRM_DEBUG_ATOMIC("[CONNECTOR:%d:%s] using [ENCODER:%d:%s] on [CRTC:%d]\n", 255 connector->base.id, 256 connector->name, 257 new_encoder->base.id, 258 new_encoder->name, 259 connector_state->crtc->base.id); 260 261 return 0; 262 } 263 264 static int 265 mode_fixup(struct drm_atomic_state *state) 266 { 267 struct drm_crtc *crtc; 268 struct drm_crtc_state *crtc_state; 269 struct drm_connector *connector; 270 struct drm_connector_state *conn_state; 271 int i; 272 bool ret; 273 274 for_each_crtc_in_state(state, crtc, crtc_state, i) { 275 if (!crtc_state->mode_changed && 276 !crtc_state->connectors_changed) 277 continue; 278 279 drm_mode_copy(&crtc_state->adjusted_mode, &crtc_state->mode); 280 } 281 282 for_each_connector_in_state(state, connector, conn_state, i) { 283 const struct drm_encoder_helper_funcs *funcs; 284 struct drm_encoder *encoder; 285 286 WARN_ON(!!conn_state->best_encoder != !!conn_state->crtc); 287 288 if (!conn_state->crtc || !conn_state->best_encoder) 289 continue; 290 291 crtc_state = 292 state->crtc_states[drm_crtc_index(conn_state->crtc)]; 293 294 /* 295 * Each encoder has at most one connector (since we always steal 296 * it away), so we won't call ->mode_fixup twice. 297 */ 298 encoder = conn_state->best_encoder; 299 funcs = encoder->helper_private; 300 if (!funcs) 301 continue; 302 303 ret = drm_bridge_mode_fixup(encoder->bridge, &crtc_state->mode, 304 &crtc_state->adjusted_mode); 305 if (!ret) { 306 DRM_DEBUG_ATOMIC("Bridge fixup failed\n"); 307 return -EINVAL; 308 } 309 310 if (funcs->atomic_check) { 311 ret = funcs->atomic_check(encoder, crtc_state, 312 conn_state); 313 if (ret) { 314 DRM_DEBUG_ATOMIC("[ENCODER:%d:%s] check failed\n", 315 encoder->base.id, encoder->name); 316 return ret; 317 } 318 } else if (funcs->mode_fixup) { 319 ret = funcs->mode_fixup(encoder, &crtc_state->mode, 320 &crtc_state->adjusted_mode); 321 if (!ret) { 322 DRM_DEBUG_ATOMIC("[ENCODER:%d:%s] fixup failed\n", 323 encoder->base.id, encoder->name); 324 return -EINVAL; 325 } 326 } 327 } 328 329 for_each_crtc_in_state(state, crtc, crtc_state, i) { 330 const struct drm_crtc_helper_funcs *funcs; 331 332 if (!crtc_state->mode_changed && 333 !crtc_state->connectors_changed) 334 continue; 335 336 funcs = crtc->helper_private; 337 if (!funcs->mode_fixup) 338 continue; 339 340 ret = funcs->mode_fixup(crtc, &crtc_state->mode, 341 &crtc_state->adjusted_mode); 342 if (!ret) { 343 DRM_DEBUG_ATOMIC("[CRTC:%d] fixup failed\n", 344 crtc->base.id); 345 return -EINVAL; 346 } 347 } 348 349 return 0; 350 } 351 352 /** 353 * drm_atomic_helper_check_modeset - validate state object for modeset changes 354 * @dev: DRM device 355 * @state: the driver state object 356 * 357 * Check the state object to see if the requested state is physically possible. 358 * This does all the crtc and connector related computations for an atomic 359 * update and adds any additional connectors needed for full modesets and calls 360 * down into ->mode_fixup functions of the driver backend. 361 * 362 * crtc_state->mode_changed is set when the input mode is changed. 363 * crtc_state->connectors_changed is set when a connector is added or 364 * removed from the crtc. 365 * crtc_state->active_changed is set when crtc_state->active changes, 366 * which is used for dpms. 367 * 368 * IMPORTANT: 369 * 370 * Drivers which update ->mode_changed (e.g. in their ->atomic_check hooks if a 371 * plane update can't be done without a full modeset) _must_ call this function 372 * afterwards after that change. It is permitted to call this function multiple 373 * times for the same update, e.g. when the ->atomic_check functions depend upon 374 * the adjusted dotclock for fifo space allocation and watermark computation. 375 * 376 * RETURNS 377 * Zero for success or -errno 378 */ 379 int 380 drm_atomic_helper_check_modeset(struct drm_device *dev, 381 struct drm_atomic_state *state) 382 { 383 struct drm_crtc *crtc; 384 struct drm_crtc_state *crtc_state; 385 struct drm_connector *connector; 386 struct drm_connector_state *connector_state; 387 int i, ret; 388 389 for_each_crtc_in_state(state, crtc, crtc_state, i) { 390 if (!drm_mode_equal(&crtc->state->mode, &crtc_state->mode)) { 391 DRM_DEBUG_ATOMIC("[CRTC:%d] mode changed\n", 392 crtc->base.id); 393 crtc_state->mode_changed = true; 394 } 395 396 if (crtc->state->enable != crtc_state->enable) { 397 DRM_DEBUG_ATOMIC("[CRTC:%d] enable changed\n", 398 crtc->base.id); 399 400 /* 401 * For clarity this assignment is done here, but 402 * enable == 0 is only true when there are no 403 * connectors and a NULL mode. 404 * 405 * The other way around is true as well. enable != 0 406 * iff connectors are attached and a mode is set. 407 */ 408 crtc_state->mode_changed = true; 409 crtc_state->connectors_changed = true; 410 } 411 } 412 413 for_each_connector_in_state(state, connector, connector_state, i) { 414 /* 415 * This only sets crtc->mode_changed for routing changes, 416 * drivers must set crtc->mode_changed themselves when connector 417 * properties need to be updated. 418 */ 419 ret = update_connector_routing(state, i); 420 if (ret) 421 return ret; 422 } 423 424 /* 425 * After all the routing has been prepared we need to add in any 426 * connector which is itself unchanged, but who's crtc changes it's 427 * configuration. This must be done before calling mode_fixup in case a 428 * crtc only changed its mode but has the same set of connectors. 429 */ 430 for_each_crtc_in_state(state, crtc, crtc_state, i) { 431 int num_connectors; 432 433 /* 434 * We must set ->active_changed after walking connectors for 435 * otherwise an update that only changes active would result in 436 * a full modeset because update_connector_routing force that. 437 */ 438 if (crtc->state->active != crtc_state->active) { 439 DRM_DEBUG_ATOMIC("[CRTC:%d] active changed\n", 440 crtc->base.id); 441 crtc_state->active_changed = true; 442 } 443 444 if (!drm_atomic_crtc_needs_modeset(crtc_state)) 445 continue; 446 447 DRM_DEBUG_ATOMIC("[CRTC:%d] needs all connectors, enable: %c, active: %c\n", 448 crtc->base.id, 449 crtc_state->enable ? 'y' : 'n', 450 crtc_state->active ? 'y' : 'n'); 451 452 ret = drm_atomic_add_affected_connectors(state, crtc); 453 if (ret != 0) 454 return ret; 455 456 ret = drm_atomic_add_affected_planes(state, crtc); 457 if (ret != 0) 458 return ret; 459 460 num_connectors = drm_atomic_connectors_for_crtc(state, 461 crtc); 462 463 if (crtc_state->enable != !!num_connectors) { 464 DRM_DEBUG_ATOMIC("[CRTC:%d] enabled/connectors mismatch\n", 465 crtc->base.id); 466 467 return -EINVAL; 468 } 469 } 470 471 return mode_fixup(state); 472 } 473 EXPORT_SYMBOL(drm_atomic_helper_check_modeset); 474 475 /** 476 * drm_atomic_helper_check_planes - validate state object for planes changes 477 * @dev: DRM device 478 * @state: the driver state object 479 * 480 * Check the state object to see if the requested state is physically possible. 481 * This does all the plane update related checks using by calling into the 482 * ->atomic_check hooks provided by the driver. 483 * 484 * It also sets crtc_state->planes_changed to indicate that a crtc has 485 * updated planes. 486 * 487 * RETURNS 488 * Zero for success or -errno 489 */ 490 int 491 drm_atomic_helper_check_planes(struct drm_device *dev, 492 struct drm_atomic_state *state) 493 { 494 struct drm_crtc *crtc; 495 struct drm_crtc_state *crtc_state; 496 struct drm_plane *plane; 497 struct drm_plane_state *plane_state; 498 int i, ret = 0; 499 500 for_each_plane_in_state(state, plane, plane_state, i) { 501 const struct drm_plane_helper_funcs *funcs; 502 503 funcs = plane->helper_private; 504 505 drm_atomic_helper_plane_changed(state, plane_state, plane); 506 507 if (!funcs || !funcs->atomic_check) 508 continue; 509 510 ret = funcs->atomic_check(plane, plane_state); 511 if (ret) { 512 DRM_DEBUG_ATOMIC("[PLANE:%d] atomic driver check failed\n", 513 plane->base.id); 514 return ret; 515 } 516 } 517 518 for_each_crtc_in_state(state, crtc, crtc_state, i) { 519 const struct drm_crtc_helper_funcs *funcs; 520 521 funcs = crtc->helper_private; 522 523 if (!funcs || !funcs->atomic_check) 524 continue; 525 526 ret = funcs->atomic_check(crtc, state->crtc_states[i]); 527 if (ret) { 528 DRM_DEBUG_ATOMIC("[CRTC:%d] atomic driver check failed\n", 529 crtc->base.id); 530 return ret; 531 } 532 } 533 534 return ret; 535 } 536 EXPORT_SYMBOL(drm_atomic_helper_check_planes); 537 538 /** 539 * drm_atomic_helper_check - validate state object 540 * @dev: DRM device 541 * @state: the driver state object 542 * 543 * Check the state object to see if the requested state is physically possible. 544 * Only crtcs and planes have check callbacks, so for any additional (global) 545 * checking that a driver needs it can simply wrap that around this function. 546 * Drivers without such needs can directly use this as their ->atomic_check() 547 * callback. 548 * 549 * This just wraps the two parts of the state checking for planes and modeset 550 * state in the default order: First it calls drm_atomic_helper_check_modeset() 551 * and then drm_atomic_helper_check_planes(). The assumption is that the 552 * ->atomic_check functions depend upon an updated adjusted_mode.clock to 553 * e.g. properly compute watermarks. 554 * 555 * RETURNS 556 * Zero for success or -errno 557 */ 558 int drm_atomic_helper_check(struct drm_device *dev, 559 struct drm_atomic_state *state) 560 { 561 int ret; 562 563 ret = drm_atomic_helper_check_modeset(dev, state); 564 if (ret) 565 return ret; 566 567 ret = drm_atomic_helper_check_planes(dev, state); 568 if (ret) 569 return ret; 570 571 return ret; 572 } 573 EXPORT_SYMBOL(drm_atomic_helper_check); 574 575 static void 576 disable_outputs(struct drm_device *dev, struct drm_atomic_state *old_state) 577 { 578 struct drm_connector *connector; 579 struct drm_connector_state *old_conn_state; 580 struct drm_crtc *crtc; 581 struct drm_crtc_state *old_crtc_state; 582 int i; 583 584 for_each_connector_in_state(old_state, connector, old_conn_state, i) { 585 const struct drm_encoder_helper_funcs *funcs; 586 struct drm_encoder *encoder; 587 struct drm_crtc_state *old_crtc_state; 588 589 /* Shut down everything that's in the changeset and currently 590 * still on. So need to check the old, saved state. */ 591 if (!old_conn_state->crtc) 592 continue; 593 594 old_crtc_state = old_state->crtc_states[drm_crtc_index(old_conn_state->crtc)]; 595 596 if (!old_crtc_state->active || 597 !drm_atomic_crtc_needs_modeset(old_conn_state->crtc->state)) 598 continue; 599 600 encoder = old_conn_state->best_encoder; 601 602 /* We shouldn't get this far if we didn't previously have 603 * an encoder.. but WARN_ON() rather than explode. 604 */ 605 if (WARN_ON(!encoder)) 606 continue; 607 608 funcs = encoder->helper_private; 609 610 DRM_DEBUG_ATOMIC("disabling [ENCODER:%d:%s]\n", 611 encoder->base.id, encoder->name); 612 613 /* 614 * Each encoder has at most one connector (since we always steal 615 * it away), so we won't call disable hooks twice. 616 */ 617 drm_bridge_disable(encoder->bridge); 618 619 /* Right function depends upon target state. */ 620 if (connector->state->crtc && funcs->prepare) 621 funcs->prepare(encoder); 622 else if (funcs->disable) 623 funcs->disable(encoder); 624 else 625 funcs->dpms(encoder, DRM_MODE_DPMS_OFF); 626 627 drm_bridge_post_disable(encoder->bridge); 628 } 629 630 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 631 const struct drm_crtc_helper_funcs *funcs; 632 633 /* Shut down everything that needs a full modeset. */ 634 if (!drm_atomic_crtc_needs_modeset(crtc->state)) 635 continue; 636 637 if (!old_crtc_state->active) 638 continue; 639 640 funcs = crtc->helper_private; 641 642 DRM_DEBUG_ATOMIC("disabling [CRTC:%d]\n", 643 crtc->base.id); 644 645 646 /* Right function depends upon target state. */ 647 if (crtc->state->enable && funcs->prepare) 648 funcs->prepare(crtc); 649 else if (funcs->disable) 650 funcs->disable(crtc); 651 else 652 funcs->dpms(crtc, DRM_MODE_DPMS_OFF); 653 } 654 } 655 656 /** 657 * drm_atomic_helper_update_legacy_modeset_state - update legacy modeset state 658 * @dev: DRM device 659 * @old_state: atomic state object with old state structures 660 * 661 * This function updates all the various legacy modeset state pointers in 662 * connectors, encoders and crtcs. It also updates the timestamping constants 663 * used for precise vblank timestamps by calling 664 * drm_calc_timestamping_constants(). 665 * 666 * Drivers can use this for building their own atomic commit if they don't have 667 * a pure helper-based modeset implementation. 668 */ 669 void 670 drm_atomic_helper_update_legacy_modeset_state(struct drm_device *dev, 671 struct drm_atomic_state *old_state) 672 { 673 struct drm_connector *connector; 674 struct drm_connector_state *old_conn_state; 675 struct drm_crtc *crtc; 676 struct drm_crtc_state *old_crtc_state; 677 int i; 678 679 /* clear out existing links and update dpms */ 680 for_each_connector_in_state(old_state, connector, old_conn_state, i) { 681 if (connector->encoder) { 682 WARN_ON(!connector->encoder->crtc); 683 684 connector->encoder->crtc = NULL; 685 connector->encoder = NULL; 686 } 687 688 crtc = connector->state->crtc; 689 if ((!crtc && old_conn_state->crtc) || 690 (crtc && drm_atomic_crtc_needs_modeset(crtc->state))) { 691 struct drm_property *dpms_prop = 692 dev->mode_config.dpms_property; 693 int mode = DRM_MODE_DPMS_OFF; 694 695 if (crtc && crtc->state->active) 696 mode = DRM_MODE_DPMS_ON; 697 698 connector->dpms = mode; 699 drm_object_property_set_value(&connector->base, 700 dpms_prop, mode); 701 } 702 } 703 704 /* set new links */ 705 for_each_connector_in_state(old_state, connector, old_conn_state, i) { 706 if (!connector->state->crtc) 707 continue; 708 709 if (WARN_ON(!connector->state->best_encoder)) 710 continue; 711 712 connector->encoder = connector->state->best_encoder; 713 connector->encoder->crtc = connector->state->crtc; 714 } 715 716 /* set legacy state in the crtc structure */ 717 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 718 struct drm_plane *primary = crtc->primary; 719 720 crtc->mode = crtc->state->mode; 721 crtc->enabled = crtc->state->enable; 722 723 if (drm_atomic_get_existing_plane_state(old_state, primary) && 724 primary->state->crtc == crtc) { 725 crtc->x = primary->state->src_x >> 16; 726 crtc->y = primary->state->src_y >> 16; 727 } 728 729 if (crtc->state->enable) 730 drm_calc_timestamping_constants(crtc, 731 &crtc->state->adjusted_mode); 732 } 733 } 734 EXPORT_SYMBOL(drm_atomic_helper_update_legacy_modeset_state); 735 736 static void 737 crtc_set_mode(struct drm_device *dev, struct drm_atomic_state *old_state) 738 { 739 struct drm_crtc *crtc; 740 struct drm_crtc_state *old_crtc_state; 741 struct drm_connector *connector; 742 struct drm_connector_state *old_conn_state; 743 int i; 744 745 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 746 const struct drm_crtc_helper_funcs *funcs; 747 748 if (!crtc->state->mode_changed) 749 continue; 750 751 funcs = crtc->helper_private; 752 753 if (crtc->state->enable && funcs->mode_set_nofb) { 754 DRM_DEBUG_ATOMIC("modeset on [CRTC:%d]\n", 755 crtc->base.id); 756 757 funcs->mode_set_nofb(crtc); 758 } 759 } 760 761 for_each_connector_in_state(old_state, connector, old_conn_state, i) { 762 const struct drm_encoder_helper_funcs *funcs; 763 struct drm_crtc_state *new_crtc_state; 764 struct drm_encoder *encoder; 765 struct drm_display_mode *mode, *adjusted_mode; 766 767 if (!connector->state->best_encoder) 768 continue; 769 770 encoder = connector->state->best_encoder; 771 funcs = encoder->helper_private; 772 new_crtc_state = connector->state->crtc->state; 773 mode = &new_crtc_state->mode; 774 adjusted_mode = &new_crtc_state->adjusted_mode; 775 776 if (!new_crtc_state->mode_changed) 777 continue; 778 779 DRM_DEBUG_ATOMIC("modeset on [ENCODER:%d:%s]\n", 780 encoder->base.id, encoder->name); 781 782 /* 783 * Each encoder has at most one connector (since we always steal 784 * it away), so we won't call mode_set hooks twice. 785 */ 786 if (funcs->mode_set) 787 funcs->mode_set(encoder, mode, adjusted_mode); 788 789 drm_bridge_mode_set(encoder->bridge, mode, adjusted_mode); 790 } 791 } 792 793 /** 794 * drm_atomic_helper_commit_modeset_disables - modeset commit to disable outputs 795 * @dev: DRM device 796 * @old_state: atomic state object with old state structures 797 * 798 * This function shuts down all the outputs that need to be shut down and 799 * prepares them (if required) with the new mode. 800 * 801 * For compatibility with legacy crtc helpers this should be called before 802 * drm_atomic_helper_commit_planes(), which is what the default commit function 803 * does. But drivers with different needs can group the modeset commits together 804 * and do the plane commits at the end. This is useful for drivers doing runtime 805 * PM since planes updates then only happen when the CRTC is actually enabled. 806 */ 807 void drm_atomic_helper_commit_modeset_disables(struct drm_device *dev, 808 struct drm_atomic_state *old_state) 809 { 810 disable_outputs(dev, old_state); 811 812 drm_atomic_helper_update_legacy_modeset_state(dev, old_state); 813 814 crtc_set_mode(dev, old_state); 815 } 816 EXPORT_SYMBOL(drm_atomic_helper_commit_modeset_disables); 817 818 /** 819 * drm_atomic_helper_commit_modeset_enables - modeset commit to enable outputs 820 * @dev: DRM device 821 * @old_state: atomic state object with old state structures 822 * 823 * This function enables all the outputs with the new configuration which had to 824 * be turned off for the update. 825 * 826 * For compatibility with legacy crtc helpers this should be called after 827 * drm_atomic_helper_commit_planes(), which is what the default commit function 828 * does. But drivers with different needs can group the modeset commits together 829 * and do the plane commits at the end. This is useful for drivers doing runtime 830 * PM since planes updates then only happen when the CRTC is actually enabled. 831 */ 832 void drm_atomic_helper_commit_modeset_enables(struct drm_device *dev, 833 struct drm_atomic_state *old_state) 834 { 835 struct drm_crtc *crtc; 836 struct drm_crtc_state *old_crtc_state; 837 struct drm_connector *connector; 838 struct drm_connector_state *old_conn_state; 839 int i; 840 841 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 842 const struct drm_crtc_helper_funcs *funcs; 843 844 /* Need to filter out CRTCs where only planes change. */ 845 if (!drm_atomic_crtc_needs_modeset(crtc->state)) 846 continue; 847 848 if (!crtc->state->active) 849 continue; 850 851 funcs = crtc->helper_private; 852 853 if (crtc->state->enable) { 854 DRM_DEBUG_ATOMIC("enabling [CRTC:%d]\n", 855 crtc->base.id); 856 857 if (funcs->enable) 858 funcs->enable(crtc); 859 else 860 funcs->commit(crtc); 861 } 862 } 863 864 for_each_connector_in_state(old_state, connector, old_conn_state, i) { 865 const struct drm_encoder_helper_funcs *funcs; 866 struct drm_encoder *encoder; 867 868 if (!connector->state->best_encoder) 869 continue; 870 871 if (!connector->state->crtc->state->active || 872 !drm_atomic_crtc_needs_modeset(connector->state->crtc->state)) 873 continue; 874 875 encoder = connector->state->best_encoder; 876 funcs = encoder->helper_private; 877 878 DRM_DEBUG_ATOMIC("enabling [ENCODER:%d:%s]\n", 879 encoder->base.id, encoder->name); 880 881 /* 882 * Each encoder has at most one connector (since we always steal 883 * it away), so we won't call enable hooks twice. 884 */ 885 drm_bridge_pre_enable(encoder->bridge); 886 887 if (funcs->enable) 888 funcs->enable(encoder); 889 else 890 funcs->commit(encoder); 891 892 drm_bridge_enable(encoder->bridge); 893 } 894 } 895 EXPORT_SYMBOL(drm_atomic_helper_commit_modeset_enables); 896 897 static void wait_for_fences(struct drm_device *dev, 898 struct drm_atomic_state *state) 899 { 900 /* XXX: implement linux/fence.h first */ 901 #if 0 902 struct drm_plane *plane; 903 struct drm_plane_state *plane_state; 904 int i; 905 906 for_each_plane_in_state(state, plane, plane_state, i) { 907 if (!plane->state->fence) 908 continue; 909 910 WARN_ON(!plane->state->fb); 911 912 fence_wait(plane->state->fence, false); 913 fence_put(plane->state->fence); 914 plane->state->fence = NULL; 915 } 916 #endif 917 } 918 919 static bool framebuffer_changed(struct drm_device *dev, 920 struct drm_atomic_state *old_state, 921 struct drm_crtc *crtc) 922 { 923 struct drm_plane *plane; 924 struct drm_plane_state *old_plane_state; 925 int i; 926 927 for_each_plane_in_state(old_state, plane, old_plane_state, i) { 928 if (plane->state->crtc != crtc && 929 old_plane_state->crtc != crtc) 930 continue; 931 932 if (plane->state->fb != old_plane_state->fb) 933 return true; 934 } 935 936 return false; 937 } 938 939 /** 940 * drm_atomic_helper_wait_for_vblanks - wait for vblank on crtcs 941 * @dev: DRM device 942 * @old_state: atomic state object with old state structures 943 * 944 * Helper to, after atomic commit, wait for vblanks on all effected 945 * crtcs (ie. before cleaning up old framebuffers using 946 * drm_atomic_helper_cleanup_planes()). It will only wait on crtcs where the 947 * framebuffers have actually changed to optimize for the legacy cursor and 948 * plane update use-case. 949 */ 950 void 951 drm_atomic_helper_wait_for_vblanks(struct drm_device *dev, 952 struct drm_atomic_state *old_state) 953 { 954 struct drm_crtc *crtc; 955 struct drm_crtc_state *old_crtc_state; 956 int i, ret; 957 958 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 959 /* No one cares about the old state, so abuse it for tracking 960 * and store whether we hold a vblank reference (and should do a 961 * vblank wait) in the ->enable boolean. */ 962 old_crtc_state->enable = false; 963 964 if (!crtc->state->enable) 965 continue; 966 967 /* Legacy cursor ioctls are completely unsynced, and userspace 968 * relies on that (by doing tons of cursor updates). */ 969 if (old_state->legacy_cursor_update) 970 continue; 971 972 if (!framebuffer_changed(dev, old_state, crtc)) 973 continue; 974 975 ret = drm_crtc_vblank_get(crtc); 976 if (ret != 0) 977 continue; 978 979 old_crtc_state->enable = true; 980 old_crtc_state->last_vblank_count = drm_crtc_vblank_count(crtc); 981 } 982 983 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 984 if (!old_crtc_state->enable) 985 continue; 986 987 ret = wait_event_timeout(dev->vblank[i].queue, 988 old_crtc_state->last_vblank_count != 989 drm_crtc_vblank_count(crtc), 990 msecs_to_jiffies(50)); 991 992 drm_crtc_vblank_put(crtc); 993 } 994 } 995 EXPORT_SYMBOL(drm_atomic_helper_wait_for_vblanks); 996 997 /** 998 * drm_atomic_helper_commit - commit validated state object 999 * @dev: DRM device 1000 * @state: the driver state object 1001 * @async: asynchronous commit 1002 * 1003 * This function commits a with drm_atomic_helper_check() pre-validated state 1004 * object. This can still fail when e.g. the framebuffer reservation fails. For 1005 * now this doesn't implement asynchronous commits. 1006 * 1007 * Note that right now this function does not support async commits, and hence 1008 * driver writers must implement their own version for now. Also note that the 1009 * default ordering of how the various stages are called is to match the legacy 1010 * modeset helper library closest. One peculiarity of that is that it doesn't 1011 * mesh well with runtime PM at all. 1012 * 1013 * For drivers supporting runtime PM the recommended sequence is 1014 * 1015 * drm_atomic_helper_commit_modeset_disables(dev, state); 1016 * 1017 * drm_atomic_helper_commit_modeset_enables(dev, state); 1018 * 1019 * drm_atomic_helper_commit_planes(dev, state, true); 1020 * 1021 * See the kerneldoc entries for these three functions for more details. 1022 * 1023 * RETURNS 1024 * Zero for success or -errno. 1025 */ 1026 int drm_atomic_helper_commit(struct drm_device *dev, 1027 struct drm_atomic_state *state, 1028 bool async) 1029 { 1030 int ret; 1031 1032 if (async) 1033 return -EBUSY; 1034 1035 ret = drm_atomic_helper_prepare_planes(dev, state); 1036 if (ret) 1037 return ret; 1038 1039 /* 1040 * This is the point of no return - everything below never fails except 1041 * when the hw goes bonghits. Which means we can commit the new state on 1042 * the software side now. 1043 */ 1044 1045 drm_atomic_helper_swap_state(dev, state); 1046 1047 /* 1048 * Everything below can be run asynchronously without the need to grab 1049 * any modeset locks at all under one condition: It must be guaranteed 1050 * that the asynchronous work has either been cancelled (if the driver 1051 * supports it, which at least requires that the framebuffers get 1052 * cleaned up with drm_atomic_helper_cleanup_planes()) or completed 1053 * before the new state gets committed on the software side with 1054 * drm_atomic_helper_swap_state(). 1055 * 1056 * This scheme allows new atomic state updates to be prepared and 1057 * checked in parallel to the asynchronous completion of the previous 1058 * update. Which is important since compositors need to figure out the 1059 * composition of the next frame right after having submitted the 1060 * current layout. 1061 */ 1062 1063 wait_for_fences(dev, state); 1064 1065 drm_atomic_helper_commit_modeset_disables(dev, state); 1066 1067 drm_atomic_helper_commit_planes(dev, state, false); 1068 1069 drm_atomic_helper_commit_modeset_enables(dev, state); 1070 1071 drm_atomic_helper_wait_for_vblanks(dev, state); 1072 1073 drm_atomic_helper_cleanup_planes(dev, state); 1074 1075 drm_atomic_state_free(state); 1076 1077 return 0; 1078 } 1079 EXPORT_SYMBOL(drm_atomic_helper_commit); 1080 1081 /** 1082 * DOC: implementing async commit 1083 * 1084 * For now the atomic helpers don't support async commit directly. If there is 1085 * real need it could be added though, using the dma-buf fence infrastructure 1086 * for generic synchronization with outstanding rendering. 1087 * 1088 * For now drivers have to implement async commit themselves, with the following 1089 * sequence being the recommended one: 1090 * 1091 * 1. Run drm_atomic_helper_prepare_planes() first. This is the only function 1092 * which commit needs to call which can fail, so we want to run it first and 1093 * synchronously. 1094 * 1095 * 2. Synchronize with any outstanding asynchronous commit worker threads which 1096 * might be affected the new state update. This can be done by either cancelling 1097 * or flushing the work items, depending upon whether the driver can deal with 1098 * cancelled updates. Note that it is important to ensure that the framebuffer 1099 * cleanup is still done when cancelling. 1100 * 1101 * For sufficient parallelism it is recommended to have a work item per crtc 1102 * (for updates which don't touch global state) and a global one. Then we only 1103 * need to synchronize with the crtc work items for changed crtcs and the global 1104 * work item, which allows nice concurrent updates on disjoint sets of crtcs. 1105 * 1106 * 3. The software state is updated synchronously with 1107 * drm_atomic_helper_swap_state(). Doing this under the protection of all modeset 1108 * locks means concurrent callers never see inconsistent state. And doing this 1109 * while it's guaranteed that no relevant async worker runs means that async 1110 * workers do not need grab any locks. Actually they must not grab locks, for 1111 * otherwise the work flushing will deadlock. 1112 * 1113 * 4. Schedule a work item to do all subsequent steps, using the split-out 1114 * commit helpers: a) pre-plane commit b) plane commit c) post-plane commit and 1115 * then cleaning up the framebuffers after the old framebuffer is no longer 1116 * being displayed. 1117 */ 1118 1119 /** 1120 * drm_atomic_helper_prepare_planes - prepare plane resources before commit 1121 * @dev: DRM device 1122 * @state: atomic state object with new state structures 1123 * 1124 * This function prepares plane state, specifically framebuffers, for the new 1125 * configuration. If any failure is encountered this function will call 1126 * ->cleanup_fb on any already successfully prepared framebuffer. 1127 * 1128 * Returns: 1129 * 0 on success, negative error code on failure. 1130 */ 1131 int drm_atomic_helper_prepare_planes(struct drm_device *dev, 1132 struct drm_atomic_state *state) 1133 { 1134 int nplanes = dev->mode_config.num_total_plane; 1135 int ret, i; 1136 1137 for (i = 0; i < nplanes; i++) { 1138 const struct drm_plane_helper_funcs *funcs; 1139 struct drm_plane *plane = state->planes[i]; 1140 struct drm_plane_state *plane_state = state->plane_states[i]; 1141 1142 if (!plane) 1143 continue; 1144 1145 funcs = plane->helper_private; 1146 1147 if (funcs->prepare_fb) { 1148 ret = funcs->prepare_fb(plane, plane_state); 1149 if (ret) 1150 goto fail; 1151 } 1152 } 1153 1154 return 0; 1155 1156 fail: 1157 for (i--; i >= 0; i--) { 1158 const struct drm_plane_helper_funcs *funcs; 1159 struct drm_plane *plane = state->planes[i]; 1160 struct drm_plane_state *plane_state = state->plane_states[i]; 1161 1162 if (!plane) 1163 continue; 1164 1165 funcs = plane->helper_private; 1166 1167 if (funcs->cleanup_fb) 1168 funcs->cleanup_fb(plane, plane_state); 1169 1170 } 1171 1172 return ret; 1173 } 1174 EXPORT_SYMBOL(drm_atomic_helper_prepare_planes); 1175 1176 static bool plane_crtc_active(struct drm_plane_state *state) 1177 { 1178 return state->crtc && state->crtc->state->active; 1179 } 1180 1181 /** 1182 * drm_atomic_helper_commit_planes - commit plane state 1183 * @dev: DRM device 1184 * @old_state: atomic state object with old state structures 1185 * @active_only: Only commit on active CRTC if set 1186 * 1187 * This function commits the new plane state using the plane and atomic helper 1188 * functions for planes and crtcs. It assumes that the atomic state has already 1189 * been pushed into the relevant object state pointers, since this step can no 1190 * longer fail. 1191 * 1192 * It still requires the global state object @old_state to know which planes and 1193 * crtcs need to be updated though. 1194 * 1195 * Note that this function does all plane updates across all CRTCs in one step. 1196 * If the hardware can't support this approach look at 1197 * drm_atomic_helper_commit_planes_on_crtc() instead. 1198 * 1199 * Plane parameters can be updated by applications while the associated CRTC is 1200 * disabled. The DRM/KMS core will store the parameters in the plane state, 1201 * which will be available to the driver when the CRTC is turned on. As a result 1202 * most drivers don't need to be immediately notified of plane updates for a 1203 * disabled CRTC. 1204 * 1205 * Unless otherwise needed, drivers are advised to set the @active_only 1206 * parameters to true in order not to receive plane update notifications related 1207 * to a disabled CRTC. This avoids the need to manually ignore plane updates in 1208 * driver code when the driver and/or hardware can't or just don't need to deal 1209 * with updates on disabled CRTCs, for example when supporting runtime PM. 1210 * 1211 * The drm_atomic_helper_commit() default implementation only sets @active_only 1212 * to false to most closely match the behaviour of the legacy helpers. This should 1213 * not be copied blindly by drivers. 1214 */ 1215 void drm_atomic_helper_commit_planes(struct drm_device *dev, 1216 struct drm_atomic_state *old_state, 1217 bool active_only) 1218 { 1219 struct drm_crtc *crtc; 1220 struct drm_crtc_state *old_crtc_state; 1221 struct drm_plane *plane; 1222 struct drm_plane_state *old_plane_state; 1223 int i; 1224 1225 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 1226 const struct drm_crtc_helper_funcs *funcs; 1227 1228 funcs = crtc->helper_private; 1229 1230 if (!funcs || !funcs->atomic_begin) 1231 continue; 1232 1233 if (active_only && !crtc->state->active) 1234 continue; 1235 1236 funcs->atomic_begin(crtc, old_crtc_state); 1237 } 1238 1239 for_each_plane_in_state(old_state, plane, old_plane_state, i) { 1240 const struct drm_plane_helper_funcs *funcs; 1241 bool disabling; 1242 1243 funcs = plane->helper_private; 1244 1245 if (!funcs) 1246 continue; 1247 1248 disabling = drm_atomic_plane_disabling(plane, old_plane_state); 1249 1250 if (active_only) { 1251 /* 1252 * Skip planes related to inactive CRTCs. If the plane 1253 * is enabled use the state of the current CRTC. If the 1254 * plane is being disabled use the state of the old 1255 * CRTC to avoid skipping planes being disabled on an 1256 * active CRTC. 1257 */ 1258 if (!disabling && !plane_crtc_active(plane->state)) 1259 continue; 1260 if (disabling && !plane_crtc_active(old_plane_state)) 1261 continue; 1262 } 1263 1264 /* 1265 * Special-case disabling the plane if drivers support it. 1266 */ 1267 if (disabling && funcs->atomic_disable) 1268 funcs->atomic_disable(plane, old_plane_state); 1269 else if (plane->state->crtc || disabling) 1270 funcs->atomic_update(plane, old_plane_state); 1271 } 1272 1273 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 1274 const struct drm_crtc_helper_funcs *funcs; 1275 1276 funcs = crtc->helper_private; 1277 1278 if (!funcs || !funcs->atomic_flush) 1279 continue; 1280 1281 if (active_only && !crtc->state->active) 1282 continue; 1283 1284 funcs->atomic_flush(crtc, old_crtc_state); 1285 } 1286 } 1287 EXPORT_SYMBOL(drm_atomic_helper_commit_planes); 1288 1289 /** 1290 * drm_atomic_helper_commit_planes_on_crtc - commit plane state for a crtc 1291 * @old_crtc_state: atomic state object with the old crtc state 1292 * 1293 * This function commits the new plane state using the plane and atomic helper 1294 * functions for planes on the specific crtc. It assumes that the atomic state 1295 * has already been pushed into the relevant object state pointers, since this 1296 * step can no longer fail. 1297 * 1298 * This function is useful when plane updates should be done crtc-by-crtc 1299 * instead of one global step like drm_atomic_helper_commit_planes() does. 1300 * 1301 * This function can only be savely used when planes are not allowed to move 1302 * between different CRTCs because this function doesn't handle inter-CRTC 1303 * depencies. Callers need to ensure that either no such depencies exist, 1304 * resolve them through ordering of commit calls or through some other means. 1305 */ 1306 void 1307 drm_atomic_helper_commit_planes_on_crtc(struct drm_crtc_state *old_crtc_state) 1308 { 1309 const struct drm_crtc_helper_funcs *crtc_funcs; 1310 struct drm_crtc *crtc = old_crtc_state->crtc; 1311 struct drm_atomic_state *old_state = old_crtc_state->state; 1312 struct drm_plane *plane; 1313 unsigned plane_mask; 1314 1315 plane_mask = old_crtc_state->plane_mask; 1316 plane_mask |= crtc->state->plane_mask; 1317 1318 crtc_funcs = crtc->helper_private; 1319 if (crtc_funcs && crtc_funcs->atomic_begin) 1320 crtc_funcs->atomic_begin(crtc, old_crtc_state); 1321 1322 drm_for_each_plane_mask(plane, crtc->dev, plane_mask) { 1323 struct drm_plane_state *old_plane_state = 1324 drm_atomic_get_existing_plane_state(old_state, plane); 1325 const struct drm_plane_helper_funcs *plane_funcs; 1326 1327 plane_funcs = plane->helper_private; 1328 1329 if (!old_plane_state || !plane_funcs) 1330 continue; 1331 1332 WARN_ON(plane->state->crtc && plane->state->crtc != crtc); 1333 1334 if (drm_atomic_plane_disabling(plane, old_plane_state) && 1335 plane_funcs->atomic_disable) 1336 plane_funcs->atomic_disable(plane, old_plane_state); 1337 else if (plane->state->crtc || 1338 drm_atomic_plane_disabling(plane, old_plane_state)) 1339 plane_funcs->atomic_update(plane, old_plane_state); 1340 } 1341 1342 if (crtc_funcs && crtc_funcs->atomic_flush) 1343 crtc_funcs->atomic_flush(crtc, old_crtc_state); 1344 } 1345 EXPORT_SYMBOL(drm_atomic_helper_commit_planes_on_crtc); 1346 1347 /** 1348 * drm_atomic_helper_cleanup_planes - cleanup plane resources after commit 1349 * @dev: DRM device 1350 * @old_state: atomic state object with old state structures 1351 * 1352 * This function cleans up plane state, specifically framebuffers, from the old 1353 * configuration. Hence the old configuration must be perserved in @old_state to 1354 * be able to call this function. 1355 * 1356 * This function must also be called on the new state when the atomic update 1357 * fails at any point after calling drm_atomic_helper_prepare_planes(). 1358 */ 1359 void drm_atomic_helper_cleanup_planes(struct drm_device *dev, 1360 struct drm_atomic_state *old_state) 1361 { 1362 struct drm_plane *plane; 1363 struct drm_plane_state *plane_state; 1364 int i; 1365 1366 for_each_plane_in_state(old_state, plane, plane_state, i) { 1367 const struct drm_plane_helper_funcs *funcs; 1368 1369 funcs = plane->helper_private; 1370 1371 if (funcs->cleanup_fb) 1372 funcs->cleanup_fb(plane, plane_state); 1373 } 1374 } 1375 EXPORT_SYMBOL(drm_atomic_helper_cleanup_planes); 1376 1377 /** 1378 * drm_atomic_helper_swap_state - store atomic state into current sw state 1379 * @dev: DRM device 1380 * @state: atomic state 1381 * 1382 * This function stores the atomic state into the current state pointers in all 1383 * driver objects. It should be called after all failing steps have been done 1384 * and succeeded, but before the actual hardware state is committed. 1385 * 1386 * For cleanup and error recovery the current state for all changed objects will 1387 * be swaped into @state. 1388 * 1389 * With that sequence it fits perfectly into the plane prepare/cleanup sequence: 1390 * 1391 * 1. Call drm_atomic_helper_prepare_planes() with the staged atomic state. 1392 * 1393 * 2. Do any other steps that might fail. 1394 * 1395 * 3. Put the staged state into the current state pointers with this function. 1396 * 1397 * 4. Actually commit the hardware state. 1398 * 1399 * 5. Call drm_atomic_helper_cleanup_planes() with @state, which since step 3 1400 * contains the old state. Also do any other cleanup required with that state. 1401 */ 1402 void drm_atomic_helper_swap_state(struct drm_device *dev, 1403 struct drm_atomic_state *state) 1404 { 1405 int i; 1406 1407 for (i = 0; i < dev->mode_config.num_connector; i++) { 1408 struct drm_connector *connector = state->connectors[i]; 1409 1410 if (!connector) 1411 continue; 1412 1413 connector->state->state = state; 1414 swap(state->connector_states[i], connector->state); 1415 connector->state->state = NULL; 1416 } 1417 1418 for (i = 0; i < dev->mode_config.num_crtc; i++) { 1419 struct drm_crtc *crtc = state->crtcs[i]; 1420 1421 if (!crtc) 1422 continue; 1423 1424 crtc->state->state = state; 1425 swap(state->crtc_states[i], crtc->state); 1426 crtc->state->state = NULL; 1427 } 1428 1429 for (i = 0; i < dev->mode_config.num_total_plane; i++) { 1430 struct drm_plane *plane = state->planes[i]; 1431 1432 if (!plane) 1433 continue; 1434 1435 plane->state->state = state; 1436 swap(state->plane_states[i], plane->state); 1437 plane->state->state = NULL; 1438 } 1439 } 1440 EXPORT_SYMBOL(drm_atomic_helper_swap_state); 1441 1442 /** 1443 * drm_atomic_helper_update_plane - Helper for primary plane update using atomic 1444 * @plane: plane object to update 1445 * @crtc: owning CRTC of owning plane 1446 * @fb: framebuffer to flip onto plane 1447 * @crtc_x: x offset of primary plane on crtc 1448 * @crtc_y: y offset of primary plane on crtc 1449 * @crtc_w: width of primary plane rectangle on crtc 1450 * @crtc_h: height of primary plane rectangle on crtc 1451 * @src_x: x offset of @fb for panning 1452 * @src_y: y offset of @fb for panning 1453 * @src_w: width of source rectangle in @fb 1454 * @src_h: height of source rectangle in @fb 1455 * 1456 * Provides a default plane update handler using the atomic driver interface. 1457 * 1458 * RETURNS: 1459 * Zero on success, error code on failure 1460 */ 1461 int drm_atomic_helper_update_plane(struct drm_plane *plane, 1462 struct drm_crtc *crtc, 1463 struct drm_framebuffer *fb, 1464 int crtc_x, int crtc_y, 1465 unsigned int crtc_w, unsigned int crtc_h, 1466 uint32_t src_x, uint32_t src_y, 1467 uint32_t src_w, uint32_t src_h) 1468 { 1469 struct drm_atomic_state *state; 1470 struct drm_plane_state *plane_state; 1471 int ret = 0; 1472 1473 state = drm_atomic_state_alloc(plane->dev); 1474 if (!state) 1475 return -ENOMEM; 1476 1477 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 1478 retry: 1479 plane_state = drm_atomic_get_plane_state(state, plane); 1480 if (IS_ERR(plane_state)) { 1481 ret = PTR_ERR(plane_state); 1482 goto fail; 1483 } 1484 1485 ret = drm_atomic_set_crtc_for_plane(plane_state, crtc); 1486 if (ret != 0) 1487 goto fail; 1488 drm_atomic_set_fb_for_plane(plane_state, fb); 1489 plane_state->crtc_x = crtc_x; 1490 plane_state->crtc_y = crtc_y; 1491 plane_state->crtc_h = crtc_h; 1492 plane_state->crtc_w = crtc_w; 1493 plane_state->src_x = src_x; 1494 plane_state->src_y = src_y; 1495 plane_state->src_h = src_h; 1496 plane_state->src_w = src_w; 1497 1498 if (plane == crtc->cursor) 1499 state->legacy_cursor_update = true; 1500 1501 ret = drm_atomic_commit(state); 1502 if (ret != 0) 1503 goto fail; 1504 1505 /* Driver takes ownership of state on successful commit. */ 1506 return 0; 1507 fail: 1508 if (ret == -EDEADLK) 1509 goto backoff; 1510 1511 drm_atomic_state_free(state); 1512 1513 return ret; 1514 backoff: 1515 drm_atomic_state_clear(state); 1516 drm_atomic_legacy_backoff(state); 1517 1518 /* 1519 * Someone might have exchanged the framebuffer while we dropped locks 1520 * in the backoff code. We need to fix up the fb refcount tracking the 1521 * core does for us. 1522 */ 1523 plane->old_fb = plane->fb; 1524 1525 goto retry; 1526 } 1527 EXPORT_SYMBOL(drm_atomic_helper_update_plane); 1528 1529 /** 1530 * drm_atomic_helper_disable_plane - Helper for primary plane disable using * atomic 1531 * @plane: plane to disable 1532 * 1533 * Provides a default plane disable handler using the atomic driver interface. 1534 * 1535 * RETURNS: 1536 * Zero on success, error code on failure 1537 */ 1538 int drm_atomic_helper_disable_plane(struct drm_plane *plane) 1539 { 1540 struct drm_atomic_state *state; 1541 struct drm_plane_state *plane_state; 1542 int ret = 0; 1543 1544 /* 1545 * FIXME: Without plane->crtc set we can't get at the implicit legacy 1546 * acquire context. The real fix will be to wire the acquire ctx through 1547 * everywhere we need it, but meanwhile prevent chaos by just skipping 1548 * this noop. The critical case is the cursor ioctls which a) only grab 1549 * crtc/cursor-plane locks (so we need the crtc to get at the right 1550 * acquire context) and b) can try to disable the plane multiple times. 1551 */ 1552 if (!plane->crtc) 1553 return 0; 1554 1555 state = drm_atomic_state_alloc(plane->dev); 1556 if (!state) 1557 return -ENOMEM; 1558 1559 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(plane->crtc); 1560 retry: 1561 plane_state = drm_atomic_get_plane_state(state, plane); 1562 if (IS_ERR(plane_state)) { 1563 ret = PTR_ERR(plane_state); 1564 goto fail; 1565 } 1566 1567 if (plane_state->crtc && (plane == plane->crtc->cursor)) 1568 plane_state->state->legacy_cursor_update = true; 1569 1570 ret = __drm_atomic_helper_disable_plane(plane, plane_state); 1571 if (ret != 0) 1572 goto fail; 1573 1574 ret = drm_atomic_commit(state); 1575 if (ret != 0) 1576 goto fail; 1577 1578 /* Driver takes ownership of state on successful commit. */ 1579 return 0; 1580 fail: 1581 if (ret == -EDEADLK) 1582 goto backoff; 1583 1584 drm_atomic_state_free(state); 1585 1586 return ret; 1587 backoff: 1588 drm_atomic_state_clear(state); 1589 drm_atomic_legacy_backoff(state); 1590 1591 /* 1592 * Someone might have exchanged the framebuffer while we dropped locks 1593 * in the backoff code. We need to fix up the fb refcount tracking the 1594 * core does for us. 1595 */ 1596 plane->old_fb = plane->fb; 1597 1598 goto retry; 1599 } 1600 EXPORT_SYMBOL(drm_atomic_helper_disable_plane); 1601 1602 /* just used from fb-helper and atomic-helper: */ 1603 int __drm_atomic_helper_disable_plane(struct drm_plane *plane, 1604 struct drm_plane_state *plane_state) 1605 { 1606 int ret; 1607 1608 ret = drm_atomic_set_crtc_for_plane(plane_state, NULL); 1609 if (ret != 0) 1610 return ret; 1611 1612 drm_atomic_set_fb_for_plane(plane_state, NULL); 1613 plane_state->crtc_x = 0; 1614 plane_state->crtc_y = 0; 1615 plane_state->crtc_h = 0; 1616 plane_state->crtc_w = 0; 1617 plane_state->src_x = 0; 1618 plane_state->src_y = 0; 1619 plane_state->src_h = 0; 1620 plane_state->src_w = 0; 1621 1622 return 0; 1623 } 1624 1625 static int update_output_state(struct drm_atomic_state *state, 1626 struct drm_mode_set *set) 1627 { 1628 struct drm_device *dev = set->crtc->dev; 1629 struct drm_crtc *crtc; 1630 struct drm_crtc_state *crtc_state; 1631 struct drm_connector *connector; 1632 struct drm_connector_state *conn_state; 1633 int ret, i, j; 1634 1635 ret = drm_modeset_lock(&dev->mode_config.connection_mutex, 1636 state->acquire_ctx); 1637 if (ret) 1638 return ret; 1639 1640 /* First grab all affected connector/crtc states. */ 1641 for (i = 0; i < set->num_connectors; i++) { 1642 conn_state = drm_atomic_get_connector_state(state, 1643 set->connectors[i]); 1644 if (IS_ERR(conn_state)) 1645 return PTR_ERR(conn_state); 1646 } 1647 1648 for_each_crtc_in_state(state, crtc, crtc_state, i) { 1649 ret = drm_atomic_add_affected_connectors(state, crtc); 1650 if (ret) 1651 return ret; 1652 } 1653 1654 /* Then recompute connector->crtc links and crtc enabling state. */ 1655 for_each_connector_in_state(state, connector, conn_state, i) { 1656 if (conn_state->crtc == set->crtc) { 1657 ret = drm_atomic_set_crtc_for_connector(conn_state, 1658 NULL); 1659 if (ret) 1660 return ret; 1661 } 1662 1663 for (j = 0; j < set->num_connectors; j++) { 1664 if (set->connectors[j] == connector) { 1665 ret = drm_atomic_set_crtc_for_connector(conn_state, 1666 set->crtc); 1667 if (ret) 1668 return ret; 1669 break; 1670 } 1671 } 1672 } 1673 1674 for_each_crtc_in_state(state, crtc, crtc_state, i) { 1675 /* Don't update ->enable for the CRTC in the set_config request, 1676 * since a mismatch would indicate a bug in the upper layers. 1677 * The actual modeset code later on will catch any 1678 * inconsistencies here. */ 1679 if (crtc == set->crtc) 1680 continue; 1681 1682 if (!drm_atomic_connectors_for_crtc(state, crtc)) { 1683 ret = drm_atomic_set_mode_prop_for_crtc(crtc_state, 1684 NULL); 1685 if (ret < 0) 1686 return ret; 1687 1688 crtc_state->active = false; 1689 } 1690 } 1691 1692 return 0; 1693 } 1694 1695 /** 1696 * drm_atomic_helper_set_config - set a new config from userspace 1697 * @set: mode set configuration 1698 * 1699 * Provides a default crtc set_config handler using the atomic driver interface. 1700 * 1701 * Returns: 1702 * Returns 0 on success, negative errno numbers on failure. 1703 */ 1704 int drm_atomic_helper_set_config(struct drm_mode_set *set) 1705 { 1706 struct drm_atomic_state *state; 1707 struct drm_crtc *crtc = set->crtc; 1708 int ret = 0; 1709 1710 state = drm_atomic_state_alloc(crtc->dev); 1711 if (!state) 1712 return -ENOMEM; 1713 1714 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 1715 retry: 1716 ret = __drm_atomic_helper_set_config(set, state); 1717 if (ret != 0) 1718 goto fail; 1719 1720 ret = drm_atomic_commit(state); 1721 if (ret != 0) 1722 goto fail; 1723 1724 /* Driver takes ownership of state on successful commit. */ 1725 return 0; 1726 fail: 1727 if (ret == -EDEADLK) 1728 goto backoff; 1729 1730 drm_atomic_state_free(state); 1731 1732 return ret; 1733 backoff: 1734 drm_atomic_state_clear(state); 1735 drm_atomic_legacy_backoff(state); 1736 1737 /* 1738 * Someone might have exchanged the framebuffer while we dropped locks 1739 * in the backoff code. We need to fix up the fb refcount tracking the 1740 * core does for us. 1741 */ 1742 crtc->primary->old_fb = crtc->primary->fb; 1743 1744 goto retry; 1745 } 1746 EXPORT_SYMBOL(drm_atomic_helper_set_config); 1747 1748 /* just used from fb-helper and atomic-helper: */ 1749 int __drm_atomic_helper_set_config(struct drm_mode_set *set, 1750 struct drm_atomic_state *state) 1751 { 1752 struct drm_crtc_state *crtc_state; 1753 struct drm_plane_state *primary_state; 1754 struct drm_crtc *crtc = set->crtc; 1755 int hdisplay, vdisplay; 1756 int ret; 1757 1758 crtc_state = drm_atomic_get_crtc_state(state, crtc); 1759 if (IS_ERR(crtc_state)) 1760 return PTR_ERR(crtc_state); 1761 1762 primary_state = drm_atomic_get_plane_state(state, crtc->primary); 1763 if (IS_ERR(primary_state)) 1764 return PTR_ERR(primary_state); 1765 1766 if (!set->mode) { 1767 WARN_ON(set->fb); 1768 WARN_ON(set->num_connectors); 1769 1770 ret = drm_atomic_set_mode_for_crtc(crtc_state, NULL); 1771 if (ret != 0) 1772 return ret; 1773 1774 crtc_state->active = false; 1775 1776 ret = drm_atomic_set_crtc_for_plane(primary_state, NULL); 1777 if (ret != 0) 1778 return ret; 1779 1780 drm_atomic_set_fb_for_plane(primary_state, NULL); 1781 1782 goto commit; 1783 } 1784 1785 WARN_ON(!set->fb); 1786 WARN_ON(!set->num_connectors); 1787 1788 ret = drm_atomic_set_mode_for_crtc(crtc_state, set->mode); 1789 if (ret != 0) 1790 return ret; 1791 1792 crtc_state->active = true; 1793 1794 ret = drm_atomic_set_crtc_for_plane(primary_state, crtc); 1795 if (ret != 0) 1796 return ret; 1797 1798 drm_crtc_get_hv_timing(set->mode, &hdisplay, &vdisplay); 1799 1800 drm_atomic_set_fb_for_plane(primary_state, set->fb); 1801 primary_state->crtc_x = 0; 1802 primary_state->crtc_y = 0; 1803 primary_state->crtc_h = vdisplay; 1804 primary_state->crtc_w = hdisplay; 1805 primary_state->src_x = set->x << 16; 1806 primary_state->src_y = set->y << 16; 1807 if (primary_state->rotation & (BIT(DRM_ROTATE_90) | BIT(DRM_ROTATE_270))) { 1808 primary_state->src_h = hdisplay << 16; 1809 primary_state->src_w = vdisplay << 16; 1810 } else { 1811 primary_state->src_h = vdisplay << 16; 1812 primary_state->src_w = hdisplay << 16; 1813 } 1814 1815 commit: 1816 ret = update_output_state(state, set); 1817 if (ret) 1818 return ret; 1819 1820 return 0; 1821 } 1822 1823 /** 1824 * drm_atomic_helper_crtc_set_property - helper for crtc properties 1825 * @crtc: DRM crtc 1826 * @property: DRM property 1827 * @val: value of property 1828 * 1829 * Provides a default crtc set_property handler using the atomic driver 1830 * interface. 1831 * 1832 * RETURNS: 1833 * Zero on success, error code on failure 1834 */ 1835 int 1836 drm_atomic_helper_crtc_set_property(struct drm_crtc *crtc, 1837 struct drm_property *property, 1838 uint64_t val) 1839 { 1840 struct drm_atomic_state *state; 1841 struct drm_crtc_state *crtc_state; 1842 int ret = 0; 1843 1844 state = drm_atomic_state_alloc(crtc->dev); 1845 if (!state) 1846 return -ENOMEM; 1847 1848 /* ->set_property is always called with all locks held. */ 1849 state->acquire_ctx = crtc->dev->mode_config.acquire_ctx; 1850 retry: 1851 crtc_state = drm_atomic_get_crtc_state(state, crtc); 1852 if (IS_ERR(crtc_state)) { 1853 ret = PTR_ERR(crtc_state); 1854 goto fail; 1855 } 1856 1857 ret = drm_atomic_crtc_set_property(crtc, crtc_state, 1858 property, val); 1859 if (ret) 1860 goto fail; 1861 1862 ret = drm_atomic_commit(state); 1863 if (ret != 0) 1864 goto fail; 1865 1866 /* Driver takes ownership of state on successful commit. */ 1867 return 0; 1868 fail: 1869 if (ret == -EDEADLK) 1870 goto backoff; 1871 1872 drm_atomic_state_free(state); 1873 1874 return ret; 1875 backoff: 1876 drm_atomic_state_clear(state); 1877 drm_atomic_legacy_backoff(state); 1878 1879 goto retry; 1880 } 1881 EXPORT_SYMBOL(drm_atomic_helper_crtc_set_property); 1882 1883 /** 1884 * drm_atomic_helper_plane_set_property - helper for plane properties 1885 * @plane: DRM plane 1886 * @property: DRM property 1887 * @val: value of property 1888 * 1889 * Provides a default plane set_property handler using the atomic driver 1890 * interface. 1891 * 1892 * RETURNS: 1893 * Zero on success, error code on failure 1894 */ 1895 int 1896 drm_atomic_helper_plane_set_property(struct drm_plane *plane, 1897 struct drm_property *property, 1898 uint64_t val) 1899 { 1900 struct drm_atomic_state *state; 1901 struct drm_plane_state *plane_state; 1902 int ret = 0; 1903 1904 state = drm_atomic_state_alloc(plane->dev); 1905 if (!state) 1906 return -ENOMEM; 1907 1908 /* ->set_property is always called with all locks held. */ 1909 state->acquire_ctx = plane->dev->mode_config.acquire_ctx; 1910 retry: 1911 plane_state = drm_atomic_get_plane_state(state, plane); 1912 if (IS_ERR(plane_state)) { 1913 ret = PTR_ERR(plane_state); 1914 goto fail; 1915 } 1916 1917 ret = drm_atomic_plane_set_property(plane, plane_state, 1918 property, val); 1919 if (ret) 1920 goto fail; 1921 1922 ret = drm_atomic_commit(state); 1923 if (ret != 0) 1924 goto fail; 1925 1926 /* Driver takes ownership of state on successful commit. */ 1927 return 0; 1928 fail: 1929 if (ret == -EDEADLK) 1930 goto backoff; 1931 1932 drm_atomic_state_free(state); 1933 1934 return ret; 1935 backoff: 1936 drm_atomic_state_clear(state); 1937 drm_atomic_legacy_backoff(state); 1938 1939 goto retry; 1940 } 1941 EXPORT_SYMBOL(drm_atomic_helper_plane_set_property); 1942 1943 /** 1944 * drm_atomic_helper_connector_set_property - helper for connector properties 1945 * @connector: DRM connector 1946 * @property: DRM property 1947 * @val: value of property 1948 * 1949 * Provides a default connector set_property handler using the atomic driver 1950 * interface. 1951 * 1952 * RETURNS: 1953 * Zero on success, error code on failure 1954 */ 1955 int 1956 drm_atomic_helper_connector_set_property(struct drm_connector *connector, 1957 struct drm_property *property, 1958 uint64_t val) 1959 { 1960 struct drm_atomic_state *state; 1961 struct drm_connector_state *connector_state; 1962 int ret = 0; 1963 1964 state = drm_atomic_state_alloc(connector->dev); 1965 if (!state) 1966 return -ENOMEM; 1967 1968 /* ->set_property is always called with all locks held. */ 1969 state->acquire_ctx = connector->dev->mode_config.acquire_ctx; 1970 retry: 1971 connector_state = drm_atomic_get_connector_state(state, connector); 1972 if (IS_ERR(connector_state)) { 1973 ret = PTR_ERR(connector_state); 1974 goto fail; 1975 } 1976 1977 ret = drm_atomic_connector_set_property(connector, connector_state, 1978 property, val); 1979 if (ret) 1980 goto fail; 1981 1982 ret = drm_atomic_commit(state); 1983 if (ret != 0) 1984 goto fail; 1985 1986 /* Driver takes ownership of state on successful commit. */ 1987 return 0; 1988 fail: 1989 if (ret == -EDEADLK) 1990 goto backoff; 1991 1992 drm_atomic_state_free(state); 1993 1994 return ret; 1995 backoff: 1996 drm_atomic_state_clear(state); 1997 drm_atomic_legacy_backoff(state); 1998 1999 goto retry; 2000 } 2001 EXPORT_SYMBOL(drm_atomic_helper_connector_set_property); 2002 2003 /** 2004 * drm_atomic_helper_page_flip - execute a legacy page flip 2005 * @crtc: DRM crtc 2006 * @fb: DRM framebuffer 2007 * @event: optional DRM event to signal upon completion 2008 * @flags: flip flags for non-vblank sync'ed updates 2009 * 2010 * Provides a default page flip implementation using the atomic driver interface. 2011 * 2012 * Note that for now so called async page flips (i.e. updates which are not 2013 * synchronized to vblank) are not supported, since the atomic interfaces have 2014 * no provisions for this yet. 2015 * 2016 * Returns: 2017 * Returns 0 on success, negative errno numbers on failure. 2018 */ 2019 int drm_atomic_helper_page_flip(struct drm_crtc *crtc, 2020 struct drm_framebuffer *fb, 2021 struct drm_pending_vblank_event *event, 2022 uint32_t flags) 2023 { 2024 struct drm_plane *plane = crtc->primary; 2025 struct drm_atomic_state *state; 2026 struct drm_plane_state *plane_state; 2027 struct drm_crtc_state *crtc_state; 2028 int ret = 0; 2029 2030 if (flags & DRM_MODE_PAGE_FLIP_ASYNC) 2031 return -EINVAL; 2032 2033 state = drm_atomic_state_alloc(plane->dev); 2034 if (!state) 2035 return -ENOMEM; 2036 2037 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 2038 retry: 2039 crtc_state = drm_atomic_get_crtc_state(state, crtc); 2040 if (IS_ERR(crtc_state)) { 2041 ret = PTR_ERR(crtc_state); 2042 goto fail; 2043 } 2044 crtc_state->event = event; 2045 2046 plane_state = drm_atomic_get_plane_state(state, plane); 2047 if (IS_ERR(plane_state)) { 2048 ret = PTR_ERR(plane_state); 2049 goto fail; 2050 } 2051 2052 ret = drm_atomic_set_crtc_for_plane(plane_state, crtc); 2053 if (ret != 0) 2054 goto fail; 2055 drm_atomic_set_fb_for_plane(plane_state, fb); 2056 2057 ret = drm_atomic_async_commit(state); 2058 if (ret != 0) 2059 goto fail; 2060 2061 /* Driver takes ownership of state on successful async commit. */ 2062 return 0; 2063 fail: 2064 if (ret == -EDEADLK) 2065 goto backoff; 2066 2067 drm_atomic_state_free(state); 2068 2069 return ret; 2070 backoff: 2071 drm_atomic_state_clear(state); 2072 drm_atomic_legacy_backoff(state); 2073 2074 /* 2075 * Someone might have exchanged the framebuffer while we dropped locks 2076 * in the backoff code. We need to fix up the fb refcount tracking the 2077 * core does for us. 2078 */ 2079 plane->old_fb = plane->fb; 2080 2081 goto retry; 2082 } 2083 EXPORT_SYMBOL(drm_atomic_helper_page_flip); 2084 2085 /** 2086 * drm_atomic_helper_connector_dpms() - connector dpms helper implementation 2087 * @connector: affected connector 2088 * @mode: DPMS mode 2089 * 2090 * This is the main helper function provided by the atomic helper framework for 2091 * implementing the legacy DPMS connector interface. It computes the new desired 2092 * ->active state for the corresponding CRTC (if the connector is enabled) and 2093 * updates it. 2094 * 2095 * Returns: 2096 * Returns 0 on success, negative errno numbers on failure. 2097 */ 2098 int drm_atomic_helper_connector_dpms(struct drm_connector *connector, 2099 int mode) 2100 { 2101 struct drm_mode_config *config = &connector->dev->mode_config; 2102 struct drm_atomic_state *state; 2103 struct drm_crtc_state *crtc_state; 2104 struct drm_crtc *crtc; 2105 struct drm_connector *tmp_connector; 2106 int ret; 2107 bool active = false; 2108 int old_mode = connector->dpms; 2109 2110 if (mode != DRM_MODE_DPMS_ON) 2111 mode = DRM_MODE_DPMS_OFF; 2112 2113 connector->dpms = mode; 2114 crtc = connector->state->crtc; 2115 2116 if (!crtc) 2117 return 0; 2118 2119 state = drm_atomic_state_alloc(connector->dev); 2120 if (!state) 2121 return -ENOMEM; 2122 2123 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 2124 retry: 2125 crtc_state = drm_atomic_get_crtc_state(state, crtc); 2126 if (IS_ERR(crtc_state)) { 2127 ret = PTR_ERR(crtc_state); 2128 goto fail; 2129 } 2130 2131 WARN_ON(!drm_modeset_is_locked(&config->connection_mutex)); 2132 2133 drm_for_each_connector(tmp_connector, connector->dev) { 2134 if (tmp_connector->state->crtc != crtc) 2135 continue; 2136 2137 if (tmp_connector->dpms == DRM_MODE_DPMS_ON) { 2138 active = true; 2139 break; 2140 } 2141 } 2142 crtc_state->active = active; 2143 2144 ret = drm_atomic_commit(state); 2145 if (ret != 0) 2146 goto fail; 2147 2148 /* Driver takes ownership of state on successful commit. */ 2149 return 0; 2150 fail: 2151 if (ret == -EDEADLK) 2152 goto backoff; 2153 2154 connector->dpms = old_mode; 2155 drm_atomic_state_free(state); 2156 2157 return ret; 2158 backoff: 2159 drm_atomic_state_clear(state); 2160 drm_atomic_legacy_backoff(state); 2161 2162 goto retry; 2163 } 2164 EXPORT_SYMBOL(drm_atomic_helper_connector_dpms); 2165 2166 /** 2167 * DOC: atomic state reset and initialization 2168 * 2169 * Both the drm core and the atomic helpers assume that there is always the full 2170 * and correct atomic software state for all connectors, CRTCs and planes 2171 * available. Which is a bit a problem on driver load and also after system 2172 * suspend. One way to solve this is to have a hardware state read-out 2173 * infrastructure which reconstructs the full software state (e.g. the i915 2174 * driver). 2175 * 2176 * The simpler solution is to just reset the software state to everything off, 2177 * which is easiest to do by calling drm_mode_config_reset(). To facilitate this 2178 * the atomic helpers provide default reset implementations for all hooks. 2179 */ 2180 2181 /** 2182 * drm_atomic_helper_crtc_reset - default ->reset hook for CRTCs 2183 * @crtc: drm CRTC 2184 * 2185 * Resets the atomic state for @crtc by freeing the state pointer (which might 2186 * be NULL, e.g. at driver load time) and allocating a new empty state object. 2187 */ 2188 void drm_atomic_helper_crtc_reset(struct drm_crtc *crtc) 2189 { 2190 if (crtc->state && crtc->state->mode_blob) 2191 drm_property_unreference_blob(crtc->state->mode_blob); 2192 kfree(crtc->state); 2193 crtc->state = kzalloc(sizeof(*crtc->state), GFP_KERNEL); 2194 2195 if (crtc->state) 2196 crtc->state->crtc = crtc; 2197 } 2198 EXPORT_SYMBOL(drm_atomic_helper_crtc_reset); 2199 2200 /** 2201 * __drm_atomic_helper_crtc_duplicate_state - copy atomic CRTC state 2202 * @crtc: CRTC object 2203 * @state: atomic CRTC state 2204 * 2205 * Copies atomic state from a CRTC's current state and resets inferred values. 2206 * This is useful for drivers that subclass the CRTC state. 2207 */ 2208 void __drm_atomic_helper_crtc_duplicate_state(struct drm_crtc *crtc, 2209 struct drm_crtc_state *state) 2210 { 2211 memcpy(state, crtc->state, sizeof(*state)); 2212 2213 if (state->mode_blob) 2214 drm_property_reference_blob(state->mode_blob); 2215 state->mode_changed = false; 2216 state->active_changed = false; 2217 state->planes_changed = false; 2218 state->connectors_changed = false; 2219 state->event = NULL; 2220 } 2221 EXPORT_SYMBOL(__drm_atomic_helper_crtc_duplicate_state); 2222 2223 /** 2224 * drm_atomic_helper_crtc_duplicate_state - default state duplicate hook 2225 * @crtc: drm CRTC 2226 * 2227 * Default CRTC state duplicate hook for drivers which don't have their own 2228 * subclassed CRTC state structure. 2229 */ 2230 struct drm_crtc_state * 2231 drm_atomic_helper_crtc_duplicate_state(struct drm_crtc *crtc) 2232 { 2233 struct drm_crtc_state *state; 2234 2235 if (WARN_ON(!crtc->state)) 2236 return NULL; 2237 2238 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2239 if (state) 2240 __drm_atomic_helper_crtc_duplicate_state(crtc, state); 2241 2242 return state; 2243 } 2244 EXPORT_SYMBOL(drm_atomic_helper_crtc_duplicate_state); 2245 2246 /** 2247 * __drm_atomic_helper_crtc_destroy_state - release CRTC state 2248 * @crtc: CRTC object 2249 * @state: CRTC state object to release 2250 * 2251 * Releases all resources stored in the CRTC state without actually freeing 2252 * the memory of the CRTC state. This is useful for drivers that subclass the 2253 * CRTC state. 2254 */ 2255 void __drm_atomic_helper_crtc_destroy_state(struct drm_crtc *crtc, 2256 struct drm_crtc_state *state) 2257 { 2258 if (state->mode_blob) 2259 drm_property_unreference_blob(state->mode_blob); 2260 } 2261 EXPORT_SYMBOL(__drm_atomic_helper_crtc_destroy_state); 2262 2263 /** 2264 * drm_atomic_helper_crtc_destroy_state - default state destroy hook 2265 * @crtc: drm CRTC 2266 * @state: CRTC state object to release 2267 * 2268 * Default CRTC state destroy hook for drivers which don't have their own 2269 * subclassed CRTC state structure. 2270 */ 2271 void drm_atomic_helper_crtc_destroy_state(struct drm_crtc *crtc, 2272 struct drm_crtc_state *state) 2273 { 2274 __drm_atomic_helper_crtc_destroy_state(crtc, state); 2275 kfree(state); 2276 } 2277 EXPORT_SYMBOL(drm_atomic_helper_crtc_destroy_state); 2278 2279 /** 2280 * drm_atomic_helper_plane_reset - default ->reset hook for planes 2281 * @plane: drm plane 2282 * 2283 * Resets the atomic state for @plane by freeing the state pointer (which might 2284 * be NULL, e.g. at driver load time) and allocating a new empty state object. 2285 */ 2286 void drm_atomic_helper_plane_reset(struct drm_plane *plane) 2287 { 2288 if (plane->state && plane->state->fb) 2289 drm_framebuffer_unreference(plane->state->fb); 2290 2291 kfree(plane->state); 2292 plane->state = kzalloc(sizeof(*plane->state), GFP_KERNEL); 2293 2294 if (plane->state) 2295 plane->state->plane = plane; 2296 } 2297 EXPORT_SYMBOL(drm_atomic_helper_plane_reset); 2298 2299 /** 2300 * __drm_atomic_helper_plane_duplicate_state - copy atomic plane state 2301 * @plane: plane object 2302 * @state: atomic plane state 2303 * 2304 * Copies atomic state from a plane's current state. This is useful for 2305 * drivers that subclass the plane state. 2306 */ 2307 void __drm_atomic_helper_plane_duplicate_state(struct drm_plane *plane, 2308 struct drm_plane_state *state) 2309 { 2310 memcpy(state, plane->state, sizeof(*state)); 2311 2312 if (state->fb) 2313 drm_framebuffer_reference(state->fb); 2314 } 2315 EXPORT_SYMBOL(__drm_atomic_helper_plane_duplicate_state); 2316 2317 /** 2318 * drm_atomic_helper_plane_duplicate_state - default state duplicate hook 2319 * @plane: drm plane 2320 * 2321 * Default plane state duplicate hook for drivers which don't have their own 2322 * subclassed plane state structure. 2323 */ 2324 struct drm_plane_state * 2325 drm_atomic_helper_plane_duplicate_state(struct drm_plane *plane) 2326 { 2327 struct drm_plane_state *state; 2328 2329 if (WARN_ON(!plane->state)) 2330 return NULL; 2331 2332 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2333 if (state) 2334 __drm_atomic_helper_plane_duplicate_state(plane, state); 2335 2336 return state; 2337 } 2338 EXPORT_SYMBOL(drm_atomic_helper_plane_duplicate_state); 2339 2340 /** 2341 * __drm_atomic_helper_plane_destroy_state - release plane state 2342 * @plane: plane object 2343 * @state: plane state object to release 2344 * 2345 * Releases all resources stored in the plane state without actually freeing 2346 * the memory of the plane state. This is useful for drivers that subclass the 2347 * plane state. 2348 */ 2349 void __drm_atomic_helper_plane_destroy_state(struct drm_plane *plane, 2350 struct drm_plane_state *state) 2351 { 2352 if (state->fb) 2353 drm_framebuffer_unreference(state->fb); 2354 } 2355 EXPORT_SYMBOL(__drm_atomic_helper_plane_destroy_state); 2356 2357 /** 2358 * drm_atomic_helper_plane_destroy_state - default state destroy hook 2359 * @plane: drm plane 2360 * @state: plane state object to release 2361 * 2362 * Default plane state destroy hook for drivers which don't have their own 2363 * subclassed plane state structure. 2364 */ 2365 void drm_atomic_helper_plane_destroy_state(struct drm_plane *plane, 2366 struct drm_plane_state *state) 2367 { 2368 __drm_atomic_helper_plane_destroy_state(plane, state); 2369 kfree(state); 2370 } 2371 EXPORT_SYMBOL(drm_atomic_helper_plane_destroy_state); 2372 2373 /** 2374 * drm_atomic_helper_connector_reset - default ->reset hook for connectors 2375 * @connector: drm connector 2376 * 2377 * Resets the atomic state for @connector by freeing the state pointer (which 2378 * might be NULL, e.g. at driver load time) and allocating a new empty state 2379 * object. 2380 */ 2381 void drm_atomic_helper_connector_reset(struct drm_connector *connector) 2382 { 2383 kfree(connector->state); 2384 connector->state = kzalloc(sizeof(*connector->state), GFP_KERNEL); 2385 2386 if (connector->state) 2387 connector->state->connector = connector; 2388 } 2389 EXPORT_SYMBOL(drm_atomic_helper_connector_reset); 2390 2391 /** 2392 * __drm_atomic_helper_connector_duplicate_state - copy atomic connector state 2393 * @connector: connector object 2394 * @state: atomic connector state 2395 * 2396 * Copies atomic state from a connector's current state. This is useful for 2397 * drivers that subclass the connector state. 2398 */ 2399 void 2400 __drm_atomic_helper_connector_duplicate_state(struct drm_connector *connector, 2401 struct drm_connector_state *state) 2402 { 2403 memcpy(state, connector->state, sizeof(*state)); 2404 } 2405 EXPORT_SYMBOL(__drm_atomic_helper_connector_duplicate_state); 2406 2407 /** 2408 * drm_atomic_helper_connector_duplicate_state - default state duplicate hook 2409 * @connector: drm connector 2410 * 2411 * Default connector state duplicate hook for drivers which don't have their own 2412 * subclassed connector state structure. 2413 */ 2414 struct drm_connector_state * 2415 drm_atomic_helper_connector_duplicate_state(struct drm_connector *connector) 2416 { 2417 struct drm_connector_state *state; 2418 2419 if (WARN_ON(!connector->state)) 2420 return NULL; 2421 2422 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2423 if (state) 2424 __drm_atomic_helper_connector_duplicate_state(connector, state); 2425 2426 return state; 2427 } 2428 EXPORT_SYMBOL(drm_atomic_helper_connector_duplicate_state); 2429 2430 /** 2431 * drm_atomic_helper_duplicate_state - duplicate an atomic state object 2432 * @dev: DRM device 2433 * @ctx: lock acquisition context 2434 * 2435 * Makes a copy of the current atomic state by looping over all objects and 2436 * duplicating their respective states. 2437 * 2438 * Note that this treats atomic state as persistent between save and restore. 2439 * Drivers must make sure that this is possible and won't result in confusion 2440 * or erroneous behaviour. 2441 * 2442 * Note that if callers haven't already acquired all modeset locks this might 2443 * return -EDEADLK, which must be handled by calling drm_modeset_backoff(). 2444 * 2445 * Returns: 2446 * A pointer to the copy of the atomic state object on success or an 2447 * ERR_PTR()-encoded error code on failure. 2448 */ 2449 struct drm_atomic_state * 2450 drm_atomic_helper_duplicate_state(struct drm_device *dev, 2451 struct drm_modeset_acquire_ctx *ctx) 2452 { 2453 struct drm_atomic_state *state; 2454 struct drm_connector *conn; 2455 struct drm_plane *plane; 2456 struct drm_crtc *crtc; 2457 int err = 0; 2458 2459 state = drm_atomic_state_alloc(dev); 2460 if (!state) 2461 return ERR_PTR(-ENOMEM); 2462 2463 state->acquire_ctx = ctx; 2464 2465 drm_for_each_crtc(crtc, dev) { 2466 struct drm_crtc_state *crtc_state; 2467 2468 crtc_state = drm_atomic_get_crtc_state(state, crtc); 2469 if (IS_ERR(crtc_state)) { 2470 err = PTR_ERR(crtc_state); 2471 goto free; 2472 } 2473 } 2474 2475 drm_for_each_plane(plane, dev) { 2476 struct drm_plane_state *plane_state; 2477 2478 plane_state = drm_atomic_get_plane_state(state, plane); 2479 if (IS_ERR(plane_state)) { 2480 err = PTR_ERR(plane_state); 2481 goto free; 2482 } 2483 } 2484 2485 drm_for_each_connector(conn, dev) { 2486 struct drm_connector_state *conn_state; 2487 2488 conn_state = drm_atomic_get_connector_state(state, conn); 2489 if (IS_ERR(conn_state)) { 2490 err = PTR_ERR(conn_state); 2491 goto free; 2492 } 2493 } 2494 2495 /* clear the acquire context so that it isn't accidentally reused */ 2496 state->acquire_ctx = NULL; 2497 2498 free: 2499 if (err < 0) { 2500 drm_atomic_state_free(state); 2501 state = ERR_PTR(err); 2502 } 2503 2504 return state; 2505 } 2506 EXPORT_SYMBOL(drm_atomic_helper_duplicate_state); 2507 2508 /** 2509 * __drm_atomic_helper_connector_destroy_state - release connector state 2510 * @connector: connector object 2511 * @state: connector state object to release 2512 * 2513 * Releases all resources stored in the connector state without actually 2514 * freeing the memory of the connector state. This is useful for drivers that 2515 * subclass the connector state. 2516 */ 2517 void 2518 __drm_atomic_helper_connector_destroy_state(struct drm_connector *connector, 2519 struct drm_connector_state *state) 2520 { 2521 /* 2522 * This is currently a placeholder so that drivers that subclass the 2523 * state will automatically do the right thing if code is ever added 2524 * to this function. 2525 */ 2526 } 2527 EXPORT_SYMBOL(__drm_atomic_helper_connector_destroy_state); 2528 2529 /** 2530 * drm_atomic_helper_connector_destroy_state - default state destroy hook 2531 * @connector: drm connector 2532 * @state: connector state object to release 2533 * 2534 * Default connector state destroy hook for drivers which don't have their own 2535 * subclassed connector state structure. 2536 */ 2537 void drm_atomic_helper_connector_destroy_state(struct drm_connector *connector, 2538 struct drm_connector_state *state) 2539 { 2540 __drm_atomic_helper_connector_destroy_state(connector, state); 2541 kfree(state); 2542 } 2543 EXPORT_SYMBOL(drm_atomic_helper_connector_destroy_state); 2544