agp: A rewrite of the i810 bits of the driver
[dragonfly.git] / sys / dev / agp / agpvar.h
... / ...
CommitLineData
1/*-
2 * Copyright (c) 2000 Doug Rabson
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: src/sys/dev/agp/agpvar.h,v 1.4 2007/11/12 21:51:37 jhb Exp $
27 * $DragonFly: src/sys/dev/agp/agpvar.h,v 1.4 2008/01/07 01:34:58 corecode Exp $
28 */
29
30#ifndef _PCI_AGPVAR_H_
31#define _PCI_AGPVAR_H_
32
33/*
34 * The AGP chipset can be acquired by user or kernel code. If the
35 * chipset has already been acquired, it cannot be acquired by another
36 * user until the previous user has released it.
37 */
38enum agp_acquire_state {
39 AGP_ACQUIRE_FREE,
40 AGP_ACQUIRE_USER,
41 AGP_ACQUIRE_KERNEL
42};
43
44/*
45 * This structure is used to query the state of the AGP system.
46 */
47struct agp_info {
48 u_int32_t ai_mode;
49 vm_offset_t ai_aperture_base;
50 vm_size_t ai_aperture_size;
51 vm_size_t ai_memory_allowed;
52 vm_size_t ai_memory_used;
53 u_int32_t ai_devid;
54};
55
56struct agp_memory_info {
57 vm_size_t ami_size; /* size in bytes */
58 vm_offset_t ami_physical; /* bogus hack for i810 */
59 vm_offset_t ami_offset; /* page offset if bound */
60 int ami_is_bound; /* non-zero if bound */
61};
62
63/*
64 * Find the AGP device and return it.
65 */
66device_t agp_find_device(void);
67
68/*
69 * Return the current owner of the AGP chipset.
70 */
71enum agp_acquire_state agp_state(device_t dev);
72
73/*
74 * Query the state of the AGP system.
75 */
76void agp_get_info(device_t dev, struct agp_info *info);
77
78/*
79 * Acquire the AGP chipset for use by the kernel. Returns EBUSY if the
80 * AGP chipset is already acquired by another user.
81 */
82int agp_acquire(device_t dev);
83
84/*
85 * Release the AGP chipset.
86 */
87int agp_release(device_t dev);
88
89/*
90 * Enable the agp hardware with the relavent mode. The mode bits are
91 * defined in <pci/agpreg.h>
92 */
93int agp_enable(device_t dev, u_int32_t mode);
94
95/*
96 * Allocate physical memory suitable for mapping into the AGP
97 * aperture. The value returned is an opaque handle which can be
98 * passed to agp_bind(), agp_unbind() or agp_deallocate().
99 */
100void *agp_alloc_memory(device_t dev, int type, vm_size_t bytes);
101
102/*
103 * Free memory which was allocated with agp_allocate().
104 */
105void agp_free_memory(device_t dev, void *handle);
106
107/*
108 * Bind memory allocated with agp_allocate() at a given offset within
109 * the AGP aperture. Returns EINVAL if the memory is already bound or
110 * the offset is not at an AGP page boundary.
111 */
112int agp_bind_memory(device_t dev, void *handle, vm_offset_t offset);
113
114/*
115 * Unbind memory from the AGP aperture. Returns EINVAL if the memory
116 * is not bound.
117 */
118int agp_unbind_memory(device_t dev, void *handle);
119
120/*
121 * Retrieve information about a memory block allocated with
122 * agp_alloc_memory().
123 */
124void agp_memory_info(device_t dev, void *handle, struct agp_memory_info *mi);
125
126#define AGP_NORMAL_MEMORY 0
127
128#define AGP_USER_TYPES (1 << 16)
129#define AGP_USER_MEMORY (AGP_USER_TYPES)
130#define AGP_USER_CACHED_MEMORY (AGP_USER_TYPES + 1)
131
132#endif /* !_PCI_AGPVAR_H_ */