Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  1 #include <media/saa7146_vv.h>
  2 
  3 #define BOARD_CAN_DO_VBI(dev)   (dev->revision != 0 && dev->vv_data->vbi_minor != -1)
  4 
  5 /****************************************************************************/
  6 /* resource management functions, shamelessly stolen from saa7134 driver */
  7 
  8 int saa7146_res_get(struct saa7146_fh *fh, unsigned int bit)
  9 {
 10         struct saa7146_dev *dev = fh->dev;
 11         struct saa7146_vv *vv = dev->vv_data;
 12 
 13         if (fh->resources & bit) {
 14                 DEB_D(("already allocated! want: 0x%02x, cur:0x%02x\n",bit,vv->resources));
 15                 /* have it already allocated */
 16                 return 1;
 17         }
 18 
 19         /* is it free? */
 20         mutex_lock(&dev->lock);
 21         if (vv->resources & bit) {
 22                 DEB_D(("locked! vv->resources:0x%02x, we want:0x%02x\n",vv->resources,bit));
 23                 /* no, someone else uses it */
 24                 mutex_unlock(&dev->lock);
 25                 return 0;
 26         }
 27         /* it's free, grab it */
 28         fh->resources  |= bit;
 29         vv->resources |= bit;
 30         DEB_D(("res: get 0x%02x, cur:0x%02x\n",bit,vv->resources));
 31         mutex_unlock(&dev->lock);
 32         return 1;
 33 }
 34 
 35 void saa7146_res_free(struct saa7146_fh *fh, unsigned int bits)
 36 {
 37         struct saa7146_dev *dev = fh->dev;
 38         struct saa7146_vv *vv = dev->vv_data;
 39 
 40         BUG_ON((fh->resources & bits) != bits);
 41 
 42         mutex_lock(&dev->lock);
 43         fh->resources  &= ~bits;
 44         vv->resources &= ~bits;
 45         DEB_D(("res: put 0x%02x, cur:0x%02x\n",bits,vv->resources));
 46         mutex_unlock(&dev->lock);
 47 }
 48 
 49 
 50 /********************************************************************************/
 51 /* common dma functions */
 52 
 53 void saa7146_dma_free(struct saa7146_dev *dev,struct videobuf_queue *q,
 54                                                 struct saa7146_buf *buf)
 55 {
 56         struct videobuf_dmabuf *dma=videobuf_to_dma(&buf->vb);
 57         DEB_EE(("dev:%p, buf:%p\n",dev,buf));
 58 
 59         BUG_ON(in_interrupt());
 60 
 61         videobuf_waiton(&buf->vb,0,0);
 62         videobuf_dma_unmap(q, dma);
 63         videobuf_dma_free(dma);
 64         buf->vb.state = VIDEOBUF_NEEDS_INIT;
 65 }
 66 
 67 
 68 /********************************************************************************/
 69 /* common buffer functions */
 70 
 71 int saa7146_buffer_queue(struct saa7146_dev *dev,
 72                          struct saa7146_dmaqueue *q,
 73                          struct saa7146_buf *buf)
 74 {
 75         assert_spin_locked(&dev->slock);
 76         DEB_EE(("dev:%p, dmaq:%p, buf:%p\n", dev, q, buf));
 77 
 78         BUG_ON(!q);
 79 
 80         if (NULL == q->curr) {
 81                 q->curr = buf;
 82                 DEB_D(("immediately activating buffer %p\n", buf));
 83                 buf->activate(dev,buf,NULL);
 84         } else {
 85                 list_add_tail(&buf->vb.queue,&q->queue);
 86                 buf->vb.state = VIDEOBUF_QUEUED;
 87                 DEB_D(("adding buffer %p to queue. (active buffer present)\n", buf));
 88         }
 89         return 0;
 90 }
 91 
 92 void saa7146_buffer_finish(struct saa7146_dev *dev,
 93                            struct saa7146_dmaqueue *q,
 94                            int state)
 95 {
 96         assert_spin_locked(&dev->slock);
 97         DEB_EE(("dev:%p, dmaq:%p, state:%d\n", dev, q, state));
 98         DEB_EE(("q->curr:%p\n",q->curr));
 99 
100         BUG_ON(!q->curr);
101 
102         /* finish current buffer */
103         if (NULL == q->curr) {
104                 DEB_D(("aiii. no current buffer\n"));
105                 return;
106         }
107 
108         q->curr->vb.state = state;
109         do_gettimeofday(&q->curr->vb.ts);
110         wake_up(&q->curr->vb.done);
111 
112         q->curr = NULL;
113 }
114 
115 void saa7146_buffer_next(struct saa7146_dev *dev,
116                          struct saa7146_dmaqueue *q, int vbi)
117 {
118         struct saa7146_buf *buf,*next = NULL;
119 
120         BUG_ON(!q);
121 
122         DEB_INT(("dev:%p, dmaq:%p, vbi:%d\n", dev, q, vbi));
123 
124         assert_spin_locked(&dev->slock);
125         if (!list_empty(&q->queue)) {
126                 /* activate next one from queue */
127                 buf = list_entry(q->queue.next,struct saa7146_buf,vb.queue);
128                 list_del(&buf->vb.queue);
129                 if (!list_empty(&q->queue))
130                         next = list_entry(q->queue.next,struct saa7146_buf, vb.queue);
131                 q->curr = buf;
132                 DEB_INT(("next buffer: buf:%p, prev:%p, next:%p\n", buf, q->queue.prev,q->queue.next));
133                 buf->activate(dev,buf,next);
134         } else {
135                 DEB_INT(("no next buffer. stopping.\n"));
136                 if( 0 != vbi ) {
137                         /* turn off video-dma3 */
138                         saa7146_write(dev,MC1, MASK_20);
139                 } else {
140                         /* nothing to do -- just prevent next video-dma1 transfer
141                            by lowering the protection address */
142 
143                         // fixme: fix this for vflip != 0
144 
145                         saa7146_write(dev, PROT_ADDR1, 0);
146                         saa7146_write(dev, MC2, (MASK_02|MASK_18));
147 
148                         /* write the address of the rps-program */
149                         saa7146_write(dev, RPS_ADDR0, dev->d_rps0.dma_handle);
150                         /* turn on rps */
151                         saa7146_write(dev, MC1, (MASK_12 | MASK_28));
152 
153 /*
154                         printk("vdma%d.base_even:     0x%08x\n", 1,saa7146_read(dev,BASE_EVEN1));
155                         printk("vdma%d.base_odd:      0x%08x\n", 1,saa7146_read(dev,BASE_ODD1));
156                         printk("vdma%d.prot_addr:     0x%08x\n", 1,saa7146_read(dev,PROT_ADDR1));
157                         printk("vdma%d.base_page:     0x%08x\n", 1,saa7146_read(dev,BASE_PAGE1));
158                         printk("vdma%d.pitch:         0x%08x\n", 1,saa7146_read(dev,PITCH1));
159                         printk("vdma%d.num_line_byte: 0x%08x\n", 1,saa7146_read(dev,NUM_LINE_BYTE1));
160 */
161                 }
162                 del_timer(&q->timeout);
163         }
164 }
165 
166 void saa7146_buffer_timeout(unsigned long data)
167 {
168         struct saa7146_dmaqueue *q = (struct saa7146_dmaqueue*)data;
169         struct saa7146_dev *dev = q->dev;
170         unsigned long flags;
171 
172         DEB_EE(("dev:%p, dmaq:%p\n", dev, q));
173 
174         spin_lock_irqsave(&dev->slock,flags);
175         if (q->curr) {
176                 DEB_D(("timeout on %p\n", q->curr));
177                 saa7146_buffer_finish(dev,q,VIDEOBUF_ERROR);
178         }
179 
180         /* we don't restart the transfer here like other drivers do. when
181            a streaming capture is disabled, the timeout function will be
182            called for the current buffer. if we activate the next buffer now,
183            we mess up our capture logic. if a timeout occurs on another buffer,
184            then something is seriously broken before, so no need to buffer the
185            next capture IMHO... */
186 /*
187         saa7146_buffer_next(dev,q);
188 */
189         spin_unlock_irqrestore(&dev->slock,flags);
190 }
191 
192 /********************************************************************************/
193 /* file operations */
194 
195 static int fops_open(struct inode *inode, struct file *file)
196 {
197         unsigned int minor = iminor(inode);
198         struct saa7146_dev *h = NULL, *dev = NULL;
199         struct list_head *list;
200         struct saa7146_fh *fh = NULL;
201         int result = 0;
202 
203         enum v4l2_buf_type type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
204 
205         DEB_EE(("inode:%p, file:%p, minor:%d\n",inode,file,minor));
206 
207         if (mutex_lock_interruptible(&saa7146_devices_lock))
208                 return -ERESTARTSYS;
209 
210         list_for_each(list,&saa7146_devices) {
211                 h = list_entry(list, struct saa7146_dev, item);
212                 if( NULL == h->vv_data ) {
213                         DEB_D(("device %p has not registered video devices.\n",h));
214                         continue;
215                 }
216                 DEB_D(("trying: %p @ major %d,%d\n",h,h->vv_data->video_minor,h->vv_data->vbi_minor));
217 
218                 if (h->vv_data->video_minor == minor) {
219                         dev = h;
220                 }
221                 if (h->vv_data->vbi_minor == minor) {
222                         type = V4L2_BUF_TYPE_VBI_CAPTURE;
223                         dev = h;
224                 }
225         }
226         if (NULL == dev) {
227                 DEB_S(("no such video device.\n"));
228                 result = -ENODEV;
229                 goto out;
230         }
231 
232         DEB_D(("using: %p\n",dev));
233 
234         /* check if an extension is registered */
235         if( NULL == dev->ext ) {
236                 DEB_S(("no extension registered for this device.\n"));
237                 result = -ENODEV;
238                 goto out;
239         }
240 
241         /* allocate per open data */
242         fh = kzalloc(sizeof(*fh),GFP_KERNEL);
243         if (NULL == fh) {
244                 DEB_S(("cannot allocate memory for per open data.\n"));
245                 result = -ENOMEM;
246                 goto out;
247         }
248 
249         file->private_data = fh;
250         fh->dev = dev;
251         fh->type = type;
252 
253         if( fh->type == V4L2_BUF_TYPE_VBI_CAPTURE) {
254                 DEB_S(("initializing vbi...\n"));
255                 if (dev->ext_vv_data->capabilities & V4L2_CAP_VBI_CAPTURE)
256                         result = saa7146_vbi_uops.open(dev,file);
257                 if (dev->ext_vv_data->vbi_fops.open)
258                         dev->ext_vv_data->vbi_fops.open(inode, file);
259         } else {
260                 DEB_S(("initializing video...\n"));
261                 result = saa7146_video_uops.open(dev,file);
262         }
263 
264         if (0 != result) {
265                 goto out;
266         }
267 
268         if( 0 == try_module_get(dev->ext->module)) {
269                 result = -EINVAL;
270                 goto out;
271         }
272 
273         result = 0;
274 out:
275         if (fh && result != 0) {
276                 kfree(fh);
277                 file->private_data = NULL;
278         }
279         mutex_unlock(&saa7146_devices_lock);
280         return result;
281 }
282 
283 static int fops_release(struct inode *inode, struct file *file)
284 {
285         struct saa7146_fh  *fh  = file->private_data;
286         struct saa7146_dev *dev = fh->dev;
287 
288         DEB_EE(("inode:%p, file:%p\n",inode,file));
289 
290         if (mutex_lock_interruptible(&saa7146_devices_lock))
291                 return -ERESTARTSYS;
292 
293         if( fh->type == V4L2_BUF_TYPE_VBI_CAPTURE) {
294                 if (dev->ext_vv_data->capabilities & V4L2_CAP_VBI_CAPTURE)
295                         saa7146_vbi_uops.release(dev,file);
296                 if (dev->ext_vv_data->vbi_fops.release)
297                         dev->ext_vv_data->vbi_fops.release(inode, file);
298         } else {
299                 saa7146_video_uops.release(dev,file);
300         }
301 
302         module_put(dev->ext->module);
303         file->private_data = NULL;
304         kfree(fh);
305 
306         mutex_unlock(&saa7146_devices_lock);
307 
308         return 0;
309 }
310 
311 static int fops_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsigned long arg)
312 {
313 /*
314         DEB_EE(("inode:%p, file:%p, cmd:%d, arg:%li\n",inode, file, cmd, arg));
315 */
316         return video_usercopy(inode, file, cmd, arg, saa7146_video_do_ioctl);
317 }
318 
319 static int fops_mmap(struct file *file, struct vm_area_struct * vma)
320 {
321         struct saa7146_fh *fh = file->private_data;
322         struct videobuf_queue *q;
323 
324         switch (fh->type) {
325         case V4L2_BUF_TYPE_VIDEO_CAPTURE: {
326                 DEB_EE(("V4L2_BUF_TYPE_VIDEO_CAPTURE: file:%p, vma:%p\n",file, vma));
327                 q = &fh->video_q;
328                 break;
329                 }
330         case V4L2_BUF_TYPE_VBI_CAPTURE: {
331                 DEB_EE(("V4L2_BUF_TYPE_VBI_CAPTURE: file:%p, vma:%p\n",file, vma));
332                 q = &fh->vbi_q;
333                 break;
334                 }
335         default:
336                 BUG();
337                 return 0;
338         }
339 
340         return videobuf_mmap_mapper(q,vma);
341 }
342 
343 static unsigned int fops_poll(struct file *file, struct poll_table_struct *wait)
344 {
345         struct saa7146_fh *fh = file->private_data;
346         struct videobuf_buffer *buf = NULL;
347         struct videobuf_queue *q;
348 
349         DEB_EE(("file:%p, poll:%p\n",file, wait));
350 
351         if (V4L2_BUF_TYPE_VBI_CAPTURE == fh->type) {
352                 if( 0 == fh->vbi_q.streaming )
353                         return videobuf_poll_stream(file, &fh->vbi_q, wait);
354                 q = &fh->vbi_q;
355         } else {
356                 DEB_D(("using video queue.\n"));
357                 q = &fh->video_q;
358         }
359 
360         if (!list_empty(&q->stream))
361                 buf = list_entry(q->stream.next, struct videobuf_buffer, stream);
362 
363         if (!buf) {
364                 DEB_D(("buf == NULL!\n"));
365                 return POLLERR;
366         }
367 
368         poll_wait(file, &buf->done, wait);
369         if (buf->state == VIDEOBUF_DONE || buf->state == VIDEOBUF_ERROR) {
370                 DEB_D(("poll succeeded!\n"));
371                 return POLLIN|POLLRDNORM;
372         }
373 
374         DEB_D(("nothing to poll for, buf->state:%d\n",buf->state));
375         return 0;
376 }
377 
378 static ssize_t fops_read(struct file *file, char __user *data, size_t count, loff_t *ppos)
379 {
380         struct saa7146_fh *fh = file->private_data;
381 
382         switch (fh->type) {
383         case V4L2_BUF_TYPE_VIDEO_CAPTURE: {
384 //              DEB_EE(("V4L2_BUF_TYPE_VIDEO_CAPTURE: file:%p, data:%p, count:%lun", file, data, (unsigned long)count));
385                 return saa7146_video_uops.read(file,data,count,ppos);
386                 }
387         case V4L2_BUF_TYPE_VBI_CAPTURE: {
388 //              DEB_EE(("V4L2_BUF_TYPE_VBI_CAPTURE: file:%p, data:%p, count:%lu\n", file, data, (unsigned long)count));
389                 if (fh->dev->ext_vv_data->capabilities & V4L2_CAP_VBI_CAPTURE)
390                         return saa7146_vbi_uops.read(file,data,count,ppos);
391                 else
392                         return -EINVAL;
393                 }
394                 break;
395         default:
396                 BUG();
397                 return 0;
398         }
399 }
400 
401 static ssize_t fops_write(struct file *file, const char __user *data, size_t count, loff_t *ppos)
402 {
403         struct saa7146_fh *fh = file->private_data;
404 
405         switch (fh->type) {
406         case V4L2_BUF_TYPE_VIDEO_CAPTURE:
407                 return -EINVAL;
408         case V4L2_BUF_TYPE_VBI_CAPTURE:
409                 if (fh->dev->ext_vv_data->vbi_fops.write)
410                         return fh->dev->ext_vv_data->vbi_fops.write(file, data, count, ppos);
411                 else
412                         return -EINVAL;
413         default:
414                 BUG();
415                 return -EINVAL;
416         }
417 }
418 
419 static const struct file_operations video_fops =
420 {
421         .owner          = THIS_MODULE,
422         .open           = fops_open,
423         .release        = fops_release,
424         .read           = fops_read,
425         .write          = fops_write,
426         .poll           = fops_poll,
427         .mmap           = fops_mmap,
428         .ioctl          = fops_ioctl,
429         .llseek         = no_llseek,
430 };
431 
432 static void vv_callback(struct saa7146_dev *dev, unsigned long status)
433 {
434         u32 isr = status;
435 
436         DEB_INT(("dev:%p, isr:0x%08x\n",dev,(u32)status));
437 
438         if (0 != (isr & (MASK_27))) {
439                 DEB_INT(("irq: RPS0 (0x%08x).\n",isr));
440                 saa7146_video_uops.irq_done(dev,isr);
441         }
442 
443         if (0 != (isr & (MASK_28))) {
444                 u32 mc2 = saa7146_read(dev, MC2);
445                 if( 0 != (mc2 & MASK_15)) {
446                         DEB_INT(("irq: RPS1 vbi workaround (0x%08x).\n",isr));
447                         wake_up(&dev->vv_data->vbi_wq);
448                         saa7146_write(dev,MC2, MASK_31);
449                         return;
450                 }
451                 DEB_INT(("irq: RPS1 (0x%08x).\n",isr));
452                 saa7146_vbi_uops.irq_done(dev,isr);
453         }
454 }
455 
456 static struct video_device device_template =
457 {
458         .fops           = &video_fops,
459         .minor          = -1,
460 };
461 
462 int saa7146_vv_init(struct saa7146_dev* dev, struct saa7146_ext_vv *ext_vv)
463 {
464         struct saa7146_vv *vv = kzalloc (sizeof(struct saa7146_vv),GFP_KERNEL);
465         if( NULL == vv ) {
466                 ERR(("out of memory. aborting.\n"));
467                 return -1;
468         }
469 
470         DEB_EE(("dev:%p\n",dev));
471 
472         /* set default values for video parts of the saa7146 */
473         saa7146_write(dev, BCS_CTRL, 0x80400040);
474 
475         /* enable video-port pins */
476         saa7146_write(dev, MC1, (MASK_10 | MASK_26));
477 
478         /* save per-device extension data (one extension can
479            handle different devices that might need different
480            configuration data) */
481         dev->ext_vv_data = ext_vv;
482 
483         vv->video_minor = -1;
484         vv->vbi_minor = -1;
485 
486         vv->d_clipping.cpu_addr = pci_alloc_consistent(dev->pci, SAA7146_CLIPPING_MEM, &vv->d_clipping.dma_handle);
487         if( NULL == vv->d_clipping.cpu_addr ) {
488                 ERR(("out of memory. aborting.\n"));
489                 kfree(vv);
490                 return -1;
491         }
492         memset(vv->d_clipping.cpu_addr, 0x0, SAA7146_CLIPPING_MEM);
493 
494         saa7146_video_uops.init(dev,vv);
495         if (dev->ext_vv_data->capabilities & V4L2_CAP_VBI_CAPTURE)
496                 saa7146_vbi_uops.init(dev,vv);
497 
498         dev->vv_data = vv;
499         dev->vv_callback = &vv_callback;
500 
501         return 0;
502 }
503 EXPORT_SYMBOL_GPL(saa7146_vv_init);
504 
505 int saa7146_vv_release(struct saa7146_dev* dev)
506 {
507         struct saa7146_vv *vv = dev->vv_data;
508 
509         DEB_EE(("dev:%p\n",dev));
510 
511         pci_free_consistent(dev->pci, SAA7146_CLIPPING_MEM, vv->d_clipping.cpu_addr, vv->d_clipping.dma_handle);
512         kfree(vv);
513         dev->vv_data = NULL;
514         dev->vv_callback = NULL;
515 
516         return 0;
517 }
518 EXPORT_SYMBOL_GPL(saa7146_vv_release);
519 
520 int saa7146_register_device(struct video_device **vid, struct saa7146_dev* dev,
521                             char *name, int type)
522 {
523         struct saa7146_vv *vv = dev->vv_data;
524         struct video_device *vfd;
525 
526         DEB_EE(("dev:%p, name:'%s', type:%d\n",dev,name,type));
527 
528         // released by vfd->release
529         vfd = video_device_alloc();
530         if (vfd == NULL)
531                 return -ENOMEM;
532 
533         memcpy(vfd, &device_template, sizeof(struct video_device));
534         strlcpy(vfd->name, name, sizeof(vfd->name));
535         vfd->release = video_device_release;
536         vfd->priv = dev;
537 
538         // fixme: -1 should be an insmod parameter *for the extension* (like "video_nr");
539         if (video_register_device(vfd, type, -1) < 0) {
540                 ERR(("cannot register v4l2 device. skipping.\n"));
541                 video_device_release(vfd);
542                 return -1;
543         }
544 
545         if( VFL_TYPE_GRABBER == type ) {
546                 vv->video_minor = vfd->minor;
547                 INFO(("%s: registered device video%d [v4l2]\n",
548                         dev->name, vfd->minor & 0x1f));
549         } else {
550                 vv->vbi_minor = vfd->minor;
551                 INFO(("%s: registered device vbi%d [v4l2]\n",
552                         dev->name, vfd->minor & 0x1f));
553         }
554 
555         *vid = vfd;
556         return 0;
557 }
558 EXPORT_SYMBOL_GPL(saa7146_register_device);
559 
560 int saa7146_unregister_device(struct video_device **vid, struct saa7146_dev* dev)
561 {
562         struct saa7146_vv *vv = dev->vv_data;
563 
564         DEB_EE(("dev:%p\n",dev));
565 
566         if( VFL_TYPE_GRABBER == (*vid)->type ) {
567                 vv->video_minor = -1;
568         } else {
569                 vv->vbi_minor = -1;
570         }
571 
572         video_unregister_device(*vid);
573         *vid = NULL;
574 
575         return 0;
576 }
577 EXPORT_SYMBOL_GPL(saa7146_unregister_device);
578 
579 static int __init saa7146_vv_init_module(void)
580 {
581         return 0;
582 }
583 
584 
585 static void __exit saa7146_vv_cleanup_module(void)
586 {
587 }
588 
589 module_init(saa7146_vv_init_module);
590 module_exit(saa7146_vv_cleanup_module);
591 
592 MODULE_AUTHOR("Michael Hunold <michael@mihu.de>");
593 MODULE_DESCRIPTION("video4linux driver for saa7146-based hardware");
594 MODULE_LICENSE("GPL");
595 
  This page was automatically generated by the LXR engine.