V4L/DVB (8496): saa7134: Copy tuner data earlier in init to avoid overwriting manual...
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / media / video / saa7134 / saa7134-core.c
bloba404368308aa1c9213054607e6ad0e14a6e7b94e
1 /*
3 * device driver for philips saa7134 based TV cards
4 * driver core
6 * (c) 2001-03 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include <linux/init.h>
24 #include <linux/list.h>
25 #include <linux/module.h>
26 #include <linux/kernel.h>
27 #include <linux/slab.h>
28 #include <linux/kmod.h>
29 #include <linux/sound.h>
30 #include <linux/interrupt.h>
31 #include <linux/delay.h>
32 #include <linux/mutex.h>
33 #include <linux/dma-mapping.h>
34 #include <linux/pm.h>
36 #include "saa7134-reg.h"
37 #include "saa7134.h"
39 MODULE_DESCRIPTION("v4l2 driver module for saa7130/34 based TV cards");
40 MODULE_AUTHOR("Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]");
41 MODULE_LICENSE("GPL");
43 /* ------------------------------------------------------------------ */
45 static unsigned int irq_debug;
46 module_param(irq_debug, int, 0644);
47 MODULE_PARM_DESC(irq_debug,"enable debug messages [IRQ handler]");
49 static unsigned int core_debug;
50 module_param(core_debug, int, 0644);
51 MODULE_PARM_DESC(core_debug,"enable debug messages [core]");
53 static unsigned int gpio_tracking;
54 module_param(gpio_tracking, int, 0644);
55 MODULE_PARM_DESC(gpio_tracking,"enable debug messages [gpio]");
57 static unsigned int alsa;
58 module_param(alsa, int, 0644);
59 MODULE_PARM_DESC(alsa,"enable ALSA DMA sound [dmasound]");
61 static unsigned int oss;
62 module_param(oss, int, 0644);
63 MODULE_PARM_DESC(oss,"enable OSS DMA sound [dmasound]");
65 static unsigned int latency = UNSET;
66 module_param(latency, int, 0444);
67 MODULE_PARM_DESC(latency,"pci latency timer");
69 int saa7134_no_overlay=-1;
70 module_param_named(no_overlay, saa7134_no_overlay, int, 0444);
71 MODULE_PARM_DESC(no_overlay,"allow override overlay default (0 disables, 1 enables)"
72 " [some VIA/SIS chipsets are known to have problem with overlay]");
74 static unsigned int video_nr[] = {[0 ... (SAA7134_MAXBOARDS - 1)] = UNSET };
75 static unsigned int vbi_nr[] = {[0 ... (SAA7134_MAXBOARDS - 1)] = UNSET };
76 static unsigned int radio_nr[] = {[0 ... (SAA7134_MAXBOARDS - 1)] = UNSET };
77 static unsigned int tuner[] = {[0 ... (SAA7134_MAXBOARDS - 1)] = UNSET };
78 static unsigned int card[] = {[0 ... (SAA7134_MAXBOARDS - 1)] = UNSET };
81 module_param_array(video_nr, int, NULL, 0444);
82 module_param_array(vbi_nr, int, NULL, 0444);
83 module_param_array(radio_nr, int, NULL, 0444);
84 module_param_array(tuner, int, NULL, 0444);
85 module_param_array(card, int, NULL, 0444);
87 MODULE_PARM_DESC(video_nr, "video device number");
88 MODULE_PARM_DESC(vbi_nr, "vbi device number");
89 MODULE_PARM_DESC(radio_nr, "radio device number");
90 MODULE_PARM_DESC(tuner, "tuner type");
91 MODULE_PARM_DESC(card, "card type");
93 static DEFINE_MUTEX(devlist_lock);
94 LIST_HEAD(saa7134_devlist);
95 static LIST_HEAD(mops_list);
96 static unsigned int saa7134_devcount;
98 int (*saa7134_dmasound_init)(struct saa7134_dev *dev);
99 int (*saa7134_dmasound_exit)(struct saa7134_dev *dev);
101 #define dprintk(fmt, arg...) if (core_debug) \
102 printk(KERN_DEBUG "%s/core: " fmt, dev->name , ## arg)
104 void saa7134_track_gpio(struct saa7134_dev *dev, char *msg)
106 unsigned long mode,status;
108 if (!gpio_tracking)
109 return;
110 /* rising SAA7134_GPIO_GPRESCAN reads the status */
111 saa_andorb(SAA7134_GPIO_GPMODE3,SAA7134_GPIO_GPRESCAN,0);
112 saa_andorb(SAA7134_GPIO_GPMODE3,SAA7134_GPIO_GPRESCAN,SAA7134_GPIO_GPRESCAN);
113 mode = saa_readl(SAA7134_GPIO_GPMODE0 >> 2) & 0xfffffff;
114 status = saa_readl(SAA7134_GPIO_GPSTATUS0 >> 2) & 0xfffffff;
115 printk(KERN_DEBUG
116 "%s: gpio: mode=0x%07lx in=0x%07lx out=0x%07lx [%s]\n",
117 dev->name, mode, (~mode) & status, mode & status, msg);
120 void saa7134_set_gpio(struct saa7134_dev *dev, int bit_no, int value)
122 u32 index, bitval;
124 index = 1 << bit_no;
125 switch (value) {
126 case 0: /* static value */
127 case 1: dprintk("setting GPIO%d to static %d\n", bit_no, value);
128 /* turn sync mode off if necessary */
129 if (index & 0x00c00000)
130 saa_andorb(SAA7134_VIDEO_PORT_CTRL6, 0x0f, 0x00);
131 if (value)
132 bitval = index;
133 else
134 bitval = 0;
135 saa_andorl(SAA7134_GPIO_GPMODE0 >> 2, index, index);
136 saa_andorl(SAA7134_GPIO_GPSTATUS0 >> 2, index, bitval);
137 break;
138 case 3: /* tristate */
139 dprintk("setting GPIO%d to tristate\n", bit_no);
140 saa_andorl(SAA7134_GPIO_GPMODE0 >> 2, index, 0);
141 break;
145 /* ------------------------------------------------------------------ */
148 /* ----------------------------------------------------------- */
149 /* delayed request_module */
151 #if defined(CONFIG_MODULES) && defined(MODULE)
153 static void request_module_async(struct work_struct *work){
154 struct saa7134_dev* dev = container_of(work, struct saa7134_dev, request_module_wk);
155 if (card_is_empress(dev))
156 request_module("saa7134-empress");
157 if (card_is_dvb(dev))
158 request_module("saa7134-dvb");
159 if (alsa)
160 request_module("saa7134-alsa");
161 if (oss)
162 request_module("saa7134-oss");
165 static void request_submodules(struct saa7134_dev *dev)
167 INIT_WORK(&dev->request_module_wk, request_module_async);
168 schedule_work(&dev->request_module_wk);
171 #else
172 #define request_submodules(dev)
173 #endif /* CONFIG_MODULES */
175 /* ------------------------------------------------------------------ */
177 /* nr of (saa7134-)pages for the given buffer size */
178 static int saa7134_buffer_pages(int size)
180 size = PAGE_ALIGN(size);
181 size += PAGE_SIZE; /* for non-page-aligned buffers */
182 size /= 4096;
183 return size;
186 /* calc max # of buffers from size (must not exceed the 4MB virtual
187 * address space per DMA channel) */
188 int saa7134_buffer_count(unsigned int size, unsigned int count)
190 unsigned int maxcount;
192 maxcount = 1024 / saa7134_buffer_pages(size);
193 if (count > maxcount)
194 count = maxcount;
195 return count;
198 int saa7134_buffer_startpage(struct saa7134_buf *buf)
200 return saa7134_buffer_pages(buf->vb.bsize) * buf->vb.i;
203 unsigned long saa7134_buffer_base(struct saa7134_buf *buf)
205 unsigned long base;
206 struct videobuf_dmabuf *dma=videobuf_to_dma(&buf->vb);
208 base = saa7134_buffer_startpage(buf) * 4096;
209 base += dma->sglist[0].offset;
210 return base;
213 /* ------------------------------------------------------------------ */
215 int saa7134_pgtable_alloc(struct pci_dev *pci, struct saa7134_pgtable *pt)
217 __le32 *cpu;
218 dma_addr_t dma_addr;
220 cpu = pci_alloc_consistent(pci, SAA7134_PGTABLE_SIZE, &dma_addr);
221 if (NULL == cpu)
222 return -ENOMEM;
223 pt->size = SAA7134_PGTABLE_SIZE;
224 pt->cpu = cpu;
225 pt->dma = dma_addr;
226 return 0;
229 int saa7134_pgtable_build(struct pci_dev *pci, struct saa7134_pgtable *pt,
230 struct scatterlist *list, unsigned int length,
231 unsigned int startpage)
233 __le32 *ptr;
234 unsigned int i,p;
236 BUG_ON(NULL == pt || NULL == pt->cpu);
238 ptr = pt->cpu + startpage;
239 for (i = 0; i < length; i++, list++)
240 for (p = 0; p * 4096 < list->length; p++, ptr++)
241 *ptr = cpu_to_le32(sg_dma_address(list) - list->offset);
242 return 0;
245 void saa7134_pgtable_free(struct pci_dev *pci, struct saa7134_pgtable *pt)
247 if (NULL == pt->cpu)
248 return;
249 pci_free_consistent(pci, pt->size, pt->cpu, pt->dma);
250 pt->cpu = NULL;
253 /* ------------------------------------------------------------------ */
255 void saa7134_dma_free(struct videobuf_queue *q,struct saa7134_buf *buf)
257 struct videobuf_dmabuf *dma=videobuf_to_dma(&buf->vb);
258 BUG_ON(in_interrupt());
260 videobuf_waiton(&buf->vb,0,0);
261 videobuf_dma_unmap(q, dma);
262 videobuf_dma_free(dma);
263 buf->vb.state = VIDEOBUF_NEEDS_INIT;
266 /* ------------------------------------------------------------------ */
268 int saa7134_buffer_queue(struct saa7134_dev *dev,
269 struct saa7134_dmaqueue *q,
270 struct saa7134_buf *buf)
272 struct saa7134_buf *next = NULL;
274 assert_spin_locked(&dev->slock);
275 dprintk("buffer_queue %p\n",buf);
276 if (NULL == q->curr) {
277 if (!q->need_two) {
278 q->curr = buf;
279 buf->activate(dev,buf,NULL);
280 } else if (list_empty(&q->queue)) {
281 list_add_tail(&buf->vb.queue,&q->queue);
282 buf->vb.state = VIDEOBUF_QUEUED;
283 } else {
284 next = list_entry(q->queue.next,struct saa7134_buf,
285 vb.queue);
286 q->curr = buf;
287 buf->activate(dev,buf,next);
289 } else {
290 list_add_tail(&buf->vb.queue,&q->queue);
291 buf->vb.state = VIDEOBUF_QUEUED;
293 return 0;
296 void saa7134_buffer_finish(struct saa7134_dev *dev,
297 struct saa7134_dmaqueue *q,
298 unsigned int state)
300 assert_spin_locked(&dev->slock);
301 dprintk("buffer_finish %p\n",q->curr);
303 /* finish current buffer */
304 q->curr->vb.state = state;
305 do_gettimeofday(&q->curr->vb.ts);
306 wake_up(&q->curr->vb.done);
307 q->curr = NULL;
310 void saa7134_buffer_next(struct saa7134_dev *dev,
311 struct saa7134_dmaqueue *q)
313 struct saa7134_buf *buf,*next = NULL;
315 assert_spin_locked(&dev->slock);
316 BUG_ON(NULL != q->curr);
318 if (!list_empty(&q->queue)) {
319 /* activate next one from queue */
320 buf = list_entry(q->queue.next,struct saa7134_buf,vb.queue);
321 dprintk("buffer_next %p [prev=%p/next=%p]\n",
322 buf,q->queue.prev,q->queue.next);
323 list_del(&buf->vb.queue);
324 if (!list_empty(&q->queue))
325 next = list_entry(q->queue.next,struct saa7134_buf,
326 vb.queue);
327 q->curr = buf;
328 buf->activate(dev,buf,next);
329 dprintk("buffer_next #2 prev=%p/next=%p\n",
330 q->queue.prev,q->queue.next);
331 } else {
332 /* nothing to do -- just stop DMA */
333 dprintk("buffer_next %p\n",NULL);
334 saa7134_set_dmabits(dev);
335 del_timer(&q->timeout);
339 void saa7134_buffer_timeout(unsigned long data)
341 struct saa7134_dmaqueue *q = (struct saa7134_dmaqueue*)data;
342 struct saa7134_dev *dev = q->dev;
343 unsigned long flags;
345 spin_lock_irqsave(&dev->slock,flags);
347 /* try to reset the hardware (SWRST) */
348 saa_writeb(SAA7134_REGION_ENABLE, 0x00);
349 saa_writeb(SAA7134_REGION_ENABLE, 0x80);
350 saa_writeb(SAA7134_REGION_ENABLE, 0x00);
352 /* flag current buffer as failed,
353 try to start over with the next one. */
354 if (q->curr) {
355 dprintk("timeout on %p\n",q->curr);
356 saa7134_buffer_finish(dev,q,VIDEOBUF_ERROR);
358 saa7134_buffer_next(dev,q);
359 spin_unlock_irqrestore(&dev->slock,flags);
362 /* resends a current buffer in queue after resume */
364 static int saa7134_buffer_requeue(struct saa7134_dev *dev,
365 struct saa7134_dmaqueue *q)
367 struct saa7134_buf *buf, *next;
369 assert_spin_locked(&dev->slock);
371 buf = q->curr;
372 next = buf;
373 dprintk("buffer_requeue\n");
375 if (!buf)
376 return 0;
378 dprintk("buffer_requeue : resending active buffers \n");
380 if (!list_empty(&q->queue))
381 next = list_entry(q->queue.next, struct saa7134_buf,
382 vb.queue);
383 buf->activate(dev, buf, next);
385 return 0;
388 /* ------------------------------------------------------------------ */
390 int saa7134_set_dmabits(struct saa7134_dev *dev)
392 u32 split, task=0, ctrl=0, irq=0;
393 enum v4l2_field cap = V4L2_FIELD_ANY;
394 enum v4l2_field ov = V4L2_FIELD_ANY;
396 assert_spin_locked(&dev->slock);
398 if (dev->insuspend)
399 return 0;
401 /* video capture -- dma 0 + video task A */
402 if (dev->video_q.curr) {
403 task |= 0x01;
404 ctrl |= SAA7134_MAIN_CTRL_TE0;
405 irq |= SAA7134_IRQ1_INTE_RA0_1 |
406 SAA7134_IRQ1_INTE_RA0_0;
407 cap = dev->video_q.curr->vb.field;
410 /* video capture -- dma 1+2 (planar modes) */
411 if (dev->video_q.curr &&
412 dev->video_q.curr->fmt->planar) {
413 ctrl |= SAA7134_MAIN_CTRL_TE4 |
414 SAA7134_MAIN_CTRL_TE5;
417 /* screen overlay -- dma 0 + video task B */
418 if (dev->ovenable) {
419 task |= 0x10;
420 ctrl |= SAA7134_MAIN_CTRL_TE1;
421 ov = dev->ovfield;
424 /* vbi capture -- dma 0 + vbi task A+B */
425 if (dev->vbi_q.curr) {
426 task |= 0x22;
427 ctrl |= SAA7134_MAIN_CTRL_TE2 |
428 SAA7134_MAIN_CTRL_TE3;
429 irq |= SAA7134_IRQ1_INTE_RA0_7 |
430 SAA7134_IRQ1_INTE_RA0_6 |
431 SAA7134_IRQ1_INTE_RA0_5 |
432 SAA7134_IRQ1_INTE_RA0_4;
435 /* audio capture -- dma 3 */
436 if (dev->dmasound.dma_running) {
437 ctrl |= SAA7134_MAIN_CTRL_TE6;
438 irq |= SAA7134_IRQ1_INTE_RA3_1 |
439 SAA7134_IRQ1_INTE_RA3_0;
442 /* TS capture -- dma 5 */
443 if (dev->ts_q.curr) {
444 ctrl |= SAA7134_MAIN_CTRL_TE5;
445 irq |= SAA7134_IRQ1_INTE_RA2_3 |
446 SAA7134_IRQ1_INTE_RA2_2 |
447 SAA7134_IRQ1_INTE_RA2_1 |
448 SAA7134_IRQ1_INTE_RA2_0;
451 /* set task conditions + field handling */
452 if (V4L2_FIELD_HAS_BOTH(cap) || V4L2_FIELD_HAS_BOTH(ov) || cap == ov) {
453 /* default config -- use full frames */
454 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_A), 0x0d);
455 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_B), 0x0d);
456 saa_writeb(SAA7134_FIELD_HANDLING(TASK_A), 0x02);
457 saa_writeb(SAA7134_FIELD_HANDLING(TASK_B), 0x02);
458 split = 0;
459 } else {
460 /* split fields between tasks */
461 if (V4L2_FIELD_TOP == cap) {
462 /* odd A, even B, repeat */
463 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_A), 0x0d);
464 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_B), 0x0e);
465 } else {
466 /* odd B, even A, repeat */
467 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_A), 0x0e);
468 saa_writeb(SAA7134_TASK_CONDITIONS(TASK_B), 0x0d);
470 saa_writeb(SAA7134_FIELD_HANDLING(TASK_A), 0x01);
471 saa_writeb(SAA7134_FIELD_HANDLING(TASK_B), 0x01);
472 split = 1;
475 /* irqs */
476 saa_writeb(SAA7134_REGION_ENABLE, task);
477 saa_writel(SAA7134_IRQ1, irq);
478 saa_andorl(SAA7134_MAIN_CTRL,
479 SAA7134_MAIN_CTRL_TE0 |
480 SAA7134_MAIN_CTRL_TE1 |
481 SAA7134_MAIN_CTRL_TE2 |
482 SAA7134_MAIN_CTRL_TE3 |
483 SAA7134_MAIN_CTRL_TE4 |
484 SAA7134_MAIN_CTRL_TE5 |
485 SAA7134_MAIN_CTRL_TE6,
486 ctrl);
487 dprintk("dmabits: task=0x%02x ctrl=0x%02x irq=0x%x split=%s\n",
488 task, ctrl, irq, split ? "no" : "yes");
490 return 0;
493 /* ------------------------------------------------------------------ */
494 /* IRQ handler + helpers */
496 static char *irqbits[] = {
497 "DONE_RA0", "DONE_RA1", "DONE_RA2", "DONE_RA3",
498 "AR", "PE", "PWR_ON", "RDCAP", "INTL", "FIDT", "MMC",
499 "TRIG_ERR", "CONF_ERR", "LOAD_ERR",
500 "GPIO16?", "GPIO18", "GPIO22", "GPIO23"
502 #define IRQBITS ARRAY_SIZE(irqbits)
504 static void print_irqstatus(struct saa7134_dev *dev, int loop,
505 unsigned long report, unsigned long status)
507 unsigned int i;
509 printk(KERN_DEBUG "%s/irq[%d,%ld]: r=0x%lx s=0x%02lx",
510 dev->name,loop,jiffies,report,status);
511 for (i = 0; i < IRQBITS; i++) {
512 if (!(report & (1 << i)))
513 continue;
514 printk(" %s",irqbits[i]);
516 if (report & SAA7134_IRQ_REPORT_DONE_RA0) {
517 printk(" | RA0=%s,%s,%s,%ld",
518 (status & 0x40) ? "vbi" : "video",
519 (status & 0x20) ? "b" : "a",
520 (status & 0x10) ? "odd" : "even",
521 (status & 0x0f));
523 printk("\n");
526 static irqreturn_t saa7134_irq(int irq, void *dev_id)
528 struct saa7134_dev *dev = (struct saa7134_dev*) dev_id;
529 unsigned long report,status;
530 int loop, handled = 0;
532 if (dev->insuspend)
533 goto out;
535 for (loop = 0; loop < 10; loop++) {
536 report = saa_readl(SAA7134_IRQ_REPORT);
537 status = saa_readl(SAA7134_IRQ_STATUS);
539 /* If dmasound support is active and we get a sound report,
540 * mask out the report and let the saa7134-alsa module deal
541 * with it */
542 if ((report & SAA7134_IRQ_REPORT_DONE_RA3) &&
543 (dev->dmasound.priv_data != NULL) )
545 if (irq_debug > 1)
546 printk(KERN_DEBUG "%s/irq: preserving DMA sound interrupt\n",
547 dev->name);
548 report &= ~SAA7134_IRQ_REPORT_DONE_RA3;
551 if (0 == report) {
552 if (irq_debug > 1)
553 printk(KERN_DEBUG "%s/irq: no (more) work\n",
554 dev->name);
555 goto out;
558 handled = 1;
559 saa_writel(SAA7134_IRQ_REPORT,report);
560 if (irq_debug)
561 print_irqstatus(dev,loop,report,status);
564 if ((report & SAA7134_IRQ_REPORT_RDCAP) ||
565 (report & SAA7134_IRQ_REPORT_INTL))
566 saa7134_irq_video_signalchange(dev);
569 if ((report & SAA7134_IRQ_REPORT_DONE_RA0) &&
570 (status & 0x60) == 0)
571 saa7134_irq_video_done(dev,status);
573 if ((report & SAA7134_IRQ_REPORT_DONE_RA0) &&
574 (status & 0x40) == 0x40)
575 saa7134_irq_vbi_done(dev,status);
577 if ((report & SAA7134_IRQ_REPORT_DONE_RA2) &&
578 card_has_mpeg(dev))
579 saa7134_irq_ts_done(dev,status);
581 if (report & SAA7134_IRQ_REPORT_GPIO16) {
582 switch (dev->has_remote) {
583 case SAA7134_REMOTE_GPIO:
584 if (!dev->remote)
585 break;
586 if (dev->remote->mask_keydown & 0x10000) {
587 saa7134_input_irq(dev);
589 break;
591 case SAA7134_REMOTE_I2C:
592 break; /* FIXME: invoke I2C get_key() */
594 default: /* GPIO16 not used by IR remote */
595 break;
599 if (report & SAA7134_IRQ_REPORT_GPIO18) {
600 switch (dev->has_remote) {
601 case SAA7134_REMOTE_GPIO:
602 if (!dev->remote)
603 break;
604 if ((dev->remote->mask_keydown & 0x40000) ||
605 (dev->remote->mask_keyup & 0x40000)) {
606 saa7134_input_irq(dev);
608 break;
610 case SAA7134_REMOTE_I2C:
611 break; /* FIXME: invoke I2C get_key() */
613 default: /* GPIO18 not used by IR remote */
614 break;
619 if (10 == loop) {
620 print_irqstatus(dev,loop,report,status);
621 if (report & SAA7134_IRQ_REPORT_PE) {
622 /* disable all parity error */
623 printk(KERN_WARNING "%s/irq: looping -- "
624 "clearing PE (parity error!) enable bit\n",dev->name);
625 saa_clearl(SAA7134_IRQ2,SAA7134_IRQ2_INTE_PE);
626 } else if (report & SAA7134_IRQ_REPORT_GPIO16) {
627 /* disable gpio16 IRQ */
628 printk(KERN_WARNING "%s/irq: looping -- "
629 "clearing GPIO16 enable bit\n",dev->name);
630 saa_clearl(SAA7134_IRQ2, SAA7134_IRQ2_INTE_GPIO16);
631 } else if (report & SAA7134_IRQ_REPORT_GPIO18) {
632 /* disable gpio18 IRQs */
633 printk(KERN_WARNING "%s/irq: looping -- "
634 "clearing GPIO18 enable bit\n",dev->name);
635 saa_clearl(SAA7134_IRQ2, SAA7134_IRQ2_INTE_GPIO18);
636 } else {
637 /* disable all irqs */
638 printk(KERN_WARNING "%s/irq: looping -- "
639 "clearing all enable bits\n",dev->name);
640 saa_writel(SAA7134_IRQ1,0);
641 saa_writel(SAA7134_IRQ2,0);
645 out:
646 return IRQ_RETVAL(handled);
649 /* ------------------------------------------------------------------ */
651 /* early init (no i2c, no irq) */
653 static int saa7134_hw_enable1(struct saa7134_dev *dev)
655 /* RAM FIFO config */
656 saa_writel(SAA7134_FIFO_SIZE, 0x08070503);
657 saa_writel(SAA7134_THRESHOULD, 0x02020202);
659 /* enable audio + video processing */
660 saa_writel(SAA7134_MAIN_CTRL,
661 SAA7134_MAIN_CTRL_VPLLE |
662 SAA7134_MAIN_CTRL_APLLE |
663 SAA7134_MAIN_CTRL_EXOSC |
664 SAA7134_MAIN_CTRL_EVFE1 |
665 SAA7134_MAIN_CTRL_EVFE2 |
666 SAA7134_MAIN_CTRL_ESFE |
667 SAA7134_MAIN_CTRL_EBDAC);
670 * Initialize OSS _after_ enabling audio clock PLL and audio processing.
671 * OSS initialization writes to registers via the audio DSP; these
672 * writes will fail unless the audio clock has been started. At worst,
673 * audio will not work.
676 /* enable peripheral devices */
677 saa_writeb(SAA7134_SPECIAL_MODE, 0x01);
679 /* set vertical line numbering start (vbi needs this) */
680 saa_writeb(SAA7134_SOURCE_TIMING2, 0x20);
682 return 0;
685 static int saa7134_hwinit1(struct saa7134_dev *dev)
687 dprintk("hwinit1\n");
689 saa_writel(SAA7134_IRQ1, 0);
690 saa_writel(SAA7134_IRQ2, 0);
691 mutex_init(&dev->lock);
692 spin_lock_init(&dev->slock);
694 saa7134_track_gpio(dev,"pre-init");
695 saa7134_video_init1(dev);
696 saa7134_vbi_init1(dev);
697 if (card_has_mpeg(dev))
698 saa7134_ts_init1(dev);
699 saa7134_input_init1(dev);
701 saa7134_hw_enable1(dev);
703 return 0;
706 /* late init (with i2c + irq) */
707 static int saa7134_hw_enable2(struct saa7134_dev *dev)
710 unsigned int irq2_mask;
712 /* enable IRQ's */
713 irq2_mask =
714 SAA7134_IRQ2_INTE_DEC3 |
715 SAA7134_IRQ2_INTE_DEC2 |
716 SAA7134_IRQ2_INTE_DEC1 |
717 SAA7134_IRQ2_INTE_DEC0 |
718 SAA7134_IRQ2_INTE_PE |
719 SAA7134_IRQ2_INTE_AR;
721 if (dev->has_remote == SAA7134_REMOTE_GPIO && dev->remote) {
722 if (dev->remote->mask_keydown & 0x10000)
723 irq2_mask |= SAA7134_IRQ2_INTE_GPIO16;
724 else if (dev->remote->mask_keydown & 0x40000)
725 irq2_mask |= SAA7134_IRQ2_INTE_GPIO18;
726 else if (dev->remote->mask_keyup & 0x40000)
727 irq2_mask |= SAA7134_IRQ2_INTE_GPIO18A;
730 saa_writel(SAA7134_IRQ1, 0);
731 saa_writel(SAA7134_IRQ2, irq2_mask);
733 return 0;
736 static int saa7134_hwinit2(struct saa7134_dev *dev)
739 dprintk("hwinit2\n");
741 saa7134_video_init2(dev);
742 saa7134_tvaudio_init2(dev);
744 saa7134_hw_enable2(dev);
746 return 0;
750 /* shutdown */
751 static int saa7134_hwfini(struct saa7134_dev *dev)
753 dprintk("hwfini\n");
755 if (card_has_mpeg(dev))
756 saa7134_ts_fini(dev);
757 saa7134_input_fini(dev);
758 saa7134_vbi_fini(dev);
759 saa7134_tvaudio_fini(dev);
760 return 0;
763 static void __devinit must_configure_manually(void)
765 unsigned int i,p;
767 printk(KERN_WARNING
768 "saa7134: <rant>\n"
769 "saa7134: Congratulations! Your TV card vendor saved a few\n"
770 "saa7134: cents for a eeprom, thus your pci board has no\n"
771 "saa7134: subsystem ID and I can't identify it automatically\n"
772 "saa7134: </rant>\n"
773 "saa7134: I feel better now. Ok, here are the good news:\n"
774 "saa7134: You can use the card=<nr> insmod option to specify\n"
775 "saa7134: which board do you have. The list:\n");
776 for (i = 0; i < saa7134_bcount; i++) {
777 printk(KERN_WARNING "saa7134: card=%d -> %-40.40s",
778 i,saa7134_boards[i].name);
779 for (p = 0; saa7134_pci_tbl[p].driver_data; p++) {
780 if (saa7134_pci_tbl[p].driver_data != i)
781 continue;
782 printk(" %04x:%04x",
783 saa7134_pci_tbl[p].subvendor,
784 saa7134_pci_tbl[p].subdevice);
786 printk("\n");
790 static struct video_device *vdev_init(struct saa7134_dev *dev,
791 struct video_device *template,
792 char *type)
794 struct video_device *vfd;
796 vfd = video_device_alloc();
797 if (NULL == vfd)
798 return NULL;
799 *vfd = *template;
800 vfd->minor = -1;
801 vfd->parent = &dev->pci->dev;
802 vfd->release = video_device_release;
803 vfd->debug = video_debug;
804 snprintf(vfd->name, sizeof(vfd->name), "%s %s (%s)",
805 dev->name, type, saa7134_boards[dev->board].name);
806 return vfd;
809 static void saa7134_unregister_video(struct saa7134_dev *dev)
811 if (dev->video_dev) {
812 if (-1 != dev->video_dev->minor)
813 video_unregister_device(dev->video_dev);
814 else
815 video_device_release(dev->video_dev);
816 dev->video_dev = NULL;
818 if (dev->vbi_dev) {
819 if (-1 != dev->vbi_dev->minor)
820 video_unregister_device(dev->vbi_dev);
821 else
822 video_device_release(dev->vbi_dev);
823 dev->vbi_dev = NULL;
825 if (dev->radio_dev) {
826 if (-1 != dev->radio_dev->minor)
827 video_unregister_device(dev->radio_dev);
828 else
829 video_device_release(dev->radio_dev);
830 dev->radio_dev = NULL;
834 static void mpeg_ops_attach(struct saa7134_mpeg_ops *ops,
835 struct saa7134_dev *dev)
837 int err;
839 if (NULL != dev->mops)
840 return;
841 if (saa7134_boards[dev->board].mpeg != ops->type)
842 return;
843 err = ops->init(dev);
844 if (0 != err)
845 return;
846 dev->mops = ops;
849 static void mpeg_ops_detach(struct saa7134_mpeg_ops *ops,
850 struct saa7134_dev *dev)
852 if (NULL == dev->mops)
853 return;
854 if (dev->mops != ops)
855 return;
856 dev->mops->fini(dev);
857 dev->mops = NULL;
860 static int __devinit saa7134_initdev(struct pci_dev *pci_dev,
861 const struct pci_device_id *pci_id)
863 struct saa7134_dev *dev;
864 struct saa7134_mpeg_ops *mops;
865 int err;
867 if (saa7134_devcount == SAA7134_MAXBOARDS)
868 return -ENOMEM;
870 dev = kzalloc(sizeof(*dev),GFP_KERNEL);
871 if (NULL == dev)
872 return -ENOMEM;
874 /* pci init */
875 dev->pci = pci_dev;
876 if (pci_enable_device(pci_dev)) {
877 err = -EIO;
878 goto fail1;
881 dev->nr = saa7134_devcount;
882 sprintf(dev->name,"saa%x[%d]",pci_dev->device,dev->nr);
884 /* pci quirks */
885 if (pci_pci_problems) {
886 if (pci_pci_problems & PCIPCI_TRITON)
887 printk(KERN_INFO "%s: quirk: PCIPCI_TRITON\n", dev->name);
888 if (pci_pci_problems & PCIPCI_NATOMA)
889 printk(KERN_INFO "%s: quirk: PCIPCI_NATOMA\n", dev->name);
890 if (pci_pci_problems & PCIPCI_VIAETBF)
891 printk(KERN_INFO "%s: quirk: PCIPCI_VIAETBF\n", dev->name);
892 if (pci_pci_problems & PCIPCI_VSFX)
893 printk(KERN_INFO "%s: quirk: PCIPCI_VSFX\n",dev->name);
894 #ifdef PCIPCI_ALIMAGIK
895 if (pci_pci_problems & PCIPCI_ALIMAGIK) {
896 printk(KERN_INFO "%s: quirk: PCIPCI_ALIMAGIK -- latency fixup\n",
897 dev->name);
898 latency = 0x0A;
900 #endif
901 if (pci_pci_problems & (PCIPCI_FAIL|PCIAGP_FAIL)) {
902 printk(KERN_INFO "%s: quirk: this driver and your "
903 "chipset may not work together"
904 " in overlay mode.\n",dev->name);
905 if (!saa7134_no_overlay) {
906 printk(KERN_INFO "%s: quirk: overlay "
907 "mode will be disabled.\n",
908 dev->name);
909 saa7134_no_overlay = 1;
910 } else {
911 printk(KERN_INFO "%s: quirk: overlay "
912 "mode will be forced. Use this"
913 " option at your own risk.\n",
914 dev->name);
918 if (UNSET != latency) {
919 printk(KERN_INFO "%s: setting pci latency timer to %d\n",
920 dev->name,latency);
921 pci_write_config_byte(pci_dev, PCI_LATENCY_TIMER, latency);
924 /* print pci info */
925 pci_read_config_byte(pci_dev, PCI_CLASS_REVISION, &dev->pci_rev);
926 pci_read_config_byte(pci_dev, PCI_LATENCY_TIMER, &dev->pci_lat);
927 printk(KERN_INFO "%s: found at %s, rev: %d, irq: %d, "
928 "latency: %d, mmio: 0x%llx\n", dev->name,
929 pci_name(pci_dev), dev->pci_rev, pci_dev->irq,
930 dev->pci_lat,(unsigned long long)pci_resource_start(pci_dev,0));
931 pci_set_master(pci_dev);
932 if (!pci_dma_supported(pci_dev, DMA_32BIT_MASK)) {
933 printk("%s: Oops: no 32bit PCI DMA ???\n",dev->name);
934 err = -EIO;
935 goto fail1;
938 /* board config */
939 dev->board = pci_id->driver_data;
940 if (card[dev->nr] >= 0 &&
941 card[dev->nr] < saa7134_bcount)
942 dev->board = card[dev->nr];
943 if (SAA7134_BOARD_NOAUTO == dev->board) {
944 must_configure_manually();
945 dev->board = SAA7134_BOARD_UNKNOWN;
947 dev->autodetected = card[dev->nr] != dev->board;
948 dev->tuner_type = saa7134_boards[dev->board].tuner_type;
949 dev->tuner_addr = saa7134_boards[dev->board].tuner_addr;
950 dev->tda9887_conf = saa7134_boards[dev->board].tda9887_conf;
951 if (UNSET != tuner[dev->nr])
952 dev->tuner_type = tuner[dev->nr];
953 printk(KERN_INFO "%s: subsystem: %04x:%04x, board: %s [card=%d,%s]\n",
954 dev->name,pci_dev->subsystem_vendor,
955 pci_dev->subsystem_device,saa7134_boards[dev->board].name,
956 dev->board, dev->autodetected ?
957 "autodetected" : "insmod option");
959 /* get mmio */
960 if (!request_mem_region(pci_resource_start(pci_dev,0),
961 pci_resource_len(pci_dev,0),
962 dev->name)) {
963 err = -EBUSY;
964 printk(KERN_ERR "%s: can't get MMIO memory @ 0x%llx\n",
965 dev->name,(unsigned long long)pci_resource_start(pci_dev,0));
966 goto fail1;
968 dev->lmmio = ioremap(pci_resource_start(pci_dev,0), 0x1000);
969 dev->bmmio = (__u8 __iomem *)dev->lmmio;
970 if (NULL == dev->lmmio) {
971 err = -EIO;
972 printk(KERN_ERR "%s: can't ioremap() MMIO memory\n",
973 dev->name);
974 goto fail2;
977 /* initialize hardware #1 */
978 saa7134_board_init1(dev);
979 saa7134_hwinit1(dev);
981 /* get irq */
982 err = request_irq(pci_dev->irq, saa7134_irq,
983 IRQF_SHARED | IRQF_DISABLED, dev->name, dev);
984 if (err < 0) {
985 printk(KERN_ERR "%s: can't get IRQ %d\n",
986 dev->name,pci_dev->irq);
987 goto fail3;
990 /* wait a bit, register i2c bus */
991 msleep(100);
992 saa7134_i2c_register(dev);
994 /* initialize hardware #2 */
995 if (TUNER_ABSENT != dev->tuner_type)
996 request_module("tuner");
997 saa7134_board_init2(dev);
999 saa7134_hwinit2(dev);
1001 /* load i2c helpers */
1002 if (card_is_empress(dev)) {
1003 request_module("saa6752hs");
1006 request_submodules(dev);
1008 v4l2_prio_init(&dev->prio);
1010 /* register v4l devices */
1011 if (saa7134_no_overlay <= 0) {
1012 saa7134_video_template.type |= VID_TYPE_OVERLAY;
1013 } else {
1014 printk("%s: Overlay support disabled.\n",dev->name);
1016 dev->video_dev = vdev_init(dev,&saa7134_video_template,"video");
1017 err = video_register_device(dev->video_dev,VFL_TYPE_GRABBER,
1018 video_nr[dev->nr]);
1019 if (err < 0) {
1020 printk(KERN_INFO "%s: can't register video device\n",
1021 dev->name);
1022 goto fail4;
1024 printk(KERN_INFO "%s: registered device video%d [v4l2]\n",
1025 dev->name,dev->video_dev->minor & 0x1f);
1027 dev->vbi_dev = vdev_init(dev, &saa7134_video_template, "vbi");
1028 dev->vbi_dev->type = VID_TYPE_TUNER | VID_TYPE_TELETEXT;
1030 err = video_register_device(dev->vbi_dev,VFL_TYPE_VBI,
1031 vbi_nr[dev->nr]);
1032 if (err < 0)
1033 goto fail4;
1034 printk(KERN_INFO "%s: registered device vbi%d\n",
1035 dev->name,dev->vbi_dev->minor & 0x1f);
1037 if (card_has_radio(dev)) {
1038 dev->radio_dev = vdev_init(dev,&saa7134_radio_template,"radio");
1039 err = video_register_device(dev->radio_dev,VFL_TYPE_RADIO,
1040 radio_nr[dev->nr]);
1041 if (err < 0)
1042 goto fail4;
1043 printk(KERN_INFO "%s: registered device radio%d\n",
1044 dev->name,dev->radio_dev->minor & 0x1f);
1047 /* everything worked */
1048 pci_set_drvdata(pci_dev,dev);
1049 saa7134_devcount++;
1051 mutex_lock(&devlist_lock);
1052 list_for_each_entry(mops, &mops_list, next)
1053 mpeg_ops_attach(mops, dev);
1054 list_add_tail(&dev->devlist,&saa7134_devlist);
1055 mutex_unlock(&devlist_lock);
1057 /* check for signal */
1058 saa7134_irq_video_signalchange(dev);
1060 if (saa7134_dmasound_init && !dev->dmasound.priv_data) {
1061 saa7134_dmasound_init(dev);
1064 if (TUNER_ABSENT != dev->tuner_type)
1065 saa7134_i2c_call_clients(dev, TUNER_SET_STANDBY, NULL);
1067 return 0;
1069 fail4:
1070 saa7134_unregister_video(dev);
1071 saa7134_i2c_unregister(dev);
1072 free_irq(pci_dev->irq, dev);
1073 fail3:
1074 saa7134_hwfini(dev);
1075 iounmap(dev->lmmio);
1076 fail2:
1077 release_mem_region(pci_resource_start(pci_dev,0),
1078 pci_resource_len(pci_dev,0));
1079 fail1:
1080 kfree(dev);
1081 return err;
1084 static void __devexit saa7134_finidev(struct pci_dev *pci_dev)
1086 struct saa7134_dev *dev = pci_get_drvdata(pci_dev);
1087 struct saa7134_mpeg_ops *mops;
1089 /* Release DMA sound modules if present */
1090 if (saa7134_dmasound_exit && dev->dmasound.priv_data) {
1091 saa7134_dmasound_exit(dev);
1094 /* debugging ... */
1095 if (irq_debug) {
1096 u32 report = saa_readl(SAA7134_IRQ_REPORT);
1097 u32 status = saa_readl(SAA7134_IRQ_STATUS);
1098 print_irqstatus(dev,42,report,status);
1101 /* disable peripheral devices */
1102 saa_writeb(SAA7134_SPECIAL_MODE,0);
1104 /* shutdown hardware */
1105 saa_writel(SAA7134_IRQ1,0);
1106 saa_writel(SAA7134_IRQ2,0);
1107 saa_writel(SAA7134_MAIN_CTRL,0);
1109 /* shutdown subsystems */
1110 saa7134_hwfini(dev);
1112 /* unregister */
1113 mutex_lock(&devlist_lock);
1114 list_del(&dev->devlist);
1115 list_for_each_entry(mops, &mops_list, next)
1116 mpeg_ops_detach(mops, dev);
1117 mutex_unlock(&devlist_lock);
1118 saa7134_devcount--;
1120 saa7134_i2c_unregister(dev);
1121 saa7134_unregister_video(dev);
1124 /* the DMA sound modules should be unloaded before reaching
1125 this, but just in case they are still present... */
1126 if (dev->dmasound.priv_data != NULL) {
1127 free_irq(pci_dev->irq, &dev->dmasound);
1128 dev->dmasound.priv_data = NULL;
1132 /* release resources */
1133 free_irq(pci_dev->irq, dev);
1134 iounmap(dev->lmmio);
1135 release_mem_region(pci_resource_start(pci_dev,0),
1136 pci_resource_len(pci_dev,0));
1138 pci_set_drvdata(pci_dev, NULL);
1140 /* free memory */
1141 kfree(dev);
1144 #ifdef CONFIG_PM
1145 static int saa7134_suspend(struct pci_dev *pci_dev , pm_message_t state)
1148 struct saa7134_dev *dev = pci_get_drvdata(pci_dev);
1150 /* disable overlay - apps should enable it explicitly on resume*/
1151 dev->ovenable = 0;
1153 /* Disable interrupts, DMA, and rest of the chip*/
1154 saa_writel(SAA7134_IRQ1, 0);
1155 saa_writel(SAA7134_IRQ2, 0);
1156 saa_writel(SAA7134_MAIN_CTRL, 0);
1158 dev->insuspend = 1;
1159 synchronize_irq(pci_dev->irq);
1161 /* ACK interrupts once more, just in case,
1162 since the IRQ handler won't ack them anymore*/
1164 saa_writel(SAA7134_IRQ_REPORT, saa_readl(SAA7134_IRQ_REPORT));
1166 /* Disable timeout timers - if we have active buffers, we will
1167 fill them on resume*/
1169 del_timer(&dev->video_q.timeout);
1170 del_timer(&dev->vbi_q.timeout);
1171 del_timer(&dev->ts_q.timeout);
1173 if (dev->remote)
1174 saa7134_ir_stop(dev);
1176 pci_save_state(pci_dev);
1177 pci_set_power_state(pci_dev, pci_choose_state(pci_dev, state));
1179 return 0;
1182 static int saa7134_resume(struct pci_dev *pci_dev)
1184 struct saa7134_dev *dev = pci_get_drvdata(pci_dev);
1185 unsigned long flags;
1187 pci_set_power_state(pci_dev, PCI_D0);
1188 pci_restore_state(pci_dev);
1190 /* Do things that are done in saa7134_initdev ,
1191 except of initializing memory structures.*/
1193 saa7134_board_init1(dev);
1195 /* saa7134_hwinit1 */
1196 if (saa7134_boards[dev->board].video_out)
1197 saa7134_videoport_init(dev);
1198 if (card_has_mpeg(dev))
1199 saa7134_ts_init_hw(dev);
1200 if (dev->remote)
1201 saa7134_ir_start(dev, dev->remote);
1202 saa7134_hw_enable1(dev);
1204 msleep(100);
1206 saa7134_board_init2(dev);
1208 /*saa7134_hwinit2*/
1209 saa7134_set_tvnorm_hw(dev);
1210 saa7134_tvaudio_setmute(dev);
1211 saa7134_tvaudio_setvolume(dev, dev->ctl_volume);
1212 saa7134_tvaudio_init(dev);
1213 saa7134_tvaudio_do_scan(dev);
1214 saa7134_enable_i2s(dev);
1215 saa7134_hw_enable2(dev);
1217 saa7134_irq_video_signalchange(dev);
1219 /*resume unfinished buffer(s)*/
1220 spin_lock_irqsave(&dev->slock, flags);
1221 saa7134_buffer_requeue(dev, &dev->video_q);
1222 saa7134_buffer_requeue(dev, &dev->vbi_q);
1223 saa7134_buffer_requeue(dev, &dev->ts_q);
1225 /* FIXME: Disable DMA audio sound - temporary till proper support
1226 is implemented*/
1228 dev->dmasound.dma_running = 0;
1230 /* start DMA now*/
1231 dev->insuspend = 0;
1232 smp_wmb();
1233 saa7134_set_dmabits(dev);
1234 spin_unlock_irqrestore(&dev->slock, flags);
1236 return 0;
1238 #endif
1240 /* ----------------------------------------------------------- */
1242 int saa7134_ts_register(struct saa7134_mpeg_ops *ops)
1244 struct saa7134_dev *dev;
1246 mutex_lock(&devlist_lock);
1247 list_for_each_entry(dev, &saa7134_devlist, devlist)
1248 mpeg_ops_attach(ops, dev);
1249 list_add_tail(&ops->next,&mops_list);
1250 mutex_unlock(&devlist_lock);
1251 return 0;
1254 void saa7134_ts_unregister(struct saa7134_mpeg_ops *ops)
1256 struct saa7134_dev *dev;
1258 mutex_lock(&devlist_lock);
1259 list_del(&ops->next);
1260 list_for_each_entry(dev, &saa7134_devlist, devlist)
1261 mpeg_ops_detach(ops, dev);
1262 mutex_unlock(&devlist_lock);
1265 EXPORT_SYMBOL(saa7134_ts_register);
1266 EXPORT_SYMBOL(saa7134_ts_unregister);
1268 /* ----------------------------------------------------------- */
1270 static struct pci_driver saa7134_pci_driver = {
1271 .name = "saa7134",
1272 .id_table = saa7134_pci_tbl,
1273 .probe = saa7134_initdev,
1274 .remove = __devexit_p(saa7134_finidev),
1275 #ifdef CONFIG_PM
1276 .suspend = saa7134_suspend,
1277 .resume = saa7134_resume
1278 #endif
1281 static int saa7134_init(void)
1283 INIT_LIST_HEAD(&saa7134_devlist);
1284 printk(KERN_INFO "saa7130/34: v4l2 driver version %d.%d.%d loaded\n",
1285 (SAA7134_VERSION_CODE >> 16) & 0xff,
1286 (SAA7134_VERSION_CODE >> 8) & 0xff,
1287 SAA7134_VERSION_CODE & 0xff);
1288 #ifdef SNAPSHOT
1289 printk(KERN_INFO "saa7130/34: snapshot date %04d-%02d-%02d\n",
1290 SNAPSHOT/10000, (SNAPSHOT/100)%100, SNAPSHOT%100);
1291 #endif
1292 return pci_register_driver(&saa7134_pci_driver);
1295 static void saa7134_fini(void)
1297 pci_unregister_driver(&saa7134_pci_driver);
1300 module_init(saa7134_init);
1301 module_exit(saa7134_fini);
1303 /* ----------------------------------------------------------- */
1305 EXPORT_SYMBOL(saa7134_set_gpio);
1306 EXPORT_SYMBOL(saa7134_i2c_call_clients);
1307 EXPORT_SYMBOL(saa7134_devlist);
1308 EXPORT_SYMBOL(saa7134_boards);
1310 /* ----------------- for the DMA sound modules --------------- */
1312 EXPORT_SYMBOL(saa7134_dmasound_init);
1313 EXPORT_SYMBOL(saa7134_dmasound_exit);
1314 EXPORT_SYMBOL(saa7134_pgtable_free);
1315 EXPORT_SYMBOL(saa7134_pgtable_build);
1316 EXPORT_SYMBOL(saa7134_pgtable_alloc);
1317 EXPORT_SYMBOL(saa7134_set_dmabits);
1319 /* ----------------------------------------------------------- */
1321 * Local variables:
1322 * c-basic-offset: 8
1323 * End: