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