drm_crtc.h 48.6 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 35
#include <uapi/drm/drm_mode.h>
#include <uapi/drm/drm_fourcc.h>
36
#include <drm/drm_modeset_lock.h>
37

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;
44
struct device_node;
45
struct fence;
D
Dave Airlie 已提交
46 47 48 49 50 51 52 53

#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 已提交
54
#define DRM_MODE_OBJECT_PLANE 0xeeeeeeee
S
Sean Paul 已提交
55
#define DRM_MODE_OBJECT_BRIDGE 0xbdbdbdbd
R
Rob Clark 已提交
56
#define DRM_MODE_OBJECT_ANY 0
D
Dave Airlie 已提交
57 58 59 60

struct drm_mode_object {
	uint32_t id;
	uint32_t type;
61 62 63
	struct drm_object_properties *properties;
};

64
#define DRM_OBJECT_MAX_PROPERTY 24
65
struct drm_object_properties {
66
	int count;
67 68
	uint32_t ids[DRM_OBJECT_MAX_PROPERTY];
	uint64_t values[DRM_OBJECT_MAX_PROPERTY];
D
Dave Airlie 已提交
69 70
};

R
Rob Clark 已提交
71 72 73 74 75 76 77 78 79
static inline int64_t U642I64(uint64_t val)
{
	return (int64_t)*((int64_t *)&val);
}
static inline uint64_t I642U64(int64_t val)
{
	return (uint64_t)*((uint64_t *)&val);
}

80 81 82 83 84 85 86 87
/* rotation property bits */
#define DRM_ROTATE_0	0
#define DRM_ROTATE_90	1
#define DRM_ROTATE_180	2
#define DRM_ROTATE_270	3
#define DRM_REFLECT_X	4
#define DRM_REFLECT_Y	5

88 89 90 91 92
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 */
D
Dave Airlie 已提交
93 94
};

95
#include <drm/drm_modes.h>
96

D
Dave Airlie 已提交
97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
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,
};

112 113 114
#define DRM_COLOR_FORMAT_RGB444		(1<<0)
#define DRM_COLOR_FORMAT_YCRCB444	(1<<1)
#define DRM_COLOR_FORMAT_YCRCB422	(1<<2)
D
Dave Airlie 已提交
115 116 117 118 119
/*
 * Describes a given display (e.g. CRT or flat panel) and its limitations.
 */
struct drm_display_info {
	char name[DRM_DISPLAY_INFO_LEN];
120

D
Dave Airlie 已提交
121 122 123 124 125 126 127 128
	/* 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 已提交
129
	unsigned int bpc;
D
Dave Airlie 已提交
130 131

	enum subpixel_order subpixel_order;
132
	u32 color_formats;
D
Dave Airlie 已提交
133

134 135 136
	/* Mask of supported hdmi deep color modes */
	u8 edid_hdmi_dc_modes;

137
	u8 cea_rev;
D
Dave Airlie 已提交
138 139 140
};

struct drm_framebuffer_funcs {
R
Rob Clark 已提交
141
	/* note: use drm_framebuffer_remove() */
D
Dave Airlie 已提交
142 143 144 145
	void (*destroy)(struct drm_framebuffer *framebuffer);
	int (*create_handle)(struct drm_framebuffer *fb,
			     struct drm_file *file_priv,
			     unsigned int *handle);
146 147
	/*
	 * Optional callback for the dirty fb ioctl.
148 149 150 151 152 153 154 155 156 157
	 *
	 * 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.
	 */
158 159
	int (*dirty)(struct drm_framebuffer *framebuffer,
		     struct drm_file *file_priv, unsigned flags,
160 161
		     unsigned color, struct drm_clip_rect *clips,
		     unsigned num_clips);
D
Dave Airlie 已提交
162 163 164 165
};

struct drm_framebuffer {
	struct drm_device *dev;
R
Rob Clark 已提交
166 167 168 169 170 171 172 173 174 175
	/*
	 * 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;
176 177 178 179
	/*
	 * Place on the dev->mode_config.fb_list, access protected by
	 * dev->mode_config.fb_lock.
	 */
D
Dave Airlie 已提交
180 181 182
	struct list_head head;
	struct drm_mode_object base;
	const struct drm_framebuffer_funcs *funcs;
183 184
	unsigned int pitches[4];
	unsigned int offsets[4];
D
Dave Airlie 已提交
185 186 187 188 189 190
	unsigned int width;
	unsigned int height;
	/* depth can be 15 or 16 */
	unsigned int depth;
	int bits_per_pixel;
	int flags;
191
	uint32_t pixel_format; /* fourcc format */
D
Dave Airlie 已提交
192
	struct list_head filp_head;
193 194
	/* if you are using the helper */
	void *helper_private;
D
Dave Airlie 已提交
195 196 197 198 199
};

struct drm_property_blob {
	struct drm_mode_object base;
	struct list_head head;
200
	size_t length;
201
	unsigned char data[];
D
Dave Airlie 已提交
202 203 204 205 206 207 208 209 210 211 212 213 214 215 216
};

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;
R
Rob Clark 已提交
217
	struct drm_device *dev;
D
Dave Airlie 已提交
218

219
	struct list_head enum_list;
D
Dave Airlie 已提交
220 221 222 223 224
};

struct drm_crtc;
struct drm_connector;
struct drm_encoder;
225
struct drm_pending_vblank_event;
J
Jesse Barnes 已提交
226
struct drm_plane;
S
Sean Paul 已提交
227
struct drm_bridge;
228 229 230
struct drm_atomic_state;

