3 * Header for DRM modesetting interface.
5 * \author Jakob Bornecrantz <wallbraker@gmail.com>
7 * \par Acknowledgements:
8 * Feb 2007, Dave Airlie <airlied@linux.ie>
12 * Copyright (c) 2007-2008 Tungsten Graphics, Inc., Cedar Park, Texas.
13 * Copyright (c) 2007-2008 Dave Airlie <airlied@linux.ie>
14 * Copyright (c) 2007-2008 Jakob Bornecrantz <wallbraker@gmail.com>
16 * Permission is hereby granted, free of charge, to any person obtaining a
17 * copy of this software and associated documentation files (the "Software"),
18 * to deal in the Software without restriction, including without limitation
19 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
20 * and/or sell copies of the Software, and to permit persons to whom the
21 * Software is furnished to do so, subject to the following conditions:
23 * The above copyright notice and this permission notice shall be included in
24 * all copies or substantial portions of the Software.
26 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
27 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
28 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
29 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
30 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
31 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
37 * TODO the types we are after are defined in diffrent headers on diffrent
38 * platforms find which headers to include to get uint32_t
41 #include <sys/ioctl.h>
44 #include "xf86drmMode.h"
52 #define U642VOID(x) ((void *)(unsigned long)(x))
53 #define VOID2U64(x) ((uint64_t)(unsigned long)(x))
55 static inline DRM_IOCTL(int fd, int cmd, void *arg)
57 int ret = drmIoctl(fd, cmd, arg);
58 return ret < 0 ? -errno : ret;
65 void* drmAllocCpy(void *array, int count, int entry_size)
70 if (!count || !array || !entry_size)
73 if (!(r = drmMalloc(count*entry_size)))
76 for (i = 0; i < count; i++)
77 memcpy(r+(entry_size*i), array+(entry_size*i), entry_size);
83 * A couple of free functions.
86 void drmModeFreeModeInfo(drmModeModeInfoPtr ptr)
94 void drmModeFreeResources(drmModeResPtr ptr)
103 void drmModeFreeFB(drmModeFBPtr ptr)
108 /* we might add more frees later. */
112 void drmModeFreeCrtc(drmModeCrtcPtr ptr)
121 void drmModeFreeConnector(drmModeConnectorPtr ptr)
126 drmFree(ptr->encoders);
127 drmFree(ptr->prop_values);
134 void drmModeFreeEncoder(drmModeEncoderPtr ptr)
140 * ModeSetting functions.
143 drmModeResPtr drmModeGetResources(int fd)
145 struct drm_mode_card_res res, counts;
149 memset(&res, 0, sizeof(struct drm_mode_card_res));
150 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res))
156 res.fb_id_ptr = VOID2U64(drmMalloc(res.count_fbs*sizeof(uint32_t)));
160 if (res.count_crtcs) {
161 res.crtc_id_ptr = VOID2U64(drmMalloc(res.count_crtcs*sizeof(uint32_t)));
162 if (!res.crtc_id_ptr)
165 if (res.count_connectors) {
166 res.connector_id_ptr = VOID2U64(drmMalloc(res.count_connectors*sizeof(uint32_t)));
167 if (!res.connector_id_ptr)
170 if (res.count_encoders) {
171 res.encoder_id_ptr = VOID2U64(drmMalloc(res.count_encoders*sizeof(uint32_t)));
172 if (!res.encoder_id_ptr)
176 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res))
179 /* The number of available connectors and etc may have changed with a
180 * hotplug event in between the ioctls, in which case the field is
181 * silently ignored by the kernel.
183 if (counts.count_fbs < res.count_fbs ||
184 counts.count_crtcs < res.count_crtcs ||
185 counts.count_connectors < res.count_connectors ||
186 counts.count_encoders < res.count_encoders)
188 drmFree(U642VOID(res.fb_id_ptr));
189 drmFree(U642VOID(res.crtc_id_ptr));
190 drmFree(U642VOID(res.connector_id_ptr));
191 drmFree(U642VOID(res.encoder_id_ptr));
199 if (!(r = drmMalloc(sizeof(*r))))
202 r->min_width = res.min_width;
203 r->max_width = res.max_width;
204 r->min_height = res.min_height;
205 r->max_height = res.max_height;
206 r->count_fbs = res.count_fbs;
207 r->count_crtcs = res.count_crtcs;
208 r->count_connectors = res.count_connectors;
209 r->count_encoders = res.count_encoders;
211 r->fbs = drmAllocCpy(U642VOID(res.fb_id_ptr), res.count_fbs, sizeof(uint32_t));
212 r->crtcs = drmAllocCpy(U642VOID(res.crtc_id_ptr), res.count_crtcs, sizeof(uint32_t));
213 r->connectors = drmAllocCpy(U642VOID(res.connector_id_ptr), res.count_connectors, sizeof(uint32_t));
214 r->encoders = drmAllocCpy(U642VOID(res.encoder_id_ptr), res.count_encoders, sizeof(uint32_t));
215 if ((res.count_fbs && !r->fbs) ||
216 (res.count_crtcs && !r->crtcs) ||
217 (res.count_connectors && !r->connectors) ||
218 (res.count_encoders && !r->encoders))
222 drmFree(r->connectors);
223 drmFree(r->encoders);
229 drmFree(U642VOID(res.fb_id_ptr));
230 drmFree(U642VOID(res.crtc_id_ptr));
231 drmFree(U642VOID(res.connector_id_ptr));
232 drmFree(U642VOID(res.encoder_id_ptr));
237 int drmModeAddFB(int fd, uint32_t width, uint32_t height, uint8_t depth,
238 uint8_t bpp, uint32_t pitch, uint32_t bo_handle,
241 struct drm_mode_fb_cmd f;
249 f.handle = bo_handle;
251 if ((ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_ADDFB, &f)))
258 int drmModeRmFB(int fd, uint32_t bufferId)
260 return DRM_IOCTL(fd, DRM_IOCTL_MODE_RMFB, &bufferId);
265 drmModeFBPtr drmModeGetFB(int fd, uint32_t buf)
267 struct drm_mode_fb_cmd info;
272 if (drmIoctl(fd, DRM_IOCTL_MODE_GETFB, &info))
275 if (!(r = drmMalloc(sizeof(*r))))
278 r->fb_id = info.fb_id;
279 r->width = info.width;
280 r->height = info.height;
281 r->pitch = info.pitch;
283 r->handle = info.handle;
284 r->depth = info.depth;
289 int drmModeDirtyFB(int fd, uint32_t bufferId,
290 drmModeClipPtr clips, uint32_t num_clips)
292 struct drm_mode_fb_dirty_cmd dirty = { 0 };
294 dirty.fb_id = bufferId;
295 dirty.clips_ptr = VOID2U64(clips);
296 dirty.num_clips = num_clips;
298 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DIRTYFB, &dirty);
306 drmModeCrtcPtr drmModeGetCrtc(int fd, uint32_t crtcId)
308 struct drm_mode_crtc crtc;
311 crtc.crtc_id = crtcId;
313 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCRTC, &crtc))
320 if (!(r = drmMalloc(sizeof(*r))))
323 r->crtc_id = crtc.crtc_id;
326 r->mode_valid = crtc.mode_valid;
328 memcpy(&r->mode, &crtc.mode, sizeof(struct drm_mode_modeinfo));
329 r->buffer_id = crtc.fb_id;
330 r->gamma_size = crtc.gamma_size;
335 int drmModeSetCrtc(int fd, uint32_t crtcId, uint32_t bufferId,
336 uint32_t x, uint32_t y, uint32_t *connectors, int count,
337 drmModeModeInfoPtr mode)
339 struct drm_mode_crtc crtc;
343 crtc.crtc_id = crtcId;
344 crtc.fb_id = bufferId;
345 crtc.set_connectors_ptr = VOID2U64(connectors);
346 crtc.count_connectors = count;
348 memcpy(&crtc.mode, mode, sizeof(struct drm_mode_modeinfo));
353 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETCRTC, &crtc);
357 * Cursor manipulation
360 int drmModeSetCursor(int fd, uint32_t crtcId, uint32_t bo_handle, uint32_t width, uint32_t height)
362 struct drm_mode_cursor arg;
364 arg.flags = DRM_MODE_CURSOR_BO;
365 arg.crtc_id = crtcId;
368 arg.handle = bo_handle;
370 return DRM_IOCTL(fd, DRM_IOCTL_MODE_CURSOR, &arg);
373 int drmModeMoveCursor(int fd, uint32_t crtcId, int x, int y)
375 struct drm_mode_cursor arg;
377 arg.flags = DRM_MODE_CURSOR_MOVE;
378 arg.crtc_id = crtcId;
382 return DRM_IOCTL(fd, DRM_IOCTL_MODE_CURSOR, &arg);
388 drmModeEncoderPtr drmModeGetEncoder(int fd, uint32_t encoder_id)
390 struct drm_mode_get_encoder enc;
391 drmModeEncoderPtr r = NULL;
393 enc.encoder_id = encoder_id;
394 enc.encoder_type = 0;
395 enc.possible_crtcs = 0;
396 enc.possible_clones = 0;
398 if (drmIoctl(fd, DRM_IOCTL_MODE_GETENCODER, &enc))
401 if (!(r = drmMalloc(sizeof(*r))))
404 r->encoder_id = enc.encoder_id;
405 r->crtc_id = enc.crtc_id;
406 r->encoder_type = enc.encoder_type;
407 r->possible_crtcs = enc.possible_crtcs;
408 r->possible_clones = enc.possible_clones;
414 * Connector manipulation
417 drmModeConnectorPtr drmModeGetConnector(int fd, uint32_t connector_id)
419 struct drm_mode_get_connector conn, counts;
420 drmModeConnectorPtr r = NULL;
423 memset(&conn, 0, sizeof(struct drm_mode_get_connector));
424 conn.connector_id = connector_id;
426 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCONNECTOR, &conn))
431 if (conn.count_props) {
432 conn.props_ptr = VOID2U64(drmMalloc(conn.count_props*sizeof(uint32_t)));
435 conn.prop_values_ptr = VOID2U64(drmMalloc(conn.count_props*sizeof(uint64_t)));
436 if (!conn.prop_values_ptr)
440 if (conn.count_modes) {
441 conn.modes_ptr = VOID2U64(drmMalloc(conn.count_modes*sizeof(struct drm_mode_modeinfo)));
446 if (conn.count_encoders) {
447 conn.encoders_ptr = VOID2U64(drmMalloc(conn.count_encoders*sizeof(uint32_t)));
448 if (!conn.encoders_ptr)
452 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCONNECTOR, &conn))
455 /* The number of available connectors and etc may have changed with a
456 * hotplug event in between the ioctls, in which case the field is
457 * silently ignored by the kernel.
459 if (counts.count_props < conn.count_props ||
460 counts.count_modes < conn.count_modes ||
461 counts.count_encoders < conn.count_encoders) {
462 drmFree(U642VOID(conn.props_ptr));
463 drmFree(U642VOID(conn.prop_values_ptr));
464 drmFree(U642VOID(conn.modes_ptr));
465 drmFree(U642VOID(conn.encoders_ptr));
470 if(!(r = drmMalloc(sizeof(*r)))) {
474 r->connector_id = conn.connector_id;
475 r->encoder_id = conn.encoder_id;
476 r->connection = conn.connection;
477 r->mmWidth = conn.mm_width;
478 r->mmHeight = conn.mm_height;
479 /* convert subpixel from kernel to userspace */
480 r->subpixel = conn.subpixel + 1;
481 r->count_modes = conn.count_modes;
482 r->count_props = conn.count_props;
483 r->props = drmAllocCpy(U642VOID(conn.props_ptr), conn.count_props, sizeof(uint32_t));
484 r->prop_values = drmAllocCpy(U642VOID(conn.prop_values_ptr), conn.count_props, sizeof(uint64_t));
485 r->modes = drmAllocCpy(U642VOID(conn.modes_ptr), conn.count_modes, sizeof(struct drm_mode_modeinfo));
486 r->count_encoders = conn.count_encoders;
487 r->encoders = drmAllocCpy(U642VOID(conn.encoders_ptr), conn.count_encoders, sizeof(uint32_t));
488 r->connector_type = conn.connector_type;
489 r->connector_type_id = conn.connector_type_id;
491 if ((r->count_props && !r->props) ||
492 (r->count_props && !r->prop_values) ||
493 (r->count_modes && !r->modes) ||
494 (r->count_encoders && !r->encoders)) {
496 drmFree(r->prop_values);
498 drmFree(r->encoders);
504 drmFree(U642VOID(conn.prop_values_ptr));
505 drmFree(U642VOID(conn.props_ptr));
506 drmFree(U642VOID(conn.modes_ptr));
507 drmFree(U642VOID(conn.encoders_ptr));
512 int drmModeAttachMode(int fd, uint32_t connector_id, drmModeModeInfoPtr mode_info)
514 struct drm_mode_mode_cmd res;
516 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
517 res.connector_id = connector_id;
519 return DRM_IOCTL(fd, DRM_IOCTL_MODE_ATTACHMODE, &res);
522 int drmModeDetachMode(int fd, uint32_t connector_id, drmModeModeInfoPtr mode_info)
524 struct drm_mode_mode_cmd res;
526 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
527 res.connector_id = connector_id;
529 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DETACHMODE, &res);
533 drmModePropertyPtr drmModeGetProperty(int fd, uint32_t property_id)
535 struct drm_mode_get_property prop;
536 drmModePropertyPtr r;
538 prop.prop_id = property_id;
539 prop.count_enum_blobs = 0;
540 prop.count_values = 0;
542 prop.enum_blob_ptr = 0;
545 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop))
548 if (prop.count_values)
549 prop.values_ptr = VOID2U64(drmMalloc(prop.count_values * sizeof(uint64_t)));
551 if (prop.count_enum_blobs && (prop.flags & DRM_MODE_PROP_ENUM))
552 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(struct drm_mode_property_enum)));
554 if (prop.count_enum_blobs && (prop.flags & DRM_MODE_PROP_BLOB)) {
555 prop.values_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
556 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
559 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop)) {
564 if (!(r = drmMalloc(sizeof(*r))))
567 r->prop_id = prop.prop_id;
568 r->count_values = prop.count_values;
570 r->flags = prop.flags;
571 if (prop.count_values)
572 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_values, sizeof(uint64_t));
573 if (prop.flags & DRM_MODE_PROP_ENUM) {
574 r->count_enums = prop.count_enum_blobs;
575 r->enums = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(struct drm_mode_property_enum));
576 } else if (prop.flags & DRM_MODE_PROP_BLOB) {
577 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_enum_blobs, sizeof(uint32_t));
578 r->blob_ids = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(uint32_t));
579 r->count_blobs = prop.count_enum_blobs;
581 strncpy(r->name, prop.name, DRM_PROP_NAME_LEN);
582 r->name[DRM_PROP_NAME_LEN-1] = 0;
585 drmFree(U642VOID(prop.values_ptr));
586 drmFree(U642VOID(prop.enum_blob_ptr));
591 void drmModeFreeProperty(drmModePropertyPtr ptr)
596 drmFree(ptr->values);
601 drmModePropertyBlobPtr drmModeGetPropertyBlob(int fd, uint32_t blob_id)
603 struct drm_mode_get_blob blob;
604 drmModePropertyBlobPtr r;
608 blob.blob_id = blob_id;
610 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob))
614 blob.data = VOID2U64(drmMalloc(blob.length));
616 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob)) {
621 if (!(r = drmMalloc(sizeof(*r))))
624 r->id = blob.blob_id;
625 r->length = blob.length;
626 r->data = drmAllocCpy(U642VOID(blob.data), 1, blob.length);
629 drmFree(U642VOID(blob.data));
633 void drmModeFreePropertyBlob(drmModePropertyBlobPtr ptr)
642 int drmModeConnectorSetProperty(int fd, uint32_t connector_id, uint32_t property_id,
645 struct drm_mode_connector_set_property osp;
647 osp.connector_id = connector_id;
648 osp.prop_id = property_id;
651 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETPROPERTY, &osp);
655 * checks if a modesetting capable driver has attached to the pci id
656 * returns 0 if modesetting supported.
657 * -EINVAL or invalid bus id
658 * -ENOSYS if no modesetting support
660 int drmCheckModesettingSupported(const char *busid)
663 char pci_dev_dir[1024];
664 int domain, bus, dev, func;
669 ret = sscanf(busid, "pci:%04x:%02x:%02x.%d", &domain, &bus, &dev, &func);
673 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/drm",
674 domain, bus, dev, func);
676 sysdir = opendir(pci_dev_dir);
678 dent = readdir(sysdir);
680 if (!strncmp(dent->d_name, "controlD", 8)) {
685 dent = readdir(sysdir);
692 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/",
693 domain, bus, dev, func);
695 sysdir = opendir(pci_dev_dir);
699 dent = readdir(sysdir);
701 if (!strncmp(dent->d_name, "drm:controlD", 12)) {
706 dent = readdir(sysdir);
717 int drmModeCrtcGetGamma(int fd, uint32_t crtc_id, uint32_t size,
718 uint16_t *red, uint16_t *green, uint16_t *blue)
720 struct drm_mode_crtc_lut l;
724 l.red = VOID2U64(red);
725 l.green = VOID2U64(green);
726 l.blue = VOID2U64(blue);
728 return DRM_IOCTL(fd, DRM_IOCTL_MODE_GETGAMMA, &l);
731 int drmModeCrtcSetGamma(int fd, uint32_t crtc_id, uint32_t size,
732 uint16_t *red, uint16_t *green, uint16_t *blue)
734 struct drm_mode_crtc_lut l;
738 l.red = VOID2U64(red);
739 l.green = VOID2U64(green);
740 l.blue = VOID2U64(blue);
742 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETGAMMA, &l);
745 int drmHandleEvent(int fd, drmEventContextPtr evctx)
750 struct drm_event_vblank *vblank;
752 /* The DRM read semantics guarantees that we always get only
753 * complete events. */
755 len = read(fd, buffer, sizeof buffer);
763 e = (struct drm_event *) &buffer[i];
765 case DRM_EVENT_VBLANK:
766 if (evctx->version < 1 ||
767 evctx->vblank_handler == NULL)
769 vblank = (struct drm_event_vblank *) e;
770 evctx->vblank_handler(fd,
774 U642VOID (vblank->user_data));
776 case DRM_EVENT_FLIP_COMPLETE:
777 if (evctx->version < 2 ||
778 evctx->page_flip_handler == NULL)
780 vblank = (struct drm_event_vblank *) e;
781 evctx->page_flip_handler(fd,
785 U642VOID (vblank->user_data));
796 int drmModePageFlip(int fd, uint32_t crtc_id, uint32_t fb_id,
797 uint32_t flags, void *user_data)
799 struct drm_mode_crtc_page_flip flip;
802 flip.crtc_id = crtc_id;
803 flip.user_data = VOID2U64(user_data);
807 return DRM_IOCTL(fd, DRM_IOCTL_MODE_PAGE_FLIP, &flip);