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 struct drm_plane *plane; 893 struct drm_plane_state *plane_state; 894 int i; 895 896 for_each_plane_in_state(state, plane, plane_state, i) { 897 if (!plane->state->fence) 898 continue; 899 900 WARN_ON(!plane->state->fb); 901 902 #if 0 903 fence_wait(plane->state->fence, false); 904 fence_put(plane->state->fence); 905 #endif 906 plane->state->fence = NULL; 907 } 908 } 909 910 static bool framebuffer_changed(struct drm_device *dev, 911 struct drm_atomic_state *old_state, 912 struct drm_crtc *crtc) 913 { 914 struct drm_plane *plane; 915 struct drm_plane_state *old_plane_state; 916 int i; 917 918 for_each_plane_in_state(old_state, plane, old_plane_state, i) { 919 if (plane->state->crtc != crtc && 920 old_plane_state->crtc != crtc) 921 continue; 922 923 if (plane->state->fb != old_plane_state->fb) 924 return true; 925 } 926 927 return false; 928 } 929 930 /** 931 * drm_atomic_helper_wait_for_vblanks - wait for vblank on crtcs 932 * @dev: DRM device 933 * @old_state: atomic state object with old state structures 934 * 935 * Helper to, after atomic commit, wait for vblanks on all effected 936 * crtcs (ie. before cleaning up old framebuffers using 937 * drm_atomic_helper_cleanup_planes()). It will only wait on crtcs where the 938 * framebuffers have actually changed to optimize for the legacy cursor and 939 * plane update use-case. 940 */ 941 void 942 drm_atomic_helper_wait_for_vblanks(struct drm_device *dev, 943 struct drm_atomic_state *old_state) 944 { 945 struct drm_crtc *crtc; 946 struct drm_crtc_state *old_crtc_state; 947 int i, ret; 948 949 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 950 /* No one cares about the old state, so abuse it for tracking 951 * and store whether we hold a vblank reference (and should do a 952 * vblank wait) in the ->enable boolean. */ 953 old_crtc_state->enable = false; 954 955 if (!crtc->state->enable) 956 continue; 957 958 /* Legacy cursor ioctls are completely unsynced, and userspace 959 * relies on that (by doing tons of cursor updates). */ 960 if (old_state->legacy_cursor_update) 961 continue; 962 963 if (!framebuffer_changed(dev, old_state, crtc)) 964 continue; 965 966 ret = drm_crtc_vblank_get(crtc); 967 if (ret != 0) 968 continue; 969 970 old_crtc_state->enable = true; 971 old_crtc_state->last_vblank_count = drm_crtc_vblank_count(crtc); 972 } 973 974 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 975 if (!old_crtc_state->enable) 976 continue; 977 978 ret = wait_event_timeout(dev->vblank[i].queue, 979 old_crtc_state->last_vblank_count != 980 drm_crtc_vblank_count(crtc), 981 msecs_to_jiffies(50)); 982 983 drm_crtc_vblank_put(crtc); 984 } 985 } 986 EXPORT_SYMBOL(drm_atomic_helper_wait_for_vblanks); 987 988 /** 989 * drm_atomic_helper_commit - commit validated state object 990 * @dev: DRM device 991 * @state: the driver state object 992 * @async: asynchronous commit 993 * 994 * This function commits a with drm_atomic_helper_check() pre-validated state 995 * object. This can still fail when e.g. the framebuffer reservation fails. For 996 * now this doesn't implement asynchronous commits. 997 * 998 * RETURNS 999 * Zero for success or -errno. 1000 */ 1001 int drm_atomic_helper_commit(struct drm_device *dev, 1002 struct drm_atomic_state *state, 1003 bool async) 1004 { 1005 int ret; 1006 1007 if (async) 1008 return -EBUSY; 1009 1010 ret = drm_atomic_helper_prepare_planes(dev, state); 1011 if (ret) 1012 return ret; 1013 1014 /* 1015 * This is the point of no return - everything below never fails except 1016 * when the hw goes bonghits. Which means we can commit the new state on 1017 * the software side now. 1018 */ 1019 1020 drm_atomic_helper_swap_state(dev, state); 1021 1022 /* 1023 * Everything below can be run asynchronously without the need to grab 1024 * any modeset locks at all under one condition: It must be guaranteed 1025 * that the asynchronous work has either been cancelled (if the driver 1026 * supports it, which at least requires that the framebuffers get 1027 * cleaned up with drm_atomic_helper_cleanup_planes()) or completed 1028 * before the new state gets committed on the software side with 1029 * drm_atomic_helper_swap_state(). 1030 * 1031 * This scheme allows new atomic state updates to be prepared and 1032 * checked in parallel to the asynchronous completion of the previous 1033 * update. Which is important since compositors need to figure out the 1034 * composition of the next frame right after having submitted the 1035 * current layout. 1036 */ 1037 1038 wait_for_fences(dev, state); 1039 1040 drm_atomic_helper_commit_modeset_disables(dev, state); 1041 1042 drm_atomic_helper_commit_planes(dev, state); 1043 1044 drm_atomic_helper_commit_modeset_enables(dev, state); 1045 1046 drm_atomic_helper_wait_for_vblanks(dev, state); 1047 1048 drm_atomic_helper_cleanup_planes(dev, state); 1049 1050 drm_atomic_state_free(state); 1051 1052 return 0; 1053 } 1054 EXPORT_SYMBOL(drm_atomic_helper_commit); 1055 1056 /** 1057 * DOC: implementing async commit 1058 * 1059 * For now the atomic helpers don't support async commit directly. If there is 1060 * real need it could be added though, using the dma-buf fence infrastructure 1061 * for generic synchronization with outstanding rendering. 1062 * 1063 * For now drivers have to implement async commit themselves, with the following 1064 * sequence being the recommended one: 1065 * 1066 * 1. Run drm_atomic_helper_prepare_planes() first. This is the only function 1067 * which commit needs to call which can fail, so we want to run it first and 1068 * synchronously. 1069 * 1070 * 2. Synchronize with any outstanding asynchronous commit worker threads which 1071 * might be affected the new state update. This can be done by either cancelling 1072 * or flushing the work items, depending upon whether the driver can deal with 1073 * cancelled updates. Note that it is important to ensure that the framebuffer 1074 * cleanup is still done when cancelling. 1075 * 1076 * For sufficient parallelism it is recommended to have a work item per crtc 1077 * (for updates which don't touch global state) and a global one. Then we only 1078 * need to synchronize with the crtc work items for changed crtcs and the global 1079 * work item, which allows nice concurrent updates on disjoint sets of crtcs. 1080 * 1081 * 3. The software state is updated synchronously with 1082 * drm_atomic_helper_swap_state. Doing this under the protection of all modeset 1083 * locks means concurrent callers never see inconsistent state. And doing this 1084 * while it's guaranteed that no relevant async worker runs means that async 1085 * workers do not need grab any locks. Actually they must not grab locks, for 1086 * otherwise the work flushing will deadlock. 1087 * 1088 * 4. Schedule a work item to do all subsequent steps, using the split-out 1089 * commit helpers: a) pre-plane commit b) plane commit c) post-plane commit and 1090 * then cleaning up the framebuffers after the old framebuffer is no longer 1091 * being displayed. 1092 */ 1093 1094 /** 1095 * drm_atomic_helper_prepare_planes - prepare plane resources before commit 1096 * @dev: DRM device 1097 * @state: atomic state object with new state structures 1098 * 1099 * This function prepares plane state, specifically framebuffers, for the new 1100 * configuration. If any failure is encountered this function will call 1101 * ->cleanup_fb on any already successfully prepared framebuffer. 1102 * 1103 * Returns: 1104 * 0 on success, negative error code on failure. 1105 */ 1106 int drm_atomic_helper_prepare_planes(struct drm_device *dev, 1107 struct drm_atomic_state *state) 1108 { 1109 int nplanes = dev->mode_config.num_total_plane; 1110 int ret, i; 1111 1112 for (i = 0; i < nplanes; i++) { 1113 const struct drm_plane_helper_funcs *funcs; 1114 struct drm_plane *plane = state->planes[i]; 1115 struct drm_plane_state *plane_state = state->plane_states[i]; 1116 struct drm_framebuffer *fb; 1117 1118 if (!plane) 1119 continue; 1120 1121 funcs = plane->helper_private; 1122 1123 fb = plane_state->fb; 1124 1125 if (fb && funcs->prepare_fb) { 1126 ret = funcs->prepare_fb(plane, fb, plane_state); 1127 if (ret) 1128 goto fail; 1129 } 1130 } 1131 1132 return 0; 1133 1134 fail: 1135 for (i--; i >= 0; i--) { 1136 const struct drm_plane_helper_funcs *funcs; 1137 struct drm_plane *plane = state->planes[i]; 1138 struct drm_plane_state *plane_state = state->plane_states[i]; 1139 struct drm_framebuffer *fb; 1140 1141 if (!plane) 1142 continue; 1143 1144 funcs = plane->helper_private; 1145 1146 fb = state->plane_states[i]->fb; 1147 1148 if (fb && funcs->cleanup_fb) 1149 funcs->cleanup_fb(plane, fb, plane_state); 1150 1151 } 1152 1153 return ret; 1154 } 1155 EXPORT_SYMBOL(drm_atomic_helper_prepare_planes); 1156 1157 /** 1158 * drm_atomic_helper_commit_planes - commit plane state 1159 * @dev: DRM device 1160 * @old_state: atomic state object with old state structures 1161 * 1162 * This function commits the new plane state using the plane and atomic helper 1163 * functions for planes and crtcs. It assumes that the atomic state has already 1164 * been pushed into the relevant object state pointers, since this step can no 1165 * longer fail. 1166 * 1167 * It still requires the global state object @old_state to know which planes and 1168 * crtcs need to be updated though. 1169 * 1170 * Note that this function does all plane updates across all CRTCs in one step. 1171 * If the hardware can't support this approach look at 1172 * drm_atomic_helper_commit_planes_on_crtc() instead. 1173 */ 1174 void drm_atomic_helper_commit_planes(struct drm_device *dev, 1175 struct drm_atomic_state *old_state) 1176 { 1177 struct drm_crtc *crtc; 1178 struct drm_crtc_state *old_crtc_state; 1179 struct drm_plane *plane; 1180 struct drm_plane_state *old_plane_state; 1181 int i; 1182 1183 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 1184 const struct drm_crtc_helper_funcs *funcs; 1185 1186 funcs = crtc->helper_private; 1187 1188 if (!funcs || !funcs->atomic_begin) 1189 continue; 1190 1191 funcs->atomic_begin(crtc, old_crtc_state); 1192 } 1193 1194 for_each_plane_in_state(old_state, plane, old_plane_state, i) { 1195 const struct drm_plane_helper_funcs *funcs; 1196 1197 funcs = plane->helper_private; 1198 1199 if (!funcs) 1200 continue; 1201 1202 /* 1203 * Special-case disabling the plane if drivers support it. 1204 */ 1205 if (drm_atomic_plane_disabling(plane, old_plane_state) && 1206 funcs->atomic_disable) 1207 funcs->atomic_disable(plane, old_plane_state); 1208 else if (plane->state->crtc || 1209 drm_atomic_plane_disabling(plane, old_plane_state)) 1210 funcs->atomic_update(plane, old_plane_state); 1211 } 1212 1213 for_each_crtc_in_state(old_state, crtc, old_crtc_state, i) { 1214 const struct drm_crtc_helper_funcs *funcs; 1215 1216 funcs = crtc->helper_private; 1217 1218 if (!funcs || !funcs->atomic_flush) 1219 continue; 1220 1221 funcs->atomic_flush(crtc, old_crtc_state); 1222 } 1223 } 1224 EXPORT_SYMBOL(drm_atomic_helper_commit_planes); 1225 1226 /** 1227 * drm_atomic_helper_commit_planes_on_crtc - commit plane state for a crtc 1228 * @old_crtc_state: atomic state object with the old crtc state 1229 * 1230 * This function commits the new plane state using the plane and atomic helper 1231 * functions for planes on the specific crtc. It assumes that the atomic state 1232 * has already been pushed into the relevant object state pointers, since this 1233 * step can no longer fail. 1234 * 1235 * This function is useful when plane updates should be done crtc-by-crtc 1236 * instead of one global step like drm_atomic_helper_commit_planes() does. 1237 * 1238 * This function can only be savely used when planes are not allowed to move 1239 * between different CRTCs because this function doesn't handle inter-CRTC 1240 * depencies. Callers need to ensure that either no such depencies exist, 1241 * resolve them through ordering of commit calls or through some other means. 1242 */ 1243 void 1244 drm_atomic_helper_commit_planes_on_crtc(struct drm_crtc_state *old_crtc_state) 1245 { 1246 const struct drm_crtc_helper_funcs *crtc_funcs; 1247 struct drm_crtc *crtc = old_crtc_state->crtc; 1248 struct drm_atomic_state *old_state = old_crtc_state->state; 1249 struct drm_plane *plane; 1250 unsigned plane_mask; 1251 1252 plane_mask = old_crtc_state->plane_mask; 1253 plane_mask |= crtc->state->plane_mask; 1254 1255 crtc_funcs = crtc->helper_private; 1256 if (crtc_funcs && crtc_funcs->atomic_begin) 1257 crtc_funcs->atomic_begin(crtc, old_crtc_state); 1258 1259 drm_for_each_plane_mask(plane, crtc->dev, plane_mask) { 1260 struct drm_plane_state *old_plane_state = 1261 drm_atomic_get_existing_plane_state(old_state, plane); 1262 const struct drm_plane_helper_funcs *plane_funcs; 1263 1264 plane_funcs = plane->helper_private; 1265 1266 if (!old_plane_state || !plane_funcs) 1267 continue; 1268 1269 WARN_ON(plane->state->crtc && plane->state->crtc != crtc); 1270 1271 if (drm_atomic_plane_disabling(plane, old_plane_state) && 1272 plane_funcs->atomic_disable) 1273 plane_funcs->atomic_disable(plane, old_plane_state); 1274 else if (plane->state->crtc || 1275 drm_atomic_plane_disabling(plane, old_plane_state)) 1276 plane_funcs->atomic_update(plane, old_plane_state); 1277 } 1278 1279 if (crtc_funcs && crtc_funcs->atomic_flush) 1280 crtc_funcs->atomic_flush(crtc, old_crtc_state); 1281 } 1282 EXPORT_SYMBOL(drm_atomic_helper_commit_planes_on_crtc); 1283 1284 /** 1285 * drm_atomic_helper_cleanup_planes - cleanup plane resources after commit 1286 * @dev: DRM device 1287 * @old_state: atomic state object with old state structures 1288 * 1289 * This function cleans up plane state, specifically framebuffers, from the old 1290 * configuration. Hence the old configuration must be perserved in @old_state to 1291 * be able to call this function. 1292 * 1293 * This function must also be called on the new state when the atomic update 1294 * fails at any point after calling drm_atomic_helper_prepare_planes(). 1295 */ 1296 void drm_atomic_helper_cleanup_planes(struct drm_device *dev, 1297 struct drm_atomic_state *old_state) 1298 { 1299 struct drm_plane *plane; 1300 struct drm_plane_state *plane_state; 1301 int i; 1302 1303 for_each_plane_in_state(old_state, plane, plane_state, i) { 1304 const struct drm_plane_helper_funcs *funcs; 1305 struct drm_framebuffer *old_fb; 1306 1307 funcs = plane->helper_private; 1308 1309 old_fb = plane_state->fb; 1310 1311 if (old_fb && funcs->cleanup_fb) 1312 funcs->cleanup_fb(plane, old_fb, plane_state); 1313 } 1314 } 1315 EXPORT_SYMBOL(drm_atomic_helper_cleanup_planes); 1316 1317 /** 1318 * drm_atomic_helper_swap_state - store atomic state into current sw state 1319 * @dev: DRM device 1320 * @state: atomic state 1321 * 1322 * This function stores the atomic state into the current state pointers in all 1323 * driver objects. It should be called after all failing steps have been done 1324 * and succeeded, but before the actual hardware state is committed. 1325 * 1326 * For cleanup and error recovery the current state for all changed objects will 1327 * be swaped into @state. 1328 * 1329 * With that sequence it fits perfectly into the plane prepare/cleanup sequence: 1330 * 1331 * 1. Call drm_atomic_helper_prepare_planes() with the staged atomic state. 1332 * 1333 * 2. Do any other steps that might fail. 1334 * 1335 * 3. Put the staged state into the current state pointers with this function. 1336 * 1337 * 4. Actually commit the hardware state. 1338 * 1339 * 5. Call drm_atomic_helper_cleanup_planes with @state, which since step 3 1340 * contains the old state. Also do any other cleanup required with that state. 1341 */ 1342 void drm_atomic_helper_swap_state(struct drm_device *dev, 1343 struct drm_atomic_state *state) 1344 { 1345 int i; 1346 1347 for (i = 0; i < dev->mode_config.num_connector; i++) { 1348 struct drm_connector *connector = state->connectors[i]; 1349 1350 if (!connector) 1351 continue; 1352 1353 connector->state->state = state; 1354 swap(state->connector_states[i], connector->state); 1355 connector->state->state = NULL; 1356 } 1357 1358 for (i = 0; i < dev->mode_config.num_crtc; i++) { 1359 struct drm_crtc *crtc = state->crtcs[i]; 1360 1361 if (!crtc) 1362 continue; 1363 1364 crtc->state->state = state; 1365 swap(state->crtc_states[i], crtc->state); 1366 crtc->state->state = NULL; 1367 } 1368 1369 for (i = 0; i < dev->mode_config.num_total_plane; i++) { 1370 struct drm_plane *plane = state->planes[i]; 1371 1372 if (!plane) 1373 continue; 1374 1375 plane->state->state = state; 1376 swap(state->plane_states[i], plane->state); 1377 plane->state->state = NULL; 1378 } 1379 } 1380 EXPORT_SYMBOL(drm_atomic_helper_swap_state); 1381 1382 /** 1383 * drm_atomic_helper_update_plane - Helper for primary plane update using atomic 1384 * @plane: plane object to update 1385 * @crtc: owning CRTC of owning plane 1386 * @fb: framebuffer to flip onto plane 1387 * @crtc_x: x offset of primary plane on crtc 1388 * @crtc_y: y offset of primary plane on crtc 1389 * @crtc_w: width of primary plane rectangle on crtc 1390 * @crtc_h: height of primary plane rectangle on crtc 1391 * @src_x: x offset of @fb for panning 1392 * @src_y: y offset of @fb for panning 1393 * @src_w: width of source rectangle in @fb 1394 * @src_h: height of source rectangle in @fb 1395 * 1396 * Provides a default plane update handler using the atomic driver interface. 1397 * 1398 * RETURNS: 1399 * Zero on success, error code on failure 1400 */ 1401 int drm_atomic_helper_update_plane(struct drm_plane *plane, 1402 struct drm_crtc *crtc, 1403 struct drm_framebuffer *fb, 1404 int crtc_x, int crtc_y, 1405 unsigned int crtc_w, unsigned int crtc_h, 1406 uint32_t src_x, uint32_t src_y, 1407 uint32_t src_w, uint32_t src_h) 1408 { 1409 struct drm_atomic_state *state; 1410 struct drm_plane_state *plane_state; 1411 int ret = 0; 1412 1413 state = drm_atomic_state_alloc(plane->dev); 1414 if (!state) 1415 return -ENOMEM; 1416 1417 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 1418 retry: 1419 plane_state = drm_atomic_get_plane_state(state, plane); 1420 if (IS_ERR(plane_state)) { 1421 ret = PTR_ERR(plane_state); 1422 goto fail; 1423 } 1424 1425 ret = drm_atomic_set_crtc_for_plane(plane_state, crtc); 1426 if (ret != 0) 1427 goto fail; 1428 drm_atomic_set_fb_for_plane(plane_state, fb); 1429 plane_state->crtc_x = crtc_x; 1430 plane_state->crtc_y = crtc_y; 1431 plane_state->crtc_h = crtc_h; 1432 plane_state->crtc_w = crtc_w; 1433 plane_state->src_x = src_x; 1434 plane_state->src_y = src_y; 1435 plane_state->src_h = src_h; 1436 plane_state->src_w = src_w; 1437 1438 if (plane == crtc->cursor) 1439 state->legacy_cursor_update = true; 1440 1441 ret = drm_atomic_commit(state); 1442 if (ret != 0) 1443 goto fail; 1444 1445 /* Driver takes ownership of state on successful commit. */ 1446 return 0; 1447 fail: 1448 if (ret == -EDEADLK) 1449 goto backoff; 1450 1451 drm_atomic_state_free(state); 1452 1453 return ret; 1454 backoff: 1455 drm_atomic_state_clear(state); 1456 drm_atomic_legacy_backoff(state); 1457 1458 /* 1459 * Someone might have exchanged the framebuffer while we dropped locks 1460 * in the backoff code. We need to fix up the fb refcount tracking the 1461 * core does for us. 1462 */ 1463 plane->old_fb = plane->fb; 1464 1465 goto retry; 1466 } 1467 EXPORT_SYMBOL(drm_atomic_helper_update_plane); 1468 1469 /** 1470 * drm_atomic_helper_disable_plane - Helper for primary plane disable using * atomic 1471 * @plane: plane to disable 1472 * 1473 * Provides a default plane disable handler using the atomic driver interface. 1474 * 1475 * RETURNS: 1476 * Zero on success, error code on failure 1477 */ 1478 int drm_atomic_helper_disable_plane(struct drm_plane *plane) 1479 { 1480 struct drm_atomic_state *state; 1481 struct drm_plane_state *plane_state; 1482 int ret = 0; 1483 1484 /* 1485 * FIXME: Without plane->crtc set we can't get at the implicit legacy 1486 * acquire context. The real fix will be to wire the acquire ctx through 1487 * everywhere we need it, but meanwhile prevent chaos by just skipping 1488 * this noop. The critical case is the cursor ioctls which a) only grab 1489 * crtc/cursor-plane locks (so we need the crtc to get at the right 1490 * acquire context) and b) can try to disable the plane multiple times. 1491 */ 1492 if (!plane->crtc) 1493 return 0; 1494 1495 state = drm_atomic_state_alloc(plane->dev); 1496 if (!state) 1497 return -ENOMEM; 1498 1499 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(plane->crtc); 1500 retry: 1501 plane_state = drm_atomic_get_plane_state(state, plane); 1502 if (IS_ERR(plane_state)) { 1503 ret = PTR_ERR(plane_state); 1504 goto fail; 1505 } 1506 1507 ret = drm_atomic_set_crtc_for_plane(plane_state, NULL); 1508 if (ret != 0) 1509 goto fail; 1510 drm_atomic_set_fb_for_plane(plane_state, NULL); 1511 plane_state->crtc_x = 0; 1512 plane_state->crtc_y = 0; 1513 plane_state->crtc_h = 0; 1514 plane_state->crtc_w = 0; 1515 plane_state->src_x = 0; 1516 plane_state->src_y = 0; 1517 plane_state->src_h = 0; 1518 plane_state->src_w = 0; 1519 1520 if (plane == plane->crtc->cursor) 1521 state->legacy_cursor_update = true; 1522 1523 ret = drm_atomic_commit(state); 1524 if (ret != 0) 1525 goto fail; 1526 1527 /* Driver takes ownership of state on successful commit. */ 1528 return 0; 1529 fail: 1530 if (ret == -EDEADLK) 1531 goto backoff; 1532 1533 drm_atomic_state_free(state); 1534 1535 return ret; 1536 backoff: 1537 drm_atomic_state_clear(state); 1538 drm_atomic_legacy_backoff(state); 1539 1540 /* 1541 * Someone might have exchanged the framebuffer while we dropped locks 1542 * in the backoff code. We need to fix up the fb refcount tracking the 1543 * core does for us. 1544 */ 1545 plane->old_fb = plane->fb; 1546 1547 goto retry; 1548 } 1549 EXPORT_SYMBOL(drm_atomic_helper_disable_plane); 1550 1551 static int update_output_state(struct drm_atomic_state *state, 1552 struct drm_mode_set *set) 1553 { 1554 struct drm_device *dev = set->crtc->dev; 1555 struct drm_crtc *crtc; 1556 struct drm_crtc_state *crtc_state; 1557 struct drm_connector *connector; 1558 struct drm_connector_state *conn_state; 1559 int ret, i, j; 1560 1561 ret = drm_modeset_lock(&dev->mode_config.connection_mutex, 1562 state->acquire_ctx); 1563 if (ret) 1564 return ret; 1565 1566 /* First grab all affected connector/crtc states. */ 1567 for (i = 0; i < set->num_connectors; i++) { 1568 conn_state = drm_atomic_get_connector_state(state, 1569 set->connectors[i]); 1570 if (IS_ERR(conn_state)) 1571 return PTR_ERR(conn_state); 1572 } 1573 1574 for_each_crtc_in_state(state, crtc, crtc_state, i) { 1575 ret = drm_atomic_add_affected_connectors(state, crtc); 1576 if (ret) 1577 return ret; 1578 } 1579 1580 /* Then recompute connector->crtc links and crtc enabling state. */ 1581 for_each_connector_in_state(state, connector, conn_state, i) { 1582 if (conn_state->crtc == set->crtc) { 1583 ret = drm_atomic_set_crtc_for_connector(conn_state, 1584 NULL); 1585 if (ret) 1586 return ret; 1587 } 1588 1589 for (j = 0; j < set->num_connectors; j++) { 1590 if (set->connectors[j] == connector) { 1591 ret = drm_atomic_set_crtc_for_connector(conn_state, 1592 set->crtc); 1593 if (ret) 1594 return ret; 1595 break; 1596 } 1597 } 1598 } 1599 1600 for_each_crtc_in_state(state, crtc, crtc_state, i) { 1601 /* Don't update ->enable for the CRTC in the set_config request, 1602 * since a mismatch would indicate a bug in the upper layers. 1603 * The actual modeset code later on will catch any 1604 * inconsistencies here. */ 1605 if (crtc == set->crtc) 1606 continue; 1607 1608 if (!drm_atomic_connectors_for_crtc(state, crtc)) { 1609 ret = drm_atomic_set_mode_prop_for_crtc(crtc_state, 1610 NULL); 1611 if (ret < 0) 1612 return ret; 1613 1614 crtc_state->active = false; 1615 } 1616 } 1617 1618 return 0; 1619 } 1620 1621 /** 1622 * drm_atomic_helper_set_config - set a new config from userspace 1623 * @set: mode set configuration 1624 * 1625 * Provides a default crtc set_config handler using the atomic driver interface. 1626 * 1627 * Returns: 1628 * Returns 0 on success, negative errno numbers on failure. 1629 */ 1630 int drm_atomic_helper_set_config(struct drm_mode_set *set) 1631 { 1632 struct drm_atomic_state *state; 1633 struct drm_crtc *crtc = set->crtc; 1634 struct drm_crtc_state *crtc_state; 1635 struct drm_plane_state *primary_state; 1636 int ret = 0; 1637 1638 state = drm_atomic_state_alloc(crtc->dev); 1639 if (!state) 1640 return -ENOMEM; 1641 1642 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 1643 retry: 1644 crtc_state = drm_atomic_get_crtc_state(state, crtc); 1645 if (IS_ERR(crtc_state)) { 1646 ret = PTR_ERR(crtc_state); 1647 goto fail; 1648 } 1649 1650 primary_state = drm_atomic_get_plane_state(state, crtc->primary); 1651 if (IS_ERR(primary_state)) { 1652 ret = PTR_ERR(primary_state); 1653 goto fail; 1654 } 1655 1656 if (!set->mode) { 1657 WARN_ON(set->fb); 1658 WARN_ON(set->num_connectors); 1659 1660 ret = drm_atomic_set_mode_for_crtc(crtc_state, NULL); 1661 if (ret != 0) 1662 goto fail; 1663 1664 crtc_state->active = false; 1665 1666 ret = drm_atomic_set_crtc_for_plane(primary_state, NULL); 1667 if (ret != 0) 1668 goto fail; 1669 1670 drm_atomic_set_fb_for_plane(primary_state, NULL); 1671 1672 goto commit; 1673 } 1674 1675 WARN_ON(!set->fb); 1676 WARN_ON(!set->num_connectors); 1677 1678 ret = drm_atomic_set_mode_for_crtc(crtc_state, set->mode); 1679 if (ret != 0) 1680 goto fail; 1681 1682 crtc_state->active = true; 1683 1684 ret = drm_atomic_set_crtc_for_plane(primary_state, crtc); 1685 if (ret != 0) 1686 goto fail; 1687 drm_atomic_set_fb_for_plane(primary_state, set->fb); 1688 primary_state->crtc_x = 0; 1689 primary_state->crtc_y = 0; 1690 primary_state->crtc_h = set->mode->vdisplay; 1691 primary_state->crtc_w = set->mode->hdisplay; 1692 primary_state->src_x = set->x << 16; 1693 primary_state->src_y = set->y << 16; 1694 primary_state->src_h = set->mode->vdisplay << 16; 1695 primary_state->src_w = set->mode->hdisplay << 16; 1696 1697 commit: 1698 ret = update_output_state(state, set); 1699 if (ret) 1700 goto fail; 1701 1702 ret = drm_atomic_commit(state); 1703 if (ret != 0) 1704 goto fail; 1705 1706 /* Driver takes ownership of state on successful commit. */ 1707 return 0; 1708 fail: 1709 if (ret == -EDEADLK) 1710 goto backoff; 1711 1712 drm_atomic_state_free(state); 1713 1714 return ret; 1715 backoff: 1716 drm_atomic_state_clear(state); 1717 drm_atomic_legacy_backoff(state); 1718 1719 /* 1720 * Someone might have exchanged the framebuffer while we dropped locks 1721 * in the backoff code. We need to fix up the fb refcount tracking the 1722 * core does for us. 1723 */ 1724 crtc->primary->old_fb = crtc->primary->fb; 1725 1726 goto retry; 1727 } 1728 EXPORT_SYMBOL(drm_atomic_helper_set_config); 1729 1730 /** 1731 * drm_atomic_helper_crtc_set_property - helper for crtc properties 1732 * @crtc: DRM crtc 1733 * @property: DRM property 1734 * @val: value of property 1735 * 1736 * Provides a default crtc set_property handler using the atomic driver 1737 * interface. 1738 * 1739 * RETURNS: 1740 * Zero on success, error code on failure 1741 */ 1742 int 1743 drm_atomic_helper_crtc_set_property(struct drm_crtc *crtc, 1744 struct drm_property *property, 1745 uint64_t val) 1746 { 1747 struct drm_atomic_state *state; 1748 struct drm_crtc_state *crtc_state; 1749 int ret = 0; 1750 1751 state = drm_atomic_state_alloc(crtc->dev); 1752 if (!state) 1753 return -ENOMEM; 1754 1755 /* ->set_property is always called with all locks held. */ 1756 state->acquire_ctx = crtc->dev->mode_config.acquire_ctx; 1757 retry: 1758 crtc_state = drm_atomic_get_crtc_state(state, crtc); 1759 if (IS_ERR(crtc_state)) { 1760 ret = PTR_ERR(crtc_state); 1761 goto fail; 1762 } 1763 1764 ret = drm_atomic_crtc_set_property(crtc, crtc_state, 1765 property, val); 1766 if (ret) 1767 goto fail; 1768 1769 ret = drm_atomic_commit(state); 1770 if (ret != 0) 1771 goto fail; 1772 1773 /* Driver takes ownership of state on successful commit. */ 1774 return 0; 1775 fail: 1776 if (ret == -EDEADLK) 1777 goto backoff; 1778 1779 drm_atomic_state_free(state); 1780 1781 return ret; 1782 backoff: 1783 drm_atomic_state_clear(state); 1784 drm_atomic_legacy_backoff(state); 1785 1786 goto retry; 1787 } 1788 EXPORT_SYMBOL(drm_atomic_helper_crtc_set_property); 1789 1790 /** 1791 * drm_atomic_helper_plane_set_property - helper for plane properties 1792 * @plane: DRM plane 1793 * @property: DRM property 1794 * @val: value of property 1795 * 1796 * Provides a default plane set_property handler using the atomic driver 1797 * interface. 1798 * 1799 * RETURNS: 1800 * Zero on success, error code on failure 1801 */ 1802 int 1803 drm_atomic_helper_plane_set_property(struct drm_plane *plane, 1804 struct drm_property *property, 1805 uint64_t val) 1806 { 1807 struct drm_atomic_state *state; 1808 struct drm_plane_state *plane_state; 1809 int ret = 0; 1810 1811 state = drm_atomic_state_alloc(plane->dev); 1812 if (!state) 1813 return -ENOMEM; 1814 1815 /* ->set_property is always called with all locks held. */ 1816 state->acquire_ctx = plane->dev->mode_config.acquire_ctx; 1817 retry: 1818 plane_state = drm_atomic_get_plane_state(state, plane); 1819 if (IS_ERR(plane_state)) { 1820 ret = PTR_ERR(plane_state); 1821 goto fail; 1822 } 1823 1824 ret = drm_atomic_plane_set_property(plane, plane_state, 1825 property, val); 1826 if (ret) 1827 goto fail; 1828 1829 ret = drm_atomic_commit(state); 1830 if (ret != 0) 1831 goto fail; 1832 1833 /* Driver takes ownership of state on successful commit. */ 1834 return 0; 1835 fail: 1836 if (ret == -EDEADLK) 1837 goto backoff; 1838 1839 drm_atomic_state_free(state); 1840 1841 return ret; 1842 backoff: 1843 drm_atomic_state_clear(state); 1844 drm_atomic_legacy_backoff(state); 1845 1846 goto retry; 1847 } 1848 EXPORT_SYMBOL(drm_atomic_helper_plane_set_property); 1849 1850 /** 1851 * drm_atomic_helper_connector_set_property - helper for connector properties 1852 * @connector: DRM connector 1853 * @property: DRM property 1854 * @val: value of property 1855 * 1856 * Provides a default connector set_property handler using the atomic driver 1857 * interface. 1858 * 1859 * RETURNS: 1860 * Zero on success, error code on failure 1861 */ 1862 int 1863 drm_atomic_helper_connector_set_property(struct drm_connector *connector, 1864 struct drm_property *property, 1865 uint64_t val) 1866 { 1867 struct drm_atomic_state *state; 1868 struct drm_connector_state *connector_state; 1869 int ret = 0; 1870 1871 state = drm_atomic_state_alloc(connector->dev); 1872 if (!state) 1873 return -ENOMEM; 1874 1875 /* ->set_property is always called with all locks held. */ 1876 state->acquire_ctx = connector->dev->mode_config.acquire_ctx; 1877 retry: 1878 connector_state = drm_atomic_get_connector_state(state, connector); 1879 if (IS_ERR(connector_state)) { 1880 ret = PTR_ERR(connector_state); 1881 goto fail; 1882 } 1883 1884 ret = drm_atomic_connector_set_property(connector, connector_state, 1885 property, val); 1886 if (ret) 1887 goto fail; 1888 1889 ret = drm_atomic_commit(state); 1890 if (ret != 0) 1891 goto fail; 1892 1893 /* Driver takes ownership of state on successful commit. */ 1894 return 0; 1895 fail: 1896 if (ret == -EDEADLK) 1897 goto backoff; 1898 1899 drm_atomic_state_free(state); 1900 1901 return ret; 1902 backoff: 1903 drm_atomic_state_clear(state); 1904 drm_atomic_legacy_backoff(state); 1905 1906 goto retry; 1907 } 1908 EXPORT_SYMBOL(drm_atomic_helper_connector_set_property); 1909 1910 /** 1911 * drm_atomic_helper_page_flip - execute a legacy page flip 1912 * @crtc: DRM crtc 1913 * @fb: DRM framebuffer 1914 * @event: optional DRM event to signal upon completion 1915 * @flags: flip flags for non-vblank sync'ed updates 1916 * 1917 * Provides a default page flip implementation using the atomic driver interface. 1918 * 1919 * Note that for now so called async page flips (i.e. updates which are not 1920 * synchronized to vblank) are not supported, since the atomic interfaces have 1921 * no provisions for this yet. 1922 * 1923 * Returns: 1924 * Returns 0 on success, negative errno numbers on failure. 1925 */ 1926 int drm_atomic_helper_page_flip(struct drm_crtc *crtc, 1927 struct drm_framebuffer *fb, 1928 struct drm_pending_vblank_event *event, 1929 uint32_t flags) 1930 { 1931 struct drm_plane *plane = crtc->primary; 1932 struct drm_atomic_state *state; 1933 struct drm_plane_state *plane_state; 1934 struct drm_crtc_state *crtc_state; 1935 int ret = 0; 1936 1937 if (flags & DRM_MODE_PAGE_FLIP_ASYNC) 1938 return -EINVAL; 1939 1940 state = drm_atomic_state_alloc(plane->dev); 1941 if (!state) 1942 return -ENOMEM; 1943 1944 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 1945 retry: 1946 crtc_state = drm_atomic_get_crtc_state(state, crtc); 1947 if (IS_ERR(crtc_state)) { 1948 ret = PTR_ERR(crtc_state); 1949 goto fail; 1950 } 1951 crtc_state->event = event; 1952 1953 plane_state = drm_atomic_get_plane_state(state, plane); 1954 if (IS_ERR(plane_state)) { 1955 ret = PTR_ERR(plane_state); 1956 goto fail; 1957 } 1958 1959 ret = drm_atomic_set_crtc_for_plane(plane_state, crtc); 1960 if (ret != 0) 1961 goto fail; 1962 drm_atomic_set_fb_for_plane(plane_state, fb); 1963 1964 ret = drm_atomic_async_commit(state); 1965 if (ret != 0) 1966 goto fail; 1967 1968 /* Driver takes ownership of state on successful async commit. */ 1969 return 0; 1970 fail: 1971 if (ret == -EDEADLK) 1972 goto backoff; 1973 1974 drm_atomic_state_free(state); 1975 1976 return ret; 1977 backoff: 1978 drm_atomic_state_clear(state); 1979 drm_atomic_legacy_backoff(state); 1980 1981 /* 1982 * Someone might have exchanged the framebuffer while we dropped locks 1983 * in the backoff code. We need to fix up the fb refcount tracking the 1984 * core does for us. 1985 */ 1986 plane->old_fb = plane->fb; 1987 1988 goto retry; 1989 } 1990 EXPORT_SYMBOL(drm_atomic_helper_page_flip); 1991 1992 /** 1993 * drm_atomic_helper_connector_dpms() - connector dpms helper implementation 1994 * @connector: affected connector 1995 * @mode: DPMS mode 1996 * 1997 * This is the main helper function provided by the atomic helper framework for 1998 * implementing the legacy DPMS connector interface. It computes the new desired 1999 * ->active state for the corresponding CRTC (if the connector is enabled) and 2000 * updates it. 2001 * 2002 * Returns: 2003 * Returns 0 on success, negative errno numbers on failure. 2004 */ 2005 int drm_atomic_helper_connector_dpms(struct drm_connector *connector, 2006 int mode) 2007 { 2008 struct drm_mode_config *config = &connector->dev->mode_config; 2009 struct drm_atomic_state *state; 2010 struct drm_crtc_state *crtc_state; 2011 struct drm_crtc *crtc; 2012 struct drm_connector *tmp_connector; 2013 int ret; 2014 bool active = false; 2015 int old_mode = connector->dpms; 2016 2017 if (mode != DRM_MODE_DPMS_ON) 2018 mode = DRM_MODE_DPMS_OFF; 2019 2020 connector->dpms = mode; 2021 crtc = connector->state->crtc; 2022 2023 if (!crtc) 2024 return 0; 2025 2026 state = drm_atomic_state_alloc(connector->dev); 2027 if (!state) 2028 return -ENOMEM; 2029 2030 state->acquire_ctx = drm_modeset_legacy_acquire_ctx(crtc); 2031 retry: 2032 crtc_state = drm_atomic_get_crtc_state(state, crtc); 2033 if (IS_ERR(crtc_state)) { 2034 ret = PTR_ERR(crtc_state); 2035 goto fail; 2036 } 2037 2038 WARN_ON(!drm_modeset_is_locked(&config->connection_mutex)); 2039 2040 drm_for_each_connector(tmp_connector, connector->dev) { 2041 if (tmp_connector->state->crtc != crtc) 2042 continue; 2043 2044 if (tmp_connector->dpms == DRM_MODE_DPMS_ON) { 2045 active = true; 2046 break; 2047 } 2048 } 2049 crtc_state->active = active; 2050 2051 ret = drm_atomic_commit(state); 2052 if (ret != 0) 2053 goto fail; 2054 2055 /* Driver takes ownership of state on successful commit. */ 2056 return 0; 2057 fail: 2058 if (ret == -EDEADLK) 2059 goto backoff; 2060 2061 connector->dpms = old_mode; 2062 drm_atomic_state_free(state); 2063 2064 return ret; 2065 backoff: 2066 drm_atomic_state_clear(state); 2067 drm_atomic_legacy_backoff(state); 2068 2069 goto retry; 2070 } 2071 EXPORT_SYMBOL(drm_atomic_helper_connector_dpms); 2072 2073 /** 2074 * DOC: atomic state reset and initialization 2075 * 2076 * Both the drm core and the atomic helpers assume that there is always the full 2077 * and correct atomic software state for all connectors, CRTCs and planes 2078 * available. Which is a bit a problem on driver load and also after system 2079 * suspend. One way to solve this is to have a hardware state read-out 2080 * infrastructure which reconstructs the full software state (e.g. the i915 2081 * driver). 2082 * 2083 * The simpler solution is to just reset the software state to everything off, 2084 * which is easiest to do by calling drm_mode_config_reset(). To facilitate this 2085 * the atomic helpers provide default reset implementations for all hooks. 2086 */ 2087 2088 /** 2089 * drm_atomic_helper_crtc_reset - default ->reset hook for CRTCs 2090 * @crtc: drm CRTC 2091 * 2092 * Resets the atomic state for @crtc by freeing the state pointer (which might 2093 * be NULL, e.g. at driver load time) and allocating a new empty state object. 2094 */ 2095 void drm_atomic_helper_crtc_reset(struct drm_crtc *crtc) 2096 { 2097 if (crtc->state && crtc->state->mode_blob) 2098 drm_property_unreference_blob(crtc->state->mode_blob); 2099 kfree(crtc->state); 2100 crtc->state = kzalloc(sizeof(*crtc->state), GFP_KERNEL); 2101 2102 if (crtc->state) 2103 crtc->state->crtc = crtc; 2104 } 2105 EXPORT_SYMBOL(drm_atomic_helper_crtc_reset); 2106 2107 /** 2108 * __drm_atomic_helper_crtc_duplicate_state - copy atomic CRTC state 2109 * @crtc: CRTC object 2110 * @state: atomic CRTC state 2111 * 2112 * Copies atomic state from a CRTC's current state and resets inferred values. 2113 * This is useful for drivers that subclass the CRTC state. 2114 */ 2115 void __drm_atomic_helper_crtc_duplicate_state(struct drm_crtc *crtc, 2116 struct drm_crtc_state *state) 2117 { 2118 memcpy(state, crtc->state, sizeof(*state)); 2119 2120 if (state->mode_blob) 2121 drm_property_reference_blob(state->mode_blob); 2122 state->mode_changed = false; 2123 state->active_changed = false; 2124 state->planes_changed = false; 2125 state->connectors_changed = false; 2126 state->event = NULL; 2127 } 2128 EXPORT_SYMBOL(__drm_atomic_helper_crtc_duplicate_state); 2129 2130 /** 2131 * drm_atomic_helper_crtc_duplicate_state - default state duplicate hook 2132 * @crtc: drm CRTC 2133 * 2134 * Default CRTC state duplicate hook for drivers which don't have their own 2135 * subclassed CRTC state structure. 2136 */ 2137 struct drm_crtc_state * 2138 drm_atomic_helper_crtc_duplicate_state(struct drm_crtc *crtc) 2139 { 2140 struct drm_crtc_state *state; 2141 2142 if (WARN_ON(!crtc->state)) 2143 return NULL; 2144 2145 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2146 if (state) 2147 __drm_atomic_helper_crtc_duplicate_state(crtc, state); 2148 2149 return state; 2150 } 2151 EXPORT_SYMBOL(drm_atomic_helper_crtc_duplicate_state); 2152 2153 /** 2154 * __drm_atomic_helper_crtc_destroy_state - release CRTC state 2155 * @crtc: CRTC object 2156 * @state: CRTC state object to release 2157 * 2158 * Releases all resources stored in the CRTC state without actually freeing 2159 * the memory of the CRTC state. This is useful for drivers that subclass the 2160 * CRTC state. 2161 */ 2162 void __drm_atomic_helper_crtc_destroy_state(struct drm_crtc *crtc, 2163 struct drm_crtc_state *state) 2164 { 2165 if (state->mode_blob) 2166 drm_property_unreference_blob(state->mode_blob); 2167 } 2168 EXPORT_SYMBOL(__drm_atomic_helper_crtc_destroy_state); 2169 2170 /** 2171 * drm_atomic_helper_crtc_destroy_state - default state destroy hook 2172 * @crtc: drm CRTC 2173 * @state: CRTC state object to release 2174 * 2175 * Default CRTC state destroy hook for drivers which don't have their own 2176 * subclassed CRTC state structure. 2177 */ 2178 void drm_atomic_helper_crtc_destroy_state(struct drm_crtc *crtc, 2179 struct drm_crtc_state *state) 2180 { 2181 __drm_atomic_helper_crtc_destroy_state(crtc, state); 2182 kfree(state); 2183 } 2184 EXPORT_SYMBOL(drm_atomic_helper_crtc_destroy_state); 2185 2186 /** 2187 * drm_atomic_helper_plane_reset - default ->reset hook for planes 2188 * @plane: drm plane 2189 * 2190 * Resets the atomic state for @plane by freeing the state pointer (which might 2191 * be NULL, e.g. at driver load time) and allocating a new empty state object. 2192 */ 2193 void drm_atomic_helper_plane_reset(struct drm_plane *plane) 2194 { 2195 if (plane->state && plane->state->fb) 2196 drm_framebuffer_unreference(plane->state->fb); 2197 2198 kfree(plane->state); 2199 plane->state = kzalloc(sizeof(*plane->state), GFP_KERNEL); 2200 2201 if (plane->state) 2202 plane->state->plane = plane; 2203 } 2204 EXPORT_SYMBOL(drm_atomic_helper_plane_reset); 2205 2206 /** 2207 * __drm_atomic_helper_plane_duplicate_state - copy atomic plane state 2208 * @plane: plane object 2209 * @state: atomic plane state 2210 * 2211 * Copies atomic state from a plane's current state. This is useful for 2212 * drivers that subclass the plane state. 2213 */ 2214 void __drm_atomic_helper_plane_duplicate_state(struct drm_plane *plane, 2215 struct drm_plane_state *state) 2216 { 2217 memcpy(state, plane->state, sizeof(*state)); 2218 2219 if (state->fb) 2220 drm_framebuffer_reference(state->fb); 2221 } 2222 EXPORT_SYMBOL(__drm_atomic_helper_plane_duplicate_state); 2223 2224 /** 2225 * drm_atomic_helper_plane_duplicate_state - default state duplicate hook 2226 * @plane: drm plane 2227 * 2228 * Default plane state duplicate hook for drivers which don't have their own 2229 * subclassed plane state structure. 2230 */ 2231 struct drm_plane_state * 2232 drm_atomic_helper_plane_duplicate_state(struct drm_plane *plane) 2233 { 2234 struct drm_plane_state *state; 2235 2236 if (WARN_ON(!plane->state)) 2237 return NULL; 2238 2239 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2240 if (state) 2241 __drm_atomic_helper_plane_duplicate_state(plane, state); 2242 2243 return state; 2244 } 2245 EXPORT_SYMBOL(drm_atomic_helper_plane_duplicate_state); 2246 2247 /** 2248 * __drm_atomic_helper_plane_destroy_state - release plane state 2249 * @plane: plane object 2250 * @state: plane state object to release 2251 * 2252 * Releases all resources stored in the plane state without actually freeing 2253 * the memory of the plane state. This is useful for drivers that subclass the 2254 * plane state. 2255 */ 2256 void __drm_atomic_helper_plane_destroy_state(struct drm_plane *plane, 2257 struct drm_plane_state *state) 2258 { 2259 if (state->fb) 2260 drm_framebuffer_unreference(state->fb); 2261 } 2262 EXPORT_SYMBOL(__drm_atomic_helper_plane_destroy_state); 2263 2264 /** 2265 * drm_atomic_helper_plane_destroy_state - default state destroy hook 2266 * @plane: drm plane 2267 * @state: plane state object to release 2268 * 2269 * Default plane state destroy hook for drivers which don't have their own 2270 * subclassed plane state structure. 2271 */ 2272 void drm_atomic_helper_plane_destroy_state(struct drm_plane *plane, 2273 struct drm_plane_state *state) 2274 { 2275 __drm_atomic_helper_plane_destroy_state(plane, state); 2276 kfree(state); 2277 } 2278 EXPORT_SYMBOL(drm_atomic_helper_plane_destroy_state); 2279 2280 /** 2281 * drm_atomic_helper_connector_reset - default ->reset hook for connectors 2282 * @connector: drm connector 2283 * 2284 * Resets the atomic state for @connector by freeing the state pointer (which 2285 * might be NULL, e.g. at driver load time) and allocating a new empty state 2286 * object. 2287 */ 2288 void drm_atomic_helper_connector_reset(struct drm_connector *connector) 2289 { 2290 kfree(connector->state); 2291 connector->state = kzalloc(sizeof(*connector->state), GFP_KERNEL); 2292 2293 if (connector->state) 2294 connector->state->connector = connector; 2295 } 2296 EXPORT_SYMBOL(drm_atomic_helper_connector_reset); 2297 2298 /** 2299 * __drm_atomic_helper_connector_duplicate_state - copy atomic connector state 2300 * @connector: connector object 2301 * @state: atomic connector state 2302 * 2303 * Copies atomic state from a connector's current state. This is useful for 2304 * drivers that subclass the connector state. 2305 */ 2306 void 2307 __drm_atomic_helper_connector_duplicate_state(struct drm_connector *connector, 2308 struct drm_connector_state *state) 2309 { 2310 memcpy(state, connector->state, sizeof(*state)); 2311 } 2312 EXPORT_SYMBOL(__drm_atomic_helper_connector_duplicate_state); 2313 2314 /** 2315 * drm_atomic_helper_connector_duplicate_state - default state duplicate hook 2316 * @connector: drm connector 2317 * 2318 * Default connector state duplicate hook for drivers which don't have their own 2319 * subclassed connector state structure. 2320 */ 2321 struct drm_connector_state * 2322 drm_atomic_helper_connector_duplicate_state(struct drm_connector *connector) 2323 { 2324 struct drm_connector_state *state; 2325 2326 if (WARN_ON(!connector->state)) 2327 return NULL; 2328 2329 state = kmalloc(sizeof(*state), M_DRM, M_WAITOK); 2330 if (state) 2331 __drm_atomic_helper_connector_duplicate_state(connector, state); 2332 2333 return state; 2334 } 2335 EXPORT_SYMBOL(drm_atomic_helper_connector_duplicate_state); 2336 2337 /** 2338 * __drm_atomic_helper_connector_destroy_state - release connector state 2339 * @connector: connector object 2340 * @state: connector state object to release 2341 * 2342 * Releases all resources stored in the connector state without actually 2343 * freeing the memory of the connector state. This is useful for drivers that 2344 * subclass the connector state. 2345 */ 2346 void 2347 __drm_atomic_helper_connector_destroy_state(struct drm_connector *connector, 2348 struct drm_connector_state *state) 2349 { 2350 /* 2351 * This is currently a placeholder so that drivers that subclass the 2352 * state will automatically do the right thing if code is ever added 2353 * to this function. 2354 */ 2355 } 2356 EXPORT_SYMBOL(__drm_atomic_helper_connector_destroy_state); 2357 2358 /** 2359 * drm_atomic_helper_connector_destroy_state - default state destroy hook 2360 * @connector: drm connector 2361 * @state: connector state object to release 2362 * 2363 * Default connector state destroy hook for drivers which don't have their own 2364 * subclassed connector state structure. 2365 */ 2366 void drm_atomic_helper_connector_destroy_state(struct drm_connector *connector, 2367 struct drm_connector_state *state) 2368 { 2369 __drm_atomic_helper_connector_destroy_state(connector, state); 2370 kfree(state); 2371 } 2372 EXPORT_SYMBOL(drm_atomic_helper_connector_destroy_state); 2373