/**
D
Daniel Vetter 已提交
231
 * struct drm_crtc_state - mutable CRTC state
232
 * @enable: whether the CRTC should be enabled, gates all other state
233 234 235
 * @mode_changed: for use by helpers and drivers when computing state updates
 * @last_vblank_count: for helpers and drivers to capture the vblank of the
 * 	update to ensure framebuffer cleanup isn't done too early
D
Daniel Vetter 已提交
236
 * @planes_changed: for use by helpers and drivers when computing state updates
237
 * @adjusted_mode: for use by helpers and drivers to compute adjusted mode timings
238 239 240 241 242 243
 * @mode: current mode timings
 * @event: optional pointer to a DRM event to signal upon completion of the
 * 	state update
 * @state: backpointer to global drm_atomic_state
 */
struct drm_crtc_state {
D
Daniel Vetter 已提交
244
	bool enable;
245

D
Daniel Vetter 已提交
246 247
	/* computed state bits used by helpers and drivers */
	bool planes_changed : 1;
248 249 250 251
	bool mode_changed : 1;

	/* last_vblank_count: for vblank waits before cleanup */
	u32 last_vblank_count;
D
Daniel Vetter 已提交
252

253 254 255
	/* adjusted_mode: for use by helpers and drivers */
	struct drm_display_mode adjusted_mode;

256 257 258 259 260 261
	struct drm_display_mode mode;

	struct drm_pending_vblank_event *event;

	struct drm_atomic_state *state;
};
D
Dave Airlie 已提交
262 263

/**
264
 * struct drm_crtc_funcs - control CRTCs for a given device
D
Dave Airlie 已提交
265
 * @save: save CRTC state
266
 * @restore: restore CRTC state
C
Christopher Harvey 已提交
267
 * @reset: reset CRTC after state has been invalidated (e.g. resume)
268
 * @cursor_set: setup the cursor
D
Daniel Vetter 已提交
269
 * @cursor_set2: setup the cursor with hotspot, superseeds @cursor_set if set
270
 * @cursor_move: move the cursor
D
Dave Airlie 已提交
271
 * @gamma_set: specify color ramp for CRTC
P
Paulo Zanoni 已提交
272 273
 * @destroy: deinit and free object
 * @set_property: called when a property is changed
274 275
 * @set_config: apply a new CRTC configuration
 * @page_flip: initiate a page flip
276 277 278
 * @atomic_duplicate_state: duplicate the atomic state for this CRTC
 * @atomic_destroy_state: destroy an atomic state for this CRTC
 * @atomic_set_property: set a property on an atomic state for this CRTC
D
Dave Airlie 已提交
279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
 *
 * 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? */
294 295
	/* Reset CRTC state */
	void (*reset)(struct drm_crtc *crtc);
D
Dave Airlie 已提交
296 297 298 299

	/* cursor controls */
	int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv,
			  uint32_t handle, uint32_t width, uint32_t height);
300 301 302
	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 已提交
303 304 305 306
	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 已提交
307
			  uint32_t start, uint32_t size);
D
Dave Airlie 已提交
308 309 310 311
	/* Object destroy routine */
	void (*destroy)(struct drm_crtc *crtc);

	int (*set_config)(struct drm_mode_set *set);
312 313 314

	/*
	 * Flip to the given framebuffer.  This implements the page
L
Lucas De Marchi 已提交
315
	 * flip ioctl described in drm_mode.h, specifically, the
316 317 318 319 320 321 322 323
	 * 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,
324 325
			 struct drm_pending_vblank_event *event,
			 uint32_t flags);
P
Paulo Zanoni 已提交
326 327 328

	int (*set_property)(struct drm_crtc *crtc,
			    struct drm_property *property, uint64_t val);
329 330 331 332

	/* atomic update handling */
	struct drm_crtc_state *(*atomic_duplicate_state)(struct drm_crtc *crtc);
	void (*atomic_destroy_state)(struct drm_crtc *crtc,
D
Daniel Vetter 已提交
333
				     struct drm_crtc_state *state);
334 335 336 337
	int (*atomic_set_property)(struct drm_crtc *crtc,
				   struct drm_crtc_state *state,
				   struct drm_property *property,
				   uint64_t val);
D
Dave Airlie 已提交
338 339 340
};

/**
341
 * struct drm_crtc - central CRTC control structure
342
 * @dev: parent DRM device
D
Daniel Vetter 已提交
343
 * @port: OF node used by drm_of_find_possible_crtcs()
344
 * @head: list management
345
 * @mutex: per-CRTC locking
346
 * @base: base KMS object for ID tracking etc.
347 348
 * @primary: primary plane for this CRTC
 * @cursor: cursor plane for this CRTC
D
Daniel Vetter 已提交
349 350
 * @cursor_x: current x position of the cursor, used for universal cursor planes
 * @cursor_y: current y position of the cursor, used for universal cursor planes
D
Dave Airlie 已提交
351
 * @enabled: is this CRTC enabled?
352 353
 * @mode: current mode timings
 * @hwmode: mode timings as programmed to hw regs
R
Rob Clark 已提交
354 355 356
 * @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 已提交
357 358 359
 * @x: x position on screen
 * @y: y position on screen
 * @funcs: CRTC control functions
360 361 362
 * @gamma_size: size of gamma ramp
 * @gamma_store: gamma ramp values
 * @framedur_ns: precise frame timing
D
Daniel Vetter 已提交
363
 * @linedur_ns: precise line timing
364 365
 * @pixeldur_ns: precise pixel timing
 * @helper_private: mid-layer private data
P
Paulo Zanoni 已提交
366
 * @properties: property tracking for this CRTC
367
 * @state: current atomic state for this CRTC
D
Daniel Vetter 已提交
368 369
 * @acquire_ctx: per-CRTC implicit acquire context used by atomic drivers for
 * 	legacy ioctls
D
Dave Airlie 已提交
370 371 372 373 374 375
 *
 * 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;
376
	struct device_node *port;
D
Dave Airlie 已提交
377 378
	struct list_head head;

379
	/*
D
Daniel Vetter 已提交
380 381 382 383 384 385
	 * 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, ...)
	 */
