drm_crtc.h 42.1 KB
Newer Older
D
Dave Airlie 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
/*
 * Copyright © 2006 Keith Packard
 * Copyright © 2007-2008 Dave Airlie
 * Copyright © 2007-2008 Intel Corporation
 *   Jesse Barnes <jesse.barnes@intel.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 */
#ifndef __DRM_CRTC_H__
#define __DRM_CRTC_H__

#include <linux/i2c.h>
#include <linux/spinlock.h>
#include <linux/types.h>
#include <linux/idr.h>
#include <linux/fb.h>
33
#include <linux/hdmi.h>
34
#include <drm/drm_mode.h>
D
Dave Airlie 已提交
35

36 37
#include <drm/drm_fourcc.h>

D
Dave Airlie 已提交
38 39 40
struct drm_device;
struct drm_mode_set;
struct drm_framebuffer;
41
struct drm_object_properties;
42 43
struct drm_file;
struct drm_clip_rect;
D
Dave Airlie 已提交
44 45 46 47 48 49 50 51

#define DRM_MODE_OBJECT_CRTC 0xcccccccc
#define DRM_MODE_OBJECT_CONNECTOR 0xc0c0c0c0
#define DRM_MODE_OBJECT_ENCODER 0xe0e0e0e0
#define DRM_MODE_OBJECT_MODE 0xdededede
#define DRM_MODE_OBJECT_PROPERTY 0xb0b0b0b0
#define DRM_MODE_OBJECT_FB 0xfbfbfbfb
#define DRM_MODE_OBJECT_BLOB 0xbbbbbbbb
J
Jesse Barnes 已提交
52
#define DRM_MODE_OBJECT_PLANE 0xeeeeeeee
S
Sean Paul 已提交
53
#define DRM_MODE_OBJECT_BRIDGE 0xbdbdbdbd
D
Dave Airlie 已提交
54 55 56 57

struct drm_mode_object {
	uint32_t id;
	uint32_t type;
58 59 60
	struct drm_object_properties *properties;
};

61
#define DRM_OBJECT_MAX_PROPERTY 24
62
struct drm_object_properties {
63
	int count;
64 65
	uint32_t ids[DRM_OBJECT_MAX_PROPERTY];
	uint64_t values[DRM_OBJECT_MAX_PROPERTY];
D
Dave Airlie 已提交
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82
};

/*
 * Note on terminology:  here, for brevity and convenience, we refer to connector
 * control chips as 'CRTCs'.  They can control any type of connector, VGA, LVDS,
 * DVI, etc.  And 'screen' refers to the whole of the visible display, which
 * may span multiple monitors (and therefore multiple CRTC and connector
 * structures).
 */

enum drm_mode_status {
    MODE_OK	= 0,	/* Mode OK */
    MODE_HSYNC,		/* hsync out of range */
    MODE_VSYNC,		/* vsync out of range */
    MODE_H_ILLEGAL,	/* mode has illegal horizontal timings */
    MODE_V_ILLEGAL,	/* mode has illegal horizontal timings */
    MODE_BAD_WIDTH,	/* requires an unsupported linepitch */
L
Lucas De Marchi 已提交
83
    MODE_NOMODE,	/* no mode with a matching name */
D
Dave Airlie 已提交
84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
    MODE_NO_INTERLACE,	/* interlaced mode not supported */
    MODE_NO_DBLESCAN,	/* doublescan mode not supported */
    MODE_NO_VSCAN,	/* multiscan mode not supported */
    MODE_MEM,		/* insufficient video memory */
    MODE_VIRTUAL_X,	/* mode width too large for specified virtual size */
    MODE_VIRTUAL_Y,	/* mode height too large for specified virtual size */
    MODE_MEM_VIRT,	/* insufficient video memory given virtual size */
    MODE_NOCLOCK,	/* no fixed clock available */
    MODE_CLOCK_HIGH,	/* clock required is too high */
    MODE_CLOCK_LOW,	/* clock required is too low */
    MODE_CLOCK_RANGE,	/* clock/mode isn't in a ClockRange */
    MODE_BAD_HVALUE,	/* horizontal timing was out of range */
    MODE_BAD_VVALUE,	/* vertical timing was out of range */
    MODE_BAD_VSCAN,	/* VScan value out of range */
    MODE_HSYNC_NARROW,	/* horizontal sync too narrow */
    MODE_HSYNC_WIDE,	/* horizontal sync too wide */
    MODE_HBLANK_NARROW,	/* horizontal blanking too narrow */
    MODE_HBLANK_WIDE,	/* horizontal blanking too wide */
    MODE_VSYNC_NARROW,	/* vertical sync too narrow */
    MODE_VSYNC_WIDE,	/* vertical sync too wide */
    MODE_VBLANK_NARROW,	/* vertical blanking too narrow */
    MODE_VBLANK_WIDE,	/* vertical blanking too wide */
    MODE_PANEL,         /* exceeds panel dimensions */
    MODE_INTERLACE_WIDTH, /* width too large for interlaced mode */
    MODE_ONE_WIDTH,     /* only one width is supported */
    MODE_ONE_HEIGHT,    /* only one height is supported */
    MODE_ONE_SIZE,      /* only one resolution is supported */
    MODE_NO_REDUCED,    /* monitor doesn't accept reduced blanking */
112
    MODE_NO_STEREO,	/* stereo modes not supported */
D
Dave Airlie 已提交
113 114 115 116 117 118 119 120 121 122 123 124 125
    MODE_UNVERIFIED = -3, /* mode needs to reverified */
    MODE_BAD = -2,	/* unspecified reason */
    MODE_ERROR	= -1	/* error condition */
};

#define DRM_MODE_TYPE_CLOCK_CRTC_C (DRM_MODE_TYPE_CLOCK_C | \
				    DRM_MODE_TYPE_CRTC_C)

#define DRM_MODE(nm, t, c, hd, hss, hse, ht, hsk, vd, vss, vse, vt, vs, f) \
	.name = nm, .status = 0, .type = (t), .clock = (c), \
	.hdisplay = (hd), .hsync_start = (hss), .hsync_end = (hse), \
	.htotal = (ht), .hskew = (hsk), .vdisplay = (vd), \
	.vsync_start = (vss), .vsync_end = (vse), .vtotal = (vt), \
126
	.vscan = (vs), .flags = (f), \
127
	.base.type = DRM_MODE_OBJECT_MODE
D
Dave Airlie 已提交
128

129 130
#define CRTC_INTERLACE_HALVE_V	(1 << 0) /* halve V values for interlacing */
#define CRTC_STEREO_DOUBLE	(1 << 1) /* adjust timings for stereo modes */
D
Dave Airlie 已提交
131

132 133
#define DRM_MODE_FLAG_3D_MAX	DRM_MODE_FLAG_3D_SIDE_BY_SIDE_HALF

D
Dave Airlie 已提交
134 135 136 137 138 139 140 141
struct drm_display_mode {
	/* Header */
	struct list_head head;
	struct drm_mode_object base;

