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) <year> <copyright holders>
14 * Permission is hereby granted, free of charge, to any person obtaining a
15 * copy of this software and associated documentation files (the "Software"),
16 * to deal in the Software without restriction, including without limitation
17 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
18 * and/or sell copies of the Software, and to permit persons to whom the
19 * Software is furnished to do so, subject to the following conditions:
21 * The above copyright notice and this permission notice shall be included in
22 * all copies or substantial portions of the Software.
24 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
27 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
29 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
35 * TODO the types we are after are defined in diffrent headers on diffrent
36 * platforms find which headers to include to get uint32_t
39 #include <sys/ioctl.h>
42 #include "xf86drmMode.h"
49 #define U642VOID(x) ((void *)(unsigned long)(x))
50 #define VOID2U64(x) ((uint64_t)(unsigned long)(x))
56 void* drmAllocCpy(void *array, int count, int entry_size)
61 if (!count || !array || !entry_size)
64 if (!(r = drmMalloc(count*entry_size)))
67 for (i = 0; i < count; i++)
68 memcpy(r+(entry_size*i), array+(entry_size*i), entry_size);
74 * A couple of free functions.
77 void drmModeFreeModeInfo(struct drm_mode_modeinfo *ptr)
85 void drmModeFreeResources(drmModeResPtr ptr)
94 void drmModeFreeFB(drmModeFBPtr ptr)
99 /* we might add more frees later. */
103 void drmModeFreeCrtc(drmModeCrtcPtr ptr)
112 void drmModeFreeOutput(drmModeOutputPtr ptr)
123 * ModeSetting functions.
126 drmModeResPtr drmModeGetResources(int fd)
128 struct drm_mode_card_res res;
131 memset(&res, 0, sizeof(struct drm_mode_card_res));
133 if (ioctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res))
137 res.fb_id_ptr = VOID2U64(drmMalloc(res.count_fbs*sizeof(uint32_t)));
139 res.crtc_id_ptr = VOID2U64(drmMalloc(res.count_crtcs*sizeof(uint32_t)));
140 if (res.count_outputs)
141 res.output_id_ptr = VOID2U64(drmMalloc(res.count_outputs*sizeof(uint32_t)));
142 if (res.count_encoders)
143 res.encoder_id_ptr = VOID2U64(drmMalloc(res.count_encoders*sizeof(uint32_t)));
145 if (ioctl(fd, DRM_IOCTL_MODE_GETRESOURCES, &res)) {
155 if (!(r = drmMalloc(sizeof(*r))))
158 r->min_width = res.min_width;
159 r->max_width = res.max_width;
160 r->min_height = res.min_height;
161 r->max_height = res.max_height;
162 r->count_fbs = res.count_fbs;
163 r->count_crtcs = res.count_crtcs;
164 r->count_outputs = res.count_outputs;
165 /* TODO we realy should test if these allocs fails. */
166 r->fbs = drmAllocCpy(U642VOID(res.fb_id_ptr), res.count_fbs, sizeof(uint32_t));
167 r->crtcs = drmAllocCpy(U642VOID(res.crtc_id_ptr), res.count_crtcs, sizeof(uint32_t));
168 r->outputs = drmAllocCpy(U642VOID(res.output_id_ptr), res.count_outputs, sizeof(uint32_t));
169 r->encoders = drmAllocCpy(U642VOID(res.encoder_id_ptr), res.count_encoders, sizeof(uint32_t));
172 drmFree(U642VOID(res.fb_id_ptr));
173 drmFree(U642VOID(res.crtc_id_ptr));
174 drmFree(U642VOID(res.output_id_ptr));
175 drmFree(U642VOID(res.encoder_id_ptr));
180 uint32_t drmModeGetHotplug(int fd)
182 struct drm_mode_hotplug arg;
185 ioctl(fd, DRM_IOCTL_MODE_HOTPLUG, &arg);
189 int drmModeAddFB(int fd, uint32_t width, uint32_t height, uint8_t depth,
190 uint8_t bpp, uint32_t pitch, uint32_t bo_handle,
193 struct drm_mode_fb_cmd f;
201 f.handle = bo_handle;
203 if ((ret = ioctl(fd, DRM_IOCTL_MODE_ADDFB, &f)))
206 *buf_id = f.buffer_id;
210 int drmModeRmFB(int fd, uint32_t bufferId)
212 return ioctl(fd, DRM_IOCTL_MODE_RMFB, &bufferId);
217 drmModeFBPtr drmModeGetFB(int fd, uint32_t buf)
219 struct drm_mode_fb_cmd info;
222 info.buffer_id = buf;
224 if (ioctl(fd, DRM_IOCTL_MODE_GETFB, &info))
227 if (!(r = drmMalloc(sizeof(*r))))
230 r->buffer_id = info.buffer_id;
231 r->width = info.width;
232 r->height = info.height;
233 r->pitch = info.pitch;
235 r->handle = info.handle;
236 r->depth = info.depth;
246 drmModeCrtcPtr drmModeGetCrtc(int fd, uint32_t crtcId)
248 struct drm_mode_crtc crtc;
251 crtc.count_outputs = 0;
253 crtc.count_possibles = 0;
255 crtc.crtc_id = crtcId;
257 if (ioctl(fd, DRM_IOCTL_MODE_GETCRTC, &crtc))
264 if (!(r = drmMalloc(sizeof(*r))))
267 r->crtc_id = crtc.crtc_id;
270 r->mode_valid = crtc.mode_valid;
272 memcpy(&r->mode, &crtc.mode, sizeof(struct drm_mode_modeinfo));
273 r->buffer_id = crtc.fb_id;
274 r->gamma_size = crtc.gamma_size;
275 r->count_outputs = crtc.count_outputs;
276 r->count_possibles = crtc.count_possibles;
277 /* TODO we realy should test if these alloc & cpy fails. */
278 r->outputs = crtc.outputs;
279 r->possibles = crtc.possibles;
285 int drmModeSetCrtc(int fd, uint32_t crtcId, uint32_t bufferId,
286 uint32_t x, uint32_t y, uint32_t *outputs, int count,
287 struct drm_mode_modeinfo *mode)
289 struct drm_mode_crtc crtc;
291 crtc.count_outputs = 0;
293 crtc.count_possibles = 0;
298 crtc.crtc_id = crtcId;
299 crtc.fb_id = bufferId;
300 crtc.set_outputs_ptr = VOID2U64(outputs);
301 crtc.count_outputs = count;
303 memcpy(&crtc.mode, mode, sizeof(struct drm_mode_modeinfo));
308 return ioctl(fd, DRM_IOCTL_MODE_SETCRTC, &crtc);
312 * Cursor manipulation
315 int drmModeSetCursor(int fd, uint32_t crtcId, uint32_t bo_handle, uint32_t width, uint32_t height)
317 struct drm_mode_cursor arg;
319 arg.flags = DRM_MODE_CURSOR_BO;
323 arg.handle = bo_handle;
325 return ioctl(fd, DRM_IOCTL_MODE_CURSOR, &arg);
328 int drmModeMoveCursor(int fd, uint32_t crtcId, int x, int y)
330 struct drm_mode_cursor arg;
332 arg.flags = DRM_MODE_CURSOR_MOVE;
337 return ioctl(fd, DRM_IOCTL_MODE_CURSOR, &arg);
343 drmModeEncoderPtr drmModeGetEncoder(int fd, uint32_t encoder_id)
345 struct drm_mode_get_encoder enc;
346 drmModeEncoderPtr r = NULL;
348 enc.encoder_id = encoder_id;
349 enc.encoder_type = 0;
353 if (ioctl(fd, DRM_IOCTL_MODE_GETENCODER, &enc))
356 r->encoder_type = enc.encoder_type;
357 r->crtcs = enc.crtcs;
358 r->clones = enc.clones;
364 * Output manipulation
367 drmModeOutputPtr drmModeGetOutput(int fd, uint32_t output_id)
369 struct drm_mode_get_output out;
370 drmModeOutputPtr r = NULL;
372 out.output = output_id;
373 out.output_type_id = 0;
377 out.count_clones = 0;
383 out.prop_values_ptr = 0;
384 out.count_encoders = 0;
385 out.encoders_ptr = 0;
387 if (ioctl(fd, DRM_IOCTL_MODE_GETOUTPUT, &out))
390 if (out.count_props) {
391 out.props_ptr = VOID2U64(drmMalloc(out.count_props*sizeof(uint32_t)));
392 out.prop_values_ptr = VOID2U64(drmMalloc(out.count_props*sizeof(uint64_t)));
396 out.modes_ptr = VOID2U64(drmMalloc(out.count_modes*sizeof(struct drm_mode_modeinfo)));
398 if (out.count_encoders)
399 out.encoders_ptr = VOID2U64(drmMalloc(out.count_encoders*sizeof(uint32_t)));
401 if (ioctl(fd, DRM_IOCTL_MODE_GETOUTPUT, &out))
404 if(!(r = drmMalloc(sizeof(*r)))) {
408 r->output_id = out.output;
410 r->connection = out.connection;
411 r->mmWidth = out.mm_width;
412 r->mmHeight = out.mm_height;
413 r->subpixel = out.subpixel;
414 r->count_crtcs = out.count_crtcs;
415 r->count_clones = out.count_clones;
416 r->count_modes = out.count_modes;
417 /* TODO we should test if these alloc & cpy fails. */
418 r->crtcs = out.crtcs;
419 r->clones = out.clones;
420 r->count_props = out.count_props;
421 r->props = drmAllocCpy(U642VOID(out.props_ptr), out.count_props, sizeof(uint32_t));
422 r->prop_values = drmAllocCpy(U642VOID(out.prop_values_ptr), out.count_props, sizeof(uint64_t));
423 r->modes = drmAllocCpy(U642VOID(out.modes_ptr), out.count_modes, sizeof(struct drm_mode_modeinfo));
424 r->count_encoders = out.count_encoders;
425 r->encoders = drmAllocCpy(U642VOID(out.encoders_ptr), out.count_encoders, sizeof(uint32_t));
426 r->output_type = out.output_type;
427 r->output_type_id = out.output_type_id;
430 drmFree(U642VOID(out.prop_values_ptr));
431 drmFree(U642VOID(out.props_ptr));
432 drmFree(U642VOID(out.modes_ptr));
433 drmFree(U642VOID(out.encoders_ptr));
438 int drmModeAttachMode(int fd, uint32_t output_id, struct drm_mode_modeinfo *mode_info)
440 struct drm_mode_mode_cmd res;
442 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
443 res.output_id = output_id;
445 return ioctl(fd, DRM_IOCTL_MODE_ATTACHMODE, &res);
448 int drmModeDetachMode(int fd, uint32_t output_id, struct drm_mode_modeinfo *mode_info)
450 struct drm_mode_mode_cmd res;
452 memcpy(&res.mode, mode_info, sizeof(struct drm_mode_modeinfo));
453 res.output_id = output_id;
455 return ioctl(fd, DRM_IOCTL_MODE_DETACHMODE, &res);
459 drmModePropertyPtr drmModeGetProperty(int fd, uint32_t property_id)
461 struct drm_mode_get_property prop;
462 drmModePropertyPtr r;
464 prop.prop_id = property_id;
465 prop.count_enum_blobs = 0;
466 prop.count_values = 0;
468 prop.enum_blob_ptr = 0;
471 if (ioctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop))
474 if (prop.count_values)
475 prop.values_ptr = VOID2U64(drmMalloc(prop.count_values * sizeof(uint64_t)));
477 if (prop.count_enum_blobs && (prop.flags & DRM_MODE_PROP_ENUM))
478 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(struct drm_mode_property_enum)));
480 if (prop.count_enum_blobs && (prop.flags & DRM_MODE_PROP_BLOB)) {
481 prop.values_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
482 prop.enum_blob_ptr = VOID2U64(drmMalloc(prop.count_enum_blobs * sizeof(uint32_t)));
485 if (ioctl(fd, DRM_IOCTL_MODE_GETPROPERTY, &prop)) {
490 if (!(r = drmMalloc(sizeof(*r))))
493 r->prop_id = prop.prop_id;
494 r->count_values = prop.count_values;
496 r->flags = prop.flags;
497 if (prop.count_values)
498 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_values, sizeof(uint64_t));
499 if (prop.flags & DRM_MODE_PROP_ENUM) {
500 r->count_enums = prop.count_enum_blobs;
501 r->enums = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(struct drm_mode_property_enum));
502 } else if (prop.flags & DRM_MODE_PROP_ENUM) {
503 r->values = drmAllocCpy(U642VOID(prop.values_ptr), prop.count_enum_blobs, sizeof(uint32_t));
504 r->blob_ids = drmAllocCpy(U642VOID(prop.enum_blob_ptr), prop.count_enum_blobs, sizeof(uint32_t));
505 r->count_blobs = prop.count_enum_blobs;
507 strncpy(r->name, prop.name, DRM_PROP_NAME_LEN);
508 r->name[DRM_PROP_NAME_LEN-1] = 0;
511 drmFree(U642VOID(prop.values_ptr));
512 drmFree(U642VOID(prop.enum_blob_ptr));
517 void drmModeFreeProperty(drmModePropertyPtr ptr)
522 drmFree(ptr->values);
527 drmModePropertyBlobPtr drmModeGetPropertyBlob(int fd, uint32_t blob_id)
529 struct drm_mode_get_blob blob;
530 drmModePropertyBlobPtr r;
534 blob.blob_id = blob_id;
536 if (ioctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob))
540 blob.data = VOID2U64(drmMalloc(blob.length));
542 if (ioctl(fd, DRM_IOCTL_MODE_GETPROPBLOB, &blob)) {
547 if (!(r = drmMalloc(sizeof(*r))))
550 r->id = blob.blob_id;
551 r->length = blob.length;
552 r->data = drmAllocCpy(U642VOID(blob.data), 1, blob.length);
555 drmFree(U642VOID(blob.data));
559 void drmModeFreePropertyBlob(drmModePropertyBlobPtr ptr)
568 int drmModeOutputSetProperty(int fd, uint32_t output_id, uint32_t property_id,
571 struct drm_mode_output_set_property osp;
574 osp.output_id = output_id;
575 osp.prop_id = property_id;
578 if ((ret = ioctl(fd, DRM_IOCTL_MODE_SETPROPERTY, &osp)))
585 * checks if a modesetting capable driver has attached to the pci id
586 * returns 0 if modesetting supported.
587 * -EINVAL or invalid bus id
588 * -ENOSYS if no modesetting support
590 int drmCheckModesettingSupported(const char *busid)
593 char pci_dev_dir[1024];
594 int domain, bus, dev, func;
599 ret = sscanf(busid, "pci:%04x:%02x:%02x.%d", &domain, &bus, &dev, &func);
603 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/drm",
604 domain, bus, dev, func);
606 sysdir = opendir(pci_dev_dir);
608 dent = readdir(sysdir);
610 if (!strncmp(dent->d_name, "controlD", 8)) {
615 dent = readdir(sysdir);
622 sprintf(pci_dev_dir, "/sys/bus/pci/devices/%04x:%02x:%02x.%d/",
623 domain, bus, dev, func);
625 sysdir = opendir(pci_dev_dir);
629 dent = readdir(sysdir);
631 if (!strncmp(dent->d_name, "drm:controlD", 12)) {
636 dent = readdir(sysdir);
647 int drmModeReplaceFB(int fd, uint32_t buffer_id,
648 uint32_t width, uint32_t height, uint8_t depth,
649 uint8_t bpp, uint32_t pitch, uint32_t bo_handle)
651 struct drm_mode_fb_cmd f;
659 f.handle = bo_handle;
660 f.buffer_id = buffer_id;
662 if ((ret = ioctl(fd, DRM_IOCTL_MODE_REPLACEFB, &f)))