386
	struct drm_modeset_lock mutex;
D
Daniel Vetter 已提交
387

D
Dave Airlie 已提交
388 389
	struct drm_mode_object base;

390 391 392 393
	/* primary and cursor planes for CRTC */
	struct drm_plane *primary;
	struct drm_plane *cursor;

394 395 396 397
	/* position of cursor plane on crtc */
	int cursor_x;
	int cursor_y;

D
Dave Airlie 已提交
398 399
	bool enabled;

400
	/* Requested mode from modesetting. */
D
Dave Airlie 已提交
401 402
	struct drm_display_mode mode;

403 404 405 406 407
	/* Programmed mode in hw, after adjustments for encoders,
	 * crtc, panel scaling etc. Needed for timestamping etc.
	 */
	struct drm_display_mode hwmode;

R
Rob Clark 已提交
408 409
	bool invert_dimensions;

D
Dave Airlie 已提交
410 411 412 413 414 415 416
	int x, y;
	const struct drm_crtc_funcs *funcs;

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

417
	/* Constants needed for precise vblank and swap timestamping. */
418
	int framedur_ns, linedur_ns, pixeldur_ns;
419

D
Dave Airlie 已提交
420 421
	/* if you are using the helper */
	void *helper_private;
P
Paulo Zanoni 已提交
422 423

	struct drm_object_properties properties;
424

425 426
	struct drm_crtc_state *state;

427 428 429 430 431
	/*
	 * For legacy crtc ioctls so that atomic drivers can get at the locking
	 * acquire context.
	 */
	struct drm_modeset_acquire_ctx *acquire_ctx;
D
Dave Airlie 已提交
432 433
};

434 435
/**
 * struct drm_connector_state - mutable connector state
D
Daniel Vetter 已提交
436
 * @crtc: CRTC to connect connector to, NULL if disabled
437
 * @best_encoder: can be used by helpers and drivers to select the encoder
438 439 440 441 442
 * @state: backpointer to global drm_atomic_state
 */
struct drm_connector_state {
	struct drm_crtc *crtc;

443 444
	struct drm_encoder *best_encoder;

445 446
	struct drm_atomic_state *state;
};
D
Dave Airlie 已提交
447 448

/**
449
 * struct drm_connector_funcs - control connectors on a given device
D
Dave Airlie 已提交
450 451 452
 * @dpms: set power state (see drm_crtc_funcs above)
 * @save: save connector state
 * @restore: restore connector state
453
 * @reset: reset connector after state has been invalidated (e.g. resume)
D
Dave Airlie 已提交
454
 * @detect: is this connector active?
455
 * @fill_modes: fill mode list for this connector
456
 * @set_property: property for this connector may need an update
D
Dave Airlie 已提交
457
 * @destroy: make object go away
458
 * @force: notify the driver that the connector is forced on
459 460 461 462
 * @atomic_duplicate_state: duplicate the atomic state for this connector
 * @atomic_destroy_state: destroy an atomic state for this connector
 * @atomic_set_property: set a property on an atomic state for this connector
 *
D
Dave Airlie 已提交
463 464 465 466 467 468 469 470
 * 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);
471
	void (*reset)(struct drm_connector *connector);
472 473 474 475 476 477 478

	/* 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.
	 */
479
	enum drm_connector_status (*detect)(struct drm_connector *connector,
480
					    bool force);
J
Jesse Barnes 已提交
481
	int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height);
D
Dave Airlie 已提交
482 483 484
	int (*set_property)(struct drm_connector *connector, struct drm_property *property,
			     uint64_t val);
	void (*destroy)(struct drm_connector *connector);
485
	void (*force)(struct drm_connector *connector);
486 487 488 489

	/* atomic update handling */
	struct drm_connector_state *(*atomic_duplicate_state)(struct drm_connector *connector);
	void (*atomic_destroy_state)(struct drm_connector *connector,
D
Daniel Vetter 已提交
490
				     struct drm_connector_state *state);
491 492 493 494
	int (*atomic_set_property)(struct drm_connector *connector,
				   struct drm_connector_state *state,
				   struct drm_property *property,
				   uint64_t val);
D
Dave Airlie 已提交
495 496
};

497
/**
498
 * struct drm_encoder_funcs - encoder controls
499 500 501 502 503
 * @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 已提交
504
struct drm_encoder_funcs {
505
	void (*reset)(struct drm_encoder *encoder);
D
Dave Airlie 已提交
506 507 508
	void (*destroy)(struct drm_encoder *encoder);
};

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

/**
512
 * struct drm_encoder - central DRM encoder structure
J
Jesse Barnes 已提交
513 514 515
 * @dev: parent DRM device
 * @head: list management
 * @base: base KMS object
516
 * @name: encoder name
J
Jesse Barnes 已提交
517 518 519 520
 * @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
 */
struct drm_encoder {
	struct drm_device *dev;
	struct list_head head;