	char name[DRM_DISPLAY_MODE_LEN];

	enum drm_mode_status status;
142
	unsigned int type;
D
Dave Airlie 已提交
143 144

	/* Proposed mode values */
A
Adam Jackson 已提交
145
	int clock;		/* in kHz */
D
Dave Airlie 已提交
146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162
	int hdisplay;
	int hsync_start;
	int hsync_end;
	int htotal;
	int hskew;
	int vdisplay;
	int vsync_start;
	int vsync_end;
	int vtotal;
	int vscan;
	unsigned int flags;

	/* Addressable image size (may be 0 for projectors, etc.) */
	int width_mm;
	int height_mm;

	/* Actual mode we give to hw */
163
	int crtc_clock;		/* in KHz */
D
Dave Airlie 已提交
164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182
	int crtc_hdisplay;
	int crtc_hblank_start;
	int crtc_hblank_end;
	int crtc_hsync_start;
	int crtc_hsync_end;
	int crtc_htotal;
	int crtc_hskew;
	int crtc_vdisplay;
	int crtc_vblank_start;
	int crtc_vblank_end;
	int crtc_vsync_start;
	int crtc_vsync_end;
	int crtc_vtotal;

	/* Driver private mode info */
	int private_size;
	int *private;
	int private_flags;

A
Adam Jackson 已提交
183 184
	int vrefresh;		/* in Hz */
	int hsync;		/* in kHz */
185
	enum hdmi_picture_aspect picture_aspect_ratio;
D
Dave Airlie 已提交
186 187
};

188 189 190 191 192
static inline bool drm_mode_is_stereo(const struct drm_display_mode *mode)
{
	return mode->flags & DRM_MODE_FLAG_3D_MASK;
}

D
Dave Airlie 已提交
193 194 195 196 197 198 199 200 201 202 203 204 205 206 207
enum drm_connector_status {
	connector_status_connected = 1,
	connector_status_disconnected = 2,
	connector_status_unknown = 3,
};

enum subpixel_order {
	SubPixelUnknown = 0,
	SubPixelHorizontalRGB,
	SubPixelHorizontalBGR,
	SubPixelVerticalRGB,
	SubPixelVerticalBGR,
	SubPixelNone,
};

208 209 210
#define DRM_COLOR_FORMAT_RGB444		(1<<0)
#define DRM_COLOR_FORMAT_YCRCB444	(1<<1)
#define DRM_COLOR_FORMAT_YCRCB422	(1<<2)
D
Dave Airlie 已提交
211 212 213 214 215
/*
 * Describes a given display (e.g. CRT or flat panel) and its limitations.
 */
struct drm_display_info {
	char name[DRM_DISPLAY_INFO_LEN];
216

D
Dave Airlie 已提交
217 218 219 220 221 222 223 224
	/* Physical size */
        unsigned int width_mm;
	unsigned int height_mm;

	/* Clock limits FIXME: storage format */
	unsigned int min_vfreq, max_vfreq;
	unsigned int min_hfreq, max_hfreq;
	unsigned int pixel_clock;
J
Jesse Barnes 已提交
225
	unsigned int bpc;
D
Dave Airlie 已提交
226 227

	enum subpixel_order subpixel_order;
228
	u32 color_formats;
D
Dave Airlie 已提交
229

230
	u8 cea_rev;
D
Dave Airlie 已提交
231 232 233
};

struct drm_framebuffer_funcs {
R
Rob Clark 已提交
234
	/* note: use drm_framebuffer_remove() */
D
Dave Airlie 已提交
235 236 237 238
	void (*destroy)(struct drm_framebuffer *framebuffer);
	int (*create_handle)(struct drm_framebuffer *fb,
			     struct drm_file *file_priv,
			     unsigned int *handle);
239 240 241 242 243 244 245 246 247 248 249 250
	/**
	 * Optinal callback for the dirty fb ioctl.
	 *
	 * Userspace can notify the driver via this callback
	 * that a area of the framebuffer has changed and should
	 * be flushed to the display hardware.
	 *
	 * See documentation in drm_mode.h for the struct
	 * drm_mode_fb_dirty_cmd for more information as all
	 * the semantics and arguments have a one to one mapping
	 * on this function.
	 */
251 252
	int (*dirty)(struct drm_framebuffer *framebuffer,
		     struct drm_file *file_priv, unsigned flags,
253 254
		     unsigned color, struct drm_clip_rect *clips,
		     unsigned num_clips);
D
Dave Airlie 已提交
255 256 257 258
};

struct drm_framebuffer {
	struct drm_device *dev;
R
Rob Clark 已提交
259 260 261 262 263 264 265 266 267 268
	/*
	 * Note that the fb is refcounted for the benefit of driver internals,
	 * for example some hw, disabling a CRTC/plane is asynchronous, and
	 * scanout does not actually complete until the next vblank.  So some
	 * cleanup (like releasing the reference(s) on the backing GEM bo(s))
	 * should be deferred.  In cases like this, the driver would like to
	 * hold a ref to the fb even though it has already been removed from
	 * userspace perspective.
	 */
	struct kref refcount;
269 270 271 272
	/*
	 * Place on the dev->mode_config.fb_list, access protected by
	 * dev->mode_config.fb_lock.
	 */
D
Dave Airlie 已提交
273 274 275
	struct list_head head;
	struct drm_mode_object base;
	const struct drm_framebuffer_funcs *funcs;
276 277
	unsigned int pitches[4];
	unsigned int offsets[4];
D
Dave Airlie 已提交
278 279 280 281 282 283
	unsigned int width;
	unsigned int height;
	/* depth can be 15 or 16 */
	unsigned int depth;
	int bits_per_pixel;
	int flags;
284
	uint32_t pixel_format; /* fourcc format */
D
Dave Airlie 已提交
285
	struct list_head filp_head;
286 287
	/* if you are using the helper */
	void *helper_private;
D
Dave Airlie 已提交
288 289 290 291 292 293
};

struct drm_property_blob {
	struct drm_mode_object base;
	struct list_head head;
	unsigned int length;
294
	unsigned char data[];
D
Dave Airlie 已提交
295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316
};

struct drm_property_enum {
	uint64_t value;
	struct list_head head;
	char name[DRM_PROP_NAME_LEN];
};

struct drm_property {
	struct list_head head;
	struct drm_mode_object base;
	uint32_t flags;
	char name[DRM_PROP_NAME_LEN];
	uint32_t num_values;
	uint64_t *values;

	struct list_head enum_blob_list;
};

struct drm_crtc;
struct drm_connector;
struct drm_encoder;
317
struct drm_pending_vblank_event;
J
Jesse Barnes 已提交
318
struct drm_plane;
S
Sean Paul 已提交
319
struct drm_bridge;
D
Dave Airlie 已提交
320 321 322 323

