xref: /netbsd-src/sys/external/bsd/drm2/dist/drm/via/via_drv.h (revision c185307488bbf6fc561ecae5b867f82bd8fc67eb)
1 /*	$NetBSD: via_drv.h,v 1.7 2021/12/19 12:30:23 riastradh Exp $	*/
2 
3 /*
4  * Copyright 1998-2003 VIA Technologies, Inc. All Rights Reserved.
5  * Copyright 2001-2003 S3 Graphics, Inc. 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, sub license,
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
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the 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 NON-INFRINGEMENT. IN NO EVENT SHALL
21  * VIA, S3 GRAPHICS, 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 #ifndef _VIA_DRV_H_
27 #define _VIA_DRV_H_
28 
29 #include <linux/irqreturn.h>
30 #include <linux/jiffies.h>
31 #include <linux/sched.h>
32 #include <linux/sched/signal.h>
33 #include <linux/wait.h>
34 
35 #include <drm/drm_ioctl.h>
36 #include <drm/drm_legacy.h>
37 #include <drm/drm_mm.h>
38 #include <drm/via_drm.h>
39 
40 #define DRIVER_AUTHOR	"Various"
41 
42 #define DRIVER_NAME		"via"
43 #define DRIVER_DESC		"VIA Unichrome / Pro"
44 #define DRIVER_DATE		"20070202"
45 
46 #define DRIVER_MAJOR		2
47 #define DRIVER_MINOR		11
48 #define DRIVER_PATCHLEVEL	1
49 
50 #include "via_verifier.h"
51 
52 #include "via_dmablit.h"
53 
54 #define VIA_PCI_BUF_SIZE 60000
55 #define VIA_FIRE_BUF_SIZE  1024
56 #define VIA_NUM_IRQS 4
57 
58 typedef struct drm_via_ring_buffer {
59 	drm_local_map_t map;
60 	char *virtual_start;
61 } drm_via_ring_buffer_t;
62 
63 typedef uint32_t maskarray_t[5];
64 
65 typedef struct drm_via_irq {
66 #ifdef __NetBSD__
67 	spinlock_t irq_lock;
68 	unsigned irq_received;
69 #else
70 	atomic_t irq_received;
71 #endif
72 	uint32_t pending_mask;
73 	uint32_t enable_mask;
74 #ifdef __NetBSD__
75 	drm_waitqueue_t irq_queue;
76 #else
77 	wait_queue_head_t irq_queue;
78 #endif
79 } drm_via_irq_t;
80 
81 typedef struct drm_via_private {
82 	drm_via_sarea_t *sarea_priv;
83 	drm_local_map_t *sarea;
84 	drm_local_map_t *fb;
85 	drm_local_map_t *mmio;
86 	unsigned long agpAddr;
87 #ifdef __NetBSD__
88 	spinlock_t decoder_lock[VIA_NR_XVMC_LOCKS];
89 	drm_waitqueue_t decoder_queue[VIA_NR_XVMC_LOCKS];
90 #else
91 	wait_queue_head_t decoder_queue[VIA_NR_XVMC_LOCKS];
92 #endif
93 	char *dma_ptr;
94 	unsigned int dma_low;
95 	unsigned int dma_high;
96 	unsigned int dma_offset;
97 	uint32_t dma_wrap;
98 	volatile uint32_t *last_pause_ptr;
99 	volatile uint32_t *hw_addr_ptr;
100 	drm_via_ring_buffer_t ring;
101 	ktime_t last_vblank;
102 	int last_vblank_valid;
103 	ktime_t nsec_per_vblank;
104 	atomic_t vbl_received;
105 	drm_via_state_t hc_state;
106 	char pci_buf[VIA_PCI_BUF_SIZE];
107 	const uint32_t *fire_offsets[VIA_FIRE_BUF_SIZE];
108 	uint32_t num_fire_offsets;
109 	int chipset;
110 	drm_via_irq_t via_irqs[VIA_NUM_IRQS];
111 	unsigned num_irqs;
112 	maskarray_t *irq_masks;
113 	uint32_t irq_enable_mask;
114 	uint32_t irq_pending_mask;
115 	int *irq_map;
116 	unsigned int idle_fault;
117 	int vram_initialized;
118 	struct drm_mm vram_mm;
119 	int agp_initialized;
120 	struct drm_mm agp_mm;
121 	/** Mapping of userspace keys to mm objects */
122 	struct idr object_idr;
123 	unsigned long vram_offset;
124 	unsigned long agp_offset;
125 	drm_via_blitq_t blit_queues[VIA_NUM_BLIT_ENGINES];
126 	uint32_t dma_diff;
127 } drm_via_private_t;
128 
129 struct via_file_private {
130 	struct list_head obj_list;
131 };
132 
133 enum via_family {
134   VIA_OTHER = 0,     /* Baseline */
135   VIA_PRO_GROUP_A,   /* Another video engine and DMA commands */
136   VIA_DX9_0          /* Same video as pro_group_a, but 3D is unsupported */
137 };
138 
139 /* VIA MMIO register access */
via_read(struct drm_via_private * dev_priv,u32 reg)140 static inline u32 via_read(struct drm_via_private *dev_priv, u32 reg)
141 {
142 	return DRM_READ32(dev_priv->mmio, reg);
143 }
144 
via_write(struct drm_via_private * dev_priv,u32 reg,u32 val)145 static inline void via_write(struct drm_via_private *dev_priv, u32 reg,
146 			     u32 val)
147 {
148 	DRM_WRITE32(dev_priv->mmio, reg, val);
149 }
150 
via_write8(struct drm_via_private * dev_priv,u32 reg,u32 val)151 static inline void via_write8(struct drm_via_private *dev_priv, u32 reg,
152 			      u32 val)
153 {
154 	DRM_WRITE8(dev_priv->mmio, reg, val);
155 }
156 
via_write8_mask(struct drm_via_private * dev_priv,u32 reg,u32 mask,u32 val)157 static inline void via_write8_mask(struct drm_via_private *dev_priv,
158 				   u32 reg, u32 mask, u32 val)
159 {
160 	u32 tmp;
161 
162 	tmp = DRM_READ8(dev_priv->mmio, reg);
163 	tmp = (tmp & ~mask) | (val & mask);
164 	DRM_WRITE8(dev_priv->mmio, reg, tmp);
165 }
166 
167 /*
168  * Poll in a loop waiting for 'contidition' to be true.
169  * Note: A direct replacement with wait_event_interruptible_timeout()
170  *       will not work unless driver is updated to emit wake_up()
171  *       in relevant places that can impact the 'condition'
172  *
173  * Returns:
174  *   ret keeps current value if 'condition' becomes true
175  *   ret = -BUSY if timeout happens
176  *   ret = -EINTR if a signal interrupted the waiting period
177  */
178 #define VIA_WAIT_ON( ret, queue, timeout, condition )		\
179 do {								\
180 	DECLARE_WAITQUEUE(entry, current);			\
181 	unsigned long end = jiffies + (timeout);		\
182 	add_wait_queue(&(queue), &entry);			\
183 								\
184 	for (;;) {						\
185 		__set_current_state(TASK_INTERRUPTIBLE);	\
186 		if (condition)					\
187 			break;					\
188 		if (time_after_eq(jiffies, end)) {		\
189 			ret = -EBUSY;				\
190 			break;					\
191 		}						\
192 		schedule_timeout((HZ/100 > 1) ? HZ/100 : 1);	\
193 		if (signal_pending(current)) {			\
194 			ret = -EINTR;				\
195 			break;					\
196 		}						\
197 	}							\
198 	__set_current_state(TASK_RUNNING);			\
199 	remove_wait_queue(&(queue), &entry);			\
200 } while (0)
201 
202 extern const struct drm_ioctl_desc via_ioctls[];
203 extern int via_max_ioctl;
204 
205 extern int via_fb_init(struct drm_device *dev, void *data, struct drm_file *file_priv);
206 extern int via_mem_alloc(struct drm_device *dev, void *data, struct drm_file *file_priv);
207 extern int via_mem_free(struct drm_device *dev, void *data, struct drm_file *file_priv);
208 extern int via_agp_init(struct drm_device *dev, void *data, struct drm_file *file_priv);
209 extern int via_map_init(struct drm_device *dev, void *data, struct drm_file *file_priv);
210 extern int via_decoder_futex(struct drm_device *dev, void *data, struct drm_file *file_priv);
211 extern int via_wait_irq(struct drm_device *dev, void *data, struct drm_file *file_priv);
212 extern int via_dma_blit_sync(struct drm_device *dev, void *data, struct drm_file *file_priv);
213 extern int via_dma_blit(struct drm_device *dev, void *data, struct drm_file *file_priv);
214 
215 extern int via_driver_load(struct drm_device *dev, unsigned long chipset);
216 extern void via_driver_unload(struct drm_device *dev);
217 
218 extern int via_init_context(struct drm_device *dev, int context);
219 extern int via_final_context(struct drm_device *dev, int context);
220 
221 extern int via_do_cleanup_map(struct drm_device *dev);
222 extern u32 via_get_vblank_counter(struct drm_device *dev, unsigned int pipe);
223 extern int via_enable_vblank(struct drm_device *dev, unsigned int pipe);
224 extern void via_disable_vblank(struct drm_device *dev, unsigned int pipe);
225 
226 extern irqreturn_t via_driver_irq_handler(DRM_IRQ_ARGS);
227 extern void via_driver_irq_preinstall(struct drm_device *dev);
228 extern int via_driver_irq_postinstall(struct drm_device *dev);
229 extern void via_driver_irq_uninstall(struct drm_device *dev);
230 
231 extern int via_dma_cleanup(struct drm_device *dev);
232 extern void via_init_command_verifier(void);
233 extern int via_driver_dma_quiescent(struct drm_device *dev);
234 extern void via_init_futex(drm_via_private_t *dev_priv);
235 extern void via_cleanup_futex(drm_via_private_t *dev_priv);
236 extern void via_release_futex(drm_via_private_t *dev_priv, int context);
237 
238 extern void via_reclaim_buffers_locked(struct drm_device *dev,
239 				       struct drm_file *file_priv);
240 extern void via_lastclose(struct drm_device *dev);
241 
242 extern void via_dmablit_handler(struct drm_device *dev, int engine, int from_irq);
243 extern void via_init_dmablit(struct drm_device *dev);
244 
245 #endif
246