	struct drm_mode_object base;
533
	char *name;
D
Dave Airlie 已提交
534 535 536 537 538
	int encoder_type;
	uint32_t possible_crtcs;
	uint32_t possible_clones;

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

544 545 546 547 548 549 550 551 552
/* 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)

553 554
#define MAX_ELD_BYTES	128

D
Dave Airlie 已提交
555
/**
556
 * struct drm_connector - central DRM connector control structure
557 558 559 560 561
 * @dev: parent DRM device
 * @kdev: kernel device for sysfs attributes
 * @attr: sysfs attributes
 * @head: list management
 * @base: base KMS object
562
 * @name: connector name
563 564
 * @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 已提交
565 566
 * @interlace_allowed: can this connector handle interlaced modes?
 * @doublescan_allowed: can this connector handle doublescan?
D
Daniel Vetter 已提交
567
 * @stereo_allowed: can this connector handle stereo modes?
568 569 570 571
 * @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 已提交
572
 * @funcs: connector control functions
573
 * @edid_blob_ptr: DRM property containing EDID if present
574
 * @properties: property tracking for this connector
D
Daniel Vetter 已提交
575
 * @path_blob_ptr: DRM blob property data for the DP MST path property
576 577 578
 * @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling
 * @dpms: current dpms state
 * @helper_private: mid-layer private data
D
Daniel Vetter 已提交
579
 * @cmdline_mode: mode line parsed from the kernel cmdline for this connector
580
 * @force: a %DRM_FORCE_<foo> state for forced mode sets
D
Daniel Vetter 已提交
581
 * @override_edid: has the EDID been overwritten through debugfs for testing?
582 583 584 585 586 587 588 589 590
 * @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
Daniel Vetter 已提交
591 592
 * @bad_edid_counter: track sinks that give us an EDID with invalid checksum
 * @debugfs_entry: debugfs directory for this connector
593
 * @state: current atomic state for this connector
D
Dave Airlie 已提交
594 595 596 597 598 599 600 601
 *
 * 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;
602
	struct device *kdev;
D
Dave Airlie 已提交
603 604 605 606 607
	struct device_attribute *attr;
	struct list_head head;

	struct drm_mode_object base;

608
	char *name;
D
Dave Airlie 已提交
609 610 611 612
	int connector_type;
	int connector_type_id;
	bool interlace_allowed;
	bool doublescan_allowed;
613
	bool stereo_allowed;
D
Dave Airlie 已提交
614 615 616 617 618 619 620 621 622 623 624
	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;
625
	struct drm_object_properties properties;
D
Dave Airlie 已提交
626

D
Dave Airlie 已提交
627 628
	struct drm_property_blob *path_blob_ptr;

629 630
	uint8_t polled; /* DRM_CONNECTOR_POLL_* */

631 632 633
	/* requested DPMS state */
	int dpms;

D
Dave Airlie 已提交
634 635
	void *helper_private;

636
	/* forced on connector */
637
	struct drm_cmdline_mode cmdline_mode;
638
	enum drm_connector_force force;
639
	bool override_edid;
D
Dave Airlie 已提交
640 641
	uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER];
	struct drm_encoder *encoder; /* currently active encoder */
642

643 644 645 646 647 648 649
	/* 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];
650
	int null_edid_counter; /* needed to workaround some HW bugs where we get all 0s */
651
	unsigned bad_edid_counter;
652 653

	struct dentry *debugfs_entry;
654 655 656 657 658 659 660

	struct drm_connector_state *state;
};

/**
 * struct drm_plane_state - mutable plane state
 * @crtc: currently bound CRTC, NULL if disabled
D
Daniel Vetter 已提交
661
 * @fb: currently bound framebuffer
662
 * @fence: optional fence to wait for before scanning out @fb
663 664 665 666 667 668 669 670 671 672 673 674 675 676 677
 * @crtc_x: left position of visible portion of plane on crtc
 * @crtc_y: upper position of visible portion of plane on crtc
 * @crtc_w: width of visible portion of plane on crtc
 * @crtc_h: height of visible portion of plane on crtc
 * @src_x: left position of visible portion of plane within
 *	plane (in 16.16)
 * @src_y: upper position of visible portion of plane within
 *	plane (in 16.16)
 * @src_w: width of visible portion of plane (in 16.16)
 * @src_h: height of visible portion of plane (in 16.16)
 * @state: backpointer to global drm_atomic_state
 */
struct drm_plane_state {
	struct drm_crtc *crtc;
	struct drm_framebuffer *fb;
678
	struct fence *fence;
679 680 681 682 683 684 685 686 687 688

	/* Signed dest location allows it to be partially off screen */
	int32_t crtc_x, crtc_y;
	uint32_t crtc_w, crtc_h;

	/* Source values are 16.16 fixed point */
	uint32_t src_x, src_y;
	uint32_t src_h, src_w;

	struct drm_atomic_state *state;
D
Dave Airlie 已提交
689 690
};

691

J
Jesse Barnes 已提交
692
/**
693
 * struct drm_plane_funcs - driver plane control functions
J
Jesse Barnes 已提交
694 695 696
 * @update_plane: update the plane configuration
 * @disable_plane: shut down the plane
 * @destroy: clean up plane resources
D
Daniel Vetter 已提交
697
 * @reset: reset plane after state has been invalidated (e.g. resume)
R
Rob Clark 已提交
698
 * @set_property: called when a property is changed
699 700 701
 * @atomic_duplicate_state: duplicate the atomic state for this plane
 * @atomic_destroy_state: destroy an atomic state for this plane
 * @atomic_set_property: set a property on an atomic state for this plane
J
Jesse Barnes 已提交
702 703 704 705 706 707 708 709 710 711
 */
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);
D
Daniel Vetter 已提交
712
	void (*reset)(struct drm_plane *plane);
R
Rob Clark 已提交
713 714 715

	int (*set_property)(struct drm_plane *plane,
			    struct drm_property *property, uint64_t val);
716 717 718 719

	/* atomic update handling */
	struct drm_plane_state *(*atomic_duplicate_state)(struct drm_plane *plane);
	void (*atomic_destroy_state)(struct drm_plane *plane,
D
Daniel Vetter 已提交
720
				     struct drm_plane_state *state);
