drivers/gpu/drm/vmwgfx/vmwgfx_stdu.c

   1 /******************************************************************************
   2  *
   3  * COPYRIGHT © 2014-2015 VMware, Inc., Palo Alto, CA., USA
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sub license, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  21  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  22  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  23  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  24  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  ******************************************************************************/
  27
  28 #include "vmwgfx_kms.h"
  29 #include "device_include/svga3d_surfacedefs.h"
  30 #include <drm/drm_plane_helper.h>
  31
  32 #define vmw_crtc_to_stdu(x) \
  33         container_of(x, struct vmw_screen_target_display_unit, base.crtc)
  34 #define vmw_encoder_to_stdu(x) \
  35         container_of(x, struct vmw_screen_target_display_unit, base.encoder)
  36 #define vmw_connector_to_stdu(x) \
  37         container_of(x, struct vmw_screen_target_display_unit, base.connector)
  38
  39
  40
  41 enum stdu_content_type {
  42         SAME_AS_DISPLAY = 0,
  43         SEPARATE_SURFACE,
  44         SEPARATE_DMA
  45 };
  46
  47 /**
  48  * struct vmw_stdu_dirty - closure structure for the update functions
  49  *
  50  * @base: The base type we derive from. Used by vmw_kms_helper_dirty().
  51  * @transfer: Transfer direction for DMA command.
  52  * @left: Left side of bounding box.
  53  * @right: Right side of bounding box.
  54  * @top: Top side of bounding box.
  55  * @bottom: Bottom side of bounding box.
  56  * @buf: DMA buffer when DMA-ing between buffer and screen targets.
  57  * @sid: Surface ID when copying between surface and screen targets.
  58  */
  59 struct vmw_stdu_dirty {
  60         struct vmw_kms_dirty base;
  61         SVGA3dTransferType  transfer;
  62         s32 left, right, top, bottom;
  63         u32 pitch;
  64         union {
  65                 struct vmw_dma_buffer *buf;
  66                 u32 sid;
  67         };
  68 };
  69
  70 /*
  71  * SVGA commands that are used by this code. Please see the device headers
  72  * for explanation.
  73  */
  74 struct vmw_stdu_update {
  75         SVGA3dCmdHeader header;
  76         SVGA3dCmdUpdateGBScreenTarget body;
  77 };
  78
  79 struct vmw_stdu_dma {
  80         SVGA3dCmdHeader     header;
  81         SVGA3dCmdSurfaceDMA body;
  82 };
  83
  84 struct vmw_stdu_surface_copy {
  85         SVGA3dCmdHeader      header;
  86         SVGA3dCmdSurfaceCopy body;
  87 };
  88
  89
  90 /**
  91  * struct vmw_screen_target_display_unit
  92  *
  93  * @base: VMW specific DU structure
  94  * @display_srf: surface to be displayed.  The dimension of this will always
  95  *               match the display mode.  If the display mode matches
  96  *               content_vfbs dimensions, then this is a pointer into the
  97  *               corresponding field in content_vfbs.  If not, then this
  98  *               is a separate buffer to which content_vfbs will blit to.
  99  * @content_type:  content_fb type
 100  * @defined:  true if the current display unit has been initialized
 101  */
 102 struct vmw_screen_target_display_unit {
 103         struct vmw_display_unit base;
 104
 105         struct vmw_surface     *display_srf;
 106         enum stdu_content_type content_fb_type;
 107
 108         bool defined;
 109 };
 110
 111
 112
 113 static void vmw_stdu_destroy(struct vmw_screen_target_display_unit *stdu);
 114
 115
 116
 117 /******************************************************************************
 118  * Screen Target Display Unit helper Functions
 119  *****************************************************************************/
 120
 121 /**
 122  * vmw_stdu_unpin_display - unpins the resource associated with display surface
 123  *
 124  * @stdu: contains the display surface
 125  *
 126  * If the display surface was privatedly allocated by
 127  * vmw_surface_gb_priv_define() and not registered as a framebuffer, then it
 128  * won't be automatically cleaned up when all the framebuffers are freed.  As
 129  * such, we have to explicitly call vmw_resource_unreference() to get it freed.
 130  */
 131 static void vmw_stdu_unpin_display(struct vmw_screen_target_display_unit *stdu)
 132 {
 133         if (stdu->display_srf) {
 134                 struct vmw_resource *res = &stdu->display_srf->res;
 135
 136                 vmw_resource_unpin(res);
 137                 vmw_surface_unreference(&stdu->display_srf);
 138         }
 139 }
 140
 141
 142
 143 /******************************************************************************
 144  * Screen Target Display Unit CRTC Functions
 145  *****************************************************************************/
 146
 147
 148 /**
 149  * vmw_stdu_crtc_destroy - cleans up the STDU
 150  *
 151  * @crtc: used to get a reference to the containing STDU
 152  */
 153 static void vmw_stdu_crtc_destroy(struct drm_crtc *crtc)
 154 {
 155         vmw_stdu_destroy(vmw_crtc_to_stdu(crtc));
 156 }
 157
 158 /**
 159  * vmw_stdu_define_st - Defines a Screen Target
 160  *
 161  * @dev_priv:  VMW DRM device
 162  * @stdu: display unit to create a Screen Target for
 163  * @mode: The mode to set.
 164  * @crtc_x: X coordinate of screen target relative to framebuffer origin.
 165  * @crtc_y: Y coordinate of screen target relative to framebuffer origin.
 166  *
 167  * Creates a STDU that we can used later.  This function is called whenever the
 168  * framebuffer size changes.
 169  *
 170  * RETURNs:
 171  * 0 on success, error code on failure
 172  */
 173 static int vmw_stdu_define_st(struct vmw_private *dev_priv,
 174                               struct vmw_screen_target_display_unit *stdu,
 175                               struct drm_display_mode *mode,
 176                               int crtc_x, int crtc_y)
 177 {
 178         struct {
 179                 SVGA3dCmdHeader header;
 180                 SVGA3dCmdDefineGBScreenTarget body;
 181         } *cmd;
 182
 183         cmd = vmw_fifo_reserve(dev_priv, sizeof(*cmd));
 184
 185         if (unlikely(cmd == NULL)) {
 186                 DRM_ERROR("Out of FIFO space defining Screen Target\n");
 187                 return -ENOMEM;
 188         }
 189
 190         cmd->header.id   = SVGA_3D_CMD_DEFINE_GB_SCREENTARGET;
 191         cmd->header.size = sizeof(cmd->body);
 192
 193         cmd->body.stid   = stdu->base.unit;
 194         cmd->body.width  = mode->hdisplay;
 195         cmd->body.height = mode->vdisplay;
 196         cmd->body.flags  = (0 == cmd->body.stid) ? SVGA_STFLAG_PRIMARY : 0;
 197         cmd->body.dpi    = 0;
 198         if (stdu->base.is_implicit) {
 199                 cmd->body.xRoot  = crtc_x;
 200                 cmd->body.yRoot  = crtc_y;
 201         } else {
 202                 cmd->body.xRoot  = stdu->base.gui_x;
 203                 cmd->body.yRoot  = stdu->base.gui_y;
 204         }
 205         stdu->base.set_gui_x = cmd->body.xRoot;
 206         stdu->base.set_gui_y = cmd->body.yRoot;
 207
 208         vmw_fifo_commit(dev_priv, sizeof(*cmd));
 209
 210         stdu->defined = true;
 211
 212         return 0;
 213 }
 214
 215
 216
 217 /**
 218  * vmw_stdu_bind_st - Binds a surface to a Screen Target
 219  *
 220  * @dev_priv: VMW DRM device
 221  * @stdu: display unit affected
 222  * @res: Buffer to bind to the screen target.  Set to NULL to blank screen.
 223  *
 224  * Binding a surface to a Screen Target the same as flipping
 225  */
 226 static int vmw_stdu_bind_st(struct vmw_private *dev_priv,
 227                             struct vmw_screen_target_display_unit *stdu,
 228                             struct vmw_resource *res)
 229 {
 230         SVGA3dSurfaceImageId image;
 231
 232         struct {
 233                 SVGA3dCmdHeader header;
 234                 SVGA3dCmdBindGBScreenTarget body;
 235         } *cmd;
 236
 237
 238         if (!stdu->defined) {
 239                 DRM_ERROR("No screen target defined\n");
 240                 return -EINVAL;
 241         }
 242
 243         /* Set up image using information in vfb */
 244         memset(&image, 0, sizeof(image));
 245         image.sid = res ? res->id : SVGA3D_INVALID_ID;
 246
 247         cmd = vmw_fifo_reserve(dev_priv, sizeof(*cmd));
 248
 249         if (unlikely(cmd == NULL)) {
 250                 DRM_ERROR("Out of FIFO space binding a screen target\n");
 251                 return -ENOMEM;
 252         }
 253
 254         cmd->header.id   = SVGA_3D_CMD_BIND_GB_SCREENTARGET;
 255         cmd->header.size = sizeof(cmd->body);
 256
 257         cmd->body.stid   = stdu->base.unit;
 258         cmd->body.image  = image;
 259
 260         vmw_fifo_commit(dev_priv, sizeof(*cmd));
 261
 262         return 0;
 263 }
 264
 265 /**
 266  * vmw_stdu_populate_update - populate an UPDATE_GB_SCREENTARGET command with a
 267  * bounding box.
 268  *
 269  * @cmd: Pointer to command stream.
 270  * @unit: Screen target unit.
 271  * @left: Left side of bounding box.
 272  * @right: Right side of bounding box.
 273  * @top: Top side of bounding box.
 274  * @bottom: Bottom side of bounding box.
 275  */
 276 static void vmw_stdu_populate_update(void *cmd, int unit,
 277                                      s32 left, s32 right, s32 top, s32 bottom)
 278 {
 279         struct vmw_stdu_update *update = cmd;
 280
 281         update->header.id   = SVGA_3D_CMD_UPDATE_GB_SCREENTARGET;
 282         update->header.size = sizeof(update->body);
 283
 284         update->body.stid   = unit;
 285         update->body.rect.x = left;
 286         update->body.rect.y = top;
 287         update->body.rect.w = right - left;
 288         update->body.rect.h = bottom - top;
 289 }
 290
 291 /**
 292  * vmw_stdu_update_st - Full update of a Screen Target
 293  *
 294  * @dev_priv: VMW DRM device
 295  * @stdu: display unit affected
 296  *
 297  * This function needs to be called whenever the content of a screen
 298  * target has changed completely. Typically as a result of a backing
 299  * surface change.
 300  *
 301  * RETURNS:
 302  * 0 on success, error code on failure
 303  */
 304 static int vmw_stdu_update_st(struct vmw_private *dev_priv,
 305                               struct vmw_screen_target_display_unit *stdu)
 306 {
 307         struct vmw_stdu_update *cmd;
 308         struct drm_crtc *crtc = &stdu->base.crtc;
 309
 310         if (!stdu->defined) {
 311                 DRM_ERROR("No screen target defined");
 312                 return -EINVAL;
 313         }
 314
 315         cmd = vmw_fifo_reserve(dev_priv, sizeof(*cmd));
 316
 317         if (unlikely(cmd == NULL)) {
 318                 DRM_ERROR("Out of FIFO space updating a Screen Target\n");
 319                 return -ENOMEM;
 320         }
 321
 322         vmw_stdu_populate_update(cmd, stdu->base.unit, 0, crtc->mode.hdisplay,
 323                                  0, crtc->mode.vdisplay);
 324
 325         vmw_fifo_commit(dev_priv, sizeof(*cmd));
 326
 327         return 0;
 328 }
 329
 330
 331
 332 /**
 333  * vmw_stdu_destroy_st - Destroy a Screen Target
 334  *
 335  * @dev_priv:  VMW DRM device
 336  * @stdu: display unit to destroy
 337  */
 338 static int vmw_stdu_destroy_st(struct vmw_private *dev_priv,
 339                                struct vmw_screen_target_display_unit *stdu)
 340 {
 341         int    ret;
 342
 343         struct {
 344                 SVGA3dCmdHeader header;
 345                 SVGA3dCmdDestroyGBScreenTarget body;
 346         } *cmd;
 347
 348
 349         /* Nothing to do if not successfully defined */
 350         if (unlikely(!stdu->defined))
 351                 return 0;
 352
 353         cmd = vmw_fifo_reserve(dev_priv, sizeof(*cmd));
 354
 355         if (unlikely(cmd == NULL)) {
 356                 DRM_ERROR("Out of FIFO space, screen target not destroyed\n");
 357                 return -ENOMEM;
 358         }
 359
 360         cmd->header.id   = SVGA_3D_CMD_DESTROY_GB_SCREENTARGET;
 361         cmd->header.size = sizeof(cmd->body);
 362
 363         cmd->body.stid   = stdu->base.unit;
 364
 365         vmw_fifo_commit(dev_priv, sizeof(*cmd));
 366
 367         /* Force sync */
 368         ret = vmw_fallback_wait(dev_priv, false, true, 0, false, 3*HZ);
 369         if (unlikely(ret != 0))
 370                 DRM_ERROR("Failed to sync with HW");
 371
 372         stdu->defined = false;
 373
 374         return ret;
 375 }
 376
 377 /**
 378  * vmw_stdu_bind_fb - Bind an fb to a defined screen target
 379  *
 380  * @dev_priv: Pointer to a device private struct.
 381  * @crtc: The crtc holding the screen target.
 382  * @mode: The mode currently used by the screen target. Must be non-NULL.
 383  * @new_fb: The new framebuffer to bind. Must be non-NULL.
 384  *
 385  * RETURNS:
 386  * 0 on success, error code on failure.
 387  */
 388 static int vmw_stdu_bind_fb(struct vmw_private *dev_priv,
 389                             struct drm_crtc *crtc,
 390                             struct drm_display_mode *mode,
 391                             struct drm_framebuffer *new_fb)
 392 {
 393         struct vmw_screen_target_display_unit *stdu = vmw_crtc_to_stdu(crtc);
 394         struct vmw_framebuffer *vfb = vmw_framebuffer_to_vfb(new_fb);
 395         struct vmw_surface *new_display_srf = NULL;
 396         enum stdu_content_type new_content_type;
 397         struct vmw_framebuffer_surface *new_vfbs;
 398         int ret;
 399
 400         WARN_ON_ONCE(!stdu->defined);
 401
 402         new_vfbs = (vfb->dmabuf) ? NULL : vmw_framebuffer_to_vfbs(new_fb);
 403
 404         if (new_vfbs && new_vfbs->surface->base_size.width == mode->hdisplay &&
 405             new_vfbs->surface->base_size.height == mode->vdisplay)
 406                 new_content_type = SAME_AS_DISPLAY;
 407         else if (vfb->dmabuf)
 408                 new_content_type = SEPARATE_DMA;
 409         else
 410                 new_content_type = SEPARATE_SURFACE;
 411
 412         if (new_content_type != SAME_AS_DISPLAY &&
 413             !stdu->display_srf) {
 414                 struct vmw_surface content_srf;
 415                 struct drm_vmw_size display_base_size = {0};
 416
 417                 display_base_size.width  = mode->hdisplay;
 418                 display_base_size.height = mode->vdisplay;
 419                 display_base_size.depth  = 1;
 420
 421                 /*
 422                  * If content buffer is a DMA buf, then we have to construct
 423                  * surface info
 424                  */
 425                 if (new_content_type == SEPARATE_DMA) {
 426
 427                         switch (new_fb->format->cpp[0] * 8) {
 428                         case 32:
 429                                 content_srf.format = SVGA3D_X8R8G8B8;
 430                                 break;
 431
 432                         case 16:
 433                                 content_srf.format = SVGA3D_R5G6B5;
 434                                 break;
 435
 436                         case 8:
 437                                 content_srf.format = SVGA3D_P8;
 438                                 break;
 439
 440                         default:
 441                                 DRM_ERROR("Invalid format\n");
 442                                 return -EINVAL;
 443                         }
 444
 445                         content_srf.flags             = 0;
 446                         content_srf.mip_levels[0]     = 1;
 447                         content_srf.multisample_count = 0;
 448                 } else {
 449                         content_srf = *new_vfbs->surface;
 450                 }
 451
 452
 453                 ret = vmw_surface_gb_priv_define(crtc->dev,
 454                                 0, /* because kernel visible only */
 455                                 content_srf.flags,
 456                                 content_srf.format,
 457                                 true, /* a scanout buffer */
 458                                 content_srf.mip_levels[0],
 459                                 content_srf.multisample_count,
 460                                 0,
 461                                 display_base_size,
 462                                 &new_display_srf);
 463                 if (unlikely(ret != 0)) {
 464                         DRM_ERROR("Could not allocate screen target surface.\n");
 465                         return ret;
 466                 }
 467         } else if (new_content_type == SAME_AS_DISPLAY) {
 468                 new_display_srf = vmw_surface_reference(new_vfbs->surface);
 469         }
 470
 471         if (new_display_srf) {
 472                 /* Pin new surface before flipping */
 473                 ret = vmw_resource_pin(&new_display_srf->res, false);
 474                 if (ret)
 475                         goto out_srf_unref;
 476
 477                 ret = vmw_stdu_bind_st(dev_priv, stdu, &new_display_srf->res);
 478                 if (ret)
 479                         goto out_srf_unpin;
 480
 481                 /* Unpin and unreference old surface */
 482                 vmw_stdu_unpin_display(stdu);
 483
 484                 /* Transfer the reference */
 485                 stdu->display_srf = new_display_srf;
 486                 new_display_srf = NULL;
 487         }
 488
 489         crtc->primary->fb = new_fb;
 490         stdu->content_fb_type = new_content_type;
 491         return 0;
 492
 493 out_srf_unpin:
 494         vmw_resource_unpin(&new_display_srf->res);
 495 out_srf_unref:
 496         vmw_surface_unreference(&new_display_srf);
 497         return ret;
 498 }
 499
 500 /**
 501  * vmw_stdu_crtc_set_config - Sets a mode
 502  *
 503  * @set:  mode parameters
 504  *
 505  * This function is the device-specific portion of the DRM CRTC mode set.
 506  * For the SVGA device, we do this by defining a Screen Target, binding a
 507  * GB Surface to that target, and finally update the screen target.
 508  *
 509  * RETURNS:
 510  * 0 on success, error code otherwise
 511  */
 512 static int vmw_stdu_crtc_set_config(struct drm_mode_set *set,
 513                                     struct drm_modeset_acquire_ctx *ctx)
 514 {
 515         struct vmw_private *dev_priv;
 516         struct vmw_framebuffer *vfb;
 517         struct vmw_screen_target_display_unit *stdu;
 518         struct drm_display_mode *mode;
 519         struct drm_framebuffer  *new_fb;
 520         struct drm_crtc      *crtc;
 521         struct drm_encoder   *encoder;
 522         struct drm_connector *connector;
 523         bool turning_off;
 524         int    ret;
 525
 526
 527         if (!set || !set->crtc)
 528                 return -EINVAL;
 529
 530         crtc     = set->crtc;
 531         stdu     = vmw_crtc_to_stdu(crtc);
 532         mode     = set->mode;
 533         new_fb   = set->fb;
 534         dev_priv = vmw_priv(crtc->dev);
 535         turning_off = set->num_connectors == 0 || !mode || !new_fb;
 536         vfb = (new_fb) ? vmw_framebuffer_to_vfb(new_fb) : NULL;
 537
 538         if (set->num_connectors > 1) {
 539                 DRM_ERROR("Too many connectors\n");
 540                 return -EINVAL;
 541         }
 542
 543         if (set->num_connectors == 1 &&
 544             set->connectors[0] != &stdu->base.connector) {
 545                 DRM_ERROR("Connectors don't match %p %p\n",
 546                         set->connectors[0], &stdu->base.connector);
 547                 return -EINVAL;
 548         }
 549
 550         if (!turning_off && (set->x + mode->hdisplay > new_fb->width ||
 551                              set->y + mode->vdisplay > new_fb->height)) {
 552                 DRM_ERROR("Set outside of framebuffer\n");
 553                 return -EINVAL;
 554         }
 555
 556         /* Only one active implicit frame-buffer at a time. */
 557         mutex_lock(&dev_priv->global_kms_state_mutex);
 558         if (!turning_off && stdu->base.is_implicit && dev_priv->implicit_fb &&
 559             !(dev_priv->num_implicit == 1 && stdu->base.active_implicit)
 560             && dev_priv->implicit_fb != vfb) {
 561                 mutex_unlock(&dev_priv->global_kms_state_mutex);
 562                 DRM_ERROR("Multiple implicit framebuffers not supported.\n");
 563                 return -EINVAL;
 564         }
 565         mutex_unlock(&dev_priv->global_kms_state_mutex);
 566
 567         /* Since they always map one to one these are safe */
 568         connector = &stdu->base.connector;
 569         encoder   = &stdu->base.encoder;
 570
 571         if (stdu->defined) {
 572                 ret = vmw_stdu_bind_st(dev_priv, stdu, NULL);
 573                 if (ret)
 574                         return ret;
 575
 576                 vmw_stdu_unpin_display(stdu);
 577                 (void) vmw_stdu_update_st(dev_priv, stdu);
 578                 vmw_kms_del_active(dev_priv, &stdu->base);
 579
 580                 ret = vmw_stdu_destroy_st(dev_priv, stdu);
 581                 if (ret)
 582                         return ret;
 583
 584                 crtc->primary->fb = NULL;
 585                 crtc->enabled = false;
 586                 encoder->crtc = NULL;
 587                 connector->encoder = NULL;
 588                 stdu->content_fb_type = SAME_AS_DISPLAY;
 589                 crtc->x = set->x;
 590                 crtc->y = set->y;
 591         }
 592
 593         if (turning_off)
 594                 return 0;
 595
 596         /*
 597          * Steps to displaying a surface, assume surface is already
 598          * bound:
 599          *   1.  define a screen target
 600          *   2.  bind a fb to the screen target
 601          *   3.  update that screen target (this is done later by
 602          *       vmw_kms_stdu_do_surface_dirty_or_present)
 603          */
 604         /*
 605          * Note on error handling: We can't really restore the crtc to
 606          * it's original state on error, but we at least update the
 607          * current state to what's submitted to hardware to enable
 608          * future recovery.
 609          */
 610         vmw_svga_enable(dev_priv);
 611         ret = vmw_stdu_define_st(dev_priv, stdu, mode, set->x, set->y);
 612         if (ret)
 613                 return ret;
 614
 615         crtc->x = set->x;
 616         crtc->y = set->y;
 617         crtc->mode = *mode;
 618
 619         ret = vmw_stdu_bind_fb(dev_priv, crtc, mode, new_fb);
 620         if (ret)
 621                 return ret;
 622
 623         vmw_kms_add_active(dev_priv, &stdu->base, vfb);
 624         crtc->enabled = true;
 625         connector->encoder = encoder;
 626         encoder->crtc      = crtc;
 627
 628         return 0;
 629 }
 630
 631 /**
 632  * vmw_stdu_crtc_page_flip - Binds a buffer to a screen target
 633  *
 634  * @crtc: CRTC to attach FB to
 635  * @fb: FB to attach
 636  * @event: Event to be posted. This event should've been alloced
 637  *         using k[mz]alloc, and should've been completely initialized.
 638  * @page_flip_flags: Input flags.
 639  *
 640  * If the STDU uses the same display and content buffers, i.e. a true flip,
 641  * this function will replace the existing display buffer with the new content
 642  * buffer.
 643  *
 644  * If the STDU uses different display and content buffers, i.e. a blit, then
 645  * only the content buffer will be updated.
 646  *
 647  * RETURNS:
 648  * 0 on success, error code on failure
 649  */
 650 static int vmw_stdu_crtc_page_flip(struct drm_crtc *crtc,
 651                                    struct drm_framebuffer *new_fb,
 652                                    struct drm_pending_vblank_event *event,
 653                                    uint32_t flags,
 654                                    struct drm_modeset_acquire_ctx *ctx)
 655
 656 {
 657         struct vmw_private *dev_priv = vmw_priv(crtc->dev);
 658         struct vmw_screen_target_display_unit *stdu;
 659         struct drm_vmw_rect vclips;
 660         struct vmw_framebuffer *vfb = vmw_framebuffer_to_vfb(new_fb);
 661         int ret;
 662
 663         dev_priv          = vmw_priv(crtc->dev);
 664         stdu              = vmw_crtc_to_stdu(crtc);
 665
 666         if (!stdu->defined || !vmw_kms_crtc_flippable(dev_priv, crtc))
 667                 return -EINVAL;
 668
 669         ret = vmw_stdu_bind_fb(dev_priv, crtc, &crtc->mode, new_fb);
 670         if (ret)
 671                 return ret;
 672
 673         if (stdu->base.is_implicit)
 674                 vmw_kms_update_implicit_fb(dev_priv, crtc);
 675
 676         vclips.x = crtc->x;
 677         vclips.y = crtc->y;
 678         vclips.w = crtc->mode.hdisplay;
 679         vclips.h = crtc->mode.vdisplay;
 680         if (vfb->dmabuf)
 681                 ret = vmw_kms_stdu_dma(dev_priv, NULL, vfb, NULL, NULL, &vclips,
 682                                        1, 1, true, false);
 683         else
 684                 ret = vmw_kms_stdu_surface_dirty(dev_priv, vfb, NULL, &vclips,
 685                                                  NULL, 0, 0, 1, 1, NULL);
 686         if (ret)
 687                 return ret;
 688
 689         if (event) {
 690                 struct vmw_fence_obj *fence = NULL;
 691                 struct drm_file *file_priv = event->base.file_priv;
 692
 693                 vmw_execbuf_fence_commands(NULL, dev_priv, &fence, NULL);
 694                 if (!fence)
 695                         return -ENOMEM;
 696
 697                 ret = vmw_event_fence_action_queue(file_priv, fence,
 698                                                    &event->base,
 699                                                    &event->event.tv_sec,
 700                                                    &event->event.tv_usec,
 701                                                    true);
 702                 vmw_fence_obj_unreference(&fence);
 703         } else {
 704                 vmw_fifo_flush(dev_priv, false);
 705         }
 706
 707         return 0;
 708 }
 709
 710
 711 /**
 712  * vmw_stdu_dmabuf_clip - Callback to encode a suface DMA command cliprect
 713  *
 714  * @dirty: The closure structure.
 715  *
 716  * Encodes a surface DMA command cliprect and updates the bounding box
 717  * for the DMA.
 718  */
 719 static void vmw_stdu_dmabuf_clip(struct vmw_kms_dirty *dirty)
 720 {
 721         struct vmw_stdu_dirty *ddirty =
 722                 container_of(dirty, struct vmw_stdu_dirty, base);
 723         struct vmw_stdu_dma *cmd = dirty->cmd;
 724         struct SVGA3dCopyBox *blit = (struct SVGA3dCopyBox *) &cmd[1];
 725
 726         blit += dirty->num_hits;
 727         blit->srcx = dirty->fb_x;
 728         blit->srcy = dirty->fb_y;
 729         blit->x = dirty->unit_x1;
 730         blit->y = dirty->unit_y1;
 731         blit->d = 1;
 732         blit->w = dirty->unit_x2 - dirty->unit_x1;
 733         blit->h = dirty->unit_y2 - dirty->unit_y1;
 734         dirty->num_hits++;
 735
 736         if (ddirty->transfer != SVGA3D_WRITE_HOST_VRAM)
 737                 return;
 738
 739         /* Destination bounding box */
 740         ddirty->left = min_t(s32, ddirty->left, dirty->unit_x1);
 741         ddirty->top = min_t(s32, ddirty->top, dirty->unit_y1);
 742         ddirty->right = max_t(s32, ddirty->right, dirty->unit_x2);
 743         ddirty->bottom = max_t(s32, ddirty->bottom, dirty->unit_y2);
 744 }
 745
 746 /**
 747  * vmw_stdu_dmabuf_fifo_commit - Callback to fill in and submit a DMA command.
 748  *
 749  * @dirty: The closure structure.
 750  *
 751  * Fills in the missing fields in a DMA command, and optionally encodes
 752  * a screen target update command, depending on transfer direction.
 753  */
 754 static void vmw_stdu_dmabuf_fifo_commit(struct vmw_kms_dirty *dirty)
 755 {
 756         struct vmw_stdu_dirty *ddirty =
 757                 container_of(dirty, struct vmw_stdu_dirty, base);
 758         struct vmw_screen_target_display_unit *stdu =
 759                 container_of(dirty->unit, typeof(*stdu), base);
 760         struct vmw_stdu_dma *cmd = dirty->cmd;
 761         struct SVGA3dCopyBox *blit = (struct SVGA3dCopyBox *) &cmd[1];
 762         SVGA3dCmdSurfaceDMASuffix *suffix =
 763                 (SVGA3dCmdSurfaceDMASuffix *) &blit[dirty->num_hits];
 764         size_t blit_size = sizeof(*blit) * dirty->num_hits + sizeof(*suffix);
 765
 766         if (!dirty->num_hits) {
 767                 vmw_fifo_commit(dirty->dev_priv, 0);
 768                 return;
 769         }
 770
 771         cmd->header.id = SVGA_3D_CMD_SURFACE_DMA;
 772         cmd->header.size = sizeof(cmd->body) + blit_size;
 773         vmw_bo_get_guest_ptr(&ddirty->buf->base, &cmd->body.guest.ptr);
 774         cmd->body.guest.pitch = ddirty->pitch;
 775         cmd->body.host.sid = stdu->display_srf->res.id;
 776         cmd->body.host.face = 0;
 777         cmd->body.host.mipmap = 0;
 778         cmd->body.transfer = ddirty->transfer;
 779         suffix->suffixSize = sizeof(*suffix);
 780         suffix->maximumOffset = ddirty->buf->base.num_pages * PAGE_SIZE;
 781
 782         if (ddirty->transfer == SVGA3D_WRITE_HOST_VRAM) {
 783                 blit_size += sizeof(struct vmw_stdu_update);
 784
 785                 vmw_stdu_populate_update(&suffix[1], stdu->base.unit,
 786                                          ddirty->left, ddirty->right,
 787                                          ddirty->top, ddirty->bottom);
 788         }
 789
 790         vmw_fifo_commit(dirty->dev_priv, sizeof(*cmd) + blit_size);
 791
 792         ddirty->left = ddirty->top = S32_MAX;
 793         ddirty->right = ddirty->bottom = S32_MIN;
 794 }
 795
 796 /**
 797  * vmw_kms_stdu_dma - Perform a DMA transfer between a dma-buffer backed
 798  * framebuffer and the screen target system.
 799  *
 800  * @dev_priv: Pointer to the device private structure.
 801  * @file_priv: Pointer to a struct drm-file identifying the caller. May be
 802  * set to NULL, but then @user_fence_rep must also be set to NULL.
 803  * @vfb: Pointer to the dma-buffer backed framebuffer.
 804  * @clips: Array of clip rects. Either @clips or @vclips must be NULL.
 805  * @vclips: Alternate array of clip rects. Either @clips or @vclips must
 806  * be NULL.
 807  * @num_clips: Number of clip rects in @clips or @vclips.
 808  * @increment: Increment to use when looping over @clips or @vclips.
 809  * @to_surface: Whether to DMA to the screen target system as opposed to
 810  * from the screen target system.
 811  * @interruptible: Whether to perform waits interruptible if possible.
 812  *
 813  * If DMA-ing till the screen target system, the function will also notify
 814  * the screen target system that a bounding box of the cliprects has been
 815  * updated.
 816  * Returns 0 on success, negative error code on failure. -ERESTARTSYS if
 817  * interrupted.
 818  */
 819 int vmw_kms_stdu_dma(struct vmw_private *dev_priv,
 820                      struct drm_file *file_priv,
 821                      struct vmw_framebuffer *vfb,
 822                      struct drm_vmw_fence_rep __user *user_fence_rep,
 823                      struct drm_clip_rect *clips,
 824                      struct drm_vmw_rect *vclips,
 825                      uint32_t num_clips,
 826                      int increment,
 827                      bool to_surface,
 828                      bool interruptible)
 829 {
 830         struct vmw_dma_buffer *buf =
 831                 container_of(vfb, struct vmw_framebuffer_dmabuf, base)->buffer;
 832         struct vmw_stdu_dirty ddirty;
 833         int ret;
 834
 835         ret = vmw_kms_helper_buffer_prepare(dev_priv, buf, interruptible,
 836                                             false);
 837         if (ret)
 838                 return ret;
 839
 840         ddirty.transfer = (to_surface) ? SVGA3D_WRITE_HOST_VRAM :
 841                 SVGA3D_READ_HOST_VRAM;
 842         ddirty.left = ddirty.top = S32_MAX;
 843         ddirty.right = ddirty.bottom = S32_MIN;
 844         ddirty.pitch = vfb->base.pitches[0];
 845         ddirty.buf = buf;
 846         ddirty.base.fifo_commit = vmw_stdu_dmabuf_fifo_commit;
 847         ddirty.base.clip = vmw_stdu_dmabuf_clip;
 848         ddirty.base.fifo_reserve_size = sizeof(struct vmw_stdu_dma) +
 849                 num_clips * sizeof(SVGA3dCopyBox) +
 850                 sizeof(SVGA3dCmdSurfaceDMASuffix);
 851         if (to_surface)
 852                 ddirty.base.fifo_reserve_size += sizeof(struct vmw_stdu_update);
 853
 854         ret = vmw_kms_helper_dirty(dev_priv, vfb, clips, vclips,
 855                                    0, 0, num_clips, increment, &ddirty.base);
 856         vmw_kms_helper_buffer_finish(dev_priv, file_priv, buf, NULL,
 857                                      user_fence_rep);
 858
 859         return ret;
 860 }
 861
 862 /**
 863  * vmw_stdu_surface_clip - Callback to encode a surface copy command cliprect
 864  *
 865  * @dirty: The closure structure.
 866  *
 867  * Encodes a surface copy command cliprect and updates the bounding box
 868  * for the copy.
 869  */
 870 static void vmw_kms_stdu_surface_clip(struct vmw_kms_dirty *dirty)
 871 {
 872         struct vmw_stdu_dirty *sdirty =
 873                 container_of(dirty, struct vmw_stdu_dirty, base);
 874         struct vmw_stdu_surface_copy *cmd = dirty->cmd;
 875         struct vmw_screen_target_display_unit *stdu =
 876                 container_of(dirty->unit, typeof(*stdu), base);
 877
 878         if (sdirty->sid != stdu->display_srf->res.id) {
 879                 struct SVGA3dCopyBox *blit = (struct SVGA3dCopyBox *) &cmd[1];
 880
 881                 blit += dirty->num_hits;
 882                 blit->srcx = dirty->fb_x;
 883                 blit->srcy = dirty->fb_y;
 884                 blit->x = dirty->unit_x1;
 885                 blit->y = dirty->unit_y1;
 886                 blit->d = 1;
 887                 blit->w = dirty->unit_x2 - dirty->unit_x1;
 888                 blit->h = dirty->unit_y2 - dirty->unit_y1;
 889         }
 890
 891         dirty->num_hits++;
 892
 893         /* Destination bounding box */
 894         sdirty->left = min_t(s32, sdirty->left, dirty->unit_x1);
 895         sdirty->top = min_t(s32, sdirty->top, dirty->unit_y1);
 896         sdirty->right = max_t(s32, sdirty->right, dirty->unit_x2);
 897         sdirty->bottom = max_t(s32, sdirty->bottom, dirty->unit_y2);
 898 }
 899
 900 /**
 901  * vmw_stdu_surface_fifo_commit - Callback to fill in and submit a surface
 902  * copy command.
 903  *
 904  * @dirty: The closure structure.
 905  *
 906  * Fills in the missing fields in a surface copy command, and encodes a screen
 907  * target update command.
 908  */
 909 static void vmw_kms_stdu_surface_fifo_commit(struct vmw_kms_dirty *dirty)
 910 {
 911         struct vmw_stdu_dirty *sdirty =
 912                 container_of(dirty, struct vmw_stdu_dirty, base);
 913         struct vmw_screen_target_display_unit *stdu =
 914                 container_of(dirty->unit, typeof(*stdu), base);
 915         struct vmw_stdu_surface_copy *cmd = dirty->cmd;
 916         struct vmw_stdu_update *update;
 917         size_t blit_size = sizeof(SVGA3dCopyBox) * dirty->num_hits;
 918         size_t commit_size;
 919
 920         if (!dirty->num_hits) {
 921                 vmw_fifo_commit(dirty->dev_priv, 0);
 922                 return;
 923         }
 924
 925         if (sdirty->sid != stdu->display_srf->res.id) {
 926                 struct SVGA3dCopyBox *blit = (struct SVGA3dCopyBox *) &cmd[1];
 927
 928                 cmd->header.id = SVGA_3D_CMD_SURFACE_COPY;
 929                 cmd->header.size = sizeof(cmd->body) + blit_size;
 930                 cmd->body.src.sid = sdirty->sid;
 931                 cmd->body.dest.sid = stdu->display_srf->res.id;
 932                 update = (struct vmw_stdu_update *) &blit[dirty->num_hits];
 933                 commit_size = sizeof(*cmd) + blit_size + sizeof(*update);
 934         } else {
 935                 update = dirty->cmd;
 936                 commit_size = sizeof(*update);
 937         }
 938
 939         vmw_stdu_populate_update(update, stdu->base.unit, sdirty->left,
 940                                  sdirty->right, sdirty->top, sdirty->bottom);
 941
 942         vmw_fifo_commit(dirty->dev_priv, commit_size);
 943
 944         sdirty->left = sdirty->top = S32_MAX;
 945         sdirty->right = sdirty->bottom = S32_MIN;
 946 }
 947
 948 /**
 949  * vmw_kms_stdu_surface_dirty - Dirty part of a surface backed framebuffer
 950  *
 951  * @dev_priv: Pointer to the device private structure.
 952  * @framebuffer: Pointer to the surface-buffer backed framebuffer.
 953  * @clips: Array of clip rects. Either @clips or @vclips must be NULL.
 954  * @vclips: Alternate array of clip rects. Either @clips or @vclips must
 955  * be NULL.
 956  * @srf: Pointer to surface to blit from. If NULL, the surface attached
 957  * to @framebuffer will be used.
 958  * @dest_x: X coordinate offset to align @srf with framebuffer coordinates.
 959  * @dest_y: Y coordinate offset to align @srf with framebuffer coordinates.
 960  * @num_clips: Number of clip rects in @clips.
 961  * @inc: Increment to use when looping over @clips.
 962  * @out_fence: If non-NULL, will return a ref-counted pointer to a
 963  * struct vmw_fence_obj. The returned fence pointer may be NULL in which
 964  * case the device has already synchronized.
 965  *
 966  * Returns 0 on success, negative error code on failure. -ERESTARTSYS if
 967  * interrupted.
 968  */
 969 int vmw_kms_stdu_surface_dirty(struct vmw_private *dev_priv,
 970                                struct vmw_framebuffer *framebuffer,
 971                                struct drm_clip_rect *clips,
 972                                struct drm_vmw_rect *vclips,
 973                                struct vmw_resource *srf,
 974                                s32 dest_x,
 975                                s32 dest_y,
 976                                unsigned num_clips, int inc,
 977                                struct vmw_fence_obj **out_fence)
 978 {
 979         struct vmw_framebuffer_surface *vfbs =
 980                 container_of(framebuffer, typeof(*vfbs), base);
 981         struct vmw_stdu_dirty sdirty;
 982         int ret;
 983
 984         if (!srf)
 985                 srf = &vfbs->surface->res;
 986
 987         ret = vmw_kms_helper_resource_prepare(srf, true);
 988         if (ret)
 989                 return ret;
 990
 991         if (vfbs->is_dmabuf_proxy) {
 992                 ret = vmw_kms_update_proxy(srf, clips, num_clips, inc);
 993                 if (ret)
 994                         goto out_finish;
 995         }
 996
 997         sdirty.base.fifo_commit = vmw_kms_stdu_surface_fifo_commit;
 998         sdirty.base.clip = vmw_kms_stdu_surface_clip;
 999         sdirty.base.fifo_reserve_size = sizeof(struct vmw_stdu_surface_copy) +
1000                 sizeof(SVGA3dCopyBox) * num_clips +
1001                 sizeof(struct vmw_stdu_update);
1002         sdirty.sid = srf->id;
1003         sdirty.left = sdirty.top = S32_MAX;
1004         sdirty.right = sdirty.bottom = S32_MIN;
1005
1006         ret = vmw_kms_helper_dirty(dev_priv, framebuffer, clips, vclips,
1007                                    dest_x, dest_y, num_clips, inc,
1008                                    &sdirty.base);
1009 out_finish:
1010         vmw_kms_helper_resource_finish(srf, out_fence);
1011
1012         return ret;
1013 }
1014
1015
1016 /*
1017  *  Screen Target CRTC dispatch table
1018  */
1019 static const struct drm_crtc_funcs vmw_stdu_crtc_funcs = {
1020         .cursor_set2 = vmw_du_crtc_cursor_set2,
1021         .cursor_move = vmw_du_crtc_cursor_move,
1022         .gamma_set = vmw_du_crtc_gamma_set,
1023         .destroy = vmw_stdu_crtc_destroy,
1024         .set_config = vmw_stdu_crtc_set_config,
1025         .page_flip = vmw_stdu_crtc_page_flip,
1026 };
1027
1028
1029
1030 /******************************************************************************
1031  * Screen Target Display Unit Encoder Functions
1032  *****************************************************************************/
1033
1034 /**
1035  * vmw_stdu_encoder_destroy - cleans up the STDU
1036  *
1037  * @encoder: used the get the containing STDU
1038  *
1039  * vmwgfx cleans up crtc/encoder/connector all at the same time so technically
1040  * this can be a no-op.  Nevertheless, it doesn't hurt of have this in case
1041  * the common KMS code changes and somehow vmw_stdu_crtc_destroy() doesn't
1042  * get called.
1043  */
1044 static void vmw_stdu_encoder_destroy(struct drm_encoder *encoder)
1045 {
1046         vmw_stdu_destroy(vmw_encoder_to_stdu(encoder));
1047 }
1048
1049 static const struct drm_encoder_funcs vmw_stdu_encoder_funcs = {
1050         .destroy = vmw_stdu_encoder_destroy,
1051 };
1052
1053
1054
1055 /******************************************************************************
1056  * Screen Target Display Unit Connector Functions
1057  *****************************************************************************/
1058
1059 /**
1060  * vmw_stdu_connector_destroy - cleans up the STDU
1061  *
1062  * @connector: used to get the containing STDU
1063  *
1064  * vmwgfx cleans up crtc/encoder/connector all at the same time so technically
1065  * this can be a no-op.  Nevertheless, it doesn't hurt of have this in case
1066  * the common KMS code changes and somehow vmw_stdu_crtc_destroy() doesn't
1067  * get called.
1068  */
1069 static void vmw_stdu_connector_destroy(struct drm_connector *connector)
1070 {
1071         vmw_stdu_destroy(vmw_connector_to_stdu(connector));
1072 }
1073
1074
1075
1076 static const struct drm_connector_funcs vmw_stdu_connector_funcs = {
1077         .dpms = vmw_du_connector_dpms,
1078         .detect = vmw_du_connector_detect,
1079         .fill_modes = vmw_du_connector_fill_modes,
1080         .set_property = vmw_du_connector_set_property,
1081         .destroy = vmw_stdu_connector_destroy,
1082 };
1083
1084
1085
1086 /**
1087  * vmw_stdu_init - Sets up a Screen Target Display Unit
1088  *
1089  * @dev_priv: VMW DRM device
1090  * @unit: unit number range from 0 to VMWGFX_NUM_DISPLAY_UNITS
1091  *
1092  * This function is called once per CRTC, and allocates one Screen Target
1093  * display unit to represent that CRTC.  Since the SVGA device does not separate
1094  * out encoder and connector, they are represented as part of the STDU as well.
1095  */
1096 static int vmw_stdu_init(struct vmw_private *dev_priv, unsigned unit)
1097 {
1098         struct vmw_screen_target_display_unit *stdu;
1099         struct drm_device *dev = dev_priv->dev;
1100         struct drm_connector *connector;
1101         struct drm_encoder *encoder;
1102         struct drm_crtc *crtc;
1103
1104
1105         stdu = kzalloc(sizeof(*stdu), GFP_KERNEL);
1106         if (!stdu)
1107                 return -ENOMEM;
1108
1109         stdu->base.unit = unit;
1110         crtc = &stdu->base.crtc;
1111         encoder = &stdu->base.encoder;
1112         connector = &stdu->base.connector;
1113
1114         stdu->base.pref_active = (unit == 0);
1115         stdu->base.pref_width  = dev_priv->initial_width;
1116         stdu->base.pref_height = dev_priv->initial_height;
1117         stdu->base.is_implicit = false;
1118
1119         drm_connector_init(dev, connector, &vmw_stdu_connector_funcs,
1120                            DRM_MODE_CONNECTOR_VIRTUAL);
1121         connector->status = vmw_du_connector_detect(connector, false);
1122
1123         drm_encoder_init(dev, encoder, &vmw_stdu_encoder_funcs,
1124                          DRM_MODE_ENCODER_VIRTUAL, NULL);
1125         drm_mode_connector_attach_encoder(connector, encoder);
1126         encoder->possible_crtcs = (1 << unit);
1127         encoder->possible_clones = 0;
1128
1129         (void) drm_connector_register(connector);
1130
1131         drm_crtc_init(dev, crtc, &vmw_stdu_crtc_funcs);
1132
1133         drm_mode_crtc_set_gamma_size(crtc, 256);
1134
1135         drm_object_attach_property(&connector->base,
1136                                    dev_priv->hotplug_mode_update_property, 1);
1137         drm_object_attach_property(&connector->base,
1138                                    dev->mode_config.suggested_x_property, 0);
1139         drm_object_attach_property(&connector->base,
1140                                    dev->mode_config.suggested_y_property, 0);
1141         if (dev_priv->implicit_placement_property)
1142                 drm_object_attach_property
1143                         (&connector->base,
1144                          dev_priv->implicit_placement_property,
1145                          stdu->base.is_implicit);
1146         return 0;
1147 }
1148
1149
1150
1151 /**
1152  *  vmw_stdu_destroy - Cleans up a vmw_screen_target_display_unit
1153  *
1154  *  @stdu:  Screen Target Display Unit to be destroyed
1155  *
1156  *  Clean up after vmw_stdu_init
1157  */
1158 static void vmw_stdu_destroy(struct vmw_screen_target_display_unit *stdu)
1159 {
1160         vmw_stdu_unpin_display(stdu);
1161
1162         vmw_du_cleanup(&stdu->base);
1163         kfree(stdu);
1164 }
1165
1166
1167
1168 /******************************************************************************
1169  * Screen Target Display KMS Functions
1170  *
1171  * These functions are called by the common KMS code in vmwgfx_kms.c
1172  *****************************************************************************/
1173
1174 /**
1175  * vmw_kms_stdu_init_display - Initializes a Screen Target based display
1176  *
1177  * @dev_priv: VMW DRM device
1178  *
1179  * This function initialize a Screen Target based display device.  It checks
1180  * the capability bits to make sure the underlying hardware can support
1181  * screen targets, and then creates the maximum number of CRTCs, a.k.a Display
1182  * Units, as supported by the display hardware.
1183  *
1184  * RETURNS:
1185  * 0 on success, error code otherwise
1186  */
1187 int vmw_kms_stdu_init_display(struct vmw_private *dev_priv)
1188 {
1189         struct drm_device *dev = dev_priv->dev;
1190         int i, ret;
1191
1192
1193         /* Do nothing if Screen Target support is turned off */
1194         if (!VMWGFX_ENABLE_SCREEN_TARGET_OTABLE)
1195                 return -ENOSYS;
1196
1197         if (!(dev_priv->capabilities & SVGA_CAP_GBOBJECTS))
1198                 return -ENOSYS;
1199
1200         ret = drm_vblank_init(dev, VMWGFX_NUM_DISPLAY_UNITS);
1201         if (unlikely(ret != 0))
1202                 return ret;
1203
1204         dev_priv->active_display_unit = vmw_du_screen_target;
1205
1206         vmw_kms_create_implicit_placement_property(dev_priv, false);
1207
1208         for (i = 0; i < VMWGFX_NUM_DISPLAY_UNITS; ++i) {
1209                 ret = vmw_stdu_init(dev_priv, i);
1210
1211                 if (unlikely(ret != 0)) {
1212                         DRM_ERROR("Failed to initialize STDU %d", i);
1213                         goto err_vblank_cleanup;
1214                 }
1215         }
1216
1217         DRM_INFO("Screen Target Display device initialized\n");
1218
1219         return 0;
1220
1221 err_vblank_cleanup:
1222         drm_vblank_cleanup(dev);
1223         return ret;
1224 }
1225
1226
1227
1228 /**
1229  * vmw_kms_stdu_close_display - Cleans up after vmw_kms_stdu_init_display
1230  *
1231  * @dev_priv: VMW DRM device
1232  *
1233  * Frees up any resources allocated by vmw_kms_stdu_init_display
1234  *
1235  * RETURNS:
1236  * 0 on success
1237  */
1238 int vmw_kms_stdu_close_display(struct vmw_private *dev_priv)
1239 {
1240         struct drm_device *dev = dev_priv->dev;
1241
1242         drm_vblank_cleanup(dev);
1243
1244         return 0;
1245 }