Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 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 | |
| 33 | #include <linux/fb.h> |
| 34 | |
| 35 | struct drm_device; |
| 36 | struct drm_mode_set; |
| 37 | struct drm_framebuffer; |
| 38 | |
| 39 | |
| 40 | #define DRM_MODE_OBJECT_CRTC 0xcccccccc |
| 41 | #define DRM_MODE_OBJECT_CONNECTOR 0xc0c0c0c0 |
| 42 | #define DRM_MODE_OBJECT_ENCODER 0xe0e0e0e0 |
| 43 | #define DRM_MODE_OBJECT_MODE 0xdededede |
| 44 | #define DRM_MODE_OBJECT_PROPERTY 0xb0b0b0b0 |
| 45 | #define DRM_MODE_OBJECT_FB 0xfbfbfbfb |
| 46 | #define DRM_MODE_OBJECT_BLOB 0xbbbbbbbb |
| 47 | |
| 48 | struct drm_mode_object { |
| 49 | uint32_t id; |
| 50 | uint32_t type; |
| 51 | }; |
| 52 | |
| 53 | /* |
| 54 | * Note on terminology: here, for brevity and convenience, we refer to connector |
| 55 | * control chips as 'CRTCs'. They can control any type of connector, VGA, LVDS, |
| 56 | * DVI, etc. And 'screen' refers to the whole of the visible display, which |
| 57 | * may span multiple monitors (and therefore multiple CRTC and connector |
| 58 | * structures). |
| 59 | */ |
| 60 | |
| 61 | enum drm_mode_status { |
| 62 | MODE_OK = 0, /* Mode OK */ |
| 63 | MODE_HSYNC, /* hsync out of range */ |
| 64 | MODE_VSYNC, /* vsync out of range */ |
| 65 | MODE_H_ILLEGAL, /* mode has illegal horizontal timings */ |
| 66 | MODE_V_ILLEGAL, /* mode has illegal horizontal timings */ |
| 67 | MODE_BAD_WIDTH, /* requires an unsupported linepitch */ |
| 68 | MODE_NOMODE, /* no mode with a maching name */ |
| 69 | MODE_NO_INTERLACE, /* interlaced mode not supported */ |
| 70 | MODE_NO_DBLESCAN, /* doublescan mode not supported */ |
| 71 | MODE_NO_VSCAN, /* multiscan mode not supported */ |
| 72 | MODE_MEM, /* insufficient video memory */ |
| 73 | MODE_VIRTUAL_X, /* mode width too large for specified virtual size */ |
| 74 | MODE_VIRTUAL_Y, /* mode height too large for specified virtual size */ |
| 75 | MODE_MEM_VIRT, /* insufficient video memory given virtual size */ |
| 76 | MODE_NOCLOCK, /* no fixed clock available */ |
| 77 | MODE_CLOCK_HIGH, /* clock required is too high */ |
| 78 | MODE_CLOCK_LOW, /* clock required is too low */ |
| 79 | MODE_CLOCK_RANGE, /* clock/mode isn't in a ClockRange */ |
| 80 | MODE_BAD_HVALUE, /* horizontal timing was out of range */ |
| 81 | MODE_BAD_VVALUE, /* vertical timing was out of range */ |
| 82 | MODE_BAD_VSCAN, /* VScan value out of range */ |
| 83 | MODE_HSYNC_NARROW, /* horizontal sync too narrow */ |
| 84 | MODE_HSYNC_WIDE, /* horizontal sync too wide */ |
| 85 | MODE_HBLANK_NARROW, /* horizontal blanking too narrow */ |
| 86 | MODE_HBLANK_WIDE, /* horizontal blanking too wide */ |
| 87 | MODE_VSYNC_NARROW, /* vertical sync too narrow */ |
| 88 | MODE_VSYNC_WIDE, /* vertical sync too wide */ |
| 89 | MODE_VBLANK_NARROW, /* vertical blanking too narrow */ |
| 90 | MODE_VBLANK_WIDE, /* vertical blanking too wide */ |
| 91 | MODE_PANEL, /* exceeds panel dimensions */ |
| 92 | MODE_INTERLACE_WIDTH, /* width too large for interlaced mode */ |
| 93 | MODE_ONE_WIDTH, /* only one width is supported */ |
| 94 | MODE_ONE_HEIGHT, /* only one height is supported */ |
| 95 | MODE_ONE_SIZE, /* only one resolution is supported */ |
| 96 | MODE_NO_REDUCED, /* monitor doesn't accept reduced blanking */ |
| 97 | MODE_UNVERIFIED = -3, /* mode needs to reverified */ |
| 98 | MODE_BAD = -2, /* unspecified reason */ |
| 99 | MODE_ERROR = -1 /* error condition */ |
| 100 | }; |
| 101 | |
| 102 | #define DRM_MODE_TYPE_CLOCK_CRTC_C (DRM_MODE_TYPE_CLOCK_C | \ |
| 103 | DRM_MODE_TYPE_CRTC_C) |
| 104 | |
| 105 | #define DRM_MODE(nm, t, c, hd, hss, hse, ht, hsk, vd, vss, vse, vt, vs, f) \ |
| 106 | .name = nm, .status = 0, .type = (t), .clock = (c), \ |
| 107 | .hdisplay = (hd), .hsync_start = (hss), .hsync_end = (hse), \ |
| 108 | .htotal = (ht), .hskew = (hsk), .vdisplay = (vd), \ |
| 109 | .vsync_start = (vss), .vsync_end = (vse), .vtotal = (vt), \ |
| 110 | .vscan = (vs), .flags = (f), .vrefresh = 0 |
| 111 | |
| 112 | #define CRTC_INTERLACE_HALVE_V 0x1 /* halve V values for interlacing */ |
| 113 | |
| 114 | struct drm_display_mode { |
| 115 | /* Header */ |
| 116 | struct list_head head; |
| 117 | struct drm_mode_object base; |
| 118 | |
| 119 | char name[DRM_DISPLAY_MODE_LEN]; |
| 120 | |
| 121 | int connector_count; |
| 122 | enum drm_mode_status status; |
| 123 | int type; |
| 124 | |
| 125 | /* Proposed mode values */ |
Adam Jackson | 7ac96a9 | 2009-12-03 17:44:37 -0500 | [diff] [blame] | 126 | int clock; /* in kHz */ |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 127 | int hdisplay; |
| 128 | int hsync_start; |
| 129 | int hsync_end; |
| 130 | int htotal; |
| 131 | int hskew; |
| 132 | int vdisplay; |
| 133 | int vsync_start; |
| 134 | int vsync_end; |
| 135 | int vtotal; |
| 136 | int vscan; |
| 137 | unsigned int flags; |
| 138 | |
| 139 | /* Addressable image size (may be 0 for projectors, etc.) */ |
| 140 | int width_mm; |
| 141 | int height_mm; |
| 142 | |
| 143 | /* Actual mode we give to hw */ |
| 144 | int clock_index; |
| 145 | int synth_clock; |
| 146 | int crtc_hdisplay; |
| 147 | int crtc_hblank_start; |
| 148 | int crtc_hblank_end; |
| 149 | int crtc_hsync_start; |
| 150 | int crtc_hsync_end; |
| 151 | int crtc_htotal; |
| 152 | int crtc_hskew; |
| 153 | int crtc_vdisplay; |
| 154 | int crtc_vblank_start; |
| 155 | int crtc_vblank_end; |
| 156 | int crtc_vsync_start; |
| 157 | int crtc_vsync_end; |
| 158 | int crtc_vtotal; |
| 159 | int crtc_hadjusted; |
| 160 | int crtc_vadjusted; |
| 161 | |
| 162 | /* Driver private mode info */ |
| 163 | int private_size; |
| 164 | int *private; |
| 165 | int private_flags; |
| 166 | |
Adam Jackson | 7ac96a9 | 2009-12-03 17:44:37 -0500 | [diff] [blame] | 167 | int vrefresh; /* in Hz */ |
| 168 | int hsync; /* in kHz */ |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 169 | }; |
| 170 | |
| 171 | enum drm_connector_status { |
| 172 | connector_status_connected = 1, |
| 173 | connector_status_disconnected = 2, |
| 174 | connector_status_unknown = 3, |
| 175 | }; |
| 176 | |
| 177 | enum subpixel_order { |
| 178 | SubPixelUnknown = 0, |
| 179 | SubPixelHorizontalRGB, |
| 180 | SubPixelHorizontalBGR, |
| 181 | SubPixelVerticalRGB, |
| 182 | SubPixelVerticalBGR, |
| 183 | SubPixelNone, |
| 184 | }; |
| 185 | |
| 186 | |
| 187 | /* |
| 188 | * Describes a given display (e.g. CRT or flat panel) and its limitations. |
| 189 | */ |
| 190 | struct drm_display_info { |
| 191 | char name[DRM_DISPLAY_INFO_LEN]; |
| 192 | /* Input info */ |
| 193 | bool serration_vsync; |
| 194 | bool sync_on_green; |
| 195 | bool composite_sync; |
| 196 | bool separate_syncs; |
| 197 | bool blank_to_black; |
| 198 | unsigned char video_level; |
| 199 | bool digital; |
| 200 | /* Physical size */ |
| 201 | unsigned int width_mm; |
| 202 | unsigned int height_mm; |
| 203 | |
| 204 | /* Display parameters */ |
| 205 | unsigned char gamma; /* FIXME: storage format */ |
| 206 | bool gtf_supported; |
| 207 | bool standard_color; |
| 208 | enum { |
| 209 | monochrome = 0, |
| 210 | rgb, |
| 211 | other, |
| 212 | unknown, |
| 213 | } display_type; |
| 214 | bool active_off_supported; |
| 215 | bool suspend_supported; |
| 216 | bool standby_supported; |
| 217 | |
| 218 | /* Color info FIXME: storage format */ |
| 219 | unsigned short redx, redy; |
| 220 | unsigned short greenx, greeny; |
| 221 | unsigned short bluex, bluey; |
| 222 | unsigned short whitex, whitey; |
| 223 | |
| 224 | /* Clock limits FIXME: storage format */ |
| 225 | unsigned int min_vfreq, max_vfreq; |
| 226 | unsigned int min_hfreq, max_hfreq; |
| 227 | unsigned int pixel_clock; |
| 228 | |
| 229 | /* White point indices FIXME: storage format */ |
| 230 | unsigned int wpx1, wpy1; |
| 231 | unsigned int wpgamma1; |
| 232 | unsigned int wpx2, wpy2; |
| 233 | unsigned int wpgamma2; |
| 234 | |
| 235 | enum subpixel_order subpixel_order; |
| 236 | |
| 237 | char *raw_edid; /* if any */ |
| 238 | }; |
| 239 | |
| 240 | struct drm_framebuffer_funcs { |
| 241 | void (*destroy)(struct drm_framebuffer *framebuffer); |
| 242 | int (*create_handle)(struct drm_framebuffer *fb, |
| 243 | struct drm_file *file_priv, |
| 244 | unsigned int *handle); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 245 | /** |
| 246 | * Optinal callback for the dirty fb ioctl. |
| 247 | * |
| 248 | * Userspace can notify the driver via this callback |
| 249 | * that a area of the framebuffer has changed and should |
| 250 | * be flushed to the display hardware. |
| 251 | * |
| 252 | * See documentation in drm_mode.h for the struct |
| 253 | * drm_mode_fb_dirty_cmd for more information as all |
| 254 | * the semantics and arguments have a one to one mapping |
| 255 | * on this function. |
| 256 | */ |
| 257 | int (*dirty)(struct drm_framebuffer *framebuffer, unsigned flags, |
| 258 | unsigned color, struct drm_clip_rect *clips, |
| 259 | unsigned num_clips); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 260 | }; |
| 261 | |
| 262 | struct drm_framebuffer { |
| 263 | struct drm_device *dev; |
| 264 | struct list_head head; |
| 265 | struct drm_mode_object base; |
| 266 | const struct drm_framebuffer_funcs *funcs; |
| 267 | unsigned int pitch; |
| 268 | unsigned int width; |
| 269 | unsigned int height; |
| 270 | /* depth can be 15 or 16 */ |
| 271 | unsigned int depth; |
| 272 | int bits_per_pixel; |
| 273 | int flags; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 274 | struct list_head filp_head; |
Dave Airlie | 785b93e | 2009-08-28 15:46:53 +1000 | [diff] [blame] | 275 | /* if you are using the helper */ |
| 276 | void *helper_private; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 277 | }; |
| 278 | |
| 279 | struct drm_property_blob { |
| 280 | struct drm_mode_object base; |
| 281 | struct list_head head; |
| 282 | unsigned int length; |
| 283 | void *data; |
| 284 | }; |
| 285 | |
| 286 | struct drm_property_enum { |
| 287 | uint64_t value; |
| 288 | struct list_head head; |
| 289 | char name[DRM_PROP_NAME_LEN]; |
| 290 | }; |
| 291 | |
| 292 | struct drm_property { |
| 293 | struct list_head head; |
| 294 | struct drm_mode_object base; |
| 295 | uint32_t flags; |
| 296 | char name[DRM_PROP_NAME_LEN]; |
| 297 | uint32_t num_values; |
| 298 | uint64_t *values; |
| 299 | |
| 300 | struct list_head enum_blob_list; |
| 301 | }; |
| 302 | |
| 303 | struct drm_crtc; |
| 304 | struct drm_connector; |
| 305 | struct drm_encoder; |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 306 | struct drm_pending_vblank_event; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 307 | |
| 308 | /** |
| 309 | * drm_crtc_funcs - control CRTCs for a given device |
| 310 | * @dpms: control display power levels |
| 311 | * @save: save CRTC state |
| 312 | * @resore: restore CRTC state |
| 313 | * @lock: lock the CRTC |
| 314 | * @unlock: unlock the CRTC |
| 315 | * @shadow_allocate: allocate shadow pixmap |
| 316 | * @shadow_create: create shadow pixmap for rotation support |
| 317 | * @shadow_destroy: free shadow pixmap |
| 318 | * @mode_fixup: fixup proposed mode |
| 319 | * @mode_set: set the desired mode on the CRTC |
| 320 | * @gamma_set: specify color ramp for CRTC |
| 321 | * @destroy: deinit and free object. |
| 322 | * |
| 323 | * The drm_crtc_funcs structure is the central CRTC management structure |
| 324 | * in the DRM. Each CRTC controls one or more connectors (note that the name |
| 325 | * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc. |
| 326 | * connectors, not just CRTs). |
| 327 | * |
| 328 | * Each driver is responsible for filling out this structure at startup time, |
| 329 | * in addition to providing other modesetting features, like i2c and DDC |
| 330 | * bus accessors. |
| 331 | */ |
| 332 | struct drm_crtc_funcs { |
| 333 | /* Save CRTC state */ |
| 334 | void (*save)(struct drm_crtc *crtc); /* suspend? */ |
| 335 | /* Restore CRTC state */ |
| 336 | void (*restore)(struct drm_crtc *crtc); /* resume? */ |
| 337 | |
| 338 | /* cursor controls */ |
| 339 | int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv, |
| 340 | uint32_t handle, uint32_t width, uint32_t height); |
| 341 | int (*cursor_move)(struct drm_crtc *crtc, int x, int y); |
| 342 | |
| 343 | /* Set gamma on the CRTC */ |
| 344 | void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b, |
| 345 | uint32_t size); |
| 346 | /* Object destroy routine */ |
| 347 | void (*destroy)(struct drm_crtc *crtc); |
| 348 | |
| 349 | int (*set_config)(struct drm_mode_set *set); |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 350 | |
| 351 | /* |
| 352 | * Flip to the given framebuffer. This implements the page |
| 353 | * flip ioctl descibed in drm_mode.h, specifically, the |
| 354 | * implementation must return immediately and block all |
| 355 | * rendering to the current fb until the flip has completed. |
| 356 | * If userspace set the event flag in the ioctl, the event |
| 357 | * argument will point to an event to send back when the flip |
| 358 | * completes, otherwise it will be NULL. |
| 359 | */ |
| 360 | int (*page_flip)(struct drm_crtc *crtc, |
| 361 | struct drm_framebuffer *fb, |
| 362 | struct drm_pending_vblank_event *event); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 363 | }; |
| 364 | |
| 365 | /** |
| 366 | * drm_crtc - central CRTC control structure |
| 367 | * @enabled: is this CRTC enabled? |
| 368 | * @x: x position on screen |
| 369 | * @y: y position on screen |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 370 | * @funcs: CRTC control functions |
| 371 | * |
| 372 | * Each CRTC may have one or more connectors associated with it. This structure |
| 373 | * allows the CRTC to be controlled. |
| 374 | */ |
| 375 | struct drm_crtc { |
| 376 | struct drm_device *dev; |
| 377 | struct list_head head; |
| 378 | |
| 379 | struct drm_mode_object base; |
| 380 | |
| 381 | /* framebuffer the connector is currently bound to */ |
| 382 | struct drm_framebuffer *fb; |
| 383 | |
| 384 | bool enabled; |
| 385 | |
| 386 | struct drm_display_mode mode; |
| 387 | |
| 388 | int x, y; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 389 | const struct drm_crtc_funcs *funcs; |
| 390 | |
| 391 | /* CRTC gamma size for reporting to userspace */ |
| 392 | uint32_t gamma_size; |
| 393 | uint16_t *gamma_store; |
| 394 | |
| 395 | /* if you are using the helper */ |
| 396 | void *helper_private; |
| 397 | }; |
| 398 | |
| 399 | |
| 400 | /** |
| 401 | * drm_connector_funcs - control connectors on a given device |
| 402 | * @dpms: set power state (see drm_crtc_funcs above) |
| 403 | * @save: save connector state |
| 404 | * @restore: restore connector state |
| 405 | * @mode_valid: is this mode valid on the given connector? |
| 406 | * @mode_fixup: try to fixup proposed mode for this connector |
| 407 | * @mode_set: set this mode |
| 408 | * @detect: is this connector active? |
| 409 | * @get_modes: get mode list for this connector |
| 410 | * @set_property: property for this connector may need update |
| 411 | * @destroy: make object go away |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 412 | * @force: notify the driver the connector is forced on |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 413 | * |
| 414 | * Each CRTC may have one or more connectors attached to it. The functions |
| 415 | * below allow the core DRM code to control connectors, enumerate available modes, |
| 416 | * etc. |
| 417 | */ |
| 418 | struct drm_connector_funcs { |
| 419 | void (*dpms)(struct drm_connector *connector, int mode); |
| 420 | void (*save)(struct drm_connector *connector); |
| 421 | void (*restore)(struct drm_connector *connector); |
| 422 | enum drm_connector_status (*detect)(struct drm_connector *connector); |
Jesse Barnes | 40a518d | 2009-01-12 12:05:32 -0800 | [diff] [blame] | 423 | int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 424 | int (*set_property)(struct drm_connector *connector, struct drm_property *property, |
| 425 | uint64_t val); |
| 426 | void (*destroy)(struct drm_connector *connector); |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 427 | void (*force)(struct drm_connector *connector); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 428 | }; |
| 429 | |
| 430 | struct drm_encoder_funcs { |
| 431 | void (*destroy)(struct drm_encoder *encoder); |
| 432 | }; |
| 433 | |
| 434 | #define DRM_CONNECTOR_MAX_UMODES 16 |
| 435 | #define DRM_CONNECTOR_MAX_PROPERTY 16 |
| 436 | #define DRM_CONNECTOR_LEN 32 |
| 437 | #define DRM_CONNECTOR_MAX_ENCODER 2 |
| 438 | |
| 439 | /** |
| 440 | * drm_encoder - central DRM encoder structure |
| 441 | */ |
| 442 | struct drm_encoder { |
| 443 | struct drm_device *dev; |
| 444 | struct list_head head; |
| 445 | |
| 446 | struct drm_mode_object base; |
| 447 | int encoder_type; |
| 448 | uint32_t possible_crtcs; |
| 449 | uint32_t possible_clones; |
| 450 | |
| 451 | struct drm_crtc *crtc; |
| 452 | const struct drm_encoder_funcs *funcs; |
| 453 | void *helper_private; |
| 454 | }; |
| 455 | |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 456 | enum drm_connector_force { |
| 457 | DRM_FORCE_UNSPECIFIED, |
| 458 | DRM_FORCE_OFF, |
| 459 | DRM_FORCE_ON, /* force on analog part normally */ |
| 460 | DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */ |
| 461 | }; |
| 462 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 463 | /** |
| 464 | * drm_connector - central DRM connector control structure |
| 465 | * @crtc: CRTC this connector is currently connected to, NULL if none |
| 466 | * @interlace_allowed: can this connector handle interlaced modes? |
| 467 | * @doublescan_allowed: can this connector handle doublescan? |
| 468 | * @available_modes: modes available on this connector (from get_modes() + user) |
| 469 | * @initial_x: initial x position for this connector |
| 470 | * @initial_y: initial y position for this connector |
| 471 | * @status: connector connected? |
| 472 | * @funcs: connector control functions |
| 473 | * |
| 474 | * Each connector may be connected to one or more CRTCs, or may be clonable by |
| 475 | * another connector if they can share a CRTC. Each connector also has a specific |
| 476 | * position in the broader display (referred to as a 'screen' though it could |
| 477 | * span multiple monitors). |
| 478 | */ |
| 479 | struct drm_connector { |
| 480 | struct drm_device *dev; |
| 481 | struct device kdev; |
| 482 | struct device_attribute *attr; |
| 483 | struct list_head head; |
| 484 | |
| 485 | struct drm_mode_object base; |
| 486 | |
| 487 | int connector_type; |
| 488 | int connector_type_id; |
| 489 | bool interlace_allowed; |
| 490 | bool doublescan_allowed; |
| 491 | struct list_head modes; /* list of modes on this connector */ |
| 492 | |
| 493 | int initial_x, initial_y; |
| 494 | enum drm_connector_status status; |
| 495 | |
| 496 | /* these are modes added by probing with DDC or the BIOS */ |
| 497 | struct list_head probed_modes; |
| 498 | |
| 499 | struct drm_display_info display_info; |
| 500 | const struct drm_connector_funcs *funcs; |
| 501 | |
| 502 | struct list_head user_modes; |
| 503 | struct drm_property_blob *edid_blob_ptr; |
| 504 | u32 property_ids[DRM_CONNECTOR_MAX_PROPERTY]; |
| 505 | uint64_t property_values[DRM_CONNECTOR_MAX_PROPERTY]; |
| 506 | |
Keith Packard | c9fb15f | 2009-05-30 20:42:28 -0700 | [diff] [blame] | 507 | /* requested DPMS state */ |
| 508 | int dpms; |
| 509 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 510 | void *helper_private; |
| 511 | |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 512 | /* forced on connector */ |
| 513 | enum drm_connector_force force; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 514 | uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER]; |
| 515 | uint32_t force_encoder_id; |
| 516 | struct drm_encoder *encoder; /* currently active encoder */ |
| 517 | }; |
| 518 | |
| 519 | /** |
| 520 | * struct drm_mode_set |
| 521 | * |
| 522 | * Represents a single crtc the connectors that it drives with what mode |
| 523 | * and from which framebuffer it scans out from. |
| 524 | * |
| 525 | * This is used to set modes. |
| 526 | */ |
| 527 | struct drm_mode_set { |
| 528 | struct list_head head; |
| 529 | |
| 530 | struct drm_framebuffer *fb; |
| 531 | struct drm_crtc *crtc; |
| 532 | struct drm_display_mode *mode; |
| 533 | |
| 534 | uint32_t x; |
| 535 | uint32_t y; |
| 536 | |
| 537 | struct drm_connector **connectors; |
| 538 | size_t num_connectors; |
| 539 | }; |
| 540 | |
| 541 | /** |
| 542 | * struct drm_mode_config_funcs - configure CRTCs for a given screen layout |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 543 | */ |
| 544 | struct drm_mode_config_funcs { |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 545 | struct drm_framebuffer *(*fb_create)(struct drm_device *dev, struct drm_file *file_priv, struct drm_mode_fb_cmd *mode_cmd); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 546 | }; |
| 547 | |
| 548 | struct drm_mode_group { |
| 549 | uint32_t num_crtcs; |
| 550 | uint32_t num_encoders; |
| 551 | uint32_t num_connectors; |
| 552 | |
| 553 | /* list of object IDs for this group */ |
| 554 | uint32_t *id_list; |
| 555 | }; |
| 556 | |
| 557 | /** |
| 558 | * drm_mode_config - Mode configuration control structure |
| 559 | * |
| 560 | */ |
| 561 | struct drm_mode_config { |
Jesse Barnes | ad2563c | 2009-01-19 17:21:45 +1000 | [diff] [blame] | 562 | struct mutex mutex; /* protects configuration (mode lists etc.) */ |
| 563 | struct mutex idr_mutex; /* for IDR management */ |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 564 | struct idr crtc_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */ |
| 565 | /* this is limited to one for now */ |
| 566 | int num_fb; |
| 567 | struct list_head fb_list; |
| 568 | int num_connector; |
| 569 | struct list_head connector_list; |
| 570 | int num_encoder; |
| 571 | struct list_head encoder_list; |
| 572 | |
| 573 | int num_crtc; |
| 574 | struct list_head crtc_list; |
| 575 | |
| 576 | struct list_head property_list; |
| 577 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 578 | int min_width, min_height; |
| 579 | int max_width, max_height; |
| 580 | struct drm_mode_config_funcs *funcs; |
Benjamin Herrenschmidt | d883f7f | 2009-02-02 16:55:45 +1100 | [diff] [blame] | 581 | resource_size_t fb_base; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 582 | |
| 583 | /* pointers to standard properties */ |
| 584 | struct list_head property_blob_list; |
| 585 | struct drm_property *edid_property; |
| 586 | struct drm_property *dpms_property; |
| 587 | |
| 588 | /* DVI-I properties */ |
| 589 | struct drm_property *dvi_i_subconnector_property; |
| 590 | struct drm_property *dvi_i_select_subconnector_property; |
| 591 | |
| 592 | /* TV properties */ |
| 593 | struct drm_property *tv_subconnector_property; |
| 594 | struct drm_property *tv_select_subconnector_property; |
| 595 | struct drm_property *tv_mode_property; |
| 596 | struct drm_property *tv_left_margin_property; |
| 597 | struct drm_property *tv_right_margin_property; |
| 598 | struct drm_property *tv_top_margin_property; |
| 599 | struct drm_property *tv_bottom_margin_property; |
Francisco Jerez | b6b7902 | 2009-08-02 04:19:20 +0200 | [diff] [blame] | 600 | struct drm_property *tv_brightness_property; |
| 601 | struct drm_property *tv_contrast_property; |
| 602 | struct drm_property *tv_flicker_reduction_property; |
Francisco Jerez | a75f023 | 2009-08-12 02:30:10 +0200 | [diff] [blame] | 603 | struct drm_property *tv_overscan_property; |
| 604 | struct drm_property *tv_saturation_property; |
| 605 | struct drm_property *tv_hue_property; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 606 | |
| 607 | /* Optional properties */ |
| 608 | struct drm_property *scaling_mode_property; |
| 609 | struct drm_property *dithering_mode_property; |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 610 | struct drm_property *dirty_info_property; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 611 | }; |
| 612 | |
| 613 | #define obj_to_crtc(x) container_of(x, struct drm_crtc, base) |
| 614 | #define obj_to_connector(x) container_of(x, struct drm_connector, base) |
| 615 | #define obj_to_encoder(x) container_of(x, struct drm_encoder, base) |
| 616 | #define obj_to_mode(x) container_of(x, struct drm_display_mode, base) |
| 617 | #define obj_to_fb(x) container_of(x, struct drm_framebuffer, base) |
| 618 | #define obj_to_property(x) container_of(x, struct drm_property, base) |
| 619 | #define obj_to_blob(x) container_of(x, struct drm_property_blob, base) |
| 620 | |
| 621 | |
| 622 | extern void drm_crtc_init(struct drm_device *dev, |
| 623 | struct drm_crtc *crtc, |
| 624 | const struct drm_crtc_funcs *funcs); |
| 625 | extern void drm_crtc_cleanup(struct drm_crtc *crtc); |
| 626 | |
| 627 | extern void drm_connector_init(struct drm_device *dev, |
| 628 | struct drm_connector *connector, |
| 629 | const struct drm_connector_funcs *funcs, |
| 630 | int connector_type); |
| 631 | |
| 632 | extern void drm_connector_cleanup(struct drm_connector *connector); |
| 633 | |
| 634 | extern void drm_encoder_init(struct drm_device *dev, |
| 635 | struct drm_encoder *encoder, |
| 636 | const struct drm_encoder_funcs *funcs, |
| 637 | int encoder_type); |
| 638 | |
| 639 | extern void drm_encoder_cleanup(struct drm_encoder *encoder); |
| 640 | |
| 641 | extern char *drm_get_connector_name(struct drm_connector *connector); |
| 642 | extern char *drm_get_dpms_name(int val); |
| 643 | extern char *drm_get_dvi_i_subconnector_name(int val); |
| 644 | extern char *drm_get_dvi_i_select_name(int val); |
| 645 | extern char *drm_get_tv_subconnector_name(int val); |
| 646 | extern char *drm_get_tv_select_name(int val); |
Kristian Høgsberg | ea39f83 | 2009-02-12 14:37:56 -0500 | [diff] [blame] | 647 | extern void drm_fb_release(struct drm_file *file_priv); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 648 | extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group); |
| 649 | extern struct edid *drm_get_edid(struct drm_connector *connector, |
| 650 | struct i2c_adapter *adapter); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 651 | extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid); |
| 652 | extern void drm_mode_probed_add(struct drm_connector *connector, struct drm_display_mode *mode); |
| 653 | extern void drm_mode_remove(struct drm_connector *connector, struct drm_display_mode *mode); |
| 654 | extern struct drm_display_mode *drm_mode_duplicate(struct drm_device *dev, |
| 655 | struct drm_display_mode *mode); |
| 656 | extern void drm_mode_debug_printmodeline(struct drm_display_mode *mode); |
| 657 | extern void drm_mode_config_init(struct drm_device *dev); |
| 658 | extern void drm_mode_config_cleanup(struct drm_device *dev); |
| 659 | extern void drm_mode_set_name(struct drm_display_mode *mode); |
| 660 | extern bool drm_mode_equal(struct drm_display_mode *mode1, struct drm_display_mode *mode2); |
| 661 | extern int drm_mode_width(struct drm_display_mode *mode); |
| 662 | extern int drm_mode_height(struct drm_display_mode *mode); |
| 663 | |
| 664 | /* for us by fb module */ |
| 665 | extern int drm_mode_attachmode_crtc(struct drm_device *dev, |
| 666 | struct drm_crtc *crtc, |
| 667 | struct drm_display_mode *mode); |
| 668 | extern int drm_mode_detachmode_crtc(struct drm_device *dev, struct drm_display_mode *mode); |
| 669 | |
| 670 | extern struct drm_display_mode *drm_mode_create(struct drm_device *dev); |
| 671 | extern void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode); |
| 672 | extern void drm_mode_list_concat(struct list_head *head, |
| 673 | struct list_head *new); |
| 674 | extern void drm_mode_validate_size(struct drm_device *dev, |
| 675 | struct list_head *mode_list, |
| 676 | int maxX, int maxY, int maxPitch); |
| 677 | extern void drm_mode_prune_invalid(struct drm_device *dev, |
| 678 | struct list_head *mode_list, bool verbose); |
| 679 | extern void drm_mode_sort(struct list_head *mode_list); |
Adam Jackson | 7ac96a9 | 2009-12-03 17:44:37 -0500 | [diff] [blame] | 680 | extern int drm_mode_hsync(struct drm_display_mode *mode); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 681 | extern int drm_mode_vrefresh(struct drm_display_mode *mode); |
| 682 | extern void drm_mode_set_crtcinfo(struct drm_display_mode *p, |
| 683 | int adjust_flags); |
| 684 | extern void drm_mode_connector_list_update(struct drm_connector *connector); |
| 685 | extern int drm_mode_connector_update_edid_property(struct drm_connector *connector, |
| 686 | struct edid *edid); |
| 687 | extern int drm_connector_property_set_value(struct drm_connector *connector, |
| 688 | struct drm_property *property, |
| 689 | uint64_t value); |
| 690 | extern int drm_connector_property_get_value(struct drm_connector *connector, |
| 691 | struct drm_property *property, |
| 692 | uint64_t *value); |
| 693 | extern struct drm_display_mode *drm_crtc_mode_create(struct drm_device *dev); |
| 694 | extern void drm_framebuffer_set_object(struct drm_device *dev, |
| 695 | unsigned long handle); |
| 696 | extern int drm_framebuffer_init(struct drm_device *dev, |
| 697 | struct drm_framebuffer *fb, |
| 698 | const struct drm_framebuffer_funcs *funcs); |
| 699 | extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb); |
| 700 | extern int drmfb_probe(struct drm_device *dev, struct drm_crtc *crtc); |
| 701 | extern int drmfb_remove(struct drm_device *dev, struct drm_framebuffer *fb); |
| 702 | extern void drm_crtc_probe_connector_modes(struct drm_device *dev, int maxX, int maxY); |
| 703 | extern bool drm_crtc_in_use(struct drm_crtc *crtc); |
| 704 | |
| 705 | extern int drm_connector_attach_property(struct drm_connector *connector, |
| 706 | struct drm_property *property, uint64_t init_val); |
| 707 | extern struct drm_property *drm_property_create(struct drm_device *dev, int flags, |
| 708 | const char *name, int num_values); |
| 709 | extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property); |
| 710 | extern int drm_property_add_enum(struct drm_property *property, int index, |
| 711 | uint64_t value, const char *name); |
| 712 | extern int drm_mode_create_dvi_i_properties(struct drm_device *dev); |
| 713 | extern int drm_mode_create_tv_properties(struct drm_device *dev, int num_formats, |
| 714 | char *formats[]); |
| 715 | extern int drm_mode_create_scaling_mode_property(struct drm_device *dev); |
| 716 | extern int drm_mode_create_dithering_property(struct drm_device *dev); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 717 | extern int drm_mode_create_dirty_info_property(struct drm_device *dev); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 718 | extern char *drm_get_encoder_name(struct drm_encoder *encoder); |
| 719 | |
| 720 | extern int drm_mode_connector_attach_encoder(struct drm_connector *connector, |
| 721 | struct drm_encoder *encoder); |
| 722 | extern void drm_mode_connector_detach_encoder(struct drm_connector *connector, |
| 723 | struct drm_encoder *encoder); |
| 724 | extern bool drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc, |
| 725 | int gamma_size); |
Daniel Vetter | 7a9c906 | 2009-09-15 22:57:31 +0200 | [diff] [blame] | 726 | extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev, |
| 727 | uint32_t id, uint32_t type); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 728 | /* IOCTLs */ |
| 729 | extern int drm_mode_getresources(struct drm_device *dev, |
| 730 | void *data, struct drm_file *file_priv); |
| 731 | |
| 732 | extern int drm_mode_getcrtc(struct drm_device *dev, |
| 733 | void *data, struct drm_file *file_priv); |
| 734 | extern int drm_mode_getconnector(struct drm_device *dev, |
| 735 | void *data, struct drm_file *file_priv); |
| 736 | extern int drm_mode_setcrtc(struct drm_device *dev, |
| 737 | void *data, struct drm_file *file_priv); |
| 738 | extern int drm_mode_cursor_ioctl(struct drm_device *dev, |
| 739 | void *data, struct drm_file *file_priv); |
| 740 | extern int drm_mode_addfb(struct drm_device *dev, |
| 741 | void *data, struct drm_file *file_priv); |
| 742 | extern int drm_mode_rmfb(struct drm_device *dev, |
| 743 | void *data, struct drm_file *file_priv); |
| 744 | extern int drm_mode_getfb(struct drm_device *dev, |
| 745 | void *data, struct drm_file *file_priv); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 746 | extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev, |
| 747 | void *data, struct drm_file *file_priv); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 748 | extern int drm_mode_addmode_ioctl(struct drm_device *dev, |
| 749 | void *data, struct drm_file *file_priv); |
| 750 | extern int drm_mode_rmmode_ioctl(struct drm_device *dev, |
| 751 | void *data, struct drm_file *file_priv); |
| 752 | extern int drm_mode_attachmode_ioctl(struct drm_device *dev, |
| 753 | void *data, struct drm_file *file_priv); |
| 754 | extern int drm_mode_detachmode_ioctl(struct drm_device *dev, |
| 755 | void *data, struct drm_file *file_priv); |
| 756 | |
| 757 | extern int drm_mode_getproperty_ioctl(struct drm_device *dev, |
| 758 | void *data, struct drm_file *file_priv); |
| 759 | extern int drm_mode_getblob_ioctl(struct drm_device *dev, |
| 760 | void *data, struct drm_file *file_priv); |
| 761 | extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev, |
| 762 | void *data, struct drm_file *file_priv); |
| 763 | extern int drm_mode_hotplug_ioctl(struct drm_device *dev, |
| 764 | void *data, struct drm_file *file_priv); |
| 765 | extern int drm_mode_replacefb(struct drm_device *dev, |
| 766 | void *data, struct drm_file *file_priv); |
| 767 | extern int drm_mode_getencoder(struct drm_device *dev, |
| 768 | void *data, struct drm_file *file_priv); |
| 769 | extern int drm_mode_gamma_get_ioctl(struct drm_device *dev, |
| 770 | void *data, struct drm_file *file_priv); |
| 771 | extern int drm_mode_gamma_set_ioctl(struct drm_device *dev, |
| 772 | void *data, struct drm_file *file_priv); |
Ma Ling | f23c20c | 2009-03-26 19:26:23 +0800 | [diff] [blame] | 773 | extern bool drm_detect_hdmi_monitor(struct edid *edid); |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 774 | extern int drm_mode_page_flip_ioctl(struct drm_device *dev, |
| 775 | void *data, struct drm_file *file_priv); |
Zhao Yakui | d782c3f | 2009-06-22 13:17:08 +0800 | [diff] [blame] | 776 | extern struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, |
| 777 | int hdisplay, int vdisplay, int vrefresh, |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 778 | bool reduced, bool interlaced, bool margins); |
Zhao Yakui | 26bbdad | 2009-06-22 13:17:09 +0800 | [diff] [blame] | 779 | extern struct drm_display_mode *drm_gtf_mode(struct drm_device *dev, |
| 780 | int hdisplay, int vdisplay, int vrefresh, |
| 781 | bool interlaced, int margins); |
Adam Jackson | 7a37435 | 2010-03-29 21:43:30 +0000 | [diff] [blame] | 782 | extern struct drm_display_mode *drm_gtf_mode_complex(struct drm_device *dev, |
| 783 | int hdisplay, int vdisplay, int vrefresh, |
| 784 | bool interlaced, int margins, int GTF_M, |
| 785 | int GTF_2C, int GTF_K, int GTF_2J); |
Zhao Yakui | f0fda0a | 2009-09-03 09:33:48 +0800 | [diff] [blame] | 786 | extern int drm_add_modes_noedid(struct drm_connector *connector, |
| 787 | int hdisplay, int vdisplay); |
Alex Deucher | 3c53788 | 2010-02-05 04:21:19 -0500 | [diff] [blame] | 788 | |
| 789 | extern bool drm_edid_is_valid(struct edid *edid); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 790 | #endif /* __DRM_CRTC_H__ */ |