/**
 * drm_crtc_funcs - control CRTCs for a given device
 * @save: save CRTC state
324
 * @restore: restore CRTC state
C
Christopher Harvey 已提交
325
 * @reset: reset CRTC after state has been invalidated (e.g. resume)
326 327
 * @cursor_set: setup the cursor
 * @cursor_move: move the cursor
D
Dave Airlie 已提交
328
 * @gamma_set: specify color ramp for CRTC
P
Paulo Zanoni 已提交
329 330
 * @destroy: deinit and free object
 * @set_property: called when a property is changed
331 332
 * @set_config: apply a new CRTC configuration
 * @page_flip: initiate a page flip
D
Dave Airlie 已提交
333 334 335 336 337 338 339 340 341 342 343 344 345 346 347
 *
 * The drm_crtc_funcs structure is the central CRTC management structure
 * in the DRM.  Each CRTC controls one or more connectors (note that the name
 * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc.
 * connectors, not just CRTs).
 *
 * Each driver is responsible for filling out this structure at startup time,
 * in addition to providing other modesetting features, like i2c and DDC
 * bus accessors.
 */
struct drm_crtc_funcs {
	/* Save CRTC state */
	void (*save)(struct drm_crtc *crtc); /* suspend? */
	/* Restore CRTC state */
	void (*restore)(struct drm_crtc *crtc); /* resume? */
348 349
	/* Reset CRTC state */
	void (*reset)(struct drm_crtc *crtc);
D
Dave Airlie 已提交
350 351 352 353

	/* cursor controls */
	int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv,
			  uint32_t handle, uint32_t width, uint32_t height);
354 355 356
	int (*cursor_set2)(struct drm_crtc *crtc, struct drm_file *file_priv,
			   uint32_t handle, uint32_t width, uint32_t height,
			   int32_t hot_x, int32_t hot_y);
D
Dave Airlie 已提交
357 358 359 360
	int (*cursor_move)(struct drm_crtc *crtc, int x, int y);

	/* Set gamma on the CRTC */
	void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b,
J
James Simmons 已提交
361
			  uint32_t start, uint32_t size);
D
Dave Airlie 已提交
362 363 364 365
	/* Object destroy routine */
	void (*destroy)(struct drm_crtc *crtc);

	int (*set_config)(struct drm_mode_set *set);
366 367 368

	/*
	 * Flip to the given framebuffer.  This implements the page
L
Lucas De Marchi 已提交
369
	 * flip ioctl described in drm_mode.h, specifically, the
370 371 372 373 374 375 376 377
	 * implementation must return immediately and block all
	 * rendering to the current fb until the flip has completed.
	 * If userspace set the event flag in the ioctl, the event
	 * argument will point to an event to send back when the flip
	 * completes, otherwise it will be NULL.
	 */
	int (*page_flip)(struct drm_crtc *crtc,
			 struct drm_framebuffer *fb,
378 379
			 struct drm_pending_vblank_event *event,
			 uint32_t flags);
P
Paulo Zanoni 已提交
380 381 382

	int (*set_property)(struct drm_crtc *crtc,
			    struct drm_property *property, uint64_t val);
D
Dave Airlie 已提交
383 384 385 386
};

/**
 * drm_crtc - central CRTC control structure
387 388 389
 * @dev: parent DRM device
 * @head: list management
 * @base: base KMS object for ID tracking etc.
D
Dave Airlie 已提交
390
 * @enabled: is this CRTC enabled?
391 392
 * @mode: current mode timings
 * @hwmode: mode timings as programmed to hw regs
R
Rob Clark 已提交
393 394 395
 * @invert_dimensions: for purposes of error checking crtc vs fb sizes,
 *    invert the width/height of the crtc.  This is used if the driver
 *    is performing 90 or 270 degree rotated scanout
D
Dave Airlie 已提交
396 397 398
 * @x: x position on screen
 * @y: y position on screen
 * @funcs: CRTC control functions
399 400 401 402 403 404
 * @gamma_size: size of gamma ramp
 * @gamma_store: gamma ramp values
 * @framedur_ns: precise frame timing
 * @framedur_ns: precise line timing
 * @pixeldur_ns: precise pixel timing
 * @helper_private: mid-layer private data
P
Paulo Zanoni 已提交
405
 * @properties: property tracking for this CRTC
D
Dave Airlie 已提交
406 407 408 409 410 411 412 413
 *
 * Each CRTC may have one or more connectors associated with it.  This structure
 * allows the CRTC to be controlled.
 */
struct drm_crtc {
	struct drm_device *dev;
	struct list_head head;

D
Daniel Vetter 已提交
414 415 416 417 418 419 420 421 422
	/**
	 * crtc mutex
	 *
	 * This provides a read lock for the overall crtc state (mode, dpms
	 * state, ...) and a write lock for everything which can be update
	 * without a full modeset (fb, cursor data, ...)
	 */
	struct mutex mutex;

D
Dave Airlie 已提交
423 424 425 426 427
	struct drm_mode_object base;

	/* framebuffer the connector is currently bound to */
	struct drm_framebuffer *fb;

D
Daniel Vetter 已提交
428 429 430 431
	/* Temporary tracking of the old fb while a modeset is ongoing. Used
	 * by drm_mode_set_config_internal to implement correct refcounting. */
	struct drm_framebuffer *old_fb;

D
Dave Airlie 已提交
432 433
	bool enabled;

434
	/* Requested mode from modesetting. */
D
Dave Airlie 已提交
435 436
	struct drm_display_mode mode;

437 438 439 440 441
	/* Programmed mode in hw, after adjustments for encoders,
	 * crtc, panel scaling etc. Needed for timestamping etc.
	 */
	struct drm_display_mode hwmode;

R
Rob Clark 已提交
442 443
	bool invert_dimensions;

D
Dave Airlie 已提交
444 445 446 447 448 449 450
	int x, y;
	const struct drm_crtc_funcs *funcs;

	/* CRTC gamma size for reporting to userspace */
	uint32_t gamma_size;
	uint16_t *gamma_store;

451
	/* Constants needed for precise vblank and swap timestamping. */
452
	int framedur_ns, linedur_ns, pixeldur_ns;
453

D
Dave Airlie 已提交
454 455
	/* if you are using the helper */
	void *helper_private;
P
Paulo Zanoni 已提交
456 457

	struct drm_object_properties properties;
D
Dave Airlie 已提交
458 459 460 461 462 463 464 465
};


/**
 * drm_connector_funcs - control connectors on a given device
 * @dpms: set power state (see drm_crtc_funcs above)
 * @save: save connector state
 * @restore: restore connector state
466
 * @reset: reset connector after state has been invalidated (e.g. resume)
D
Dave Airlie 已提交
467
 * @detect: is this connector active?
468
 * @fill_modes: fill mode list for this connector
469
 * @set_property: property for this connector may need an update
D
Dave Airlie 已提交
470
 * @destroy: make object go away
471
 * @force: notify the driver that the connector is forced on
D
Dave Airlie 已提交
472 473 474 475 476 477 478 479 480
 *
 * Each CRTC may have one or more connectors attached to it.  The functions
 * below allow the core DRM code to control connectors, enumerate available modes,
 * etc.
 */
