2 * Copyright (c) 2000 Doug Rabson
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
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.
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
29 #ifndef _PCI_AGPVAR_H_
30 #define _PCI_AGPVAR_H_
33 * The AGP chipset can be acquired by user or kernel code. If the
34 * chipset has already been acquired, it cannot be acquired by another
35 * user until the previous user has released it.
37 enum agp_acquire_state {
44 * This structure is used to query the state of the AGP system.
48 vm_offset_t ai_aperture_base;
49 vm_size_t ai_aperture_size;
50 vm_size_t ai_memory_allowed;
51 vm_size_t ai_memory_used;
55 struct agp_memory_info {
56 vm_size_t ami_size; /* size in bytes */
57 vm_offset_t ami_physical; /* bogus hack for i810 */
58 vm_offset_t ami_offset; /* page offset if bound */
59 int ami_is_bound; /* non-zero if bound */
63 * Find the AGP device and return it.
65 device_t agp_find_device(void);
68 * Return the current owner of the AGP chipset.
70 enum agp_acquire_state agp_state(device_t dev);
73 * Query the state of the AGP system.
75 void agp_get_info(device_t dev, struct agp_info *info);
78 * Acquire the AGP chipset for use by the kernel. Returns EBUSY if the
79 * AGP chipset is already acquired by another user.
81 int agp_acquire(device_t dev);
84 * Release the AGP chipset.
86 int agp_release(device_t dev);
89 * Enable the agp hardware with the relavent mode. The mode bits are
90 * defined in <dev/agp/agpreg.h>
92 int agp_enable(device_t dev, u_int32_t mode);
95 * Allocate physical memory suitable for mapping into the AGP
96 * aperture. The value returned is an opaque handle which can be
97 * passed to agp_bind(), agp_unbind() or agp_deallocate().
99 void *agp_alloc_memory(device_t dev, int type, vm_size_t bytes);
102 * Free memory which was allocated with agp_allocate().
104 void agp_free_memory(device_t dev, void *handle);
107 * Bind memory allocated with agp_allocate() at a given offset within
108 * the AGP aperture. Returns EINVAL if the memory is already bound or
109 * the offset is not at an AGP page boundary.
111 int agp_bind_memory(device_t dev, void *handle, vm_offset_t offset);
114 * Unbind memory from the AGP aperture. Returns EINVAL if the memory
117 int agp_unbind_memory(device_t dev, void *handle);
120 * Retrieve information about a memory block allocated with
121 * agp_alloc_memory().
123 void agp_memory_info(device_t dev, void *handle, struct agp_memory_info *mi);
125 #endif /* !_PCI_AGPVAR_H_ */