xref: /openbmc/linux/drivers/media/pci/cx88/cx88-mpeg.c (revision 293d5b43)
1 /*
2  *
3  *  Support for the mpeg transport stream transfers
4  *  PCI function #2 of the cx2388x.
5  *
6  *    (c) 2004 Jelle Foks <jelle@foks.us>
7  *    (c) 2004 Chris Pascoe <c.pascoe@itee.uq.edu.au>
8  *    (c) 2004 Gerd Knorr <kraxel@bytesex.org>
9  *
10  *  This program is free software; you can redistribute it and/or modify
11  *  it under the terms of the GNU General Public License as published by
12  *  the Free Software Foundation; either version 2 of the License, or
13  *  (at your option) any later version.
14  *
15  *  This program is distributed in the hope that it will be useful,
16  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
17  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  *  GNU General Public License for more details.
19  *
20  *  You should have received a copy of the GNU General Public License
21  *  along with this program; if not, write to the Free Software
22  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23  */
24 
25 #include <linux/module.h>
26 #include <linux/slab.h>
27 #include <linux/init.h>
28 #include <linux/device.h>
29 #include <linux/dma-mapping.h>
30 #include <linux/interrupt.h>
31 #include <asm/delay.h>
32 
33 #include "cx88.h"
34 
35 /* ------------------------------------------------------------------ */
36 
37 MODULE_DESCRIPTION("mpeg driver for cx2388x based TV cards");
38 MODULE_AUTHOR("Jelle Foks <jelle@foks.us>");
39 MODULE_AUTHOR("Chris Pascoe <c.pascoe@itee.uq.edu.au>");
40 MODULE_AUTHOR("Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]");
41 MODULE_LICENSE("GPL");
42 MODULE_VERSION(CX88_VERSION);
43 
44 static unsigned int debug;
45 module_param(debug,int,0644);
46 MODULE_PARM_DESC(debug,"enable debug messages [mpeg]");
47 
48 #define dprintk(level, fmt, arg...) do {				       \
49 	if (debug + 1 > level)						       \
50 		printk(KERN_DEBUG "%s/2-mpeg: " fmt, dev->core->name, ## arg); \
51 } while(0)
52 
53 #define mpeg_dbg(level, fmt, arg...) do {				  \
54 	if (debug + 1 > level)						  \
55 		printk(KERN_DEBUG "%s/2-mpeg: " fmt, core->name, ## arg); \
56 } while(0)
57 
58 #if defined(CONFIG_MODULES) && defined(MODULE)
59 static void request_module_async(struct work_struct *work)
60 {
61 	struct cx8802_dev *dev=container_of(work, struct cx8802_dev, request_module_wk);
62 
63 	if (dev->core->board.mpeg & CX88_MPEG_DVB)
64 		request_module("cx88-dvb");
65 	if (dev->core->board.mpeg & CX88_MPEG_BLACKBIRD)
66 		request_module("cx88-blackbird");
67 }
68 
69 static void request_modules(struct cx8802_dev *dev)
70 {
71 	INIT_WORK(&dev->request_module_wk, request_module_async);
72 	schedule_work(&dev->request_module_wk);
73 }
74 
75 static void flush_request_modules(struct cx8802_dev *dev)
76 {
77 	flush_work(&dev->request_module_wk);
78 }
79 #else
80 #define request_modules(dev)
81 #define flush_request_modules(dev)
82 #endif /* CONFIG_MODULES */
83 
84 
85 static LIST_HEAD(cx8802_devlist);
86 static DEFINE_MUTEX(cx8802_mutex);
87 /* ------------------------------------------------------------------ */
88 
89 int cx8802_start_dma(struct cx8802_dev    *dev,
90 			    struct cx88_dmaqueue *q,
91 			    struct cx88_buffer   *buf)
92 {
93 	struct cx88_core *core = dev->core;
94 
95 	dprintk(1, "cx8802_start_dma w: %d, h: %d, f: %d\n",
96 		core->width, core->height, core->field);
97 
98 	/* setup fifo + format */
99 	cx88_sram_channel_setup(core, &cx88_sram_channels[SRAM_CH28],
100 				dev->ts_packet_size, buf->risc.dma);
101 
102 	/* write TS length to chip */
103 	cx_write(MO_TS_LNGTH, dev->ts_packet_size);
104 
105 	/* FIXME: this needs a review.
106 	 * also: move to cx88-blackbird + cx88-dvb source files? */
107 
108 	dprintk( 1, "core->active_type_id = 0x%08x\n", core->active_type_id);
109 
110 	if ( (core->active_type_id == CX88_MPEG_DVB) &&
111 		(core->board.mpeg & CX88_MPEG_DVB) ) {
112 
113 		dprintk( 1, "cx8802_start_dma doing .dvb\n");
114 		/* negedge driven & software reset */
115 		cx_write(TS_GEN_CNTRL, 0x0040 | dev->ts_gen_cntrl);
116 		udelay(100);
117 		cx_write(MO_PINMUX_IO, 0x00);
118 		cx_write(TS_HW_SOP_CNTRL, 0x47<<16|188<<4|0x01);
119 		switch (core->boardnr) {
120 		case CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q:
121 		case CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T:
122 		case CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD:
123 		case CX88_BOARD_PCHDTV_HD5500:
124 			cx_write(TS_SOP_STAT, 1<<13);
125 			break;
126 		case CX88_BOARD_SAMSUNG_SMT_7020:
127 			cx_write(TS_SOP_STAT, 0x00);
128 			break;
129 		case CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1:
130 		case CX88_BOARD_HAUPPAUGE_NOVASE2_S1:
131 			cx_write(MO_PINMUX_IO, 0x88); /* Enable MPEG parallel IO and video signal pins */
132 			udelay(100);
133 			break;
134 		case CX88_BOARD_HAUPPAUGE_HVR1300:
135 			/* Enable MPEG parallel IO and video signal pins */
136 			cx_write(MO_PINMUX_IO, 0x88);
137 			cx_write(TS_SOP_STAT, 0);
138 			cx_write(TS_VALERR_CNTRL, 0);
139 			break;
140 		case CX88_BOARD_PINNACLE_PCTV_HD_800i:
141 			/* Enable MPEG parallel IO and video signal pins */
142 			cx_write(MO_PINMUX_IO, 0x88);
143 			cx_write(TS_HW_SOP_CNTRL, (0x47 << 16) | (188 << 4));
144 			dev->ts_gen_cntrl = 5;
145 			cx_write(TS_SOP_STAT, 0);
146 			cx_write(TS_VALERR_CNTRL, 0);
147 			udelay(100);
148 			break;
149 		default:
150 			cx_write(TS_SOP_STAT, 0x00);
151 			break;
152 		}
153 		cx_write(TS_GEN_CNTRL, dev->ts_gen_cntrl);
154 		udelay(100);
155 	} else if ( (core->active_type_id == CX88_MPEG_BLACKBIRD) &&
156 		(core->board.mpeg & CX88_MPEG_BLACKBIRD) ) {
157 		dprintk( 1, "cx8802_start_dma doing .blackbird\n");
158 		cx_write(MO_PINMUX_IO, 0x88); /* enable MPEG parallel IO */
159 
160 		cx_write(TS_GEN_CNTRL, 0x46); /* punctured clock TS & posedge driven & software reset */
161 		udelay(100);
162 
163 		cx_write(TS_HW_SOP_CNTRL, 0x408); /* mpeg start byte */
164 		cx_write(TS_VALERR_CNTRL, 0x2000);
165 
166 		cx_write(TS_GEN_CNTRL, 0x06); /* punctured clock TS & posedge driven */
167 		udelay(100);
168 	} else {
169 		printk( "%s() Failed. Unsupported value in .mpeg (0x%08x)\n", __func__,
170 			core->board.mpeg );
171 		return -EINVAL;
172 	}
173 
174 	/* reset counter */
175 	cx_write(MO_TS_GPCNTRL, GP_COUNT_CONTROL_RESET);
176 	q->count = 0;
177 
178 	/* enable irqs */
179 	dprintk( 1, "setting the interrupt mask\n" );
180 	cx_set(MO_PCI_INTMSK, core->pci_irqmask | PCI_INT_TSINT);
181 	cx_set(MO_TS_INTMSK,  0x1f0011);
182 
183 	/* start dma */
184 	cx_set(MO_DEV_CNTRL2, (1<<5));
185 	cx_set(MO_TS_DMACNTRL, 0x11);
186 	return 0;
187 }
188 
189 static int cx8802_stop_dma(struct cx8802_dev *dev)
190 {
191 	struct cx88_core *core = dev->core;
192 	dprintk( 1, "cx8802_stop_dma\n" );
193 
194 	/* stop dma */
195 	cx_clear(MO_TS_DMACNTRL, 0x11);
196 
197 	/* disable irqs */
198 	cx_clear(MO_PCI_INTMSK, PCI_INT_TSINT);
199 	cx_clear(MO_TS_INTMSK, 0x1f0011);
200 
201 	/* Reset the controller */
202 	cx_write(TS_GEN_CNTRL, 0xcd);
203 	return 0;
204 }
205 
206 static int cx8802_restart_queue(struct cx8802_dev    *dev,
207 				struct cx88_dmaqueue *q)
208 {
209 	struct cx88_buffer *buf;
210 
211 	dprintk( 1, "cx8802_restart_queue\n" );
212 	if (list_empty(&q->active))
213 		return 0;
214 
215 	buf = list_entry(q->active.next, struct cx88_buffer, list);
216 	dprintk(2,"restart_queue [%p/%d]: restart dma\n",
217 		buf, buf->vb.vb2_buf.index);
218 	cx8802_start_dma(dev, q, buf);
219 	return 0;
220 }
221 
222 /* ------------------------------------------------------------------ */
223 
224 int cx8802_buf_prepare(struct vb2_queue *q, struct cx8802_dev *dev,
225 			struct cx88_buffer *buf)
226 {
227 	int size = dev->ts_packet_size * dev->ts_packet_count;
228 	struct sg_table *sgt = vb2_dma_sg_plane_desc(&buf->vb.vb2_buf, 0);
229 	struct cx88_riscmem *risc = &buf->risc;
230 	int rc;
231 
232 	if (vb2_plane_size(&buf->vb.vb2_buf, 0) < size)
233 		return -EINVAL;
234 	vb2_set_plane_payload(&buf->vb.vb2_buf, 0, size);
235 
236 	rc = cx88_risc_databuffer(dev->pci, risc, sgt->sgl,
237 			     dev->ts_packet_size, dev->ts_packet_count, 0);
238 	if (rc) {
239 		if (risc->cpu)
240 			pci_free_consistent(dev->pci, risc->size, risc->cpu, risc->dma);
241 		memset(risc, 0, sizeof(*risc));
242 		return rc;
243 	}
244 	return 0;
245 }
246 
247 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf)
248 {
249 	struct cx88_buffer    *prev;
250 	struct cx88_dmaqueue  *cx88q = &dev->mpegq;
251 
252 	dprintk( 1, "cx8802_buf_queue\n" );
253 	/* add jump to start */
254 	buf->risc.cpu[1] = cpu_to_le32(buf->risc.dma + 8);
255 	buf->risc.jmp[0] = cpu_to_le32(RISC_JUMP | RISC_CNT_INC);
256 	buf->risc.jmp[1] = cpu_to_le32(buf->risc.dma + 8);
257 
258 	if (list_empty(&cx88q->active)) {
259 		dprintk( 1, "queue is empty - first active\n" );
260 		list_add_tail(&buf->list, &cx88q->active);
261 		dprintk(1,"[%p/%d] %s - first active\n",
262 			buf, buf->vb.vb2_buf.index, __func__);
263 
264 	} else {
265 		buf->risc.cpu[0] |= cpu_to_le32(RISC_IRQ1);
266 		dprintk( 1, "queue is not empty - append to active\n" );
267 		prev = list_entry(cx88q->active.prev, struct cx88_buffer, list);
268 		list_add_tail(&buf->list, &cx88q->active);
269 		prev->risc.jmp[1] = cpu_to_le32(buf->risc.dma);
270 		dprintk( 1, "[%p/%d] %s - append to active\n",
271 			buf, buf->vb.vb2_buf.index, __func__);
272 	}
273 }
274 
275 /* ----------------------------------------------------------- */
276 
277 static void do_cancel_buffers(struct cx8802_dev *dev)
278 {
279 	struct cx88_dmaqueue *q = &dev->mpegq;
280 	struct cx88_buffer *buf;
281 	unsigned long flags;
282 
283 	spin_lock_irqsave(&dev->slock,flags);
284 	while (!list_empty(&q->active)) {
285 		buf = list_entry(q->active.next, struct cx88_buffer, list);
286 		list_del(&buf->list);
287 		vb2_buffer_done(&buf->vb.vb2_buf, VB2_BUF_STATE_ERROR);
288 	}
289 	spin_unlock_irqrestore(&dev->slock,flags);
290 }
291 
292 void cx8802_cancel_buffers(struct cx8802_dev *dev)
293 {
294 	dprintk( 1, "cx8802_cancel_buffers" );
295 	cx8802_stop_dma(dev);
296 	do_cancel_buffers(dev);
297 }
298 
299 static const char * cx88_mpeg_irqs[32] = {
300 	"ts_risci1", NULL, NULL, NULL,
301 	"ts_risci2", NULL, NULL, NULL,
302 	"ts_oflow",  NULL, NULL, NULL,
303 	"ts_sync",   NULL, NULL, NULL,
304 	"opc_err", "par_err", "rip_err", "pci_abort",
305 	"ts_err?",
306 };
307 
308 static void cx8802_mpeg_irq(struct cx8802_dev *dev)
309 {
310 	struct cx88_core *core = dev->core;
311 	u32 status, mask, count;
312 
313 	dprintk( 1, "cx8802_mpeg_irq\n" );
314 	status = cx_read(MO_TS_INTSTAT);
315 	mask   = cx_read(MO_TS_INTMSK);
316 	if (0 == (status & mask))
317 		return;
318 
319 	cx_write(MO_TS_INTSTAT, status);
320 
321 	if (debug || (status & mask & ~0xff))
322 		cx88_print_irqbits(core->name, "irq mpeg ",
323 				   cx88_mpeg_irqs, ARRAY_SIZE(cx88_mpeg_irqs),
324 				   status, mask);
325 
326 	/* risc op code error */
327 	if (status & (1 << 16)) {
328 		printk(KERN_WARNING "%s: mpeg risc op code error\n",core->name);
329 		cx_clear(MO_TS_DMACNTRL, 0x11);
330 		cx88_sram_channel_dump(dev->core, &cx88_sram_channels[SRAM_CH28]);
331 	}
332 
333 	/* risc1 y */
334 	if (status & 0x01) {
335 		dprintk( 1, "wake up\n" );
336 		spin_lock(&dev->slock);
337 		count = cx_read(MO_TS_GPCNT);
338 		cx88_wakeup(dev->core, &dev->mpegq, count);
339 		spin_unlock(&dev->slock);
340 	}
341 
342 	/* other general errors */
343 	if (status & 0x1f0100) {
344 		dprintk( 0, "general errors: 0x%08x\n", status & 0x1f0100 );
345 		spin_lock(&dev->slock);
346 		cx8802_stop_dma(dev);
347 		spin_unlock(&dev->slock);
348 	}
349 }
350 
351 #define MAX_IRQ_LOOP 10
352 
353 static irqreturn_t cx8802_irq(int irq, void *dev_id)
354 {
355 	struct cx8802_dev *dev = dev_id;
356 	struct cx88_core *core = dev->core;
357 	u32 status;
358 	int loop, handled = 0;
359 
360 	for (loop = 0; loop < MAX_IRQ_LOOP; loop++) {
361 		status = cx_read(MO_PCI_INTSTAT) &
362 			(core->pci_irqmask | PCI_INT_TSINT);
363 		if (0 == status)
364 			goto out;
365 		dprintk( 1, "cx8802_irq\n" );
366 		dprintk( 1, "    loop: %d/%d\n", loop, MAX_IRQ_LOOP );
367 		dprintk( 1, "    status: %d\n", status );
368 		handled = 1;
369 		cx_write(MO_PCI_INTSTAT, status);
370 
371 		if (status & core->pci_irqmask)
372 			cx88_core_irq(core,status);
373 		if (status & PCI_INT_TSINT)
374 			cx8802_mpeg_irq(dev);
375 	}
376 	if (MAX_IRQ_LOOP == loop) {
377 		dprintk( 0, "clearing mask\n" );
378 		printk(KERN_WARNING "%s/0: irq loop -- clearing mask\n",
379 		       core->name);
380 		cx_write(MO_PCI_INTMSK,0);
381 	}
382 
383  out:
384 	return IRQ_RETVAL(handled);
385 }
386 
387 static int cx8802_init_common(struct cx8802_dev *dev)
388 {
389 	struct cx88_core *core = dev->core;
390 	int err;
391 
392 	/* pci init */
393 	if (pci_enable_device(dev->pci))
394 		return -EIO;
395 	pci_set_master(dev->pci);
396 	err = pci_set_dma_mask(dev->pci,DMA_BIT_MASK(32));
397 	if (err) {
398 		printk("%s/2: Oops: no 32bit PCI DMA ???\n",dev->core->name);
399 		return -EIO;
400 	}
401 
402 	dev->pci_rev = dev->pci->revision;
403 	pci_read_config_byte(dev->pci, PCI_LATENCY_TIMER,  &dev->pci_lat);
404 	printk(KERN_INFO "%s/2: found at %s, rev: %d, irq: %d, "
405 	       "latency: %d, mmio: 0x%llx\n", dev->core->name,
406 	       pci_name(dev->pci), dev->pci_rev, dev->pci->irq,
407 	       dev->pci_lat,(unsigned long long)pci_resource_start(dev->pci,0));
408 
409 	/* initialize driver struct */
410 	spin_lock_init(&dev->slock);
411 
412 	/* init dma queue */
413 	INIT_LIST_HEAD(&dev->mpegq.active);
414 
415 	/* get irq */
416 	err = request_irq(dev->pci->irq, cx8802_irq,
417 			  IRQF_SHARED, dev->core->name, dev);
418 	if (err < 0) {
419 		printk(KERN_ERR "%s: can't get IRQ %d\n",
420 		       dev->core->name, dev->pci->irq);
421 		return err;
422 	}
423 	cx_set(MO_PCI_INTMSK, core->pci_irqmask);
424 
425 	/* everything worked */
426 	pci_set_drvdata(dev->pci,dev);
427 	return 0;
428 }
429 
430 static void cx8802_fini_common(struct cx8802_dev *dev)
431 {
432 	dprintk( 2, "cx8802_fini_common\n" );
433 	cx8802_stop_dma(dev);
434 	pci_disable_device(dev->pci);
435 
436 	/* unregister stuff */
437 	free_irq(dev->pci->irq, dev);
438 }
439 
440 /* ----------------------------------------------------------- */
441 
442 static int cx8802_suspend_common(struct pci_dev *pci_dev, pm_message_t state)
443 {
444 	struct cx8802_dev *dev = pci_get_drvdata(pci_dev);
445 	struct cx88_core *core = dev->core;
446 	unsigned long flags;
447 
448 	/* stop mpeg dma */
449 	spin_lock_irqsave(&dev->slock, flags);
450 	if (!list_empty(&dev->mpegq.active)) {
451 		dprintk( 2, "suspend\n" );
452 		printk("%s: suspend mpeg\n", core->name);
453 		cx8802_stop_dma(dev);
454 	}
455 	spin_unlock_irqrestore(&dev->slock, flags);
456 
457 	/* FIXME -- shutdown device */
458 	cx88_shutdown(dev->core);
459 
460 	pci_save_state(pci_dev);
461 	if (0 != pci_set_power_state(pci_dev, pci_choose_state(pci_dev, state))) {
462 		pci_disable_device(pci_dev);
463 		dev->state.disabled = 1;
464 	}
465 	return 0;
466 }
467 
468 static int cx8802_resume_common(struct pci_dev *pci_dev)
469 {
470 	struct cx8802_dev *dev = pci_get_drvdata(pci_dev);
471 	struct cx88_core *core = dev->core;
472 	unsigned long flags;
473 	int err;
474 
475 	if (dev->state.disabled) {
476 		err=pci_enable_device(pci_dev);
477 		if (err) {
478 			printk(KERN_ERR "%s: can't enable device\n",
479 					       dev->core->name);
480 			return err;
481 		}
482 		dev->state.disabled = 0;
483 	}
484 	err=pci_set_power_state(pci_dev, PCI_D0);
485 	if (err) {
486 		printk(KERN_ERR "%s: can't enable device\n",
487 					       dev->core->name);
488 		pci_disable_device(pci_dev);
489 		dev->state.disabled = 1;
490 
491 		return err;
492 	}
493 	pci_restore_state(pci_dev);
494 
495 	/* FIXME: re-initialize hardware */
496 	cx88_reset(dev->core);
497 
498 	/* restart video+vbi capture */
499 	spin_lock_irqsave(&dev->slock, flags);
500 	if (!list_empty(&dev->mpegq.active)) {
501 		printk("%s: resume mpeg\n", core->name);
502 		cx8802_restart_queue(dev,&dev->mpegq);
503 	}
504 	spin_unlock_irqrestore(&dev->slock, flags);
505 
506 	return 0;
507 }
508 
509 struct cx8802_driver * cx8802_get_driver(struct cx8802_dev *dev, enum cx88_board_type btype)
510 {
511 	struct cx8802_driver *d;
512 
513 	list_for_each_entry(d, &dev->drvlist, drvlist)
514 		if (d->type_id == btype)
515 			return d;
516 
517 	return NULL;
518 }
519 
520 /* Driver asked for hardware access. */
521 static int cx8802_request_acquire(struct cx8802_driver *drv)
522 {
523 	struct cx88_core *core = drv->core;
524 	unsigned int	i;
525 
526 	/* Fail a request for hardware if the device is busy. */
527 	if (core->active_type_id != CX88_BOARD_NONE &&
528 	    core->active_type_id != drv->type_id)
529 		return -EBUSY;
530 
531 	if (drv->type_id == CX88_MPEG_DVB) {
532 		/* When switching to DVB, always set the input to the tuner */
533 		core->last_analog_input = core->input;
534 		core->input = 0;
535 		for (i = 0;
536 		     i < (sizeof(core->board.input) / sizeof(struct cx88_input));
537 		     i++) {
538 			if (core->board.input[i].type == CX88_VMUX_DVB) {
539 				core->input = i;
540 				break;
541 			}
542 		}
543 	}
544 
545 	if (drv->advise_acquire)
546 	{
547 		core->active_ref++;
548 		if (core->active_type_id == CX88_BOARD_NONE) {
549 			core->active_type_id = drv->type_id;
550 			drv->advise_acquire(drv);
551 		}
552 
553 		mpeg_dbg(1,"%s() Post acquire GPIO=%x\n", __func__, cx_read(MO_GP0_IO));
554 	}
555 
556 	return 0;
557 }
558 
559 /* Driver asked to release hardware. */
560 static int cx8802_request_release(struct cx8802_driver *drv)
561 {
562 	struct cx88_core *core = drv->core;
563 
564 	if (drv->advise_release && --core->active_ref == 0)
565 	{
566 		if (drv->type_id == CX88_MPEG_DVB) {
567 			/* If the DVB driver is releasing, reset the input
568 			   state to the last configured analog input */
569 			core->input = core->last_analog_input;
570 		}
571 
572 		drv->advise_release(drv);
573 		core->active_type_id = CX88_BOARD_NONE;
574 		mpeg_dbg(1,"%s() Post release GPIO=%x\n", __func__, cx_read(MO_GP0_IO));
575 	}
576 
577 	return 0;
578 }
579 
580 static int cx8802_check_driver(struct cx8802_driver *drv)
581 {
582 	if (drv == NULL)
583 		return -ENODEV;
584 
585 	if ((drv->type_id != CX88_MPEG_DVB) &&
586 		(drv->type_id != CX88_MPEG_BLACKBIRD))
587 		return -EINVAL;
588 
589 	if ((drv->hw_access != CX8802_DRVCTL_SHARED) &&
590 		(drv->hw_access != CX8802_DRVCTL_EXCLUSIVE))
591 		return -EINVAL;
592 
593 	if ((drv->probe == NULL) ||
594 		(drv->remove == NULL) ||
595 		(drv->advise_acquire == NULL) ||
596 		(drv->advise_release == NULL))
597 		return -EINVAL;
598 
599 	return 0;
600 }
601 
602 int cx8802_register_driver(struct cx8802_driver *drv)
603 {
604 	struct cx8802_dev *dev;
605 	struct cx8802_driver *driver;
606 	int err, i = 0;
607 
608 	printk(KERN_INFO
609 	       "cx88/2: registering cx8802 driver, type: %s access: %s\n",
610 	       drv->type_id == CX88_MPEG_DVB ? "dvb" : "blackbird",
611 	       drv->hw_access == CX8802_DRVCTL_SHARED ? "shared" : "exclusive");
612 
613 	if ((err = cx8802_check_driver(drv)) != 0) {
614 		printk(KERN_ERR "cx88/2: cx8802_driver is invalid\n");
615 		return err;
616 	}
617 
618 	mutex_lock(&cx8802_mutex);
619 
620 	list_for_each_entry(dev, &cx8802_devlist, devlist) {
621 		printk(KERN_INFO
622 		       "%s/2: subsystem: %04x:%04x, board: %s [card=%d]\n",
623 		       dev->core->name, dev->pci->subsystem_vendor,
624 		       dev->pci->subsystem_device, dev->core->board.name,
625 		       dev->core->boardnr);
626 
627 		/* Bring up a new struct for each driver instance */
628 		driver = kzalloc(sizeof(*drv),GFP_KERNEL);
629 		if (driver == NULL) {
630 			err = -ENOMEM;
631 			goto out;
632 		}
633 
634 		/* Snapshot of the driver registration data */
635 		drv->core = dev->core;
636 		drv->suspend = cx8802_suspend_common;
637 		drv->resume = cx8802_resume_common;
638 		drv->request_acquire = cx8802_request_acquire;
639 		drv->request_release = cx8802_request_release;
640 		memcpy(driver, drv, sizeof(*driver));
641 
642 		mutex_lock(&drv->core->lock);
643 		err = drv->probe(driver);
644 		if (err == 0) {
645 			i++;
646 			list_add_tail(&driver->drvlist, &dev->drvlist);
647 		} else {
648 			printk(KERN_ERR
649 			       "%s/2: cx8802 probe failed, err = %d\n",
650 			       dev->core->name, err);
651 		}
652 		mutex_unlock(&drv->core->lock);
653 	}
654 
655 	err = i ? 0 : -ENODEV;
656 out:
657 	mutex_unlock(&cx8802_mutex);
658 	return err;
659 }
660 
661 int cx8802_unregister_driver(struct cx8802_driver *drv)
662 {
663 	struct cx8802_dev *dev;
664 	struct cx8802_driver *d, *dtmp;
665 	int err = 0;
666 
667 	printk(KERN_INFO
668 	       "cx88/2: unregistering cx8802 driver, type: %s access: %s\n",
669 	       drv->type_id == CX88_MPEG_DVB ? "dvb" : "blackbird",
670 	       drv->hw_access == CX8802_DRVCTL_SHARED ? "shared" : "exclusive");
671 
672 	mutex_lock(&cx8802_mutex);
673 
674 	list_for_each_entry(dev, &cx8802_devlist, devlist) {
675 		printk(KERN_INFO
676 		       "%s/2: subsystem: %04x:%04x, board: %s [card=%d]\n",
677 		       dev->core->name, dev->pci->subsystem_vendor,
678 		       dev->pci->subsystem_device, dev->core->board.name,
679 		       dev->core->boardnr);
680 
681 		mutex_lock(&dev->core->lock);
682 
683 		list_for_each_entry_safe(d, dtmp, &dev->drvlist, drvlist) {
684 			/* only unregister the correct driver type */
685 			if (d->type_id != drv->type_id)
686 				continue;
687 
688 			err = d->remove(d);
689 			if (err == 0) {
690 				list_del(&d->drvlist);
691 				kfree(d);
692 			} else
693 				printk(KERN_ERR "%s/2: cx8802 driver remove "
694 				       "failed (%d)\n", dev->core->name, err);
695 		}
696 
697 		mutex_unlock(&dev->core->lock);
698 	}
699 
700 	mutex_unlock(&cx8802_mutex);
701 
702 	return err;
703 }
704 
705 /* ----------------------------------------------------------- */
706 static int cx8802_probe(struct pci_dev *pci_dev,
707 			const struct pci_device_id *pci_id)
708 {
709 	struct cx8802_dev *dev;
710 	struct cx88_core  *core;
711 	int err;
712 
713 	/* general setup */
714 	core = cx88_core_get(pci_dev);
715 	if (NULL == core)
716 		return -EINVAL;
717 
718 	printk("%s/2: cx2388x 8802 Driver Manager\n", core->name);
719 
720 	err = -ENODEV;
721 	if (!core->board.mpeg)
722 		goto fail_core;
723 
724 	err = -ENOMEM;
725 	dev = kzalloc(sizeof(*dev),GFP_KERNEL);
726 	if (NULL == dev)
727 		goto fail_core;
728 	dev->pci = pci_dev;
729 	dev->core = core;
730 
731 	/* Maintain a reference so cx88-video can query the 8802 device. */
732 	core->dvbdev = dev;
733 
734 	err = cx8802_init_common(dev);
735 	if (err != 0)
736 		goto fail_dev;
737 
738 	INIT_LIST_HEAD(&dev->drvlist);
739 	mutex_lock(&cx8802_mutex);
740 	list_add_tail(&dev->devlist,&cx8802_devlist);
741 	mutex_unlock(&cx8802_mutex);
742 
743 	/* now autoload cx88-dvb or cx88-blackbird */
744 	request_modules(dev);
745 	return 0;
746 
747  fail_dev:
748 	kfree(dev);
749  fail_core:
750 	core->dvbdev = NULL;
751 	cx88_core_put(core,pci_dev);
752 	return err;
753 }
754 
755 static void cx8802_remove(struct pci_dev *pci_dev)
756 {
757 	struct cx8802_dev *dev;
758 
759 	dev = pci_get_drvdata(pci_dev);
760 
761 	dprintk( 1, "%s\n", __func__);
762 
763 	flush_request_modules(dev);
764 
765 	mutex_lock(&dev->core->lock);
766 
767 	if (!list_empty(&dev->drvlist)) {
768 		struct cx8802_driver *drv, *tmp;
769 		int err;
770 
771 		printk(KERN_WARNING "%s/2: Trying to remove cx8802 driver "
772 		       "while cx8802 sub-drivers still loaded?!\n",
773 		       dev->core->name);
774 
775 		list_for_each_entry_safe(drv, tmp, &dev->drvlist, drvlist) {
776 			err = drv->remove(drv);
777 			if (err == 0) {
778 				list_del(&drv->drvlist);
779 			} else
780 				printk(KERN_ERR "%s/2: cx8802 driver remove "
781 				       "failed (%d)\n", dev->core->name, err);
782 			kfree(drv);
783 		}
784 	}
785 
786 	mutex_unlock(&dev->core->lock);
787 
788 	/* Destroy any 8802 reference. */
789 	dev->core->dvbdev = NULL;
790 
791 	/* common */
792 	cx8802_fini_common(dev);
793 	cx88_core_put(dev->core,dev->pci);
794 	kfree(dev);
795 }
796 
797 static const struct pci_device_id cx8802_pci_tbl[] = {
798 	{
799 		.vendor       = 0x14f1,
800 		.device       = 0x8802,
801 		.subvendor    = PCI_ANY_ID,
802 		.subdevice    = PCI_ANY_ID,
803 	},{
804 		/* --- end of list --- */
805 	}
806 };
807 MODULE_DEVICE_TABLE(pci, cx8802_pci_tbl);
808 
809 static struct pci_driver cx8802_pci_driver = {
810 	.name     = "cx88-mpeg driver manager",
811 	.id_table = cx8802_pci_tbl,
812 	.probe    = cx8802_probe,
813 	.remove   = cx8802_remove,
814 };
815 
816 module_pci_driver(cx8802_pci_driver);
817 
818 EXPORT_SYMBOL(cx8802_buf_prepare);
819 EXPORT_SYMBOL(cx8802_buf_queue);
820 EXPORT_SYMBOL(cx8802_cancel_buffers);
821 EXPORT_SYMBOL(cx8802_start_dma);
822 
823 EXPORT_SYMBOL(cx8802_register_driver);
824 EXPORT_SYMBOL(cx8802_unregister_driver);
825 EXPORT_SYMBOL(cx8802_get_driver);
826