struct drm_connector_funcs {
	void (*dpms)(struct drm_connector *connector, int mode);
	void (*save)(struct drm_connector *connector);
	void (*restore)(struct drm_connector *connector);
481
	void (*reset)(struct drm_connector *connector);
482 483 484 485 486 487 488

	/* Check to see if anything is attached to the connector.
	 * @force is set to false whilst polling, true when checking the
	 * connector due to user request. @force can be used by the driver
	 * to avoid expensive, destructive operations during automated
	 * probing.
	 */
489
	enum drm_connector_status (*detect)(struct drm_connector *connector,
490
					    bool force);
J
Jesse Barnes 已提交
491
	int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height);
D
Dave Airlie 已提交
492 493 494
	int (*set_property)(struct drm_connector *connector, struct drm_property *property,
			     uint64_t val);
	void (*destroy)(struct drm_connector *connector);
495
	void (*force)(struct drm_connector *connector);
D
Dave Airlie 已提交
496 497
};

498 499 500 501 502 503 504
/**
 * drm_encoder_funcs - encoder controls
 * @reset: reset state (e.g. at init or resume time)
 * @destroy: cleanup and free associated data
 *
 * Encoders sit between CRTCs and connectors.
 */
D
Dave Airlie 已提交
505
struct drm_encoder_funcs {
506
	void (*reset)(struct drm_encoder *encoder);
D
Dave Airlie 已提交
507 508 509
	void (*destroy)(struct drm_encoder *encoder);
};

510
#define DRM_CONNECTOR_MAX_ENCODER 3
D
Dave Airlie 已提交
511 512 513

/**
 * drm_encoder - central DRM encoder structure
J
Jesse Barnes 已提交
514 515 516 517 518 519 520
 * @dev: parent DRM device
 * @head: list management
 * @base: base KMS object
 * @encoder_type: one of the %DRM_MODE_ENCODER_<foo> types in drm_mode.h
 * @possible_crtcs: bitmask of potential CRTC bindings
 * @possible_clones: bitmask of potential sibling encoders for cloning
 * @crtc: currently bound CRTC
S
Sean Paul 已提交
521
 * @bridge: bridge associated to the encoder
J
Jesse Barnes 已提交
522 523 524 525 526
 * @funcs: control functions
 * @helper_private: mid-layer private data
 *
 * CRTCs drive pixels to encoders, which convert them into signals
 * appropriate for a given connector or set of connectors.
D
Dave Airlie 已提交
527 528 529 530 531 532 533 534 535 536 537
 */
struct drm_encoder {
	struct drm_device *dev;
	struct list_head head;

	struct drm_mode_object base;
	int encoder_type;
	uint32_t possible_crtcs;
	uint32_t possible_clones;

	struct drm_crtc *crtc;
S
Sean Paul 已提交
538
	struct drm_bridge *bridge;
D
Dave Airlie 已提交
539 540 541 542
	const struct drm_encoder_funcs *funcs;
	void *helper_private;
};

543 544 545 546 547 548 549
enum drm_connector_force {
	DRM_FORCE_UNSPECIFIED,
	DRM_FORCE_OFF,
	DRM_FORCE_ON,         /* force on analog part normally */
	DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */
};

550 551 552 553 554 555 556 557 558
/* should we poll this connector for connects and disconnects */
/* hot plug detectable */
#define DRM_CONNECTOR_POLL_HPD (1 << 0)
/* poll for connections */
#define DRM_CONNECTOR_POLL_CONNECT (1 << 1)
/* can cleanly poll for disconnections without flickering the screen */
/* DACs should rarely do this without a lot of testing */
#define DRM_CONNECTOR_POLL_DISCONNECT (1 << 2)

559 560
#define MAX_ELD_BYTES	128

D
Dave Airlie 已提交
561 562
/**
 * drm_connector - central DRM connector control structure
563 564 565 566 567 568 569
 * @dev: parent DRM device
 * @kdev: kernel device for sysfs attributes
 * @attr: sysfs attributes
 * @head: list management
 * @base: base KMS object
 * @connector_type: one of the %DRM_MODE_CONNECTOR_<foo> types from drm_mode.h
 * @connector_type_id: index into connector type enum
D
Dave Airlie 已提交
570 571
 * @interlace_allowed: can this connector handle interlaced modes?
 * @doublescan_allowed: can this connector handle doublescan?
572 573 574 575
 * @modes: modes available on this connector (from fill_modes() + user)
 * @status: one of the drm_connector_status enums (connected, not, or unknown)
 * @probed_modes: list of modes derived directly from the display
 * @display_info: information about attached display (e.g. from EDID)
D
Dave Airlie 已提交
576
 * @funcs: connector control functions
577
 * @edid_blob_ptr: DRM property containing EDID if present
578
 * @properties: property tracking for this connector
579 580 581 582 583 584 585 586 587 588 589 590 591
 * @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling
 * @dpms: current dpms state
 * @helper_private: mid-layer private data
 * @force: a %DRM_FORCE_<foo> state for forced mode sets
 * @encoder_ids: valid encoders for this connector
 * @encoder: encoder driving this connector, if any
 * @eld: EDID-like data, if present
 * @dvi_dual: dual link DVI, if found
 * @max_tmds_clock: max clock rate, if found
 * @latency_present: AV delay info from ELD, if found
 * @video_latency: video latency info from ELD, if found
 * @audio_latency: audio latency info from ELD, if found
 * @null_edid_counter: track sinks that give us all zeros for the EDID
D
Dave Airlie 已提交
592 593 594 595 596 597 598 599
 *
 * Each connector may be connected to one or more CRTCs, or may be clonable by
 * another connector if they can share a CRTC.  Each connector also has a specific
 * position in the broader display (referred to as a 'screen' though it could
 * span multiple monitors).
 */
struct drm_connector {
	struct drm_device *dev;
600
	struct device *kdev;
D
Dave Airlie 已提交
601 602 603 604 605 606 607 608 609
	struct device_attribute *attr;
	struct list_head head;

	struct drm_mode_object base;

	int connector_type;
	int connector_type_id;
	bool interlace_allowed;
	bool doublescan_allowed;
610
	bool stereo_allowed;
D
Dave Airlie 已提交
611 612 613 614 615 616 617 618 619 620 621
	struct list_head modes; /* list of modes on this connector */

	enum drm_connector_status status;

	/* these are modes added by probing with DDC or the BIOS */
	struct list_head probed_modes;

	struct drm_display_info display_info;
	const struct drm_connector_funcs *funcs;

	struct drm_property_blob *edid_blob_ptr;
622
	struct drm_object_properties properties;
D
Dave Airlie 已提交
623

624 625
	uint8_t polled; /* DRM_CONNECTOR_POLL_* */

626 627 628
	/* requested DPMS state */
	int dpms;

D
Dave Airlie 已提交
629 630
	void *helper_private;

631 632
	/* forced on connector */
	enum drm_connector_force force;
D
Dave Airlie 已提交
633 634
	uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER];
	struct drm_encoder *encoder; /* currently active encoder */