721 722 723 724
	int (*atomic_set_property)(struct drm_plane *plane,
				   struct drm_plane_state *state,
				   struct drm_property *property,
				   uint64_t val);
J
Jesse Barnes 已提交
725 726
};

727 728 729 730 731 732
enum drm_plane_type {
	DRM_PLANE_TYPE_OVERLAY,
	DRM_PLANE_TYPE_PRIMARY,
	DRM_PLANE_TYPE_CURSOR,
};

J
Jesse Barnes 已提交
733
/**
734
 * struct drm_plane - central DRM plane control structure
J
Jesse Barnes 已提交
735 736 737 738 739 740 741 742
 * @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
D
Daniel Vetter 已提交
743 744
 * @old_fb: Temporary tracking of the old fb while a modeset is ongoing. Used by
 * 	drm_mode_set_config_internal() to implement correct refcounting.
J
Jesse Barnes 已提交
745
 * @funcs: helper functions
R
Rob Clark 已提交
746
 * @properties: property tracking for this plane
747
 * @type: type of plane (overlay, primary, cursor)
748
 * @state: current atomic state for this plane
J
Jesse Barnes 已提交
749 750 751 752 753
 */
struct drm_plane {
	struct drm_device *dev;
	struct list_head head;

D
Daniel Vetter 已提交
754 755
	struct drm_modeset_lock mutex;

J
Jesse Barnes 已提交
756 757 758 759 760 761 762 763 764
	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;

765 766
	struct drm_framebuffer *old_fb;

J
Jesse Barnes 已提交
767
	const struct drm_plane_funcs *funcs;
R
Rob Clark 已提交
768 769

	struct drm_object_properties properties;
770 771

	enum drm_plane_type type;
772

D
Daniel Vetter 已提交
773 774
	void *helper_private;

775
	struct drm_plane_state *state;
J
Jesse Barnes 已提交
776 777
};

S
Sean Paul 已提交
778
/**
779
 * struct drm_bridge_funcs - drm_bridge control functions
S
Sean Paul 已提交
780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802
 * @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);
};

/**
803
 * struct drm_bridge - central DRM bridge control structure
S
Sean Paul 已提交
804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819
 * @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
Daniel Vetter 已提交
820 821 822 823 824 825 826 827
/**
 * struct struct drm_atomic_state - the global state object for atomic updates
 * @dev: parent DRM device
 * @flags: state flags like async update
 * @planes: pointer to array of plane pointers
 * @plane_states: pointer to array of plane states pointers
 * @crtcs: pointer to array of CRTC pointers
 * @crtc_states: pointer to array of CRTC states pointers
828
 * @num_connector: size of the @connectors and @connector_states arrays
D
Daniel Vetter 已提交
829 830 831 832 833 834 835 836 837 838 839
 * @connectors: pointer to array of connector pointers
 * @connector_states: pointer to array of connector states pointers
 * @acquire_ctx: acquire context for this atomic modeset state update
 */
struct drm_atomic_state {
	struct drm_device *dev;
	uint32_t flags;
	struct drm_plane **planes;
	struct drm_plane_state **plane_states;
	struct drm_crtc **crtcs;
	struct drm_crtc_state **crtc_states;
840
	int num_connector;
D
Daniel Vetter 已提交
841 842 843 844 845 846 847
	struct drm_connector **connectors;
	struct drm_connector_state **connector_states;

	struct drm_modeset_acquire_ctx *acquire_ctx;
};


D
Dave Airlie 已提交
848
/**
849
 * struct drm_mode_set - new values for a CRTC config change
850 851 852 853 854 855 856
 * @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 已提交
857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875
 *
 * 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;
};

/**
876 877 878
 * 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
D
Daniel Vetter 已提交
879 880 881
 * @atomic_check: check whether a give atomic state update is possible
 * @atomic_commit: commit an atomic state update previously verified with
 * 	atomic_check()
882 883 884
 *
 * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that
 * involve drivers.
D
Dave Airlie 已提交
885 886
 */
struct drm_mode_config_funcs {
887 888 889
	struct drm_framebuffer *(*fb_create)(struct drm_device *dev,
					     struct drm_file *file_priv,
					     struct drm_mode_fb_cmd2 *mode_cmd);
890
	void (*output_poll_changed)(struct drm_device *dev);
D
Daniel Vetter 已提交
891 892 893 894 895 896

	int (*atomic_check)(struct drm_device *dev,
			    struct drm_atomic_state *a);
	int (*atomic_commit)(struct drm_device *dev,
			     struct drm_atomic_state *a,
			     bool async);
D
Dave Airlie 已提交
897 898
};

