include/drm/drm_modes.h

3  * Copyright © 2007-2008 Dave Airlie
4  * Copyright © 2007-2008 Intel Corporation
40  * DVI, etc.  And 'screen' refers to the whole of the visible display, which
46  * enum drm_mode_status - hardware support status of a mode
50  * @MODE_H_ILLEGAL: mode has illegal horizontal timings
51  * @MODE_V_ILLEGAL: mode has illegal vertical timings
129 	MODE_STALE = -3,
130 	MODE_BAD = -2,
131 	MODE_ERROR = -1
142  * DRM_MODE_RES_MM - Calculates the display size from resolution and DPI
157  * DRM_MODE_INIT - Initialize display mode
161  * @hd_mm: Display width in millimeters
162  * @vd_mm: Display height in millimeters
171  * DRM_SIMPLE_MODE - Simple display mode
174  * @hd_mm: Display width in millimeters
175  * @vd_mm: Display height in millimeters
184 #define CRTC_STEREO_DOUBLE	(1 << 1) /* adjust timings for stereo modes */
198  * struct drm_display_mode - DRM kernel-internal display mode structure
199  * @hdisplay: horizontal display size
204  * @vdisplay: vertical display size
209  * @crtc_hdisplay: hardware mode horizontal display size
216  * @crtc_vdisplay: hardware mode vertical display size
223  * This is the kernel API display mode information structure. For the
224  * user-space version see struct drm_mode_modeinfo.
226  * The horizontal and vertical timings are defined per the following diagram.
233  *     <-----------------------><----------------><-------------><-------------->
238  *     <----- [hv]display ----->
239  *     <------------- [hv]sync_start ------------>
240  *     <--------------------- [hv]sync_end --------------------->
241  *     <-------------------------------- [hv]total ----------------------------->*
243  * This structure contains two copies of timings. First are the plain timings,
246  * there's the hardware timings, which are corrected for interlacing,
247  * double-clocking and similar things. They are provided as a convenience, and
274 	 *  - DRM_MODE_FLAG_PHSYNC: horizontal sync is active high.
275 	 *  - DRM_MODE_FLAG_NHSYNC: horizontal sync is active low.
276 	 *  - DRM_MODE_FLAG_PVSYNC: vertical sync is active high.
277 	 *  - DRM_MODE_FLAG_NVSYNC: vertical sync is active low.
278 	 *  - DRM_MODE_FLAG_INTERLACE: mode is interlaced.
279 	 *  - DRM_MODE_FLAG_DBLSCAN: mode uses doublescan.
280 	 *  - DRM_MODE_FLAG_CSYNC: mode uses composite sync.
281 	 *  - DRM_MODE_FLAG_PCSYNC: composite sync is active high.
282 	 *  - DRM_MODE_FLAG_NCSYNC: composite sync is active low.
283 	 *  - DRM_MODE_FLAG_HSKEW: hskew provided (not used?).
284 	 *  - DRM_MODE_FLAG_BCAST: <deprecated>
285 	 *  - DRM_MODE_FLAG_PIXMUX: <deprecated>
286 	 *  - DRM_MODE_FLAG_DBLCLK: double-clocked mode.
287 	 *  - DRM_MODE_FLAG_CLKDIV2: half-clocked mode.
291 	 *  - DRM_MODE_FLAG_3D_NONE: normal, non-3D mode.
292 	 *  - DRM_MODE_FLAG_3D_FRAME_PACKING: 2 full frames for left and right.
293 	 *  - DRM_MODE_FLAG_3D_FIELD_ALTERNATIVE: interleaved like fields.
294 	 *  - DRM_MODE_FLAG_3D_LINE_ALTERNATIVE: interleaved lines.
295 	 *  - DRM_MODE_FLAG_3D_SIDE_BY_SIDE_FULL: side-by-side full frames.
296 	 *  - DRM_MODE_FLAG_3D_L_DEPTH: ?
297 	 *  - DRM_MODE_FLAG_3D_L_DEPTH_GFX_GFX_DEPTH: ?
298 	 *  - DRM_MODE_FLAG_3D_TOP_AND_BOTTOM: frame split into top and bottom
300 	 *  - DRM_MODE_FLAG_3D_SIDE_BY_SIDE_HALF: frame split into left and
309 	 * logical @clock when e.g. using interlacing, double-clocking, stereo
310 	 * modes or other fancy stuff that changes the timings and signals
357 	 *  - DRM_MODE_TYPE_PREFERRED: Preferred mode, usually the native
360 	 *  - DRM_MODE_TYPE_DRIVER: Mode created by the driver, which is all of
363 	 *  - DRM_MODE_TYPE_USERDEF: Mode defined or selected via the kernel
370 	 *  - DRM_MODE_TYPE_BUILTIN: Meant for hard-coded modes, unused.
372 	 *  - DRM_MODE_TYPE_DEFAULT: Again a leftover, use
374 	 *  - DRM_MODE_TYPE_CLOCK_C and DRM_MODE_TYPE_CRTC_C: Define leftovers
385 	 * user-mode's list in drm_mode_getconnector ioctl. The purpose of
401 	 * Human-readable name of the mode, filled out with drm_mode_set_name().
423  * DRM_MODE_FMT - printf string for &struct drm_display_mode
428  * DRM_MODE_ARG - printf arguments for &struct drm_display_mode
429  * @m: display mode
432 	(m)->name, drm_mode_vrefresh(m), (m)->clock, \
433 	(m)->hdisplay, (m)->hsync_start, (m)->hsync_end, (m)->htotal, \
434 	(m)->vdisplay, (m)->vsync_start, (m)->vsync_end, (m)->vtotal, \
435 	(m)->type, (m)->flags
440  * drm_mode_is_stereo - check for stereo mode flags
444  * True if the mode is one of the stereo modes (like side-by-side), false if
449 	return mode->flags & DRM_MODE_FLAG_3D_MASK;  in drm_mode_is_stereo()
464 bool drm_mode_is_420_only(const struct drm_display_info *display,
466 bool drm_mode_is_420_also(const struct drm_display_info *display,
468 bool drm_mode_is_420(const struct drm_display_info *display,
520 	return -EINVAL;  in of_get_drm_display_mode()
526 	return -EINVAL;  in of_get_drm_panel_display_mode()