635

636 637 638 639 640 641 642
	/* EDID bits */
	uint8_t eld[MAX_ELD_BYTES];
	bool dvi_dual;
	int max_tmds_clock;	/* in MHz */
	bool latency_present[2];
	int video_latency[2];	/* [0]: progressive, [1]: interlaced */
	int audio_latency[2];
643
	int null_edid_counter; /* needed to workaround some HW bugs where we get all 0s */
644
	unsigned bad_edid_counter;
D
Dave Airlie 已提交
645 646
};

J
Jesse Barnes 已提交
647 648 649 650 651
/**
 * drm_plane_funcs - driver plane control functions
 * @update_plane: update the plane configuration
 * @disable_plane: shut down the plane
 * @destroy: clean up plane resources
R
Rob Clark 已提交
652
 * @set_property: called when a property is changed
J
Jesse Barnes 已提交
653 654 655 656 657 658 659 660 661 662
 */
struct drm_plane_funcs {
	int (*update_plane)(struct drm_plane *plane,
			    struct drm_crtc *crtc, struct drm_framebuffer *fb,
			    int crtc_x, int crtc_y,
			    unsigned int crtc_w, unsigned int crtc_h,
			    uint32_t src_x, uint32_t src_y,
			    uint32_t src_w, uint32_t src_h);
	int (*disable_plane)(struct drm_plane *plane);
	void (*destroy)(struct drm_plane *plane);
R
Rob Clark 已提交
663 664 665

	int (*set_property)(struct drm_plane *plane,
			    struct drm_property *property, uint64_t val);
J
Jesse Barnes 已提交
666 667 668 669 670 671 672 673 674 675 676 677 678
};

/**
 * drm_plane - central DRM plane control structure
 * @dev: DRM device this plane belongs to
 * @head: for list management
 * @base: base mode object
 * @possible_crtcs: pipes this plane can be bound to
 * @format_types: array of formats supported by this plane
 * @format_count: number of formats supported
 * @crtc: currently bound CRTC
 * @fb: currently bound fb
 * @funcs: helper functions
R
Rob Clark 已提交
679
 * @properties: property tracking for this plane
J
Jesse Barnes 已提交
680 681 682 683 684 685 686 687 688 689 690 691 692 693 694
 */
struct drm_plane {
	struct drm_device *dev;
	struct list_head head;

	struct drm_mode_object base;

	uint32_t possible_crtcs;
	uint32_t *format_types;
	uint32_t format_count;

	struct drm_crtc *crtc;
	struct drm_framebuffer *fb;

	const struct drm_plane_funcs *funcs;
R
Rob Clark 已提交
695 696

	struct drm_object_properties properties;
J
Jesse Barnes 已提交
697 698
};

S
Sean Paul 已提交
699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740
/**
 * drm_bridge_funcs - drm_bridge control functions
 * @mode_fixup: Try to fixup (or reject entirely) proposed mode for this bridge
 * @disable: Called right before encoder prepare, disables the bridge
 * @post_disable: Called right after encoder prepare, for lockstepped disable
 * @mode_set: Set this mode to the bridge
 * @pre_enable: Called right before encoder commit, for lockstepped commit
 * @enable: Called right after encoder commit, enables the bridge
 * @destroy: make object go away
 */
struct drm_bridge_funcs {
	bool (*mode_fixup)(struct drm_bridge *bridge,
			   const struct drm_display_mode *mode,
			   struct drm_display_mode *adjusted_mode);
	void (*disable)(struct drm_bridge *bridge);
	void (*post_disable)(struct drm_bridge *bridge);
	void (*mode_set)(struct drm_bridge *bridge,
			 struct drm_display_mode *mode,
			 struct drm_display_mode *adjusted_mode);
	void (*pre_enable)(struct drm_bridge *bridge);
	void (*enable)(struct drm_bridge *bridge);
	void (*destroy)(struct drm_bridge *bridge);
};

/**
 * drm_bridge - central DRM bridge control structure
 * @dev: DRM device this bridge belongs to
 * @head: list management
 * @base: base mode object
 * @funcs: control functions
 * @driver_private: pointer to the bridge driver's internal context
 */
struct drm_bridge {
	struct drm_device *dev;
	struct list_head head;

	struct drm_mode_object base;

	const struct drm_bridge_funcs *funcs;
	void *driver_private;
};

D
Dave Airlie 已提交
741
/**
742 743 744 745 746 747 748 749 750
 * drm_mode_set - new values for a CRTC config change
 * @head: list management
 * @fb: framebuffer to use for new config
 * @crtc: CRTC whose configuration we're about to change
 * @mode: mode timings to use
 * @x: position of this CRTC relative to @fb
 * @y: position of this CRTC relative to @fb
 * @connectors: array of connectors to drive with this CRTC if possible
 * @num_connectors: size of @connectors array
D
Dave Airlie 已提交
751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769
 *
 * Represents a single crtc the connectors that it drives with what mode
 * and from which framebuffer it scans out from.
 *
 * This is used to set modes.
 */
struct drm_mode_set {
	struct drm_framebuffer *fb;
	struct drm_crtc *crtc;
	struct drm_display_mode *mode;

	uint32_t x;
	uint32_t y;

	struct drm_connector **connectors;
	size_t num_connectors;
};

/**
770 771 772 773 774 775
 * struct drm_mode_config_funcs - basic driver provided mode setting functions
 * @fb_create: create a new framebuffer object
 * @output_poll_changed: function to handle output configuration changes
 *
 * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that
 * involve drivers.
D
Dave Airlie 已提交
776 777
 */
struct drm_mode_config_funcs {
778 779 780
	struct drm_framebuffer *(*fb_create)(struct drm_device *dev,
					     struct drm_file *file_priv,
					     struct drm_mode_fb_cmd2 *mode_cmd);
781
	void (*output_poll_changed)(struct drm_device *dev);
D
Dave Airlie 已提交
782 783
};

784 785 786 787 788 789 790 791 792 793 794 795 796
/**
 * drm_mode_group - group of mode setting resources for potential sub-grouping
 * @num_crtcs: CRTC count
 * @num_encoders: encoder count
 * @num_connectors: connector count
 * @id_list: list of KMS object IDs in this group
 *
 * Currently this simply tracks the global mode setting state.  But in the
 * future it could allow groups of objects to be set aside into independent
 * control groups for use by different user level processes (e.g. two X servers
 * running simultaneously on different heads, each with their own mode
 * configuration and freedom of mode setting).
 */
D
Dave Airlie 已提交
797 798 799 800
struct drm_mode_group {
	uint32_t num_crtcs;
	uint32_t num_encoders;
	uint32_t num_connectors;
S
Sean Paul 已提交
801
	uint32_t num_bridges;
D
Dave Airlie 已提交
802 803 804 805 806 807 808

