shared-core/drm.h

   1 /* drm.h -- Header for Direct Rendering Manager -*- linux-c -*-
   2  * Created: Mon Jan  4 10:05:05 1999 by faith@precisioninsight.com
   3  *
   4  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
   5  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
   6  * All rights reserved.
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a
   9  * copy of this software and associated documentation files (the "Software"),
  10  * to deal in the Software without restriction, including without limitation
  11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  12  * and/or sell copies of the Software, and to permit persons to whom the
  13  * Software is furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice (including the next
  16  * paragraph) shall be included in all copies or substantial portions of the
  17  * Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  22  * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  23  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  24  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  25  * DEALINGS IN THE SOFTWARE.
  26  *
  27  * Authors:
  28  *    Rickard E. (Rik) Faith <faith@valinux.com>
  29  *
  30  * Acknowledgements:
  31  * Dec 1999, Richard Henderson <rth@twiddle.net>, move to generic cmpxchg.
  32  *
  33  */
  34
  35 #ifndef _DRM_H_
  36 #define _DRM_H_
  37
  38 #if defined(__linux__)
  39 #include <asm/ioctl.h>          /* For _IO* macros */
  40 #define DRM_IOCTL_NR(n)      _IOC_NR(n)
  41 #elif defined(__FreeBSD__)
  42 #include <sys/ioccom.h>
  43 #define DRM_IOCTL_NR(n)      ((n) & 0xff)
  44 #endif
  45
  46 #define DRM_PROC_DEVICES "/proc/devices"
  47 #define DRM_PROC_MISC    "/proc/misc"
  48 #define DRM_PROC_DRM     "/proc/drm"
  49 #define DRM_DEV_DRM      "/dev/drm"
  50 #define DRM_DEV_MODE     (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)
  51 #define DRM_DEV_UID      0
  52 #define DRM_DEV_GID      0
  53
  54
  55 #define DRM_NAME        "drm"     /* Name in kernel, /dev, and /proc        */
  56 #define DRM_MIN_ORDER   5         /* At least 2^5 bytes = 32 bytes          */
  57 #define DRM_MAX_ORDER   22        /* Up to 2^22 bytes = 4MB                 */
  58 #define DRM_RAM_PERCENT 10        /* How much system ram can we lock?       */
  59
  60 #define _DRM_LOCK_HELD  0x80000000 /* Hardware lock is held                 */
  61 #define _DRM_LOCK_CONT  0x40000000 /* Hardware lock is contended            */
  62 #define _DRM_LOCK_IS_HELD(lock)    ((lock) & _DRM_LOCK_HELD)
  63 #define _DRM_LOCK_IS_CONT(lock)    ((lock) & _DRM_LOCK_CONT)
  64 #define _DRM_LOCKING_CONTEXT(lock) ((lock) & ~(_DRM_LOCK_HELD|_DRM_LOCK_CONT))
  65
  66 typedef unsigned long drm_handle_t;
  67 typedef unsigned int  drm_context_t;
  68 typedef unsigned int  drm_drawable_t;
  69 typedef unsigned int  drm_magic_t;
  70
  71 /* Warning: If you change this structure, make sure you change
  72  * XF86DRIClipRectRec in the server as well */
  73
  74 typedef struct drm_clip_rect {
  75            unsigned short x1;
  76            unsigned short y1;
  77            unsigned short x2;
  78            unsigned short y2;
  79 } drm_clip_rect_t;
  80
  81 /* Seperate include files for the i810/mga/r128 specific structures */
  82 #include "mga_drm.h"
  83 #include "i810_drm.h"
  84 #include "r128_drm.h"
  85 #ifdef CONFIG_DRM_SIS
  86 #include "sis_drm.h"
  87 #endif
  88
  89 typedef struct drm_version {
  90         int    version_major;     /* Major version                          */
  91         int    version_minor;     /* Minor version                          */
  92         int    version_patchlevel;/* Patch level                            */
  93         size_t name_len;          /* Length of name buffer                  */
  94         char   *name;             /* Name of driver                         */
  95         size_t date_len;          /* Length of date buffer                  */
  96         char   *date;             /* User-space buffer to hold date         */
  97         size_t desc_len;          /* Length of desc buffer                  */
  98         char   *desc;             /* User-space buffer to hold desc         */
  99 } drm_version_t;
 100
 101 typedef struct drm_unique {
 102         size_t unique_len;        /* Length of unique                       */
 103         char   *unique;           /* Unique name for driver instantiation   */
 104 } drm_unique_t;
 105
 106 typedef struct drm_list {
 107         int              count;   /* Length of user-space structures        */
 108         drm_version_t    *version;
 109 } drm_list_t;
 110
 111 typedef struct drm_block {
 112         int              unused;
 113 } drm_block_t;
 114
 115 typedef struct drm_control {
 116         enum {
 117                 DRM_ADD_COMMAND,
 118                 DRM_RM_COMMAND,
 119                 DRM_INST_HANDLER,
 120                 DRM_UNINST_HANDLER
 121         }                func;
 122         int              irq;
 123 } drm_control_t;
 124
 125 typedef enum drm_map_type {
 126         _DRM_FRAME_BUFFER = 0,    /* WC (no caching), no core dump          */
 127         _DRM_REGISTERS    = 1,    /* no caching, no core dump               */
 128         _DRM_SHM          = 2,    /* shared, cached                         */
 129         _DRM_AGP          = 3     /* AGP/GART                               */
 130 } drm_map_type_t;
 131
 132 typedef enum drm_map_flags {
 133         _DRM_RESTRICTED      = 0x01, /* Cannot be mapped to user-virtual    */
 134         _DRM_READ_ONLY       = 0x02,
 135         _DRM_LOCKED          = 0x04, /* shared, cached, locked              */
 136         _DRM_KERNEL          = 0x08, /* kernel requires access              */
 137         _DRM_WRITE_COMBINING = 0x10, /* use write-combining if available    */
 138         _DRM_CONTAINS_LOCK   = 0x20  /* SHM page that contains lock         */
 139 } drm_map_flags_t;
 140
 141 typedef struct drm_map {
 142         unsigned long   offset;  /* Requested physical address (0 for SAREA)*/
 143         unsigned long   size;    /* Requested physical size (bytes)         */
 144         drm_map_type_t  type;    /* Type of memory to map                   */
 145         drm_map_flags_t flags;   /* Flags                                   */
 146         void            *handle; /* User-space: "Handle" to pass to mmap    */
 147                                  /* Kernel-space: kernel-virtual address    */
 148         int             mtrr;    /* MTRR slot used                          */
 149                                  /* Private data                            */
 150 } drm_map_t;
 151
 152 typedef enum drm_lock_flags {
 153         _DRM_LOCK_READY      = 0x01, /* Wait until hardware is ready for DMA */
 154         _DRM_LOCK_QUIESCENT  = 0x02, /* Wait until hardware quiescent        */
 155         _DRM_LOCK_FLUSH      = 0x04, /* Flush this context's DMA queue first */
 156         _DRM_LOCK_FLUSH_ALL  = 0x08, /* Flush all DMA queues first           */
 157                                 /* These *HALT* flags aren't supported yet
 158                                    -- they will be used to support the
 159                                    full-screen DGA-like mode. */
 160         _DRM_HALT_ALL_QUEUES = 0x10, /* Halt all current and future queues   */
 161         _DRM_HALT_CUR_QUEUES = 0x20  /* Halt all current queues              */
 162 } drm_lock_flags_t;
 163
 164 typedef struct drm_lock {
 165         int              context;
 166         drm_lock_flags_t flags;
 167 } drm_lock_t;
 168
 169 typedef enum drm_dma_flags {          /* These values *MUST* match xf86drm.h */
 170                                       /* Flags for DMA buffer dispatch       */
 171         _DRM_DMA_BLOCK        = 0x01, /* Block until buffer dispatched.
 172                                          Note, the buffer may not yet have
 173                                          been processed by the hardware --
 174                                          getting a hardware lock with the
 175                                          hardware quiescent will ensure
 176                                          that the buffer has been
 177                                          processed.                          */
 178         _DRM_DMA_WHILE_LOCKED = 0x02, /* Dispatch while lock held            */
 179         _DRM_DMA_PRIORITY     = 0x04, /* High priority dispatch              */
 180
 181                                       /* Flags for DMA buffer request        */
 182         _DRM_DMA_WAIT         = 0x10, /* Wait for free buffers               */
 183         _DRM_DMA_SMALLER_OK   = 0x20, /* Smaller-than-requested buffers ok   */
 184         _DRM_DMA_LARGER_OK    = 0x40  /* Larger-than-requested buffers ok    */
 185 } drm_dma_flags_t;
 186
 187 typedef struct drm_buf_desc {
 188         int           count;     /* Number of buffers of this size           */
 189         int           size;      /* Size in bytes                            */
 190         int           low_mark;  /* Low water mark                           */
 191         int           high_mark; /* High water mark                          */
 192         enum {
 193                 _DRM_PAGE_ALIGN = 0x01, /* Align on page boundaries for DMA  */
 194                 _DRM_AGP_BUFFER = 0x02  /* Buffer is in agp space            */
 195         }             flags;
 196         unsigned long agp_start; /* Start address of where the agp buffers
 197                                   * are in the agp aperture */
 198 } drm_buf_desc_t;
 199
 200 typedef struct drm_buf_info {
 201         int            count;   /* Entries in list                           */
 202         drm_buf_desc_t *list;
 203 } drm_buf_info_t;
 204
 205 typedef struct drm_buf_free {
 206         int            count;
 207         int            *list;
 208 } drm_buf_free_t;
 209
 210 typedef struct drm_buf_pub {
 211         int               idx;         /* Index into master buflist          */
 212         int               total;       /* Buffer size                        */
 213         int               used;        /* Amount of buffer in use (for DMA)  */
 214         void              *address;    /* Address of buffer                  */
 215 } drm_buf_pub_t;
 216
 217 typedef struct drm_buf_map {
 218         int           count;    /* Length of buflist                        */
 219         void          *virtual; /* Mmaped area in user-virtual              */
 220         drm_buf_pub_t *list;    /* Buffer information                       */
 221 } drm_buf_map_t;
 222
 223 typedef struct drm_dma {
 224                                 /* Indices here refer to the offset into
 225                                    buflist in drm_buf_get_t.  */
 226         int             context;          /* Context handle                 */
 227         int             send_count;       /* Number of buffers to send      */
 228         int             *send_indices;    /* List of handles to buffers     */
 229         int             *send_sizes;      /* Lengths of data to send        */
 230         drm_dma_flags_t flags;            /* Flags                          */
 231         int             request_count;    /* Number of buffers requested    */
 232         int             request_size;     /* Desired size for buffers       */
 233         int             *request_indices; /* Buffer information             */
 234         int             *request_sizes;
 235         int             granted_count;    /* Number of buffers granted      */
 236 } drm_dma_t;
 237
 238 typedef enum {
 239         _DRM_CONTEXT_PRESERVED = 0x01,
 240         _DRM_CONTEXT_2DONLY    = 0x02
 241 } drm_ctx_flags_t;
 242
 243 typedef struct drm_ctx {
 244         drm_context_t   handle;
 245         drm_ctx_flags_t flags;
 246 } drm_ctx_t;
 247
 248 typedef struct drm_ctx_res {
 249         int             count;
 250         drm_ctx_t       *contexts;
 251 } drm_ctx_res_t;
 252
 253 typedef struct drm_draw {
 254         drm_drawable_t  handle;
 255 } drm_draw_t;
 256
 257 typedef struct drm_auth {
 258         drm_magic_t     magic;
 259 } drm_auth_t;
 260
 261 typedef struct drm_irq_busid {
 262         int irq;
 263         int busnum;
 264         int devnum;
 265         int funcnum;
 266 } drm_irq_busid_t;
 267
 268 typedef struct drm_agp_mode {
 269         unsigned long mode;
 270 } drm_agp_mode_t;
 271
 272                                 /* For drm_agp_alloc -- allocated a buffer */
 273 typedef struct drm_agp_buffer {
 274         unsigned long size;     /* In bytes -- will round to page boundary */
 275         unsigned long handle;   /* Used for BIND/UNBIND ioctls */
 276         unsigned long type;     /* Type of memory to allocate  */
 277         unsigned long physical; /* Physical used by i810       */
 278 } drm_agp_buffer_t;
 279
 280                                 /* For drm_agp_bind */
 281 typedef struct drm_agp_binding {
 282         unsigned long handle;   /* From drm_agp_buffer */
 283         unsigned long offset;   /* In bytes -- will round to page boundary */
 284 } drm_agp_binding_t;
 285
 286 typedef struct drm_agp_info {
 287         int            agp_version_major;
 288         int            agp_version_minor;
 289         unsigned long  mode;
 290         unsigned long  aperture_base;  /* physical address */
 291         unsigned long  aperture_size;  /* bytes */
 292         unsigned long  memory_allowed; /* bytes */
 293         unsigned long  memory_used;
 294
 295                                 /* PCI information */
 296         unsigned short id_vendor;
 297         unsigned short id_device;
 298 } drm_agp_info_t;
 299
 300 #define DRM_IOCTL_BASE       'd'
 301 #define DRM_IO(nr)           _IO(DRM_IOCTL_BASE,nr)
 302 #define DRM_IOR(nr,size)     _IOR(DRM_IOCTL_BASE,nr,size)
 303 #define DRM_IOW(nr,size)     _IOW(DRM_IOCTL_BASE,nr,size)
 304 #define DRM_IOWR(nr,size)    _IOWR(DRM_IOCTL_BASE,nr,size)
 305
 306
 307 #define DRM_IOCTL_VERSION    DRM_IOWR(0x00, drm_version_t)
 308 #define DRM_IOCTL_GET_UNIQUE DRM_IOWR(0x01, drm_unique_t)
 309 #define DRM_IOCTL_GET_MAGIC  DRM_IOR( 0x02, drm_auth_t)
 310 #define DRM_IOCTL_IRQ_BUSID  DRM_IOWR(0x03, drm_irq_busid_t)
 311
 312 #define DRM_IOCTL_SET_UNIQUE DRM_IOW( 0x10, drm_unique_t)
 313 #define DRM_IOCTL_AUTH_MAGIC DRM_IOW( 0x11, drm_auth_t)
 314 #define DRM_IOCTL_BLOCK      DRM_IOWR(0x12, drm_block_t)
 315 #define DRM_IOCTL_UNBLOCK    DRM_IOWR(0x13, drm_block_t)
 316 #define DRM_IOCTL_CONTROL    DRM_IOW( 0x14, drm_control_t)
 317 #define DRM_IOCTL_ADD_MAP    DRM_IOWR(0x15, drm_map_t)
 318 #define DRM_IOCTL_ADD_BUFS   DRM_IOWR(0x16, drm_buf_desc_t)
 319 #define DRM_IOCTL_MARK_BUFS  DRM_IOW( 0x17, drm_buf_desc_t)
 320 #define DRM_IOCTL_INFO_BUFS  DRM_IOWR(0x18, drm_buf_info_t)
 321 #define DRM_IOCTL_MAP_BUFS   DRM_IOWR(0x19, drm_buf_map_t)
 322 #define DRM_IOCTL_FREE_BUFS  DRM_IOW( 0x1a, drm_buf_free_t)
 323
 324 #define DRM_IOCTL_ADD_CTX    DRM_IOWR(0x20, drm_ctx_t)
 325 #define DRM_IOCTL_RM_CTX     DRM_IOWR(0x21, drm_ctx_t)
 326 #define DRM_IOCTL_MOD_CTX    DRM_IOW( 0x22, drm_ctx_t)
 327 #define DRM_IOCTL_GET_CTX    DRM_IOWR(0x23, drm_ctx_t)
 328 #define DRM_IOCTL_SWITCH_CTX DRM_IOW( 0x24, drm_ctx_t)
 329 #define DRM_IOCTL_NEW_CTX    DRM_IOW( 0x25, drm_ctx_t)
 330 #define DRM_IOCTL_RES_CTX    DRM_IOWR(0x26, drm_ctx_res_t)
 331 #define DRM_IOCTL_ADD_DRAW   DRM_IOWR(0x27, drm_draw_t)
 332 #define DRM_IOCTL_RM_DRAW    DRM_IOWR(0x28, drm_draw_t)
 333 #define DRM_IOCTL_DMA        DRM_IOWR(0x29, drm_dma_t)
 334 #define DRM_IOCTL_LOCK       DRM_IOW( 0x2a, drm_lock_t)
 335 #define DRM_IOCTL_UNLOCK     DRM_IOW( 0x2b, drm_lock_t)
 336 #define DRM_IOCTL_FINISH     DRM_IOW( 0x2c, drm_lock_t)
 337
 338 #define DRM_IOCTL_AGP_ACQUIRE DRM_IO(  0x30)
 339 #define DRM_IOCTL_AGP_RELEASE DRM_IO(  0x31)
 340 #define DRM_IOCTL_AGP_ENABLE  DRM_IOW( 0x32, drm_agp_mode_t)
 341 #define DRM_IOCTL_AGP_INFO    DRM_IOR( 0x33, drm_agp_info_t)
 342 #define DRM_IOCTL_AGP_ALLOC   DRM_IOWR(0x34, drm_agp_buffer_t)
 343 #define DRM_IOCTL_AGP_FREE    DRM_IOW( 0x35, drm_agp_buffer_t)
 344 #define DRM_IOCTL_AGP_BIND    DRM_IOW( 0x36, drm_agp_binding_t)
 345 #define DRM_IOCTL_AGP_UNBIND  DRM_IOW( 0x37, drm_agp_binding_t)
 346
 347 /* Mga specific ioctls */
 348 #define DRM_IOCTL_MGA_INIT    DRM_IOW( 0x40, drm_mga_init_t)
 349 #define DRM_IOCTL_MGA_SWAP    DRM_IOW( 0x41, drm_mga_swap_t)
 350 #define DRM_IOCTL_MGA_CLEAR   DRM_IOW( 0x42, drm_mga_clear_t)
 351 #define DRM_IOCTL_MGA_ILOAD   DRM_IOW( 0x43, drm_mga_iload_t)
 352 #define DRM_IOCTL_MGA_VERTEX  DRM_IOW( 0x44, drm_mga_vertex_t)
 353 #define DRM_IOCTL_MGA_FLUSH   DRM_IOW( 0x45, drm_lock_t )
 354 #define DRM_IOCTL_MGA_INDICES DRM_IOW( 0x46, drm_mga_indices_t)
 355 #define DRM_IOCTL_MGA_BLIT    DRM_IOW( 0x47, drm_mga_blit_t)
 356
 357 /* I810 specific ioctls */
 358 #define DRM_IOCTL_I810_INIT    DRM_IOW( 0x40, drm_i810_init_t)
 359 #define DRM_IOCTL_I810_VERTEX  DRM_IOW( 0x41, drm_i810_vertex_t)
 360 #define DRM_IOCTL_I810_CLEAR   DRM_IOW( 0x42, drm_i810_clear_t)
 361 #define DRM_IOCTL_I810_FLUSH   DRM_IO ( 0x43)
 362 #define DRM_IOCTL_I810_GETAGE  DRM_IO ( 0x44)
 363 #define DRM_IOCTL_I810_GETBUF  DRM_IOWR(0x45, drm_i810_dma_t)
 364 #define DRM_IOCTL_I810_SWAP    DRM_IO ( 0x46)
 365 #define DRM_IOCTL_I810_COPY    DRM_IOW( 0x47, drm_i810_copy_t)
 366 #define DRM_IOCTL_I810_DOCOPY  DRM_IO ( 0x48)
 367
 368 /* Rage 128 specific ioctls */
 369 #define DRM_IOCTL_R128_INIT      DRM_IOW( 0x40, drm_r128_init_t)
 370 #define DRM_IOCTL_R128_CCE_START DRM_IO(  0x41)
 371 #define DRM_IOCTL_R128_CCE_STOP  DRM_IOW( 0x42, drm_r128_cce_stop_t)
 372 #define DRM_IOCTL_R128_CCE_RESET DRM_IO(  0x43)
 373 #define DRM_IOCTL_R128_CCE_IDLE  DRM_IO(  0x44)
 374 #define DRM_IOCTL_R128_RESET     DRM_IO(  0x46)
 375 #define DRM_IOCTL_R128_SWAP      DRM_IO(  0x47)
 376 #define DRM_IOCTL_R128_CLEAR     DRM_IOW( 0x48, drm_r128_clear_t)
 377 #define DRM_IOCTL_R128_VERTEX    DRM_IOW( 0x49, drm_r128_vertex_t)
 378 #define DRM_IOCTL_R128_INDICES   DRM_IOW( 0x4a, drm_r128_indices_t)
 379 #define DRM_IOCTL_R128_BLIT      DRM_IOW( 0x4b, drm_r128_blit_t)
 380 #define DRM_IOCTL_R128_DEPTH     DRM_IOW( 0x4c, drm_r128_depth_t)
 381 #define DRM_IOCTL_R128_STIPPLE   DRM_IOW( 0x4d, drm_r128_stipple_t)
 382 #define DRM_IOCTL_R128_PACKET    DRM_IOWR(0x4e, drm_r128_packet_t)
 383
 384 #ifdef CONFIG_DRM_SIS
 385 /* SiS specific ioctls */
 386 #define SIS_IOCTL_FB_ALLOC     DRM_IOWR( 0x44, drm_sis_mem_t)
 387 #define SIS_IOCTL_FB_FREE      DRM_IOW( 0x45, drm_sis_mem_t)
 388 #define SIS_IOCTL_AGP_INIT     DRM_IOWR( 0x53, drm_sis_agp_t)
 389 #define SIS_IOCTL_AGP_ALLOC    DRM_IOWR( 0x54, drm_sis_mem_t)
 390 #define SIS_IOCTL_AGP_FREE     DRM_IOW( 0x55, drm_sis_mem_t)
 391 #define SIS_IOCTL_FLIP         DRM_IOW( 0x48, drm_sis_flip_t)
 392 #define SIS_IOCTL_FLIP_INIT    DRM_IO( 0x49)
 393 #define SIS_IOCTL_FLIP_FINAL   DRM_IO( 0x50)
 394 #endif
 395
 396 #endif