1 /* 2 * Copyright © 2006 Keith Packard 3 * Copyright © 2007-2008 Dave Airlie 4 * Copyright © 2007-2008 Intel Corporation 5 * Jesse Barnes <jesse.barnes@intel.com> 6 * 7 * Permission is hereby granted, free of charge, to any person obtaining a 8 * copy of this software and associated documentation files (the "Software"), 9 * to deal in the Software without restriction, including without limitation 10 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 11 * and/or sell copies of the Software, and to permit persons to whom the 12 * Software is furnished to do so, subject to the following conditions: 13 * 14 * The above copyright notice and this permission notice shall be included in 15 * all copies or substantial portions of the Software. 16 * 17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 20 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 21 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 22 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 23 * OTHER DEALINGS IN THE SOFTWARE. 24 */ 25 #ifndef __DRM_CRTC_H__ 26 #define __DRM_CRTC_H__ 27 28 #include <linux/i2c.h> 29 #include <linux/spinlock.h> 30 #include <linux/types.h> 31 #include <linux/idr.h> 32 #include <linux/fb.h> 33 #include <linux/hdmi.h> 34 #include <drm/drm_mode.h> 35 36 #include <drm/drm_fourcc.h> 37 38 struct drm_device; 39 struct drm_mode_set; 40 struct drm_framebuffer; 41 struct drm_object_properties; 42 struct drm_file; 43 struct drm_clip_rect; 44 45 #define DRM_MODE_OBJECT_CRTC 0xcccccccc 46 #define DRM_MODE_OBJECT_CONNECTOR 0xc0c0c0c0 47 #define DRM_MODE_OBJECT_ENCODER 0xe0e0e0e0 48 #define DRM_MODE_OBJECT_MODE 0xdededede 49 #define DRM_MODE_OBJECT_PROPERTY 0xb0b0b0b0 50 #define DRM_MODE_OBJECT_FB 0xfbfbfbfb 51 #define DRM_MODE_OBJECT_BLOB 0xbbbbbbbb 52 #define DRM_MODE_OBJECT_PLANE 0xeeeeeeee 53 #define DRM_MODE_OBJECT_BRIDGE 0xbdbdbdbd 54 55 struct drm_mode_object { 56 uint32_t id; 57 uint32_t type; 58 struct drm_object_properties *properties; 59 }; 60 61 #define DRM_OBJECT_MAX_PROPERTY 24 62 struct drm_object_properties { 63 int count; 64 uint32_t ids[DRM_OBJECT_MAX_PROPERTY]; 65 uint64_t values[DRM_OBJECT_MAX_PROPERTY]; 66 }; 67 68 /* 69 * Note on terminology: here, for brevity and convenience, we refer to connector 70 * control chips as 'CRTCs'. They can control any type of connector, VGA, LVDS, 71 * DVI, etc. And 'screen' refers to the whole of the visible display, which 72 * may span multiple monitors (and therefore multiple CRTC and connector 73 * structures). 74 */ 75 76 enum drm_mode_status { 77 MODE_OK = 0, /* Mode OK */ 78 MODE_HSYNC, /* hsync out of range */ 79 MODE_VSYNC, /* vsync out of range */ 80 MODE_H_ILLEGAL, /* mode has illegal horizontal timings */ 81 MODE_V_ILLEGAL, /* mode has illegal horizontal timings */ 82 MODE_BAD_WIDTH, /* requires an unsupported linepitch */ 83 MODE_NOMODE, /* no mode with a matching name */ 84 MODE_NO_INTERLACE, /* interlaced mode not supported */ 85 MODE_NO_DBLESCAN, /* doublescan mode not supported */ 86 MODE_NO_VSCAN, /* multiscan mode not supported */ 87 MODE_MEM, /* insufficient video memory */ 88 MODE_VIRTUAL_X, /* mode width too large for specified virtual size */ 89 MODE_VIRTUAL_Y, /* mode height too large for specified virtual size */ 90 MODE_MEM_VIRT, /* insufficient video memory given virtual size */ 91 MODE_NOCLOCK, /* no fixed clock available */ 92 MODE_CLOCK_HIGH, /* clock required is too high */ 93 MODE_CLOCK_LOW, /* clock required is too low */ 94 MODE_CLOCK_RANGE, /* clock/mode isn't in a ClockRange */ 95 MODE_BAD_HVALUE, /* horizontal timing was out of range */ 96 MODE_BAD_VVALUE, /* vertical timing was out of range */ 97 MODE_BAD_VSCAN, /* VScan value out of range */ 98 MODE_HSYNC_NARROW, /* horizontal sync too narrow */ 99 MODE_HSYNC_WIDE, /* horizontal sync too wide */ 100 MODE_HBLANK_NARROW, /* horizontal blanking too narrow */ 101 MODE_HBLANK_WIDE, /* horizontal blanking too wide */ 102 MODE_VSYNC_NARROW, /* vertical sync too narrow */ 103 MODE_VSYNC_WIDE, /* vertical sync too wide */ 104 MODE_VBLANK_NARROW, /* vertical blanking too narrow */ 105 MODE_VBLANK_WIDE, /* vertical blanking too wide */ 106 MODE_PANEL, /* exceeds panel dimensions */ 107 MODE_INTERLACE_WIDTH, /* width too large for interlaced mode */ 108 MODE_ONE_WIDTH, /* only one width is supported */ 109 MODE_ONE_HEIGHT, /* only one height is supported */ 110 MODE_ONE_SIZE, /* only one resolution is supported */ 111 MODE_NO_REDUCED, /* monitor doesn't accept reduced blanking */ 112 MODE_NO_STEREO, /* stereo modes not supported */ 113 MODE_UNVERIFIED = -3, /* mode needs to reverified */ 114 MODE_BAD = -2, /* unspecified reason */ 115 MODE_ERROR = -1 /* error condition */ 116 }; 117 118 #define DRM_MODE_TYPE_CLOCK_CRTC_C (DRM_MODE_TYPE_CLOCK_C | \ 119 DRM_MODE_TYPE_CRTC_C) 120 121 #define DRM_MODE(nm, t, c, hd, hss, hse, ht, hsk, vd, vss, vse, vt, vs, f) \ 122 .name = nm, .status = 0, .type = (t), .clock = (c), \ 123 .hdisplay = (hd), .hsync_start = (hss), .hsync_end = (hse), \ 124 .htotal = (ht), .hskew = (hsk), .vdisplay = (vd), \ 125 .vsync_start = (vss), .vsync_end = (vse), .vtotal = (vt), \ 126 .vscan = (vs), .flags = (f), \ 127 .base.type = DRM_MODE_OBJECT_MODE 128 129 #define CRTC_INTERLACE_HALVE_V (1 << 0) /* halve V values for interlacing */ 130 #define CRTC_STEREO_DOUBLE (1 << 1) /* adjust timings for stereo modes */ 131 132 #define DRM_MODE_FLAG_3D_MAX DRM_MODE_FLAG_3D_SIDE_BY_SIDE_HALF 133 134 struct drm_display_mode { 135 /* Header */ 136 struct list_head head; 137 struct drm_mode_object base; 138 139 char name[DRM_DISPLAY_MODE_LEN]; 140 141 enum drm_mode_status status; 142 unsigned int type; 143 144 /* Proposed mode values */ 145 int clock; /* in kHz */ 146 int hdisplay; 147 int hsync_start; 148 int hsync_end; 149 int htotal; 150 int hskew; 151 int vdisplay; 152 int vsync_start; 153 int vsync_end; 154 int vtotal; 155 int vscan; 156 unsigned int flags; 157 158 /* Addressable image size (may be 0 for projectors, etc.) */ 159 int width_mm; 160 int height_mm; 161 162 /* Actual mode we give to hw */ 163 int crtc_clock; /* in KHz */ 164 int crtc_hdisplay; 165 int crtc_hblank_start; 166 int crtc_hblank_end; 167 int crtc_hsync_start; 168 int crtc_hsync_end; 169 int crtc_htotal; 170 int crtc_hskew; 171 int crtc_vdisplay; 172 int crtc_vblank_start; 173 int crtc_vblank_end; 174 int crtc_vsync_start; 175 int crtc_vsync_end; 176 int crtc_vtotal; 177 178 /* Driver private mode info */ 179 int private_size; 180 int *private; 181 int private_flags; 182 183 int vrefresh; /* in Hz */ 184 int hsync; /* in kHz */ 185 enum hdmi_picture_aspect picture_aspect_ratio; 186 }; 187 188 static inline bool drm_mode_is_stereo(const struct drm_display_mode *mode) 189 { 190 return mode->flags & DRM_MODE_FLAG_3D_MASK; 191 } 192 193 enum drm_connector_status { 194 connector_status_connected = 1, 195 connector_status_disconnected = 2, 196 connector_status_unknown = 3, 197 }; 198 199 enum subpixel_order { 200 SubPixelUnknown = 0, 201 SubPixelHorizontalRGB, 202 SubPixelHorizontalBGR, 203 SubPixelVerticalRGB, 204 SubPixelVerticalBGR, 205 SubPixelNone, 206 }; 207 208 #define DRM_COLOR_FORMAT_RGB444 (1<<0) 209 #define DRM_COLOR_FORMAT_YCRCB444 (1<<1) 210 #define DRM_COLOR_FORMAT_YCRCB422 (1<<2) 211 /* 212 * Describes a given display (e.g. CRT or flat panel) and its limitations. 213 */ 214 struct drm_display_info { 215 char name[DRM_DISPLAY_INFO_LEN]; 216 217 /* Physical size */ 218 unsigned int width_mm; 219 unsigned int height_mm; 220 221 /* Clock limits FIXME: storage format */ 222 unsigned int min_vfreq, max_vfreq; 223 unsigned int min_hfreq, max_hfreq; 224 unsigned int pixel_clock; 225 unsigned int bpc; 226 227 enum subpixel_order subpixel_order; 228 u32 color_formats; 229 230 u8 cea_rev; 231 }; 232 233 struct drm_framebuffer_funcs { 234 /* note: use drm_framebuffer_remove() */ 235 void (*destroy)(struct drm_framebuffer *framebuffer); 236 int (*create_handle)(struct drm_framebuffer *fb, 237 struct drm_file *file_priv, 238 unsigned int *handle); 239 /** 240 * Optinal callback for the dirty fb ioctl. 241 * 242 * Userspace can notify the driver via this callback 243 * that a area of the framebuffer has changed and should 244 * be flushed to the display hardware. 245 * 246 * See documentation in drm_mode.h for the struct 247 * drm_mode_fb_dirty_cmd for more information as all 248 * the semantics and arguments have a one to one mapping 249 * on this function. 250 */ 251 int (*dirty)(struct drm_framebuffer *framebuffer, 252 struct drm_file *file_priv, unsigned flags, 253 unsigned color, struct drm_clip_rect *clips, 254 unsigned num_clips); 255 }; 256 257 struct drm_framebuffer { 258 struct drm_device *dev; 259 /* 260 * Note that the fb is refcounted for the benefit of driver internals, 261 * for example some hw, disabling a CRTC/plane is asynchronous, and 262 * scanout does not actually complete until the next vblank. So some 263 * cleanup (like releasing the reference(s) on the backing GEM bo(s)) 264 * should be deferred. In cases like this, the driver would like to 265 * hold a ref to the fb even though it has already been removed from 266 * userspace perspective. 267 */ 268 struct kref refcount; 269 /* 270 * Place on the dev->mode_config.fb_list, access protected by 271 * dev->mode_config.fb_lock. 272 */ 273 struct list_head head; 274 struct drm_mode_object base; 275 const struct drm_framebuffer_funcs *funcs; 276 unsigned int pitches[4]; 277 unsigned int offsets[4]; 278 unsigned int width; 279 unsigned int height; 280 /* depth can be 15 or 16 */ 281 unsigned int depth; 282 int bits_per_pixel; 283 int flags; 284 uint32_t pixel_format; /* fourcc format */ 285 struct list_head filp_head; 286 /* if you are using the helper */ 287 void *helper_private; 288 }; 289 290 struct drm_property_blob { 291 struct drm_mode_object base; 292 struct list_head head; 293 unsigned int length; 294 unsigned char data[]; 295 }; 296 297 struct drm_property_enum { 298 uint64_t value; 299 struct list_head head; 300 char name[DRM_PROP_NAME_LEN]; 301 }; 302 303 struct drm_property { 304 struct list_head head; 305 struct drm_mode_object base; 306 uint32_t flags; 307 char name[DRM_PROP_NAME_LEN]; 308 uint32_t num_values; 309 uint64_t *values; 310 311 struct list_head enum_blob_list; 312 }; 313 314 struct drm_crtc; 315 struct drm_connector; 316 struct drm_encoder; 317 struct drm_pending_vblank_event; 318 struct drm_plane; 319 struct drm_bridge; 320 321 /** 322 * drm_crtc_funcs - control CRTCs for a given device 323 * @save: save CRTC state 324 * @restore: restore CRTC state 325 * @reset: reset CRTC after state has been invalidated (e.g. resume) 326 * @cursor_set: setup the cursor 327 * @cursor_move: move the cursor 328 * @gamma_set: specify color ramp for CRTC 329 * @destroy: deinit and free object 330 * @set_property: called when a property is changed 331 * @set_config: apply a new CRTC configuration 332 * @page_flip: initiate a page flip 333 * 334 * The drm_crtc_funcs structure is the central CRTC management structure 335 * in the DRM. Each CRTC controls one or more connectors (note that the name 336 * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc. 337 * connectors, not just CRTs). 338 * 339 * Each driver is responsible for filling out this structure at startup time, 340 * in addition to providing other modesetting features, like i2c and DDC 341 * bus accessors. 342 */ 343 struct drm_crtc_funcs { 344 /* Save CRTC state */ 345 void (*save)(struct drm_crtc *crtc); /* suspend? */ 346 /* Restore CRTC state */ 347 void (*restore)(struct drm_crtc *crtc); /* resume? */ 348 /* Reset CRTC state */ 349 void (*reset)(struct drm_crtc *crtc); 350 351 /* cursor controls */ 352 int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv, 353 uint32_t handle, uint32_t width, uint32_t height); 354 int (*cursor_set2)(struct drm_crtc *crtc, struct drm_file *file_priv, 355 uint32_t handle, uint32_t width, uint32_t height, 356 int32_t hot_x, int32_t hot_y); 357 int (*cursor_move)(struct drm_crtc *crtc, int x, int y); 358 359 /* Set gamma on the CRTC */ 360 void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b, 361 uint32_t start, uint32_t size); 362 /* Object destroy routine */ 363 void (*destroy)(struct drm_crtc *crtc); 364 365 int (*set_config)(struct drm_mode_set *set); 366 367 /* 368 * Flip to the given framebuffer. This implements the page 369 * flip ioctl described in drm_mode.h, specifically, the 370 * implementation must return immediately and block all 371 * rendering to the current fb until the flip has completed. 372 * If userspace set the event flag in the ioctl, the event 373 * argument will point to an event to send back when the flip 374 * completes, otherwise it will be NULL. 375 */ 376 int (*page_flip)(struct drm_crtc *crtc, 377 struct drm_framebuffer *fb, 378 struct drm_pending_vblank_event *event, 379 uint32_t flags); 380 381 int (*set_property)(struct drm_crtc *crtc, 382 struct drm_property *property, uint64_t val); 383 }; 384 385 /** 386 * drm_crtc - central CRTC control structure 387 * @dev: parent DRM device 388 * @head: list management 389 * @base: base KMS object for ID tracking etc. 390 * @enabled: is this CRTC enabled? 391 * @mode: current mode timings 392 * @hwmode: mode timings as programmed to hw regs 393 * @invert_dimensions: for purposes of error checking crtc vs fb sizes, 394 * invert the width/height of the crtc. This is used if the driver 395 * is performing 90 or 270 degree rotated scanout 396 * @x: x position on screen 397 * @y: y position on screen 398 * @funcs: CRTC control functions 399 * @gamma_size: size of gamma ramp 400 * @gamma_store: gamma ramp values 401 * @framedur_ns: precise frame timing 402 * @framedur_ns: precise line timing 403 * @pixeldur_ns: precise pixel timing 404 * @helper_private: mid-layer private data 405 * @properties: property tracking for this CRTC 406 * 407 * Each CRTC may have one or more connectors associated with it. This structure 408 * allows the CRTC to be controlled. 409 */ 410 struct drm_crtc { 411 struct drm_device *dev; 412 struct list_head head; 413 414 /** 415 * crtc mutex 416 * 417 * This provides a read lock for the overall crtc state (mode, dpms 418 * state, ...) and a write lock for everything which can be update 419 * without a full modeset (fb, cursor data, ...) 420 */ 421 struct mutex mutex; 422 423 struct drm_mode_object base; 424 425 /* framebuffer the connector is currently bound to */ 426 struct drm_framebuffer *fb; 427 428 /* Temporary tracking of the old fb while a modeset is ongoing. Used 429 * by drm_mode_set_config_internal to implement correct refcounting. */ 430 struct drm_framebuffer *old_fb; 431 432 bool enabled; 433 434 /* Requested mode from modesetting. */ 435 struct drm_display_mode mode; 436 437 /* Programmed mode in hw, after adjustments for encoders, 438 * crtc, panel scaling etc. Needed for timestamping etc. 439 */ 440 struct drm_display_mode hwmode; 441 442 bool invert_dimensions; 443 444 int x, y; 445 const struct drm_crtc_funcs *funcs; 446 447 /* CRTC gamma size for reporting to userspace */ 448 uint32_t gamma_size; 449 uint16_t *gamma_store; 450 451 /* Constants needed for precise vblank and swap timestamping. */ 452 int framedur_ns, linedur_ns, pixeldur_ns; 453 454 /* if you are using the helper */ 455 void *helper_private; 456 457 struct drm_object_properties properties; 458 }; 459 460 461 /** 462 * drm_connector_funcs - control connectors on a given device 463 * @dpms: set power state (see drm_crtc_funcs above) 464 * @save: save connector state 465 * @restore: restore connector state 466 * @reset: reset connector after state has been invalidated (e.g. resume) 467 * @detect: is this connector active? 468 * @fill_modes: fill mode list for this connector 469 * @set_property: property for this connector may need an update 470 * @destroy: make object go away 471 * @force: notify the driver that the connector is forced on 472 * 473 * Each CRTC may have one or more connectors attached to it. The functions 474 * below allow the core DRM code to control connectors, enumerate available modes, 475 * etc. 476 */ 477 struct drm_connector_funcs { 478 void (*dpms)(struct drm_connector *connector, int mode); 479 void (*save)(struct drm_connector *connector); 480 void (*restore)(struct drm_connector *connector); 481 void (*reset)(struct drm_connector *connector); 482 483 /* Check to see if anything is attached to the connector. 484 * @force is set to false whilst polling, true when checking the 485 * connector due to user request. @force can be used by the driver 486 * to avoid expensive, destructive operations during automated 487 * probing. 488 */ 489 enum drm_connector_status (*detect)(struct drm_connector *connector, 490 bool force); 491 int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height); 492 int (*set_property)(struct drm_connector *connector, struct drm_property *property, 493 uint64_t val); 494 void (*destroy)(struct drm_connector *connector); 495 void (*force)(struct drm_connector *connector); 496 }; 497 498 /** 499 * drm_encoder_funcs - encoder controls 500 * @reset: reset state (e.g. at init or resume time) 501 * @destroy: cleanup and free associated data 502 * 503 * Encoders sit between CRTCs and connectors. 504 */ 505 struct drm_encoder_funcs { 506 void (*reset)(struct drm_encoder *encoder); 507 void (*destroy)(struct drm_encoder *encoder); 508 }; 509 510 #define DRM_CONNECTOR_MAX_ENCODER 3 511 512 /** 513 * drm_encoder - central DRM encoder structure 514 * @dev: parent DRM device 515 * @head: list management 516 * @base: base KMS object 517 * @encoder_type: one of the %DRM_MODE_ENCODER_<foo> types in drm_mode.h 518 * @possible_crtcs: bitmask of potential CRTC bindings 519 * @possible_clones: bitmask of potential sibling encoders for cloning 520 * @crtc: currently bound CRTC 521 * @bridge: bridge associated to the encoder 522 * @funcs: control functions 523 * @helper_private: mid-layer private data 524 * 525 * CRTCs drive pixels to encoders, which convert them into signals 526 * appropriate for a given connector or set of connectors. 527 */ 528 struct drm_encoder { 529 struct drm_device *dev; 530 struct list_head head; 531 532 struct drm_mode_object base; 533 int encoder_type; 534 uint32_t possible_crtcs; 535 uint32_t possible_clones; 536 537 struct drm_crtc *crtc; 538 struct drm_bridge *bridge; 539 const struct drm_encoder_funcs *funcs; 540 void *helper_private; 541 }; 542 543 enum drm_connector_force { 544 DRM_FORCE_UNSPECIFIED, 545 DRM_FORCE_OFF, 546 DRM_FORCE_ON, /* force on analog part normally */ 547 DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */ 548 }; 549 550 /* should we poll this connector for connects and disconnects */ 551 /* hot plug detectable */ 552 #define DRM_CONNECTOR_POLL_HPD (1 << 0) 553 /* poll for connections */ 554 #define DRM_CONNECTOR_POLL_CONNECT (1 << 1) 555 /* can cleanly poll for disconnections without flickering the screen */ 556 /* DACs should rarely do this without a lot of testing */ 557 #define DRM_CONNECTOR_POLL_DISCONNECT (1 << 2) 558 559 #define MAX_ELD_BYTES 128 560 561 /** 562 * drm_connector - central DRM connector control structure 563 * @dev: parent DRM device 564 * @kdev: kernel device for sysfs attributes 565 * @attr: sysfs attributes 566 * @head: list management 567 * @base: base KMS object 568 * @connector_type: one of the %DRM_MODE_CONNECTOR_<foo> types from drm_mode.h 569 * @connector_type_id: index into connector type enum 570 * @interlace_allowed: can this connector handle interlaced modes? 571 * @doublescan_allowed: can this connector handle doublescan? 572 * @modes: modes available on this connector (from fill_modes() + user) 573 * @status: one of the drm_connector_status enums (connected, not, or unknown) 574 * @probed_modes: list of modes derived directly from the display 575 * @display_info: information about attached display (e.g. from EDID) 576 * @funcs: connector control functions 577 * @edid_blob_ptr: DRM property containing EDID if present 578 * @properties: property tracking for this connector 579 * @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling 580 * @dpms: current dpms state 581 * @helper_private: mid-layer private data 582 * @force: a %DRM_FORCE_<foo> state for forced mode sets 583 * @encoder_ids: valid encoders for this connector 584 * @encoder: encoder driving this connector, if any 585 * @eld: EDID-like data, if present 586 * @dvi_dual: dual link DVI, if found 587 * @max_tmds_clock: max clock rate, if found 588 * @latency_present: AV delay info from ELD, if found 589 * @video_latency: video latency info from ELD, if found 590 * @audio_latency: audio latency info from ELD, if found 591 * @null_edid_counter: track sinks that give us all zeros for the EDID 592 * 593 * Each connector may be connected to one or more CRTCs, or may be clonable by 594 * another connector if they can share a CRTC. Each connector also has a specific 595 * position in the broader display (referred to as a 'screen' though it could 596 * span multiple monitors). 597 */ 598 struct drm_connector { 599 struct drm_device *dev; 600 struct device *kdev; 601 struct device_attribute *attr; 602 struct list_head head; 603 604 struct drm_mode_object base; 605 606 int connector_type; 607 int connector_type_id; 608 bool interlace_allowed; 609 bool doublescan_allowed; 610 bool stereo_allowed; 611 struct list_head modes; /* list of modes on this connector */ 612 613 enum drm_connector_status status; 614 615 /* these are modes added by probing with DDC or the BIOS */ 616 struct list_head probed_modes; 617 618 struct drm_display_info display_info; 619 const struct drm_connector_funcs *funcs; 620 621 struct drm_property_blob *edid_blob_ptr; 622 struct drm_object_properties properties; 623 624 uint8_t polled; /* DRM_CONNECTOR_POLL_* */ 625 626 /* requested DPMS state */ 627 int dpms; 628 629 void *helper_private; 630 631 /* forced on connector */ 632 enum drm_connector_force force; 633 uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER]; 634 struct drm_encoder *encoder; /* currently active encoder */ 635 636 /* EDID bits */ 637 uint8_t eld[MAX_ELD_BYTES]; 638 bool dvi_dual; 639 int max_tmds_clock; /* in MHz */ 640 bool latency_present[2]; 641 int video_latency[2]; /* [0]: progressive, [1]: interlaced */ 642 int audio_latency[2]; 643 int null_edid_counter; /* needed to workaround some HW bugs where we get all 0s */ 644 unsigned bad_edid_counter; 645 }; 646 647 /** 648 * drm_plane_funcs - driver plane control functions 649 * @update_plane: update the plane configuration 650 * @disable_plane: shut down the plane 651 * @destroy: clean up plane resources 652 * @set_property: called when a property is changed 653 */ 654 struct drm_plane_funcs { 655 int (*update_plane)(struct drm_plane *plane, 656 struct drm_crtc *crtc, struct drm_framebuffer *fb, 657 int crtc_x, int crtc_y, 658 unsigned int crtc_w, unsigned int crtc_h, 659 uint32_t src_x, uint32_t src_y, 660 uint32_t src_w, uint32_t src_h); 661 int (*disable_plane)(struct drm_plane *plane); 662 void (*destroy)(struct drm_plane *plane); 663 664 int (*set_property)(struct drm_plane *plane, 665 struct drm_property *property, uint64_t val); 666 }; 667 668 /** 669 * drm_plane - central DRM plane control structure 670 * @dev: DRM device this plane belongs to 671 * @head: for list management 672 * @base: base mode object 673 * @possible_crtcs: pipes this plane can be bound to 674 * @format_types: array of formats supported by this plane 675 * @format_count: number of formats supported 676 * @crtc: currently bound CRTC 677 * @fb: currently bound fb 678 * @funcs: helper functions 679 * @properties: property tracking for this plane 680 */ 681 struct drm_plane { 682 struct drm_device *dev; 683 struct list_head head; 684 685 struct drm_mode_object base; 686 687 uint32_t possible_crtcs; 688 uint32_t *format_types; 689 uint32_t format_count; 690 691 struct drm_crtc *crtc; 692 struct drm_framebuffer *fb; 693 694 const struct drm_plane_funcs *funcs; 695 696 struct drm_object_properties properties; 697 }; 698 699 /** 700 * drm_bridge_funcs - drm_bridge control functions 701 * @mode_fixup: Try to fixup (or reject entirely) proposed mode for this bridge 702 * @disable: Called right before encoder prepare, disables the bridge 703 * @post_disable: Called right after encoder prepare, for lockstepped disable 704 * @mode_set: Set this mode to the bridge 705 * @pre_enable: Called right before encoder commit, for lockstepped commit 706 * @enable: Called right after encoder commit, enables the bridge 707 * @destroy: make object go away 708 */ 709 struct drm_bridge_funcs { 710 bool (*mode_fixup)(struct drm_bridge *bridge, 711 const struct drm_display_mode *mode, 712 struct drm_display_mode *adjusted_mode); 713 void (*disable)(struct drm_bridge *bridge); 714 void (*post_disable)(struct drm_bridge *bridge); 715 void (*mode_set)(struct drm_bridge *bridge, 716 struct drm_display_mode *mode, 717 struct drm_display_mode *adjusted_mode); 718 void (*pre_enable)(struct drm_bridge *bridge); 719 void (*enable)(struct drm_bridge *bridge); 720 void (*destroy)(struct drm_bridge *bridge); 721 }; 722 723 /** 724 * drm_bridge - central DRM bridge control structure 725 * @dev: DRM device this bridge belongs to 726 * @head: list management 727 * @base: base mode object 728 * @funcs: control functions 729 * @driver_private: pointer to the bridge driver's internal context 730 */ 731 struct drm_bridge { 732 struct drm_device *dev; 733 struct list_head head; 734 735 struct drm_mode_object base; 736 737 const struct drm_bridge_funcs *funcs; 738 void *driver_private; 739 }; 740 741 /** 742 * drm_mode_set - new values for a CRTC config change 743 * @head: list management 744 * @fb: framebuffer to use for new config 745 * @crtc: CRTC whose configuration we're about to change 746 * @mode: mode timings to use 747 * @x: position of this CRTC relative to @fb 748 * @y: position of this CRTC relative to @fb 749 * @connectors: array of connectors to drive with this CRTC if possible 750 * @num_connectors: size of @connectors array 751 * 752 * Represents a single crtc the connectors that it drives with what mode 753 * and from which framebuffer it scans out from. 754 * 755 * This is used to set modes. 756 */ 757 struct drm_mode_set { 758 struct drm_framebuffer *fb; 759 struct drm_crtc *crtc; 760 struct drm_display_mode *mode; 761 762 uint32_t x; 763 uint32_t y; 764 765 struct drm_connector **connectors; 766 size_t num_connectors; 767 }; 768 769 /** 770 * struct drm_mode_config_funcs - basic driver provided mode setting functions 771 * @fb_create: create a new framebuffer object 772 * @output_poll_changed: function to handle output configuration changes 773 * 774 * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that 775 * involve drivers. 776 */ 777 struct drm_mode_config_funcs { 778 struct drm_framebuffer *(*fb_create)(struct drm_device *dev, 779 struct drm_file *file_priv, 780 struct drm_mode_fb_cmd2 *mode_cmd); 781 void (*output_poll_changed)(struct drm_device *dev); 782 }; 783 784 /** 785 * drm_mode_group - group of mode setting resources for potential sub-grouping 786 * @num_crtcs: CRTC count 787 * @num_encoders: encoder count 788 * @num_connectors: connector count 789 * @id_list: list of KMS object IDs in this group 790 * 791 * Currently this simply tracks the global mode setting state. But in the 792 * future it could allow groups of objects to be set aside into independent 793 * control groups for use by different user level processes (e.g. two X servers 794 * running simultaneously on different heads, each with their own mode 795 * configuration and freedom of mode setting). 796 */ 797 struct drm_mode_group { 798 uint32_t num_crtcs; 799 uint32_t num_encoders; 800 uint32_t num_connectors; 801 uint32_t num_bridges; 802 803 /* list of object IDs for this group */ 804 uint32_t *id_list; 805 }; 806 807 /** 808 * drm_mode_config - Mode configuration control structure 809 * @mutex: mutex protecting KMS related lists and structures 810 * @idr_mutex: mutex for KMS ID allocation and management 811 * @crtc_idr: main KMS ID tracking object 812 * @num_fb: number of fbs available 813 * @fb_list: list of framebuffers available 814 * @num_connector: number of connectors on this device 815 * @connector_list: list of connector objects 816 * @num_bridge: number of bridges on this device 817 * @bridge_list: list of bridge objects 818 * @num_encoder: number of encoders on this device 819 * @encoder_list: list of encoder objects 820 * @num_crtc: number of CRTCs on this device 821 * @crtc_list: list of CRTC objects 822 * @min_width: minimum pixel width on this device 823 * @min_height: minimum pixel height on this device 824 * @max_width: maximum pixel width on this device 825 * @max_height: maximum pixel height on this device 826 * @funcs: core driver provided mode setting functions 827 * @fb_base: base address of the framebuffer 828 * @poll_enabled: track polling status for this device 829 * @output_poll_work: delayed work for polling in process context 830 * @*_property: core property tracking 831 * 832 * Core mode resource tracking structure. All CRTC, encoders, and connectors 833 * enumerated by the driver are added here, as are global properties. Some 834 * global restrictions are also here, e.g. dimension restrictions. 835 */ 836 struct drm_mode_config { 837 struct mutex mutex; /* protects configuration (mode lists etc.) */ 838 struct mutex idr_mutex; /* for IDR management */ 839 struct idr crtc_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */ 840 /* this is limited to one for now */ 841 842 843 /** 844 * fb_lock - mutex to protect fb state 845 * 846 * Besides the global fb list his also protects the fbs list in the 847 * file_priv 848 */ 849 struct mutex fb_lock; 850 int num_fb; 851 struct list_head fb_list; 852 853 int num_connector; 854 struct list_head connector_list; 855 int num_bridge; 856 struct list_head bridge_list; 857 int num_encoder; 858 struct list_head encoder_list; 859 int num_plane; 860 struct list_head plane_list; 861 862 int num_crtc; 863 struct list_head crtc_list; 864 865 struct list_head property_list; 866 867 int min_width, min_height; 868 int max_width, max_height; 869 const struct drm_mode_config_funcs *funcs; 870 resource_size_t fb_base; 871 872 /* output poll support */ 873 bool poll_enabled; 874 bool poll_running; 875 struct delayed_work output_poll_work; 876 877 /* pointers to standard properties */ 878 struct list_head property_blob_list; 879 struct drm_property *edid_property; 880 struct drm_property *dpms_property; 881 882 /* DVI-I properties */ 883 struct drm_property *dvi_i_subconnector_property; 884 struct drm_property *dvi_i_select_subconnector_property; 885 886 /* TV properties */ 887 struct drm_property *tv_subconnector_property; 888 struct drm_property *tv_select_subconnector_property; 889 struct drm_property *tv_mode_property; 890 struct drm_property *tv_left_margin_property; 891 struct drm_property *tv_right_margin_property; 892 struct drm_property *tv_top_margin_property; 893 struct drm_property *tv_bottom_margin_property; 894 struct drm_property *tv_brightness_property; 895 struct drm_property *tv_contrast_property; 896 struct drm_property *tv_flicker_reduction_property; 897 struct drm_property *tv_overscan_property; 898 struct drm_property *tv_saturation_property; 899 struct drm_property *tv_hue_property; 900 901 /* Optional properties */ 902 struct drm_property *scaling_mode_property; 903 struct drm_property *dirty_info_property; 904 905 /* dumb ioctl parameters */ 906 uint32_t preferred_depth, prefer_shadow; 907 908 /* whether async page flip is supported or not */ 909 bool async_page_flip; 910 }; 911 912 #define obj_to_crtc(x) container_of(x, struct drm_crtc, base) 913 #define obj_to_connector(x) container_of(x, struct drm_connector, base) 914 #define obj_to_encoder(x) container_of(x, struct drm_encoder, base) 915 #define obj_to_mode(x) container_of(x, struct drm_display_mode, base) 916 #define obj_to_fb(x) container_of(x, struct drm_framebuffer, base) 917 #define obj_to_property(x) container_of(x, struct drm_property, base) 918 #define obj_to_blob(x) container_of(x, struct drm_property_blob, base) 919 #define obj_to_plane(x) container_of(x, struct drm_plane, base) 920 921 struct drm_prop_enum_list { 922 int type; 923 char *name; 924 }; 925 926 extern void drm_modeset_lock_all(struct drm_device *dev); 927 extern void drm_modeset_unlock_all(struct drm_device *dev); 928 extern void drm_warn_on_modeset_not_all_locked(struct drm_device *dev); 929 930 extern int drm_crtc_init(struct drm_device *dev, 931 struct drm_crtc *crtc, 932 const struct drm_crtc_funcs *funcs); 933 extern void drm_crtc_cleanup(struct drm_crtc *crtc); 934 extern unsigned int drm_crtc_index(struct drm_crtc *crtc); 935 936 /** 937 * drm_crtc_mask - find the mask of a registered CRTC 938 * @crtc: CRTC to find mask for 939 * 940 * Given a registered CRTC, return the mask bit of that CRTC for an 941 * encoder's possible_crtcs field. 942 */ 943 static inline uint32_t drm_crtc_mask(struct drm_crtc *crtc) 944 { 945 return 1 << drm_crtc_index(crtc); 946 } 947 948 extern void drm_connector_ida_init(void); 949 extern void drm_connector_ida_destroy(void); 950 extern int drm_connector_init(struct drm_device *dev, 951 struct drm_connector *connector, 952 const struct drm_connector_funcs *funcs, 953 int connector_type); 954 955 extern void drm_connector_cleanup(struct drm_connector *connector); 956 /* helper to unplug all connectors from sysfs for device */ 957 extern void drm_connector_unplug_all(struct drm_device *dev); 958 959 extern int drm_bridge_init(struct drm_device *dev, struct drm_bridge *bridge, 960 const struct drm_bridge_funcs *funcs); 961 extern void drm_bridge_cleanup(struct drm_bridge *bridge); 962 963 extern int drm_encoder_init(struct drm_device *dev, 964 struct drm_encoder *encoder, 965 const struct drm_encoder_funcs *funcs, 966 int encoder_type); 967 968 /** 969 * drm_encoder_crtc_ok - can a given crtc drive a given encoder? 970 * @encoder: encoder to test 971 * @crtc: crtc to test 972 * 973 * Return false if @encoder can't be driven by @crtc, true otherwise. 974 */ 975 static inline bool drm_encoder_crtc_ok(struct drm_encoder *encoder, 976 struct drm_crtc *crtc) 977 { 978 return !!(encoder->possible_crtcs & drm_crtc_mask(crtc)); 979 } 980 981 extern int drm_plane_init(struct drm_device *dev, 982 struct drm_plane *plane, 983 unsigned long possible_crtcs, 984 const struct drm_plane_funcs *funcs, 985 const uint32_t *formats, uint32_t format_count, 986 bool priv); 987 extern void drm_plane_cleanup(struct drm_plane *plane); 988 extern void drm_plane_force_disable(struct drm_plane *plane); 989 990 extern void drm_encoder_cleanup(struct drm_encoder *encoder); 991 992 extern const char *drm_get_connector_name(const struct drm_connector *connector); 993 extern const char *drm_get_connector_status_name(enum drm_connector_status status); 994 extern const char *drm_get_dpms_name(int val); 995 extern const char *drm_get_dvi_i_subconnector_name(int val); 996 extern const char *drm_get_dvi_i_select_name(int val); 997 extern const char *drm_get_tv_subconnector_name(int val); 998 extern const char *drm_get_tv_select_name(int val); 999 extern void drm_fb_release(struct drm_file *file_priv); 1000 extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group); 1001 extern bool drm_probe_ddc(struct i2c_adapter *adapter); 1002 extern struct edid *drm_get_edid(struct drm_connector *connector, 1003 struct i2c_adapter *adapter); 1004 extern struct edid *drm_edid_duplicate(const struct edid *edid); 1005 extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid); 1006 extern void drm_mode_probed_add(struct drm_connector *connector, struct drm_display_mode *mode); 1007 extern void drm_mode_copy(struct drm_display_mode *dst, const struct drm_display_mode *src); 1008 extern struct drm_display_mode *drm_mode_duplicate(struct drm_device *dev, 1009 const struct drm_display_mode *mode); 1010 extern void drm_mode_debug_printmodeline(const struct drm_display_mode *mode); 1011 extern void drm_mode_config_init(struct drm_device *dev); 1012 extern void drm_mode_config_reset(struct drm_device *dev); 1013 extern void drm_mode_config_cleanup(struct drm_device *dev); 1014 extern void drm_mode_set_name(struct drm_display_mode *mode); 1015 extern bool drm_mode_equal(const struct drm_display_mode *mode1, const struct drm_display_mode *mode2); 1016 extern bool drm_mode_equal_no_clocks_no_stereo(const struct drm_display_mode *mode1, const struct drm_display_mode *mode2); 1017 extern int drm_mode_width(const struct drm_display_mode *mode); 1018 extern int drm_mode_height(const struct drm_display_mode *mode); 1019 1020 /* for us by fb module */ 1021 extern struct drm_display_mode *drm_mode_create(struct drm_device *dev); 1022 extern void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode); 1023 extern void drm_mode_validate_size(struct drm_device *dev, 1024 struct list_head *mode_list, 1025 int maxX, int maxY, int maxPitch); 1026 extern void drm_mode_prune_invalid(struct drm_device *dev, 1027 struct list_head *mode_list, bool verbose); 1028 extern void drm_mode_sort(struct list_head *mode_list); 1029 extern int drm_mode_hsync(const struct drm_display_mode *mode); 1030 extern int drm_mode_vrefresh(const struct drm_display_mode *mode); 1031 extern void drm_mode_set_crtcinfo(struct drm_display_mode *p, 1032 int adjust_flags); 1033 extern void drm_mode_connector_list_update(struct drm_connector *connector); 1034 extern int drm_mode_connector_update_edid_property(struct drm_connector *connector, 1035 struct edid *edid); 1036 extern int drm_object_property_set_value(struct drm_mode_object *obj, 1037 struct drm_property *property, 1038 uint64_t val); 1039 extern int drm_object_property_get_value(struct drm_mode_object *obj, 1040 struct drm_property *property, 1041 uint64_t *value); 1042 extern int drm_framebuffer_init(struct drm_device *dev, 1043 struct drm_framebuffer *fb, 1044 const struct drm_framebuffer_funcs *funcs); 1045 extern struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev, 1046 uint32_t id); 1047 extern void drm_framebuffer_unreference(struct drm_framebuffer *fb); 1048 extern void drm_framebuffer_reference(struct drm_framebuffer *fb); 1049 extern void drm_framebuffer_remove(struct drm_framebuffer *fb); 1050 extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb); 1051 extern void drm_framebuffer_unregister_private(struct drm_framebuffer *fb); 1052 1053 extern void drm_object_attach_property(struct drm_mode_object *obj, 1054 struct drm_property *property, 1055 uint64_t init_val); 1056 extern struct drm_property *drm_property_create(struct drm_device *dev, int flags, 1057 const char *name, int num_values); 1058 extern struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags, 1059 const char *name, 1060 const struct drm_prop_enum_list *props, 1061 int num_values); 1062 struct drm_property *drm_property_create_bitmask(struct drm_device *dev, 1063 int flags, const char *name, 1064 const struct drm_prop_enum_list *props, 1065 int num_values); 1066 struct drm_property *drm_property_create_range(struct drm_device *dev, int flags, 1067 const char *name, 1068 uint64_t min, uint64_t max); 1069 extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property); 1070 extern int drm_property_add_enum(struct drm_property *property, int index, 1071 uint64_t value, const char *name); 1072 extern int drm_mode_create_dvi_i_properties(struct drm_device *dev); 1073 extern int drm_mode_create_tv_properties(struct drm_device *dev, int num_formats, 1074 char *formats[]); 1075 extern int drm_mode_create_scaling_mode_property(struct drm_device *dev); 1076 extern int drm_mode_create_dirty_info_property(struct drm_device *dev); 1077 extern const char *drm_get_encoder_name(const struct drm_encoder *encoder); 1078 1079 extern int drm_mode_connector_attach_encoder(struct drm_connector *connector, 1080 struct drm_encoder *encoder); 1081 extern void drm_mode_connector_detach_encoder(struct drm_connector *connector, 1082 struct drm_encoder *encoder); 1083 extern int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc, 1084 int gamma_size); 1085 extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev, 1086 uint32_t id, uint32_t type); 1087 /* IOCTLs */ 1088 extern int drm_mode_getresources(struct drm_device *dev, 1089 void *data, struct drm_file *file_priv); 1090 extern int drm_mode_getplane_res(struct drm_device *dev, void *data, 1091 struct drm_file *file_priv); 1092 extern int drm_mode_getcrtc(struct drm_device *dev, 1093 void *data, struct drm_file *file_priv); 1094 extern int drm_mode_getconnector(struct drm_device *dev, 1095 void *data, struct drm_file *file_priv); 1096 extern int drm_mode_set_config_internal(struct drm_mode_set *set); 1097 extern int drm_mode_setcrtc(struct drm_device *dev, 1098 void *data, struct drm_file *file_priv); 1099 extern int drm_mode_getplane(struct drm_device *dev, 1100 void *data, struct drm_file *file_priv); 1101 extern int drm_mode_setplane(struct drm_device *dev, 1102 void *data, struct drm_file *file_priv); 1103 extern int drm_mode_cursor_ioctl(struct drm_device *dev, 1104 void *data, struct drm_file *file_priv); 1105 extern int drm_mode_cursor2_ioctl(struct drm_device *dev, 1106 void *data, struct drm_file *file_priv); 1107 extern int drm_mode_addfb(struct drm_device *dev, 1108 void *data, struct drm_file *file_priv); 1109 extern int drm_mode_addfb2(struct drm_device *dev, 1110 void *data, struct drm_file *file_priv); 1111 extern uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth); 1112 extern int drm_mode_rmfb(struct drm_device *dev, 1113 void *data, struct drm_file *file_priv); 1114 extern int drm_mode_getfb(struct drm_device *dev, 1115 void *data, struct drm_file *file_priv); 1116 extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev, 1117 void *data, struct drm_file *file_priv); 1118 1119 extern int drm_mode_getproperty_ioctl(struct drm_device *dev, 1120 void *data, struct drm_file *file_priv); 1121 extern int drm_mode_getblob_ioctl(struct drm_device *dev, 1122 void *data, struct drm_file *file_priv); 1123 extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev, 1124 void *data, struct drm_file *file_priv); 1125 extern int drm_mode_getencoder(struct drm_device *dev, 1126 void *data, struct drm_file *file_priv); 1127 extern int drm_mode_gamma_get_ioctl(struct drm_device *dev, 1128 void *data, struct drm_file *file_priv); 1129 extern int drm_mode_gamma_set_ioctl(struct drm_device *dev, 1130 void *data, struct drm_file *file_priv); 1131 extern u8 drm_match_cea_mode(const struct drm_display_mode *to_match); 1132 extern bool drm_detect_hdmi_monitor(struct edid *edid); 1133 extern bool drm_detect_monitor_audio(struct edid *edid); 1134 extern bool drm_rgb_quant_range_selectable(struct edid *edid); 1135 extern int drm_mode_page_flip_ioctl(struct drm_device *dev, 1136 void *data, struct drm_file *file_priv); 1137 extern struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, 1138 int hdisplay, int vdisplay, int vrefresh, 1139 bool reduced, bool interlaced, bool margins); 1140 extern struct drm_display_mode *drm_gtf_mode(struct drm_device *dev, 1141 int hdisplay, int vdisplay, int vrefresh, 1142 bool interlaced, int margins); 1143 extern struct drm_display_mode *drm_gtf_mode_complex(struct drm_device *dev, 1144 int hdisplay, int vdisplay, int vrefresh, 1145 bool interlaced, int margins, int GTF_M, 1146 int GTF_2C, int GTF_K, int GTF_2J); 1147 extern int drm_add_modes_noedid(struct drm_connector *connector, 1148 int hdisplay, int vdisplay); 1149 extern void drm_set_preferred_mode(struct drm_connector *connector, 1150 int hpref, int vpref); 1151 1152 extern int drm_edid_header_is_valid(const u8 *raw_edid); 1153 extern bool drm_edid_block_valid(u8 *raw_edid, int block, bool print_bad_edid); 1154 extern bool drm_edid_is_valid(struct edid *edid); 1155 struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev, 1156 int hsize, int vsize, int fresh, 1157 bool rb); 1158 1159 extern int drm_mode_create_dumb_ioctl(struct drm_device *dev, 1160 void *data, struct drm_file *file_priv); 1161 extern int drm_mode_mmap_dumb_ioctl(struct drm_device *dev, 1162 void *data, struct drm_file *file_priv); 1163 extern int drm_mode_destroy_dumb_ioctl(struct drm_device *dev, 1164 void *data, struct drm_file *file_priv); 1165 extern int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data, 1166 struct drm_file *file_priv); 1167 extern int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data, 1168 struct drm_file *file_priv); 1169 1170 extern void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth, 1171 int *bpp); 1172 extern int drm_format_num_planes(uint32_t format); 1173 extern int drm_format_plane_cpp(uint32_t format, int plane); 1174 extern int drm_format_horz_chroma_subsampling(uint32_t format); 1175 extern int drm_format_vert_chroma_subsampling(uint32_t format); 1176 extern const char *drm_get_format_name(uint32_t format); 1177 1178 /* Helpers */ 1179 static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev, 1180 uint32_t id) 1181 { 1182 struct drm_mode_object *mo; 1183 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CRTC); 1184 return mo ? obj_to_crtc(mo) : NULL; 1185 } 1186 1187 static inline struct drm_encoder *drm_encoder_find(struct drm_device *dev, 1188 uint32_t id) 1189 { 1190 struct drm_mode_object *mo; 1191 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_ENCODER); 1192 return mo ? obj_to_encoder(mo) : NULL; 1193 } 1194 1195 #endif /* __DRM_CRTC_H__ */ 1196