	/* list of object IDs for this group */
	uint32_t *id_list;
};

/**
 * drm_mode_config - Mode configuration control structure
809 810 811 812 813 814 815
 * @mutex: mutex protecting KMS related lists and structures
 * @idr_mutex: mutex for KMS ID allocation and management
 * @crtc_idr: main KMS ID tracking object
 * @num_fb: number of fbs available
 * @fb_list: list of framebuffers available
 * @num_connector: number of connectors on this device
 * @connector_list: list of connector objects
S
Sean Paul 已提交
816 817
 * @num_bridge: number of bridges on this device
 * @bridge_list: list of bridge objects
818 819 820 821 822 823 824 825 826 827 828 829 830
 * @num_encoder: number of encoders on this device
 * @encoder_list: list of encoder objects
 * @num_crtc: number of CRTCs on this device
 * @crtc_list: list of CRTC objects
 * @min_width: minimum pixel width on this device
 * @min_height: minimum pixel height on this device
 * @max_width: maximum pixel width on this device
 * @max_height: maximum pixel height on this device
 * @funcs: core driver provided mode setting functions
 * @fb_base: base address of the framebuffer
 * @poll_enabled: track polling status for this device
 * @output_poll_work: delayed work for polling in process context
 * @*_property: core property tracking
D
Dave Airlie 已提交
831
 *
832 833 834
 * Core mode resource tracking structure.  All CRTC, encoders, and connectors
 * enumerated by the driver are added here, as are global properties.  Some
 * global restrictions are also here, e.g. dimension restrictions.
D
Dave Airlie 已提交
835 836
 */
struct drm_mode_config {
J
Jesse Barnes 已提交
837 838
	struct mutex mutex; /* protects configuration (mode lists etc.) */
	struct mutex idr_mutex; /* for IDR management */
D
Dave Airlie 已提交
839 840
	struct idr crtc_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */
	/* this is limited to one for now */
841 842 843 844 845 846 847 848 849


	/**
	 * fb_lock - mutex to protect fb state
	 *
	 * Besides the global fb list his also protects the fbs list in the
	 * file_priv
	 */
	struct mutex fb_lock;
D
Dave Airlie 已提交
850 851
	int num_fb;
	struct list_head fb_list;
852

D
Dave Airlie 已提交
853 854
	int num_connector;
	struct list_head connector_list;
S
Sean Paul 已提交
855 856
	int num_bridge;
	struct list_head bridge_list;
D
Dave Airlie 已提交
857 858
	int num_encoder;
	struct list_head encoder_list;
J
Jesse Barnes 已提交
859 860
	int num_plane;
	struct list_head plane_list;
D
Dave Airlie 已提交
861 862 863 864 865 866 867 868

	int num_crtc;
	struct list_head crtc_list;

	struct list_head property_list;

	int min_width, min_height;
	int max_width, max_height;
869
	const struct drm_mode_config_funcs *funcs;
870
	resource_size_t fb_base;
D
Dave Airlie 已提交
871

872 873
	/* output poll support */
	bool poll_enabled;
874
	bool poll_running;
875
	struct delayed_work output_poll_work;
876

D
Dave Airlie 已提交
877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893
	/* pointers to standard properties */
	struct list_head property_blob_list;
	struct drm_property *edid_property;
	struct drm_property *dpms_property;

	/* DVI-I properties */
	struct drm_property *dvi_i_subconnector_property;
	struct drm_property *dvi_i_select_subconnector_property;

	/* TV properties */
	struct drm_property *tv_subconnector_property;
	struct drm_property *tv_select_subconnector_property;
	struct drm_property *tv_mode_property;
	struct drm_property *tv_left_margin_property;
	struct drm_property *tv_right_margin_property;
	struct drm_property *tv_top_margin_property;
	struct drm_property *tv_bottom_margin_property;
894 895 896
	struct drm_property *tv_brightness_property;
	struct drm_property *tv_contrast_property;
	struct drm_property *tv_flicker_reduction_property;
897 898 899
	struct drm_property *tv_overscan_property;
	struct drm_property *tv_saturation_property;
	struct drm_property *tv_hue_property;
D
Dave Airlie 已提交
900 901 902

	/* Optional properties */
	struct drm_property *scaling_mode_property;
903
	struct drm_property *dirty_info_property;
904 905 906

	/* dumb ioctl parameters */
	uint32_t preferred_depth, prefer_shadow;
907 908 909

	/* whether async page flip is supported or not */
	bool async_page_flip;
A
Alex Deucher 已提交
910 911 912

	/* cursor size */
	uint32_t cursor_width, cursor_height;
D
Dave Airlie 已提交
913 914 915 916 917 918 919 920 921
};

#define obj_to_crtc(x) container_of(x, struct drm_crtc, base)
#define obj_to_connector(x) container_of(x, struct drm_connector, base)
#define obj_to_encoder(x) container_of(x, struct drm_encoder, base)
#define obj_to_mode(x) container_of(x, struct drm_display_mode, base)
#define obj_to_fb(x) container_of(x, struct drm_framebuffer, base)
#define obj_to_property(x) container_of(x, struct drm_property, base)
#define obj_to_blob(x) container_of(x, struct drm_property_blob, base)
J
Jesse Barnes 已提交
922
#define obj_to_plane(x) container_of(x, struct drm_plane, base)
D
Dave Airlie 已提交
923

924 925 926 927
struct drm_prop_enum_list {
	int type;
	char *name;
};
D
Dave Airlie 已提交
928

929 930
extern void drm_modeset_lock_all(struct drm_device *dev);
extern void drm_modeset_unlock_all(struct drm_device *dev);
931
extern void drm_warn_on_modeset_not_all_locked(struct drm_device *dev);
932

933 934 935
extern int drm_crtc_init(struct drm_device *dev,
			 struct drm_crtc *crtc,
			 const struct drm_crtc_funcs *funcs);
D
Dave Airlie 已提交
936
extern void drm_crtc_cleanup(struct drm_crtc *crtc);
937 938 939 940 941 942 943 944 945 946 947 948 949
extern unsigned int drm_crtc_index(struct drm_crtc *crtc);

/**
 * drm_crtc_mask - find the mask of a registered CRTC
 * @crtc: CRTC to find mask for
 *
 * Given a registered CRTC, return the mask bit of that CRTC for an
 * encoder's possible_crtcs field.
 */
static inline uint32_t drm_crtc_mask(struct drm_crtc *crtc)
{
	return 1 << drm_crtc_index(crtc);
}
D
Dave Airlie 已提交
950

951 952
extern void drm_connector_ida_init(void);
extern void drm_connector_ida_destroy(void);
953 954 955 956
extern int drm_connector_init(struct drm_device *dev,
			      struct drm_connector *connector,
			      const struct drm_connector_funcs *funcs,
			      int connector_type);
D
Dave Airlie 已提交
957 958