899
/**
D
Daniel Vetter 已提交
900
 * struct drm_mode_group - group of mode setting resources for potential sub-grouping
901 902 903
 * @num_crtcs: CRTC count
 * @num_encoders: encoder count
 * @num_connectors: connector count
D
Daniel Vetter 已提交
904
 * @num_bridges: bridge count
905 906 907 908 909 910 911 912
 * @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 已提交
913 914 915 916
struct drm_mode_group {
	uint32_t num_crtcs;
	uint32_t num_encoders;
	uint32_t num_connectors;
S
Sean Paul 已提交
917
	uint32_t num_bridges;
D
Dave Airlie 已提交
918 919 920 921 922 923

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

/**
D
Daniel Vetter 已提交
924
 * struct drm_mode_config - Mode configuration control structure
925
 * @mutex: mutex protecting KMS related lists and structures
D
Daniel Vetter 已提交
926 927 928
 * @connection_mutex: ww mutex protecting connector state and routing
 * @acquire_ctx: global implicit acquire context used by atomic drivers for
 * 	legacy ioctls
929 930
 * @idr_mutex: mutex for KMS ID allocation and management
 * @crtc_idr: main KMS ID tracking object
D
Daniel Vetter 已提交
931
 * @fb_lock: mutex to protect fb state and lists
932 933 934 935
 * @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 已提交
936 937
 * @num_bridge: number of bridges on this device
 * @bridge_list: list of bridge objects
938 939
 * @num_encoder: number of encoders on this device
 * @encoder_list: list of encoder objects
D
Daniel Vetter 已提交
940 941 942
 * @num_overlay_plane: number of overlay planes on this device
 * @num_total_plane: number of universal (i.e. with primary/curso) planes on this device
 * @plane_list: list of plane objects
943 944
 * @num_crtc: number of CRTCs on this device
 * @crtc_list: list of CRTC objects
D
Daniel Vetter 已提交
945
 * @property_list: list of property objects
946 947 948 949 950 951
 * @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
D
Daniel Vetter 已提交
952 953
 * @poll_enabled: track polling support for this device
 * @poll_running: track polling status for this device
954
 * @output_poll_work: delayed work for polling in process context
D
Daniel Vetter 已提交
955
 * @property_blob_list: list of all the blob property objects
956
 * @*_property: core property tracking
D
Daniel Vetter 已提交
957 958 959 960 961
 * @preferred_depth: preferred RBG pixel depth, used by fb helpers
 * @prefer_shadow: hint to userspace to prefer shadow-fb rendering
 * @async_page_flip: does this device support async flips on the primary plane?
 * @cursor_width: hint to userspace for max cursor width
 * @cursor_height: hint to userspace for max cursor height
D
Dave Airlie 已提交
962
 *
963 964 965
 * 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 已提交
966 967
 */
struct drm_mode_config {
J
Jesse Barnes 已提交
968
	struct mutex mutex; /* protects configuration (mode lists etc.) */
969 970
	struct drm_modeset_lock connection_mutex; /* protects connector->encoder and encoder->crtc links */
	struct drm_modeset_acquire_ctx *acquire_ctx; /* for legacy _lock_all() / _unlock_all() */
J
Jesse Barnes 已提交
971
	struct mutex idr_mutex; /* for IDR management */
D
Dave Airlie 已提交
972 973
	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 */
974

D
Daniel Vetter 已提交
975
	struct mutex fb_lock; /* proctects global and per-file fb lists */
D
Dave Airlie 已提交
976 977
	int num_fb;
	struct list_head fb_list;
978

D
Dave Airlie 已提交
979 980
	int num_connector;
	struct list_head connector_list;
S
Sean Paul 已提交
981 982
	int num_bridge;
	struct list_head bridge_list;
D
Dave Airlie 已提交
983 984
	int num_encoder;
	struct list_head encoder_list;
985 986 987 988 989 990 991 992 993

	/*
	 * Track # of overlay planes separately from # of total planes.  By
	 * default we only advertise overlay planes to userspace; if userspace
	 * sets the "universal plane" capability bit, we'll go ahead and
	 * expose all planes.
	 */
	int num_overlay_plane;
	int num_total_plane;
J
Jesse Barnes 已提交
994
	struct list_head plane_list;
D
Dave Airlie 已提交
995 996 997 998 999 1000 1001 1002

	int num_crtc;
	struct list_head crtc_list;

	struct list_head property_list;

	int min_width, min_height;
	int max_width, max_height;
1003
	const struct drm_mode_config_funcs *funcs;
1004
	resource_size_t fb_base;
D
Dave Airlie 已提交
1005

1006 1007
	/* output poll support */
	bool poll_enabled;
1008
	bool poll_running;
1009
	struct delayed_work output_poll_work;
1010

D
Dave Airlie 已提交
1011 1012 1013 1014
	/* pointers to standard properties */
	struct list_head property_blob_list;
	struct drm_property *edid_property;
	struct drm_property *dpms_property;
D
Dave Airlie 已提交
1015
	struct drm_property *path_property;
R
Rob Clark 已提交
1016
	struct drm_property *plane_type_property;
1017
	struct drm_property *rotation_property;
D
Dave Airlie 已提交
1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030

	/* 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;
1031 1032 1033
	struct drm_property *tv_brightness_property;
	struct drm_property *tv_contrast_property;
	struct drm_property *tv_flicker_reduction_property;
1034 1035 1036
	struct drm_property *tv_overscan_property;
	struct drm_property *tv_saturation_property;
	struct drm_property *tv_hue_property;
D
Dave Airlie 已提交
1037 1038 1039

	/* Optional properties */
	struct drm_property *scaling_mode_property;
1040
	struct drm_property *aspect_ratio_property;
1041
	struct drm_property *dirty_info_property;
1042

1043 1044 1045 1046
	/* properties for virtual machine layout */
	struct drm_property *suggested_x_property;
	struct drm_property *suggested_y_property;

1047 1048
	/* dumb ioctl parameters */
	uint32_t preferred_depth, prefer_shadow;
1049 1050 1051

	/* whether async page flip is supported or not */
	bool async_page_flip;
A
Alex Deucher 已提交
1052 1053 1054

	/* cursor size */
	uint32_t cursor_width, cursor_height;
D
Dave Airlie 已提交
1055 1056 1057 1058 1059 1060 1061 1062 1063
};

#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 已提交
1064
#define obj_to_plane(x) container_of(x, struct drm_plane, base)
D
Dave Airlie 已提交
1065

1066 1067 1068 1069
struct drm_prop_enum_list {
	int type;
	char *name;
};
D
Dave Airlie 已提交
1070

