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
40 #include <sys/ioctl.h>
43 #include <sys/types.h>
45 #include <sys/sysctl.h>
50 #include "libdrm_macros.h"
51 #include "xf86drmMode.h"
54 #include <drm_fourcc.h>
60 #define memclear(s) memset(&s, 0, sizeof(s))
62 #define U642VOID(x) ((void *)(unsigned long)(x))
63 #define VOID2U64(x) ((uint64_t)(unsigned long)(x))
65 static inline int DRM_IOCTL(int fd, unsigned long cmd, void *arg)
67 int ret = drmIoctl(fd, cmd, arg);
68 return ret < 0 ? -errno : ret;
75 static void* drmAllocCpy(char *array, int count, int entry_size)
80 if (!count || !array || !entry_size)
83 if (!(r = drmMalloc(count*entry_size)))
86 for (i = 0; i < count; i++)
87 memcpy(r+(entry_size*i), array+(entry_size*i), entry_size);
93 * A couple of free functions.
96 drm_public void drmModeFreeModeInfo(drmModeModeInfoPtr ptr)
104 drm_public void drmModeFreeResources(drmModeResPtr ptr)
111 drmFree(ptr->connectors);
112 drmFree(ptr->encoders);
116 drm_public void drmModeFreeFB(drmModeFBPtr ptr)
121 /* we might add more frees later. */
125 drm_public void drmModeFreeCrtc(drmModeCrtcPtr ptr)
133 drm_public void drmModeFreeConnector(drmModeConnectorPtr ptr)
138 drmFree(ptr->encoders);
139 drmFree(ptr->prop_values);
145 drm_public void drmModeFreeEncoder(drmModeEncoderPtr ptr)
151 * ModeSetting functions.
154 drm_public int drmIsKMS(int fd)
156 struct drm_mode_card_res res = {0};
158 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res) != 0)
161 return res.count_crtcs > 0 && res.count_connectors > 0 && res.count_encoders > 0;
164 drm_public drmModeResPtr drmModeGetResources(int fd)
166 struct drm_mode_card_res res, counts;
171 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res))
177 res.fb_id_ptr = VOID2U64(drmMalloc(res.count_fbs*sizeof(uint32_t)));
181 if (res.count_crtcs) {
182 res.crtc_id_ptr = VOID2U64(drmMalloc(res.count_crtcs*sizeof(uint32_t)));
183 if (!res.crtc_id_ptr)
186 if (res.count_connectors) {
187 res.connector_id_ptr = VOID2U64(drmMalloc(res.count_connectors*sizeof(uint32_t)));
188 if (!res.connector_id_ptr)
191 if (res.count_encoders) {
192 res.encoder_id_ptr = VOID2U64(drmMalloc(res.count_encoders*sizeof(uint32_t)));
193 if (!res.encoder_id_ptr)
197 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res))
200 /* The number of available connectors and etc may have changed with a
201 * hotplug event in between the ioctls, in which case the field is
202 * silently ignored by the kernel.
204 if (counts.count_fbs < res.count_fbs ||
205 counts.count_crtcs < res.count_crtcs ||
206 counts.count_connectors < res.count_connectors ||
207 counts.count_encoders < res.count_encoders)
209 drmFree(U642VOID(res.fb_id_ptr));
210 drmFree(U642VOID(res.crtc_id_ptr));
211 drmFree(U642VOID(res.connector_id_ptr));
212 drmFree(U642VOID(res.encoder_id_ptr));
220 if (!(r = drmMalloc(sizeof(*r))))
223 r->min_width = res.min_width;
224 r->max_width = res.max_width;
225 r->min_height = res.min_height;
226 r->max_height = res.max_height;
227 r->count_fbs = res.count_fbs;
228 r->count_crtcs = res.count_crtcs;
229 r->count_connectors = res.count_connectors;
230 r->count_encoders = res.count_encoders;
232 r->fbs = drmAllocCpy(U642VOID(res.fb_id_ptr), res.count_fbs, sizeof(uint32_t));
233 r->crtcs = drmAllocCpy(U642VOID(res.crtc_id_ptr), res.count_crtcs, sizeof(uint32_t));
234 r->connectors = drmAllocCpy(U642VOID(res.connector_id_ptr), res.count_connectors, sizeof(uint32_t));
235 r->encoders = drmAllocCpy(U642VOID(res.encoder_id_ptr), res.count_encoders, sizeof(uint32_t));
236 if ((res.count_fbs && !r->fbs) ||
237 (res.count_crtcs && !r->crtcs) ||
238 (res.count_connectors && !r->connectors) ||
239 (res.count_encoders && !r->encoders))
243 drmFree(r->connectors);
244 drmFree(r->encoders);
250 drmFree(U642VOID(res.fb_id_ptr));
251 drmFree(U642VOID(res.crtc_id_ptr));
252 drmFree(U642VOID(res.connector_id_ptr));
253 drmFree(U642VOID(res.encoder_id_ptr));
259 drm_public int drmModeAddFB(int fd, uint32_t width, uint32_t height, uint8_t depth,
260 uint8_t bpp, uint32_t pitch, uint32_t bo_handle,
263 struct drm_mode_fb_cmd f;
272 f.handle = bo_handle;
274 if ((ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_ADDFB, &f)))
281 drm_public int drmModeAddFB2WithModifiers(int fd, uint32_t width,
282 uint32_t height, uint32_t pixel_format, const uint32_t bo_handles[4],
283 const uint32_t pitches[4], const uint32_t offsets[4],
284 const uint64_t modifier[4], uint32_t *buf_id, uint32_t flags)
286 struct drm_mode_fb_cmd2 f;
292 f.pixel_format = pixel_format;
294 memcpy(f.handles, bo_handles, 4 * sizeof(bo_handles[0]));
295 memcpy(f.pitches, pitches, 4 * sizeof(pitches[0]));
296 memcpy(f.offsets, offsets, 4 * sizeof(offsets[0]));
298 memcpy(f.modifier, modifier, 4 * sizeof(modifier[0]));
300 if ((ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_ADDFB2, &f)))
307 drm_public int drmModeAddFB2(int fd, uint32_t width, uint32_t height,
308 uint32_t pixel_format, const uint32_t bo_handles[4],
309 const uint32_t pitches[4], const uint32_t offsets[4],
310 uint32_t *buf_id, uint32_t flags)
312 return drmModeAddFB2WithModifiers(fd, width, height,
313 pixel_format, bo_handles,
314 pitches, offsets, NULL,
318 drm_public int drmModeRmFB(int fd, uint32_t bufferId)
320 return DRM_IOCTL(fd, DRM_IOCTL_MODE_RMFB, &bufferId);
323 drm_public drmModeFBPtr drmModeGetFB(int fd, uint32_t buf)
325 struct drm_mode_fb_cmd info;
331 if (drmIoctl(fd, DRM_IOCTL_MODE_GETFB, &info))
334 if (!(r = drmMalloc(sizeof(*r))))
337 r->fb_id = info.fb_id;
338 r->width = info.width;
339 r->height = info.height;
340 r->pitch = info.pitch;
342 r->handle = info.handle;
343 r->depth = info.depth;
348 drm_public int drmModeDirtyFB(int fd, uint32_t bufferId,
349 drmModeClipPtr clips, uint32_t num_clips)
351 struct drm_mode_fb_dirty_cmd dirty;
354 dirty.fb_id = bufferId;
355 dirty.clips_ptr = VOID2U64(clips);
356 dirty.num_clips = num_clips;
358 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DIRTYFB, &dirty);
365 drm_public drmModeCrtcPtr drmModeGetCrtc(int fd, uint32_t crtcId)
367 struct drm_mode_crtc crtc;
371 crtc.crtc_id = crtcId;
373 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCRTC, &crtc))
380 if (!(r = drmMalloc(sizeof(*r))))
383 r->crtc_id = crtc.crtc_id;
386 r->mode_valid = crtc.mode_valid;
388 memcpy(&r->mode, &crtc.mode, sizeof(struct drm_mode_modeinfo));
389 r->width = crtc.mode.hdisplay;
390 r->height = crtc.mode.vdisplay;
392 r->buffer_id = crtc.fb_id;
393 r->gamma_size = crtc.gamma_size;
397 drm_public int drmModeSetCrtc(int fd, uint32_t crtcId, uint32_t bufferId,
398 uint32_t x, uint32_t y, uint32_t *connectors, int count,
399 drmModeModeInfoPtr mode)
401 struct drm_mode_crtc crtc;
406 crtc.crtc_id = crtcId;
407 crtc.fb_id = bufferId;
408 crtc.set_connectors_ptr = VOID2U64(connectors);
409 crtc.count_connectors = count;
411 memcpy(&crtc.mode, mode, sizeof(struct drm_mode_modeinfo));
415 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETCRTC, &crtc);
419 * Cursor manipulation
422 drm_public int drmModeSetCursor(int fd, uint32_t crtcId, uint32_t bo_handle,
423 uint32_t width, uint32_t height)
425 struct drm_mode_cursor arg;
428 arg.flags = DRM_MODE_CURSOR_BO;
429 arg.crtc_id = crtcId;
432 arg.handle = bo_handle;
434 return DRM_IOCTL(fd, DRM_IOCTL_MODE_CURSOR, &arg);
437 drm_public int drmModeSetCursor2(int fd, uint32_t crtcId, uint32_t bo_handle,
438 uint32_t width, uint32_t height, int32_t hot_x,
441 struct drm_mode_cursor2 arg;
444 arg.flags = DRM_MODE_CURSOR_BO;
445 arg.crtc_id = crtcId;
448 arg.handle = bo_handle;
452 return DRM_IOCTL(fd, DRM_IOCTL_MODE_CURSOR2, &arg);
455 drm_public int drmModeMoveCursor(int fd, uint32_t crtcId, int x, int y)
457 struct drm_mode_cursor arg;
460 arg.flags = DRM_MODE_CURSOR_MOVE;
461 arg.crtc_id = crtcId;
465 return DRM_IOCTL(fd, DRM_IOCTL_MODE_CURSOR, &arg);
471 drm_public drmModeEncoderPtr drmModeGetEncoder(int fd, uint32_t encoder_id)
473 struct drm_mode_get_encoder enc;
474 drmModeEncoderPtr r = NULL;
477 enc.encoder_id = encoder_id;
479 if (drmIoctl(fd, DRM_IOCTL_MODE_GETENCODER, &enc))
482 if (!(r = drmMalloc(sizeof(*r))))
485 r->encoder_id = enc.encoder_id;
486 r->crtc_id = enc.crtc_id;
487 r->encoder_type = enc.encoder_type;
488 r->possible_crtcs = enc.possible_crtcs;
489 r->possible_clones = enc.possible_clones;
495 * Connector manipulation
497 static drmModeConnectorPtr
498 _drmModeGetConnector(int fd, uint32_t connector_id, int probe)
500 struct drm_mode_get_connector conn, counts;
501 drmModeConnectorPtr r = NULL;
502 struct drm_mode_modeinfo stack_mode;
505 conn.connector_id = connector_id;
507 conn.count_modes = 1;
508 conn.modes_ptr = VOID2U64(&stack_mode);
511 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCONNECTOR, &conn))
517 if (conn.count_props) {
518 conn.props_ptr = VOID2U64(drmMalloc(conn.count_props*sizeof(uint32_t)));
521 conn.prop_values_ptr = VOID2U64(drmMalloc(conn.count_props*sizeof(uint64_t)));
522 if (!conn.prop_values_ptr)
526 if (conn.count_modes) {
527 conn.modes_ptr = VOID2U64(drmMalloc(conn.count_modes*sizeof(struct drm_mode_modeinfo)));
531 conn.count_modes = 1;
532 conn.modes_ptr = VOID2U64(&stack_mode);
535 if (conn.count_encoders) {
536 conn.encoders_ptr = VOID2U64(drmMalloc(conn.count_encoders*sizeof(uint32_t)));
537 if (!conn.encoders_ptr)
541 if (drmIoctl(fd, DRM_IOCTL_MODE_GETCONNECTOR, &conn))
544 /* The number of available connectors and etc may have changed with a
545 * hotplug event in between the ioctls, in which case the field is
546 * silently ignored by the kernel.
548 if (counts.count_props < conn.count_props ||
549 counts.count_modes < conn.count_modes ||
550 counts.count_encoders < conn.count_encoders) {
551 drmFree(U642VOID(conn.props_ptr));
552 drmFree(U642VOID(conn.prop_values_ptr));
553 if (U642VOID(conn.modes_ptr) != &stack_mode)
554 drmFree(U642VOID(conn.modes_ptr));
555 drmFree(U642VOID(conn.encoders_ptr));
560 if(!(r = drmMalloc(sizeof(*r)))) {
564 r->connector_id = conn.connector_id;
565 r->encoder_id = conn.encoder_id;
566 r->connection = conn.connection;
567 r->mmWidth = conn.mm_width;
568 r->mmHeight = conn.mm_height;
569 /* convert subpixel from kernel to userspace */
570 r->subpixel = conn.subpixel + 1;
571 r->count_modes = conn.count_modes;
572 r->count_props = conn.count_props;
573 r->props = drmAllocCpy(U642VOID(conn.props_ptr), conn.count_props, sizeof(uint32_t));
574 r->prop_values = drmAllocCpy(U642VOID(conn.prop_values_ptr), conn.count_props, sizeof(uint64_t));
575 r->modes = drmAllocCpy(U642VOID(conn.modes_ptr), conn.count_modes, sizeof(struct drm_mode_modeinfo));
576 r->count_encoders = conn.count_encoders;
577 r->encoders = drmAllocCpy(U642VOID(conn.encoders_ptr), conn.count_encoders, sizeof(uint32_t));
578 r->connector_type = conn.connector_type;
579 r->connector_type_id = conn.connector_type_id;
581 if ((r->count_props && !r->props) ||
582 (r->count_props && !r->prop_values) ||
583 (r->count_modes && !r->modes) ||
584 (r->count_encoders && !r->encoders)) {
586 drmFree(r->prop_values);
588 drmFree(r->encoders);
594 drmFree(U642VOID(conn.prop_values_ptr));
595 drmFree(U642VOID(conn.props_ptr));
596 if (U642VOID(conn.modes_ptr) != &stack_mode)
597 drmFree(U642VOID(conn.modes_ptr));
598 drmFree(U642VOID(conn.encoders_ptr));
603 drm_public drmModeConnectorPtr drmModeGetConnector(int fd, uint32_t connector_id)
605 return _drmModeGetConnector(fd, connector_id, 1);
608 drm_public drmModeConnectorPtr drmModeGetConnectorCurrent(int fd, uint32_t connector_id)
610 return _drmModeGetConnector(fd, connector_id, 0);
613 drm_public uint32_t drmModeConnectorGetPossibleCrtcs(int fd,
614 const drmModeConnector *connector)
616 drmModeEncoder *encoder;
618 uint32_t possible_crtcs;
621 for (i = 0; i < connector->count_encoders; i++) {
622 encoder = drmModeGetEncoder(fd, connector->encoders[i]);
627 possible_crtcs |= encoder->possible_crtcs;
628 drmModeFreeEncoder(encoder);
631 if (possible_crtcs == 0)
633 return possible_crtcs;
636 drm_public int drmModeAttachMode(int fd, uint32_t connector_id, drmModeModeInfoPtr mode_info)
638 struct drm_mode_mode_cmd res;
641 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
642 res.connector_id = connector_id;
644 return DRM_IOCTL(fd, DRM_IOCTL_MODE_ATTACHMODE, &res);
647 drm_public int drmModeDetachMode(int fd, uint32_t connector_id, drmModeModeInfoPtr mode_info)
649 struct drm_mode_mode_cmd res;
652 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
653 res.connector_id = connector_id;
655 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DETACHMODE, &res);
658 drm_public drmModePropertyPtr drmModeGetProperty(int fd, uint32_t property_id)
660 struct drm_mode_get_property prop;
661 drmModePropertyPtr r;
664 prop.prop_id = property_id;
666 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop))
669 if (prop.count_values)
670 prop.values_ptr = VOID2U64(drmMalloc(prop.count_values * sizeof(uint64_t)));
672 if (prop.count_enum_blobs && (prop.flags & (DRM_MODE_PROP_ENUM | DRM_MODE_PROP_BITMASK)))
673 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(struct drm_mode_property_enum)));
675 if (prop.count_enum_blobs && (prop.flags & DRM_MODE_PROP_BLOB)) {
676 prop.values_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
677 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
680 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop)) {
685 if (!(r = drmMalloc(sizeof(*r))))
688 r->prop_id = prop.prop_id;
689 r->count_values = prop.count_values;
691 r->flags = prop.flags;
692 if (prop.count_values)
693 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_values, sizeof(uint64_t));
694 if (prop.flags & (DRM_MODE_PROP_ENUM | DRM_MODE_PROP_BITMASK)) {
695 r->count_enums = prop.count_enum_blobs;
696 r->enums = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(struct drm_mode_property_enum));
697 } else if (prop.flags & DRM_MODE_PROP_BLOB) {
698 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_enum_blobs, sizeof(uint32_t));
699 r->blob_ids = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(uint32_t));
700 r->count_blobs = prop.count_enum_blobs;
702 strncpy(r->name, prop.name, DRM_PROP_NAME_LEN);
703 r->name[DRM_PROP_NAME_LEN-1] = 0;
706 drmFree(U642VOID(prop.values_ptr));
707 drmFree(U642VOID(prop.enum_blob_ptr));
712 drm_public void drmModeFreeProperty(drmModePropertyPtr ptr)
717 drmFree(ptr->values);
719 drmFree(ptr->blob_ids);
723 drm_public drmModePropertyBlobPtr drmModeGetPropertyBlob(int fd,
726 struct drm_mode_get_blob blob;
727 drmModePropertyBlobPtr r;
730 blob.blob_id = blob_id;
732 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob))
736 blob.data = VOID2U64(drmMalloc(blob.length));
738 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob)) {
743 if (!(r = drmMalloc(sizeof(*r))))
746 r->id = blob.blob_id;
747 r->length = blob.length;
748 r->data = drmAllocCpy(U642VOID(blob.data), 1, blob.length);
751 drmFree(U642VOID(blob.data));
755 static inline const uint32_t *
756 get_formats_ptr(const struct drm_format_modifier_blob *blob)
758 return (const uint32_t *)(((uint8_t *)blob) + blob->formats_offset);
761 static inline const struct drm_format_modifier *
762 get_modifiers_ptr(const struct drm_format_modifier_blob *blob)
764 return (const struct drm_format_modifier *)(((uint8_t *)blob) +
765 blob->modifiers_offset);
768 static bool _drmModeFormatModifierGetNext(const drmModePropertyBlobRes *blob,
769 drmModeFormatModifierIterator *iter)
771 const struct drm_format_modifier *blob_modifiers, *mod;
772 const struct drm_format_modifier_blob *fmt_mod_blob;
773 const uint32_t *blob_formats;
775 assert(blob && iter);
777 fmt_mod_blob = blob->data;
778 blob_modifiers = get_modifiers_ptr(fmt_mod_blob);
779 blob_formats = get_formats_ptr(fmt_mod_blob);
781 /* fmt_idx and mod_idx designate the number of processed formats
784 if (iter->fmt_idx >= fmt_mod_blob->count_formats ||
785 iter->mod_idx >= fmt_mod_blob->count_modifiers)
788 iter->fmt = blob_formats[iter->fmt_idx];
789 iter->mod = DRM_FORMAT_MOD_INVALID;
791 /* From the latest valid found, get the next valid modifier */
792 while (iter->mod_idx < fmt_mod_blob->count_modifiers) {
793 mod = &blob_modifiers[iter->mod_idx++];
795 /* Check if the format that fmt_idx designates, belongs to
796 * this modifier 64-bit window selected via mod->offset.
798 if (iter->fmt_idx < mod->offset ||
799 iter->fmt_idx >= mod->offset + 64)
801 if (!(mod->formats & (1 << (iter->fmt_idx - mod->offset))))
804 iter->mod = mod->modifier;
808 if (iter->mod_idx == fmt_mod_blob->count_modifiers) {
813 /* Since mod_idx reset, in order for the caller to iterate over
814 * the last modifier of the last format, always return true here
815 * and early return from the next call.
821 * Iterate over formats first and then over modifiers. On each call, iter->fmt
822 * is retained until all associated modifiers are returned. Then, either update
823 * iter->fmt with the next format, or exit if there aren't any left.
825 * NOTE: clients should not make any assumption on mod_idx and fmt_idx values
827 * @blob: valid kernel blob holding formats and modifiers
828 * @iter: input and output iterator data. Iter data must be initialised to zero
829 * @return: false, on error or there aren't any further formats or modifiers left.
830 * true, on success and there are more formats or modifiers.
832 drm_public bool drmModeFormatModifierBlobIterNext(const drmModePropertyBlobRes *blob,
833 drmModeFormatModifierIterator *iter)
835 drmModeFormatModifierIterator tmp;
841 tmp.fmt_idx = iter->fmt_idx;
842 tmp.mod_idx = iter->mod_idx;
844 /* With the current state of things, DRM/KMS drivers are allowed to
845 * construct blobs having formats and no modifiers. Userspace can't
846 * legitimately abort in such cases.
848 * While waiting for the kernel to perhaps disallow formats with no
849 * modifiers in IN_FORMATS blobs, skip the format altogether.
852 has_fmt = _drmModeFormatModifierGetNext(blob, &tmp);
853 if (has_fmt && tmp.mod != DRM_FORMAT_MOD_INVALID)
856 } while (has_fmt && tmp.mod == DRM_FORMAT_MOD_INVALID);
861 drm_public void drmModeFreePropertyBlob(drmModePropertyBlobPtr ptr)
870 drm_public int drmModeConnectorSetProperty(int fd, uint32_t connector_id,
871 uint32_t property_id,
874 struct drm_mode_connector_set_property osp;
877 osp.connector_id = connector_id;
878 osp.prop_id = property_id;
881 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETPROPERTY, &osp);
885 * checks if a modesetting capable driver has attached to the pci id
886 * returns 0 if modesetting supported.
887 * -EINVAL or invalid bus id
888 * -ENOSYS if no modesetting support
890 drm_public int drmCheckModesettingSupported(const char *busid)
892 #if defined (__linux__)
893 char pci_dev_dir[1024];
894 int domain, bus, dev, func;
899 ret = sscanf(busid, "pci:%04x:%02x:%02x.%d", &domain, &bus, &dev, &func);
903 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/drm",
904 domain, bus, dev, func);
906 sysdir = opendir(pci_dev_dir);
908 dent = readdir(sysdir);
910 if (!strncmp(dent->d_name, "controlD", 8)) {
915 dent = readdir(sysdir);
922 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/",
923 domain, bus, dev, func);
925 sysdir = opendir(pci_dev_dir);
929 dent = readdir(sysdir);
931 if (!strncmp(dent->d_name, "drm:controlD", 12)) {
936 dent = readdir(sysdir);
942 #elif defined (__FreeBSD__) || defined (__FreeBSD_kernel__)
945 int i, modesetting, ret;
948 /* How many GPUs do we expect in the machine ? */
949 for (i = 0; i < 10; i++) {
950 snprintf(oid, sizeof(oid), "hw.dri.%d.busid", i);
951 len = sizeof(sbusid);
952 ret = sysctlbyname(oid, sbusid, &len, NULL, 0);
958 if (strcmp(sbusid, busid) != 0)
960 snprintf(oid, sizeof(oid), "hw.dri.%d.modesetting", i);
961 len = sizeof(modesetting);
962 ret = sysctlbyname(oid, &modesetting, &len, NULL, 0);
963 if (ret == -1 || len != sizeof(modesetting))
965 return (modesetting ? 0 : -ENOSYS);
967 #elif defined(__DragonFly__)
969 #elif defined(__OpenBSD__)
971 struct drm_mode_card_res res;
974 if ((fd = drmOpen(NULL, busid)) < 0)
977 memset(&res, 0, sizeof(struct drm_mode_card_res));
979 if (drmIoctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res)) {
990 drm_public int drmModeCrtcGetGamma(int fd, uint32_t crtc_id, uint32_t size,
991 uint16_t *red, uint16_t *green,
994 struct drm_mode_crtc_lut l;
999 l.red = VOID2U64(red);
1000 l.green = VOID2U64(green);
1001 l.blue = VOID2U64(blue);
1003 return DRM_IOCTL(fd, DRM_IOCTL_MODE_GETGAMMA, &l);
1006 drm_public int drmModeCrtcSetGamma(int fd, uint32_t crtc_id, uint32_t size,
1007 const uint16_t *red, const uint16_t *green,
1008 const uint16_t *blue)
1010 struct drm_mode_crtc_lut l;
1013 l.crtc_id = crtc_id;
1014 l.gamma_size = size;
1015 l.red = VOID2U64(red);
1016 l.green = VOID2U64(green);
1017 l.blue = VOID2U64(blue);
1019 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETGAMMA, &l);
1022 drm_public int drmHandleEvent(int fd, drmEventContextPtr evctx)
1026 struct drm_event *e;
1027 struct drm_event_vblank *vblank;
1028 struct drm_event_crtc_sequence *seq;
1031 /* The DRM read semantics guarantees that we always get only
1032 * complete events. */
1034 len = read(fd, buffer, sizeof buffer);
1037 if (len < (int)sizeof *e)
1042 e = (struct drm_event *)(buffer + i);
1044 case DRM_EVENT_VBLANK:
1045 if (evctx->version < 1 ||
1046 evctx->vblank_handler == NULL)
1048 vblank = (struct drm_event_vblank *) e;
1049 evctx->vblank_handler(fd,
1053 U642VOID (vblank->user_data));
1055 case DRM_EVENT_FLIP_COMPLETE:
1056 vblank = (struct drm_event_vblank *) e;
1057 user_data = U642VOID (vblank->user_data);
1059 if (evctx->version >= 3 && evctx->page_flip_handler2)
1060 evctx->page_flip_handler2(fd,
1066 else if (evctx->version >= 2 && evctx->page_flip_handler)
1067 evctx->page_flip_handler(fd,
1073 case DRM_EVENT_CRTC_SEQUENCE:
1074 seq = (struct drm_event_crtc_sequence *) e;
1075 if (evctx->version >= 4 && evctx->sequence_handler)
1076 evctx->sequence_handler(fd,
1090 drm_public int drmModePageFlip(int fd, uint32_t crtc_id, uint32_t fb_id,
1091 uint32_t flags, void *user_data)
1093 struct drm_mode_crtc_page_flip flip;
1097 flip.crtc_id = crtc_id;
1098 flip.user_data = VOID2U64(user_data);
1101 return DRM_IOCTL(fd, DRM_IOCTL_MODE_PAGE_FLIP, &flip);
1104 drm_public int drmModePageFlipTarget(int fd, uint32_t crtc_id, uint32_t fb_id,
1105 uint32_t flags, void *user_data,
1106 uint32_t target_vblank)
1108 struct drm_mode_crtc_page_flip_target flip_target;
1110 memclear(flip_target);
1111 flip_target.fb_id = fb_id;
1112 flip_target.crtc_id = crtc_id;
1113 flip_target.user_data = VOID2U64(user_data);
1114 flip_target.flags = flags;
1115 flip_target.sequence = target_vblank;
1117 return DRM_IOCTL(fd, DRM_IOCTL_MODE_PAGE_FLIP, &flip_target);
1120 drm_public int drmModeSetPlane(int fd, uint32_t plane_id, uint32_t crtc_id,
1121 uint32_t fb_id, uint32_t flags,
1122 int32_t crtc_x, int32_t crtc_y,
1123 uint32_t crtc_w, uint32_t crtc_h,
1124 uint32_t src_x, uint32_t src_y,
1125 uint32_t src_w, uint32_t src_h)
1127 struct drm_mode_set_plane s;
1130 s.plane_id = plane_id;
1131 s.crtc_id = crtc_id;
1143 return DRM_IOCTL(fd, DRM_IOCTL_MODE_SETPLANE, &s);
1146 drm_public drmModePlanePtr drmModeGetPlane(int fd, uint32_t plane_id)
1148 struct drm_mode_get_plane ovr, counts;
1149 drmModePlanePtr r = 0;
1153 ovr.plane_id = plane_id;
1154 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPLANE, &ovr))
1159 if (ovr.count_format_types) {
1160 ovr.format_type_ptr = VOID2U64(drmMalloc(ovr.count_format_types *
1162 if (!ovr.format_type_ptr)
1166 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPLANE, &ovr))
1169 if (counts.count_format_types < ovr.count_format_types) {
1170 drmFree(U642VOID(ovr.format_type_ptr));
1174 if (!(r = drmMalloc(sizeof(*r))))
1177 r->count_formats = ovr.count_format_types;
1178 r->plane_id = ovr.plane_id;
1179 r->crtc_id = ovr.crtc_id;
1180 r->fb_id = ovr.fb_id;
1181 r->possible_crtcs = ovr.possible_crtcs;
1182 r->gamma_size = ovr.gamma_size;
1183 r->formats = drmAllocCpy(U642VOID(ovr.format_type_ptr),
1184 ovr.count_format_types, sizeof(uint32_t));
1185 if (ovr.count_format_types && !r->formats) {
1186 drmFree(r->formats);
1192 drmFree(U642VOID(ovr.format_type_ptr));
1197 drm_public void drmModeFreePlane(drmModePlanePtr ptr)
1202 drmFree(ptr->formats);
1206 drm_public drmModePlaneResPtr drmModeGetPlaneResources(int fd)
1208 struct drm_mode_get_plane_res res, counts;
1209 drmModePlaneResPtr r = 0;
1213 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPLANERESOURCES, &res))
1218 if (res.count_planes) {
1219 res.plane_id_ptr = VOID2U64(drmMalloc(res.count_planes *
1221 if (!res.plane_id_ptr)
1225 if (drmIoctl(fd, DRM_IOCTL_MODE_GETPLANERESOURCES, &res))
1228 if (counts.count_planes < res.count_planes) {
1229 drmFree(U642VOID(res.plane_id_ptr));
1233 if (!(r = drmMalloc(sizeof(*r))))
1236 r->count_planes = res.count_planes;
1237 r->planes = drmAllocCpy(U642VOID(res.plane_id_ptr),
1238 res.count_planes, sizeof(uint32_t));
1239 if (res.count_planes && !r->planes) {
1246 drmFree(U642VOID(res.plane_id_ptr));
1251 drm_public void drmModeFreePlaneResources(drmModePlaneResPtr ptr)
1256 drmFree(ptr->planes);
1260 drm_public drmModeObjectPropertiesPtr drmModeObjectGetProperties(int fd,
1262 uint32_t object_type)
1264 struct drm_mode_obj_get_properties properties;
1265 drmModeObjectPropertiesPtr ret = NULL;
1269 memclear(properties);
1270 properties.obj_id = object_id;
1271 properties.obj_type = object_type;
1273 if (drmIoctl(fd, DRM_IOCTL_MODE_OBJ_GETPROPERTIES, &properties))
1276 count = properties.count_props;
1279 properties.props_ptr = VOID2U64(drmMalloc(count *
1281 if (!properties.props_ptr)
1283 properties.prop_values_ptr = VOID2U64(drmMalloc(count *
1285 if (!properties.prop_values_ptr)
1289 if (drmIoctl(fd, DRM_IOCTL_MODE_OBJ_GETPROPERTIES, &properties))
1292 if (count < properties.count_props) {
1293 drmFree(U642VOID(properties.props_ptr));
1294 drmFree(U642VOID(properties.prop_values_ptr));
1297 count = properties.count_props;
1299 ret = drmMalloc(sizeof(*ret));
1303 ret->count_props = count;
1304 ret->props = drmAllocCpy(U642VOID(properties.props_ptr),
1305 count, sizeof(uint32_t));
1306 ret->prop_values = drmAllocCpy(U642VOID(properties.prop_values_ptr),
1307 count, sizeof(uint64_t));
1308 if (ret->count_props && (!ret->props || !ret->prop_values)) {
1309 drmFree(ret->props);
1310 drmFree(ret->prop_values);
1316 drmFree(U642VOID(properties.props_ptr));
1317 drmFree(U642VOID(properties.prop_values_ptr));
1321 drm_public void drmModeFreeObjectProperties(drmModeObjectPropertiesPtr ptr)
1325 drmFree(ptr->props);
1326 drmFree(ptr->prop_values);
1330 drm_public int drmModeObjectSetProperty(int fd, uint32_t object_id, uint32_t object_type,
1331 uint32_t property_id, uint64_t value)
1333 struct drm_mode_obj_set_property prop;
1337 prop.prop_id = property_id;
1338 prop.obj_id = object_id;
1339 prop.obj_type = object_type;
1341 return DRM_IOCTL(fd, DRM_IOCTL_MODE_OBJ_SETPROPERTY, &prop);
1344 typedef struct _drmModeAtomicReqItem drmModeAtomicReqItem, *drmModeAtomicReqItemPtr;
1346 struct _drmModeAtomicReqItem {
1348 uint32_t property_id;
1353 struct _drmModeAtomicReq {
1355 uint32_t size_items;
1356 drmModeAtomicReqItemPtr items;
1359 drm_public drmModeAtomicReqPtr drmModeAtomicAlloc(void)
1361 drmModeAtomicReqPtr req;
1363 req = drmMalloc(sizeof *req);
1369 req->size_items = 0;
1374 drm_public drmModeAtomicReqPtr drmModeAtomicDuplicate(const drmModeAtomicReqPtr old)
1376 drmModeAtomicReqPtr new;
1381 new = drmMalloc(sizeof *new);
1385 new->cursor = old->cursor;
1386 new->size_items = old->size_items;
1388 if (old->size_items) {
1389 new->items = drmMalloc(old->size_items * sizeof(*new->items));
1394 memcpy(new->items, old->items,
1395 old->cursor * sizeof(*new->items));
1403 drm_public int drmModeAtomicMerge(drmModeAtomicReqPtr base,
1404 const drmModeAtomicReqPtr augment)
1411 if (!augment || augment->cursor == 0)
1414 if (base->cursor + augment->cursor >= base->size_items) {
1415 drmModeAtomicReqItemPtr new;
1416 int saved_size = base->size_items;
1418 base->size_items = base->cursor + augment->cursor;
1419 new = realloc(base->items,
1420 base->size_items * sizeof(*base->items));
1422 base->size_items = saved_size;
1428 memcpy(&base->items[base->cursor], augment->items,
1429 augment->cursor * sizeof(*augment->items));
1430 for (i = base->cursor; i < base->cursor + augment->cursor; i++)
1431 base->items[i].cursor = i;
1432 base->cursor += augment->cursor;
1437 drm_public int drmModeAtomicGetCursor(const drmModeAtomicReqPtr req)
1444 drm_public void drmModeAtomicSetCursor(drmModeAtomicReqPtr req, int cursor)
1447 req->cursor = cursor;
1450 drm_public int drmModeAtomicAddProperty(drmModeAtomicReqPtr req,
1452 uint32_t property_id,
1458 if (object_id == 0 || property_id == 0)
1461 if (req->cursor >= req->size_items) {
1462 const uint32_t item_size_inc = getpagesize() / sizeof(*req->items);
1463 drmModeAtomicReqItemPtr new;
1465 req->size_items += item_size_inc;
1466 new = realloc(req->items, req->size_items * sizeof(*req->items));
1468 req->size_items -= item_size_inc;
1474 req->items[req->cursor].object_id = object_id;
1475 req->items[req->cursor].property_id = property_id;
1476 req->items[req->cursor].value = value;
1477 req->items[req->cursor].cursor = req->cursor;
1483 drm_public void drmModeAtomicFree(drmModeAtomicReqPtr req)
1489 drmFree(req->items);
1493 static int sort_req_list(const void *misc, const void *other)
1495 const drmModeAtomicReqItem *first = misc;
1496 const drmModeAtomicReqItem *second = other;
1498 if (first->object_id != second->object_id)
1499 return first->object_id - second->object_id;
1500 else if (first->property_id != second->property_id)
1501 return first->property_id - second->property_id;
1503 return first->cursor - second->cursor;
1506 drm_public int drmModeAtomicCommit(int fd, const drmModeAtomicReqPtr req,
1507 uint32_t flags, void *user_data)
1509 drmModeAtomicReqPtr sorted;
1510 struct drm_mode_atomic atomic;
1511 uint32_t *objs_ptr = NULL;
1512 uint32_t *count_props_ptr = NULL;
1513 uint32_t *props_ptr = NULL;
1514 uint64_t *prop_values_ptr = NULL;
1515 uint32_t last_obj_id = 0;
1523 if (req->cursor == 0)
1526 sorted = drmModeAtomicDuplicate(req);
1532 /* Sort the list by object ID, then by property ID. */
1533 qsort(sorted->items, sorted->cursor, sizeof(*sorted->items),
1536 /* Now the list is sorted, eliminate duplicate property sets. */
1537 for (i = 0; i < sorted->cursor; i++) {
1538 if (sorted->items[i].object_id != last_obj_id) {
1539 atomic.count_objs++;
1540 last_obj_id = sorted->items[i].object_id;
1543 if (i == sorted->cursor - 1)
1546 if (sorted->items[i].object_id != sorted->items[i + 1].object_id ||
1547 sorted->items[i].property_id != sorted->items[i + 1].property_id)
1550 memmove(&sorted->items[i], &sorted->items[i + 1],
1551 (sorted->cursor - i - 1) * sizeof(*sorted->items));
1555 for (i = 0; i < sorted->cursor; i++)
1556 sorted->items[i].cursor = i;
1558 objs_ptr = drmMalloc(atomic.count_objs * sizeof objs_ptr[0]);
1564 count_props_ptr = drmMalloc(atomic.count_objs * sizeof count_props_ptr[0]);
1565 if (!count_props_ptr) {
1570 props_ptr = drmMalloc(sorted->cursor * sizeof props_ptr[0]);
1576 prop_values_ptr = drmMalloc(sorted->cursor * sizeof prop_values_ptr[0]);
1577 if (!prop_values_ptr) {
1582 for (i = 0, last_obj_id = 0; i < sorted->cursor; i++) {
1583 if (sorted->items[i].object_id != last_obj_id) {
1585 objs_ptr[obj_idx] = sorted->items[i].object_id;
1586 last_obj_id = objs_ptr[obj_idx];
1589 count_props_ptr[obj_idx]++;
1590 props_ptr[i] = sorted->items[i].property_id;
1591 prop_values_ptr[i] = sorted->items[i].value;
1595 atomic.flags = flags;
1596 atomic.objs_ptr = VOID2U64(objs_ptr);
1597 atomic.count_props_ptr = VOID2U64(count_props_ptr);
1598 atomic.props_ptr = VOID2U64(props_ptr);
1599 atomic.prop_values_ptr = VOID2U64(prop_values_ptr);
1600 atomic.user_data = VOID2U64(user_data);
1602 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_ATOMIC, &atomic);
1606 drmFree(count_props_ptr);
1608 drmFree(prop_values_ptr);
1609 drmModeAtomicFree(sorted);
1615 drmModeCreatePropertyBlob(int fd, const void *data, size_t length,
1618 struct drm_mode_create_blob create;
1621 if (length >= 0xffffffff)
1626 create.length = length;
1627 create.data = (uintptr_t) data;
1631 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_CREATEPROPBLOB, &create);
1635 *id = create.blob_id;
1640 drmModeDestroyPropertyBlob(int fd, uint32_t id)
1642 struct drm_mode_destroy_blob destroy;
1645 destroy.blob_id = id;
1646 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DESTROYPROPBLOB, &destroy);
1650 drmModeCreateLease(int fd, const uint32_t *objects, int num_objects, int flags,
1651 uint32_t *lessee_id)
1653 struct drm_mode_create_lease create;
1657 create.object_ids = (uintptr_t) objects;
1658 create.object_count = num_objects;
1659 create.flags = flags;
1661 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_CREATE_LEASE, &create);
1663 *lessee_id = create.lessee_id;
1669 drm_public drmModeLesseeListPtr
1670 drmModeListLessees(int fd)
1672 struct drm_mode_list_lessees list;
1674 drmModeLesseeListPtr ret;
1678 if (DRM_IOCTL(fd, DRM_IOCTL_MODE_LIST_LESSEES, &list))
1681 count = list.count_lessees;
1682 ret = drmMalloc(sizeof (drmModeLesseeListRes) + count * sizeof (ret->lessees[0]));
1686 list.lessees_ptr = VOID2U64(&ret->lessees[0]);
1687 if (DRM_IOCTL(fd, DRM_IOCTL_MODE_LIST_LESSEES, &list)) {
1696 drm_public drmModeObjectListPtr
1697 drmModeGetLease(int fd)
1699 struct drm_mode_get_lease get;
1701 drmModeObjectListPtr ret;
1705 if (DRM_IOCTL(fd, DRM_IOCTL_MODE_GET_LEASE, &get))
1708 count = get.count_objects;
1709 ret = drmMalloc(sizeof (drmModeObjectListRes) + count * sizeof (ret->objects[0]));
1713 get.objects_ptr = VOID2U64(&ret->objects[0]);
1714 if (DRM_IOCTL(fd, DRM_IOCTL_MODE_GET_LEASE, &get)) {
1724 drmModeRevokeLease(int fd, uint32_t lessee_id)
1726 struct drm_mode_revoke_lease revoke;
1731 revoke.lessee_id = lessee_id;
1733 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_REVOKE_LEASE, &revoke);
1739 drm_public drmModeFB2Ptr
1740 drmModeGetFB2(int fd, uint32_t fb_id)
1742 struct drm_mode_fb_cmd2 get = {
1748 err = DRM_IOCTL(fd, DRM_IOCTL_MODE_GETFB2, &get);
1752 ret = drmMalloc(sizeof(drmModeFB2));
1757 ret->width = get.width;
1758 ret->height = get.height;
1759 ret->pixel_format = get.pixel_format;
1760 ret->flags = get.flags;
1761 ret->modifier = get.modifier[0];
1762 memcpy(ret->handles, get.handles, sizeof(uint32_t) * 4);
1763 memcpy(ret->pitches, get.pitches, sizeof(uint32_t) * 4);
1764 memcpy(ret->offsets, get.offsets, sizeof(uint32_t) * 4);
1769 drm_public void drmModeFreeFB2(drmModeFB2Ptr ptr)
1774 drm_public const char *
1775 drmModeGetConnectorTypeName(uint32_t connector_type)
1777 /* Keep the strings in sync with the kernel's drm_connector_enum_list in
1778 * drm_connector.c. */
1779 switch (connector_type) {
1780 case DRM_MODE_CONNECTOR_Unknown:
1782 case DRM_MODE_CONNECTOR_VGA:
1784 case DRM_MODE_CONNECTOR_DVII:
1786 case DRM_MODE_CONNECTOR_DVID:
1788 case DRM_MODE_CONNECTOR_DVIA:
1790 case DRM_MODE_CONNECTOR_Composite:
1792 case DRM_MODE_CONNECTOR_SVIDEO:
1794 case DRM_MODE_CONNECTOR_LVDS:
1796 case DRM_MODE_CONNECTOR_Component:
1798 case DRM_MODE_CONNECTOR_9PinDIN:
1800 case DRM_MODE_CONNECTOR_DisplayPort:
1802 case DRM_MODE_CONNECTOR_HDMIA:
1804 case DRM_MODE_CONNECTOR_HDMIB:
1806 case DRM_MODE_CONNECTOR_TV:
1808 case DRM_MODE_CONNECTOR_eDP:
1810 case DRM_MODE_CONNECTOR_VIRTUAL:
1812 case DRM_MODE_CONNECTOR_DSI:
1814 case DRM_MODE_CONNECTOR_DPI:
1816 case DRM_MODE_CONNECTOR_WRITEBACK:
1818 case DRM_MODE_CONNECTOR_SPI:
1820 case DRM_MODE_CONNECTOR_USB:
1828 drmModeCreateDumbBuffer(int fd, uint32_t width, uint32_t height, uint32_t bpp,
1829 uint32_t flags, uint32_t *handle, uint32_t *pitch,
1833 struct drm_mode_create_dumb create = {
1840 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_CREATE_DUMB, &create);
1844 *handle = create.handle;
1845 *pitch = create.pitch;
1846 *size = create.size;
1851 drmModeDestroyDumbBuffer(int fd, uint32_t handle)
1853 struct drm_mode_destroy_dumb destroy = {
1857 return DRM_IOCTL(fd, DRM_IOCTL_MODE_DESTROY_DUMB, &destroy);
1861 drmModeMapDumbBuffer(int fd, uint32_t handle, uint64_t *offset)
1864 struct drm_mode_map_dumb map = {
1868 ret = DRM_IOCTL(fd, DRM_IOCTL_MODE_MAP_DUMB, &map);
1872 *offset = map.offset;