xref: /linux/drivers/gpu/drm/radeon/radeon_drv.h (revision 34dc1baba215b826e454b8d19e4f24adbeb7d00d)
1 /* radeon_drv.h -- Private header for radeon driver -*- linux-c -*-
2  *
3  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
4  * Copyright 2000 VA Linux Systems, Inc., Fremont, California.
5  * All rights reserved.
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a
8  * copy of this software and associated documentation files (the "Software"),
9  * to deal in the Software without restriction, including without limitation
10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11  * and/or sell copies of the Software, and to permit persons to whom the
12  * Software is furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the next
15  * paragraph) shall be included in all copies or substantial portions of the
16  * Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
21  * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
22  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
23  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24  * DEALINGS IN THE SOFTWARE.
25  *
26  * Authors:
27  *    Kevin E. Martin <martin@valinux.com>
28  *    Gareth Hughes <gareth@valinux.com>
29  */
30 
31 #ifndef __RADEON_DRV_H__
32 #define __RADEON_DRV_H__
33 
34 #include <linux/firmware.h>
35 #include <linux/platform_device.h>
36 #include <drm/drm_legacy.h>
37 
38 #include "radeon_family.h"
39 
40 /* General customization:
41  */
42 
43 #define DRIVER_AUTHOR		"Gareth Hughes, Keith Whitwell, others."
44 
45 #define DRIVER_NAME		"radeon"
46 #define DRIVER_DESC		"ATI Radeon"
47 #define DRIVER_DATE		"20080528"
48 
49 /* Interface history:
50  *
51  * 1.1 - ??
52  * 1.2 - Add vertex2 ioctl (keith)
53  *     - Add stencil capability to clear ioctl (gareth, keith)
54  *     - Increase MAX_TEXTURE_LEVELS (brian)
55  * 1.3 - Add cmdbuf ioctl (keith)
56  *     - Add support for new radeon packets (keith)
57  *     - Add getparam ioctl (keith)
58  *     - Add flip-buffers ioctl, deprecate fullscreen foo (keith).
59  * 1.4 - Add scratch registers to get_param ioctl.
60  * 1.5 - Add r200 packets to cmdbuf ioctl
61  *     - Add r200 function to init ioctl
62  *     - Add 'scalar2' instruction to cmdbuf
63  * 1.6 - Add static GART memory manager
64  *       Add irq handler (won't be turned on unless X server knows to)
65  *       Add irq ioctls and irq_active getparam.
66  *       Add wait command for cmdbuf ioctl
67  *       Add GART offset query for getparam
68  * 1.7 - Add support for cube map registers: R200_PP_CUBIC_FACES_[0..5]
69  *       and R200_PP_CUBIC_OFFSET_F1_[0..5].
70  *       Added packets R200_EMIT_PP_CUBIC_FACES_[0..5] and
71  *       R200_EMIT_PP_CUBIC_OFFSETS_[0..5].  (brian)
72  * 1.8 - Remove need to call cleanup ioctls on last client exit (keith)
73  *       Add 'GET' queries for starting additional clients on different VT's.
74  * 1.9 - Add DRM_IOCTL_RADEON_CP_RESUME ioctl.
75  *       Add texture rectangle support for r100.
76  * 1.10- Add SETPARAM ioctl; first parameter to set is FB_LOCATION, which
77  *       clients use to tell the DRM where they think the framebuffer is
78  *       located in the card's address space
79  * 1.11- Add packet R200_EMIT_RB3D_BLENDCOLOR to support GL_EXT_blend_color
80  *       and GL_EXT_blend_[func|equation]_separate on r200
81  * 1.12- Add R300 CP microcode support - this just loads the CP on r300
82  *       (No 3D support yet - just microcode loading).
83  * 1.13- Add packet R200_EMIT_TCL_POINT_SPRITE_CNTL for ARB_point_parameters
84  *     - Add hyperz support, add hyperz flags to clear ioctl.
85  * 1.14- Add support for color tiling
86  *     - Add R100/R200 surface allocation/free support
87  * 1.15- Add support for texture micro tiling
88  *     - Add support for r100 cube maps
89  * 1.16- Add R200_EMIT_PP_TRI_PERF_CNTL packet to support brilinear
90  *       texture filtering on r200
91  * 1.17- Add initial support for R300 (3D).
92  * 1.18- Add support for GL_ATI_fragment_shader, new packets
93  *       R200_EMIT_PP_AFS_0/1, R200_EMIT_PP_TXCTLALL_0-5 (replaces
94  *       R200_EMIT_PP_TXFILTER_0-5, 2 more regs) and R200_EMIT_ATF_TFACTOR
95  *       (replaces R200_EMIT_TFACTOR_0 (8 consts instead of 6)
96  * 1.19- Add support for gart table in FB memory and PCIE r300
97  * 1.20- Add support for r300 texrect
98  * 1.21- Add support for card type getparam
99  * 1.22- Add support for texture cache flushes (R300_TX_CNTL)
100  * 1.23- Add new radeon memory map work from benh
101  * 1.24- Add general-purpose packet for manipulating scratch registers (r300)
102  * 1.25- Add support for r200 vertex programs (R200_EMIT_VAP_PVS_CNTL,
103  *       new packet type)
104  * 1.26- Add support for variable size PCI(E) gart aperture
105  * 1.27- Add support for IGP GART
106  * 1.28- Add support for VBL on CRTC2
107  * 1.29- R500 3D cmd buffer support
108  * 1.30- Add support for occlusion queries
109  * 1.31- Add support for num Z pipes from GET_PARAM
110  * 1.32- fixes for rv740 setup
111  * 1.33- Add r6xx/r7xx const buffer support
112  * 1.34- fix evergreen/cayman GS register
113  */
114 #define DRIVER_MAJOR		1
115 #define DRIVER_MINOR		34
116 #define DRIVER_PATCHLEVEL	0
117 
118 long radeon_drm_ioctl(struct file *filp,
119 		      unsigned int cmd, unsigned long arg);
120 
121 int radeon_driver_load_kms(struct drm_device *dev, unsigned long flags);
122 void radeon_driver_unload_kms(struct drm_device *dev);
123 int radeon_driver_open_kms(struct drm_device *dev, struct drm_file *file_priv);
124 void radeon_driver_postclose_kms(struct drm_device *dev,
125 				 struct drm_file *file_priv);
126 
127 /* atpx handler */
128 #if defined(CONFIG_VGA_SWITCHEROO)
129 void radeon_register_atpx_handler(void);
130 void radeon_unregister_atpx_handler(void);
131 bool radeon_has_atpx_dgpu_power_cntl(void);
132 bool radeon_is_atpx_hybrid(void);
133 #else
134 static inline void radeon_register_atpx_handler(void) {}
135 static inline void radeon_unregister_atpx_handler(void) {}
136 static inline bool radeon_has_atpx_dgpu_power_cntl(void) { return false; }
137 static inline bool radeon_is_atpx_hybrid(void) { return false; }
138 #endif
139 
140 #endif				/* __RADEON_DRV_H__ */
141