blob: faaeff7db6847323a19b8112c64a9ccb3fcb5dfc [file] [log] [blame]
Dave Airlief453ba02008-11-07 14:05:41 -08001/*
2 * Copyright © 2006 Keith Packard
3 * Copyright © 2007-2008 Dave Airlie
4 * Copyright © 2007-2008 Intel Corporation
5 * Jesse Barnes <jesse.barnes@intel.com>
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
21 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23 * OTHER DEALINGS IN THE SOFTWARE.
24 */
25#ifndef __DRM_CRTC_H__
26#define __DRM_CRTC_H__
27
28#include <linux/i2c.h>
29#include <linux/spinlock.h>
30#include <linux/types.h>
31#include <linux/idr.h>
Dave Airlief453ba02008-11-07 14:05:41 -080032#include <linux/fb.h>
Vandana Kannan985e5dc2013-12-19 15:34:07 +053033#include <linux/hdmi.h>
Boris Brezillonb5571e92014-07-22 12:09:10 +020034#include <linux/media-bus-format.h>
David Herrmannd7d2c482014-08-29 12:12:40 +020035#include <uapi/drm/drm_mode.h>
36#include <uapi/drm/drm_fourcc.h>
Rob Clark51fd3712013-11-19 12:10:12 -050037#include <drm/drm_modeset_lock.h>
Jesse Barnes308e5bc2011-11-14 14:51:28 -080038
Dave Airlief453ba02008-11-07 14:05:41 -080039struct drm_device;
40struct drm_mode_set;
41struct drm_framebuffer;
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -030042struct drm_object_properties;
Thierry Reding595887e2012-11-21 15:00:47 +010043struct drm_file;
44struct drm_clip_rect;
Russell King7e435aa2014-06-15 11:07:12 +010045struct device_node;
Daniel Vettere2330f02014-10-29 11:34:56 +010046struct fence;
Dave Airlief453ba02008-11-07 14:05:41 -080047
48#define DRM_MODE_OBJECT_CRTC 0xcccccccc
49#define DRM_MODE_OBJECT_CONNECTOR 0xc0c0c0c0
50#define DRM_MODE_OBJECT_ENCODER 0xe0e0e0e0
51#define DRM_MODE_OBJECT_MODE 0xdededede
52#define DRM_MODE_OBJECT_PROPERTY 0xb0b0b0b0
53#define DRM_MODE_OBJECT_FB 0xfbfbfbfb
54#define DRM_MODE_OBJECT_BLOB 0xbbbbbbbb
Jesse Barnes8cf5c912011-11-14 14:51:27 -080055#define DRM_MODE_OBJECT_PLANE 0xeeeeeeee
Rob Clark98f75de2014-05-30 11:37:03 -040056#define DRM_MODE_OBJECT_ANY 0
Dave Airlief453ba02008-11-07 14:05:41 -080057
58struct drm_mode_object {
59 uint32_t id;
60 uint32_t type;
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -030061 struct drm_object_properties *properties;
62};
63
Paulo Zanonife456162012-06-12 11:27:01 -030064#define DRM_OBJECT_MAX_PROPERTY 24
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -030065struct drm_object_properties {
Rob Clark88a48e22014-12-18 16:01:50 -050066 int count, atomic_count;
Rob Clarkb17cd752014-12-16 18:05:30 -050067 /* NOTE: if we ever start dynamically destroying properties (ie.
68 * not at drm_mode_config_cleanup() time), then we'd have to do
69 * a better job of detaching property from mode objects to avoid
70 * dangling property pointers:
71 */
72 struct drm_property *properties[DRM_OBJECT_MAX_PROPERTY];
Rob Clark22b8b132014-12-16 18:05:31 -050073 /* do not read/write values directly, but use drm_object_property_get_value()
74 * and drm_object_property_set_value():
75 */
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -030076 uint64_t values[DRM_OBJECT_MAX_PROPERTY];
Dave Airlief453ba02008-11-07 14:05:41 -080077};
78
Rob Clarkebc44cf2012-09-12 22:22:31 -050079static inline int64_t U642I64(uint64_t val)
80{
81 return (int64_t)*((int64_t *)&val);
82}
83static inline uint64_t I642U64(int64_t val)
84{
85 return (uint64_t)*((uint64_t *)&val);
86}
87
Ville Syrjälä06596962014-07-08 10:31:51 +053088/* rotation property bits */
89#define DRM_ROTATE_0 0
90#define DRM_ROTATE_90 1
91#define DRM_ROTATE_180 2
92#define DRM_ROTATE_270 3
93#define DRM_REFLECT_X 4
94#define DRM_REFLECT_Y 5
95
Daniel Vetter55310002014-01-23 15:52:20 +010096enum drm_connector_force {
97 DRM_FORCE_UNSPECIFIED,
98 DRM_FORCE_OFF,
99 DRM_FORCE_ON, /* force on analog part normally */
100 DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */
Dave Airlief453ba02008-11-07 14:05:41 -0800101};
102
Daniel Vetter55310002014-01-23 15:52:20 +0100103#include <drm/drm_modes.h>
Damien Lespiau4aa17cf2013-09-25 16:45:21 +0100104
Dave Airlief453ba02008-11-07 14:05:41 -0800105enum drm_connector_status {
106 connector_status_connected = 1,
107 connector_status_disconnected = 2,
108 connector_status_unknown = 3,
109};
110
111enum subpixel_order {
112 SubPixelUnknown = 0,
113 SubPixelHorizontalRGB,
114 SubPixelHorizontalBGR,
115 SubPixelVerticalRGB,
116 SubPixelVerticalBGR,
117 SubPixelNone,
118};
119
Jesse Barnesda05a5a72011-04-15 13:48:57 -0700120#define DRM_COLOR_FORMAT_RGB444 (1<<0)
121#define DRM_COLOR_FORMAT_YCRCB444 (1<<1)
122#define DRM_COLOR_FORMAT_YCRCB422 (1<<2)
Dave Airlief453ba02008-11-07 14:05:41 -0800123/*
124 * Describes a given display (e.g. CRT or flat panel) and its limitations.
125 */
126struct drm_display_info {
127 char name[DRM_DISPLAY_INFO_LEN];
Adam Jacksonfb439642010-08-03 14:38:16 -0400128
Dave Airlief453ba02008-11-07 14:05:41 -0800129 /* Physical size */
130 unsigned int width_mm;
131 unsigned int height_mm;
132
Dave Airlief453ba02008-11-07 14:05:41 -0800133 /* Clock limits FIXME: storage format */
134 unsigned int min_vfreq, max_vfreq;
135 unsigned int min_hfreq, max_hfreq;
136 unsigned int pixel_clock;
Jesse Barnes3b112282011-04-15 12:49:23 -0700137 unsigned int bpc;
Dave Airlief453ba02008-11-07 14:05:41 -0800138
Dave Airlief453ba02008-11-07 14:05:41 -0800139 enum subpixel_order subpixel_order;
Jesse Barnesda05a5a72011-04-15 13:48:57 -0700140 u32 color_formats;
Dave Airlief453ba02008-11-07 14:05:41 -0800141
Boris Brezillonb5571e92014-07-22 12:09:10 +0200142 const u32 *bus_formats;
143 unsigned int num_bus_formats;
144
Mario Kleiner5d02626d2014-06-05 09:52:10 -0400145 /* Mask of supported hdmi deep color modes */
146 u8 edid_hdmi_dc_modes;
147
Jesse Barnesebec9a72011-08-03 09:22:54 -0700148 u8 cea_rev;
Dave Airlief453ba02008-11-07 14:05:41 -0800149};
150
Dave Airlie138f9eb2014-10-20 16:17:17 +1000151/* data corresponds to displayid vend/prod/serial */
152struct drm_tile_group {
153 struct kref refcount;
154 struct drm_device *dev;
155 int id;
156 u8 group_data[8];
157};
158
Dave Airlief453ba02008-11-07 14:05:41 -0800159struct drm_framebuffer_funcs {
Rob Clarkf7eff602012-09-05 21:48:38 +0000160 /* note: use drm_framebuffer_remove() */
Dave Airlief453ba02008-11-07 14:05:41 -0800161 void (*destroy)(struct drm_framebuffer *framebuffer);
162 int (*create_handle)(struct drm_framebuffer *fb,
163 struct drm_file *file_priv,
164 unsigned int *handle);
Daniel Vetter3bf04012014-10-27 16:54:27 +0100165 /*
166 * Optional callback for the dirty fb ioctl.
Jakob Bornecrantz884840a2009-12-03 23:25:47 +0000167 *
168 * Userspace can notify the driver via this callback
169 * that a area of the framebuffer has changed and should
170 * be flushed to the display hardware.
171 *
172 * See documentation in drm_mode.h for the struct
173 * drm_mode_fb_dirty_cmd for more information as all
174 * the semantics and arguments have a one to one mapping
175 * on this function.
176 */
Thomas Hellstrom02b00162010-10-05 12:43:02 +0200177 int (*dirty)(struct drm_framebuffer *framebuffer,
178 struct drm_file *file_priv, unsigned flags,
Jakob Bornecrantz884840a2009-12-03 23:25:47 +0000179 unsigned color, struct drm_clip_rect *clips,
180 unsigned num_clips);
Dave Airlief453ba02008-11-07 14:05:41 -0800181};
182
183struct drm_framebuffer {
184 struct drm_device *dev;
Rob Clarkf7eff602012-09-05 21:48:38 +0000185 /*
186 * Note that the fb is refcounted for the benefit of driver internals,
187 * for example some hw, disabling a CRTC/plane is asynchronous, and
188 * scanout does not actually complete until the next vblank. So some
189 * cleanup (like releasing the reference(s) on the backing GEM bo(s))
190 * should be deferred. In cases like this, the driver would like to
191 * hold a ref to the fb even though it has already been removed from
192 * userspace perspective.
193 */
194 struct kref refcount;
Daniel Vetter4b096ac2012-12-10 21:19:18 +0100195 /*
196 * Place on the dev->mode_config.fb_list, access protected by
197 * dev->mode_config.fb_lock.
198 */
Dave Airlief453ba02008-11-07 14:05:41 -0800199 struct list_head head;
200 struct drm_mode_object base;
201 const struct drm_framebuffer_funcs *funcs;
Ville Syrjälä01f2c772011-12-20 00:06:49 +0200202 unsigned int pitches[4];
203 unsigned int offsets[4];
Rob Clarke3eb3252015-02-05 14:41:52 +0000204 uint64_t modifier[4];
Dave Airlief453ba02008-11-07 14:05:41 -0800205 unsigned int width;
206 unsigned int height;
207 /* depth can be 15 or 16 */
208 unsigned int depth;
209 int bits_per_pixel;
210 int flags;
Jesse Barnes308e5bc2011-11-14 14:51:28 -0800211 uint32_t pixel_format; /* fourcc format */
Dave Airlief453ba02008-11-07 14:05:41 -0800212 struct list_head filp_head;
Dave Airlie785b93e2009-08-28 15:46:53 +1000213 /* if you are using the helper */
214 void *helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800215};
216
217struct drm_property_blob {
218 struct drm_mode_object base;
Daniel Stone6bcacf52015-04-20 19:22:55 +0100219 struct drm_device *dev;
220 struct kref refcount;
Daniel Stonee2f5d2e2015-05-22 13:34:51 +0100221 struct list_head head_global;
222 struct list_head head_file;
Thierry Redingecbbe592014-05-13 11:36:13 +0200223 size_t length;
Ville Syrjäläd63f5e62012-03-13 12:35:49 +0200224 unsigned char data[];
Dave Airlief453ba02008-11-07 14:05:41 -0800225};
226
227struct drm_property_enum {
228 uint64_t value;
229 struct list_head head;
230 char name[DRM_PROP_NAME_LEN];
231};
232
233struct drm_property {
234 struct list_head head;
235 struct drm_mode_object base;
236 uint32_t flags;
237 char name[DRM_PROP_NAME_LEN];
238 uint32_t num_values;
239 uint64_t *values;
Rob Clark98f75de2014-05-30 11:37:03 -0400240 struct drm_device *dev;
Dave Airlief453ba02008-11-07 14:05:41 -0800241
Daniel Vetter3758b342014-11-19 18:38:10 +0100242 struct list_head enum_list;
Dave Airlief453ba02008-11-07 14:05:41 -0800243};
244
245struct drm_crtc;
246struct drm_connector;
247struct drm_encoder;
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -0500248struct drm_pending_vblank_event;
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800249struct drm_plane;
Sean Paul3b336ec2013-08-14 16:47:37 -0400250struct drm_bridge;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100251struct drm_atomic_state;
252
253/**
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200254 * struct drm_crtc_state - mutable CRTC state
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100255 * @crtc: backpointer to the CRTC
Daniel Vetter144ecb92014-10-27 20:28:44 +0100256 * @enable: whether the CRTC should be enabled, gates all other state
Daniel Vetterd9b13622014-11-26 16:57:41 +0100257 * @active: whether the CRTC is actively displaying (used for DPMS)
Maarten Lankhorstfc596662015-07-21 13:28:57 +0200258 * @planes_changed: planes on this crtc are updated
259 * @mode_changed: crtc_state->mode or crtc_state->enable has been changed
260 * @active_changed: crtc_state->active has been toggled.
261 * @connectors_changed: connectors to this crtc have been updated
Rob Clark6ddd3882014-11-21 15:28:31 -0500262 * @plane_mask: bitmask of (1 << drm_plane_index(plane)) of attached planes
Daniel Vetter623369e2014-09-16 17:50:47 +0200263 * @last_vblank_count: for helpers and drivers to capture the vblank of the
264 * update to ensure framebuffer cleanup isn't done too early
Daniel Vetter2f324b42014-10-29 11:13:47 +0100265 * @adjusted_mode: for use by helpers and drivers to compute adjusted mode timings
Daniel Vetter144ecb92014-10-27 20:28:44 +0100266 * @mode: current mode timings
267 * @event: optional pointer to a DRM event to signal upon completion of the
268 * state update
269 * @state: backpointer to global drm_atomic_state
Daniel Vetterd9b13622014-11-26 16:57:41 +0100270 *
271 * Note that the distinction between @enable and @active is rather subtile:
272 * Flipping @active while @enable is set without changing anything else may
273 * never return in a failure from the ->atomic_check callback. Userspace assumes
274 * that a DPMS On will always succeed. In other words: @enable controls resource
275 * assignment, @active controls the actual hardware state.
Daniel Vetter144ecb92014-10-27 20:28:44 +0100276 */
277struct drm_crtc_state {
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100278 struct drm_crtc *crtc;
279
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200280 bool enable;
Daniel Vetterd9b13622014-11-26 16:57:41 +0100281 bool active;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100282
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100283 /* computed state bits used by helpers and drivers */
284 bool planes_changed : 1;
Daniel Vetter623369e2014-09-16 17:50:47 +0200285 bool mode_changed : 1;
Daniel Vettereab3bbe2015-01-22 16:36:21 +0100286 bool active_changed : 1;
Maarten Lankhorstfc596662015-07-21 13:28:57 +0200287 bool connectors_changed : 1;
Daniel Vetter623369e2014-09-16 17:50:47 +0200288
Rob Clark6ddd3882014-11-21 15:28:31 -0500289 /* attached planes bitmask:
290 * WARNING: transitional helpers do not maintain plane_mask so
291 * drivers not converted over to atomic helpers should not rely
292 * on plane_mask being accurate!
293 */
294 u32 plane_mask;
295
Daniel Vetter623369e2014-09-16 17:50:47 +0200296 /* last_vblank_count: for vblank waits before cleanup */
297 u32 last_vblank_count;
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100298
Daniel Vetter2f324b42014-10-29 11:13:47 +0100299 /* adjusted_mode: for use by helpers and drivers */
300 struct drm_display_mode adjusted_mode;
301
Daniel Vetter144ecb92014-10-27 20:28:44 +0100302 struct drm_display_mode mode;
303
Daniel Stone99cf4a22015-05-25 19:11:51 +0100304 /* blob property to expose current mode to atomic userspace */
305 struct drm_property_blob *mode_blob;
306
Daniel Vetter144ecb92014-10-27 20:28:44 +0100307 struct drm_pending_vblank_event *event;
308
309 struct drm_atomic_state *state;
310};
Dave Airlief453ba02008-11-07 14:05:41 -0800311
312/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100313 * struct drm_crtc_funcs - control CRTCs for a given device
Dave Airlief453ba02008-11-07 14:05:41 -0800314 * @save: save CRTC state
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200315 * @restore: restore CRTC state
Christopher Harvey715f59c2013-04-05 15:28:32 +0000316 * @reset: reset CRTC after state has been invalidated (e.g. resume)
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200317 * @cursor_set: setup the cursor
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100318 * @cursor_set2: setup the cursor with hotspot, superseeds @cursor_set if set
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200319 * @cursor_move: move the cursor
Dave Airlief453ba02008-11-07 14:05:41 -0800320 * @gamma_set: specify color ramp for CRTC
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300321 * @destroy: deinit and free object
322 * @set_property: called when a property is changed
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200323 * @set_config: apply a new CRTC configuration
324 * @page_flip: initiate a page flip
Daniel Vetter144ecb92014-10-27 20:28:44 +0100325 * @atomic_duplicate_state: duplicate the atomic state for this CRTC
326 * @atomic_destroy_state: destroy an atomic state for this CRTC
327 * @atomic_set_property: set a property on an atomic state for this CRTC
Rob Clark40ecc692014-12-18 16:01:46 -0500328 * (do not call directly, use drm_atomic_crtc_set_property())
Rob Clarkac9c9252014-12-18 16:01:47 -0500329 * @atomic_get_property: get a property on an atomic state for this CRTC
330 * (do not call directly, use drm_atomic_crtc_get_property())
Dave Airlief453ba02008-11-07 14:05:41 -0800331 *
332 * The drm_crtc_funcs structure is the central CRTC management structure
333 * in the DRM. Each CRTC controls one or more connectors (note that the name
334 * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc.
335 * connectors, not just CRTs).
336 *
337 * Each driver is responsible for filling out this structure at startup time,
338 * in addition to providing other modesetting features, like i2c and DDC
339 * bus accessors.
340 */
341struct drm_crtc_funcs {
342 /* Save CRTC state */
343 void (*save)(struct drm_crtc *crtc); /* suspend? */
344 /* Restore CRTC state */
345 void (*restore)(struct drm_crtc *crtc); /* resume? */
Chris Wilsoneb033552011-01-24 15:11:08 +0000346 /* Reset CRTC state */
347 void (*reset)(struct drm_crtc *crtc);
Dave Airlief453ba02008-11-07 14:05:41 -0800348
349 /* cursor controls */
350 int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv,
351 uint32_t handle, uint32_t width, uint32_t height);
Dave Airlie4c813d42013-06-20 11:48:52 +1000352 int (*cursor_set2)(struct drm_crtc *crtc, struct drm_file *file_priv,
353 uint32_t handle, uint32_t width, uint32_t height,
354 int32_t hot_x, int32_t hot_y);
Dave Airlief453ba02008-11-07 14:05:41 -0800355 int (*cursor_move)(struct drm_crtc *crtc, int x, int y);
356
357 /* Set gamma on the CRTC */
358 void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b,
James Simmons72034252010-08-03 01:33:19 +0100359 uint32_t start, uint32_t size);
Dave Airlief453ba02008-11-07 14:05:41 -0800360 /* Object destroy routine */
361 void (*destroy)(struct drm_crtc *crtc);
362
363 int (*set_config)(struct drm_mode_set *set);
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -0500364
365 /*
366 * Flip to the given framebuffer. This implements the page
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300367 * flip ioctl described in drm_mode.h, specifically, the
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -0500368 * implementation must return immediately and block all
369 * rendering to the current fb until the flip has completed.
370 * If userspace set the event flag in the ioctl, the event
371 * argument will point to an event to send back when the flip
372 * completes, otherwise it will be NULL.
373 */
374 int (*page_flip)(struct drm_crtc *crtc,
375 struct drm_framebuffer *fb,
Keith Packarded8d1972013-07-22 18:49:58 -0700376 struct drm_pending_vblank_event *event,
377 uint32_t flags);
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300378
379 int (*set_property)(struct drm_crtc *crtc,
380 struct drm_property *property, uint64_t val);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100381
382 /* atomic update handling */
383 struct drm_crtc_state *(*atomic_duplicate_state)(struct drm_crtc *crtc);
384 void (*atomic_destroy_state)(struct drm_crtc *crtc,
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200385 struct drm_crtc_state *state);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100386 int (*atomic_set_property)(struct drm_crtc *crtc,
387 struct drm_crtc_state *state,
388 struct drm_property *property,
389 uint64_t val);
Rob Clarkac9c9252014-12-18 16:01:47 -0500390 int (*atomic_get_property)(struct drm_crtc *crtc,
391 const struct drm_crtc_state *state,
392 struct drm_property *property,
393 uint64_t *val);
Dave Airlief453ba02008-11-07 14:05:41 -0800394};
395
396/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100397 * struct drm_crtc - central CRTC control structure
Jesse Barnes77491632011-11-07 12:03:14 -0800398 * @dev: parent DRM device
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100399 * @port: OF node used by drm_of_find_possible_crtcs()
Jesse Barnes77491632011-11-07 12:03:14 -0800400 * @head: list management
Rob Clark51fd3712013-11-19 12:10:12 -0500401 * @mutex: per-CRTC locking
Jesse Barnes77491632011-11-07 12:03:14 -0800402 * @base: base KMS object for ID tracking etc.
Matt Ropere13161a2014-04-01 15:22:38 -0700403 * @primary: primary plane for this CRTC
404 * @cursor: cursor plane for this CRTC
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100405 * @cursor_x: current x position of the cursor, used for universal cursor planes
406 * @cursor_y: current y position of the cursor, used for universal cursor planes
Dave Airlief453ba02008-11-07 14:05:41 -0800407 * @enabled: is this CRTC enabled?
Jesse Barnes77491632011-11-07 12:03:14 -0800408 * @mode: current mode timings
409 * @hwmode: mode timings as programmed to hw regs
Rob Clark7c80e122012-09-04 16:35:56 +0000410 * @invert_dimensions: for purposes of error checking crtc vs fb sizes,
411 * invert the width/height of the crtc. This is used if the driver
412 * is performing 90 or 270 degree rotated scanout
Dave Airlief453ba02008-11-07 14:05:41 -0800413 * @x: x position on screen
414 * @y: y position on screen
Dave Airlief453ba02008-11-07 14:05:41 -0800415 * @funcs: CRTC control functions
Jesse Barnes77491632011-11-07 12:03:14 -0800416 * @gamma_size: size of gamma ramp
417 * @gamma_store: gamma ramp values
418 * @framedur_ns: precise frame timing
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100419 * @linedur_ns: precise line timing
Jesse Barnes77491632011-11-07 12:03:14 -0800420 * @pixeldur_ns: precise pixel timing
421 * @helper_private: mid-layer private data
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300422 * @properties: property tracking for this CRTC
Daniel Vetter144ecb92014-10-27 20:28:44 +0100423 * @state: current atomic state for this CRTC
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100424 * @acquire_ctx: per-CRTC implicit acquire context used by atomic drivers for
425 * legacy ioctls
Dave Airlief453ba02008-11-07 14:05:41 -0800426 *
427 * Each CRTC may have one or more connectors associated with it. This structure
428 * allows the CRTC to be controlled.
429 */
430struct drm_crtc {
431 struct drm_device *dev;
Russell King7e435aa2014-06-15 11:07:12 +0100432 struct device_node *port;
Dave Airlief453ba02008-11-07 14:05:41 -0800433 struct list_head head;
434
Daniel Vetter3bf04012014-10-27 16:54:27 +0100435 /*
Daniel Vetter29494c12012-12-02 02:18:25 +0100436 * crtc mutex
437 *
438 * This provides a read lock for the overall crtc state (mode, dpms
439 * state, ...) and a write lock for everything which can be update
440 * without a full modeset (fb, cursor data, ...)
441 */
Rob Clark51fd3712013-11-19 12:10:12 -0500442 struct drm_modeset_lock mutex;
Daniel Vetter29494c12012-12-02 02:18:25 +0100443
Dave Airlief453ba02008-11-07 14:05:41 -0800444 struct drm_mode_object base;
445
Matt Ropere13161a2014-04-01 15:22:38 -0700446 /* primary and cursor planes for CRTC */
447 struct drm_plane *primary;
448 struct drm_plane *cursor;
449
Matt Roper161d0dc2014-06-10 08:28:10 -0700450 /* position of cursor plane on crtc */
451 int cursor_x;
452 int cursor_y;
453
Dave Airlief453ba02008-11-07 14:05:41 -0800454 bool enabled;
455
Mario Kleiner27641c32010-10-23 04:20:23 +0200456 /* Requested mode from modesetting. */
Dave Airlief453ba02008-11-07 14:05:41 -0800457 struct drm_display_mode mode;
458
Mario Kleiner27641c32010-10-23 04:20:23 +0200459 /* Programmed mode in hw, after adjustments for encoders,
460 * crtc, panel scaling etc. Needed for timestamping etc.
461 */
462 struct drm_display_mode hwmode;
463
Rob Clark7c80e122012-09-04 16:35:56 +0000464 bool invert_dimensions;
465
Dave Airlief453ba02008-11-07 14:05:41 -0800466 int x, y;
Dave Airlief453ba02008-11-07 14:05:41 -0800467 const struct drm_crtc_funcs *funcs;
468
469 /* CRTC gamma size for reporting to userspace */
470 uint32_t gamma_size;
471 uint16_t *gamma_store;
472
Mario Kleiner27641c32010-10-23 04:20:23 +0200473 /* Constants needed for precise vblank and swap timestamping. */
Ville Syrjälä3c184f62013-10-26 17:38:52 +0300474 int framedur_ns, linedur_ns, pixeldur_ns;
Mario Kleiner27641c32010-10-23 04:20:23 +0200475
Dave Airlief453ba02008-11-07 14:05:41 -0800476 /* if you are using the helper */
Jani Nikula9a436ee2015-04-13 11:21:42 +0300477 const void *helper_private;
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300478
479 struct drm_object_properties properties;
Daniel Vetterd059f652014-07-25 18:07:40 +0200480
Daniel Vetter144ecb92014-10-27 20:28:44 +0100481 struct drm_crtc_state *state;
482
Daniel Vetterd059f652014-07-25 18:07:40 +0200483 /*
484 * For legacy crtc ioctls so that atomic drivers can get at the locking
485 * acquire context.
486 */
487 struct drm_modeset_acquire_ctx *acquire_ctx;
Dave Airlief453ba02008-11-07 14:05:41 -0800488};
489
Daniel Vetter144ecb92014-10-27 20:28:44 +0100490/**
491 * struct drm_connector_state - mutable connector state
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100492 * @connector: backpointer to the connector
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200493 * @crtc: CRTC to connect connector to, NULL if disabled
Daniel Vetter623369e2014-09-16 17:50:47 +0200494 * @best_encoder: can be used by helpers and drivers to select the encoder
Daniel Vetter144ecb92014-10-27 20:28:44 +0100495 * @state: backpointer to global drm_atomic_state
496 */
497struct drm_connector_state {
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100498 struct drm_connector *connector;
499
Rob Clark6ddd3882014-11-21 15:28:31 -0500500 struct drm_crtc *crtc; /* do not write directly, use drm_atomic_set_crtc_for_connector() */
Daniel Vetter144ecb92014-10-27 20:28:44 +0100501
Daniel Vetter623369e2014-09-16 17:50:47 +0200502 struct drm_encoder *best_encoder;
503
Daniel Vetter144ecb92014-10-27 20:28:44 +0100504 struct drm_atomic_state *state;
505};
Dave Airlief453ba02008-11-07 14:05:41 -0800506
507/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100508 * struct drm_connector_funcs - control connectors on a given device
Thierry Reding261ea742014-12-17 16:41:40 +0100509 * @dpms: set power state
Dave Airlief453ba02008-11-07 14:05:41 -0800510 * @save: save connector state
511 * @restore: restore connector state
Christopher Harvey13bcf012013-03-07 10:42:25 -0500512 * @reset: reset connector after state has been invalidated (e.g. resume)
Dave Airlief453ba02008-11-07 14:05:41 -0800513 * @detect: is this connector active?
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200514 * @fill_modes: fill mode list for this connector
Christopher Harvey13bcf012013-03-07 10:42:25 -0500515 * @set_property: property for this connector may need an update
Dave Airlief453ba02008-11-07 14:05:41 -0800516 * @destroy: make object go away
Christopher Harvey13bcf012013-03-07 10:42:25 -0500517 * @force: notify the driver that the connector is forced on
Daniel Vetter144ecb92014-10-27 20:28:44 +0100518 * @atomic_duplicate_state: duplicate the atomic state for this connector
519 * @atomic_destroy_state: destroy an atomic state for this connector
520 * @atomic_set_property: set a property on an atomic state for this connector
Rob Clark40ecc692014-12-18 16:01:46 -0500521 * (do not call directly, use drm_atomic_connector_set_property())
Rob Clarkac9c9252014-12-18 16:01:47 -0500522 * @atomic_get_property: get a property on an atomic state for this connector
523 * (do not call directly, use drm_atomic_connector_get_property())
Daniel Vetter144ecb92014-10-27 20:28:44 +0100524 *
Dave Airlief453ba02008-11-07 14:05:41 -0800525 * Each CRTC may have one or more connectors attached to it. The functions
526 * below allow the core DRM code to control connectors, enumerate available modes,
527 * etc.
528 */
529struct drm_connector_funcs {
Maarten Lankhorst9a69a9a2015-07-21 11:34:55 +0200530 int (*dpms)(struct drm_connector *connector, int mode);
Dave Airlief453ba02008-11-07 14:05:41 -0800531 void (*save)(struct drm_connector *connector);
532 void (*restore)(struct drm_connector *connector);
Chris Wilsoneb033552011-01-24 15:11:08 +0000533 void (*reset)(struct drm_connector *connector);
Chris Wilson930a9e22010-09-14 11:07:23 +0100534
535 /* Check to see if anything is attached to the connector.
536 * @force is set to false whilst polling, true when checking the
537 * connector due to user request. @force can be used by the driver
538 * to avoid expensive, destructive operations during automated
539 * probing.
540 */
Chris Wilson7b334fc2010-09-09 23:51:02 +0100541 enum drm_connector_status (*detect)(struct drm_connector *connector,
Chris Wilson930a9e22010-09-14 11:07:23 +0100542 bool force);
Jesse Barnes40a518d2009-01-12 12:05:32 -0800543 int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height);
Dave Airlief453ba02008-11-07 14:05:41 -0800544 int (*set_property)(struct drm_connector *connector, struct drm_property *property,
545 uint64_t val);
546 void (*destroy)(struct drm_connector *connector);
Dave Airlied50ba252009-09-23 14:44:08 +1000547 void (*force)(struct drm_connector *connector);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100548
549 /* atomic update handling */
550 struct drm_connector_state *(*atomic_duplicate_state)(struct drm_connector *connector);
551 void (*atomic_destroy_state)(struct drm_connector *connector,
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200552 struct drm_connector_state *state);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100553 int (*atomic_set_property)(struct drm_connector *connector,
554 struct drm_connector_state *state,
555 struct drm_property *property,
556 uint64_t val);
Rob Clarkac9c9252014-12-18 16:01:47 -0500557 int (*atomic_get_property)(struct drm_connector *connector,
558 const struct drm_connector_state *state,
559 struct drm_property *property,
560 uint64_t *val);
Dave Airlief453ba02008-11-07 14:05:41 -0800561};
562
Jesse Barnes6c3db922011-11-07 12:03:16 -0800563/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100564 * struct drm_encoder_funcs - encoder controls
Jesse Barnes6c3db922011-11-07 12:03:16 -0800565 * @reset: reset state (e.g. at init or resume time)
566 * @destroy: cleanup and free associated data
567 *
568 * Encoders sit between CRTCs and connectors.
569 */
Dave Airlief453ba02008-11-07 14:05:41 -0800570struct drm_encoder_funcs {
Chris Wilsoneb033552011-01-24 15:11:08 +0000571 void (*reset)(struct drm_encoder *encoder);
Dave Airlief453ba02008-11-07 14:05:41 -0800572 void (*destroy)(struct drm_encoder *encoder);
573};
574
Ben Skeggsafe887d2012-01-12 16:00:57 +1000575#define DRM_CONNECTOR_MAX_ENCODER 3
Dave Airlief453ba02008-11-07 14:05:41 -0800576
577/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100578 * struct drm_encoder - central DRM encoder structure
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800579 * @dev: parent DRM device
580 * @head: list management
581 * @base: base KMS object
Jani Nikulae5748942014-05-14 16:58:20 +0300582 * @name: encoder name
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800583 * @encoder_type: one of the %DRM_MODE_ENCODER_<foo> types in drm_mode.h
584 * @possible_crtcs: bitmask of potential CRTC bindings
585 * @possible_clones: bitmask of potential sibling encoders for cloning
586 * @crtc: currently bound CRTC
Sean Paul3b336ec2013-08-14 16:47:37 -0400587 * @bridge: bridge associated to the encoder
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800588 * @funcs: control functions
589 * @helper_private: mid-layer private data
590 *
591 * CRTCs drive pixels to encoders, which convert them into signals
592 * appropriate for a given connector or set of connectors.
Dave Airlief453ba02008-11-07 14:05:41 -0800593 */
594struct drm_encoder {
595 struct drm_device *dev;
596 struct list_head head;
597
598 struct drm_mode_object base;
Jani Nikulae5748942014-05-14 16:58:20 +0300599 char *name;
Dave Airlief453ba02008-11-07 14:05:41 -0800600 int encoder_type;
601 uint32_t possible_crtcs;
602 uint32_t possible_clones;
603
604 struct drm_crtc *crtc;
Sean Paul3b336ec2013-08-14 16:47:37 -0400605 struct drm_bridge *bridge;
Dave Airlief453ba02008-11-07 14:05:41 -0800606 const struct drm_encoder_funcs *funcs;
Jani Nikula9a436ee2015-04-13 11:21:42 +0300607 const void *helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800608};
609
Dave Airlieeb1f8e42010-05-07 06:42:51 +0000610/* should we poll this connector for connects and disconnects */
611/* hot plug detectable */
612#define DRM_CONNECTOR_POLL_HPD (1 << 0)
613/* poll for connections */
614#define DRM_CONNECTOR_POLL_CONNECT (1 << 1)
615/* can cleanly poll for disconnections without flickering the screen */
616/* DACs should rarely do this without a lot of testing */
617#define DRM_CONNECTOR_POLL_DISCONNECT (1 << 2)
618
Wu Fengguang76adaa342011-09-05 14:23:20 +0800619#define MAX_ELD_BYTES 128
620
Dave Airlief453ba02008-11-07 14:05:41 -0800621/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100622 * struct drm_connector - central DRM connector control structure
Jesse Barnes72252542011-11-07 12:03:18 -0800623 * @dev: parent DRM device
624 * @kdev: kernel device for sysfs attributes
625 * @attr: sysfs attributes
626 * @head: list management
627 * @base: base KMS object
Jani Nikula2abdd312014-05-14 16:58:19 +0300628 * @name: connector name
Jesse Barnes72252542011-11-07 12:03:18 -0800629 * @connector_type: one of the %DRM_MODE_CONNECTOR_<foo> types from drm_mode.h
630 * @connector_type_id: index into connector type enum
Dave Airlief453ba02008-11-07 14:05:41 -0800631 * @interlace_allowed: can this connector handle interlaced modes?
632 * @doublescan_allowed: can this connector handle doublescan?
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100633 * @stereo_allowed: can this connector handle stereo modes?
Jesse Barnes72252542011-11-07 12:03:18 -0800634 * @modes: modes available on this connector (from fill_modes() + user)
635 * @status: one of the drm_connector_status enums (connected, not, or unknown)
636 * @probed_modes: list of modes derived directly from the display
637 * @display_info: information about attached display (e.g. from EDID)
Dave Airlief453ba02008-11-07 14:05:41 -0800638 * @funcs: connector control functions
Jesse Barnes72252542011-11-07 12:03:18 -0800639 * @edid_blob_ptr: DRM property containing EDID if present
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -0300640 * @properties: property tracking for this connector
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100641 * @path_blob_ptr: DRM blob property data for the DP MST path property
Jesse Barnes72252542011-11-07 12:03:18 -0800642 * @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling
643 * @dpms: current dpms state
644 * @helper_private: mid-layer private data
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100645 * @cmdline_mode: mode line parsed from the kernel cmdline for this connector
Jesse Barnes72252542011-11-07 12:03:18 -0800646 * @force: a %DRM_FORCE_<foo> state for forced mode sets
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100647 * @override_edid: has the EDID been overwritten through debugfs for testing?
Jesse Barnes72252542011-11-07 12:03:18 -0800648 * @encoder_ids: valid encoders for this connector
649 * @encoder: encoder driving this connector, if any
650 * @eld: EDID-like data, if present
651 * @dvi_dual: dual link DVI, if found
652 * @max_tmds_clock: max clock rate, if found
653 * @latency_present: AV delay info from ELD, if found
654 * @video_latency: video latency info from ELD, if found
655 * @audio_latency: audio latency info from ELD, if found
656 * @null_edid_counter: track sinks that give us all zeros for the EDID
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100657 * @bad_edid_counter: track sinks that give us an EDID with invalid checksum
Daniel Vetterac6f2e22015-05-08 16:15:41 +0200658 * @edid_corrupt: indicates whether the last read EDID was corrupt
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100659 * @debugfs_entry: debugfs directory for this connector
Daniel Vetter144ecb92014-10-27 20:28:44 +0100660 * @state: current atomic state for this connector
Dave Airlie40d9b042014-10-20 16:29:33 +1000661 * @has_tile: is this connector connected to a tiled monitor
662 * @tile_group: tile group for the connected monitor
663 * @tile_is_single_monitor: whether the tile is one monitor housing
664 * @num_h_tile: number of horizontal tiles in the tile group
665 * @num_v_tile: number of vertical tiles in the tile group
666 * @tile_h_loc: horizontal location of this tile
667 * @tile_v_loc: vertical location of this tile
668 * @tile_h_size: horizontal size of this tile.
669 * @tile_v_size: vertical size of this tile.
Dave Airlief453ba02008-11-07 14:05:41 -0800670 *
671 * Each connector may be connected to one or more CRTCs, or may be clonable by
672 * another connector if they can share a CRTC. Each connector also has a specific
673 * position in the broader display (referred to as a 'screen' though it could
674 * span multiple monitors).
675 */
676struct drm_connector {
677 struct drm_device *dev;
Dave Airlie5bdebb12013-10-11 14:07:25 +1000678 struct device *kdev;
Dave Airlief453ba02008-11-07 14:05:41 -0800679 struct device_attribute *attr;
680 struct list_head head;
681
682 struct drm_mode_object base;
683
Jani Nikula2abdd312014-05-14 16:58:19 +0300684 char *name;
Dave Airlief453ba02008-11-07 14:05:41 -0800685 int connector_type;
686 int connector_type_id;
687 bool interlace_allowed;
688 bool doublescan_allowed;
Damien Lespiau560a0672013-09-25 16:45:29 +0100689 bool stereo_allowed;
Dave Airlief453ba02008-11-07 14:05:41 -0800690 struct list_head modes; /* list of modes on this connector */
691
Dave Airlief453ba02008-11-07 14:05:41 -0800692 enum drm_connector_status status;
693
694 /* these are modes added by probing with DDC or the BIOS */
695 struct list_head probed_modes;
696
697 struct drm_display_info display_info;
698 const struct drm_connector_funcs *funcs;
699
Dave Airlief453ba02008-11-07 14:05:41 -0800700 struct drm_property_blob *edid_blob_ptr;
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -0300701 struct drm_object_properties properties;
Dave Airlief453ba02008-11-07 14:05:41 -0800702
Dave Airlie43aba7e2014-06-05 14:01:31 +1000703 struct drm_property_blob *path_blob_ptr;
704
Dave Airlie6f134d72014-10-20 16:30:50 +1000705 struct drm_property_blob *tile_blob_ptr;
706
Dave Airlieeb1f8e42010-05-07 06:42:51 +0000707 uint8_t polled; /* DRM_CONNECTOR_POLL_* */
708
Keith Packardc9fb15f2009-05-30 20:42:28 -0700709 /* requested DPMS state */
710 int dpms;
711
Jani Nikula9a436ee2015-04-13 11:21:42 +0300712 const void *helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800713
Dave Airlied50ba252009-09-23 14:44:08 +1000714 /* forced on connector */
Chris Wilsoneaf99c72014-08-06 10:08:32 +0200715 struct drm_cmdline_mode cmdline_mode;
Dave Airlied50ba252009-09-23 14:44:08 +1000716 enum drm_connector_force force;
Thomas Wood4cf2b282014-06-18 17:52:33 +0100717 bool override_edid;
Dave Airlief453ba02008-11-07 14:05:41 -0800718 uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER];
Dave Airlief453ba02008-11-07 14:05:41 -0800719 struct drm_encoder *encoder; /* currently active encoder */
Dave Airlie4a9a8b72011-06-14 06:13:55 +0000720
Wu Fengguang76adaa342011-09-05 14:23:20 +0800721 /* EDID bits */
722 uint8_t eld[MAX_ELD_BYTES];
723 bool dvi_dual;
724 int max_tmds_clock; /* in MHz */
725 bool latency_present[2];
726 int video_latency[2]; /* [0]: progressive, [1]: interlaced */
727 int audio_latency[2];
Dave Airlie4a9a8b72011-06-14 06:13:55 +0000728 int null_edid_counter; /* needed to workaround some HW bugs where we get all 0s */
Jerome Glisse0b2443e2012-08-09 11:25:51 -0400729 unsigned bad_edid_counter;
Thomas Wood30f65702014-06-18 17:52:32 +0100730
Todd Previte6ba2bd32015-04-21 11:09:41 -0700731 /* Flag for raw EDID header corruption - used in Displayport
732 * compliance testing - * Displayport Link CTS Core 1.2 rev1.1 4.2.2.6
733 */
734 bool edid_corrupt;
735
Thomas Wood30f65702014-06-18 17:52:32 +0100736 struct dentry *debugfs_entry;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100737
738 struct drm_connector_state *state;
Dave Airlie40d9b042014-10-20 16:29:33 +1000739
740 /* DisplayID bits */
741 bool has_tile;
742 struct drm_tile_group *tile_group;
743 bool tile_is_single_monitor;
744
745 uint8_t num_h_tile, num_v_tile;
746 uint8_t tile_h_loc, tile_v_loc;
747 uint16_t tile_h_size, tile_v_size;
Dave Airlief453ba02008-11-07 14:05:41 -0800748};
749
750/**
Daniel Vetter144ecb92014-10-27 20:28:44 +0100751 * struct drm_plane_state - mutable plane state
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100752 * @plane: backpointer to the plane
Daniel Vetter144ecb92014-10-27 20:28:44 +0100753 * @crtc: currently bound CRTC, NULL if disabled
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200754 * @fb: currently bound framebuffer
Daniel Vettere2330f02014-10-29 11:34:56 +0100755 * @fence: optional fence to wait for before scanning out @fb
Daniel Vetter144ecb92014-10-27 20:28:44 +0100756 * @crtc_x: left position of visible portion of plane on crtc
757 * @crtc_y: upper position of visible portion of plane on crtc
758 * @crtc_w: width of visible portion of plane on crtc
759 * @crtc_h: height of visible portion of plane on crtc
760 * @src_x: left position of visible portion of plane within
761 * plane (in 16.16)
762 * @src_y: upper position of visible portion of plane within
763 * plane (in 16.16)
764 * @src_w: width of visible portion of plane (in 16.16)
765 * @src_h: height of visible portion of plane (in 16.16)
766 * @state: backpointer to global drm_atomic_state
767 */
768struct drm_plane_state {
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100769 struct drm_plane *plane;
770
Rob Clark6ddd3882014-11-21 15:28:31 -0500771 struct drm_crtc *crtc; /* do not write directly, use drm_atomic_set_crtc_for_plane() */
772 struct drm_framebuffer *fb; /* do not write directly, use drm_atomic_set_fb_for_plane() */
Daniel Vettere2330f02014-10-29 11:34:56 +0100773 struct fence *fence;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100774
775 /* Signed dest location allows it to be partially off screen */
776 int32_t crtc_x, crtc_y;
777 uint32_t crtc_w, crtc_h;
778
779 /* Source values are 16.16 fixed point */
780 uint32_t src_x, src_y;
781 uint32_t src_h, src_w;
782
Matt Roper1da30622015-01-21 16:35:40 -0800783 /* Plane rotation */
784 unsigned int rotation;
785
Daniel Vetter144ecb92014-10-27 20:28:44 +0100786 struct drm_atomic_state *state;
787};
788
789
790/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100791 * struct drm_plane_funcs - driver plane control functions
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800792 * @update_plane: update the plane configuration
793 * @disable_plane: shut down the plane
794 * @destroy: clean up plane resources
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100795 * @reset: reset plane after state has been invalidated (e.g. resume)
Rob Clark4d939142012-05-17 02:23:27 -0600796 * @set_property: called when a property is changed
Daniel Vetter144ecb92014-10-27 20:28:44 +0100797 * @atomic_duplicate_state: duplicate the atomic state for this plane
798 * @atomic_destroy_state: destroy an atomic state for this plane
799 * @atomic_set_property: set a property on an atomic state for this plane
Rob Clark40ecc692014-12-18 16:01:46 -0500800 * (do not call directly, use drm_atomic_plane_set_property())
Rob Clarkac9c9252014-12-18 16:01:47 -0500801 * @atomic_get_property: get a property on an atomic state for this plane
802 * (do not call directly, use drm_atomic_plane_get_property())
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800803 */
804struct drm_plane_funcs {
805 int (*update_plane)(struct drm_plane *plane,
806 struct drm_crtc *crtc, struct drm_framebuffer *fb,
807 int crtc_x, int crtc_y,
808 unsigned int crtc_w, unsigned int crtc_h,
809 uint32_t src_x, uint32_t src_y,
810 uint32_t src_w, uint32_t src_h);
811 int (*disable_plane)(struct drm_plane *plane);
812 void (*destroy)(struct drm_plane *plane);
Daniel Vetter2a0d7cf2014-07-29 15:32:37 +0200813 void (*reset)(struct drm_plane *plane);
Rob Clark4d939142012-05-17 02:23:27 -0600814
815 int (*set_property)(struct drm_plane *plane,
816 struct drm_property *property, uint64_t val);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100817
818 /* atomic update handling */
819 struct drm_plane_state *(*atomic_duplicate_state)(struct drm_plane *plane);
820 void (*atomic_destroy_state)(struct drm_plane *plane,
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200821 struct drm_plane_state *state);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100822 int (*atomic_set_property)(struct drm_plane *plane,
823 struct drm_plane_state *state,
824 struct drm_property *property,
825 uint64_t val);
Rob Clarkac9c9252014-12-18 16:01:47 -0500826 int (*atomic_get_property)(struct drm_plane *plane,
827 const struct drm_plane_state *state,
828 struct drm_property *property,
829 uint64_t *val);
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800830};
831
Matt Ropere27dde32014-04-01 15:22:30 -0700832enum drm_plane_type {
833 DRM_PLANE_TYPE_OVERLAY,
834 DRM_PLANE_TYPE_PRIMARY,
835 DRM_PLANE_TYPE_CURSOR,
836};
837
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800838/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100839 * struct drm_plane - central DRM plane control structure
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800840 * @dev: DRM device this plane belongs to
841 * @head: for list management
842 * @base: base mode object
843 * @possible_crtcs: pipes this plane can be bound to
844 * @format_types: array of formats supported by this plane
845 * @format_count: number of formats supported
Laurent Pinchart7eb5f302015-03-09 10:41:07 +0200846 * @format_default: driver hasn't supplied supported formats for the plane
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800847 * @crtc: currently bound CRTC
848 * @fb: currently bound fb
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100849 * @old_fb: Temporary tracking of the old fb while a modeset is ongoing. Used by
850 * drm_mode_set_config_internal() to implement correct refcounting.
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800851 * @funcs: helper functions
Rob Clark4d939142012-05-17 02:23:27 -0600852 * @properties: property tracking for this plane
Matt Ropere27dde32014-04-01 15:22:30 -0700853 * @type: type of plane (overlay, primary, cursor)
Daniel Vetter144ecb92014-10-27 20:28:44 +0100854 * @state: current atomic state for this plane
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800855 */
856struct drm_plane {
857 struct drm_device *dev;
858 struct list_head head;
859
Daniel Vetter4d02e2d2014-11-11 10:12:00 +0100860 struct drm_modeset_lock mutex;
861
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800862 struct drm_mode_object base;
863
864 uint32_t possible_crtcs;
865 uint32_t *format_types;
Thierry Reding45e37432015-08-12 16:54:28 +0200866 unsigned int format_count;
Laurent Pinchart7eb5f302015-03-09 10:41:07 +0200867 bool format_default;
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800868
869 struct drm_crtc *crtc;
870 struct drm_framebuffer *fb;
871
Daniel Vetter3d30a592014-07-27 13:42:42 +0200872 struct drm_framebuffer *old_fb;
873
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800874 const struct drm_plane_funcs *funcs;
Rob Clark4d939142012-05-17 02:23:27 -0600875
876 struct drm_object_properties properties;
Matt Ropere27dde32014-04-01 15:22:30 -0700877
878 enum drm_plane_type type;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100879
Jani Nikula9a436ee2015-04-13 11:21:42 +0300880 const void *helper_private;
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100881
Daniel Vetter144ecb92014-10-27 20:28:44 +0100882 struct drm_plane_state *state;
Jesse Barnes8cf5c912011-11-14 14:51:27 -0800883};
884
885/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100886 * struct drm_bridge_funcs - drm_bridge control functions
Ajay Kumar3d3f8b12015-01-20 22:08:44 +0530887 * @attach: Called during drm_bridge_attach
Sean Paul3b336ec2013-08-14 16:47:37 -0400888 * @mode_fixup: Try to fixup (or reject entirely) proposed mode for this bridge
889 * @disable: Called right before encoder prepare, disables the bridge
890 * @post_disable: Called right after encoder prepare, for lockstepped disable
891 * @mode_set: Set this mode to the bridge
892 * @pre_enable: Called right before encoder commit, for lockstepped commit
893 * @enable: Called right after encoder commit, enables the bridge
Sean Paul3b336ec2013-08-14 16:47:37 -0400894 */
895struct drm_bridge_funcs {
Ajay Kumar3d3f8b12015-01-20 22:08:44 +0530896 int (*attach)(struct drm_bridge *bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400897 bool (*mode_fixup)(struct drm_bridge *bridge,
898 const struct drm_display_mode *mode,
899 struct drm_display_mode *adjusted_mode);
900 void (*disable)(struct drm_bridge *bridge);
901 void (*post_disable)(struct drm_bridge *bridge);
902 void (*mode_set)(struct drm_bridge *bridge,
903 struct drm_display_mode *mode,
904 struct drm_display_mode *adjusted_mode);
905 void (*pre_enable)(struct drm_bridge *bridge);
906 void (*enable)(struct drm_bridge *bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -0400907};
908
909/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100910 * struct drm_bridge - central DRM bridge control structure
Sean Paul3b336ec2013-08-14 16:47:37 -0400911 * @dev: DRM device this bridge belongs to
Archit Taneja862e6862015-05-21 11:03:16 +0530912 * @encoder: encoder to which this bridge is connected
913 * @next: the next bridge in the encoder chain
Ajay Kumar3d3f8b12015-01-20 22:08:44 +0530914 * @of_node: device node pointer to the bridge
915 * @list: to keep track of all added bridges
Sean Paul3b336ec2013-08-14 16:47:37 -0400916 * @base: base mode object
917 * @funcs: control functions
918 * @driver_private: pointer to the bridge driver's internal context
919 */
920struct drm_bridge {
921 struct drm_device *dev;
Ajay Kumar3d3f8b12015-01-20 22:08:44 +0530922 struct drm_encoder *encoder;
Archit Taneja862e6862015-05-21 11:03:16 +0530923 struct drm_bridge *next;
Ajay Kumar3d3f8b12015-01-20 22:08:44 +0530924#ifdef CONFIG_OF
925 struct device_node *of_node;
926#endif
927 struct list_head list;
Sean Paul3b336ec2013-08-14 16:47:37 -0400928
929 const struct drm_bridge_funcs *funcs;
930 void *driver_private;
931};
932
933/**
Rob Clark08855fa2015-03-11 10:23:09 -0400934 * struct drm_atomic_state - the global state object for atomic updates
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200935 * @dev: parent DRM device
Rob Clarkd34f20d2014-12-18 16:01:56 -0500936 * @allow_modeset: allow full modeset
Daniel Vetterf02ad902015-01-22 16:36:23 +0100937 * @legacy_cursor_update: hint to enforce legacy cursor ioctl semantics
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200938 * @planes: pointer to array of plane pointers
939 * @plane_states: pointer to array of plane states pointers
940 * @crtcs: pointer to array of CRTC pointers
941 * @crtc_states: pointer to array of CRTC states pointers
Daniel Vetterf52b69f12014-11-19 18:38:08 +0100942 * @num_connector: size of the @connectors and @connector_states arrays
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200943 * @connectors: pointer to array of connector pointers
944 * @connector_states: pointer to array of connector states pointers
945 * @acquire_ctx: acquire context for this atomic modeset state update
946 */
947struct drm_atomic_state {
948 struct drm_device *dev;
Rob Clarkd34f20d2014-12-18 16:01:56 -0500949 bool allow_modeset : 1;
Daniel Vetterf02ad902015-01-22 16:36:23 +0100950 bool legacy_cursor_update : 1;
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200951 struct drm_plane **planes;
952 struct drm_plane_state **plane_states;
953 struct drm_crtc **crtcs;
954 struct drm_crtc_state **crtc_states;
Daniel Vetterf52b69f12014-11-19 18:38:08 +0100955 int num_connector;
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200956 struct drm_connector **connectors;
957 struct drm_connector_state **connector_states;
958
959 struct drm_modeset_acquire_ctx *acquire_ctx;
960};
961
962
963/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100964 * struct drm_mode_set - new values for a CRTC config change
Jesse Barnesef273512011-11-07 12:03:19 -0800965 * @fb: framebuffer to use for new config
966 * @crtc: CRTC whose configuration we're about to change
967 * @mode: mode timings to use
968 * @x: position of this CRTC relative to @fb
969 * @y: position of this CRTC relative to @fb
970 * @connectors: array of connectors to drive with this CRTC if possible
971 * @num_connectors: size of @connectors array
Dave Airlief453ba02008-11-07 14:05:41 -0800972 *
973 * Represents a single crtc the connectors that it drives with what mode
974 * and from which framebuffer it scans out from.
975 *
976 * This is used to set modes.
977 */
978struct drm_mode_set {
Dave Airlief453ba02008-11-07 14:05:41 -0800979 struct drm_framebuffer *fb;
980 struct drm_crtc *crtc;
981 struct drm_display_mode *mode;
982
983 uint32_t x;
984 uint32_t y;
985
986 struct drm_connector **connectors;
987 size_t num_connectors;
988};
989
990/**
Jesse Barnes550cebc2011-11-07 12:03:20 -0800991 * struct drm_mode_config_funcs - basic driver provided mode setting functions
992 * @fb_create: create a new framebuffer object
993 * @output_poll_changed: function to handle output configuration changes
John Hunter2b1193d2015-04-14 17:07:22 +0800994 * @atomic_check: check whether a given atomic state update is possible
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200995 * @atomic_commit: commit an atomic state update previously verified with
996 * atomic_check()
Maarten Lankhorst036ef572015-05-18 10:06:40 +0200997 * @atomic_state_alloc: allocate a new atomic state
998 * @atomic_state_clear: clear the atomic state
999 * @atomic_state_free: free the atomic state
Jesse Barnes550cebc2011-11-07 12:03:20 -08001000 *
1001 * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that
1002 * involve drivers.
Dave Airlief453ba02008-11-07 14:05:41 -08001003 */
1004struct drm_mode_config_funcs {
Jesse Barnes550cebc2011-11-07 12:03:20 -08001005 struct drm_framebuffer *(*fb_create)(struct drm_device *dev,
1006 struct drm_file *file_priv,
1007 struct drm_mode_fb_cmd2 *mode_cmd);
Dave Airlieeb1f8e42010-05-07 06:42:51 +00001008 void (*output_poll_changed)(struct drm_device *dev);
Daniel Vettercc4ceb42014-07-25 21:30:38 +02001009
1010 int (*atomic_check)(struct drm_device *dev,
1011 struct drm_atomic_state *a);
1012 int (*atomic_commit)(struct drm_device *dev,
1013 struct drm_atomic_state *a,
1014 bool async);
Maarten Lankhorst036ef572015-05-18 10:06:40 +02001015 struct drm_atomic_state *(*atomic_state_alloc)(struct drm_device *dev);
1016 void (*atomic_state_clear)(struct drm_atomic_state *state);
1017 void (*atomic_state_free)(struct drm_atomic_state *state);
Dave Airlief453ba02008-11-07 14:05:41 -08001018};
1019
Jesse Barnesc1aaca22011-11-07 12:03:21 -08001020/**
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001021 * struct drm_mode_config - Mode configuration control structure
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001022 * @mutex: mutex protecting KMS related lists and structures
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001023 * @connection_mutex: ww mutex protecting connector state and routing
1024 * @acquire_ctx: global implicit acquire context used by atomic drivers for
1025 * legacy ioctls
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001026 * @idr_mutex: mutex for KMS ID allocation and management
1027 * @crtc_idr: main KMS ID tracking object
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001028 * @fb_lock: mutex to protect fb state and lists
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001029 * @num_fb: number of fbs available
1030 * @fb_list: list of framebuffers available
1031 * @num_connector: number of connectors on this device
1032 * @connector_list: list of connector objects
1033 * @num_encoder: number of encoders on this device
1034 * @encoder_list: list of encoder objects
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001035 * @num_overlay_plane: number of overlay planes on this device
1036 * @num_total_plane: number of universal (i.e. with primary/curso) planes on this device
1037 * @plane_list: list of plane objects
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001038 * @num_crtc: number of CRTCs on this device
1039 * @crtc_list: list of CRTC objects
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001040 * @property_list: list of property objects
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001041 * @min_width: minimum pixel width on this device
1042 * @min_height: minimum pixel height on this device
1043 * @max_width: maximum pixel width on this device
1044 * @max_height: maximum pixel height on this device
1045 * @funcs: core driver provided mode setting functions
1046 * @fb_base: base address of the framebuffer
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001047 * @poll_enabled: track polling support for this device
1048 * @poll_running: track polling status for this device
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001049 * @output_poll_work: delayed work for polling in process context
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001050 * @property_blob_list: list of all the blob property objects
Daniel Stone8fb6e7a2015-04-20 19:22:54 +01001051 * @blob_lock: mutex for blob property allocation and management
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001052 * @*_property: core property tracking
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001053 * @preferred_depth: preferred RBG pixel depth, used by fb helpers
1054 * @prefer_shadow: hint to userspace to prefer shadow-fb rendering
1055 * @async_page_flip: does this device support async flips on the primary plane?
1056 * @cursor_width: hint to userspace for max cursor width
1057 * @cursor_height: hint to userspace for max cursor height
Dave Airlief453ba02008-11-07 14:05:41 -08001058 *
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001059 * Core mode resource tracking structure. All CRTC, encoders, and connectors
1060 * enumerated by the driver are added here, as are global properties. Some
1061 * global restrictions are also here, e.g. dimension restrictions.
Dave Airlief453ba02008-11-07 14:05:41 -08001062 */
1063struct drm_mode_config {
Jesse Barnesad2563c2009-01-19 17:21:45 +10001064 struct mutex mutex; /* protects configuration (mode lists etc.) */
Rob Clark51fd3712013-11-19 12:10:12 -05001065 struct drm_modeset_lock connection_mutex; /* protects connector->encoder and encoder->crtc links */
1066 struct drm_modeset_acquire_ctx *acquire_ctx; /* for legacy _lock_all() / _unlock_all() */
Jesse Barnesad2563c2009-01-19 17:21:45 +10001067 struct mutex idr_mutex; /* for IDR management */
Dave Airlief453ba02008-11-07 14:05:41 -08001068 struct idr crtc_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */
Dave Airlie138f9eb2014-10-20 16:17:17 +10001069 struct idr tile_idr; /* use this idr for all IDs, fb, crtc, connector, modes - just makes life easier */
Dave Airlief453ba02008-11-07 14:05:41 -08001070 /* this is limited to one for now */
Daniel Vetter4b096ac2012-12-10 21:19:18 +01001071
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001072 struct mutex fb_lock; /* proctects global and per-file fb lists */
Dave Airlief453ba02008-11-07 14:05:41 -08001073 int num_fb;
1074 struct list_head fb_list;
Daniel Vetter4b096ac2012-12-10 21:19:18 +01001075
Dave Airlief453ba02008-11-07 14:05:41 -08001076 int num_connector;
1077 struct list_head connector_list;
1078 int num_encoder;
1079 struct list_head encoder_list;
Matt Ropere27dde32014-04-01 15:22:30 -07001080
1081 /*
1082 * Track # of overlay planes separately from # of total planes. By
1083 * default we only advertise overlay planes to userspace; if userspace
1084 * sets the "universal plane" capability bit, we'll go ahead and
1085 * expose all planes.
1086 */
1087 int num_overlay_plane;
1088 int num_total_plane;
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001089 struct list_head plane_list;
Dave Airlief453ba02008-11-07 14:05:41 -08001090
1091 int num_crtc;
1092 struct list_head crtc_list;
1093
1094 struct list_head property_list;
1095
Dave Airlief453ba02008-11-07 14:05:41 -08001096 int min_width, min_height;
1097 int max_width, max_height;
Laurent Pincharte6ecefa2012-05-17 13:27:23 +02001098 const struct drm_mode_config_funcs *funcs;
Benjamin Herrenschmidtd883f7f2009-02-02 16:55:45 +11001099 resource_size_t fb_base;
Dave Airlief453ba02008-11-07 14:05:41 -08001100
Dave Airlieeb1f8e42010-05-07 06:42:51 +00001101 /* output poll support */
1102 bool poll_enabled;
Daniel Vetter905bc9f2012-10-23 18:23:36 +00001103 bool poll_running;
Daniel Vetter162b6a52015-01-21 08:45:21 +01001104 bool delayed_event;
Tejun Heo991ea752010-07-20 22:09:02 +02001105 struct delayed_work output_poll_work;
Dave Airlieeb1f8e42010-05-07 06:42:51 +00001106
Daniel Stone8fb6e7a2015-04-20 19:22:54 +01001107 struct mutex blob_lock;
1108
Dave Airlief453ba02008-11-07 14:05:41 -08001109 /* pointers to standard properties */
1110 struct list_head property_blob_list;
1111 struct drm_property *edid_property;
1112 struct drm_property *dpms_property;
Dave Airlie43aba7e2014-06-05 14:01:31 +10001113 struct drm_property *path_property;
Dave Airlie6f134d72014-10-20 16:30:50 +10001114 struct drm_property *tile_property;
Rob Clark9922ab52014-04-01 20:16:57 -04001115 struct drm_property *plane_type_property;
Sonika Jindal2a297cc2014-08-05 11:26:54 +05301116 struct drm_property *rotation_property;
Rob Clark6b4959f2014-12-18 16:01:53 -05001117 struct drm_property *prop_src_x;
1118 struct drm_property *prop_src_y;
1119 struct drm_property *prop_src_w;
1120 struct drm_property *prop_src_h;
1121 struct drm_property *prop_crtc_x;
1122 struct drm_property *prop_crtc_y;
1123 struct drm_property *prop_crtc_w;
1124 struct drm_property *prop_crtc_h;
1125 struct drm_property *prop_fb_id;
1126 struct drm_property *prop_crtc_id;
Daniel Vettereab3bbe2015-01-22 16:36:21 +01001127 struct drm_property *prop_active;
Daniel Stone955f3c32015-05-25 19:11:52 +01001128 struct drm_property *prop_mode_id;
Dave Airlief453ba02008-11-07 14:05:41 -08001129
1130 /* DVI-I properties */
1131 struct drm_property *dvi_i_subconnector_property;
1132 struct drm_property *dvi_i_select_subconnector_property;
1133
1134 /* TV properties */
1135 struct drm_property *tv_subconnector_property;
1136 struct drm_property *tv_select_subconnector_property;
1137 struct drm_property *tv_mode_property;
1138 struct drm_property *tv_left_margin_property;
1139 struct drm_property *tv_right_margin_property;
1140 struct drm_property *tv_top_margin_property;
1141 struct drm_property *tv_bottom_margin_property;
Francisco Jerezb6b79022009-08-02 04:19:20 +02001142 struct drm_property *tv_brightness_property;
1143 struct drm_property *tv_contrast_property;
1144 struct drm_property *tv_flicker_reduction_property;
Francisco Jereza75f0232009-08-12 02:30:10 +02001145 struct drm_property *tv_overscan_property;
1146 struct drm_property *tv_saturation_property;
1147 struct drm_property *tv_hue_property;
Dave Airlief453ba02008-11-07 14:05:41 -08001148
1149 /* Optional properties */
1150 struct drm_property *scaling_mode_property;
Vandana Kannanff587e42014-06-11 10:46:48 +05301151 struct drm_property *aspect_ratio_property;
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001152 struct drm_property *dirty_info_property;
Dave Airlie019d96c2011-09-29 16:20:42 +01001153
Dave Airlie5bb2bbf2014-11-10 10:18:15 +10001154 /* properties for virtual machine layout */
1155 struct drm_property *suggested_x_property;
1156 struct drm_property *suggested_y_property;
1157
Dave Airlie019d96c2011-09-29 16:20:42 +01001158 /* dumb ioctl parameters */
1159 uint32_t preferred_depth, prefer_shadow;
Keith Packard62f21042013-07-22 18:50:00 -07001160
1161 /* whether async page flip is supported or not */
1162 bool async_page_flip;
Alex Deucher8716ed42014-02-12 12:48:23 -05001163
Rob Clarke3eb3252015-02-05 14:41:52 +00001164 /* whether the driver supports fb modifiers */
1165 bool allow_fb_modifiers;
1166
Alex Deucher8716ed42014-02-12 12:48:23 -05001167 /* cursor size */
1168 uint32_t cursor_width, cursor_height;
Dave Airlief453ba02008-11-07 14:05:41 -08001169};
1170
Rob Clarkdd275952014-11-25 20:29:46 -05001171/**
1172 * drm_for_each_plane_mask - iterate over planes specified by bitmask
1173 * @plane: the loop cursor
1174 * @dev: the DRM device
1175 * @plane_mask: bitmask of plane indices
1176 *
1177 * Iterate over all planes specified by bitmask.
1178 */
1179#define drm_for_each_plane_mask(plane, dev, plane_mask) \
1180 list_for_each_entry((plane), &(dev)->mode_config.plane_list, head) \
1181 if ((plane_mask) & (1 << drm_plane_index(plane)))
1182
1183
Dave Airlief453ba02008-11-07 14:05:41 -08001184#define obj_to_crtc(x) container_of(x, struct drm_crtc, base)
1185#define obj_to_connector(x) container_of(x, struct drm_connector, base)
1186#define obj_to_encoder(x) container_of(x, struct drm_encoder, base)
1187#define obj_to_mode(x) container_of(x, struct drm_display_mode, base)
1188#define obj_to_fb(x) container_of(x, struct drm_framebuffer, base)
1189#define obj_to_property(x) container_of(x, struct drm_property, base)
1190#define obj_to_blob(x) container_of(x, struct drm_property_blob, base)
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001191#define obj_to_plane(x) container_of(x, struct drm_plane, base)
Dave Airlief453ba02008-11-07 14:05:41 -08001192
Sascha Hauer4a67d392012-02-06 10:58:17 +01001193struct drm_prop_enum_list {
1194 int type;
1195 char *name;
1196};
Dave Airlief453ba02008-11-07 14:05:41 -08001197
Matt Ropere13161a2014-04-01 15:22:38 -07001198extern int drm_crtc_init_with_planes(struct drm_device *dev,
1199 struct drm_crtc *crtc,
1200 struct drm_plane *primary,
Matt Roperfc1d3e42014-06-10 08:28:11 -07001201 struct drm_plane *cursor,
Matt Ropere13161a2014-04-01 15:22:38 -07001202 const struct drm_crtc_funcs *funcs);
Dave Airlief453ba02008-11-07 14:05:41 -08001203extern void drm_crtc_cleanup(struct drm_crtc *crtc);
Russell Kingdb5f7a62014-01-02 21:27:33 +00001204extern unsigned int drm_crtc_index(struct drm_crtc *crtc);
1205
1206/**
1207 * drm_crtc_mask - find the mask of a registered CRTC
1208 * @crtc: CRTC to find mask for
1209 *
1210 * Given a registered CRTC, return the mask bit of that CRTC for an
1211 * encoder's possible_crtcs field.
1212 */
1213static inline uint32_t drm_crtc_mask(struct drm_crtc *crtc)
1214{
1215 return 1 << drm_crtc_index(crtc);
1216}
Dave Airlief453ba02008-11-07 14:05:41 -08001217
Ilia Mirkinb21e3af2013-08-07 22:34:48 -04001218extern void drm_connector_ida_init(void);
1219extern void drm_connector_ida_destroy(void);
Ville Syrjälä6bfc56a2012-03-13 12:35:48 +02001220extern int drm_connector_init(struct drm_device *dev,
1221 struct drm_connector *connector,
1222 const struct drm_connector_funcs *funcs,
1223 int connector_type);
Thomas Wood34ea3d32014-05-29 16:57:41 +01001224int drm_connector_register(struct drm_connector *connector);
1225void drm_connector_unregister(struct drm_connector *connector);
Dave Airlief453ba02008-11-07 14:05:41 -08001226
1227extern void drm_connector_cleanup(struct drm_connector *connector);
Daniel Vetter10f637b2014-07-29 13:47:11 +02001228extern unsigned int drm_connector_index(struct drm_connector *connector);
Dave Airliecbc7e222012-02-20 14:16:40 +00001229/* helper to unplug all connectors from sysfs for device */
1230extern void drm_connector_unplug_all(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001231
Ajay Kumar3d3f8b12015-01-20 22:08:44 +05301232extern int drm_bridge_add(struct drm_bridge *bridge);
1233extern void drm_bridge_remove(struct drm_bridge *bridge);
1234extern struct drm_bridge *of_drm_find_bridge(struct device_node *np);
1235extern int drm_bridge_attach(struct drm_device *dev, struct drm_bridge *bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -04001236
Archit Taneja862e6862015-05-21 11:03:16 +05301237bool drm_bridge_mode_fixup(struct drm_bridge *bridge,
1238 const struct drm_display_mode *mode,
1239 struct drm_display_mode *adjusted_mode);
1240void drm_bridge_disable(struct drm_bridge *bridge);
1241void drm_bridge_post_disable(struct drm_bridge *bridge);
1242void drm_bridge_mode_set(struct drm_bridge *bridge,
1243 struct drm_display_mode *mode,
1244 struct drm_display_mode *adjusted_mode);
1245void drm_bridge_pre_enable(struct drm_bridge *bridge);
1246void drm_bridge_enable(struct drm_bridge *bridge);
1247
Ville Syrjälä6bfc56a2012-03-13 12:35:48 +02001248extern int drm_encoder_init(struct drm_device *dev,
1249 struct drm_encoder *encoder,
1250 const struct drm_encoder_funcs *funcs,
1251 int encoder_type);
Dave Airlief453ba02008-11-07 14:05:41 -08001252
Thierry Reding3d887362014-01-13 14:33:20 +01001253/**
1254 * drm_encoder_crtc_ok - can a given crtc drive a given encoder?
1255 * @encoder: encoder to test
1256 * @crtc: crtc to test
1257 *
1258 * Return false if @encoder can't be driven by @crtc, true otherwise.
1259 */
1260static inline bool drm_encoder_crtc_ok(struct drm_encoder *encoder,
1261 struct drm_crtc *crtc)
1262{
1263 return !!(encoder->possible_crtcs & drm_crtc_mask(crtc));
1264}
1265
Matt Roperdc415ff2014-04-01 15:22:36 -07001266extern int drm_universal_plane_init(struct drm_device *dev,
1267 struct drm_plane *plane,
1268 unsigned long possible_crtcs,
1269 const struct drm_plane_funcs *funcs,
1270 const uint32_t *formats,
Thierry Reding45e37432015-08-12 16:54:28 +02001271 unsigned int format_count,
Matt Roperdc415ff2014-04-01 15:22:36 -07001272 enum drm_plane_type type);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001273extern int drm_plane_init(struct drm_device *dev,
1274 struct drm_plane *plane,
1275 unsigned long possible_crtcs,
1276 const struct drm_plane_funcs *funcs,
Thierry Reding45e37432015-08-12 16:54:28 +02001277 const uint32_t *formats, unsigned int format_count,
Matt Roperdc415ff2014-04-01 15:22:36 -07001278 bool is_primary);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001279extern void drm_plane_cleanup(struct drm_plane *plane);
Daniel Vetter10f637b2014-07-29 13:47:11 +02001280extern unsigned int drm_plane_index(struct drm_plane *plane);
Chandra Konduruf81338a2015-04-09 17:36:21 -07001281extern struct drm_plane * drm_plane_from_index(struct drm_device *dev, int idx);
Ville Syrjälä9125e612013-06-03 16:10:40 +03001282extern void drm_plane_force_disable(struct drm_plane *plane);
Laurent Pinchartead86102015-03-05 02:25:43 +02001283extern int drm_plane_check_pixel_format(const struct drm_plane *plane,
1284 u32 format);
Gustavo Padovanecb7e162014-12-01 15:40:09 -08001285extern void drm_crtc_get_hv_timing(const struct drm_display_mode *mode,
1286 int *hdisplay, int *vdisplay);
Matt Roperaf936292014-04-01 15:22:34 -07001287extern int drm_crtc_check_viewport(const struct drm_crtc *crtc,
1288 int x, int y,
1289 const struct drm_display_mode *mode,
1290 const struct drm_framebuffer *fb);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001291
Dave Airlief453ba02008-11-07 14:05:41 -08001292extern void drm_encoder_cleanup(struct drm_encoder *encoder);
1293
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001294extern const char *drm_get_connector_status_name(enum drm_connector_status status);
Jesse Barnesac1bb362014-02-10 15:32:44 -08001295extern const char *drm_get_subpixel_order_name(enum subpixel_order order);
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001296extern const char *drm_get_dpms_name(int val);
1297extern const char *drm_get_dvi_i_subconnector_name(int val);
1298extern const char *drm_get_dvi_i_select_name(int val);
1299extern const char *drm_get_tv_subconnector_name(int val);
1300extern const char *drm_get_tv_select_name(int val);
Kristian Høgsbergea39f832009-02-12 14:37:56 -05001301extern void drm_fb_release(struct drm_file *file_priv);
Daniel Stonee2f5d2e2015-05-22 13:34:51 +01001302extern void drm_property_destroy_user_blobs(struct drm_device *dev,
1303 struct drm_file *file_priv);
Adam Jacksonfbff4692012-09-18 10:58:47 -04001304extern bool drm_probe_ddc(struct i2c_adapter *adapter);
Dave Airlief453ba02008-11-07 14:05:41 -08001305extern struct edid *drm_get_edid(struct drm_connector *connector,
1306 struct i2c_adapter *adapter);
Jani Nikula51f8da52013-09-27 15:08:27 +03001307extern struct edid *drm_edid_duplicate(const struct edid *edid);
Dave Airlief453ba02008-11-07 14:05:41 -08001308extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid);
Dave Airlief453ba02008-11-07 14:05:41 -08001309extern void drm_mode_config_init(struct drm_device *dev);
Chris Wilsoneb033552011-01-24 15:11:08 +00001310extern void drm_mode_config_reset(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001311extern void drm_mode_config_cleanup(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001312
Dave Airlie43aba7e2014-06-05 14:01:31 +10001313extern int drm_mode_connector_set_path_property(struct drm_connector *connector,
Thierry Reding12e6cec2014-05-13 11:38:36 +02001314 const char *path);
Dave Airlie6f134d72014-10-20 16:30:50 +10001315int drm_mode_connector_set_tile_property(struct drm_connector *connector);
Dave Airlief453ba02008-11-07 14:05:41 -08001316extern int drm_mode_connector_update_edid_property(struct drm_connector *connector,
Thierry Reding12e6cec2014-05-13 11:38:36 +02001317 const struct edid *edid);
Rob Clark5ea22f22014-05-30 11:34:01 -04001318
Boris Brezillonb5571e92014-07-22 12:09:10 +02001319extern int drm_display_info_set_bus_formats(struct drm_display_info *info,
1320 const u32 *formats,
1321 unsigned int num_formats);
1322
Rob Clark5ea22f22014-05-30 11:34:01 -04001323static inline bool drm_property_type_is(struct drm_property *property,
1324 uint32_t type)
1325{
1326 /* instanceof for props.. handles extended type vs original types: */
1327 if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
1328 return (property->flags & DRM_MODE_PROP_EXTENDED_TYPE) == type;
1329 return property->flags & type;
1330}
1331
1332static inline bool drm_property_type_valid(struct drm_property *property)
1333{
1334 if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
1335 return !(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
1336 return !!(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
1337}
1338
Paulo Zanonic5431882012-05-15 18:09:02 -03001339extern int drm_object_property_set_value(struct drm_mode_object *obj,
1340 struct drm_property *property,
1341 uint64_t val);
1342extern int drm_object_property_get_value(struct drm_mode_object *obj,
1343 struct drm_property *property,
1344 uint64_t *value);
Dave Airlief453ba02008-11-07 14:05:41 -08001345extern int drm_framebuffer_init(struct drm_device *dev,
1346 struct drm_framebuffer *fb,
1347 const struct drm_framebuffer_funcs *funcs);
Daniel Vetter786b99e2012-12-02 21:53:40 +01001348extern struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev,
1349 uint32_t id);
Rob Clarkf7eff602012-09-05 21:48:38 +00001350extern void drm_framebuffer_unreference(struct drm_framebuffer *fb);
1351extern void drm_framebuffer_reference(struct drm_framebuffer *fb);
1352extern void drm_framebuffer_remove(struct drm_framebuffer *fb);
Dave Airlief453ba02008-11-07 14:05:41 -08001353extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb);
Daniel Vetter36206362012-12-10 20:42:17 +01001354extern void drm_framebuffer_unregister_private(struct drm_framebuffer *fb);
Dave Airlief453ba02008-11-07 14:05:41 -08001355
Paulo Zanonic5431882012-05-15 18:09:02 -03001356extern void drm_object_attach_property(struct drm_mode_object *obj,
1357 struct drm_property *property,
1358 uint64_t init_val);
Dave Airlief453ba02008-11-07 14:05:41 -08001359extern struct drm_property *drm_property_create(struct drm_device *dev, int flags,
1360 const char *name, int num_values);
Sascha Hauer4a67d392012-02-06 10:58:17 +01001361extern struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
1362 const char *name,
1363 const struct drm_prop_enum_list *props,
1364 int num_values);
Rob Clark49e27542012-05-17 02:23:26 -06001365struct drm_property *drm_property_create_bitmask(struct drm_device *dev,
1366 int flags, const char *name,
1367 const struct drm_prop_enum_list *props,
Ville Syrjälä7689ffb2014-07-08 10:31:52 +05301368 int num_props,
1369 uint64_t supported_bits);
Sascha Hauerd9bc3c02012-02-06 10:58:18 +01001370struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
1371 const char *name,
1372 uint64_t min, uint64_t max);
Rob Clarkebc44cf2012-09-12 22:22:31 -05001373struct drm_property *drm_property_create_signed_range(struct drm_device *dev,
1374 int flags, const char *name,
1375 int64_t min, int64_t max);
Rob Clark98f75de2014-05-30 11:37:03 -04001376struct drm_property *drm_property_create_object(struct drm_device *dev,
1377 int flags, const char *name, uint32_t type);
Daniel Vetter960cd9d2015-01-21 08:47:38 +01001378struct drm_property *drm_property_create_bool(struct drm_device *dev, int flags,
1379 const char *name);
Daniel Stone6bcacf52015-04-20 19:22:55 +01001380struct drm_property_blob *drm_property_create_blob(struct drm_device *dev,
1381 size_t length,
1382 const void *data);
1383struct drm_property_blob *drm_property_lookup_blob(struct drm_device *dev,
1384 uint32_t id);
1385struct drm_property_blob *drm_property_reference_blob(struct drm_property_blob *blob);
1386void drm_property_unreference_blob(struct drm_property_blob *blob);
Dave Airlief453ba02008-11-07 14:05:41 -08001387extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property);
1388extern int drm_property_add_enum(struct drm_property *property, int index,
1389 uint64_t value, const char *name);
1390extern int drm_mode_create_dvi_i_properties(struct drm_device *dev);
Thierry Reding2f763312014-10-13 12:45:57 +02001391extern int drm_mode_create_tv_properties(struct drm_device *dev,
1392 unsigned int num_modes,
1393 char *modes[]);
Dave Airlief453ba02008-11-07 14:05:41 -08001394extern int drm_mode_create_scaling_mode_property(struct drm_device *dev);
Vandana Kannanff587e42014-06-11 10:46:48 +05301395extern int drm_mode_create_aspect_ratio_property(struct drm_device *dev);
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001396extern int drm_mode_create_dirty_info_property(struct drm_device *dev);
Dave Airlie5bb2bbf2014-11-10 10:18:15 +10001397extern int drm_mode_create_suggested_offset_properties(struct drm_device *dev);
Rob Clarkd34f20d2014-12-18 16:01:56 -05001398extern bool drm_property_change_valid_get(struct drm_property *property,
1399 uint64_t value, struct drm_mode_object **ref);
1400extern void drm_property_change_valid_put(struct drm_property *property,
1401 struct drm_mode_object *ref);
Dave Airlief453ba02008-11-07 14:05:41 -08001402
1403extern int drm_mode_connector_attach_encoder(struct drm_connector *connector,
1404 struct drm_encoder *encoder);
Sascha Hauer4cae5b82012-02-01 11:38:23 +01001405extern int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
Dave Airlief453ba02008-11-07 14:05:41 -08001406 int gamma_size);
Daniel Vetter7a9c9062009-09-15 22:57:31 +02001407extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
1408 uint32_t id, uint32_t type);
Rob Clark98f75de2014-05-30 11:37:03 -04001409
Dave Airlief453ba02008-11-07 14:05:41 -08001410/* IOCTLs */
1411extern int drm_mode_getresources(struct drm_device *dev,
1412 void *data, struct drm_file *file_priv);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001413extern int drm_mode_getplane_res(struct drm_device *dev, void *data,
1414 struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001415extern int drm_mode_getcrtc(struct drm_device *dev,
1416 void *data, struct drm_file *file_priv);
1417extern int drm_mode_getconnector(struct drm_device *dev,
1418 void *data, struct drm_file *file_priv);
Daniel Vetter2d13b672012-12-11 13:47:23 +01001419extern int drm_mode_set_config_internal(struct drm_mode_set *set);
Dave Airlief453ba02008-11-07 14:05:41 -08001420extern int drm_mode_setcrtc(struct drm_device *dev,
1421 void *data, struct drm_file *file_priv);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001422extern int drm_mode_getplane(struct drm_device *dev,
1423 void *data, struct drm_file *file_priv);
1424extern int drm_mode_setplane(struct drm_device *dev,
1425 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001426extern int drm_mode_cursor_ioctl(struct drm_device *dev,
1427 void *data, struct drm_file *file_priv);
Dave Airlie4c813d42013-06-20 11:48:52 +10001428extern int drm_mode_cursor2_ioctl(struct drm_device *dev,
1429 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001430extern int drm_mode_addfb(struct drm_device *dev,
1431 void *data, struct drm_file *file_priv);
Jesse Barnes308e5bc2011-11-14 14:51:28 -08001432extern int drm_mode_addfb2(struct drm_device *dev,
1433 void *data, struct drm_file *file_priv);
1434extern uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth);
Dave Airlief453ba02008-11-07 14:05:41 -08001435extern int drm_mode_rmfb(struct drm_device *dev,
1436 void *data, struct drm_file *file_priv);
1437extern int drm_mode_getfb(struct drm_device *dev,
1438 void *data, struct drm_file *file_priv);
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001439extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
1440 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001441
1442extern int drm_mode_getproperty_ioctl(struct drm_device *dev,
1443 void *data, struct drm_file *file_priv);
1444extern int drm_mode_getblob_ioctl(struct drm_device *dev,
1445 void *data, struct drm_file *file_priv);
Daniel Stonee2f5d2e2015-05-22 13:34:51 +01001446extern int drm_mode_createblob_ioctl(struct drm_device *dev,
1447 void *data, struct drm_file *file_priv);
1448extern int drm_mode_destroyblob_ioctl(struct drm_device *dev,
1449 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001450extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev,
1451 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001452extern int drm_mode_getencoder(struct drm_device *dev,
1453 void *data, struct drm_file *file_priv);
1454extern int drm_mode_gamma_get_ioctl(struct drm_device *dev,
1455 void *data, struct drm_file *file_priv);
1456extern int drm_mode_gamma_set_ioctl(struct drm_device *dev,
1457 void *data, struct drm_file *file_priv);
Thierry Reding18316c82012-12-20 15:41:44 +01001458extern u8 drm_match_cea_mode(const struct drm_display_mode *to_match);
Vandana Kannan0967e6a2014-04-01 16:26:59 +05301459extern enum hdmi_picture_aspect drm_get_cea_aspect_ratio(const u8 video_code);
Ma Lingf23c20c2009-03-26 19:26:23 +08001460extern bool drm_detect_hdmi_monitor(struct edid *edid);
Zhenyu Wang8fe97902010-09-19 14:27:28 +08001461extern bool drm_detect_monitor_audio(struct edid *edid);
Ville Syrjäläb1edd6a2013-01-17 16:31:30 +02001462extern bool drm_rgb_quant_range_selectable(struct edid *edid);
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -05001463extern int drm_mode_page_flip_ioctl(struct drm_device *dev,
1464 void *data, struct drm_file *file_priv);
Zhao Yakuif0fda0a2009-09-03 09:33:48 +08001465extern int drm_add_modes_noedid(struct drm_connector *connector,
1466 int hdisplay, int vdisplay);
Gerd Hoffmann3cf70da2013-10-11 10:01:08 +02001467extern void drm_set_preferred_mode(struct drm_connector *connector,
1468 int hpref, int vpref);
Alex Deucher3c537882010-02-05 04:21:19 -05001469
Thomas Reim051963d2011-07-29 14:28:57 +00001470extern int drm_edid_header_is_valid(const u8 *raw_edid);
Todd Previte6ba2bd32015-04-21 11:09:41 -07001471extern bool drm_edid_block_valid(u8 *raw_edid, int block, bool print_bad_edid,
1472 bool *edid_corrupt);
Alex Deucher3c537882010-02-05 04:21:19 -05001473extern bool drm_edid_is_valid(struct edid *edid);
Dave Airlie138f9eb2014-10-20 16:17:17 +10001474
1475extern struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev,
1476 char topology[8]);
1477extern struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev,
1478 char topology[8]);
1479extern void drm_mode_put_tile_group(struct drm_device *dev,
1480 struct drm_tile_group *tg);
Dave Airlie1d42bbc2010-05-07 05:02:30 +00001481struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev,
Adam Jacksonf6e252b2012-04-13 16:33:31 -04001482 int hsize, int vsize, int fresh,
1483 bool rb);
Dave Airlieff72145b2011-02-07 12:16:14 +10001484
1485extern int drm_mode_create_dumb_ioctl(struct drm_device *dev,
1486 void *data, struct drm_file *file_priv);
1487extern int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
1488 void *data, struct drm_file *file_priv);
1489extern int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
1490 void *data, struct drm_file *file_priv);
Paulo Zanonic5431882012-05-15 18:09:02 -03001491extern int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
1492 struct drm_file *file_priv);
1493extern int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
1494 struct drm_file *file_priv);
Thomas Wood3a5f87c2014-08-20 14:45:00 +01001495extern int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
1496 struct drm_property *property,
1497 uint64_t value);
Rob Clarkd34f20d2014-12-18 16:01:56 -05001498extern int drm_mode_atomic_ioctl(struct drm_device *dev,
1499 void *data, struct drm_file *file_priv);
Dave Airlie248dbc22011-11-29 20:02:54 +00001500
1501extern void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
1502 int *bpp);
Ville Syrjälä141670e2012-04-05 21:35:15 +03001503extern int drm_format_num_planes(uint32_t format);
Ville Syrjälä5a86bd52012-04-05 21:35:16 +03001504extern int drm_format_plane_cpp(uint32_t format, int plane);
Ville Syrjälä01b68b02012-04-05 21:35:17 +03001505extern int drm_format_horz_chroma_subsampling(uint32_t format);
1506extern int drm_format_vert_chroma_subsampling(uint32_t format);
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001507extern const char *drm_get_format_name(uint32_t format);
Ville Syrjäläc1df5f32014-07-08 10:31:53 +05301508extern struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
1509 unsigned int supported_rotations);
Ville Syrjälä3c9855f2014-07-08 10:31:56 +05301510extern unsigned int drm_rotation_simplify(unsigned int rotation,
1511 unsigned int supported_rotations);
Ville Syrjälä141670e2012-04-05 21:35:15 +03001512
Russell King96f60e32012-08-15 13:59:49 +01001513/* Helpers */
Rob Clarka2b34e22013-10-05 16:36:52 -04001514
1515static inline struct drm_plane *drm_plane_find(struct drm_device *dev,
1516 uint32_t id)
1517{
1518 struct drm_mode_object *mo;
1519 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PLANE);
1520 return mo ? obj_to_plane(mo) : NULL;
1521}
1522
Russell King96f60e32012-08-15 13:59:49 +01001523static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev,
1524 uint32_t id)
1525{
1526 struct drm_mode_object *mo;
1527 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CRTC);
1528 return mo ? obj_to_crtc(mo) : NULL;
1529}
1530
1531static inline struct drm_encoder *drm_encoder_find(struct drm_device *dev,
1532 uint32_t id)
1533{
1534 struct drm_mode_object *mo;
1535 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_ENCODER);
1536 return mo ? obj_to_encoder(mo) : NULL;
1537}
1538
Rob Clarka2b34e22013-10-05 16:36:52 -04001539static inline struct drm_connector *drm_connector_find(struct drm_device *dev,
1540 uint32_t id)
1541{
1542 struct drm_mode_object *mo;
1543 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CONNECTOR);
1544 return mo ? obj_to_connector(mo) : NULL;
1545}
1546
1547static inline struct drm_property *drm_property_find(struct drm_device *dev,
1548 uint32_t id)
1549{
1550 struct drm_mode_object *mo;
1551 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PROPERTY);
1552 return mo ? obj_to_property(mo) : NULL;
1553}
1554
Matt Ropere27dde32014-04-01 15:22:30 -07001555/* Plane list iterator for legacy (overlay only) planes. */
Daniel Vetter4ea50e92015-07-09 23:44:24 +02001556#define drm_for_each_legacy_plane(plane, dev) \
1557 list_for_each_entry(plane, &(dev)->mode_config.plane_list, head) \
Matt Ropere27dde32014-04-01 15:22:30 -07001558 if (plane->type == DRM_PLANE_TYPE_OVERLAY)
1559
Daniel Vetter6295d602015-07-09 23:44:25 +02001560#define drm_for_each_plane(plane, dev) \
1561 list_for_each_entry(plane, &(dev)->mode_config.plane_list, head)
1562
1563#define drm_for_each_crtc(crtc, dev) \
1564 list_for_each_entry(crtc, &(dev)->mode_config.crtc_list, head)
1565
Daniel Vetter7a3f3d62015-07-09 23:44:28 +02001566static inline void
1567assert_drm_connector_list_read_locked(struct drm_mode_config *mode_config)
1568{
Daniel Vettercff20ba2015-07-09 23:44:33 +02001569 /*
1570 * The connector hotadd/remove code currently grabs both locks when
1571 * updating lists. Hence readers need only hold either of them to be
1572 * safe and the check amounts to
1573 *
1574 * WARN_ON(not_holding(A) && not_holding(B)).
1575 */
1576 WARN_ON(!mutex_is_locked(&mode_config->mutex) &&
1577 !drm_modeset_is_locked(&mode_config->connection_mutex));
Daniel Vetter7a3f3d62015-07-09 23:44:28 +02001578}
1579
Daniel Vetter6295d602015-07-09 23:44:25 +02001580#define drm_for_each_connector(connector, dev) \
Daniel Vetter7a3f3d62015-07-09 23:44:28 +02001581 for (assert_drm_connector_list_read_locked(&(dev)->mode_config), \
1582 connector = list_first_entry(&(dev)->mode_config.connector_list, \
1583 struct drm_connector, head); \
1584 &connector->head != (&(dev)->mode_config.connector_list); \
1585 connector = list_next_entry(connector, head))
Daniel Vetter6295d602015-07-09 23:44:25 +02001586
1587#define drm_for_each_encoder(encoder, dev) \
1588 list_for_each_entry(encoder, &(dev)->mode_config.encoder_list, head)
1589
1590#define drm_for_each_fb(fb, dev) \
Daniel Vetter4676ba02015-07-09 23:44:30 +02001591 for (WARN_ON(!mutex_is_locked(&(dev)->mode_config.fb_lock)), \
1592 fb = list_first_entry(&(dev)->mode_config.fb_list, \
1593 struct drm_framebuffer, head); \
1594 &fb->head != (&(dev)->mode_config.fb_list); \
1595 fb = list_next_entry(fb, head))
Daniel Vetter6295d602015-07-09 23:44:25 +02001596
Dave Airlief453ba02008-11-07 14:05:41 -08001597#endif /* __DRM_CRTC_H__ */