include/drm/exynos_drm.h

   1 /* exynos_drm.h
   2  *
   3  * Copyright (c) 2011 Samsung Electronics Co., Ltd.
   4  * Authors:
   5  *      Inki Dae <inki.dae@samsung.com>
   6  *      Joonyoung Shim <jy0922.shim@samsung.com>
   7  *      Seung-Woo Kim <sw0312.kim@samsung.com>
   8  *
   9  * Permission is hereby granted, free of charge, to any person obtaining a
  10  * copy of this software and associated documentation files (the "Software"),
  11  * to deal in the Software without restriction, including without limitation
  12  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  13  * and/or sell copies of the Software, and to permit persons to whom the
  14  * Software is furnished to do so, subject to the following conditions:
  15  *
  16  * The above copyright notice and this permission notice (including the next
  17  * paragraph) shall be included in all copies or substantial portions of the
  18  * Software.
  19  *
  20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  21  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  23  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  24  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  25  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  26  * OTHER DEALINGS IN THE SOFTWARE.
  27  */
  28
  29 #ifndef _EXYNOS_DRM_H_
  30 #define _EXYNOS_DRM_H_
  31
  32 #include "drm.h"
  33
  34 /**
  35  * User-desired buffer creation information structure.
  36  *
  37  * @size: user-desired memory allocation size.
  38  *      - this size value would be page-aligned internally.
  39  * @flags: user request for setting memory type or cache attributes.
  40  * @handle: returned a handle to created gem object.
  41  *      - this handle will be set by gem module of kernel side.
  42  */
  43 struct drm_exynos_gem_create {
  44         uint64_t size;
  45         unsigned int flags;
  46         unsigned int handle;
  47 };
  48
  49 /**
  50  * A structure for getting buffer offset.
  51  *
  52  * @handle: a pointer to gem object created.
  53  * @pad: just padding to be 64-bit aligned.
  54  * @offset: relatived offset value of the memory region allocated.
  55  *      - this value should be set by user.
  56  */
  57 struct drm_exynos_gem_map_off {
  58         unsigned int handle;
  59         unsigned int pad;
  60         uint64_t offset;
  61 };
  62
  63 /**
  64  * A structure for mapping buffer.
  65  *
  66  * @handle: a handle to gem object created.
  67  * @pad: just padding to be 64-bit aligned.
  68  * @size: memory size to be mapped.
  69  * @mapped: having user virtual address mmaped.
  70  *      - this variable would be filled by exynos gem module
  71  *      of kernel side with user virtual address which is allocated
  72  *      by do_mmap().
  73  */
  74 struct drm_exynos_gem_mmap {
  75         unsigned int handle;
  76         unsigned int pad;
  77         uint64_t size;
  78         uint64_t mapped;
  79 };
  80
  81 /**
  82  * A structure to gem information.
  83  *
  84  * @handle: a handle to gem object created.
  85  * @flags: flag value including memory type and cache attribute and
  86  *      this value would be set by driver.
  87  * @size: size to memory region allocated by gem and this size would
  88  *      be set by driver.
  89  */
  90 struct drm_exynos_gem_info {
  91         unsigned int handle;
  92         unsigned int flags;
  93         uint64_t size;
  94 };
  95
  96 /**
  97  * A structure for user connection request of virtual display.
  98  *
  99  * @connection: indicate whether doing connetion or not by user.
 100  * @extensions: if this value is 1 then the vidi driver would need additional
 101  *      128bytes edid data.
 102  * @edid: the edid data pointer from user side.
 103  */
 104 struct drm_exynos_vidi_connection {
 105         unsigned int connection;
 106         unsigned int extensions;
 107         uint64_t edid;
 108 };
 109
 110 /* Indicate Exynos specific vblank flags */
 111 enum e_drm_exynos_vblank {
 112         /*
 113          * this flags is used for Virtual Display module
 114          * to use DRM_IOCTL_WAIT_VBLANK feature. for this,
 115          * user should set this flag to vblwait->request.type
 116          */
 117         _DRM_VBLANK_EXYNOS_VIDI = 2,
 118 };
 119
 120 /* memory type definitions. */
 121 enum e_drm_exynos_gem_mem_type {
 122         /* Physically Continuous memory and used as default. */
 123         EXYNOS_BO_CONTIG        = 0 << 0,
 124         /* Physically Non-Continuous memory. */
 125         EXYNOS_BO_NONCONTIG     = 1 << 0,
 126         /* non-cachable mapping and used as default. */
 127         EXYNOS_BO_NONCACHABLE   = 0 << 1,
 128         /* cachable mapping. */
 129         EXYNOS_BO_CACHABLE      = 1 << 1,
 130         /* write-combine mapping. */
 131         EXYNOS_BO_WC            = 1 << 2,
 132         EXYNOS_BO_MASK          = EXYNOS_BO_NONCONTIG | EXYNOS_BO_CACHABLE |
 133                                         EXYNOS_BO_WC
 134 };
 135
 136 struct drm_exynos_g2d_get_ver {
 137         __u32   major;
 138         __u32   minor;
 139 };
 140
 141 struct drm_exynos_g2d_cmd {
 142         __u32   offset;
 143         __u32   data;
 144 };
 145
 146 enum drm_exynos_g2d_event_type {
 147         G2D_EVENT_NOT,
 148         G2D_EVENT_NONSTOP,
 149         G2D_EVENT_STOP,         /* not yet */
 150 };
 151
 152 struct drm_exynos_g2d_set_cmdlist {
 153         __u64                                   cmd;
 154         __u64                                   cmd_gem;
 155         __u32                                   cmd_nr;
 156         __u32                                   cmd_gem_nr;
 157
 158         /* for g2d event */
 159         __u64                                   event_type;
 160         __u64                                   user_data;
 161 };
 162
 163 struct drm_exynos_g2d_exec {
 164         __u64                                   async;
 165 };
 166
 167 #define DRM_EXYNOS_GEM_CREATE           0x00
 168 #define DRM_EXYNOS_GEM_MAP_OFFSET       0x01
 169 #define DRM_EXYNOS_GEM_MMAP             0x02
 170 /* Reserved 0x03 ~ 0x05 for exynos specific gem ioctl */
 171 #define DRM_EXYNOS_GEM_GET              0x04
 172 #define DRM_EXYNOS_VIDI_CONNECTION      0x07
 173
 174 /* G2D */
 175 #define DRM_EXYNOS_G2D_GET_VER          0x20
 176 #define DRM_EXYNOS_G2D_SET_CMDLIST      0x21
 177 #define DRM_EXYNOS_G2D_EXEC             0x22
 178
 179 #define DRM_IOCTL_EXYNOS_GEM_CREATE             DRM_IOWR(DRM_COMMAND_BASE + \
 180                 DRM_EXYNOS_GEM_CREATE, struct drm_exynos_gem_create)
 181
 182 #define DRM_IOCTL_EXYNOS_GEM_MAP_OFFSET DRM_IOWR(DRM_COMMAND_BASE + \
 183                 DRM_EXYNOS_GEM_MAP_OFFSET, struct drm_exynos_gem_map_off)
 184
 185 #define DRM_IOCTL_EXYNOS_GEM_MMAP       DRM_IOWR(DRM_COMMAND_BASE + \
 186                 DRM_EXYNOS_GEM_MMAP, struct drm_exynos_gem_mmap)
 187
 188 #define DRM_IOCTL_EXYNOS_GEM_GET        DRM_IOWR(DRM_COMMAND_BASE + \
 189                 DRM_EXYNOS_GEM_GET,     struct drm_exynos_gem_info)
 190
 191 #define DRM_IOCTL_EXYNOS_VIDI_CONNECTION        DRM_IOWR(DRM_COMMAND_BASE + \
 192                 DRM_EXYNOS_VIDI_CONNECTION, struct drm_exynos_vidi_connection)
 193
 194 #define DRM_IOCTL_EXYNOS_G2D_GET_VER            DRM_IOWR(DRM_COMMAND_BASE + \
 195                 DRM_EXYNOS_G2D_GET_VER, struct drm_exynos_g2d_get_ver)
 196 #define DRM_IOCTL_EXYNOS_G2D_SET_CMDLIST        DRM_IOWR(DRM_COMMAND_BASE + \
 197                 DRM_EXYNOS_G2D_SET_CMDLIST, struct drm_exynos_g2d_set_cmdlist)
 198 #define DRM_IOCTL_EXYNOS_G2D_EXEC               DRM_IOWR(DRM_COMMAND_BASE + \
 199                 DRM_EXYNOS_G2D_EXEC, struct drm_exynos_g2d_exec)
 200
 201 /* EXYNOS specific events */
 202 #define DRM_EXYNOS_G2D_EVENT            0x80000000
 203
 204 struct drm_exynos_g2d_event {
 205         struct drm_event        base;
 206         __u64                   user_data;
 207         __u32                   tv_sec;
 208         __u32                   tv_usec;
 209         __u32                   cmdlist_no;
 210         __u32                   reserved;
 211 };
 212
 213 #ifdef __KERNEL__
 214
 215 /**
 216  * A structure for lcd panel information.
 217  *
 218  * @timing: default video mode for initializing
 219  * @width_mm: physical size of lcd width.
 220  * @height_mm: physical size of lcd height.
 221  */
 222 struct exynos_drm_panel_info {
 223         struct fb_videomode timing;
 224         u32 width_mm;
 225         u32 height_mm;
 226 };
 227
 228 /**
 229  * Platform Specific Structure for DRM based FIMD.
 230  *
 231  * @panel: default panel info for initializing
 232  * @default_win: default window layer number to be used for UI.
 233  * @bpp: default bit per pixel.
 234  */
 235 struct exynos_drm_fimd_pdata {
 236         struct exynos_drm_panel_info panel;
 237         u32                             vidcon0;
 238         u32                             vidcon1;
 239         unsigned int                    default_win;
 240         unsigned int                    bpp;
 241 };
 242
 243 /**
 244  * Platform Specific Structure for DRM based HDMI.
 245  *
 246  * @hdmi_dev: device point to specific hdmi driver.
 247  * @mixer_dev: device point to specific mixer driver.
 248  *
 249  * this structure is used for common hdmi driver and each device object
 250  * would be used to access specific device driver(hdmi or mixer driver)
 251  */
 252 struct exynos_drm_common_hdmi_pd {
 253         struct device *hdmi_dev;
 254         struct device *mixer_dev;
 255 };
 256
 257 /**
 258  * Platform Specific Structure for DRM based HDMI core.
 259  *
 260  * @is_v13: set if hdmi version 13 is.
 261  * @cfg_hpd: function pointer to configure hdmi hotplug detection pin
 262  * @get_hpd: function pointer to get value of hdmi hotplug detection pin
 263  */
 264 struct exynos_drm_hdmi_pdata {
 265         bool is_v13;
 266         void (*cfg_hpd)(bool external);
 267         int (*get_hpd)(void);
 268 };
 269
 270 #endif  /* __KERNEL__ */
 271 #endif  /* _EXYNOS_DRM_H_ */