extern void drm_connector_cleanup(struct drm_connector *connector);
959 960
/* helper to unplug all connectors from sysfs for device */
extern void drm_connector_unplug_all(struct drm_device *dev);
D
Dave Airlie 已提交
961

S
Sean Paul 已提交
962 963 964 965
extern int drm_bridge_init(struct drm_device *dev, struct drm_bridge *bridge,
			   const struct drm_bridge_funcs *funcs);
extern void drm_bridge_cleanup(struct drm_bridge *bridge);

966 967 968 969
extern int drm_encoder_init(struct drm_device *dev,
			    struct drm_encoder *encoder,
			    const struct drm_encoder_funcs *funcs,
			    int encoder_type);
D
Dave Airlie 已提交
970

971 972 973 974 975 976 977 978 979 980 981 982 983
/**
 * drm_encoder_crtc_ok - can a given crtc drive a given encoder?
 * @encoder: encoder to test
 * @crtc: crtc to test
 *
 * Return false if @encoder can't be driven by @crtc, true otherwise.
 */
static inline bool drm_encoder_crtc_ok(struct drm_encoder *encoder,
				       struct drm_crtc *crtc)
{
	return !!(encoder->possible_crtcs & drm_crtc_mask(crtc));
}

J
Jesse Barnes 已提交
984 985 986 987
extern int drm_plane_init(struct drm_device *dev,
			  struct drm_plane *plane,
			  unsigned long possible_crtcs,
			  const struct drm_plane_funcs *funcs,
R
Rob Clark 已提交
988 989
			  const uint32_t *formats, uint32_t format_count,
			  bool priv);
J
Jesse Barnes 已提交
990
extern void drm_plane_cleanup(struct drm_plane *plane);
991
extern void drm_plane_force_disable(struct drm_plane *plane);
J
Jesse Barnes 已提交
992

D
Dave Airlie 已提交
993 994
extern void drm_encoder_cleanup(struct drm_encoder *encoder);

995 996
extern const char *drm_get_connector_name(const struct drm_connector *connector);
extern const char *drm_get_connector_status_name(enum drm_connector_status status);
997
extern const char *drm_get_subpixel_order_name(enum subpixel_order order);
998 999 1000 1001 1002
extern const char *drm_get_dpms_name(int val);
extern const char *drm_get_dvi_i_subconnector_name(int val);
extern const char *drm_get_dvi_i_select_name(int val);
extern const char *drm_get_tv_subconnector_name(int val);
extern const char *drm_get_tv_select_name(int val);
1003
extern void drm_fb_release(struct drm_file *file_priv);
D
Dave Airlie 已提交
1004
extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group);
A
Adam Jackson 已提交
1005
extern bool drm_probe_ddc(struct i2c_adapter *adapter);
D
Dave Airlie 已提交
1006 1007
extern struct edid *drm_get_edid(struct drm_connector *connector,
				 struct i2c_adapter *adapter);
J
Jani Nikula 已提交
1008
extern struct edid *drm_edid_duplicate(const struct edid *edid);
D
Dave Airlie 已提交
1009 1010
extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid);
extern void drm_mode_probed_add(struct drm_connector *connector, struct drm_display_mode *mode);
V
Ville Syrjälä 已提交
1011
extern void drm_mode_copy(struct drm_display_mode *dst, const struct drm_display_mode *src);
D
Dave Airlie 已提交
1012
extern struct drm_display_mode *drm_mode_duplicate(struct drm_device *dev,
1013
						   const struct drm_display_mode *mode);
1014
extern void drm_mode_debug_printmodeline(const struct drm_display_mode *mode);
D
Dave Airlie 已提交
1015
extern void drm_mode_config_init(struct drm_device *dev);
1016
extern void drm_mode_config_reset(struct drm_device *dev);
D
Dave Airlie 已提交
1017 1018
extern void drm_mode_config_cleanup(struct drm_device *dev);
extern void drm_mode_set_name(struct drm_display_mode *mode);
1019
extern bool drm_mode_equal(const struct drm_display_mode *mode1, const struct drm_display_mode *mode2);
1020
extern bool drm_mode_equal_no_clocks_no_stereo(const struct drm_display_mode *mode1, const struct drm_display_mode *mode2);
1021 1022
extern int drm_mode_width(const struct drm_display_mode *mode);
extern int drm_mode_height(const struct drm_display_mode *mode);
D
Dave Airlie 已提交
1023 1024 1025 1026 1027 1028 1029 1030 1031 1032

/* for us by fb module */
extern struct drm_display_mode *drm_mode_create(struct drm_device *dev);
extern void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode);
extern void drm_mode_validate_size(struct drm_device *dev,
				   struct list_head *mode_list,
				   int maxX, int maxY, int maxPitch);
extern void drm_mode_prune_invalid(struct drm_device *dev,
				   struct list_head *mode_list, bool verbose);
extern void drm_mode_sort(struct list_head *mode_list);
1033 1034
extern int drm_mode_hsync(const struct drm_display_mode *mode);
extern int drm_mode_vrefresh(const struct drm_display_mode *mode);
D
Dave Airlie 已提交
1035 1036 1037 1038 1039
extern void drm_mode_set_crtcinfo(struct drm_display_mode *p,
				  int adjust_flags);
extern void drm_mode_connector_list_update(struct drm_connector *connector);
extern int drm_mode_connector_update_edid_property(struct drm_connector *connector,
						struct edid *edid);
1040 1041 1042 1043 1044 1045
extern int drm_object_property_set_value(struct drm_mode_object *obj,
					 struct drm_property *property,
					 uint64_t val);
extern int drm_object_property_get_value(struct drm_mode_object *obj,
					 struct drm_property *property,
					 uint64_t *value);
D
Dave Airlie 已提交
1046 1047 1048
extern int drm_framebuffer_init(struct drm_device *dev,
				struct drm_framebuffer *fb,
				const struct drm_framebuffer_funcs *funcs);
1049 1050
extern struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev,
						      uint32_t id);
R
Rob Clark 已提交
1051 1052 1053
extern void drm_framebuffer_unreference(struct drm_framebuffer *fb);
extern void drm_framebuffer_reference(struct drm_framebuffer *fb);
extern void drm_framebuffer_remove(struct drm_framebuffer *fb);
D
Dave Airlie 已提交
1054
extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb);
1055
extern void drm_framebuffer_unregister_private(struct drm_framebuffer *fb);
D
Dave Airlie 已提交
1056

1057 1058 1059
extern void drm_object_attach_property(struct drm_mode_object *obj,
				       struct drm_property *property,
				       uint64_t init_val);
D
Dave Airlie 已提交
1060 1061
extern struct drm_property *drm_property_create(struct drm_device *dev, int flags,
						const char *name, int num_values);
1062 1063
extern struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
					 const char *name,
R
Rob Clark 已提交
1064 1065 1066 1067
					 const struct drm_prop_enum_list *props,
					 int num_values);
