include/uapi/drm/omap_drm.h

   1 /*
   2  * include/uapi/drm/omap_drm.h
   3  *
   4  * Copyright (C) 2011 Texas Instruments
   5  * Author: Rob Clark <rob@ti.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License version 2 as published by
   9  * the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  14  * more details.
  15  *
  16  * You should have received a copy of the GNU General Public License along with
  17  * this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #ifndef __OMAP_DRM_H__
  21 #define __OMAP_DRM_H__
  22
  23 #include <drm/drm.h>
  24
  25 /* Please note that modifications to all structs defined here are
  26  * subject to backwards-compatibility constraints.
  27  */
  28
  29 #define OMAP_PARAM_CHIPSET_ID   1       /* ie. 0x3430, 0x4430, etc */
  30
  31 struct drm_omap_param {
  32         uint64_t param;                 /* in */
  33         uint64_t value;                 /* in (set_param), out (get_param) */
  34 };
  35
  36 #define OMAP_BO_SCANOUT         0x00000001      /* scanout capable (phys contiguous) */
  37 #define OMAP_BO_CACHE_MASK      0x00000006      /* cache type mask, see cache modes */
  38 #define OMAP_BO_TILED_MASK      0x00000f00      /* tiled mapping mask, see tiled modes */
  39
  40 /* cache modes */
  41 #define OMAP_BO_CACHED          0x00000000      /* default */
  42 #define OMAP_BO_WC              0x00000002      /* write-combine */
  43 #define OMAP_BO_UNCACHED        0x00000004      /* strongly-ordered (uncached) */
  44
  45 /* tiled modes */
  46 #define OMAP_BO_TILED_8         0x00000100
  47 #define OMAP_BO_TILED_16        0x00000200
  48 #define OMAP_BO_TILED_32        0x00000300
  49 #define OMAP_BO_TILED           (OMAP_BO_TILED_8 | OMAP_BO_TILED_16 | OMAP_BO_TILED_32)
  50
  51 union omap_gem_size {
  52         uint32_t bytes;         /* (for non-tiled formats) */
  53         struct {
  54                 uint16_t width;
  55                 uint16_t height;
  56         } tiled;                /* (for tiled formats) */
  57 };
  58
  59 struct drm_omap_gem_new {
  60         union omap_gem_size size;       /* in */
  61         uint32_t flags;                 /* in */
  62         uint32_t handle;                /* out */
  63         uint32_t __pad;
  64 };
  65
  66 /* mask of operations: */
  67 enum omap_gem_op {
  68         OMAP_GEM_READ = 0x01,
  69         OMAP_GEM_WRITE = 0x02,
  70 };
  71
  72 struct drm_omap_gem_cpu_prep {
  73         uint32_t handle;                /* buffer handle (in) */
  74         uint32_t op;                    /* mask of omap_gem_op (in) */
  75 };
  76
  77 struct drm_omap_gem_cpu_fini {
  78         uint32_t handle;                /* buffer handle (in) */
  79         uint32_t op;                    /* mask of omap_gem_op (in) */
  80         /* TODO maybe here we pass down info about what regions are touched
  81          * by sw so we can be clever about cache ops?  For now a placeholder,
  82          * set to zero and we just do full buffer flush..
  83          */
  84         uint32_t nregions;
  85         uint32_t __pad;
  86 };
  87
  88 struct drm_omap_gem_info {
  89         uint32_t handle;                /* buffer handle (in) */
  90         uint32_t pad;
  91         uint64_t offset;                /* mmap offset (out) */
  92         /* note: in case of tiled buffers, the user virtual size can be
  93          * different from the physical size (ie. how many pages are needed
  94          * to back the object) which is returned in DRM_IOCTL_GEM_OPEN..
  95          * This size here is the one that should be used if you want to
  96          * mmap() the buffer:
  97          */
  98         uint32_t size;                  /* virtual size for mmap'ing (out) */
  99         uint32_t __pad;
 100 };
 101
 102 #define DRM_OMAP_GET_PARAM              0x00
 103 #define DRM_OMAP_SET_PARAM              0x01
 104 /* placeholder for plugin-api
 105 #define DRM_OMAP_GET_BASE               0x02
 106 */
 107 #define DRM_OMAP_GEM_NEW                0x03
 108 #define DRM_OMAP_GEM_CPU_PREP           0x04
 109 #define DRM_OMAP_GEM_CPU_FINI           0x05
 110 #define DRM_OMAP_GEM_INFO               0x06
 111 #define DRM_OMAP_NUM_IOCTLS             0x07
 112
 113 #define DRM_IOCTL_OMAP_GET_PARAM        DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GET_PARAM, struct drm_omap_param)
 114 #define DRM_IOCTL_OMAP_SET_PARAM        DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_SET_PARAM, struct drm_omap_param)
 115 /* placeholder for plugin-api
 116 #define DRM_IOCTL_OMAP_GET_BASE         DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GET_BASE, struct drm_omap_get_base)
 117 */
 118 #define DRM_IOCTL_OMAP_GEM_NEW          DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GEM_NEW, struct drm_omap_gem_new)
 119 #define DRM_IOCTL_OMAP_GEM_CPU_PREP     DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_GEM_CPU_PREP, struct drm_omap_gem_cpu_prep)
 120 #define DRM_IOCTL_OMAP_GEM_CPU_FINI     DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_GEM_CPU_FINI, struct drm_omap_gem_cpu_fini)
 121 #define DRM_IOCTL_OMAP_GEM_INFO         DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GEM_INFO, struct drm_omap_gem_info)
 122
 123 #endif /* __OMAP_DRM_H__ */