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]; |
Adam Jackson | fb43964 | 2010-08-03 14:38:16 -0400 | [diff] [blame] | 192 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 193 | /* Physical size */ |
| 194 | unsigned int width_mm; |
| 195 | unsigned int height_mm; |
| 196 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 197 | /* Clock limits FIXME: storage format */ |
| 198 | unsigned int min_vfreq, max_vfreq; |
| 199 | unsigned int min_hfreq, max_hfreq; |
| 200 | unsigned int pixel_clock; |
| 201 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 202 | enum subpixel_order subpixel_order; |
| 203 | |
| 204 | char *raw_edid; /* if any */ |
| 205 | }; |
| 206 | |
| 207 | struct drm_framebuffer_funcs { |
| 208 | void (*destroy)(struct drm_framebuffer *framebuffer); |
| 209 | int (*create_handle)(struct drm_framebuffer *fb, |
| 210 | struct drm_file *file_priv, |
| 211 | unsigned int *handle); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 212 | /** |
| 213 | * Optinal callback for the dirty fb ioctl. |
| 214 | * |
| 215 | * Userspace can notify the driver via this callback |
| 216 | * that a area of the framebuffer has changed and should |
| 217 | * be flushed to the display hardware. |
| 218 | * |
| 219 | * See documentation in drm_mode.h for the struct |
| 220 | * drm_mode_fb_dirty_cmd for more information as all |
| 221 | * the semantics and arguments have a one to one mapping |
| 222 | * on this function. |
| 223 | */ |
Thomas Hellstrom | 02b0016 | 2010-10-05 12:43:02 +0200 | [diff] [blame^] | 224 | int (*dirty)(struct drm_framebuffer *framebuffer, |
| 225 | struct drm_file *file_priv, unsigned flags, |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 226 | unsigned color, struct drm_clip_rect *clips, |
| 227 | unsigned num_clips); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 228 | }; |
| 229 | |
| 230 | struct drm_framebuffer { |
| 231 | struct drm_device *dev; |
| 232 | struct list_head head; |
| 233 | struct drm_mode_object base; |
| 234 | const struct drm_framebuffer_funcs *funcs; |
| 235 | unsigned int pitch; |
| 236 | unsigned int width; |
| 237 | unsigned int height; |
| 238 | /* depth can be 15 or 16 */ |
| 239 | unsigned int depth; |
| 240 | int bits_per_pixel; |
| 241 | int flags; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 242 | struct list_head filp_head; |
Dave Airlie | 785b93e | 2009-08-28 15:46:53 +1000 | [diff] [blame] | 243 | /* if you are using the helper */ |
| 244 | void *helper_private; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 245 | }; |
| 246 | |
| 247 | struct drm_property_blob { |
| 248 | struct drm_mode_object base; |
| 249 | struct list_head head; |
| 250 | unsigned int length; |
| 251 | void *data; |
| 252 | }; |
| 253 | |
| 254 | struct drm_property_enum { |
| 255 | uint64_t value; |
| 256 | struct list_head head; |
| 257 | char name[DRM_PROP_NAME_LEN]; |
| 258 | }; |
| 259 | |
| 260 | struct drm_property { |
| 261 | struct list_head head; |
| 262 | struct drm_mode_object base; |
| 263 | uint32_t flags; |
| 264 | char name[DRM_PROP_NAME_LEN]; |
| 265 | uint32_t num_values; |
| 266 | uint64_t *values; |
| 267 | |
| 268 | struct list_head enum_blob_list; |
| 269 | }; |
| 270 | |
| 271 | struct drm_crtc; |
| 272 | struct drm_connector; |
| 273 | struct drm_encoder; |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 274 | struct drm_pending_vblank_event; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 275 | |
| 276 | /** |
| 277 | * drm_crtc_funcs - control CRTCs for a given device |
| 278 | * @dpms: control display power levels |
| 279 | * @save: save CRTC state |
| 280 | * @resore: restore CRTC state |
| 281 | * @lock: lock the CRTC |
| 282 | * @unlock: unlock the CRTC |
| 283 | * @shadow_allocate: allocate shadow pixmap |
| 284 | * @shadow_create: create shadow pixmap for rotation support |
| 285 | * @shadow_destroy: free shadow pixmap |
| 286 | * @mode_fixup: fixup proposed mode |
| 287 | * @mode_set: set the desired mode on the CRTC |
| 288 | * @gamma_set: specify color ramp for CRTC |
| 289 | * @destroy: deinit and free object. |
| 290 | * |
| 291 | * The drm_crtc_funcs structure is the central CRTC management structure |
| 292 | * in the DRM. Each CRTC controls one or more connectors (note that the name |
| 293 | * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc. |
| 294 | * connectors, not just CRTs). |
| 295 | * |
| 296 | * Each driver is responsible for filling out this structure at startup time, |
| 297 | * in addition to providing other modesetting features, like i2c and DDC |
| 298 | * bus accessors. |
| 299 | */ |
| 300 | struct drm_crtc_funcs { |
| 301 | /* Save CRTC state */ |
| 302 | void (*save)(struct drm_crtc *crtc); /* suspend? */ |
| 303 | /* Restore CRTC state */ |
| 304 | void (*restore)(struct drm_crtc *crtc); /* resume? */ |
| 305 | |
| 306 | /* cursor controls */ |
| 307 | int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv, |
| 308 | uint32_t handle, uint32_t width, uint32_t height); |
| 309 | int (*cursor_move)(struct drm_crtc *crtc, int x, int y); |
| 310 | |
| 311 | /* Set gamma on the CRTC */ |
| 312 | void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b, |
James Simmons | 7203425 | 2010-08-03 01:33:19 +0100 | [diff] [blame] | 313 | uint32_t start, uint32_t size); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 314 | /* Object destroy routine */ |
| 315 | void (*destroy)(struct drm_crtc *crtc); |
| 316 | |
| 317 | int (*set_config)(struct drm_mode_set *set); |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 318 | |
| 319 | /* |
| 320 | * Flip to the given framebuffer. This implements the page |
| 321 | * flip ioctl descibed in drm_mode.h, specifically, the |
| 322 | * implementation must return immediately and block all |
| 323 | * rendering to the current fb until the flip has completed. |
| 324 | * If userspace set the event flag in the ioctl, the event |
| 325 | * argument will point to an event to send back when the flip |
| 326 | * completes, otherwise it will be NULL. |
| 327 | */ |
| 328 | int (*page_flip)(struct drm_crtc *crtc, |
| 329 | struct drm_framebuffer *fb, |
| 330 | struct drm_pending_vblank_event *event); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 331 | }; |
| 332 | |
| 333 | /** |
| 334 | * drm_crtc - central CRTC control structure |
| 335 | * @enabled: is this CRTC enabled? |
| 336 | * @x: x position on screen |
| 337 | * @y: y position on screen |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 338 | * @funcs: CRTC control functions |
| 339 | * |
| 340 | * Each CRTC may have one or more connectors associated with it. This structure |
| 341 | * allows the CRTC to be controlled. |
| 342 | */ |
| 343 | struct drm_crtc { |
| 344 | struct drm_device *dev; |
| 345 | struct list_head head; |
| 346 | |
| 347 | struct drm_mode_object base; |
| 348 | |
| 349 | /* framebuffer the connector is currently bound to */ |
| 350 | struct drm_framebuffer *fb; |
| 351 | |
| 352 | bool enabled; |
| 353 | |
| 354 | struct drm_display_mode mode; |
| 355 | |
| 356 | int x, y; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 357 | const struct drm_crtc_funcs *funcs; |
| 358 | |
| 359 | /* CRTC gamma size for reporting to userspace */ |
| 360 | uint32_t gamma_size; |
| 361 | uint16_t *gamma_store; |
| 362 | |
| 363 | /* if you are using the helper */ |
| 364 | void *helper_private; |
| 365 | }; |
| 366 | |
| 367 | |
| 368 | /** |
| 369 | * drm_connector_funcs - control connectors on a given device |
| 370 | * @dpms: set power state (see drm_crtc_funcs above) |
| 371 | * @save: save connector state |
| 372 | * @restore: restore connector state |
| 373 | * @mode_valid: is this mode valid on the given connector? |
| 374 | * @mode_fixup: try to fixup proposed mode for this connector |
| 375 | * @mode_set: set this mode |
| 376 | * @detect: is this connector active? |
| 377 | * @get_modes: get mode list for this connector |
| 378 | * @set_property: property for this connector may need update |
| 379 | * @destroy: make object go away |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 380 | * @force: notify the driver the connector is forced on |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 381 | * |
| 382 | * Each CRTC may have one or more connectors attached to it. The functions |
| 383 | * below allow the core DRM code to control connectors, enumerate available modes, |
| 384 | * etc. |
| 385 | */ |
| 386 | struct drm_connector_funcs { |
| 387 | void (*dpms)(struct drm_connector *connector, int mode); |
| 388 | void (*save)(struct drm_connector *connector); |
| 389 | void (*restore)(struct drm_connector *connector); |
Chris Wilson | 930a9e2 | 2010-09-14 11:07:23 +0100 | [diff] [blame] | 390 | |
| 391 | /* Check to see if anything is attached to the connector. |
| 392 | * @force is set to false whilst polling, true when checking the |
| 393 | * connector due to user request. @force can be used by the driver |
| 394 | * to avoid expensive, destructive operations during automated |
| 395 | * probing. |
| 396 | */ |
Chris Wilson | 7b334fc | 2010-09-09 23:51:02 +0100 | [diff] [blame] | 397 | enum drm_connector_status (*detect)(struct drm_connector *connector, |
Chris Wilson | 930a9e2 | 2010-09-14 11:07:23 +0100 | [diff] [blame] | 398 | bool force); |
Jesse Barnes | 40a518d | 2009-01-12 12:05:32 -0800 | [diff] [blame] | 399 | 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] | 400 | int (*set_property)(struct drm_connector *connector, struct drm_property *property, |
| 401 | uint64_t val); |
| 402 | void (*destroy)(struct drm_connector *connector); |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 403 | void (*force)(struct drm_connector *connector); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 404 | }; |
| 405 | |
| 406 | struct drm_encoder_funcs { |
| 407 | void (*destroy)(struct drm_encoder *encoder); |
| 408 | }; |
| 409 | |
| 410 | #define DRM_CONNECTOR_MAX_UMODES 16 |
| 411 | #define DRM_CONNECTOR_MAX_PROPERTY 16 |
| 412 | #define DRM_CONNECTOR_LEN 32 |
| 413 | #define DRM_CONNECTOR_MAX_ENCODER 2 |
| 414 | |
| 415 | /** |
| 416 | * drm_encoder - central DRM encoder structure |
| 417 | */ |
| 418 | struct drm_encoder { |
| 419 | struct drm_device *dev; |
| 420 | struct list_head head; |
| 421 | |
| 422 | struct drm_mode_object base; |
| 423 | int encoder_type; |
| 424 | uint32_t possible_crtcs; |
| 425 | uint32_t possible_clones; |
| 426 | |
| 427 | struct drm_crtc *crtc; |
| 428 | const struct drm_encoder_funcs *funcs; |
| 429 | void *helper_private; |
| 430 | }; |
| 431 | |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 432 | enum drm_connector_force { |
| 433 | DRM_FORCE_UNSPECIFIED, |
| 434 | DRM_FORCE_OFF, |
| 435 | DRM_FORCE_ON, /* force on analog part normally */ |
| 436 | DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */ |
| 437 | }; |
| 438 | |
Dave Airlie | eb1f8e4 | 2010-05-07 06:42:51 +0000 | [diff] [blame] | 439 | /* should we poll this connector for connects and disconnects */ |
| 440 | /* hot plug detectable */ |
| 441 | #define DRM_CONNECTOR_POLL_HPD (1 << 0) |
| 442 | /* poll for connections */ |
| 443 | #define DRM_CONNECTOR_POLL_CONNECT (1 << 1) |
| 444 | /* can cleanly poll for disconnections without flickering the screen */ |
| 445 | /* DACs should rarely do this without a lot of testing */ |
| 446 | #define DRM_CONNECTOR_POLL_DISCONNECT (1 << 2) |
| 447 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 448 | /** |
| 449 | * drm_connector - central DRM connector control structure |
| 450 | * @crtc: CRTC this connector is currently connected to, NULL if none |
| 451 | * @interlace_allowed: can this connector handle interlaced modes? |
| 452 | * @doublescan_allowed: can this connector handle doublescan? |
| 453 | * @available_modes: modes available on this connector (from get_modes() + user) |
| 454 | * @initial_x: initial x position for this connector |
| 455 | * @initial_y: initial y position for this connector |
| 456 | * @status: connector connected? |
| 457 | * @funcs: connector control functions |
| 458 | * |
| 459 | * Each connector may be connected to one or more CRTCs, or may be clonable by |
| 460 | * another connector if they can share a CRTC. Each connector also has a specific |
| 461 | * position in the broader display (referred to as a 'screen' though it could |
| 462 | * span multiple monitors). |
| 463 | */ |
| 464 | struct drm_connector { |
| 465 | struct drm_device *dev; |
| 466 | struct device kdev; |
| 467 | struct device_attribute *attr; |
| 468 | struct list_head head; |
| 469 | |
| 470 | struct drm_mode_object base; |
| 471 | |
| 472 | int connector_type; |
| 473 | int connector_type_id; |
| 474 | bool interlace_allowed; |
| 475 | bool doublescan_allowed; |
| 476 | struct list_head modes; /* list of modes on this connector */ |
| 477 | |
| 478 | int initial_x, initial_y; |
| 479 | enum drm_connector_status status; |
| 480 | |
| 481 | /* these are modes added by probing with DDC or the BIOS */ |
| 482 | struct list_head probed_modes; |
| 483 | |
| 484 | struct drm_display_info display_info; |
| 485 | const struct drm_connector_funcs *funcs; |
| 486 | |
| 487 | struct list_head user_modes; |
| 488 | struct drm_property_blob *edid_blob_ptr; |
| 489 | u32 property_ids[DRM_CONNECTOR_MAX_PROPERTY]; |
| 490 | uint64_t property_values[DRM_CONNECTOR_MAX_PROPERTY]; |
| 491 | |
Dave Airlie | eb1f8e4 | 2010-05-07 06:42:51 +0000 | [diff] [blame] | 492 | uint8_t polled; /* DRM_CONNECTOR_POLL_* */ |
| 493 | |
Keith Packard | c9fb15f | 2009-05-30 20:42:28 -0700 | [diff] [blame] | 494 | /* requested DPMS state */ |
| 495 | int dpms; |
| 496 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 497 | void *helper_private; |
| 498 | |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 499 | /* forced on connector */ |
| 500 | enum drm_connector_force force; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 501 | uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER]; |
| 502 | uint32_t force_encoder_id; |
| 503 | struct drm_encoder *encoder; /* currently active encoder */ |
| 504 | }; |
| 505 | |
| 506 | /** |
| 507 | * struct drm_mode_set |
| 508 | * |
| 509 | * Represents a single crtc the connectors that it drives with what mode |
| 510 | * and from which framebuffer it scans out from. |
| 511 | * |
| 512 | * This is used to set modes. |
| 513 | */ |
| 514 | struct drm_mode_set { |
| 515 | struct list_head head; |
| 516 | |
| 517 | struct drm_framebuffer *fb; |
| 518 | struct drm_crtc *crtc; |
| 519 | struct drm_display_mode *mode; |
| 520 | |
| 521 | uint32_t x; |
| 522 | uint32_t y; |
| 523 | |
| 524 | struct drm_connector **connectors; |
| 525 | size_t num_connectors; |
| 526 | }; |
| 527 | |
| 528 | /** |
| 529 | * struct drm_mode_config_funcs - configure CRTCs for a given screen layout |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 530 | */ |
| 531 | struct drm_mode_config_funcs { |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 532 | struct drm_framebuffer *(*fb_create)(struct drm_device *dev, struct drm_file *file_priv, struct drm_mode_fb_cmd *mode_cmd); |
Dave Airlie | eb1f8e4 | 2010-05-07 06:42:51 +0000 | [diff] [blame] | 533 | void (*output_poll_changed)(struct drm_device *dev); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 534 | }; |
| 535 | |
| 536 | struct drm_mode_group { |
| 537 | uint32_t num_crtcs; |
| 538 | uint32_t num_encoders; |
| 539 | uint32_t num_connectors; |
| 540 | |
| 541 | /* list of object IDs for this group */ |
| 542 | uint32_t *id_list; |
| 543 | }; |
| 544 | |
| 545 | /** |
| 546 | * drm_mode_config - Mode configuration control structure |
| 547 | * |
| 548 | */ |
| 549 | struct drm_mode_config { |
Jesse Barnes | ad2563c | 2009-01-19 17:21:45 +1000 | [diff] [blame] | 550 | struct mutex mutex; /* protects configuration (mode lists etc.) */ |
| 551 | struct mutex idr_mutex; /* for IDR management */ |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 552 | struct idr crtc_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */ |
| 553 | /* this is limited to one for now */ |
| 554 | int num_fb; |
| 555 | struct list_head fb_list; |
| 556 | int num_connector; |
| 557 | struct list_head connector_list; |
| 558 | int num_encoder; |
| 559 | struct list_head encoder_list; |
| 560 | |
| 561 | int num_crtc; |
| 562 | struct list_head crtc_list; |
| 563 | |
| 564 | struct list_head property_list; |
| 565 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 566 | int min_width, min_height; |
| 567 | int max_width, max_height; |
| 568 | struct drm_mode_config_funcs *funcs; |
Benjamin Herrenschmidt | d883f7f | 2009-02-02 16:55:45 +1100 | [diff] [blame] | 569 | resource_size_t fb_base; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 570 | |
Dave Airlie | eb1f8e4 | 2010-05-07 06:42:51 +0000 | [diff] [blame] | 571 | /* output poll support */ |
| 572 | bool poll_enabled; |
Tejun Heo | 991ea75 | 2010-07-20 22:09:02 +0200 | [diff] [blame] | 573 | struct delayed_work output_poll_work; |
Dave Airlie | eb1f8e4 | 2010-05-07 06:42:51 +0000 | [diff] [blame] | 574 | |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 575 | /* pointers to standard properties */ |
| 576 | struct list_head property_blob_list; |
| 577 | struct drm_property *edid_property; |
| 578 | struct drm_property *dpms_property; |
| 579 | |
| 580 | /* DVI-I properties */ |
| 581 | struct drm_property *dvi_i_subconnector_property; |
| 582 | struct drm_property *dvi_i_select_subconnector_property; |
| 583 | |
| 584 | /* TV properties */ |
| 585 | struct drm_property *tv_subconnector_property; |
| 586 | struct drm_property *tv_select_subconnector_property; |
| 587 | struct drm_property *tv_mode_property; |
| 588 | struct drm_property *tv_left_margin_property; |
| 589 | struct drm_property *tv_right_margin_property; |
| 590 | struct drm_property *tv_top_margin_property; |
| 591 | struct drm_property *tv_bottom_margin_property; |
Francisco Jerez | b6b7902 | 2009-08-02 04:19:20 +0200 | [diff] [blame] | 592 | struct drm_property *tv_brightness_property; |
| 593 | struct drm_property *tv_contrast_property; |
| 594 | struct drm_property *tv_flicker_reduction_property; |
Francisco Jerez | a75f023 | 2009-08-12 02:30:10 +0200 | [diff] [blame] | 595 | struct drm_property *tv_overscan_property; |
| 596 | struct drm_property *tv_saturation_property; |
| 597 | struct drm_property *tv_hue_property; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 598 | |
| 599 | /* Optional properties */ |
| 600 | struct drm_property *scaling_mode_property; |
| 601 | struct drm_property *dithering_mode_property; |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 602 | struct drm_property *dirty_info_property; |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 603 | }; |
| 604 | |
| 605 | #define obj_to_crtc(x) container_of(x, struct drm_crtc, base) |
| 606 | #define obj_to_connector(x) container_of(x, struct drm_connector, base) |
| 607 | #define obj_to_encoder(x) container_of(x, struct drm_encoder, base) |
| 608 | #define obj_to_mode(x) container_of(x, struct drm_display_mode, base) |
| 609 | #define obj_to_fb(x) container_of(x, struct drm_framebuffer, base) |
| 610 | #define obj_to_property(x) container_of(x, struct drm_property, base) |
| 611 | #define obj_to_blob(x) container_of(x, struct drm_property_blob, base) |
| 612 | |
| 613 | |
| 614 | extern void drm_crtc_init(struct drm_device *dev, |
| 615 | struct drm_crtc *crtc, |
| 616 | const struct drm_crtc_funcs *funcs); |
| 617 | extern void drm_crtc_cleanup(struct drm_crtc *crtc); |
| 618 | |
| 619 | extern void drm_connector_init(struct drm_device *dev, |
| 620 | struct drm_connector *connector, |
| 621 | const struct drm_connector_funcs *funcs, |
| 622 | int connector_type); |
| 623 | |
| 624 | extern void drm_connector_cleanup(struct drm_connector *connector); |
| 625 | |
| 626 | extern void drm_encoder_init(struct drm_device *dev, |
| 627 | struct drm_encoder *encoder, |
| 628 | const struct drm_encoder_funcs *funcs, |
| 629 | int encoder_type); |
| 630 | |
| 631 | extern void drm_encoder_cleanup(struct drm_encoder *encoder); |
| 632 | |
| 633 | extern char *drm_get_connector_name(struct drm_connector *connector); |
| 634 | extern char *drm_get_dpms_name(int val); |
| 635 | extern char *drm_get_dvi_i_subconnector_name(int val); |
| 636 | extern char *drm_get_dvi_i_select_name(int val); |
| 637 | extern char *drm_get_tv_subconnector_name(int val); |
| 638 | extern char *drm_get_tv_select_name(int val); |
Kristian Høgsberg | ea39f83 | 2009-02-12 14:37:56 -0500 | [diff] [blame] | 639 | extern void drm_fb_release(struct drm_file *file_priv); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 640 | extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group); |
| 641 | extern struct edid *drm_get_edid(struct drm_connector *connector, |
| 642 | struct i2c_adapter *adapter); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 643 | extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid); |
| 644 | extern void drm_mode_probed_add(struct drm_connector *connector, struct drm_display_mode *mode); |
| 645 | extern void drm_mode_remove(struct drm_connector *connector, struct drm_display_mode *mode); |
| 646 | extern struct drm_display_mode *drm_mode_duplicate(struct drm_device *dev, |
| 647 | struct drm_display_mode *mode); |
| 648 | extern void drm_mode_debug_printmodeline(struct drm_display_mode *mode); |
| 649 | extern void drm_mode_config_init(struct drm_device *dev); |
| 650 | extern void drm_mode_config_cleanup(struct drm_device *dev); |
| 651 | extern void drm_mode_set_name(struct drm_display_mode *mode); |
| 652 | extern bool drm_mode_equal(struct drm_display_mode *mode1, struct drm_display_mode *mode2); |
| 653 | extern int drm_mode_width(struct drm_display_mode *mode); |
| 654 | extern int drm_mode_height(struct drm_display_mode *mode); |
| 655 | |
| 656 | /* for us by fb module */ |
| 657 | extern int drm_mode_attachmode_crtc(struct drm_device *dev, |
| 658 | struct drm_crtc *crtc, |
| 659 | struct drm_display_mode *mode); |
| 660 | extern int drm_mode_detachmode_crtc(struct drm_device *dev, struct drm_display_mode *mode); |
| 661 | |
| 662 | extern struct drm_display_mode *drm_mode_create(struct drm_device *dev); |
| 663 | extern void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode); |
| 664 | extern void drm_mode_list_concat(struct list_head *head, |
| 665 | struct list_head *new); |
| 666 | extern void drm_mode_validate_size(struct drm_device *dev, |
| 667 | struct list_head *mode_list, |
| 668 | int maxX, int maxY, int maxPitch); |
| 669 | extern void drm_mode_prune_invalid(struct drm_device *dev, |
| 670 | struct list_head *mode_list, bool verbose); |
| 671 | extern void drm_mode_sort(struct list_head *mode_list); |
Adam Jackson | 7ac96a9 | 2009-12-03 17:44:37 -0500 | [diff] [blame] | 672 | extern int drm_mode_hsync(struct drm_display_mode *mode); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 673 | extern int drm_mode_vrefresh(struct drm_display_mode *mode); |
| 674 | extern void drm_mode_set_crtcinfo(struct drm_display_mode *p, |
| 675 | int adjust_flags); |
| 676 | extern void drm_mode_connector_list_update(struct drm_connector *connector); |
| 677 | extern int drm_mode_connector_update_edid_property(struct drm_connector *connector, |
| 678 | struct edid *edid); |
| 679 | extern int drm_connector_property_set_value(struct drm_connector *connector, |
| 680 | struct drm_property *property, |
| 681 | uint64_t value); |
| 682 | extern int drm_connector_property_get_value(struct drm_connector *connector, |
| 683 | struct drm_property *property, |
| 684 | uint64_t *value); |
| 685 | extern struct drm_display_mode *drm_crtc_mode_create(struct drm_device *dev); |
| 686 | extern void drm_framebuffer_set_object(struct drm_device *dev, |
| 687 | unsigned long handle); |
| 688 | extern int drm_framebuffer_init(struct drm_device *dev, |
| 689 | struct drm_framebuffer *fb, |
| 690 | const struct drm_framebuffer_funcs *funcs); |
| 691 | extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb); |
| 692 | extern int drmfb_probe(struct drm_device *dev, struct drm_crtc *crtc); |
| 693 | extern int drmfb_remove(struct drm_device *dev, struct drm_framebuffer *fb); |
| 694 | extern void drm_crtc_probe_connector_modes(struct drm_device *dev, int maxX, int maxY); |
| 695 | extern bool drm_crtc_in_use(struct drm_crtc *crtc); |
| 696 | |
| 697 | extern int drm_connector_attach_property(struct drm_connector *connector, |
| 698 | struct drm_property *property, uint64_t init_val); |
| 699 | extern struct drm_property *drm_property_create(struct drm_device *dev, int flags, |
| 700 | const char *name, int num_values); |
| 701 | extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property); |
| 702 | extern int drm_property_add_enum(struct drm_property *property, int index, |
| 703 | uint64_t value, const char *name); |
| 704 | extern int drm_mode_create_dvi_i_properties(struct drm_device *dev); |
| 705 | extern int drm_mode_create_tv_properties(struct drm_device *dev, int num_formats, |
| 706 | char *formats[]); |
| 707 | extern int drm_mode_create_scaling_mode_property(struct drm_device *dev); |
| 708 | extern int drm_mode_create_dithering_property(struct drm_device *dev); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 709 | extern int drm_mode_create_dirty_info_property(struct drm_device *dev); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 710 | extern char *drm_get_encoder_name(struct drm_encoder *encoder); |
| 711 | |
| 712 | extern int drm_mode_connector_attach_encoder(struct drm_connector *connector, |
| 713 | struct drm_encoder *encoder); |
| 714 | extern void drm_mode_connector_detach_encoder(struct drm_connector *connector, |
| 715 | struct drm_encoder *encoder); |
| 716 | extern bool drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc, |
| 717 | int gamma_size); |
Daniel Vetter | 7a9c906 | 2009-09-15 22:57:31 +0200 | [diff] [blame] | 718 | extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev, |
| 719 | uint32_t id, uint32_t type); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 720 | /* IOCTLs */ |
| 721 | extern int drm_mode_getresources(struct drm_device *dev, |
| 722 | void *data, struct drm_file *file_priv); |
| 723 | |
| 724 | extern int drm_mode_getcrtc(struct drm_device *dev, |
| 725 | void *data, struct drm_file *file_priv); |
| 726 | extern int drm_mode_getconnector(struct drm_device *dev, |
| 727 | void *data, struct drm_file *file_priv); |
| 728 | extern int drm_mode_setcrtc(struct drm_device *dev, |
| 729 | void *data, struct drm_file *file_priv); |
| 730 | extern int drm_mode_cursor_ioctl(struct drm_device *dev, |
| 731 | void *data, struct drm_file *file_priv); |
| 732 | extern int drm_mode_addfb(struct drm_device *dev, |
| 733 | void *data, struct drm_file *file_priv); |
| 734 | extern int drm_mode_rmfb(struct drm_device *dev, |
| 735 | void *data, struct drm_file *file_priv); |
| 736 | extern int drm_mode_getfb(struct drm_device *dev, |
| 737 | void *data, struct drm_file *file_priv); |
Jakob Bornecrantz | 884840a | 2009-12-03 23:25:47 +0000 | [diff] [blame] | 738 | extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev, |
| 739 | void *data, struct drm_file *file_priv); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 740 | extern int drm_mode_addmode_ioctl(struct drm_device *dev, |
| 741 | void *data, struct drm_file *file_priv); |
| 742 | extern int drm_mode_rmmode_ioctl(struct drm_device *dev, |
| 743 | void *data, struct drm_file *file_priv); |
| 744 | extern int drm_mode_attachmode_ioctl(struct drm_device *dev, |
| 745 | void *data, struct drm_file *file_priv); |
| 746 | extern int drm_mode_detachmode_ioctl(struct drm_device *dev, |
| 747 | void *data, struct drm_file *file_priv); |
| 748 | |
| 749 | extern int drm_mode_getproperty_ioctl(struct drm_device *dev, |
| 750 | void *data, struct drm_file *file_priv); |
| 751 | extern int drm_mode_getblob_ioctl(struct drm_device *dev, |
| 752 | void *data, struct drm_file *file_priv); |
| 753 | extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev, |
| 754 | void *data, struct drm_file *file_priv); |
| 755 | extern int drm_mode_hotplug_ioctl(struct drm_device *dev, |
| 756 | void *data, struct drm_file *file_priv); |
| 757 | extern int drm_mode_replacefb(struct drm_device *dev, |
| 758 | void *data, struct drm_file *file_priv); |
| 759 | extern int drm_mode_getencoder(struct drm_device *dev, |
| 760 | void *data, struct drm_file *file_priv); |
| 761 | extern int drm_mode_gamma_get_ioctl(struct drm_device *dev, |
| 762 | void *data, struct drm_file *file_priv); |
| 763 | extern int drm_mode_gamma_set_ioctl(struct drm_device *dev, |
| 764 | void *data, struct drm_file *file_priv); |
Ma Ling | f23c20c | 2009-03-26 19:26:23 +0800 | [diff] [blame] | 765 | extern bool drm_detect_hdmi_monitor(struct edid *edid); |
Kristian Høgsberg | d91d8a3 | 2009-11-17 12:43:55 -0500 | [diff] [blame] | 766 | extern int drm_mode_page_flip_ioctl(struct drm_device *dev, |
| 767 | void *data, struct drm_file *file_priv); |
Zhao Yakui | d782c3f | 2009-06-22 13:17:08 +0800 | [diff] [blame] | 768 | extern struct drm_display_mode *drm_cvt_mode(struct drm_device *dev, |
| 769 | int hdisplay, int vdisplay, int vrefresh, |
Dave Airlie | d50ba25 | 2009-09-23 14:44:08 +1000 | [diff] [blame] | 770 | bool reduced, bool interlaced, bool margins); |
Zhao Yakui | 26bbdad | 2009-06-22 13:17:09 +0800 | [diff] [blame] | 771 | extern struct drm_display_mode *drm_gtf_mode(struct drm_device *dev, |
| 772 | int hdisplay, int vdisplay, int vrefresh, |
| 773 | bool interlaced, int margins); |
Adam Jackson | 7a37435 | 2010-03-29 21:43:30 +0000 | [diff] [blame] | 774 | extern struct drm_display_mode *drm_gtf_mode_complex(struct drm_device *dev, |
| 775 | int hdisplay, int vdisplay, int vrefresh, |
| 776 | bool interlaced, int margins, int GTF_M, |
| 777 | int GTF_2C, int GTF_K, int GTF_2J); |
Zhao Yakui | f0fda0a | 2009-09-03 09:33:48 +0800 | [diff] [blame] | 778 | extern int drm_add_modes_noedid(struct drm_connector *connector, |
| 779 | int hdisplay, int vdisplay); |
Alex Deucher | 3c53788 | 2010-02-05 04:21:19 -0500 | [diff] [blame] | 780 | |
| 781 | extern bool drm_edid_is_valid(struct edid *edid); |
Dave Airlie | 1d42bbc | 2010-05-07 05:02:30 +0000 | [diff] [blame] | 782 | struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev, |
| 783 | int hsize, int vsize, int fresh); |
Dave Airlie | f453ba0 | 2008-11-07 14:05:41 -0800 | [diff] [blame] | 784 | #endif /* __DRM_CRTC_H__ */ |