xref: /kernel/linux/linux-6.6/drivers/char/agp/agp.h (revision 62306a36)
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
43extern struct agp_bridge_data *agp_bridge;
44
45enum 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
53struct 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
64struct aper_size_info_8 {
65	int size;
66	int num_entries;
67	int page_order;
68	u8 size_value;
69};
70
71struct aper_size_info_16 {
72	int size;
73	int num_entries;
74	int page_order;
75	u16 size_value;
76};
77
78struct aper_size_info_32 {
79	int size;
80	int num_entries;
81	int page_order;
82	u32 size_value;
83};
84
85struct aper_size_info_lvl2 {
86	int size;
87	int num_entries;
88	u32 size_value;
89};
90
91struct aper_size_info_fixed {
92	int size;
93	int num_entries;
94	int page_order;
95};
96
97struct 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};
124
125struct agp_bridge_data {
126	const struct agp_version *version;
127	const struct agp_bridge_driver *driver;
128	const struct vm_operations_struct *vm_ops;
129	void *previous_size;
130	void *current_size;
131	void *dev_private_data;
132	struct pci_dev *dev;
133	u32 __iomem *gatt_table;
134	u32 *gatt_table_real;
135	unsigned long scratch_page;
136	struct page *scratch_page_page;
137	dma_addr_t scratch_page_dma;
138	unsigned long gart_bus_addr;
139	unsigned long gatt_bus_addr;
140	u32 mode;
141	enum chipset_type type;
142	unsigned long *key_list;
143	atomic_t current_memory_agp;
144	atomic_t agp_in_use;
145	int max_memory_agp;	/* in number of pages */
146	int aperture_size_idx;
147	int capndx;
148	int flags;
149	char major_version;
150	char minor_version;
151	struct list_head list;
152	u32 apbase_config;
153	/* list of agp_memory mapped to the aperture */
154	struct list_head mapped_list;
155	spinlock_t mapped_lock;
156};
157
158#define KB(x)	((x) * 1024)
159#define MB(x)	(KB (KB (x)))
160#define GB(x)	(MB (KB (x)))
161
162#define A_SIZE_8(x)	((struct aper_size_info_8 *) x)
163#define A_SIZE_16(x)	((struct aper_size_info_16 *) x)
164#define A_SIZE_32(x)	((struct aper_size_info_32 *) x)
165#define A_SIZE_LVL2(x)	((struct aper_size_info_lvl2 *) x)
166#define A_SIZE_FIX(x)	((struct aper_size_info_fixed *) x)
167#define A_IDX8(bridge)	(A_SIZE_8((bridge)->driver->aperture_sizes) + i)
168#define A_IDX16(bridge)	(A_SIZE_16((bridge)->driver->aperture_sizes) + i)
169#define A_IDX32(bridge)	(A_SIZE_32((bridge)->driver->aperture_sizes) + i)
170#define MAXKEY		(4096 * 32)
171
172#define PGE_EMPTY(b, p)	(!(p) || (p) == (unsigned long) (b)->scratch_page)
173
174
175struct agp_device_ids {
176	unsigned short device_id; /* first, to make table easier to read */
177	enum chipset_type chipset;
178	const char *chipset_name;
179	int (*chipset_setup) (struct pci_dev *pdev);	/* used to override generic */
180};
181
182/* Driver registration */
183struct agp_bridge_data *agp_alloc_bridge(void);
184void agp_put_bridge(struct agp_bridge_data *bridge);
185int agp_add_bridge(struct agp_bridge_data *bridge);
186void agp_remove_bridge(struct agp_bridge_data *bridge);
187
188/* Frontend routines. */
189#if IS_ENABLED(CONFIG_DRM_LEGACY)
190int agp_frontend_initialize(void);
191void agp_frontend_cleanup(void);
192#else
193static inline int agp_frontend_initialize(void) { return 0; }
194static inline void agp_frontend_cleanup(void) {}
195#endif
196
197/* Generic routines. */
198void agp_generic_enable(struct agp_bridge_data *bridge, u32 mode);
199int agp_generic_create_gatt_table(struct agp_bridge_data *bridge);
200int agp_generic_free_gatt_table(struct agp_bridge_data *bridge);
201struct agp_memory *agp_create_memory(int scratch_pages);
202int agp_generic_insert_memory(struct agp_memory *mem, off_t pg_start, int type);
203int agp_generic_remove_memory(struct agp_memory *mem, off_t pg_start, int type);
204struct agp_memory *agp_generic_alloc_by_type(size_t page_count, int type);
205void agp_generic_free_by_type(struct agp_memory *curr);
206struct page *agp_generic_alloc_page(struct agp_bridge_data *bridge);
207int agp_generic_alloc_pages(struct agp_bridge_data *agp_bridge,
208			    struct agp_memory *memory, size_t page_count);
209void agp_generic_destroy_page(struct page *page, int flags);
210void agp_generic_destroy_pages(struct agp_memory *memory);
211void agp_free_key(int key);
212int agp_num_entries(void);
213u32 agp_collect_device_status(struct agp_bridge_data *bridge, u32 mode, u32 command);
214void agp_device_command(u32 command, bool agp_v3);
215int agp_3_5_enable(struct agp_bridge_data *bridge);
216void global_cache_flush(void);
217void get_agp_version(struct agp_bridge_data *bridge);
218unsigned long agp_generic_mask_memory(struct agp_bridge_data *bridge,
219				      dma_addr_t phys, int type);
220int agp_generic_type_to_mask_type(struct agp_bridge_data *bridge,
221				  int type);
222struct agp_bridge_data *agp_generic_find_bridge(struct pci_dev *pdev);
223
224/* generic functions for user-populated AGP memory types */
225struct agp_memory *agp_generic_alloc_user(size_t page_count, int type);
226void agp_alloc_page_array(size_t size, struct agp_memory *mem);
227static inline void agp_free_page_array(struct agp_memory *mem)
228{
229	kvfree(mem->pages);
230}
231
232
233/* generic routines for agp>=3 */
234int agp3_generic_fetch_size(void);
235void agp3_generic_tlbflush(struct agp_memory *mem);
236int agp3_generic_configure(void);
237void agp3_generic_cleanup(void);
238
239/* GATT allocation. Returns/accepts GATT kernel virtual address. */
240#define alloc_gatt_pages(order)		\
241	((char *)__get_free_pages(GFP_KERNEL, (order)))
242#define free_gatt_pages(table, order)	\
243	free_pages((unsigned long)(table), (order))
244
245/* aperture sizes have been standardised since v3 */
246#define AGP_GENERIC_SIZES_ENTRIES 11
247extern const struct aper_size_info_16 agp3_generic_sizes[];
248
249extern int agp_off;
250extern int agp_try_unsupported_boot;
251
252long compat_agp_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
253
254/* Chipset independent registers (from AGP Spec) */
255#define AGP_APBASE	0x10
256#define AGP_APERTURE_BAR	0
257
258#define AGPSTAT		0x4
259#define AGPCMD		0x8
260#define AGPNISTAT	0xc
261#define AGPCTRL		0x10
262#define AGPAPSIZE	0x14
263#define AGPNEPG		0x16
264#define AGPGARTLO	0x18
265#define AGPGARTHI	0x1c
266#define AGPNICMD	0x20
267
268#define AGP_MAJOR_VERSION_SHIFT	(20)
269#define AGP_MINOR_VERSION_SHIFT	(16)
270
271#define AGPSTAT_RQ_DEPTH	(0xff000000)
272#define AGPSTAT_RQ_DEPTH_SHIFT	24
273
274#define AGPSTAT_CAL_MASK	(1<<12|1<<11|1<<10)
275#define AGPSTAT_ARQSZ		(1<<15|1<<14|1<<13)
276#define AGPSTAT_ARQSZ_SHIFT	13
277
278#define AGPSTAT_SBA		(1<<9)
279#define AGPSTAT_AGP_ENABLE	(1<<8)
280#define AGPSTAT_FW		(1<<4)
281#define AGPSTAT_MODE_3_0	(1<<3)
282
283#define AGPSTAT2_1X		(1<<0)
284#define AGPSTAT2_2X		(1<<1)
285#define AGPSTAT2_4X		(1<<2)
286
287#define AGPSTAT3_RSVD		(1<<2)
288#define AGPSTAT3_8X		(1<<1)
289#define AGPSTAT3_4X		(1)
290
291#define AGPCTRL_APERENB		(1<<8)
292#define AGPCTRL_GTLBEN		(1<<7)
293
294#define AGP2_RESERVED_MASK 0x00fffcc8
295#define AGP3_RESERVED_MASK 0x00ff00c4
296
297#define AGP_ERRATA_FASTWRITES 1<<0
298#define AGP_ERRATA_SBA	 1<<1
299#define AGP_ERRATA_1X 1<<2
300
301#endif	/* _AGP_BACKEND_PRIV_H */
302