3 * device driver for Conexant 2388x based TV cards
4 * video4linux video interface
6 * (c) 2003-04 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]
8 * (c) 2005-2006 Mauro Carvalho Chehab <mchehab@infradead.org>
10 * - video_ioctl2 conversion
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2 of the License, or
16 * (at your option) any later version.
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with this program; if not, write to the Free Software
25 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 #include <linux/init.h>
29 #include <linux/list.h>
30 #include <linux/module.h>
31 #include <linux/kmod.h>
32 #include <linux/kernel.h>
33 #include <linux/slab.h>
34 #include <linux/smp_lock.h>
35 #include <linux/interrupt.h>
36 #include <linux/dma-mapping.h>
37 #include <linux/delay.h>
38 #include <linux/kthread.h>
39 #include <asm/div64.h>
42 #include <media/v4l2-common.h>
43 #include <media/v4l2-ioctl.h>
45 MODULE_DESCRIPTION("v4l2 driver module for cx2388x based TV cards");
46 MODULE_AUTHOR("Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]");
47 MODULE_LICENSE("GPL");
49 /* ------------------------------------------------------------------ */
51 static unsigned int video_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
52 static unsigned int vbi_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
53 static unsigned int radio_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
55 module_param_array(video_nr
, int, NULL
, 0444);
56 module_param_array(vbi_nr
, int, NULL
, 0444);
57 module_param_array(radio_nr
, int, NULL
, 0444);
59 MODULE_PARM_DESC(video_nr
,"video device numbers");
60 MODULE_PARM_DESC(vbi_nr
,"vbi device numbers");
61 MODULE_PARM_DESC(radio_nr
,"radio device numbers");
63 static unsigned int video_debug
;
64 module_param(video_debug
,int,0644);
65 MODULE_PARM_DESC(video_debug
,"enable debug messages [video]");
67 static unsigned int irq_debug
;
68 module_param(irq_debug
,int,0644);
69 MODULE_PARM_DESC(irq_debug
,"enable debug messages [IRQ handler]");
71 static unsigned int vid_limit
= 16;
72 module_param(vid_limit
,int,0644);
73 MODULE_PARM_DESC(vid_limit
,"capture memory limit in megabytes");
75 #define dprintk(level,fmt, arg...) if (video_debug >= level) \
76 printk(KERN_DEBUG "%s/0: " fmt, core->name , ## arg)
78 /* ------------------------------------------------------------------- */
81 static struct cx8800_fmt formats
[] = {
83 .name
= "8 bpp, gray",
84 .fourcc
= V4L2_PIX_FMT_GREY
,
85 .cxformat
= ColorFormatY8
,
87 .flags
= FORMAT_FLAGS_PACKED
,
89 .name
= "15 bpp RGB, le",
90 .fourcc
= V4L2_PIX_FMT_RGB555
,
91 .cxformat
= ColorFormatRGB15
,
93 .flags
= FORMAT_FLAGS_PACKED
,
95 .name
= "15 bpp RGB, be",
96 .fourcc
= V4L2_PIX_FMT_RGB555X
,
97 .cxformat
= ColorFormatRGB15
| ColorFormatBSWAP
,
99 .flags
= FORMAT_FLAGS_PACKED
,
101 .name
= "16 bpp RGB, le",
102 .fourcc
= V4L2_PIX_FMT_RGB565
,
103 .cxformat
= ColorFormatRGB16
,
105 .flags
= FORMAT_FLAGS_PACKED
,
107 .name
= "16 bpp RGB, be",
108 .fourcc
= V4L2_PIX_FMT_RGB565X
,
109 .cxformat
= ColorFormatRGB16
| ColorFormatBSWAP
,
111 .flags
= FORMAT_FLAGS_PACKED
,
113 .name
= "24 bpp RGB, le",
114 .fourcc
= V4L2_PIX_FMT_BGR24
,
115 .cxformat
= ColorFormatRGB24
,
117 .flags
= FORMAT_FLAGS_PACKED
,
119 .name
= "32 bpp RGB, le",
120 .fourcc
= V4L2_PIX_FMT_BGR32
,
121 .cxformat
= ColorFormatRGB32
,
123 .flags
= FORMAT_FLAGS_PACKED
,
125 .name
= "32 bpp RGB, be",
126 .fourcc
= V4L2_PIX_FMT_RGB32
,
127 .cxformat
= ColorFormatRGB32
| ColorFormatBSWAP
| ColorFormatWSWAP
,
129 .flags
= FORMAT_FLAGS_PACKED
,
131 .name
= "4:2:2, packed, YUYV",
132 .fourcc
= V4L2_PIX_FMT_YUYV
,
133 .cxformat
= ColorFormatYUY2
,
135 .flags
= FORMAT_FLAGS_PACKED
,
137 .name
= "4:2:2, packed, UYVY",
138 .fourcc
= V4L2_PIX_FMT_UYVY
,
139 .cxformat
= ColorFormatYUY2
| ColorFormatBSWAP
,
141 .flags
= FORMAT_FLAGS_PACKED
,
145 static struct cx8800_fmt
* format_by_fourcc(unsigned int fourcc
)
149 for (i
= 0; i
< ARRAY_SIZE(formats
); i
++)
150 if (formats
[i
].fourcc
== fourcc
)
155 /* ------------------------------------------------------------------- */
157 static const struct v4l2_queryctrl no_ctl
= {
159 .flags
= V4L2_CTRL_FLAG_DISABLED
,
162 static struct cx88_ctrl cx8800_ctls
[] = {
166 .id
= V4L2_CID_BRIGHTNESS
,
167 .name
= "Brightness",
171 .default_value
= 0x7f,
172 .type
= V4L2_CTRL_TYPE_INTEGER
,
175 .reg
= MO_CONTR_BRIGHT
,
180 .id
= V4L2_CID_CONTRAST
,
185 .default_value
= 0x3f,
186 .type
= V4L2_CTRL_TYPE_INTEGER
,
189 .reg
= MO_CONTR_BRIGHT
,
199 .default_value
= 0x7f,
200 .type
= V4L2_CTRL_TYPE_INTEGER
,
207 /* strictly, this only describes only U saturation.
208 * V saturation is handled specially through code.
211 .id
= V4L2_CID_SATURATION
,
212 .name
= "Saturation",
216 .default_value
= 0x7f,
217 .type
= V4L2_CTRL_TYPE_INTEGER
,
220 .reg
= MO_UV_SATURATION
,
225 .id
= V4L2_CID_CHROMA_AGC
,
226 .name
= "Chroma AGC",
229 .default_value
= 0x1,
230 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
232 .reg
= MO_INPUT_FORMAT
,
237 .id
= V4L2_CID_COLOR_KILLER
,
238 .name
= "Color killer",
241 .default_value
= 0x1,
242 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
244 .reg
= MO_INPUT_FORMAT
,
250 .id
= V4L2_CID_AUDIO_MUTE
,
255 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
258 .sreg
= SHADOW_AUD_VOL_CTL
,
263 .id
= V4L2_CID_AUDIO_VOLUME
,
268 .default_value
= 0x3f,
269 .type
= V4L2_CTRL_TYPE_INTEGER
,
272 .sreg
= SHADOW_AUD_VOL_CTL
,
277 .id
= V4L2_CID_AUDIO_BALANCE
,
282 .default_value
= 0x40,
283 .type
= V4L2_CTRL_TYPE_INTEGER
,
286 .sreg
= SHADOW_AUD_BAL_CTL
,
291 static const int CX8800_CTLS
= ARRAY_SIZE(cx8800_ctls
);
293 /* Must be sorted from low to high control ID! */
294 const u32 cx88_user_ctrls
[] = {
300 V4L2_CID_AUDIO_VOLUME
,
301 V4L2_CID_AUDIO_BALANCE
,
304 V4L2_CID_COLOR_KILLER
,
307 EXPORT_SYMBOL(cx88_user_ctrls
);
309 static const u32
*ctrl_classes
[] = {
314 int cx8800_ctrl_query(struct cx88_core
*core
, struct v4l2_queryctrl
*qctrl
)
318 if (qctrl
->id
< V4L2_CID_BASE
||
319 qctrl
->id
>= V4L2_CID_LASTP1
)
321 for (i
= 0; i
< CX8800_CTLS
; i
++)
322 if (cx8800_ctls
[i
].v
.id
== qctrl
->id
)
324 if (i
== CX8800_CTLS
) {
328 *qctrl
= cx8800_ctls
[i
].v
;
329 /* Report chroma AGC as inactive when SECAM is selected */
330 if (cx8800_ctls
[i
].v
.id
== V4L2_CID_CHROMA_AGC
&&
331 core
->tvnorm
& V4L2_STD_SECAM
)
332 qctrl
->flags
|= V4L2_CTRL_FLAG_INACTIVE
;
336 EXPORT_SYMBOL(cx8800_ctrl_query
);
338 /* ------------------------------------------------------------------- */
339 /* resource management */
341 static int res_get(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bit
)
343 struct cx88_core
*core
= dev
->core
;
344 if (fh
->resources
& bit
)
345 /* have it already allocated */
349 mutex_lock(&core
->lock
);
350 if (dev
->resources
& bit
) {
351 /* no, someone else uses it */
352 mutex_unlock(&core
->lock
);
355 /* it's free, grab it */
356 fh
->resources
|= bit
;
357 dev
->resources
|= bit
;
358 dprintk(1,"res: get %d\n",bit
);
359 mutex_unlock(&core
->lock
);
364 int res_check(struct cx8800_fh
*fh
, unsigned int bit
)
366 return (fh
->resources
& bit
);
370 int res_locked(struct cx8800_dev
*dev
, unsigned int bit
)
372 return (dev
->resources
& bit
);
376 void res_free(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bits
)
378 struct cx88_core
*core
= dev
->core
;
379 BUG_ON((fh
->resources
& bits
) != bits
);
381 mutex_lock(&core
->lock
);
382 fh
->resources
&= ~bits
;
383 dev
->resources
&= ~bits
;
384 dprintk(1,"res: put %d\n",bits
);
385 mutex_unlock(&core
->lock
);
388 /* ------------------------------------------------------------------ */
390 int cx88_video_mux(struct cx88_core
*core
, unsigned int input
)
392 /* struct cx88_core *core = dev->core; */
394 dprintk(1,"video_mux: %d [vmux=%d,gpio=0x%x,0x%x,0x%x,0x%x]\n",
395 input
, INPUT(input
).vmux
,
396 INPUT(input
).gpio0
,INPUT(input
).gpio1
,
397 INPUT(input
).gpio2
,INPUT(input
).gpio3
);
399 cx_andor(MO_INPUT_FORMAT
, 0x03 << 14, INPUT(input
).vmux
<< 14);
400 cx_write(MO_GP3_IO
, INPUT(input
).gpio3
);
401 cx_write(MO_GP0_IO
, INPUT(input
).gpio0
);
402 cx_write(MO_GP1_IO
, INPUT(input
).gpio1
);
403 cx_write(MO_GP2_IO
, INPUT(input
).gpio2
);
405 switch (INPUT(input
).type
) {
406 case CX88_VMUX_SVIDEO
:
407 cx_set(MO_AFECFG_IO
, 0x00000001);
408 cx_set(MO_INPUT_FORMAT
, 0x00010010);
409 cx_set(MO_FILTER_EVEN
, 0x00002020);
410 cx_set(MO_FILTER_ODD
, 0x00002020);
413 cx_clear(MO_AFECFG_IO
, 0x00000001);
414 cx_clear(MO_INPUT_FORMAT
, 0x00010010);
415 cx_clear(MO_FILTER_EVEN
, 0x00002020);
416 cx_clear(MO_FILTER_ODD
, 0x00002020);
420 /* if there are audioroutes defined, we have an external
421 ADC to deal with audio */
422 if (INPUT(input
).audioroute
) {
423 /* The wm8775 module has the "2" route hardwired into
424 the initialization. Some boards may use different
425 routes for different inputs. HVR-1300 surely does */
426 if (core
->board
.audio_chip
&&
427 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
428 call_all(core
, audio
, s_routing
,
429 INPUT(input
).audioroute
, 0, 0);
431 /* cx2388's C-ADC is connected to the tuner only.
432 When used with S-Video, that ADC is busy dealing with
433 chroma, so an external must be used for baseband audio */
434 if (INPUT(input
).type
!= CX88_VMUX_TELEVISION
) {
436 core
->tvaudio
= WW_I2SADC
;
437 cx88_set_tvaudio(core
);
440 cx_write(AUD_I2SCNTL
, 0x0);
441 cx_clear(AUD_CTL
, EN_I2SIN_ENABLE
);
447 EXPORT_SYMBOL(cx88_video_mux
);
449 /* ------------------------------------------------------------------ */
451 static int start_video_dma(struct cx8800_dev
*dev
,
452 struct cx88_dmaqueue
*q
,
453 struct cx88_buffer
*buf
)
455 struct cx88_core
*core
= dev
->core
;
457 /* setup fifo + format */
458 cx88_sram_channel_setup(core
, &cx88_sram_channels
[SRAM_CH21
],
459 buf
->bpl
, buf
->risc
.dma
);
460 cx88_set_scale(core
, buf
->vb
.width
, buf
->vb
.height
, buf
->vb
.field
);
461 cx_write(MO_COLOR_CTRL
, buf
->fmt
->cxformat
| ColorFormatGamma
);
464 cx_write(MO_VIDY_GPCNTRL
,GP_COUNT_CONTROL_RESET
);
468 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
| PCI_INT_VIDINT
);
470 /* Enables corresponding bits at PCI_INT_STAT:
471 bits 0 to 4: video, audio, transport stream, VIP, Host
473 bits 8 and 9: DMA complete for: SRC, DST
474 bits 10 and 11: BERR signal asserted for RISC: RD, WR
475 bits 12 to 15: BERR signal asserted for: BRDG, SRC, DST, IPB
477 cx_set(MO_VID_INTMSK
, 0x0f0011);
480 cx_set(VID_CAPTURE_CONTROL
,0x06);
483 cx_set(MO_DEV_CNTRL2
, (1<<5));
484 cx_set(MO_VID_DMACNTRL
, 0x11); /* Planar Y and packed FIFO and RISC enable */
490 static int stop_video_dma(struct cx8800_dev
*dev
)
492 struct cx88_core
*core
= dev
->core
;
495 cx_clear(MO_VID_DMACNTRL
, 0x11);
497 /* disable capture */
498 cx_clear(VID_CAPTURE_CONTROL
,0x06);
501 cx_clear(MO_PCI_INTMSK
, PCI_INT_VIDINT
);
502 cx_clear(MO_VID_INTMSK
, 0x0f0011);
507 static int restart_video_queue(struct cx8800_dev
*dev
,
508 struct cx88_dmaqueue
*q
)
510 struct cx88_core
*core
= dev
->core
;
511 struct cx88_buffer
*buf
, *prev
;
513 if (!list_empty(&q
->active
)) {
514 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
515 dprintk(2,"restart_queue [%p/%d]: restart dma\n",
517 start_video_dma(dev
, q
, buf
);
518 list_for_each_entry(buf
, &q
->active
, vb
.queue
)
519 buf
->count
= q
->count
++;
520 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
526 if (list_empty(&q
->queued
))
528 buf
= list_entry(q
->queued
.next
, struct cx88_buffer
, vb
.queue
);
530 list_move_tail(&buf
->vb
.queue
, &q
->active
);
531 start_video_dma(dev
, q
, buf
);
532 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
533 buf
->count
= q
->count
++;
534 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
535 dprintk(2,"[%p/%d] restart_queue - first active\n",
538 } else if (prev
->vb
.width
== buf
->vb
.width
&&
539 prev
->vb
.height
== buf
->vb
.height
&&
540 prev
->fmt
== buf
->fmt
) {
541 list_move_tail(&buf
->vb
.queue
, &q
->active
);
542 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
543 buf
->count
= q
->count
++;
544 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
545 dprintk(2,"[%p/%d] restart_queue - move to active\n",
554 /* ------------------------------------------------------------------ */
557 buffer_setup(struct videobuf_queue
*q
, unsigned int *count
, unsigned int *size
)
559 struct cx8800_fh
*fh
= q
->priv_data
;
561 *size
= fh
->fmt
->depth
*fh
->width
*fh
->height
>> 3;
564 while (*size
* *count
> vid_limit
* 1024 * 1024)
570 buffer_prepare(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
,
571 enum v4l2_field field
)
573 struct cx8800_fh
*fh
= q
->priv_data
;
574 struct cx8800_dev
*dev
= fh
->dev
;
575 struct cx88_core
*core
= dev
->core
;
576 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
577 struct videobuf_dmabuf
*dma
=videobuf_to_dma(&buf
->vb
);
578 int rc
, init_buffer
= 0;
580 BUG_ON(NULL
== fh
->fmt
);
581 if (fh
->width
< 48 || fh
->width
> norm_maxw(core
->tvnorm
) ||
582 fh
->height
< 32 || fh
->height
> norm_maxh(core
->tvnorm
))
584 buf
->vb
.size
= (fh
->width
* fh
->height
* fh
->fmt
->depth
) >> 3;
585 if (0 != buf
->vb
.baddr
&& buf
->vb
.bsize
< buf
->vb
.size
)
588 if (buf
->fmt
!= fh
->fmt
||
589 buf
->vb
.width
!= fh
->width
||
590 buf
->vb
.height
!= fh
->height
||
591 buf
->vb
.field
!= field
) {
593 buf
->vb
.width
= fh
->width
;
594 buf
->vb
.height
= fh
->height
;
595 buf
->vb
.field
= field
;
599 if (VIDEOBUF_NEEDS_INIT
== buf
->vb
.state
) {
601 if (0 != (rc
= videobuf_iolock(q
,&buf
->vb
,NULL
)))
606 buf
->bpl
= buf
->vb
.width
* buf
->fmt
->depth
>> 3;
607 switch (buf
->vb
.field
) {
609 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
610 dma
->sglist
, 0, UNSET
,
611 buf
->bpl
, 0, buf
->vb
.height
);
613 case V4L2_FIELD_BOTTOM
:
614 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
615 dma
->sglist
, UNSET
, 0,
616 buf
->bpl
, 0, buf
->vb
.height
);
618 case V4L2_FIELD_INTERLACED
:
619 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
620 dma
->sglist
, 0, buf
->bpl
,
622 buf
->vb
.height
>> 1);
624 case V4L2_FIELD_SEQ_TB
:
625 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
627 0, buf
->bpl
* (buf
->vb
.height
>> 1),
629 buf
->vb
.height
>> 1);
631 case V4L2_FIELD_SEQ_BT
:
632 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
634 buf
->bpl
* (buf
->vb
.height
>> 1), 0,
636 buf
->vb
.height
>> 1);
642 dprintk(2,"[%p/%d] buffer_prepare - %dx%d %dbpp \"%s\" - dma=0x%08lx\n",
644 fh
->width
, fh
->height
, fh
->fmt
->depth
, fh
->fmt
->name
,
645 (unsigned long)buf
->risc
.dma
);
647 buf
->vb
.state
= VIDEOBUF_PREPARED
;
651 cx88_free_buffer(q
,buf
);
656 buffer_queue(struct videobuf_queue
*vq
, struct videobuf_buffer
*vb
)
658 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
659 struct cx88_buffer
*prev
;
660 struct cx8800_fh
*fh
= vq
->priv_data
;
661 struct cx8800_dev
*dev
= fh
->dev
;
662 struct cx88_core
*core
= dev
->core
;
663 struct cx88_dmaqueue
*q
= &dev
->vidq
;
665 /* add jump to stopper */
666 buf
->risc
.jmp
[0] = cpu_to_le32(RISC_JUMP
| RISC_IRQ1
| RISC_CNT_INC
);
667 buf
->risc
.jmp
[1] = cpu_to_le32(q
->stopper
.dma
);
669 if (!list_empty(&q
->queued
)) {
670 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
671 buf
->vb
.state
= VIDEOBUF_QUEUED
;
672 dprintk(2,"[%p/%d] buffer_queue - append to queued\n",
675 } else if (list_empty(&q
->active
)) {
676 list_add_tail(&buf
->vb
.queue
,&q
->active
);
677 start_video_dma(dev
, q
, buf
);
678 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
679 buf
->count
= q
->count
++;
680 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
681 dprintk(2,"[%p/%d] buffer_queue - first active\n",
685 prev
= list_entry(q
->active
.prev
, struct cx88_buffer
, vb
.queue
);
686 if (prev
->vb
.width
== buf
->vb
.width
&&
687 prev
->vb
.height
== buf
->vb
.height
&&
688 prev
->fmt
== buf
->fmt
) {
689 list_add_tail(&buf
->vb
.queue
,&q
->active
);
690 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
691 buf
->count
= q
->count
++;
692 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
693 dprintk(2,"[%p/%d] buffer_queue - append to active\n",
697 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
698 buf
->vb
.state
= VIDEOBUF_QUEUED
;
699 dprintk(2,"[%p/%d] buffer_queue - first queued\n",
705 static void buffer_release(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
)
707 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
709 cx88_free_buffer(q
,buf
);
712 static struct videobuf_queue_ops cx8800_video_qops
= {
713 .buf_setup
= buffer_setup
,
714 .buf_prepare
= buffer_prepare
,
715 .buf_queue
= buffer_queue
,
716 .buf_release
= buffer_release
,
719 /* ------------------------------------------------------------------ */
722 /* ------------------------------------------------------------------ */
724 static struct videobuf_queue
* get_queue(struct cx8800_fh
*fh
)
727 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
729 case V4L2_BUF_TYPE_VBI_CAPTURE
:
737 static int get_ressource(struct cx8800_fh
*fh
)
740 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
741 return RESOURCE_VIDEO
;
742 case V4L2_BUF_TYPE_VBI_CAPTURE
:
750 static int video_open(struct file
*file
)
752 struct video_device
*vdev
= video_devdata(file
);
753 struct cx8800_dev
*dev
= video_drvdata(file
);
754 struct cx88_core
*core
;
755 struct cx8800_fh
*fh
;
756 enum v4l2_buf_type type
= 0;
759 switch (vdev
->vfl_type
) {
760 case VFL_TYPE_GRABBER
:
761 type
= V4L2_BUF_TYPE_VIDEO_CAPTURE
;
764 type
= V4L2_BUF_TYPE_VBI_CAPTURE
;
775 dprintk(1, "open dev=%s radio=%d type=%s\n",
776 video_device_node_name(vdev
), radio
, v4l2_type_names
[type
]);
778 /* allocate + initialize per filehandle data */
779 fh
= kzalloc(sizeof(*fh
),GFP_KERNEL
);
784 file
->private_data
= fh
;
790 fh
->fmt
= format_by_fourcc(V4L2_PIX_FMT_BGR24
);
792 videobuf_queue_sg_init(&fh
->vidq
, &cx8800_video_qops
,
793 &dev
->pci
->dev
, &dev
->slock
,
794 V4L2_BUF_TYPE_VIDEO_CAPTURE
,
795 V4L2_FIELD_INTERLACED
,
796 sizeof(struct cx88_buffer
),
798 videobuf_queue_sg_init(&fh
->vbiq
, &cx8800_vbi_qops
,
799 &dev
->pci
->dev
, &dev
->slock
,
800 V4L2_BUF_TYPE_VBI_CAPTURE
,
802 sizeof(struct cx88_buffer
),
806 dprintk(1,"video_open: setting radio device\n");
807 cx_write(MO_GP3_IO
, core
->board
.radio
.gpio3
);
808 cx_write(MO_GP0_IO
, core
->board
.radio
.gpio0
);
809 cx_write(MO_GP1_IO
, core
->board
.radio
.gpio1
);
810 cx_write(MO_GP2_IO
, core
->board
.radio
.gpio2
);
811 if (core
->board
.radio
.audioroute
) {
812 if(core
->board
.audio_chip
&&
813 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
814 call_all(core
, audio
, s_routing
,
815 core
->board
.radio
.audioroute
, 0, 0);
818 core
->tvaudio
= WW_I2SADC
;
819 cx88_set_tvaudio(core
);
822 core
->tvaudio
= WW_FM
;
823 cx88_set_tvaudio(core
);
824 cx88_set_stereo(core
,V4L2_TUNER_MODE_STEREO
,1);
826 call_all(core
, tuner
, s_radio
);
830 atomic_inc(&core
->users
);
836 video_read(struct file
*file
, char __user
*data
, size_t count
, loff_t
*ppos
)
838 struct cx8800_fh
*fh
= file
->private_data
;
841 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
842 if (res_locked(fh
->dev
,RESOURCE_VIDEO
))
844 return videobuf_read_one(&fh
->vidq
, data
, count
, ppos
,
845 file
->f_flags
& O_NONBLOCK
);
846 case V4L2_BUF_TYPE_VBI_CAPTURE
:
847 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
849 return videobuf_read_stream(&fh
->vbiq
, data
, count
, ppos
, 1,
850 file
->f_flags
& O_NONBLOCK
);
858 video_poll(struct file
*file
, struct poll_table_struct
*wait
)
860 struct cx8800_fh
*fh
= file
->private_data
;
861 struct cx88_buffer
*buf
;
862 unsigned int rc
= POLLERR
;
864 if (V4L2_BUF_TYPE_VBI_CAPTURE
== fh
->type
) {
865 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
867 return videobuf_poll_stream(file
, &fh
->vbiq
, wait
);
870 mutex_lock(&fh
->vidq
.vb_lock
);
871 if (res_check(fh
,RESOURCE_VIDEO
)) {
872 /* streaming capture */
873 if (list_empty(&fh
->vidq
.stream
))
875 buf
= list_entry(fh
->vidq
.stream
.next
,struct cx88_buffer
,vb
.stream
);
878 buf
= (struct cx88_buffer
*)fh
->vidq
.read_buf
;
882 poll_wait(file
, &buf
->vb
.done
, wait
);
883 if (buf
->vb
.state
== VIDEOBUF_DONE
||
884 buf
->vb
.state
== VIDEOBUF_ERROR
)
885 rc
= POLLIN
|POLLRDNORM
;
889 mutex_unlock(&fh
->vidq
.vb_lock
);
893 static int video_release(struct file
*file
)
895 struct cx8800_fh
*fh
= file
->private_data
;
896 struct cx8800_dev
*dev
= fh
->dev
;
898 /* turn off overlay */
899 if (res_check(fh
, RESOURCE_OVERLAY
)) {
901 res_free(dev
,fh
,RESOURCE_OVERLAY
);
904 /* stop video capture */
905 if (res_check(fh
, RESOURCE_VIDEO
)) {
906 videobuf_queue_cancel(&fh
->vidq
);
907 res_free(dev
,fh
,RESOURCE_VIDEO
);
909 if (fh
->vidq
.read_buf
) {
910 buffer_release(&fh
->vidq
,fh
->vidq
.read_buf
);
911 kfree(fh
->vidq
.read_buf
);
914 /* stop vbi capture */
915 if (res_check(fh
, RESOURCE_VBI
)) {
916 videobuf_stop(&fh
->vbiq
);
917 res_free(dev
,fh
,RESOURCE_VBI
);
920 videobuf_mmap_free(&fh
->vidq
);
921 videobuf_mmap_free(&fh
->vbiq
);
922 file
->private_data
= NULL
;
925 mutex_lock(&dev
->core
->lock
);
926 if(atomic_dec_and_test(&dev
->core
->users
))
927 call_all(dev
->core
, core
, s_power
, 0);
928 mutex_unlock(&dev
->core
->lock
);
934 video_mmap(struct file
*file
, struct vm_area_struct
* vma
)
936 struct cx8800_fh
*fh
= file
->private_data
;
938 return videobuf_mmap_mapper(get_queue(fh
), vma
);
941 /* ------------------------------------------------------------------ */
942 /* VIDEO CTRL IOCTLS */
944 int cx88_get_control (struct cx88_core
*core
, struct v4l2_control
*ctl
)
946 struct cx88_ctrl
*c
= NULL
;
950 for (i
= 0; i
< CX8800_CTLS
; i
++)
951 if (cx8800_ctls
[i
].v
.id
== ctl
->id
)
953 if (unlikely(NULL
== c
))
956 value
= c
->sreg
? cx_sread(c
->sreg
) : cx_read(c
->reg
);
958 case V4L2_CID_AUDIO_BALANCE
:
959 ctl
->value
= ((value
& 0x7f) < 0x40) ? ((value
& 0x7f) + 0x40)
960 : (0x7f - (value
& 0x7f));
962 case V4L2_CID_AUDIO_VOLUME
:
963 ctl
->value
= 0x3f - (value
& 0x3f);
966 ctl
->value
= ((value
+ (c
->off
<< c
->shift
)) & c
->mask
) >> c
->shift
;
969 dprintk(1,"get_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
970 ctl
->id
, c
->v
.name
, ctl
->value
, c
->reg
,
971 value
,c
->mask
, c
->sreg
? " [shadowed]" : "");
974 EXPORT_SYMBOL(cx88_get_control
);
976 int cx88_set_control(struct cx88_core
*core
, struct v4l2_control
*ctl
)
978 struct cx88_ctrl
*c
= NULL
;
982 for (i
= 0; i
< CX8800_CTLS
; i
++) {
983 if (cx8800_ctls
[i
].v
.id
== ctl
->id
) {
987 if (unlikely(NULL
== c
))
990 if (ctl
->value
< c
->v
.minimum
)
991 ctl
->value
= c
->v
.minimum
;
992 if (ctl
->value
> c
->v
.maximum
)
993 ctl
->value
= c
->v
.maximum
;
996 case V4L2_CID_AUDIO_BALANCE
:
997 value
= (ctl
->value
< 0x40) ? (0x7f - ctl
->value
) : (ctl
->value
- 0x40);
999 case V4L2_CID_AUDIO_VOLUME
:
1000 value
= 0x3f - (ctl
->value
& 0x3f);
1002 case V4L2_CID_SATURATION
:
1003 /* special v_sat handling */
1005 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1007 if (core
->tvnorm
& V4L2_STD_SECAM
) {
1008 /* For SECAM, both U and V sat should be equal */
1009 value
=value
<<8|value
;
1011 /* Keeps U Saturation proportional to V Sat */
1012 value
=(value
*0x5a)/0x7f<<8|value
;
1016 case V4L2_CID_CHROMA_AGC
:
1017 /* Do not allow chroma AGC to be enabled for SECAM */
1018 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1019 if (core
->tvnorm
& V4L2_STD_SECAM
&& value
)
1023 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1026 dprintk(1,"set_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
1027 ctl
->id
, c
->v
.name
, ctl
->value
, c
->reg
, value
,
1028 mask
, c
->sreg
? " [shadowed]" : "");
1030 cx_sandor(c
->sreg
, c
->reg
, mask
, value
);
1032 cx_andor(c
->reg
, mask
, value
);
1036 EXPORT_SYMBOL(cx88_set_control
);
1038 static void init_controls(struct cx88_core
*core
)
1040 struct v4l2_control ctrl
;
1043 for (i
= 0; i
< CX8800_CTLS
; i
++) {
1044 ctrl
.id
=cx8800_ctls
[i
].v
.id
;
1045 ctrl
.value
=cx8800_ctls
[i
].v
.default_value
;
1047 cx88_set_control(core
, &ctrl
);
1051 /* ------------------------------------------------------------------ */
1054 static int vidioc_g_fmt_vid_cap(struct file
*file
, void *priv
,
1055 struct v4l2_format
*f
)
1057 struct cx8800_fh
*fh
= priv
;
1059 f
->fmt
.pix
.width
= fh
->width
;
1060 f
->fmt
.pix
.height
= fh
->height
;
1061 f
->fmt
.pix
.field
= fh
->vidq
.field
;
1062 f
->fmt
.pix
.pixelformat
= fh
->fmt
->fourcc
;
1063 f
->fmt
.pix
.bytesperline
=
1064 (f
->fmt
.pix
.width
* fh
->fmt
->depth
) >> 3;
1065 f
->fmt
.pix
.sizeimage
=
1066 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1070 static int vidioc_try_fmt_vid_cap(struct file
*file
, void *priv
,
1071 struct v4l2_format
*f
)
1073 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1074 struct cx8800_fmt
*fmt
;
1075 enum v4l2_field field
;
1076 unsigned int maxw
, maxh
;
1078 fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1082 field
= f
->fmt
.pix
.field
;
1083 maxw
= norm_maxw(core
->tvnorm
);
1084 maxh
= norm_maxh(core
->tvnorm
);
1086 if (V4L2_FIELD_ANY
== field
) {
1087 field
= (f
->fmt
.pix
.height
> maxh
/2)
1088 ? V4L2_FIELD_INTERLACED
1089 : V4L2_FIELD_BOTTOM
;
1093 case V4L2_FIELD_TOP
:
1094 case V4L2_FIELD_BOTTOM
:
1097 case V4L2_FIELD_INTERLACED
:
1103 f
->fmt
.pix
.field
= field
;
1104 v4l_bound_align_image(&f
->fmt
.pix
.width
, 48, maxw
, 2,
1105 &f
->fmt
.pix
.height
, 32, maxh
, 0, 0);
1106 f
->fmt
.pix
.bytesperline
=
1107 (f
->fmt
.pix
.width
* fmt
->depth
) >> 3;
1108 f
->fmt
.pix
.sizeimage
=
1109 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1114 static int vidioc_s_fmt_vid_cap(struct file
*file
, void *priv
,
1115 struct v4l2_format
*f
)
1117 struct cx8800_fh
*fh
= priv
;
1118 int err
= vidioc_try_fmt_vid_cap (file
,priv
,f
);
1122 fh
->fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1123 fh
->width
= f
->fmt
.pix
.width
;
1124 fh
->height
= f
->fmt
.pix
.height
;
1125 fh
->vidq
.field
= f
->fmt
.pix
.field
;
1129 static int vidioc_querycap (struct file
*file
, void *priv
,
1130 struct v4l2_capability
*cap
)
1132 struct cx8800_dev
*dev
= ((struct cx8800_fh
*)priv
)->dev
;
1133 struct cx88_core
*core
= dev
->core
;
1135 strcpy(cap
->driver
, "cx8800");
1136 strlcpy(cap
->card
, core
->board
.name
, sizeof(cap
->card
));
1137 sprintf(cap
->bus_info
,"PCI:%s",pci_name(dev
->pci
));
1138 cap
->version
= CX88_VERSION_CODE
;
1140 V4L2_CAP_VIDEO_CAPTURE
|
1141 V4L2_CAP_READWRITE
|
1142 V4L2_CAP_STREAMING
|
1143 V4L2_CAP_VBI_CAPTURE
;
1144 if (UNSET
!= core
->board
.tuner_type
)
1145 cap
->capabilities
|= V4L2_CAP_TUNER
;
1149 static int vidioc_enum_fmt_vid_cap (struct file
*file
, void *priv
,
1150 struct v4l2_fmtdesc
*f
)
1152 if (unlikely(f
->index
>= ARRAY_SIZE(formats
)))
1155 strlcpy(f
->description
,formats
[f
->index
].name
,sizeof(f
->description
));
1156 f
->pixelformat
= formats
[f
->index
].fourcc
;
1161 #ifdef CONFIG_VIDEO_V4L1_COMPAT
1162 static int vidiocgmbuf (struct file
*file
, void *priv
, struct video_mbuf
*mbuf
)
1164 struct cx8800_fh
*fh
= priv
;
1166 return videobuf_cgmbuf (get_queue(fh
), mbuf
, 8);
1170 static int vidioc_reqbufs (struct file
*file
, void *priv
, struct v4l2_requestbuffers
*p
)
1172 struct cx8800_fh
*fh
= priv
;
1173 return (videobuf_reqbufs(get_queue(fh
), p
));
1176 static int vidioc_querybuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1178 struct cx8800_fh
*fh
= priv
;
1179 return (videobuf_querybuf(get_queue(fh
), p
));
1182 static int vidioc_qbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1184 struct cx8800_fh
*fh
= priv
;
1185 return (videobuf_qbuf(get_queue(fh
), p
));
1188 static int vidioc_dqbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1190 struct cx8800_fh
*fh
= priv
;
1191 return (videobuf_dqbuf(get_queue(fh
), p
,
1192 file
->f_flags
& O_NONBLOCK
));
1195 static int vidioc_streamon(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1197 struct cx8800_fh
*fh
= priv
;
1198 struct cx8800_dev
*dev
= fh
->dev
;
1200 /* We should remember that this driver also supports teletext, */
1201 /* so we have to test if the v4l2_buf_type is VBI capture data. */
1202 if (unlikely((fh
->type
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) &&
1203 (fh
->type
!= V4L2_BUF_TYPE_VBI_CAPTURE
)))
1206 if (unlikely(i
!= fh
->type
))
1209 if (unlikely(!res_get(dev
,fh
,get_ressource(fh
))))
1211 return videobuf_streamon(get_queue(fh
));
1214 static int vidioc_streamoff(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1216 struct cx8800_fh
*fh
= priv
;
1217 struct cx8800_dev
*dev
= fh
->dev
;
1220 if ((fh
->type
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) &&
1221 (fh
->type
!= V4L2_BUF_TYPE_VBI_CAPTURE
))
1227 res
= get_ressource(fh
);
1228 err
= videobuf_streamoff(get_queue(fh
));
1231 res_free(dev
,fh
,res
);
1235 static int vidioc_s_std (struct file
*file
, void *priv
, v4l2_std_id
*tvnorms
)
1237 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1239 mutex_lock(&core
->lock
);
1240 cx88_set_tvnorm(core
,*tvnorms
);
1241 mutex_unlock(&core
->lock
);
1246 /* only one input in this sample driver */
1247 int cx88_enum_input (struct cx88_core
*core
,struct v4l2_input
*i
)
1249 static const char *iname
[] = {
1250 [ CX88_VMUX_COMPOSITE1
] = "Composite1",
1251 [ CX88_VMUX_COMPOSITE2
] = "Composite2",
1252 [ CX88_VMUX_COMPOSITE3
] = "Composite3",
1253 [ CX88_VMUX_COMPOSITE4
] = "Composite4",
1254 [ CX88_VMUX_SVIDEO
] = "S-Video",
1255 [ CX88_VMUX_TELEVISION
] = "Television",
1256 [ CX88_VMUX_CABLE
] = "Cable TV",
1257 [ CX88_VMUX_DVB
] = "DVB",
1258 [ CX88_VMUX_DEBUG
] = "for debug only",
1260 unsigned int n
= i
->index
;
1264 if (0 == INPUT(n
).type
)
1266 i
->type
= V4L2_INPUT_TYPE_CAMERA
;
1267 strcpy(i
->name
,iname
[INPUT(n
).type
]);
1268 if ((CX88_VMUX_TELEVISION
== INPUT(n
).type
) ||
1269 (CX88_VMUX_CABLE
== INPUT(n
).type
))
1270 i
->type
= V4L2_INPUT_TYPE_TUNER
;
1271 i
->std
= CX88_NORMS
;
1274 EXPORT_SYMBOL(cx88_enum_input
);
1276 static int vidioc_enum_input (struct file
*file
, void *priv
,
1277 struct v4l2_input
*i
)
1279 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1280 return cx88_enum_input (core
,i
);
1283 static int vidioc_g_input (struct file
*file
, void *priv
, unsigned int *i
)
1285 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1291 static int vidioc_s_input (struct file
*file
, void *priv
, unsigned int i
)
1293 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1298 mutex_lock(&core
->lock
);
1299 cx88_newstation(core
);
1300 cx88_video_mux(core
,i
);
1301 mutex_unlock(&core
->lock
);
1307 static int vidioc_queryctrl (struct file
*file
, void *priv
,
1308 struct v4l2_queryctrl
*qctrl
)
1310 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1312 qctrl
->id
= v4l2_ctrl_next(ctrl_classes
, qctrl
->id
);
1313 if (unlikely(qctrl
->id
== 0))
1315 return cx8800_ctrl_query(core
, qctrl
);
1318 static int vidioc_g_ctrl (struct file
*file
, void *priv
,
1319 struct v4l2_control
*ctl
)
1321 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1323 cx88_get_control(core
,ctl
);
1326 static int vidioc_s_ctrl (struct file
*file
, void *priv
,
1327 struct v4l2_control
*ctl
)
1329 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1331 cx88_set_control(core
,ctl
);
1334 static int vidioc_g_tuner (struct file
*file
, void *priv
,
1335 struct v4l2_tuner
*t
)
1337 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1340 if (unlikely(UNSET
== core
->board
.tuner_type
))
1345 strcpy(t
->name
, "Television");
1346 t
->type
= V4L2_TUNER_ANALOG_TV
;
1347 t
->capability
= V4L2_TUNER_CAP_NORM
;
1348 t
->rangehigh
= 0xffffffffUL
;
1350 cx88_get_stereo(core
,t
);
1351 reg
= cx_read(MO_DEVICE_STATUS
);
1352 t
->signal
= (reg
& (1<<5)) ? 0xffff : 0x0000;
1356 static int vidioc_s_tuner (struct file
*file
, void *priv
,
1357 struct v4l2_tuner
*t
)
1359 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1361 if (UNSET
== core
->board
.tuner_type
)
1366 cx88_set_stereo(core
, t
->audmode
, 1);
1370 static int vidioc_g_frequency (struct file
*file
, void *priv
,
1371 struct v4l2_frequency
*f
)
1373 struct cx8800_fh
*fh
= priv
;
1374 struct cx88_core
*core
= fh
->dev
->core
;
1376 if (unlikely(UNSET
== core
->board
.tuner_type
))
1379 /* f->type = fh->radio ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV; */
1380 f
->type
= fh
->radio
? V4L2_TUNER_RADIO
: V4L2_TUNER_ANALOG_TV
;
1381 f
->frequency
= core
->freq
;
1383 call_all(core
, tuner
, g_frequency
, f
);
1388 int cx88_set_freq (struct cx88_core
*core
,
1389 struct v4l2_frequency
*f
)
1391 if (unlikely(UNSET
== core
->board
.tuner_type
))
1393 if (unlikely(f
->tuner
!= 0))
1396 mutex_lock(&core
->lock
);
1397 core
->freq
= f
->frequency
;
1398 cx88_newstation(core
);
1399 call_all(core
, tuner
, s_frequency
, f
);
1401 /* When changing channels it is required to reset TVAUDIO */
1403 cx88_set_tvaudio(core
);
1405 mutex_unlock(&core
->lock
);
1409 EXPORT_SYMBOL(cx88_set_freq
);
1411 static int vidioc_s_frequency (struct file
*file
, void *priv
,
1412 struct v4l2_frequency
*f
)
1414 struct cx8800_fh
*fh
= priv
;
1415 struct cx88_core
*core
= fh
->dev
->core
;
1417 if (unlikely(0 == fh
->radio
&& f
->type
!= V4L2_TUNER_ANALOG_TV
))
1419 if (unlikely(1 == fh
->radio
&& f
->type
!= V4L2_TUNER_RADIO
))
1423 cx88_set_freq (core
,f
);
1426 #ifdef CONFIG_VIDEO_ADV_DEBUG
1427 static int vidioc_g_register (struct file
*file
, void *fh
,
1428 struct v4l2_dbg_register
*reg
)
1430 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1432 if (!v4l2_chip_match_host(®
->match
))
1434 /* cx2388x has a 24-bit register space */
1435 reg
->val
= cx_read(reg
->reg
& 0xffffff);
1440 static int vidioc_s_register (struct file
*file
, void *fh
,
1441 struct v4l2_dbg_register
*reg
)
1443 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1445 if (!v4l2_chip_match_host(®
->match
))
1447 cx_write(reg
->reg
& 0xffffff, reg
->val
);
1452 /* ----------------------------------------------------------- */
1453 /* RADIO ESPECIFIC IOCTLS */
1454 /* ----------------------------------------------------------- */
1456 static int radio_querycap (struct file
*file
, void *priv
,
1457 struct v4l2_capability
*cap
)
1459 struct cx8800_dev
*dev
= ((struct cx8800_fh
*)priv
)->dev
;
1460 struct cx88_core
*core
= dev
->core
;
1462 strcpy(cap
->driver
, "cx8800");
1463 strlcpy(cap
->card
, core
->board
.name
, sizeof(cap
->card
));
1464 sprintf(cap
->bus_info
,"PCI:%s", pci_name(dev
->pci
));
1465 cap
->version
= CX88_VERSION_CODE
;
1466 cap
->capabilities
= V4L2_CAP_TUNER
;
1470 static int radio_g_tuner (struct file
*file
, void *priv
,
1471 struct v4l2_tuner
*t
)
1473 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1475 if (unlikely(t
->index
> 0))
1478 strcpy(t
->name
, "Radio");
1479 t
->type
= V4L2_TUNER_RADIO
;
1481 call_all(core
, tuner
, g_tuner
, t
);
1485 static int radio_enum_input (struct file
*file
, void *priv
,
1486 struct v4l2_input
*i
)
1490 strcpy(i
->name
,"Radio");
1491 i
->type
= V4L2_INPUT_TYPE_TUNER
;
1496 static int radio_g_audio (struct file
*file
, void *priv
, struct v4l2_audio
*a
)
1498 if (unlikely(a
->index
))
1501 strcpy(a
->name
,"Radio");
1505 /* FIXME: Should add a standard for radio */
1507 static int radio_s_tuner (struct file
*file
, void *priv
,
1508 struct v4l2_tuner
*t
)
1510 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1515 call_all(core
, tuner
, s_tuner
, t
);
1520 static int radio_s_audio (struct file
*file
, void *fh
,
1521 struct v4l2_audio
*a
)
1526 static int radio_s_input (struct file
*file
, void *fh
, unsigned int i
)
1531 static int radio_queryctrl (struct file
*file
, void *priv
,
1532 struct v4l2_queryctrl
*c
)
1536 if (c
->id
< V4L2_CID_BASE
||
1537 c
->id
>= V4L2_CID_LASTP1
)
1539 if (c
->id
== V4L2_CID_AUDIO_MUTE
) {
1540 for (i
= 0; i
< CX8800_CTLS
; i
++)
1541 if (cx8800_ctls
[i
].v
.id
== c
->id
)
1543 *c
= cx8800_ctls
[i
].v
;
1549 /* ----------------------------------------------------------- */
1551 static void cx8800_vid_timeout(unsigned long data
)
1553 struct cx8800_dev
*dev
= (struct cx8800_dev
*)data
;
1554 struct cx88_core
*core
= dev
->core
;
1555 struct cx88_dmaqueue
*q
= &dev
->vidq
;
1556 struct cx88_buffer
*buf
;
1557 unsigned long flags
;
1559 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1561 cx_clear(MO_VID_DMACNTRL
, 0x11);
1562 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1564 spin_lock_irqsave(&dev
->slock
,flags
);
1565 while (!list_empty(&q
->active
)) {
1566 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
1567 list_del(&buf
->vb
.queue
);
1568 buf
->vb
.state
= VIDEOBUF_ERROR
;
1569 wake_up(&buf
->vb
.done
);
1570 printk("%s/0: [%p/%d] timeout - dma=0x%08lx\n", core
->name
,
1571 buf
, buf
->vb
.i
, (unsigned long)buf
->risc
.dma
);
1573 restart_video_queue(dev
,q
);
1574 spin_unlock_irqrestore(&dev
->slock
,flags
);
1577 static char *cx88_vid_irqs
[32] = {
1578 "y_risci1", "u_risci1", "v_risci1", "vbi_risc1",
1579 "y_risci2", "u_risci2", "v_risci2", "vbi_risc2",
1580 "y_oflow", "u_oflow", "v_oflow", "vbi_oflow",
1581 "y_sync", "u_sync", "v_sync", "vbi_sync",
1582 "opc_err", "par_err", "rip_err", "pci_abort",
1585 static void cx8800_vid_irq(struct cx8800_dev
*dev
)
1587 struct cx88_core
*core
= dev
->core
;
1588 u32 status
, mask
, count
;
1590 status
= cx_read(MO_VID_INTSTAT
);
1591 mask
= cx_read(MO_VID_INTMSK
);
1592 if (0 == (status
& mask
))
1594 cx_write(MO_VID_INTSTAT
, status
);
1595 if (irq_debug
|| (status
& mask
& ~0xff))
1596 cx88_print_irqbits(core
->name
, "irq vid",
1597 cx88_vid_irqs
, ARRAY_SIZE(cx88_vid_irqs
),
1600 /* risc op code error */
1601 if (status
& (1 << 16)) {
1602 printk(KERN_WARNING
"%s/0: video risc op code error\n",core
->name
);
1603 cx_clear(MO_VID_DMACNTRL
, 0x11);
1604 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1605 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1609 if (status
& 0x01) {
1610 spin_lock(&dev
->slock
);
1611 count
= cx_read(MO_VIDY_GPCNT
);
1612 cx88_wakeup(core
, &dev
->vidq
, count
);
1613 spin_unlock(&dev
->slock
);
1617 if (status
& 0x08) {
1618 spin_lock(&dev
->slock
);
1619 count
= cx_read(MO_VBI_GPCNT
);
1620 cx88_wakeup(core
, &dev
->vbiq
, count
);
1621 spin_unlock(&dev
->slock
);
1625 if (status
& 0x10) {
1626 dprintk(2,"stopper video\n");
1627 spin_lock(&dev
->slock
);
1628 restart_video_queue(dev
,&dev
->vidq
);
1629 spin_unlock(&dev
->slock
);
1633 if (status
& 0x80) {
1634 dprintk(2,"stopper vbi\n");
1635 spin_lock(&dev
->slock
);
1636 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
1637 spin_unlock(&dev
->slock
);
1641 static irqreturn_t
cx8800_irq(int irq
, void *dev_id
)
1643 struct cx8800_dev
*dev
= dev_id
;
1644 struct cx88_core
*core
= dev
->core
;
1646 int loop
, handled
= 0;
1648 for (loop
= 0; loop
< 10; loop
++) {
1649 status
= cx_read(MO_PCI_INTSTAT
) &
1650 (core
->pci_irqmask
| PCI_INT_VIDINT
);
1653 cx_write(MO_PCI_INTSTAT
, status
);
1656 if (status
& core
->pci_irqmask
)
1657 cx88_core_irq(core
,status
);
1658 if (status
& PCI_INT_VIDINT
)
1659 cx8800_vid_irq(dev
);
1662 printk(KERN_WARNING
"%s/0: irq loop -- clearing mask\n",
1664 cx_write(MO_PCI_INTMSK
,0);
1668 return IRQ_RETVAL(handled
);
1671 /* ----------------------------------------------------------- */
1672 /* exported stuff */
1674 static const struct v4l2_file_operations video_fops
=
1676 .owner
= THIS_MODULE
,
1678 .release
= video_release
,
1682 .ioctl
= video_ioctl2
,
1685 static const struct v4l2_ioctl_ops video_ioctl_ops
= {
1686 .vidioc_querycap
= vidioc_querycap
,
1687 .vidioc_enum_fmt_vid_cap
= vidioc_enum_fmt_vid_cap
,
1688 .vidioc_g_fmt_vid_cap
= vidioc_g_fmt_vid_cap
,
1689 .vidioc_try_fmt_vid_cap
= vidioc_try_fmt_vid_cap
,
1690 .vidioc_s_fmt_vid_cap
= vidioc_s_fmt_vid_cap
,
1691 .vidioc_g_fmt_vbi_cap
= cx8800_vbi_fmt
,
1692 .vidioc_try_fmt_vbi_cap
= cx8800_vbi_fmt
,
1693 .vidioc_s_fmt_vbi_cap
= cx8800_vbi_fmt
,
1694 .vidioc_reqbufs
= vidioc_reqbufs
,
1695 .vidioc_querybuf
= vidioc_querybuf
,
1696 .vidioc_qbuf
= vidioc_qbuf
,
1697 .vidioc_dqbuf
= vidioc_dqbuf
,
1698 .vidioc_s_std
= vidioc_s_std
,
1699 .vidioc_enum_input
= vidioc_enum_input
,
1700 .vidioc_g_input
= vidioc_g_input
,
1701 .vidioc_s_input
= vidioc_s_input
,
1702 .vidioc_queryctrl
= vidioc_queryctrl
,
1703 .vidioc_g_ctrl
= vidioc_g_ctrl
,
1704 .vidioc_s_ctrl
= vidioc_s_ctrl
,
1705 .vidioc_streamon
= vidioc_streamon
,
1706 .vidioc_streamoff
= vidioc_streamoff
,
1707 #ifdef CONFIG_VIDEO_V4L1_COMPAT
1708 .vidiocgmbuf
= vidiocgmbuf
,
1710 .vidioc_g_tuner
= vidioc_g_tuner
,
1711 .vidioc_s_tuner
= vidioc_s_tuner
,
1712 .vidioc_g_frequency
= vidioc_g_frequency
,
1713 .vidioc_s_frequency
= vidioc_s_frequency
,
1714 #ifdef CONFIG_VIDEO_ADV_DEBUG
1715 .vidioc_g_register
= vidioc_g_register
,
1716 .vidioc_s_register
= vidioc_s_register
,
1720 static struct video_device cx8800_vbi_template
;
1722 static struct video_device cx8800_video_template
= {
1723 .name
= "cx8800-video",
1724 .fops
= &video_fops
,
1725 .ioctl_ops
= &video_ioctl_ops
,
1726 .tvnorms
= CX88_NORMS
,
1727 .current_norm
= V4L2_STD_NTSC_M
,
1730 static const struct v4l2_file_operations radio_fops
=
1732 .owner
= THIS_MODULE
,
1734 .release
= video_release
,
1735 .ioctl
= video_ioctl2
,
1738 static const struct v4l2_ioctl_ops radio_ioctl_ops
= {
1739 .vidioc_querycap
= radio_querycap
,
1740 .vidioc_g_tuner
= radio_g_tuner
,
1741 .vidioc_enum_input
= radio_enum_input
,
1742 .vidioc_g_audio
= radio_g_audio
,
1743 .vidioc_s_tuner
= radio_s_tuner
,
1744 .vidioc_s_audio
= radio_s_audio
,
1745 .vidioc_s_input
= radio_s_input
,
1746 .vidioc_queryctrl
= radio_queryctrl
,
1747 .vidioc_g_ctrl
= vidioc_g_ctrl
,
1748 .vidioc_s_ctrl
= vidioc_s_ctrl
,
1749 .vidioc_g_frequency
= vidioc_g_frequency
,
1750 .vidioc_s_frequency
= vidioc_s_frequency
,
1751 #ifdef CONFIG_VIDEO_ADV_DEBUG
1752 .vidioc_g_register
= vidioc_g_register
,
1753 .vidioc_s_register
= vidioc_s_register
,
1757 static struct video_device cx8800_radio_template
= {
1758 .name
= "cx8800-radio",
1759 .fops
= &radio_fops
,
1760 .ioctl_ops
= &radio_ioctl_ops
,
1763 /* ----------------------------------------------------------- */
1765 static void cx8800_unregister_video(struct cx8800_dev
*dev
)
1767 if (dev
->radio_dev
) {
1768 if (video_is_registered(dev
->radio_dev
))
1769 video_unregister_device(dev
->radio_dev
);
1771 video_device_release(dev
->radio_dev
);
1772 dev
->radio_dev
= NULL
;
1775 if (video_is_registered(dev
->vbi_dev
))
1776 video_unregister_device(dev
->vbi_dev
);
1778 video_device_release(dev
->vbi_dev
);
1779 dev
->vbi_dev
= NULL
;
1781 if (dev
->video_dev
) {
1782 if (video_is_registered(dev
->video_dev
))
1783 video_unregister_device(dev
->video_dev
);
1785 video_device_release(dev
->video_dev
);
1786 dev
->video_dev
= NULL
;
1790 static int __devinit
cx8800_initdev(struct pci_dev
*pci_dev
,
1791 const struct pci_device_id
*pci_id
)
1793 struct cx8800_dev
*dev
;
1794 struct cx88_core
*core
;
1798 dev
= kzalloc(sizeof(*dev
),GFP_KERNEL
);
1804 if (pci_enable_device(pci_dev
)) {
1808 core
= cx88_core_get(dev
->pci
);
1815 /* print pci info */
1816 pci_read_config_byte(pci_dev
, PCI_CLASS_REVISION
, &dev
->pci_rev
);
1817 pci_read_config_byte(pci_dev
, PCI_LATENCY_TIMER
, &dev
->pci_lat
);
1818 printk(KERN_INFO
"%s/0: found at %s, rev: %d, irq: %d, "
1819 "latency: %d, mmio: 0x%llx\n", core
->name
,
1820 pci_name(pci_dev
), dev
->pci_rev
, pci_dev
->irq
,
1821 dev
->pci_lat
,(unsigned long long)pci_resource_start(pci_dev
,0));
1823 pci_set_master(pci_dev
);
1824 if (!pci_dma_supported(pci_dev
,DMA_BIT_MASK(32))) {
1825 printk("%s/0: Oops: no 32bit PCI DMA ???\n",core
->name
);
1830 /* Initialize VBI template */
1831 memcpy( &cx8800_vbi_template
, &cx8800_video_template
,
1832 sizeof(cx8800_vbi_template
) );
1833 strcpy(cx8800_vbi_template
.name
,"cx8800-vbi");
1835 /* initialize driver struct */
1836 spin_lock_init(&dev
->slock
);
1837 core
->tvnorm
= cx8800_video_template
.current_norm
;
1839 /* init video dma queues */
1840 INIT_LIST_HEAD(&dev
->vidq
.active
);
1841 INIT_LIST_HEAD(&dev
->vidq
.queued
);
1842 dev
->vidq
.timeout
.function
= cx8800_vid_timeout
;
1843 dev
->vidq
.timeout
.data
= (unsigned long)dev
;
1844 init_timer(&dev
->vidq
.timeout
);
1845 cx88_risc_stopper(dev
->pci
,&dev
->vidq
.stopper
,
1846 MO_VID_DMACNTRL
,0x11,0x00);
1848 /* init vbi dma queues */
1849 INIT_LIST_HEAD(&dev
->vbiq
.active
);
1850 INIT_LIST_HEAD(&dev
->vbiq
.queued
);
1851 dev
->vbiq
.timeout
.function
= cx8800_vbi_timeout
;
1852 dev
->vbiq
.timeout
.data
= (unsigned long)dev
;
1853 init_timer(&dev
->vbiq
.timeout
);
1854 cx88_risc_stopper(dev
->pci
,&dev
->vbiq
.stopper
,
1855 MO_VID_DMACNTRL
,0x88,0x00);
1858 err
= request_irq(pci_dev
->irq
, cx8800_irq
,
1859 IRQF_SHARED
| IRQF_DISABLED
, core
->name
, dev
);
1861 printk(KERN_ERR
"%s/0: can't get IRQ %d\n",
1862 core
->name
,pci_dev
->irq
);
1865 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
1867 /* load and configure helper modules */
1869 if (core
->board
.audio_chip
== V4L2_IDENT_WM8775
)
1870 v4l2_i2c_new_subdev(&core
->v4l2_dev
, &core
->i2c_adap
,
1871 "wm8775", "wm8775", 0x36 >> 1, NULL
);
1873 if (core
->board
.audio_chip
== V4L2_IDENT_TVAUDIO
) {
1874 /* This probes for a tda9874 as is used on some
1875 Pixelview Ultra boards. */
1876 v4l2_i2c_new_subdev(&core
->v4l2_dev
,
1878 "tvaudio", "tvaudio", 0, I2C_ADDRS(0xb0 >> 1));
1881 switch (core
->boardnr
) {
1882 case CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD
:
1883 case CX88_BOARD_DVICO_FUSIONHDTV_7_GOLD
: {
1884 static struct i2c_board_info rtc_info
= {
1885 I2C_BOARD_INFO("isl1208", 0x6f)
1888 request_module("rtc-isl1208");
1889 core
->i2c_rtc
= i2c_new_device(&core
->i2c_adap
, &rtc_info
);
1891 /* break intentionally omitted */
1892 case CX88_BOARD_DVICO_FUSIONHDTV_5_PCI_NANO
:
1893 request_module("ir-kbd-i2c");
1896 /* register v4l devices */
1897 dev
->video_dev
= cx88_vdev_init(core
,dev
->pci
,
1898 &cx8800_video_template
,"video");
1899 video_set_drvdata(dev
->video_dev
, dev
);
1900 err
= video_register_device(dev
->video_dev
,VFL_TYPE_GRABBER
,
1901 video_nr
[core
->nr
]);
1903 printk(KERN_ERR
"%s/0: can't register video device\n",
1907 printk(KERN_INFO
"%s/0: registered device %s [v4l2]\n",
1908 core
->name
, video_device_node_name(dev
->video_dev
));
1910 dev
->vbi_dev
= cx88_vdev_init(core
,dev
->pci
,&cx8800_vbi_template
,"vbi");
1911 video_set_drvdata(dev
->vbi_dev
, dev
);
1912 err
= video_register_device(dev
->vbi_dev
,VFL_TYPE_VBI
,
1915 printk(KERN_ERR
"%s/0: can't register vbi device\n",
1919 printk(KERN_INFO
"%s/0: registered device %s\n",
1920 core
->name
, video_device_node_name(dev
->vbi_dev
));
1922 if (core
->board
.radio
.type
== CX88_RADIO
) {
1923 dev
->radio_dev
= cx88_vdev_init(core
,dev
->pci
,
1924 &cx8800_radio_template
,"radio");
1925 video_set_drvdata(dev
->radio_dev
, dev
);
1926 err
= video_register_device(dev
->radio_dev
,VFL_TYPE_RADIO
,
1927 radio_nr
[core
->nr
]);
1929 printk(KERN_ERR
"%s/0: can't register radio device\n",
1933 printk(KERN_INFO
"%s/0: registered device %s\n",
1934 core
->name
, video_device_node_name(dev
->radio_dev
));
1937 /* everything worked */
1938 pci_set_drvdata(pci_dev
,dev
);
1940 /* initial device configuration */
1941 mutex_lock(&core
->lock
);
1942 cx88_set_tvnorm(core
,core
->tvnorm
);
1943 init_controls(core
);
1944 cx88_video_mux(core
,0);
1945 mutex_unlock(&core
->lock
);
1947 /* start tvaudio thread */
1948 if (core
->board
.tuner_type
!= TUNER_ABSENT
) {
1949 core
->kthread
= kthread_run(cx88_audio_thread
, core
, "cx88 tvaudio");
1950 if (IS_ERR(core
->kthread
)) {
1951 err
= PTR_ERR(core
->kthread
);
1952 printk(KERN_ERR
"%s/0: failed to create cx88 audio thread, err=%d\n",
1959 cx8800_unregister_video(dev
);
1960 free_irq(pci_dev
->irq
, dev
);
1962 cx88_core_put(core
,dev
->pci
);
1968 static void __devexit
cx8800_finidev(struct pci_dev
*pci_dev
)
1970 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
1971 struct cx88_core
*core
= dev
->core
;
1974 if (core
->kthread
) {
1975 kthread_stop(core
->kthread
);
1976 core
->kthread
= NULL
;
1980 cx88_ir_stop(core
, core
->ir
);
1982 cx88_shutdown(core
); /* FIXME */
1983 pci_disable_device(pci_dev
);
1985 /* unregister stuff */
1987 free_irq(pci_dev
->irq
, dev
);
1988 cx8800_unregister_video(dev
);
1989 pci_set_drvdata(pci_dev
, NULL
);
1992 btcx_riscmem_free(dev
->pci
,&dev
->vidq
.stopper
);
1993 cx88_core_put(core
,dev
->pci
);
1998 static int cx8800_suspend(struct pci_dev
*pci_dev
, pm_message_t state
)
2000 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
2001 struct cx88_core
*core
= dev
->core
;
2003 /* stop video+vbi capture */
2004 spin_lock(&dev
->slock
);
2005 if (!list_empty(&dev
->vidq
.active
)) {
2006 printk("%s/0: suspend video\n", core
->name
);
2007 stop_video_dma(dev
);
2008 del_timer(&dev
->vidq
.timeout
);
2010 if (!list_empty(&dev
->vbiq
.active
)) {
2011 printk("%s/0: suspend vbi\n", core
->name
);
2012 cx8800_stop_vbi_dma(dev
);
2013 del_timer(&dev
->vbiq
.timeout
);
2015 spin_unlock(&dev
->slock
);
2018 cx88_ir_stop(core
, core
->ir
);
2019 /* FIXME -- shutdown device */
2020 cx88_shutdown(core
);
2022 pci_save_state(pci_dev
);
2023 if (0 != pci_set_power_state(pci_dev
, pci_choose_state(pci_dev
, state
))) {
2024 pci_disable_device(pci_dev
);
2025 dev
->state
.disabled
= 1;
2030 static int cx8800_resume(struct pci_dev
*pci_dev
)
2032 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
2033 struct cx88_core
*core
= dev
->core
;
2036 if (dev
->state
.disabled
) {
2037 err
=pci_enable_device(pci_dev
);
2039 printk(KERN_ERR
"%s/0: can't enable device\n",
2044 dev
->state
.disabled
= 0;
2046 err
= pci_set_power_state(pci_dev
, PCI_D0
);
2048 printk(KERN_ERR
"%s/0: can't set power state\n", core
->name
);
2049 pci_disable_device(pci_dev
);
2050 dev
->state
.disabled
= 1;
2054 pci_restore_state(pci_dev
);
2056 /* FIXME: re-initialize hardware */
2059 cx88_ir_start(core
, core
->ir
);
2061 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
2063 /* restart video+vbi capture */
2064 spin_lock(&dev
->slock
);
2065 if (!list_empty(&dev
->vidq
.active
)) {
2066 printk("%s/0: resume video\n", core
->name
);
2067 restart_video_queue(dev
,&dev
->vidq
);
2069 if (!list_empty(&dev
->vbiq
.active
)) {
2070 printk("%s/0: resume vbi\n", core
->name
);
2071 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
2073 spin_unlock(&dev
->slock
);
2079 /* ----------------------------------------------------------- */
2081 static struct pci_device_id cx8800_pci_tbl
[] = {
2085 .subvendor
= PCI_ANY_ID
,
2086 .subdevice
= PCI_ANY_ID
,
2088 /* --- end of list --- */
2091 MODULE_DEVICE_TABLE(pci
, cx8800_pci_tbl
);
2093 static struct pci_driver cx8800_pci_driver
= {
2095 .id_table
= cx8800_pci_tbl
,
2096 .probe
= cx8800_initdev
,
2097 .remove
= __devexit_p(cx8800_finidev
),
2099 .suspend
= cx8800_suspend
,
2100 .resume
= cx8800_resume
,
2104 static int __init
cx8800_init(void)
2106 printk(KERN_INFO
"cx88/0: cx2388x v4l2 driver version %d.%d.%d loaded\n",
2107 (CX88_VERSION_CODE
>> 16) & 0xff,
2108 (CX88_VERSION_CODE
>> 8) & 0xff,
2109 CX88_VERSION_CODE
& 0xff);
2111 printk(KERN_INFO
"cx2388x: snapshot date %04d-%02d-%02d\n",
2112 SNAPSHOT
/10000, (SNAPSHOT
/100)%100, SNAPSHOT
%100);
2114 return pci_register_driver(&cx8800_pci_driver
);
2117 static void __exit
cx8800_fini(void)
2119 pci_unregister_driver(&cx8800_pci_driver
);
2122 module_init(cx8800_init
);
2123 module_exit(cx8800_fini
);
2125 /* ----------------------------------------------------------- */
2130 * kate: eol "unix"; indent-width 3; remove-trailing-space on; replace-trailing-space-save on; tab-width 8; replace-tabs off; space-indent off; mixed-indent off