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