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/pci/agpvar.h,v 1.1.2.2 2002/01/10 12:07:08 mdodd Exp $ 27 * $DragonFly: src/sys/dev/agp/agpvar.h,v 1.2 2003/06/17 04:28:56 dillon 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 */ 38 enum 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 */ 47 struct agp_info { 48 u_int32_t ai_mode; 49 vm_offset_t ai_aperture_base; 50 vm_size_t ai_aperture_size; 51 vm_offset_t ai_aperture_va; 52 vm_size_t ai_memory_allowed; 53 vm_size_t ai_memory_used; 54 u_int32_t ai_devid; 55 }; 56 57 struct agp_memory_info { 58 vm_size_t ami_size; /* size in bytes */ 59 vm_offset_t ami_physical; /* bogus hack for i810 */ 60 vm_offset_t ami_offset; /* page offset if bound */ 61 int ami_is_bound; /* non-zero if bound */ 62 }; 63 64 /* 65 * Find the AGP device and return it. 66 */ 67 device_t agp_find_device(void); 68 69 /* 70 * Return the current owner of the AGP chipset. 71 */ 72 enum agp_acquire_state agp_state(device_t dev); 73 74 /* 75 * Query the state of the AGP system. 76 */ 77 void agp_get_info(device_t dev, struct agp_info *info); 78 79 /* 80 * Acquire the AGP chipset for use by the kernel. Returns EBUSY if the 81 * AGP chipset is already acquired by another user. 82 */ 83 int agp_acquire(device_t dev); 84 85 /* 86 * Release the AGP chipset. 87 */ 88 int agp_release(device_t dev); 89 90 /* 91 * Enable the agp hardware with the relavent mode. The mode bits are 92 * defined in <pci/agpreg.h> 93 */ 94 int agp_enable(device_t dev, u_int32_t mode); 95 96 /* 97 * Allocate physical memory suitable for mapping into the AGP 98 * aperture. The value returned is an opaque handle which can be 99 * passed to agp_bind(), agp_unbind() or agp_deallocate(). 100 */ 101 void *agp_alloc_memory(device_t dev, int type, vm_size_t bytes); 102 103 /* 104 * Free memory which was allocated with agp_allocate(). 105 */ 106 void agp_free_memory(device_t dev, void *handle); 107 108 /* 109 * Bind memory allocated with agp_allocate() at a given offset within 110 * the AGP aperture. Returns EINVAL if the memory is already bound or 111 * the offset is not at an AGP page boundary. 112 */ 113 int agp_bind_memory(device_t dev, void *handle, vm_offset_t offset); 114 115 /* 116 * Unbind memory from the AGP aperture. Returns EINVAL if the memory 117 * is not bound. 118 */ 119 int agp_unbind_memory(device_t dev, void *handle); 120 121 /* 122 * Retrieve information about a memory block allocated with 123 * agp_alloc_memory(). 124 */ 125 void agp_memory_info(device_t dev, void *handle, struct agp_memory_info *mi); 126 127 #endif /* !_PCI_AGPVAR_H_ */ 128