1071 1072 1073
extern int drm_crtc_init_with_planes(struct drm_device *dev,
				     struct drm_crtc *crtc,
				     struct drm_plane *primary,
1074
				     struct drm_plane *cursor,
1075
				     const struct drm_crtc_funcs *funcs);
D
Dave Airlie 已提交
1076
extern void drm_crtc_cleanup(struct drm_crtc *crtc);
1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089
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 已提交
1090

1091 1092
extern void drm_connector_ida_init(void);
extern void drm_connector_ida_destroy(void);
1093 1094 1095 1096
extern int drm_connector_init(struct drm_device *dev,
			      struct drm_connector *connector,
			      const struct drm_connector_funcs *funcs,
			      int connector_type);
1097 1098
int drm_connector_register(struct drm_connector *connector);
void drm_connector_unregister(struct drm_connector *connector);
D
Dave Airlie 已提交
1099 1100

extern void drm_connector_cleanup(struct drm_connector *connector);
1101
extern unsigned int drm_connector_index(struct drm_connector *connector);
1102 1103
/* helper to unplug all connectors from sysfs for device */
extern void drm_connector_unplug_all(struct drm_device *dev);
D
Dave Airlie 已提交
1104

S
Sean Paul 已提交
1105 1106 1107 1108
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);

1109 1110 1111 1112
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 已提交
1113

1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126
/**
 * 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));
}

M
Matt Roper 已提交
1127 1128 1129 1130 1131 1132 1133
extern int drm_universal_plane_init(struct drm_device *dev,
				    struct drm_plane *plane,
				    unsigned long possible_crtcs,
				    const struct drm_plane_funcs *funcs,
				    const uint32_t *formats,
				    uint32_t format_count,
				    enum drm_plane_type type);
J
Jesse Barnes 已提交
1134 1135 1136 1137
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 已提交
1138
			  const uint32_t *formats, uint32_t format_count,
M
Matt Roper 已提交
1139
			  bool is_primary);
J
Jesse Barnes 已提交
1140
extern void drm_plane_cleanup(struct drm_plane *plane);
1141
extern unsigned int drm_plane_index(struct drm_plane *plane);
1142
extern void drm_plane_force_disable(struct drm_plane *plane);
1143 1144 1145 1146
extern int drm_crtc_check_viewport(const struct drm_crtc *crtc,
				   int x, int y,
				   const struct drm_display_mode *mode,
				   const struct drm_framebuffer *fb);
J
Jesse Barnes 已提交
1147

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

1150
extern const char *drm_get_connector_status_name(enum drm_connector_status status);
1151
extern const char *drm_get_subpixel_order_name(enum subpixel_order order);
1152 1153 1154 1155 1156
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);
1157
extern void drm_fb_release(struct drm_file *file_priv);
D
Dave Airlie 已提交
1158
extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group);
1159
extern void drm_mode_group_destroy(struct drm_mode_group *group);
1160
extern void drm_reinit_primary_mode_group(struct drm_device *dev);
A
Adam Jackson 已提交
1161
extern bool drm_probe_ddc(struct i2c_adapter *adapter);
D
Dave Airlie 已提交
1162 1163
extern struct edid *drm_get_edid(struct drm_connector *connector,
				 struct i2c_adapter *adapter);
J
Jani Nikula 已提交
1164
extern struct edid *drm_edid_duplicate(const struct edid *edid);
D
Dave Airlie 已提交
1165 1166
extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid);
extern void drm_mode_config_init(struct drm_device *dev);
1167
extern void drm_mode_config_reset(struct drm_device *dev);
D
Dave Airlie 已提交
1168
extern void drm_mode_config_cleanup(struct drm_device *dev);
1169

D
Dave Airlie 已提交
1170
extern int drm_mode_connector_set_path_property(struct drm_connector *connector,
1171
						const char *path);
D
Dave Airlie 已提交
1172
extern int drm_mode_connector_update_edid_property(struct drm_connector *connector,
1173
						   const struct edid *edid);
R
Rob Clark 已提交
1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190

static inline bool drm_property_type_is(struct drm_property *property,
		uint32_t type)
{
	/* instanceof for props.. handles extended type vs original types: */
	if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
		return (property->flags & DRM_MODE_PROP_EXTENDED_TYPE) == type;
	return property->flags & type;
}

static inline bool drm_property_type_valid(struct drm_property *property)
{
	if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
		return !(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
	return !!(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
}

1191 1192 1193 1194 1195 1196
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 已提交
1197 1198 1199
extern int drm_framebuffer_init(struct drm_device *dev,
				struct drm_framebuffer *fb,
				const struct drm_framebuffer_funcs *funcs);
1200 1201
extern struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev,
						      uint32_t id);
R
Rob Clark 已提交
1202 1203 1204
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 已提交
1205
extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb);
1206
extern void drm_framebuffer_unregister_private(struct drm_framebuffer *fb);
D
Dave Airlie 已提交
1207

1208 1209 1210
extern void drm_object_attach_property(struct drm_mode_object *obj,
				       struct drm_property *property,
				       uint64_t init_val);
D
Dave Airlie 已提交
1211 1212
extern struct drm_property *drm_property_create(struct drm_device *dev, int flags,
						const char *name, int num_values);
1213 1214
extern struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
					 const char *name,
R
Rob Clark 已提交
1215 1216 1217 1218
					 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,
1219
					 const struct drm_prop_enum_list *props,
1220 1221
					 int num_props,
					 uint64_t supported_bits);
1222 1223 1224
struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
					 const char *name,
					 uint64_t min, uint64_t max);
R
Rob Clark 已提交
1225 1226 1227
struct drm_property *drm_property_create_signed_range(struct drm_device *dev,
					 int flags, const char *name,
					 int64_t min, int64_t max);
