7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Header for DRM modesetting interface.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * \author Jakob Bornecrantz <wallbraker@gmail.com>
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * \par Acknowledgements:
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Feb 2007, Dave Airlie <airlied@linux.ie>
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Copyright (c) 2007-2008 Tungsten Graphics, Inc., Cedar Park, Texas.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Copyright (c) 2007-2008 Dave Airlie <airlied@linux.ie>
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Copyright (c) 2007-2008 Jakob Bornecrantz <wallbraker@gmail.com>
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Permission is hereby granted, free of charge, to any person obtaining a
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * copy of this software and associated documentation files (the "Software"),
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * to deal in the Software without restriction, including without limitation
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * the rights to use, copy, modify, merge, publish, distribute, sublicense,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * and/or sell copies of the Software, and to permit persons to whom the
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Software is furnished to do so, subject to the following conditions:
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * The above copyright notice and this permission notice shall be included in
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * all copies or substantial portions of the Software.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * IN THE SOFTWARE.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * This is the interface for modesetting for drm.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * In order to use this interface you must include either <stdint.h> or another
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * header defining uint32_t, int32_t and uint16_t.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * It aims to provide a randr1.2 compatible interface for modesettings in the
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * kernel, the interface is also ment to be used by libraries like EGL.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * More information can be found in randrproto.txt which can be found here:
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * http://gitweb.freedesktop.org/?p=xorg/proto/randrproto.git
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * There are some major diffrences to be noted. Unlike the randr1.2 proto you
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * need to create the memory object of the framebuffer yourself with the ttm
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * buffer object interface. This object needs to be pinned.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * If we pickup an old version of drm.h which doesn't include drm_mode.h
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * we should redefine defines. This is so that builds doesn't breaks with
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * new libdrm on old kernels.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync#define DRM_MODE_TYPE_CLOCK_C ((1<<1) | DRM_MODE_TYPE_BUILTIN)
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync#define DRM_MODE_TYPE_CRTC_C ((1<<2) | DRM_MODE_TYPE_BUILTIN)
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* Video mode flags */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* bit compatible with the xorg definitions. */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync#define DRM_MODE_FLAG_HSKEW (1<<9) /* hskew provided */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* DPMS flags */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* bit compatible with the xorg definitions. */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* Scaling mode options */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync/* Dithering mode options */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync#define DRM_MODE_PROP_ENUM (1<<3) /* enumerated type with text strings */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync#endif /* _DRM_MODE_H */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint16_t hdisplay, hsync_start, hsync_end, htotal, hskew;
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint16_t vdisplay, vsync_start, vsync_end, vtotal, vscan;
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync /* driver specific handle */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint32_t buffer_id; /**< FB id to connect to 0 = disconnect */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsynctypedef enum {
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsynctypedef enum {
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint32_t encoder_id; /**< Encoder currently connected to */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint32_t mmWidth, mmHeight; /**< HxW in millimeters */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint64_t *prop_values; /**< List of property values */
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreeModeInfo( drmModeModeInfoPtr ptr );
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreeResources( drmModeResPtr ptr );
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreeConnector( drmModeConnectorPtr ptr );
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreeEncoder( drmModeEncoderPtr ptr );
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Retrives all of the resources associated with a card.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * FrameBuffer manipulation.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Retrive information about framebuffer bufferId
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern drmModeFBPtr drmModeGetFB(int fd, uint32_t bufferId);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Creates a new framebuffer with an buffer object as its scanout buffer.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmModeAddFB(int fd, uint32_t width, uint32_t height, uint8_t depth,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Destroies the given framebuffer.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Crtc functions
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Retrive information about the ctrt crtcId
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern drmModeCrtcPtr drmModeGetCrtc(int fd, uint32_t crtcId);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Set the mode on a crtc crtcId with the given mode modeId.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncint drmModeSetCrtc(int fd, uint32_t crtcId, uint32_t bufferId,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync uint32_t x, uint32_t y, uint32_t *connectors, int count,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Cursor functions
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Set the cursor on crtc
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncint drmModeSetCursor(int fd, uint32_t crtcId, uint32_t bo_handle, uint32_t width, uint32_t height);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Move the cursor on crtc
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncint drmModeMoveCursor(int fd, uint32_t crtcId, int x, int y);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Encoder functions
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncdrmModeEncoderPtr drmModeGetEncoder(int fd, uint32_t encoder_id);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Connector manipulation
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Retrive information about the connector connectorId.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern drmModeConnectorPtr drmModeGetConnector(int fd,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Attaches the given mode to an connector.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmModeAttachMode(int fd, uint32_t connectorId, drmModeModeInfoPtr mode_info);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * Detaches a mode from the connector
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsync * must be unused, by the given mode.
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmModeDetachMode(int fd, uint32_t connectorId, drmModeModeInfoPtr mode_info);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern drmModePropertyPtr drmModeGetProperty(int fd, uint32_t propertyId);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreeProperty(drmModePropertyPtr ptr);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern drmModePropertyBlobPtr drmModeGetPropertyBlob(int fd, uint32_t blob_id);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern void drmModeFreePropertyBlob(drmModePropertyBlobPtr ptr);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmModeConnectorSetProperty(int fd, uint32_t connector_id, uint32_t property_id,
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmCheckModesettingSupported(const char *busid);
7a0d67332f33bc21290d63bc7c8150b0cf0a4b21vboxsyncextern int drmModeCrtcSetGamma(int fd, uint32_t crtc_id, uint32_t size,