drivers/char/agp/agp.h

   1 /*
   2  * AGPGART
   3  * Copyright (C) 2004 Silicon Graphics, Inc.
   4  * Copyright (C) 2002-2004 Dave Jones
   5  * Copyright (C) 1999 Jeff Hartmann
   6  * Copyright (C) 1999 Precision Insight, Inc.
   7  * Copyright (C) 1999 Xi Graphics, Inc.
   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 shall be included
  17  * in all copies or substantial portions of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  20  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  22  * JEFF HARTMANN, OR ANY OTHER CONTRIBUTORS BE LIABLE FOR ANY CLAIM,
  23  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  24  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
  25  * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  26  *
  27  */
  28
  29 #ifndef _AGP_BACKEND_PRIV_H
  30 #define _AGP_BACKEND_PRIV_H 1
  31
  32 #include <asm/agp.h>    /* for flush_agp_cache() */
  33
  34 #define PFX "agpgart: "
  35
  36 //#define AGP_DEBUG 1
  37 #ifdef AGP_DEBUG
  38 #define DBG(x,y...) printk (KERN_DEBUG PFX "%s: " x "\n", __func__ , ## y)
  39 #else
  40 #define DBG(x,y...) do { } while (0)
  41 #endif
  42
  43 extern struct agp_bridge_data *agp_bridge;
  44
  45 enum aper_size_type {
  46         U8_APER_SIZE,
  47         U16_APER_SIZE,
  48         U32_APER_SIZE,
  49         LVL2_APER_SIZE,
  50         FIXED_APER_SIZE
  51 };
  52
  53 struct gatt_mask {
  54         unsigned long mask;
  55         u32 type;
  56         /* totally device specific, for integrated chipsets that
  57          * might have different types of memory masks.  For other
  58          * devices this will probably be ignored */
  59 };
  60
  61 #define AGP_PAGE_DESTROY_UNMAP 1
  62 #define AGP_PAGE_DESTROY_FREE 2
  63
  64 struct aper_size_info_8 {
  65         int size;
  66         int num_entries;
  67         int page_order;
  68         u8 size_value;
  69 };
  70
  71 struct aper_size_info_16 {
  72         int size;
  73         int num_entries;
  74         int page_order;
  75         u16 size_value;
  76 };
  77
  78 struct aper_size_info_32 {
  79         int size;
  80         int num_entries;
  81         int page_order;
  82         u32 size_value;
  83 };
  84
  85 struct aper_size_info_lvl2 {
  86         int size;
  87         int num_entries;
  88         u32 size_value;
  89 };
  90
  91 struct aper_size_info_fixed {
  92         int size;
  93         int num_entries;
  94         int page_order;
  95 };
  96
  97 struct agp_bridge_driver {
  98         struct module *owner;
  99         const void *aperture_sizes;
 100         int num_aperture_sizes;
 101         enum aper_size_type size_type;
 102         bool cant_use_aperture;
 103         bool needs_scratch_page;
 104         const struct gatt_mask *masks;
 105         int (*fetch_size)(void);
 106         int (*configure)(void);
 107         void (*agp_enable)(struct agp_bridge_data *, u32);
 108         void (*cleanup)(void);
 109         void (*tlb_flush)(struct agp_memory *);
 110         unsigned long (*mask_memory)(struct agp_bridge_data *, dma_addr_t, int);
 111         void (*cache_flush)(void);
 112         int (*create_gatt_table)(struct agp_bridge_data *);
 113         int (*free_gatt_table)(struct agp_bridge_data *);
 114         int (*insert_memory)(struct agp_memory *, off_t, int);
 115         int (*remove_memory)(struct agp_memory *, off_t, int);
 116         struct agp_memory *(*alloc_by_type) (size_t, int);
 117         void (*free_by_type)(struct agp_memory *);
 118         struct page *(*agp_alloc_page)(struct agp_bridge_data *);
 119         int (*agp_alloc_pages)(struct agp_bridge_data *, struct agp_memory *, size_t);
 120         void (*agp_destroy_page)(struct page *, int flags);
 121         void (*agp_destroy_pages)(struct agp_memory *);
 122         int (*agp_type_to_mask_type) (struct agp_bridge_data *, int);
 123         void (*chipset_flush)(struct agp_bridge_data *);
 124
 125         int (*agp_map_page)(struct page *page, dma_addr_t *ret);
 126         void (*agp_unmap_page)(struct page *page, dma_addr_t dma);
 127         int (*agp_map_memory)(struct agp_memory *mem);
 128         void (*agp_unmap_memory)(struct agp_memory *mem);
 129 };
 130
 131 struct agp_bridge_data {
 132         const struct agp_version *version;
 133         const struct agp_bridge_driver *driver;
 134         const struct vm_operations_struct *vm_ops;
 135         void *previous_size;
 136         void *current_size;
 137         void *dev_private_data;
 138         struct pci_dev *dev;
 139         u32 __iomem *gatt_table;
 140         u32 *gatt_table_real;
 141         unsigned long scratch_page;
 142         struct page *scratch_page_page;
 143         dma_addr_t scratch_page_dma;
 144         unsigned long gart_bus_addr;
 145         unsigned long gatt_bus_addr;
 146         u32 mode;
 147         enum chipset_type type;
 148         unsigned long *key_list;
 149         atomic_t current_memory_agp;
 150         atomic_t agp_in_use;
 151         int max_memory_agp;     /* in number of pages */
 152         int aperture_size_idx;
 153         int capndx;
 154         int flags;
 155         char major_version;
 156         char minor_version;
 157         struct list_head list;
 158         u32 apbase_config;
 159         /* list of agp_memory mapped to the aperture */
 160         struct list_head mapped_list;
 161         spinlock_t mapped_lock;
 162 };
 163
 164 #define KB(x)   ((x) * 1024)
 165 #define MB(x)   (KB (KB (x)))
 166 #define GB(x)   (MB (KB (x)))
 167
 168 #define A_SIZE_8(x)     ((struct aper_size_info_8 *) x)
 169 #define A_SIZE_16(x)    ((struct aper_size_info_16 *) x)
 170 #define A_SIZE_32(x)    ((struct aper_size_info_32 *) x)
 171 #define A_SIZE_LVL2(x)  ((struct aper_size_info_lvl2 *) x)
 172 #define A_SIZE_FIX(x)   ((struct aper_size_info_fixed *) x)
 173 #define A_IDX8(bridge)  (A_SIZE_8((bridge)->driver->aperture_sizes) + i)
 174 #define A_IDX16(bridge) (A_SIZE_16((bridge)->driver->aperture_sizes) + i)
 175 #define A_IDX32(bridge) (A_SIZE_32((bridge)->driver->aperture_sizes) + i)
 176 #define MAXKEY          (4096 * 32)
 177
 178 #define PGE_EMPTY(b, p) (!(p) || (p) == (unsigned long) (b)->scratch_page)
 179
 180
 181 struct agp_device_ids {
 182         unsigned short device_id; /* first, to make table easier to read */
 183         enum chipset_type chipset;
 184         const char *chipset_name;
 185         int (*chipset_setup) (struct pci_dev *pdev);    /* used to override generic */
 186 };
 187
 188 /* Driver registration */
 189 struct agp_bridge_data *agp_alloc_bridge(void);
 190 void agp_put_bridge(struct agp_bridge_data *bridge);
 191 int agp_add_bridge(struct agp_bridge_data *bridge);
 192 void agp_remove_bridge(struct agp_bridge_data *bridge);
 193
 194 /* Frontend routines. */
 195 int agp_frontend_initialize(void);
 196 void agp_frontend_cleanup(void);
 197
 198 /* Generic routines. */
 199 void agp_generic_enable(struct agp_bridge_data *bridge, u32 mode);
 200 int agp_generic_create_gatt_table(struct agp_bridge_data *bridge);
 201 int agp_generic_free_gatt_table(struct agp_bridge_data *bridge);
 202 struct agp_memory *agp_create_memory(int scratch_pages);
 203 int agp_generic_insert_memory(struct agp_memory *mem, off_t pg_start, int type);
 204 int agp_generic_remove_memory(struct agp_memory *mem, off_t pg_start, int type);
 205 struct agp_memory *agp_generic_alloc_by_type(size_t page_count, int type);
 206 void agp_generic_free_by_type(struct agp_memory *curr);
 207 struct page *agp_generic_alloc_page(struct agp_bridge_data *bridge);
 208 int agp_generic_alloc_pages(struct agp_bridge_data *agp_bridge,
 209                             struct agp_memory *memory, size_t page_count);
 210 void agp_generic_destroy_page(struct page *page, int flags);
 211 void agp_generic_destroy_pages(struct agp_memory *memory);
 212 void agp_free_key(int key);
 213 int agp_num_entries(void);
 214 u32 agp_collect_device_status(struct agp_bridge_data *bridge, u32 mode, u32 command);
 215 void agp_device_command(u32 command, bool agp_v3);
 216 int agp_3_5_enable(struct agp_bridge_data *bridge);
 217 void global_cache_flush(void);
 218 void get_agp_version(struct agp_bridge_data *bridge);
 219 unsigned long agp_generic_mask_memory(struct agp_bridge_data *bridge,
 220                                       dma_addr_t phys, int type);
 221 int agp_generic_type_to_mask_type(struct agp_bridge_data *bridge,
 222                                   int type);
 223 struct agp_bridge_data *agp_generic_find_bridge(struct pci_dev *pdev);
 224
 225 /* generic functions for user-populated AGP memory types */
 226 struct agp_memory *agp_generic_alloc_user(size_t page_count, int type);
 227 void agp_alloc_page_array(size_t size, struct agp_memory *mem);
 228 void agp_free_page_array(struct agp_memory *mem);
 229
 230
 231 /* generic routines for agp>=3 */
 232 int agp3_generic_fetch_size(void);
 233 void agp3_generic_tlbflush(struct agp_memory *mem);
 234 int agp3_generic_configure(void);
 235 void agp3_generic_cleanup(void);
 236
 237 /* aperture sizes have been standardised since v3 */
 238 #define AGP_GENERIC_SIZES_ENTRIES 11
 239 extern const struct aper_size_info_16 agp3_generic_sizes[];
 240
 241 extern int agp_off;
 242 extern int agp_try_unsupported_boot;
 243
 244 long compat_agp_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
 245
 246 /* Chipset independant registers (from AGP Spec) */
 247 #define AGP_APBASE      0x10
 248
 249 #define AGPSTAT         0x4
 250 #define AGPCMD          0x8
 251 #define AGPNISTAT       0xc
 252 #define AGPCTRL         0x10
 253 #define AGPAPSIZE       0x14
 254 #define AGPNEPG         0x16
 255 #define AGPGARTLO       0x18
 256 #define AGPGARTHI       0x1c
 257 #define AGPNICMD        0x20
 258
 259 #define AGP_MAJOR_VERSION_SHIFT (20)
 260 #define AGP_MINOR_VERSION_SHIFT (16)
 261
 262 #define AGPSTAT_RQ_DEPTH        (0xff000000)
 263 #define AGPSTAT_RQ_DEPTH_SHIFT  24
 264
 265 #define AGPSTAT_CAL_MASK        (1<<12|1<<11|1<<10)
 266 #define AGPSTAT_ARQSZ           (1<<15|1<<14|1<<13)
 267 #define AGPSTAT_ARQSZ_SHIFT     13
 268
 269 #define AGPSTAT_SBA             (1<<9)
 270 #define AGPSTAT_AGP_ENABLE      (1<<8)
 271 #define AGPSTAT_FW              (1<<4)
 272 #define AGPSTAT_MODE_3_0        (1<<3)
 273
 274 #define AGPSTAT2_1X             (1<<0)
 275 #define AGPSTAT2_2X             (1<<1)
 276 #define AGPSTAT2_4X             (1<<2)
 277
 278 #define AGPSTAT3_RSVD           (1<<2)
 279 #define AGPSTAT3_8X             (1<<1)
 280 #define AGPSTAT3_4X             (1)
 281
 282 #define AGPCTRL_APERENB         (1<<8)
 283 #define AGPCTRL_GTLBEN          (1<<7)
 284
 285 #define AGP2_RESERVED_MASK 0x00fffcc8
 286 #define AGP3_RESERVED_MASK 0x00ff00c4
 287
 288 #define AGP_ERRATA_FASTWRITES 1<<0
 289 #define AGP_ERRATA_SBA   1<<1
 290 #define AGP_ERRATA_1X 1<<2
 291
 292 #endif  /* _AGP_BACKEND_PRIV_H */