R
Rob Clark 已提交
1228 1229
struct drm_property *drm_property_create_object(struct drm_device *dev,
					 int flags, const char *name, uint32_t type);
D
Dave Airlie 已提交
1230 1231 1232 1233
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);
1234 1235 1236
extern int drm_mode_create_tv_properties(struct drm_device *dev,
					 unsigned int num_modes,
					 char *modes[]);
D
Dave Airlie 已提交
1237
extern int drm_mode_create_scaling_mode_property(struct drm_device *dev);
1238
extern int drm_mode_create_aspect_ratio_property(struct drm_device *dev);
1239
extern int drm_mode_create_dirty_info_property(struct drm_device *dev);
1240
extern int drm_mode_create_suggested_offset_properties(struct drm_device *dev);
D
Dave Airlie 已提交
1241 1242 1243

extern int drm_mode_connector_attach_encoder(struct drm_connector *connector,
					     struct drm_encoder *encoder);
1244
extern int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
D
Dave Airlie 已提交
1245
					 int gamma_size);
1246 1247
extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
		uint32_t id, uint32_t type);
R
Rob Clark 已提交
1248

D
Dave Airlie 已提交
1249 1250 1251
/* IOCTLs */
extern int drm_mode_getresources(struct drm_device *dev,
				 void *data, struct drm_file *file_priv);
J
Jesse Barnes 已提交
1252 1253
extern int drm_mode_getplane_res(struct drm_device *dev, void *data,
				   struct drm_file *file_priv);
D
Dave Airlie 已提交
1254 1255 1256 1257
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);
1258
extern int drm_mode_set_config_internal(struct drm_mode_set *set);
D
Dave Airlie 已提交
1259 1260
extern int drm_mode_setcrtc(struct drm_device *dev,
			    void *data, struct drm_file *file_priv);
J
Jesse Barnes 已提交
1261 1262 1263 1264
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 已提交
1265 1266
extern int drm_mode_cursor_ioctl(struct drm_device *dev,
				void *data, struct drm_file *file_priv);
1267 1268
extern int drm_mode_cursor2_ioctl(struct drm_device *dev,
				void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
1269 1270
extern int drm_mode_addfb(struct drm_device *dev,
			  void *data, struct drm_file *file_priv);
1271 1272 1273
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 已提交
1274 1275 1276 1277
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);
1278 1279
extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
				  void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292

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);
1293
extern u8 drm_match_cea_mode(const struct drm_display_mode *to_match);
1294
extern enum hdmi_picture_aspect drm_get_cea_aspect_ratio(const u8 video_code);
1295
extern bool drm_detect_hdmi_monitor(struct edid *edid);
1296
extern bool drm_detect_monitor_audio(struct edid *edid);
1297
extern bool drm_rgb_quant_range_selectable(struct edid *edid);
1298 1299
extern int drm_mode_page_flip_ioctl(struct drm_device *dev,
				    void *data, struct drm_file *file_priv);
1300 1301
extern int drm_add_modes_noedid(struct drm_connector *connector,
				int hdisplay, int vdisplay);
G
Gerd Hoffmann 已提交
1302 1303
extern void drm_set_preferred_mode(struct drm_connector *connector,
				   int hpref, int vpref);
1304

1305
extern int drm_edid_header_is_valid(const u8 *raw_edid);
1306
extern bool drm_edid_block_valid(u8 *raw_edid, int block, bool print_bad_edid);
1307
extern bool drm_edid_is_valid(struct edid *edid);
D
Dave Airlie 已提交
1308
struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev,
1309 1310
					   int hsize, int vsize, int fresh,
					   bool rb);
1311 1312 1313 1314 1315 1316 1317

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);
1318 1319 1320 1321
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);
1322 1323 1324
extern int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
				       struct drm_property *property,
				       uint64_t value);
1325 1326 1327

extern void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
				 int *bpp);
1328
extern int drm_format_num_planes(uint32_t format);
1329
extern int drm_format_plane_cpp(uint32_t format, int plane);
1330 1331
extern int drm_format_horz_chroma_subsampling(uint32_t format);
extern int drm_format_vert_chroma_subsampling(uint32_t format);
1332
extern const char *drm_get_format_name(uint32_t format);
1333 1334
extern struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
							      unsigned int supported_rotations);
1335 1336
extern unsigned int drm_rotation_simplify(unsigned int rotation,
					  unsigned int supported_rotations);
1337

R
Russell King 已提交
1338
/* Helpers */
R
Rob Clark 已提交
1339 1340 1341 1342 1343 1344 1345 1346 1347

static inline struct drm_plane *drm_plane_find(struct drm_device *dev,
		uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PLANE);
	return mo ? obj_to_plane(mo) : NULL;
}

R
Russell King 已提交
1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363
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;
}

R
Rob Clark 已提交
1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387
static inline struct drm_connector *drm_connector_find(struct drm_device *dev,
		uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CONNECTOR);
	return mo ? obj_to_connector(mo) : NULL;
}

static inline struct drm_property *drm_property_find(struct drm_device *dev,
		uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PROPERTY);
	return mo ? obj_to_property(mo) : NULL;
}

static inline struct drm_property_blob *
drm_property_blob_find(struct drm_device *dev, uint32_t id)
{
	struct drm_mode_object *mo;
	mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_BLOB);
	return mo ? obj_to_blob(mo) : NULL;
}

1388 1389 1390 1391 1392
/* Plane list iterator for legacy (overlay only) planes. */
#define drm_for_each_legacy_plane(plane, planelist) \
	list_for_each_entry(plane, planelist, head) \
		if (plane->type == DRM_PLANE_TYPE_OVERLAY)

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