struct drm_property *drm_property_create_bitmask(struct drm_device *dev,
					 int flags, const char *name,
1068 1069
					 const struct drm_prop_enum_list *props,
					 int num_values);
1070 1071 1072
struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
					 const char *name,
					 uint64_t min, uint64_t max);
D
Dave Airlie 已提交
1073 1074 1075 1076 1077 1078 1079
extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property);
extern int drm_property_add_enum(struct drm_property *property, int index,
				 uint64_t value, const char *name);
extern int drm_mode_create_dvi_i_properties(struct drm_device *dev);
extern int drm_mode_create_tv_properties(struct drm_device *dev, int num_formats,
				     char *formats[]);
extern int drm_mode_create_scaling_mode_property(struct drm_device *dev);
1080
extern int drm_mode_create_dirty_info_property(struct drm_device *dev);
1081
extern const char *drm_get_encoder_name(const struct drm_encoder *encoder);
D
Dave Airlie 已提交
1082 1083 1084

extern int drm_mode_connector_attach_encoder(struct drm_connector *connector,
					     struct drm_encoder *encoder);
1085
extern int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
D
Dave Airlie 已提交
1086
					 int gamma_size);
1087 1088
extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
		uint32_t id, uint32_t type);
D
Dave Airlie 已提交
1089 1090 1091
/* IOCTLs */
extern int drm_mode_getresources(struct drm_device *dev,
				 void *data, struct drm_file *file_priv);
J
Jesse Barnes 已提交
1092 1093
extern int drm_mode_getplane_res(struct drm_device *dev, void *data,
				   struct drm_file *file_priv);
D
Dave Airlie 已提交
1094 1095 1096 1097
extern int drm_mode_getcrtc(struct drm_device *dev,
			    void *data, struct drm_file *file_priv);
extern int drm_mode_getconnector(struct drm_device *dev,
			      void *data, struct drm_file *file_priv);
1098
extern int drm_mode_set_config_internal(struct drm_mode_set *set);
D
Dave Airlie 已提交
1099 1100
extern int drm_mode_setcrtc(struct drm_device *dev,
			    void *data, struct drm_file *file_priv);
J
Jesse Barnes 已提交
1101 1102 1103 1104
extern int drm_mode_getplane(struct drm_device *dev,
			       void *data, struct drm_file *file_priv);
extern int drm_mode_setplane(struct drm_device *dev,
			       void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
1105 1106
extern int drm_mode_cursor_ioctl(struct drm_device *dev,
				void *data, struct drm_file *file_priv);
1107 1108
extern int drm_mode_cursor2_ioctl(struct drm_device *dev,
				void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
1109 1110
extern int drm_mode_addfb(struct drm_device *dev,
			  void *data, struct drm_file *file_priv);
1111 1112 1113
extern int drm_mode_addfb2(struct drm_device *dev,
			   void *data, struct drm_file *file_priv);
extern uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth);
D
Dave Airlie 已提交
1114 1115 1116 1117
extern int drm_mode_rmfb(struct drm_device *dev,
			 void *data, struct drm_file *file_priv);
extern int drm_mode_getfb(struct drm_device *dev,
			  void *data, struct drm_file *file_priv);
1118 1119
extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
				  void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132

extern int drm_mode_getproperty_ioctl(struct drm_device *dev,
				      void *data, struct drm_file *file_priv);
extern int drm_mode_getblob_ioctl(struct drm_device *dev,
				  void *data, struct drm_file *file_priv);
extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev,
					      void *data, struct drm_file *file_priv);
extern int drm_mode_getencoder(struct drm_device *dev,
			       void *data, struct drm_file *file_priv);
extern int drm_mode_gamma_get_ioctl(struct drm_device *dev,
				    void *data, struct drm_file *file_priv);
extern int drm_mode_gamma_set_ioctl(struct drm_device *dev,
				    void *data, struct drm_file *file_priv);
1133
extern u8 drm_match_cea_mode(const struct drm_display_mode *to_match);
1134
extern bool drm_detect_hdmi_monitor(struct edid *edid);
1135
extern bool drm_detect_monitor_audio(struct edid *edid);
1136
extern bool drm_rgb_quant_range_selectable(struct edid *edid);
1137 1138
extern int drm_mode_page_flip_ioctl(struct drm_device *dev,
				    void *data, struct drm_file *file_priv);
1139 1140
extern struct drm_display_mode *drm_cvt_mode(struct drm_device *dev,
				int hdisplay, int vdisplay, int vrefresh,
1141
				bool reduced, bool interlaced, bool margins);
1142 1143 1144
extern struct drm_display_mode *drm_gtf_mode(struct drm_device *dev,
				int hdisplay, int vdisplay, int vrefresh,
				bool interlaced, int margins);
1145 1146 1147 1148
extern struct drm_display_mode *drm_gtf_mode_complex(struct drm_device *dev,
				int hdisplay, int vdisplay, int vrefresh,
				bool interlaced, int margins, int GTF_M,
				int GTF_2C, int GTF_K, int GTF_2J);
1149 1150
extern int drm_add_modes_noedid(struct drm_connector *connector,
				int hdisplay, int vdisplay);
G
Gerd Hoffmann 已提交
1151 1152
extern void drm_set_preferred_mode(struct drm_connector *connector,
				   int hpref, int vpref);
1153

1154
extern int drm_edid_header_is_valid(const u8 *raw_edid);
1155
extern bool drm_edid_block_valid(u8 *raw_edid, int block, bool print_bad_edid);
1156
extern bool drm_edid_is_valid(struct edid *edid);
D
Dave Airlie 已提交
1157
struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev,
1158 1159
					   int hsize, int vsize, int fresh,
					   bool rb);
1160 1161 1162 1163 1164 1165 1166

extern int drm_mode_create_dumb_ioctl(struct drm_device *dev,
				      void *data, struct drm_file *file_priv);
extern int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
				    void *data, struct drm_file *file_priv);
extern int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
				      void *data, struct drm_file *file_priv);
1167 1168 1169 1170
extern int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
					     struct drm_file *file_priv);
extern int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
					   struct drm_file *file_priv);
1171 1172 1173

extern void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
				 int *bpp);
1174
extern int drm_format_num_planes(uint32_t format);
1175
extern int drm_format_plane_cpp(uint32_t format, int plane);
1176 1177
extern int drm_format_horz_chroma_subsampling(uint32_t format);
extern int drm_format_vert_chroma_subsampling(uint32_t format);
1178
extern const char *drm_get_format_name(uint32_t format);
1179

R
Russell King 已提交
1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196
/* Helpers */
static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev,
	uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CRTC);
	return mo ? obj_to_crtc(mo) : NULL;
}

static inline struct drm_encoder *drm_encoder_find(struct drm_device *dev,
	uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_ENCODER);
	return mo ? obj_to_encoder(mo) : NULL;
}

D
Dave Airlie 已提交
1197
#endif /* __DRM_CRTC_H__ */