blob: 57ca8cc383a615344498202384b1b814911bc766 [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 Barnesebec9a7b2011-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)
Daniel Vetter623369e2014-09-16 17:50:47 +0200258 * @mode_changed: for use by helpers and drivers when computing state updates
Daniel Vettereab3bbe2015-01-22 16:36:21 +0100259 * @active_changed: for use by helpers and drivers when computing state updates
Rob Clark6ddd3882014-11-21 15:28:31 -0500260 * @plane_mask: bitmask of (1 << drm_plane_index(plane)) of attached planes
Daniel Vetter623369e2014-09-16 17:50:47 +0200261 * @last_vblank_count: for helpers and drivers to capture the vblank of the
262 * update to ensure framebuffer cleanup isn't done too early
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100263 * @planes_changed: for use by helpers and drivers when computing state updates
Daniel Vetter2f324b42014-10-29 11:13:47 +0100264 * @adjusted_mode: for use by helpers and drivers to compute adjusted mode timings
Daniel Vetter144ecb92014-10-27 20:28:44 +0100265 * @mode: current mode timings
266 * @event: optional pointer to a DRM event to signal upon completion of the
267 * state update
268 * @state: backpointer to global drm_atomic_state
Daniel Vetterd9b13622014-11-26 16:57:41 +0100269 *
270 * Note that the distinction between @enable and @active is rather subtile:
271 * Flipping @active while @enable is set without changing anything else may
272 * never return in a failure from the ->atomic_check callback. Userspace assumes
273 * that a DPMS On will always succeed. In other words: @enable controls resource
274 * assignment, @active controls the actual hardware state.
Daniel Vetter144ecb92014-10-27 20:28:44 +0100275 */
276struct drm_crtc_state {
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100277 struct drm_crtc *crtc;
278
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200279 bool enable;
Daniel Vetterd9b13622014-11-26 16:57:41 +0100280 bool active;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100281
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100282 /* computed state bits used by helpers and drivers */
283 bool planes_changed : 1;
Daniel Vetter623369e2014-09-16 17:50:47 +0200284 bool mode_changed : 1;
Daniel Vettereab3bbe2015-01-22 16:36:21 +0100285 bool active_changed : 1;
Daniel Vetter623369e2014-09-16 17:50:47 +0200286
Rob Clark6ddd3882014-11-21 15:28:31 -0500287 /* attached planes bitmask:
288 * WARNING: transitional helpers do not maintain plane_mask so
289 * drivers not converted over to atomic helpers should not rely
290 * on plane_mask being accurate!
291 */
292 u32 plane_mask;
293
Daniel Vetter623369e2014-09-16 17:50:47 +0200294 /* last_vblank_count: for vblank waits before cleanup */
295 u32 last_vblank_count;
Daniel Vetterc2fcd272014-11-05 00:14:14 +0100296
Daniel Vetter2f324b42014-10-29 11:13:47 +0100297 /* adjusted_mode: for use by helpers and drivers */
298 struct drm_display_mode adjusted_mode;
299
Daniel Vetter144ecb92014-10-27 20:28:44 +0100300 struct drm_display_mode mode;
301
Daniel Stone99cf4a22015-05-25 19:11:51 +0100302 /* blob property to expose current mode to atomic userspace */
303 struct drm_property_blob *mode_blob;
304
Daniel Vetter144ecb92014-10-27 20:28:44 +0100305 struct drm_pending_vblank_event *event;
306
307 struct drm_atomic_state *state;
308};
Dave Airlief453ba02008-11-07 14:05:41 -0800309
310/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100311 * struct drm_crtc_funcs - control CRTCs for a given device
Dave Airlief453ba02008-11-07 14:05:41 -0800312 * @save: save CRTC state
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200313 * @restore: restore CRTC state
Christopher Harvey715f59c2013-04-05 15:28:32 +0000314 * @reset: reset CRTC after state has been invalidated (e.g. resume)
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200315 * @cursor_set: setup the cursor
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100316 * @cursor_set2: setup the cursor with hotspot, superseeds @cursor_set if set
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200317 * @cursor_move: move the cursor
Dave Airlief453ba02008-11-07 14:05:41 -0800318 * @gamma_set: specify color ramp for CRTC
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300319 * @destroy: deinit and free object
320 * @set_property: called when a property is changed
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200321 * @set_config: apply a new CRTC configuration
322 * @page_flip: initiate a page flip
Daniel Vetter144ecb92014-10-27 20:28:44 +0100323 * @atomic_duplicate_state: duplicate the atomic state for this CRTC
324 * @atomic_destroy_state: destroy an atomic state for this CRTC
325 * @atomic_set_property: set a property on an atomic state for this CRTC
Rob Clark40ecc692014-12-18 16:01:46 -0500326 * (do not call directly, use drm_atomic_crtc_set_property())
Rob Clarkac9c9252014-12-18 16:01:47 -0500327 * @atomic_get_property: get a property on an atomic state for this CRTC
328 * (do not call directly, use drm_atomic_crtc_get_property())
Dave Airlief453ba02008-11-07 14:05:41 -0800329 *
330 * The drm_crtc_funcs structure is the central CRTC management structure
331 * in the DRM. Each CRTC controls one or more connectors (note that the name
332 * CRTC is simply historical, a CRTC may control LVDS, VGA, DVI, TV out, etc.
333 * connectors, not just CRTs).
334 *
335 * Each driver is responsible for filling out this structure at startup time,
336 * in addition to providing other modesetting features, like i2c and DDC
337 * bus accessors.
338 */
339struct drm_crtc_funcs {
340 /* Save CRTC state */
341 void (*save)(struct drm_crtc *crtc); /* suspend? */
342 /* Restore CRTC state */
343 void (*restore)(struct drm_crtc *crtc); /* resume? */
Chris Wilsoneb033552011-01-24 15:11:08 +0000344 /* Reset CRTC state */
345 void (*reset)(struct drm_crtc *crtc);
Dave Airlief453ba02008-11-07 14:05:41 -0800346
347 /* cursor controls */
348 int (*cursor_set)(struct drm_crtc *crtc, struct drm_file *file_priv,
349 uint32_t handle, uint32_t width, uint32_t height);
Dave Airlie4c813d42013-06-20 11:48:52 +1000350 int (*cursor_set2)(struct drm_crtc *crtc, struct drm_file *file_priv,
351 uint32_t handle, uint32_t width, uint32_t height,
352 int32_t hot_x, int32_t hot_y);
Dave Airlief453ba02008-11-07 14:05:41 -0800353 int (*cursor_move)(struct drm_crtc *crtc, int x, int y);
354
355 /* Set gamma on the CRTC */
356 void (*gamma_set)(struct drm_crtc *crtc, u16 *r, u16 *g, u16 *b,
James Simmons72034252010-08-03 01:33:19 +0100357 uint32_t start, uint32_t size);
Dave Airlief453ba02008-11-07 14:05:41 -0800358 /* Object destroy routine */
359 void (*destroy)(struct drm_crtc *crtc);
360
361 int (*set_config)(struct drm_mode_set *set);
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -0500362
363 /*
364 * Flip to the given framebuffer. This implements the page
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300365 * flip ioctl described in drm_mode.h, specifically, the
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -0500366 * implementation must return immediately and block all
367 * rendering to the current fb until the flip has completed.
368 * If userspace set the event flag in the ioctl, the event
369 * argument will point to an event to send back when the flip
370 * completes, otherwise it will be NULL.
371 */
372 int (*page_flip)(struct drm_crtc *crtc,
373 struct drm_framebuffer *fb,
Keith Packarded8d1972013-07-22 18:49:58 -0700374 struct drm_pending_vblank_event *event,
375 uint32_t flags);
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300376
377 int (*set_property)(struct drm_crtc *crtc,
378 struct drm_property *property, uint64_t val);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100379
380 /* atomic update handling */
381 struct drm_crtc_state *(*atomic_duplicate_state)(struct drm_crtc *crtc);
382 void (*atomic_destroy_state)(struct drm_crtc *crtc,
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200383 struct drm_crtc_state *state);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100384 int (*atomic_set_property)(struct drm_crtc *crtc,
385 struct drm_crtc_state *state,
386 struct drm_property *property,
387 uint64_t val);
Rob Clarkac9c9252014-12-18 16:01:47 -0500388 int (*atomic_get_property)(struct drm_crtc *crtc,
389 const struct drm_crtc_state *state,
390 struct drm_property *property,
391 uint64_t *val);
Dave Airlief453ba02008-11-07 14:05:41 -0800392};
393
394/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100395 * struct drm_crtc - central CRTC control structure
Jesse Barnes77491632011-11-07 12:03:14 -0800396 * @dev: parent DRM device
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100397 * @port: OF node used by drm_of_find_possible_crtcs()
Jesse Barnes77491632011-11-07 12:03:14 -0800398 * @head: list management
Rob Clark51fd3712013-11-19 12:10:12 -0500399 * @mutex: per-CRTC locking
Jesse Barnes77491632011-11-07 12:03:14 -0800400 * @base: base KMS object for ID tracking etc.
Matt Ropere13161a2014-04-01 15:22:38 -0700401 * @primary: primary plane for this CRTC
402 * @cursor: cursor plane for this CRTC
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100403 * @cursor_x: current x position of the cursor, used for universal cursor planes
404 * @cursor_y: current y position of the cursor, used for universal cursor planes
Dave Airlief453ba02008-11-07 14:05:41 -0800405 * @enabled: is this CRTC enabled?
Jesse Barnes77491632011-11-07 12:03:14 -0800406 * @mode: current mode timings
407 * @hwmode: mode timings as programmed to hw regs
Rob Clark7c80e122012-09-04 16:35:56 +0000408 * @invert_dimensions: for purposes of error checking crtc vs fb sizes,
409 * invert the width/height of the crtc. This is used if the driver
410 * is performing 90 or 270 degree rotated scanout
Dave Airlief453ba02008-11-07 14:05:41 -0800411 * @x: x position on screen
412 * @y: y position on screen
Dave Airlief453ba02008-11-07 14:05:41 -0800413 * @funcs: CRTC control functions
Jesse Barnes77491632011-11-07 12:03:14 -0800414 * @gamma_size: size of gamma ramp
415 * @gamma_store: gamma ramp values
416 * @framedur_ns: precise frame timing
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100417 * @linedur_ns: precise line timing
Jesse Barnes77491632011-11-07 12:03:14 -0800418 * @pixeldur_ns: precise pixel timing
419 * @helper_private: mid-layer private data
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300420 * @properties: property tracking for this CRTC
Daniel Vetter144ecb92014-10-27 20:28:44 +0100421 * @state: current atomic state for this CRTC
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100422 * @acquire_ctx: per-CRTC implicit acquire context used by atomic drivers for
423 * legacy ioctls
Dave Airlief453ba02008-11-07 14:05:41 -0800424 *
425 * Each CRTC may have one or more connectors associated with it. This structure
426 * allows the CRTC to be controlled.
427 */
428struct drm_crtc {
429 struct drm_device *dev;
Russell King7e435aa2014-06-15 11:07:12 +0100430 struct device_node *port;
Dave Airlief453ba02008-11-07 14:05:41 -0800431 struct list_head head;
432
Daniel Vetter3bf04012014-10-27 16:54:27 +0100433 /*
Daniel Vetter29494c12012-12-02 02:18:25 +0100434 * crtc mutex
435 *
436 * This provides a read lock for the overall crtc state (mode, dpms
437 * state, ...) and a write lock for everything which can be update
438 * without a full modeset (fb, cursor data, ...)
439 */
Rob Clark51fd3712013-11-19 12:10:12 -0500440 struct drm_modeset_lock mutex;
Daniel Vetter29494c12012-12-02 02:18:25 +0100441
Dave Airlief453ba02008-11-07 14:05:41 -0800442 struct drm_mode_object base;
443
Matt Ropere13161a2014-04-01 15:22:38 -0700444 /* primary and cursor planes for CRTC */
445 struct drm_plane *primary;
446 struct drm_plane *cursor;
447
Matt Roper161d0dc2014-06-10 08:28:10 -0700448 /* position of cursor plane on crtc */
449 int cursor_x;
450 int cursor_y;
451
Dave Airlief453ba02008-11-07 14:05:41 -0800452 bool enabled;
453
Mario Kleiner27641c32010-10-23 04:20:23 +0200454 /* Requested mode from modesetting. */
Dave Airlief453ba02008-11-07 14:05:41 -0800455 struct drm_display_mode mode;
456
Mario Kleiner27641c32010-10-23 04:20:23 +0200457 /* Programmed mode in hw, after adjustments for encoders,
458 * crtc, panel scaling etc. Needed for timestamping etc.
459 */
460 struct drm_display_mode hwmode;
461
Rob Clark7c80e122012-09-04 16:35:56 +0000462 bool invert_dimensions;
463
Dave Airlief453ba02008-11-07 14:05:41 -0800464 int x, y;
Dave Airlief453ba02008-11-07 14:05:41 -0800465 const struct drm_crtc_funcs *funcs;
466
467 /* CRTC gamma size for reporting to userspace */
468 uint32_t gamma_size;
469 uint16_t *gamma_store;
470
Mario Kleiner27641c32010-10-23 04:20:23 +0200471 /* Constants needed for precise vblank and swap timestamping. */
Ville Syrjälä3c184f62013-10-26 17:38:52 +0300472 int framedur_ns, linedur_ns, pixeldur_ns;
Mario Kleiner27641c32010-10-23 04:20:23 +0200473
Dave Airlief453ba02008-11-07 14:05:41 -0800474 /* if you are using the helper */
Jani Nikula9a436ee2015-04-13 11:21:42 +0300475 const void *helper_private;
Paulo Zanonibffd9de02012-05-15 18:09:05 -0300476
477 struct drm_object_properties properties;
Daniel Vetterd059f652014-07-25 18:07:40 +0200478
Daniel Vetter144ecb92014-10-27 20:28:44 +0100479 struct drm_crtc_state *state;
480
Daniel Vetterd059f652014-07-25 18:07:40 +0200481 /*
482 * For legacy crtc ioctls so that atomic drivers can get at the locking
483 * acquire context.
484 */
485 struct drm_modeset_acquire_ctx *acquire_ctx;
Dave Airlief453ba02008-11-07 14:05:41 -0800486};
487
Daniel Vetter144ecb92014-10-27 20:28:44 +0100488/**
489 * struct drm_connector_state - mutable connector state
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100490 * @connector: backpointer to the connector
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200491 * @crtc: CRTC to connect connector to, NULL if disabled
Daniel Vetter623369e2014-09-16 17:50:47 +0200492 * @best_encoder: can be used by helpers and drivers to select the encoder
Daniel Vetter144ecb92014-10-27 20:28:44 +0100493 * @state: backpointer to global drm_atomic_state
494 */
495struct drm_connector_state {
Daniel Vetter07cc0ef2014-11-27 15:49:39 +0100496 struct drm_connector *connector;
497
Rob Clark6ddd3882014-11-21 15:28:31 -0500498 struct drm_crtc *crtc; /* do not write directly, use drm_atomic_set_crtc_for_connector() */
Daniel Vetter144ecb92014-10-27 20:28:44 +0100499
Daniel Vetter623369e2014-09-16 17:50:47 +0200500 struct drm_encoder *best_encoder;
501
Daniel Vetter144ecb92014-10-27 20:28:44 +0100502 struct drm_atomic_state *state;
503};
Dave Airlief453ba02008-11-07 14:05:41 -0800504
505/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100506 * struct drm_connector_funcs - control connectors on a given device
Thierry Reding261ea742014-12-17 16:41:40 +0100507 * @dpms: set power state
Dave Airlief453ba02008-11-07 14:05:41 -0800508 * @save: save connector state
509 * @restore: restore connector state
Christopher Harvey13bcf012013-03-07 10:42:25 -0500510 * @reset: reset connector after state has been invalidated (e.g. resume)
Dave Airlief453ba02008-11-07 14:05:41 -0800511 * @detect: is this connector active?
Laurent Pinchart3b02ab82012-05-17 13:27:20 +0200512 * @fill_modes: fill mode list for this connector
Christopher Harvey13bcf012013-03-07 10:42:25 -0500513 * @set_property: property for this connector may need an update
Dave Airlief453ba02008-11-07 14:05:41 -0800514 * @destroy: make object go away
Christopher Harvey13bcf012013-03-07 10:42:25 -0500515 * @force: notify the driver that the connector is forced on
Daniel Vetter144ecb92014-10-27 20:28:44 +0100516 * @atomic_duplicate_state: duplicate the atomic state for this connector
517 * @atomic_destroy_state: destroy an atomic state for this connector
518 * @atomic_set_property: set a property on an atomic state for this connector
Rob Clark40ecc692014-12-18 16:01:46 -0500519 * (do not call directly, use drm_atomic_connector_set_property())
Rob Clarkac9c9252014-12-18 16:01:47 -0500520 * @atomic_get_property: get a property on an atomic state for this connector
521 * (do not call directly, use drm_atomic_connector_get_property())
Daniel Vetter144ecb92014-10-27 20:28:44 +0100522 *
Dave Airlief453ba02008-11-07 14:05:41 -0800523 * Each CRTC may have one or more connectors attached to it. The functions
524 * below allow the core DRM code to control connectors, enumerate available modes,
525 * etc.
526 */
527struct drm_connector_funcs {
528 void (*dpms)(struct drm_connector *connector, int mode);
529 void (*save)(struct drm_connector *connector);
530 void (*restore)(struct drm_connector *connector);
Chris Wilsoneb033552011-01-24 15:11:08 +0000531 void (*reset)(struct drm_connector *connector);
Chris Wilson930a9e22010-09-14 11:07:23 +0100532
533 /* Check to see if anything is attached to the connector.
534 * @force is set to false whilst polling, true when checking the
535 * connector due to user request. @force can be used by the driver
536 * to avoid expensive, destructive operations during automated
537 * probing.
538 */
Chris Wilson7b334fc2010-09-09 23:51:02 +0100539 enum drm_connector_status (*detect)(struct drm_connector *connector,
Chris Wilson930a9e22010-09-14 11:07:23 +0100540 bool force);
Jesse Barnes40a518d2009-01-12 12:05:32 -0800541 int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height);
Dave Airlief453ba02008-11-07 14:05:41 -0800542 int (*set_property)(struct drm_connector *connector, struct drm_property *property,
543 uint64_t val);
544 void (*destroy)(struct drm_connector *connector);
Dave Airlied50ba252009-09-23 14:44:08 +1000545 void (*force)(struct drm_connector *connector);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100546
547 /* atomic update handling */
548 struct drm_connector_state *(*atomic_duplicate_state)(struct drm_connector *connector);
549 void (*atomic_destroy_state)(struct drm_connector *connector,
Daniel Vettercc4ceb42014-07-25 21:30:38 +0200550 struct drm_connector_state *state);
Daniel Vetter144ecb92014-10-27 20:28:44 +0100551 int (*atomic_set_property)(struct drm_connector *connector,
552 struct drm_connector_state *state,
553 struct drm_property *property,
554 uint64_t val);
Rob Clarkac9c9252014-12-18 16:01:47 -0500555 int (*atomic_get_property)(struct drm_connector *connector,
556 const struct drm_connector_state *state,
557 struct drm_property *property,
558 uint64_t *val);
Dave Airlief453ba02008-11-07 14:05:41 -0800559};
560
Jesse Barnes6c3db922011-11-07 12:03:16 -0800561/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100562 * struct drm_encoder_funcs - encoder controls
Jesse Barnes6c3db922011-11-07 12:03:16 -0800563 * @reset: reset state (e.g. at init or resume time)
564 * @destroy: cleanup and free associated data
565 *
566 * Encoders sit between CRTCs and connectors.
567 */
Dave Airlief453ba02008-11-07 14:05:41 -0800568struct drm_encoder_funcs {
Chris Wilsoneb033552011-01-24 15:11:08 +0000569 void (*reset)(struct drm_encoder *encoder);
Dave Airlief453ba02008-11-07 14:05:41 -0800570 void (*destroy)(struct drm_encoder *encoder);
571};
572
Ben Skeggsafe887d2012-01-12 16:00:57 +1000573#define DRM_CONNECTOR_MAX_ENCODER 3
Dave Airlief453ba02008-11-07 14:05:41 -0800574
575/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100576 * struct drm_encoder - central DRM encoder structure
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800577 * @dev: parent DRM device
578 * @head: list management
579 * @base: base KMS object
Jani Nikulae5748942014-05-14 16:58:20 +0300580 * @name: encoder name
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800581 * @encoder_type: one of the %DRM_MODE_ENCODER_<foo> types in drm_mode.h
582 * @possible_crtcs: bitmask of potential CRTC bindings
583 * @possible_clones: bitmask of potential sibling encoders for cloning
584 * @crtc: currently bound CRTC
Sean Paul3b336ec2013-08-14 16:47:37 -0400585 * @bridge: bridge associated to the encoder
Jesse Barnesdb3e4492011-11-07 12:03:17 -0800586 * @funcs: control functions
587 * @helper_private: mid-layer private data
588 *
589 * CRTCs drive pixels to encoders, which convert them into signals
590 * appropriate for a given connector or set of connectors.
Dave Airlief453ba02008-11-07 14:05:41 -0800591 */
592struct drm_encoder {
593 struct drm_device *dev;
594 struct list_head head;
595
596 struct drm_mode_object base;
Jani Nikulae5748942014-05-14 16:58:20 +0300597 char *name;
Dave Airlief453ba02008-11-07 14:05:41 -0800598 int encoder_type;
599 uint32_t possible_crtcs;
600 uint32_t possible_clones;
601
602 struct drm_crtc *crtc;
Sean Paul3b336ec2013-08-14 16:47:37 -0400603 struct drm_bridge *bridge;
Dave Airlief453ba02008-11-07 14:05:41 -0800604 const struct drm_encoder_funcs *funcs;
Jani Nikula9a436ee2015-04-13 11:21:42 +0300605 const void *helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800606};
607
Dave Airlieeb1f8e42010-05-07 06:42:51 +0000608/* should we poll this connector for connects and disconnects */
609/* hot plug detectable */
610#define DRM_CONNECTOR_POLL_HPD (1 << 0)
611/* poll for connections */
612#define DRM_CONNECTOR_POLL_CONNECT (1 << 1)
613/* can cleanly poll for disconnections without flickering the screen */
614/* DACs should rarely do this without a lot of testing */
615#define DRM_CONNECTOR_POLL_DISCONNECT (1 << 2)
616
Wu Fengguang76adaa342011-09-05 14:23:20 +0800617#define MAX_ELD_BYTES 128
618
Dave Airlief453ba02008-11-07 14:05:41 -0800619/**
Daniel Vetter3bf04012014-10-27 16:54:27 +0100620 * struct drm_connector - central DRM connector control structure
Jesse Barnes72252542011-11-07 12:03:18 -0800621 * @dev: parent DRM device
622 * @kdev: kernel device for sysfs attributes
623 * @attr: sysfs attributes
624 * @head: list management
625 * @base: base KMS object
Jani Nikula2abdd312014-05-14 16:58:19 +0300626 * @name: connector name
Jesse Barnes72252542011-11-07 12:03:18 -0800627 * @connector_type: one of the %DRM_MODE_CONNECTOR_<foo> types from drm_mode.h
628 * @connector_type_id: index into connector type enum
Dave Airlief453ba02008-11-07 14:05:41 -0800629 * @interlace_allowed: can this connector handle interlaced modes?
630 * @doublescan_allowed: can this connector handle doublescan?
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100631 * @stereo_allowed: can this connector handle stereo modes?
Jesse Barnes72252542011-11-07 12:03:18 -0800632 * @modes: modes available on this connector (from fill_modes() + user)
633 * @status: one of the drm_connector_status enums (connected, not, or unknown)
634 * @probed_modes: list of modes derived directly from the display
635 * @display_info: information about attached display (e.g. from EDID)
Dave Airlief453ba02008-11-07 14:05:41 -0800636 * @funcs: connector control functions
Jesse Barnes72252542011-11-07 12:03:18 -0800637 * @edid_blob_ptr: DRM property containing EDID if present
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -0300638 * @properties: property tracking for this connector
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100639 * @path_blob_ptr: DRM blob property data for the DP MST path property
Jesse Barnes72252542011-11-07 12:03:18 -0800640 * @polled: a %DRM_CONNECTOR_POLL_<foo> value for core driven polling
641 * @dpms: current dpms state
642 * @helper_private: mid-layer private data
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100643 * @cmdline_mode: mode line parsed from the kernel cmdline for this connector
Jesse Barnes72252542011-11-07 12:03:18 -0800644 * @force: a %DRM_FORCE_<foo> state for forced mode sets
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100645 * @override_edid: has the EDID been overwritten through debugfs for testing?
Jesse Barnes72252542011-11-07 12:03:18 -0800646 * @encoder_ids: valid encoders for this connector
647 * @encoder: encoder driving this connector, if any
648 * @eld: EDID-like data, if present
649 * @dvi_dual: dual link DVI, if found
650 * @max_tmds_clock: max clock rate, if found
651 * @latency_present: AV delay info from ELD, if found
652 * @video_latency: video latency info from ELD, if found
653 * @audio_latency: audio latency info from ELD, if found
654 * @null_edid_counter: track sinks that give us all zeros for the EDID
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100655 * @bad_edid_counter: track sinks that give us an EDID with invalid checksum
Daniel Vetterac6f2e22015-05-08 16:15:41 +0200656 * @edid_corrupt: indicates whether the last read EDID was corrupt
Daniel Vetter2c0c33d2014-10-27 20:19:38 +0100657 * @debugfs_entry: debugfs directory for this connector
Daniel Vetter144ecb92014-10-27 20:28:44 +0100658 * @state: current atomic state for this connector
Dave Airlie40d9b042014-10-20 16:29:33 +1000659 * @has_tile: is this connector connected to a tiled monitor
660 * @tile_group: tile group for the connected monitor
661 * @tile_is_single_monitor: whether the tile is one monitor housing
662 * @num_h_tile: number of horizontal tiles in the tile group
663 * @num_v_tile: number of vertical tiles in the tile group
664 * @tile_h_loc: horizontal location of this tile
665 * @tile_v_loc: vertical location of this tile
666 * @tile_h_size: horizontal size of this tile.
667 * @tile_v_size: vertical size of this tile.
Dave Airlief453ba02008-11-07 14:05:41 -0800668 *
669 * Each connector may be connected to one or more CRTCs, or may be clonable by
670 * another connector if they can share a CRTC. Each connector also has a specific
671 * position in the broader display (referred to as a 'screen' though it could
672 * span multiple monitors).
673 */
674struct drm_connector {
675 struct drm_device *dev;
Dave Airlie5bdebb12013-10-11 14:07:25 +1000676 struct device *kdev;
Dave Airlief453ba02008-11-07 14:05:41 -0800677 struct device_attribute *attr;
678 struct list_head head;
679
680 struct drm_mode_object base;
681
Jani Nikula2abdd312014-05-14 16:58:19 +0300682 char *name;
Dave Airlief453ba02008-11-07 14:05:41 -0800683 int connector_type;
684 int connector_type_id;
685 bool interlace_allowed;
686 bool doublescan_allowed;
Damien Lespiau560a0672013-09-25 16:45:29 +0100687 bool stereo_allowed;
Dave Airlief453ba02008-11-07 14:05:41 -0800688 struct list_head modes; /* list of modes on this connector */
689
Dave Airlief453ba02008-11-07 14:05:41 -0800690 enum drm_connector_status status;
691
692 /* these are modes added by probing with DDC or the BIOS */
693 struct list_head probed_modes;
694
695 struct drm_display_info display_info;
696 const struct drm_connector_funcs *funcs;
697
Dave Airlief453ba02008-11-07 14:05:41 -0800698 struct drm_property_blob *edid_blob_ptr;
Paulo Zanoni7e3bdf42012-05-15 18:09:01 -0300699 struct drm_object_properties properties;
Dave Airlief453ba02008-11-07 14:05:41 -0800700
Dave Airlie43aba7e2014-06-05 14:01:31 +1000701 struct drm_property_blob *path_blob_ptr;
702
Dave Airlie6f134d72014-10-20 16:30:50 +1000703 struct drm_property_blob *tile_blob_ptr;
704
Dave Airlieeb1f8e42010-05-07 06:42:51 +0000705 uint8_t polled; /* DRM_CONNECTOR_POLL_* */
706
Keith Packardc9fb15f2009-05-30 20:42:28 -0700707 /* requested DPMS state */
708 int dpms;
709
Jani Nikula9a436ee2015-04-13 11:21:42 +0300710 const void *helper_private;
Dave Airlief453ba02008-11-07 14:05:41 -0800711
Dave Airlied50ba252009-09-23 14:44:08 +1000712 /* forced on connector */
Chris Wilsoneaf99c72014-08-06 10:08:32 +0200713 struct drm_cmdline_mode cmdline_mode;
Dave Airlied50ba252009-09-23 14:44:08 +1000714 enum drm_connector_force force;
Thomas Wood4cf2b282014-06-18 17:52:33 +0100715 bool override_edid;
Dave Airlief453ba02008-11-07 14:05:41 -0800716 uint32_t encoder_ids[DRM_CONNECTOR_MAX_ENCODER];
Dave Airlief453ba02008-11-07 14:05:41 -0800717 struct drm_encoder *encoder; /* currently active encoder */
Dave Airlie4a9a8b72011-06-14 06:13:55 +0000718
Wu Fengguang76adaa342011-09-05 14:23:20 +0800719 /* EDID bits */
720 uint8_t eld[MAX_ELD_BYTES];
721 bool dvi_dual;
722 int max_tmds_clock; /* in MHz */
723 bool latency_present[2];
724 int video_latency[2]; /* [0]: progressive, [1]: interlaced */
725 int audio_latency[2];
Dave Airlie4a9a8b72011-06-14 06:13:55 +0000726 int null_edid_counter; /* needed to workaround some HW bugs where we get all 0s */
Jerome Glisse0b2443e2012-08-09 11:25:51 -0400727 unsigned bad_edid_counter;
Thomas Wood30f65702014-06-18 17:52:32 +0100728
Todd Previte6ba2bd32015-04-21 11:09:41 -0700729 /* Flag for raw EDID header corruption - used in Displayport
730 * compliance testing - * Displayport Link CTS Core 1.2 rev1.1 4.2.2.6
731 */
732 bool edid_corrupt;
733
Thomas Wood30f65702014-06-18 17:52:32 +0100734 struct dentry *debugfs_entry;
Daniel Vetter144ecb92014-10-27 20:28:44 +0100735
736 struct drm_connector_state *state;
Dave Airlie40d9b042014-10-20 16:29:33 +1000737
738 /* DisplayID bits */
739 bool has_tile;
740 struct drm_tile_group *tile_group;
741 bool tile_is_single_monitor;
742
743 uint8_t num_h_tile, num_v_tile;
744 uint8_t tile_h_loc, tile_v_loc;
745 uint16_t tile_h_size, tile_v_size;
Dave Airlie6b8eeca2015-06-15 10:34:28 +1000746
747 struct list_head destroy_list;
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;
866 uint32_t 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_group - group of mode setting resources for potential sub-grouping
Jesse Barnesc1aaca22011-11-07 12:03:21 -08001022 * @num_crtcs: CRTC count
1023 * @num_encoders: encoder count
1024 * @num_connectors: connector count
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001025 * @num_bridges: bridge count
Jesse Barnesc1aaca22011-11-07 12:03:21 -08001026 * @id_list: list of KMS object IDs in this group
1027 *
1028 * Currently this simply tracks the global mode setting state. But in the
1029 * future it could allow groups of objects to be set aside into independent
1030 * control groups for use by different user level processes (e.g. two X servers
1031 * running simultaneously on different heads, each with their own mode
1032 * configuration and freedom of mode setting).
1033 */
Dave Airlief453ba02008-11-07 14:05:41 -08001034struct drm_mode_group {
1035 uint32_t num_crtcs;
1036 uint32_t num_encoders;
1037 uint32_t num_connectors;
1038
1039 /* list of object IDs for this group */
1040 uint32_t *id_list;
1041};
1042
1043/**
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001044 * struct drm_mode_config - Mode configuration control structure
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001045 * @mutex: mutex protecting KMS related lists and structures
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001046 * @connection_mutex: ww mutex protecting connector state and routing
1047 * @acquire_ctx: global implicit acquire context used by atomic drivers for
1048 * legacy ioctls
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001049 * @idr_mutex: mutex for KMS ID allocation and management
1050 * @crtc_idr: main KMS ID tracking object
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001051 * @fb_lock: mutex to protect fb state and lists
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001052 * @num_fb: number of fbs available
1053 * @fb_list: list of framebuffers available
1054 * @num_connector: number of connectors on this device
1055 * @connector_list: list of connector objects
1056 * @num_encoder: number of encoders on this device
1057 * @encoder_list: list of encoder objects
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001058 * @num_overlay_plane: number of overlay planes on this device
1059 * @num_total_plane: number of universal (i.e. with primary/curso) planes on this device
1060 * @plane_list: list of plane objects
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001061 * @num_crtc: number of CRTCs on this device
1062 * @crtc_list: list of CRTC objects
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001063 * @property_list: list of property objects
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001064 * @min_width: minimum pixel width on this device
1065 * @min_height: minimum pixel height on this device
1066 * @max_width: maximum pixel width on this device
1067 * @max_height: maximum pixel height on this device
1068 * @funcs: core driver provided mode setting functions
1069 * @fb_base: base address of the framebuffer
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001070 * @poll_enabled: track polling support for this device
1071 * @poll_running: track polling status for this device
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001072 * @output_poll_work: delayed work for polling in process context
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001073 * @property_blob_list: list of all the blob property objects
Daniel Stone8fb6e7a2015-04-20 19:22:54 +01001074 * @blob_lock: mutex for blob property allocation and management
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001075 * @*_property: core property tracking
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001076 * @preferred_depth: preferred RBG pixel depth, used by fb helpers
1077 * @prefer_shadow: hint to userspace to prefer shadow-fb rendering
1078 * @async_page_flip: does this device support async flips on the primary plane?
1079 * @cursor_width: hint to userspace for max cursor width
1080 * @cursor_height: hint to userspace for max cursor height
Dave Airlief453ba02008-11-07 14:05:41 -08001081 *
Jesse Barnesa62c93d2011-11-07 12:03:22 -08001082 * Core mode resource tracking structure. All CRTC, encoders, and connectors
1083 * enumerated by the driver are added here, as are global properties. Some
1084 * global restrictions are also here, e.g. dimension restrictions.
Dave Airlief453ba02008-11-07 14:05:41 -08001085 */
1086struct drm_mode_config {
Jesse Barnesad2563c2009-01-19 17:21:45 +10001087 struct mutex mutex; /* protects configuration (mode lists etc.) */
Rob Clark51fd3712013-11-19 12:10:12 -05001088 struct drm_modeset_lock connection_mutex; /* protects connector->encoder and encoder->crtc links */
1089 struct drm_modeset_acquire_ctx *acquire_ctx; /* for legacy _lock_all() / _unlock_all() */
Jesse Barnesad2563c2009-01-19 17:21:45 +10001090 struct mutex idr_mutex; /* for IDR management */
Dave Airlief453ba02008-11-07 14:05:41 -08001091 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 +10001092 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 -08001093 /* this is limited to one for now */
Daniel Vetter4b096ac2012-12-10 21:19:18 +01001094
Daniel Vetter2c0c33d2014-10-27 20:19:38 +01001095 struct mutex fb_lock; /* proctects global and per-file fb lists */
Dave Airlief453ba02008-11-07 14:05:41 -08001096 int num_fb;
1097 struct list_head fb_list;
Daniel Vetter4b096ac2012-12-10 21:19:18 +01001098
Dave Airlief453ba02008-11-07 14:05:41 -08001099 int num_connector;
1100 struct list_head connector_list;
1101 int num_encoder;
1102 struct list_head encoder_list;
Matt Ropere27dde32014-04-01 15:22:30 -07001103
1104 /*
1105 * Track # of overlay planes separately from # of total planes. By
1106 * default we only advertise overlay planes to userspace; if userspace
1107 * sets the "universal plane" capability bit, we'll go ahead and
1108 * expose all planes.
1109 */
1110 int num_overlay_plane;
1111 int num_total_plane;
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001112 struct list_head plane_list;
Dave Airlief453ba02008-11-07 14:05:41 -08001113
1114 int num_crtc;
1115 struct list_head crtc_list;
1116
1117 struct list_head property_list;
1118
Dave Airlief453ba02008-11-07 14:05:41 -08001119 int min_width, min_height;
1120 int max_width, max_height;
Laurent Pincharte6ecefa2012-05-17 13:27:23 +02001121 const struct drm_mode_config_funcs *funcs;
Benjamin Herrenschmidtd883f7f2009-02-02 16:55:45 +11001122 resource_size_t fb_base;
Dave Airlief453ba02008-11-07 14:05:41 -08001123
Dave Airlieeb1f8e42010-05-07 06:42:51 +00001124 /* output poll support */
1125 bool poll_enabled;
Daniel Vetter905bc9f2012-10-23 18:23:36 +00001126 bool poll_running;
Daniel Vetter162b6a52015-01-21 08:45:21 +01001127 bool delayed_event;
Tejun Heo991ea752010-07-20 22:09:02 +02001128 struct delayed_work output_poll_work;
Dave Airlieeb1f8e42010-05-07 06:42:51 +00001129
Daniel Stone8fb6e7a2015-04-20 19:22:54 +01001130 struct mutex blob_lock;
1131
Dave Airlief453ba02008-11-07 14:05:41 -08001132 /* pointers to standard properties */
1133 struct list_head property_blob_list;
1134 struct drm_property *edid_property;
1135 struct drm_property *dpms_property;
Dave Airlie43aba7e2014-06-05 14:01:31 +10001136 struct drm_property *path_property;
Dave Airlie6f134d72014-10-20 16:30:50 +10001137 struct drm_property *tile_property;
Rob Clark9922ab52014-04-01 20:16:57 -04001138 struct drm_property *plane_type_property;
Sonika Jindal2a297cc2014-08-05 11:26:54 +05301139 struct drm_property *rotation_property;
Rob Clark6b4959f2014-12-18 16:01:53 -05001140 struct drm_property *prop_src_x;
1141 struct drm_property *prop_src_y;
1142 struct drm_property *prop_src_w;
1143 struct drm_property *prop_src_h;
1144 struct drm_property *prop_crtc_x;
1145 struct drm_property *prop_crtc_y;
1146 struct drm_property *prop_crtc_w;
1147 struct drm_property *prop_crtc_h;
1148 struct drm_property *prop_fb_id;
1149 struct drm_property *prop_crtc_id;
Daniel Vettereab3bbe2015-01-22 16:36:21 +01001150 struct drm_property *prop_active;
Daniel Stone955f3c32015-05-25 19:11:52 +01001151 struct drm_property *prop_mode_id;
Dave Airlief453ba02008-11-07 14:05:41 -08001152
1153 /* DVI-I properties */
1154 struct drm_property *dvi_i_subconnector_property;
1155 struct drm_property *dvi_i_select_subconnector_property;
1156
1157 /* TV properties */
1158 struct drm_property *tv_subconnector_property;
1159 struct drm_property *tv_select_subconnector_property;
1160 struct drm_property *tv_mode_property;
1161 struct drm_property *tv_left_margin_property;
1162 struct drm_property *tv_right_margin_property;
1163 struct drm_property *tv_top_margin_property;
1164 struct drm_property *tv_bottom_margin_property;
Francisco Jerezb6b79022009-08-02 04:19:20 +02001165 struct drm_property *tv_brightness_property;
1166 struct drm_property *tv_contrast_property;
1167 struct drm_property *tv_flicker_reduction_property;
Francisco Jereza75f0232009-08-12 02:30:10 +02001168 struct drm_property *tv_overscan_property;
1169 struct drm_property *tv_saturation_property;
1170 struct drm_property *tv_hue_property;
Dave Airlief453ba02008-11-07 14:05:41 -08001171
1172 /* Optional properties */
1173 struct drm_property *scaling_mode_property;
Vandana Kannanff587e42014-06-11 10:46:48 +05301174 struct drm_property *aspect_ratio_property;
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001175 struct drm_property *dirty_info_property;
Dave Airlie019d96c2011-09-29 16:20:42 +01001176
Dave Airlie5bb2bbf2014-11-10 10:18:15 +10001177 /* properties for virtual machine layout */
1178 struct drm_property *suggested_x_property;
1179 struct drm_property *suggested_y_property;
1180
Dave Airlie019d96c2011-09-29 16:20:42 +01001181 /* dumb ioctl parameters */
1182 uint32_t preferred_depth, prefer_shadow;
Keith Packard62f21042013-07-22 18:50:00 -07001183
1184 /* whether async page flip is supported or not */
1185 bool async_page_flip;
Alex Deucher8716ed42014-02-12 12:48:23 -05001186
Rob Clarke3eb3252015-02-05 14:41:52 +00001187 /* whether the driver supports fb modifiers */
1188 bool allow_fb_modifiers;
1189
Alex Deucher8716ed42014-02-12 12:48:23 -05001190 /* cursor size */
1191 uint32_t cursor_width, cursor_height;
Dave Airlief453ba02008-11-07 14:05:41 -08001192};
1193
Rob Clarkdd275952014-11-25 20:29:46 -05001194/**
1195 * drm_for_each_plane_mask - iterate over planes specified by bitmask
1196 * @plane: the loop cursor
1197 * @dev: the DRM device
1198 * @plane_mask: bitmask of plane indices
1199 *
1200 * Iterate over all planes specified by bitmask.
1201 */
1202#define drm_for_each_plane_mask(plane, dev, plane_mask) \
1203 list_for_each_entry((plane), &(dev)->mode_config.plane_list, head) \
1204 if ((plane_mask) & (1 << drm_plane_index(plane)))
1205
1206
Dave Airlief453ba02008-11-07 14:05:41 -08001207#define obj_to_crtc(x) container_of(x, struct drm_crtc, base)
1208#define obj_to_connector(x) container_of(x, struct drm_connector, base)
1209#define obj_to_encoder(x) container_of(x, struct drm_encoder, base)
1210#define obj_to_mode(x) container_of(x, struct drm_display_mode, base)
1211#define obj_to_fb(x) container_of(x, struct drm_framebuffer, base)
1212#define obj_to_property(x) container_of(x, struct drm_property, base)
1213#define obj_to_blob(x) container_of(x, struct drm_property_blob, base)
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001214#define obj_to_plane(x) container_of(x, struct drm_plane, base)
Dave Airlief453ba02008-11-07 14:05:41 -08001215
Sascha Hauer4a67d392012-02-06 10:58:17 +01001216struct drm_prop_enum_list {
1217 int type;
1218 char *name;
1219};
Dave Airlief453ba02008-11-07 14:05:41 -08001220
Matt Ropere13161a2014-04-01 15:22:38 -07001221extern int drm_crtc_init_with_planes(struct drm_device *dev,
1222 struct drm_crtc *crtc,
1223 struct drm_plane *primary,
Matt Roperfc1d3e42014-06-10 08:28:11 -07001224 struct drm_plane *cursor,
Matt Ropere13161a2014-04-01 15:22:38 -07001225 const struct drm_crtc_funcs *funcs);
Dave Airlief453ba02008-11-07 14:05:41 -08001226extern void drm_crtc_cleanup(struct drm_crtc *crtc);
Russell Kingdb5f7a62014-01-02 21:27:33 +00001227extern unsigned int drm_crtc_index(struct drm_crtc *crtc);
1228
1229/**
1230 * drm_crtc_mask - find the mask of a registered CRTC
1231 * @crtc: CRTC to find mask for
1232 *
1233 * Given a registered CRTC, return the mask bit of that CRTC for an
1234 * encoder's possible_crtcs field.
1235 */
1236static inline uint32_t drm_crtc_mask(struct drm_crtc *crtc)
1237{
1238 return 1 << drm_crtc_index(crtc);
1239}
Dave Airlief453ba02008-11-07 14:05:41 -08001240
Ilia Mirkinb21e3af2013-08-07 22:34:48 -04001241extern void drm_connector_ida_init(void);
1242extern void drm_connector_ida_destroy(void);
Ville Syrjälä6bfc56a2012-03-13 12:35:48 +02001243extern int drm_connector_init(struct drm_device *dev,
1244 struct drm_connector *connector,
1245 const struct drm_connector_funcs *funcs,
1246 int connector_type);
Thomas Wood34ea3d32014-05-29 16:57:41 +01001247int drm_connector_register(struct drm_connector *connector);
1248void drm_connector_unregister(struct drm_connector *connector);
Dave Airlief453ba02008-11-07 14:05:41 -08001249
1250extern void drm_connector_cleanup(struct drm_connector *connector);
Daniel Vetter10f637b2014-07-29 13:47:11 +02001251extern unsigned int drm_connector_index(struct drm_connector *connector);
Dave Airliecbc7e222012-02-20 14:16:40 +00001252/* helper to unplug all connectors from sysfs for device */
1253extern void drm_connector_unplug_all(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001254
Ajay Kumar3d3f8b12015-01-20 22:08:44 +05301255extern int drm_bridge_add(struct drm_bridge *bridge);
1256extern void drm_bridge_remove(struct drm_bridge *bridge);
1257extern struct drm_bridge *of_drm_find_bridge(struct device_node *np);
1258extern int drm_bridge_attach(struct drm_device *dev, struct drm_bridge *bridge);
Sean Paul3b336ec2013-08-14 16:47:37 -04001259
Archit Taneja862e6862015-05-21 11:03:16 +05301260bool drm_bridge_mode_fixup(struct drm_bridge *bridge,
1261 const struct drm_display_mode *mode,
1262 struct drm_display_mode *adjusted_mode);
1263void drm_bridge_disable(struct drm_bridge *bridge);
1264void drm_bridge_post_disable(struct drm_bridge *bridge);
1265void drm_bridge_mode_set(struct drm_bridge *bridge,
1266 struct drm_display_mode *mode,
1267 struct drm_display_mode *adjusted_mode);
1268void drm_bridge_pre_enable(struct drm_bridge *bridge);
1269void drm_bridge_enable(struct drm_bridge *bridge);
1270
Ville Syrjälä6bfc56a2012-03-13 12:35:48 +02001271extern int drm_encoder_init(struct drm_device *dev,
1272 struct drm_encoder *encoder,
1273 const struct drm_encoder_funcs *funcs,
1274 int encoder_type);
Dave Airlief453ba02008-11-07 14:05:41 -08001275
Thierry Reding3d887362014-01-13 14:33:20 +01001276/**
1277 * drm_encoder_crtc_ok - can a given crtc drive a given encoder?
1278 * @encoder: encoder to test
1279 * @crtc: crtc to test
1280 *
1281 * Return false if @encoder can't be driven by @crtc, true otherwise.
1282 */
1283static inline bool drm_encoder_crtc_ok(struct drm_encoder *encoder,
1284 struct drm_crtc *crtc)
1285{
1286 return !!(encoder->possible_crtcs & drm_crtc_mask(crtc));
1287}
1288
Matt Roperdc415ff2014-04-01 15:22:36 -07001289extern int drm_universal_plane_init(struct drm_device *dev,
1290 struct drm_plane *plane,
1291 unsigned long possible_crtcs,
1292 const struct drm_plane_funcs *funcs,
1293 const uint32_t *formats,
1294 uint32_t format_count,
1295 enum drm_plane_type type);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001296extern int drm_plane_init(struct drm_device *dev,
1297 struct drm_plane *plane,
1298 unsigned long possible_crtcs,
1299 const struct drm_plane_funcs *funcs,
Rob Clark0a7eb242011-12-13 20:19:36 -06001300 const uint32_t *formats, uint32_t format_count,
Matt Roperdc415ff2014-04-01 15:22:36 -07001301 bool is_primary);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001302extern void drm_plane_cleanup(struct drm_plane *plane);
Daniel Vetter10f637b2014-07-29 13:47:11 +02001303extern unsigned int drm_plane_index(struct drm_plane *plane);
Chandra Konduruf81338a2015-04-09 17:36:21 -07001304extern struct drm_plane * drm_plane_from_index(struct drm_device *dev, int idx);
Ville Syrjälä9125e612013-06-03 16:10:40 +03001305extern void drm_plane_force_disable(struct drm_plane *plane);
Laurent Pinchartead86102015-03-05 02:25:43 +02001306extern int drm_plane_check_pixel_format(const struct drm_plane *plane,
1307 u32 format);
Gustavo Padovanecb7e162014-12-01 15:40:09 -08001308extern void drm_crtc_get_hv_timing(const struct drm_display_mode *mode,
1309 int *hdisplay, int *vdisplay);
Matt Roperaf936292014-04-01 15:22:34 -07001310extern int drm_crtc_check_viewport(const struct drm_crtc *crtc,
1311 int x, int y,
1312 const struct drm_display_mode *mode,
1313 const struct drm_framebuffer *fb);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001314
Dave Airlief453ba02008-11-07 14:05:41 -08001315extern void drm_encoder_cleanup(struct drm_encoder *encoder);
1316
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001317extern const char *drm_get_connector_status_name(enum drm_connector_status status);
Jesse Barnesac1bb362014-02-10 15:32:44 -08001318extern const char *drm_get_subpixel_order_name(enum subpixel_order order);
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001319extern const char *drm_get_dpms_name(int val);
1320extern const char *drm_get_dvi_i_subconnector_name(int val);
1321extern const char *drm_get_dvi_i_select_name(int val);
1322extern const char *drm_get_tv_subconnector_name(int val);
1323extern const char *drm_get_tv_select_name(int val);
Kristian Høgsbergea39f832009-02-12 14:37:56 -05001324extern void drm_fb_release(struct drm_file *file_priv);
Daniel Stonee2f5d2e2015-05-22 13:34:51 +01001325extern void drm_property_destroy_user_blobs(struct drm_device *dev,
1326 struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001327extern int drm_mode_group_init_legacy_group(struct drm_device *dev, struct drm_mode_group *group);
Dave Airliead222792014-05-02 13:22:19 +10001328extern void drm_mode_group_destroy(struct drm_mode_group *group);
Dave Airlie2390cd12014-06-05 14:01:29 +10001329extern void drm_reinit_primary_mode_group(struct drm_device *dev);
Adam Jacksonfbff4692012-09-18 10:58:47 -04001330extern bool drm_probe_ddc(struct i2c_adapter *adapter);
Dave Airlief453ba02008-11-07 14:05:41 -08001331extern struct edid *drm_get_edid(struct drm_connector *connector,
1332 struct i2c_adapter *adapter);
Jani Nikula51f8da52013-09-27 15:08:27 +03001333extern struct edid *drm_edid_duplicate(const struct edid *edid);
Dave Airlief453ba02008-11-07 14:05:41 -08001334extern int drm_add_edid_modes(struct drm_connector *connector, struct edid *edid);
Dave Airlief453ba02008-11-07 14:05:41 -08001335extern void drm_mode_config_init(struct drm_device *dev);
Chris Wilsoneb033552011-01-24 15:11:08 +00001336extern void drm_mode_config_reset(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001337extern void drm_mode_config_cleanup(struct drm_device *dev);
Dave Airlief453ba02008-11-07 14:05:41 -08001338
Dave Airlie43aba7e2014-06-05 14:01:31 +10001339extern int drm_mode_connector_set_path_property(struct drm_connector *connector,
Thierry Reding12e6cec2014-05-13 11:38:36 +02001340 const char *path);
Dave Airlie6f134d72014-10-20 16:30:50 +10001341int drm_mode_connector_set_tile_property(struct drm_connector *connector);
Dave Airlief453ba02008-11-07 14:05:41 -08001342extern int drm_mode_connector_update_edid_property(struct drm_connector *connector,
Thierry Reding12e6cec2014-05-13 11:38:36 +02001343 const struct edid *edid);
Rob Clark5ea22f22014-05-30 11:34:01 -04001344
Boris Brezillonb5571e92014-07-22 12:09:10 +02001345extern int drm_display_info_set_bus_formats(struct drm_display_info *info,
1346 const u32 *formats,
1347 unsigned int num_formats);
1348
Rob Clark5ea22f22014-05-30 11:34:01 -04001349static inline bool drm_property_type_is(struct drm_property *property,
1350 uint32_t type)
1351{
1352 /* instanceof for props.. handles extended type vs original types: */
1353 if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
1354 return (property->flags & DRM_MODE_PROP_EXTENDED_TYPE) == type;
1355 return property->flags & type;
1356}
1357
1358static inline bool drm_property_type_valid(struct drm_property *property)
1359{
1360 if (property->flags & DRM_MODE_PROP_EXTENDED_TYPE)
1361 return !(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
1362 return !!(property->flags & DRM_MODE_PROP_LEGACY_TYPE);
1363}
1364
Paulo Zanonic5431882012-05-15 18:09:02 -03001365extern int drm_object_property_set_value(struct drm_mode_object *obj,
1366 struct drm_property *property,
1367 uint64_t val);
1368extern int drm_object_property_get_value(struct drm_mode_object *obj,
1369 struct drm_property *property,
1370 uint64_t *value);
Dave Airlief453ba02008-11-07 14:05:41 -08001371extern int drm_framebuffer_init(struct drm_device *dev,
1372 struct drm_framebuffer *fb,
1373 const struct drm_framebuffer_funcs *funcs);
Daniel Vetter786b99e2012-12-02 21:53:40 +01001374extern struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev,
1375 uint32_t id);
Rob Clarkf7eff602012-09-05 21:48:38 +00001376extern void drm_framebuffer_unreference(struct drm_framebuffer *fb);
1377extern void drm_framebuffer_reference(struct drm_framebuffer *fb);
1378extern void drm_framebuffer_remove(struct drm_framebuffer *fb);
Dave Airlief453ba02008-11-07 14:05:41 -08001379extern void drm_framebuffer_cleanup(struct drm_framebuffer *fb);
Daniel Vetter36206362012-12-10 20:42:17 +01001380extern void drm_framebuffer_unregister_private(struct drm_framebuffer *fb);
Dave Airlief453ba02008-11-07 14:05:41 -08001381
Paulo Zanonic5431882012-05-15 18:09:02 -03001382extern void drm_object_attach_property(struct drm_mode_object *obj,
1383 struct drm_property *property,
1384 uint64_t init_val);
Dave Airlief453ba02008-11-07 14:05:41 -08001385extern struct drm_property *drm_property_create(struct drm_device *dev, int flags,
1386 const char *name, int num_values);
Sascha Hauer4a67d392012-02-06 10:58:17 +01001387extern struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
1388 const char *name,
1389 const struct drm_prop_enum_list *props,
1390 int num_values);
Rob Clark49e27542012-05-17 02:23:26 -06001391struct drm_property *drm_property_create_bitmask(struct drm_device *dev,
1392 int flags, const char *name,
1393 const struct drm_prop_enum_list *props,
Ville Syrjälä7689ffb2014-07-08 10:31:52 +05301394 int num_props,
1395 uint64_t supported_bits);
Sascha Hauerd9bc3c02012-02-06 10:58:18 +01001396struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
1397 const char *name,
1398 uint64_t min, uint64_t max);
Rob Clarkebc44cf2012-09-12 22:22:31 -05001399struct drm_property *drm_property_create_signed_range(struct drm_device *dev,
1400 int flags, const char *name,
1401 int64_t min, int64_t max);
Rob Clark98f75de2014-05-30 11:37:03 -04001402struct drm_property *drm_property_create_object(struct drm_device *dev,
1403 int flags, const char *name, uint32_t type);
Daniel Vetter960cd9d2015-01-21 08:47:38 +01001404struct drm_property *drm_property_create_bool(struct drm_device *dev, int flags,
1405 const char *name);
Daniel Stone6bcacf52015-04-20 19:22:55 +01001406struct drm_property_blob *drm_property_create_blob(struct drm_device *dev,
1407 size_t length,
1408 const void *data);
1409struct drm_property_blob *drm_property_lookup_blob(struct drm_device *dev,
1410 uint32_t id);
1411struct drm_property_blob *drm_property_reference_blob(struct drm_property_blob *blob);
1412void drm_property_unreference_blob(struct drm_property_blob *blob);
Dave Airlief453ba02008-11-07 14:05:41 -08001413extern void drm_property_destroy(struct drm_device *dev, struct drm_property *property);
1414extern int drm_property_add_enum(struct drm_property *property, int index,
1415 uint64_t value, const char *name);
1416extern int drm_mode_create_dvi_i_properties(struct drm_device *dev);
Thierry Reding2f763312014-10-13 12:45:57 +02001417extern int drm_mode_create_tv_properties(struct drm_device *dev,
1418 unsigned int num_modes,
1419 char *modes[]);
Dave Airlief453ba02008-11-07 14:05:41 -08001420extern int drm_mode_create_scaling_mode_property(struct drm_device *dev);
Vandana Kannanff587e42014-06-11 10:46:48 +05301421extern int drm_mode_create_aspect_ratio_property(struct drm_device *dev);
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001422extern int drm_mode_create_dirty_info_property(struct drm_device *dev);
Dave Airlie5bb2bbf2014-11-10 10:18:15 +10001423extern int drm_mode_create_suggested_offset_properties(struct drm_device *dev);
Rob Clarkd34f20d2014-12-18 16:01:56 -05001424extern bool drm_property_change_valid_get(struct drm_property *property,
1425 uint64_t value, struct drm_mode_object **ref);
1426extern void drm_property_change_valid_put(struct drm_property *property,
1427 struct drm_mode_object *ref);
Dave Airlief453ba02008-11-07 14:05:41 -08001428
1429extern int drm_mode_connector_attach_encoder(struct drm_connector *connector,
1430 struct drm_encoder *encoder);
Sascha Hauer4cae5b82012-02-01 11:38:23 +01001431extern int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
Dave Airlief453ba02008-11-07 14:05:41 -08001432 int gamma_size);
Daniel Vetter7a9c9062009-09-15 22:57:31 +02001433extern struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
1434 uint32_t id, uint32_t type);
Rob Clark98f75de2014-05-30 11:37:03 -04001435
Dave Airlief453ba02008-11-07 14:05:41 -08001436/* IOCTLs */
1437extern int drm_mode_getresources(struct drm_device *dev,
1438 void *data, struct drm_file *file_priv);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001439extern int drm_mode_getplane_res(struct drm_device *dev, void *data,
1440 struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001441extern int drm_mode_getcrtc(struct drm_device *dev,
1442 void *data, struct drm_file *file_priv);
1443extern int drm_mode_getconnector(struct drm_device *dev,
1444 void *data, struct drm_file *file_priv);
Daniel Vetter2d13b672012-12-11 13:47:23 +01001445extern int drm_mode_set_config_internal(struct drm_mode_set *set);
Dave Airlief453ba02008-11-07 14:05:41 -08001446extern int drm_mode_setcrtc(struct drm_device *dev,
1447 void *data, struct drm_file *file_priv);
Jesse Barnes8cf5c912011-11-14 14:51:27 -08001448extern int drm_mode_getplane(struct drm_device *dev,
1449 void *data, struct drm_file *file_priv);
1450extern int drm_mode_setplane(struct drm_device *dev,
1451 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001452extern int drm_mode_cursor_ioctl(struct drm_device *dev,
1453 void *data, struct drm_file *file_priv);
Dave Airlie4c813d42013-06-20 11:48:52 +10001454extern int drm_mode_cursor2_ioctl(struct drm_device *dev,
1455 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001456extern int drm_mode_addfb(struct drm_device *dev,
1457 void *data, struct drm_file *file_priv);
Jesse Barnes308e5bc2011-11-14 14:51:28 -08001458extern int drm_mode_addfb2(struct drm_device *dev,
1459 void *data, struct drm_file *file_priv);
1460extern uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth);
Dave Airlief453ba02008-11-07 14:05:41 -08001461extern int drm_mode_rmfb(struct drm_device *dev,
1462 void *data, struct drm_file *file_priv);
1463extern int drm_mode_getfb(struct drm_device *dev,
1464 void *data, struct drm_file *file_priv);
Jakob Bornecrantz884840a2009-12-03 23:25:47 +00001465extern int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
1466 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001467
1468extern int drm_mode_getproperty_ioctl(struct drm_device *dev,
1469 void *data, struct drm_file *file_priv);
1470extern int drm_mode_getblob_ioctl(struct drm_device *dev,
1471 void *data, struct drm_file *file_priv);
Daniel Stonee2f5d2e2015-05-22 13:34:51 +01001472extern int drm_mode_createblob_ioctl(struct drm_device *dev,
1473 void *data, struct drm_file *file_priv);
1474extern int drm_mode_destroyblob_ioctl(struct drm_device *dev,
1475 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001476extern int drm_mode_connector_property_set_ioctl(struct drm_device *dev,
1477 void *data, struct drm_file *file_priv);
Dave Airlief453ba02008-11-07 14:05:41 -08001478extern int drm_mode_getencoder(struct drm_device *dev,
1479 void *data, struct drm_file *file_priv);
1480extern int drm_mode_gamma_get_ioctl(struct drm_device *dev,
1481 void *data, struct drm_file *file_priv);
1482extern int drm_mode_gamma_set_ioctl(struct drm_device *dev,
1483 void *data, struct drm_file *file_priv);
Thierry Reding18316c82012-12-20 15:41:44 +01001484extern u8 drm_match_cea_mode(const struct drm_display_mode *to_match);
Vandana Kannan0967e6a2014-04-01 16:26:59 +05301485extern enum hdmi_picture_aspect drm_get_cea_aspect_ratio(const u8 video_code);
Ma Lingf23c20c2009-03-26 19:26:23 +08001486extern bool drm_detect_hdmi_monitor(struct edid *edid);
Zhenyu Wang8fe97902010-09-19 14:27:28 +08001487extern bool drm_detect_monitor_audio(struct edid *edid);
Ville Syrjäläb1edd6a2013-01-17 16:31:30 +02001488extern bool drm_rgb_quant_range_selectable(struct edid *edid);
Kristian Høgsbergd91d8a32009-11-17 12:43:55 -05001489extern int drm_mode_page_flip_ioctl(struct drm_device *dev,
1490 void *data, struct drm_file *file_priv);
Zhao Yakuif0fda0a2009-09-03 09:33:48 +08001491extern int drm_add_modes_noedid(struct drm_connector *connector,
1492 int hdisplay, int vdisplay);
Gerd Hoffmann3cf70da2013-10-11 10:01:08 +02001493extern void drm_set_preferred_mode(struct drm_connector *connector,
1494 int hpref, int vpref);
Alex Deucher3c537882010-02-05 04:21:19 -05001495
Thomas Reim051963d2011-07-29 14:28:57 +00001496extern int drm_edid_header_is_valid(const u8 *raw_edid);
Todd Previte6ba2bd32015-04-21 11:09:41 -07001497extern bool drm_edid_block_valid(u8 *raw_edid, int block, bool print_bad_edid,
1498 bool *edid_corrupt);
Alex Deucher3c537882010-02-05 04:21:19 -05001499extern bool drm_edid_is_valid(struct edid *edid);
Dave Airlie138f9eb2014-10-20 16:17:17 +10001500
1501extern struct drm_tile_group *drm_mode_create_tile_group(struct drm_device *dev,
1502 char topology[8]);
1503extern struct drm_tile_group *drm_mode_get_tile_group(struct drm_device *dev,
1504 char topology[8]);
1505extern void drm_mode_put_tile_group(struct drm_device *dev,
1506 struct drm_tile_group *tg);
Dave Airlie1d42bbc2010-05-07 05:02:30 +00001507struct drm_display_mode *drm_mode_find_dmt(struct drm_device *dev,
Adam Jacksonf6e252b2012-04-13 16:33:31 -04001508 int hsize, int vsize, int fresh,
1509 bool rb);
Dave Airlieff72145b2011-02-07 12:16:14 +10001510
1511extern int drm_mode_create_dumb_ioctl(struct drm_device *dev,
1512 void *data, struct drm_file *file_priv);
1513extern int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
1514 void *data, struct drm_file *file_priv);
1515extern int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
1516 void *data, struct drm_file *file_priv);
Paulo Zanonic5431882012-05-15 18:09:02 -03001517extern int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
1518 struct drm_file *file_priv);
1519extern int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
1520 struct drm_file *file_priv);
Thomas Wood3a5f87c2014-08-20 14:45:00 +01001521extern int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
1522 struct drm_property *property,
1523 uint64_t value);
Rob Clarkd34f20d2014-12-18 16:01:56 -05001524extern int drm_mode_atomic_ioctl(struct drm_device *dev,
1525 void *data, struct drm_file *file_priv);
Dave Airlie248dbc22011-11-29 20:02:54 +00001526
1527extern void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
1528 int *bpp);
Ville Syrjälä141670e2012-04-05 21:35:15 +03001529extern int drm_format_num_planes(uint32_t format);
Ville Syrjälä5a86bd52012-04-05 21:35:16 +03001530extern int drm_format_plane_cpp(uint32_t format, int plane);
Ville Syrjälä01b68b02012-04-05 21:35:17 +03001531extern int drm_format_horz_chroma_subsampling(uint32_t format);
1532extern int drm_format_vert_chroma_subsampling(uint32_t format);
Ville Syrjäläd20d3172013-06-07 15:43:07 +00001533extern const char *drm_get_format_name(uint32_t format);
Ville Syrjäläc1df5f32014-07-08 10:31:53 +05301534extern struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
1535 unsigned int supported_rotations);
Ville Syrjälä3c9855f2014-07-08 10:31:56 +05301536extern unsigned int drm_rotation_simplify(unsigned int rotation,
1537 unsigned int supported_rotations);
Ville Syrjälä141670e2012-04-05 21:35:15 +03001538
Russell King96f60e32012-08-15 13:59:49 +01001539/* Helpers */
Rob Clarka2b34e22013-10-05 16:36:52 -04001540
1541static inline struct drm_plane *drm_plane_find(struct drm_device *dev,
1542 uint32_t id)
1543{
1544 struct drm_mode_object *mo;
1545 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PLANE);
1546 return mo ? obj_to_plane(mo) : NULL;
1547}
1548
Russell King96f60e32012-08-15 13:59:49 +01001549static inline struct drm_crtc *drm_crtc_find(struct drm_device *dev,
1550 uint32_t id)
1551{
1552 struct drm_mode_object *mo;
1553 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CRTC);
1554 return mo ? obj_to_crtc(mo) : NULL;
1555}
1556
1557static inline struct drm_encoder *drm_encoder_find(struct drm_device *dev,
1558 uint32_t id)
1559{
1560 struct drm_mode_object *mo;
1561 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_ENCODER);
1562 return mo ? obj_to_encoder(mo) : NULL;
1563}
1564
Rob Clarka2b34e22013-10-05 16:36:52 -04001565static inline struct drm_connector *drm_connector_find(struct drm_device *dev,
1566 uint32_t id)
1567{
1568 struct drm_mode_object *mo;
1569 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_CONNECTOR);
1570 return mo ? obj_to_connector(mo) : NULL;
1571}
1572
1573static inline struct drm_property *drm_property_find(struct drm_device *dev,
1574 uint32_t id)
1575{
1576 struct drm_mode_object *mo;
1577 mo = drm_mode_object_find(dev, id, DRM_MODE_OBJECT_PROPERTY);
1578 return mo ? obj_to_property(mo) : NULL;
1579}
1580
Matt Ropere27dde32014-04-01 15:22:30 -07001581/* Plane list iterator for legacy (overlay only) planes. */
1582#define drm_for_each_legacy_plane(plane, planelist) \
1583 list_for_each_entry(plane, planelist, head) \
1584 if (plane->type == DRM_PLANE_TYPE_OVERLAY)
1585
Dave Airlief453ba02008-11-07 14:05:41 -08001586#endif /* __DRM_CRTC_H__ */