Merge /spare/repo/netdev-2.6 branch 'ieee80211'
[linux-2.6] / drivers / char / drm / drm_irq.c
1 /**
2  * \file drm_irq.h 
3  * IRQ support
4  *
5  * \author Rickard E. (Rik) Faith <faith@valinux.com>
6  * \author Gareth Hughes <gareth@valinux.com>
7  */
8
9 /*
10  * Created: Fri Mar 19 14:30:16 1999 by faith@valinux.com
11  *
12  * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
13  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
14  * All Rights Reserved.
15  *
16  * Permission is hereby granted, free of charge, to any person obtaining a
17  * copy of this software and associated documentation files (the "Software"),
18  * to deal in the Software without restriction, including without limitation
19  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
20  * and/or sell copies of the Software, and to permit persons to whom the
21  * Software is furnished to do so, subject to the following conditions:
22  *
23  * The above copyright notice and this permission notice (including the next
24  * paragraph) shall be included in all copies or substantial portions of the
25  * Software.
26  *
27  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
28  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
29  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
30  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
31  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
32  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
33  * OTHER DEALINGS IN THE SOFTWARE.
34  */
35
36 #include "drmP.h"
37
38 #include <linux/interrupt.h>    /* For task queue support */
39
40 /**
41  * Get interrupt from bus id.
42  * 
43  * \param inode device inode.
44  * \param filp file pointer.
45  * \param cmd command.
46  * \param arg user argument, pointing to a drm_irq_busid structure.
47  * \return zero on success or a negative number on failure.
48  * 
49  * Finds the PCI device with the specified bus id and gets its IRQ number.
50  * This IOCTL is deprecated, and will now return EINVAL for any busid not equal
51  * to that of the device that this DRM instance attached to.
52  */
53 int drm_irq_by_busid(struct inode *inode, struct file *filp,
54                    unsigned int cmd, unsigned long arg)
55 {
56         drm_file_t *priv = filp->private_data;
57         drm_device_t *dev = priv->head->dev;
58         drm_irq_busid_t __user *argp = (void __user *)arg;
59         drm_irq_busid_t p;
60
61         if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
62                 return -EINVAL;
63
64         if (copy_from_user(&p, argp, sizeof(p)))
65                 return -EFAULT;
66
67         if ((p.busnum >> 8) != dev->pci_domain ||
68             (p.busnum & 0xff) != dev->pci_bus ||
69             p.devnum != dev->pci_slot ||
70             p.funcnum != dev->pci_func)
71                 return -EINVAL;
72
73         p.irq = dev->irq;
74
75         DRM_DEBUG("%d:%d:%d => IRQ %d\n",
76                   p.busnum, p.devnum, p.funcnum, p.irq);
77         if (copy_to_user(argp, &p, sizeof(p)))
78                 return -EFAULT;
79         return 0;
80 }
81
82 /**
83  * Install IRQ handler.
84  *
85  * \param dev DRM device.
86  * \param irq IRQ number.
87  *
88  * Initializes the IRQ related data, and setups drm_device::vbl_queue. Installs the handler, calling the driver
89  * \c drm_driver_irq_preinstall() and \c drm_driver_irq_postinstall() functions
90  * before and after the installation.
91  */
92 static int drm_irq_install( drm_device_t *dev )
93 {
94         int ret;
95         unsigned long sh_flags=0;
96
97         if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
98                 return -EINVAL;
99
100         if ( dev->irq == 0 )
101                 return -EINVAL;
102
103         down( &dev->struct_sem );
104
105         /* Driver must have been initialized */
106         if ( !dev->dev_private ) {
107                 up( &dev->struct_sem );
108                 return -EINVAL;
109         }
110
111         if ( dev->irq_enabled ) {
112                 up( &dev->struct_sem );
113                 return -EBUSY;
114         }
115         dev->irq_enabled = 1;
116         up( &dev->struct_sem );
117
118         DRM_DEBUG( "%s: irq=%d\n", __FUNCTION__, dev->irq );
119
120         if (drm_core_check_feature(dev, DRIVER_IRQ_VBL)) {
121                 init_waitqueue_head(&dev->vbl_queue);
122                 
123                 spin_lock_init( &dev->vbl_lock );
124                 
125                 INIT_LIST_HEAD( &dev->vbl_sigs.head );
126                 
127                 dev->vbl_pending = 0;
128         }
129
130                                 /* Before installing handler */
131         dev->driver->irq_preinstall(dev);
132
133                                 /* Install handler */
134         if (drm_core_check_feature(dev, DRIVER_IRQ_SHARED))
135                 sh_flags = SA_SHIRQ;
136         
137         ret = request_irq( dev->irq, dev->driver->irq_handler,
138                            sh_flags, dev->devname, dev );
139         if ( ret < 0 ) {
140                 down( &dev->struct_sem );
141                 dev->irq_enabled = 0;
142                 up( &dev->struct_sem );
143                 return ret;
144         }
145
146                                 /* After installing handler */
147         dev->driver->irq_postinstall(dev);
148
149         return 0;
150 }
151
152 /**
153  * Uninstall the IRQ handler.
154  *
155  * \param dev DRM device.
156  *
157  * Calls the driver's \c drm_driver_irq_uninstall() function, and stops the irq.
158  */
159 int drm_irq_uninstall( drm_device_t *dev )
160 {
161         int irq_enabled;
162
163         if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
164                 return -EINVAL;
165
166         down( &dev->struct_sem );
167         irq_enabled = dev->irq_enabled;
168         dev->irq_enabled = 0;
169         up( &dev->struct_sem );
170
171         if ( !irq_enabled )
172                 return -EINVAL;
173
174         DRM_DEBUG( "%s: irq=%d\n", __FUNCTION__, dev->irq );
175
176         dev->driver->irq_uninstall(dev);
177
178         free_irq( dev->irq, dev );
179
180         return 0;
181 }
182 EXPORT_SYMBOL(drm_irq_uninstall);
183
184 /**
185  * IRQ control ioctl.
186  *
187  * \param inode device inode.
188  * \param filp file pointer.
189  * \param cmd command.
190  * \param arg user argument, pointing to a drm_control structure.
191  * \return zero on success or a negative number on failure.
192  *
193  * Calls irq_install() or irq_uninstall() according to \p arg.
194  */
195 int drm_control( struct inode *inode, struct file *filp,
196                   unsigned int cmd, unsigned long arg )
197 {
198         drm_file_t *priv = filp->private_data;
199         drm_device_t *dev = priv->head->dev;
200         drm_control_t ctl;
201         
202         /* if we haven't irq we fallback for compatibility reasons - this used to be a separate function in drm_dma.h */
203
204         if ( copy_from_user( &ctl, (drm_control_t __user *)arg, sizeof(ctl) ) )
205                 return -EFAULT;
206
207         switch ( ctl.func ) {
208         case DRM_INST_HANDLER:
209                 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
210                         return 0;
211                 if (dev->if_version < DRM_IF_VERSION(1, 2) &&
212                     ctl.irq != dev->irq)
213                         return -EINVAL;
214                 return drm_irq_install( dev );
215         case DRM_UNINST_HANDLER:
216                 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
217                         return 0;
218                 return drm_irq_uninstall( dev );
219         default:
220                 return -EINVAL;
221         }
222 }
223
224 /**
225  * Wait for VBLANK.
226  *
227  * \param inode device inode.
228  * \param filp file pointer.
229  * \param cmd command.
230  * \param data user argument, pointing to a drm_wait_vblank structure.
231  * \return zero on success or a negative number on failure.
232  *
233  * Verifies the IRQ is installed. 
234  *
235  * If a signal is requested checks if this task has already scheduled the same signal
236  * for the same vblank sequence number - nothing to be done in
237  * that case. If the number of tasks waiting for the interrupt exceeds 100 the
238  * function fails. Otherwise adds a new entry to drm_device::vbl_sigs for this
239  * task.
240  *
241  * If a signal is not requested, then calls vblank_wait().
242  */
243 int drm_wait_vblank( DRM_IOCTL_ARGS )
244 {
245         drm_file_t *priv = filp->private_data;
246         drm_device_t *dev = priv->head->dev;
247         drm_wait_vblank_t __user *argp = (void __user *)data;
248         drm_wait_vblank_t vblwait;
249         struct timeval now;
250         int ret = 0;
251         unsigned int flags;
252
253         if (!drm_core_check_feature(dev, DRIVER_IRQ_VBL))
254                 return -EINVAL;
255
256         if (!dev->irq)
257                 return -EINVAL;
258
259         DRM_COPY_FROM_USER_IOCTL( vblwait, argp, sizeof(vblwait) );
260
261         switch ( vblwait.request.type & ~_DRM_VBLANK_FLAGS_MASK ) {
262         case _DRM_VBLANK_RELATIVE:
263                 vblwait.request.sequence += atomic_read( &dev->vbl_received );
264                 vblwait.request.type &= ~_DRM_VBLANK_RELATIVE;
265         case _DRM_VBLANK_ABSOLUTE:
266                 break;
267         default:
268                 return -EINVAL;
269         }
270
271         flags = vblwait.request.type & _DRM_VBLANK_FLAGS_MASK;
272         
273         if ( flags & _DRM_VBLANK_SIGNAL ) {
274                 unsigned long irqflags;
275                 drm_vbl_sig_t *vbl_sig;
276                 
277                 vblwait.reply.sequence = atomic_read( &dev->vbl_received );
278
279                 spin_lock_irqsave( &dev->vbl_lock, irqflags );
280
281                 /* Check if this task has already scheduled the same signal
282                  * for the same vblank sequence number; nothing to be done in
283                  * that case
284                  */
285                 list_for_each_entry( vbl_sig, &dev->vbl_sigs.head, head ) {
286                         if (vbl_sig->sequence == vblwait.request.sequence
287                             && vbl_sig->info.si_signo == vblwait.request.signal
288                             && vbl_sig->task == current)
289                         {
290                                 spin_unlock_irqrestore( &dev->vbl_lock, irqflags );
291                                 goto done;
292                         }
293                 }
294
295                 if ( dev->vbl_pending >= 100 ) {
296                         spin_unlock_irqrestore( &dev->vbl_lock, irqflags );
297                         return -EBUSY;
298                 }
299
300                 dev->vbl_pending++;
301
302                 spin_unlock_irqrestore( &dev->vbl_lock, irqflags );
303
304                 if ( !( vbl_sig = drm_alloc( sizeof( drm_vbl_sig_t ), DRM_MEM_DRIVER ) ) ) {
305                         return -ENOMEM;
306                 }
307
308                 memset( (void *)vbl_sig, 0, sizeof(*vbl_sig) );
309
310                 vbl_sig->sequence = vblwait.request.sequence;
311                 vbl_sig->info.si_signo = vblwait.request.signal;
312                 vbl_sig->task = current;
313
314                 spin_lock_irqsave( &dev->vbl_lock, irqflags );
315
316                 list_add_tail( (struct list_head *) vbl_sig, &dev->vbl_sigs.head );
317
318                 spin_unlock_irqrestore( &dev->vbl_lock, irqflags );
319         } else {
320                 if (dev->driver->vblank_wait)
321                         ret = dev->driver->vblank_wait( dev, &vblwait.request.sequence );
322
323                 do_gettimeofday( &now );
324                 vblwait.reply.tval_sec = now.tv_sec;
325                 vblwait.reply.tval_usec = now.tv_usec;
326         }
327
328 done:
329         DRM_COPY_TO_USER_IOCTL( argp, vblwait, sizeof(vblwait) );
330
331         return ret;
332 }
333
334 /**
335  * Send the VBLANK signals.
336  *
337  * \param dev DRM device.
338  *
339  * Sends a signal for each task in drm_device::vbl_sigs and empties the list.
340  *
341  * If a signal is not requested, then calls vblank_wait().
342  */
343 void drm_vbl_send_signals( drm_device_t *dev )
344 {
345         struct list_head *list, *tmp;
346         drm_vbl_sig_t *vbl_sig;
347         unsigned int vbl_seq = atomic_read( &dev->vbl_received );
348         unsigned long flags;
349
350         spin_lock_irqsave( &dev->vbl_lock, flags );
351
352         list_for_each_safe( list, tmp, &dev->vbl_sigs.head ) {
353                 vbl_sig = list_entry( list, drm_vbl_sig_t, head );
354                 if ( ( vbl_seq - vbl_sig->sequence ) <= (1<<23) ) {
355                         vbl_sig->info.si_code = vbl_seq;
356                         send_sig_info( vbl_sig->info.si_signo, &vbl_sig->info, vbl_sig->task );
357
358                         list_del( list );
359
360                         drm_free( vbl_sig, sizeof(*vbl_sig), DRM_MEM_DRIVER );
361
362                         dev->vbl_pending--;
363                 }
364         }
365
366         spin_unlock_irqrestore( &dev->vbl_lock, flags );
367 }
368 EXPORT_SYMBOL(drm_vbl_send_signals);
369
370