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/interrupt.h>
35 #include <linux/dma-mapping.h>
36 #include <linux/delay.h>
37 #include <linux/kthread.h>
38 #include <asm/div64.h>
41 #include <media/v4l2-common.h>
42 #include <media/v4l2-ioctl.h>
44 #ifdef CONFIG_VIDEO_V4L1_COMPAT
45 /* Include V4L1 specific functions. Should be removed soon */
46 #include <linux/videodev.h>
49 MODULE_DESCRIPTION("v4l2 driver module for cx2388x based TV cards");
50 MODULE_AUTHOR("Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]");
51 MODULE_LICENSE("GPL");
53 /* ------------------------------------------------------------------ */
55 static unsigned int video_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
56 static unsigned int vbi_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
57 static unsigned int radio_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
59 module_param_array(video_nr
, int, NULL
, 0444);
60 module_param_array(vbi_nr
, int, NULL
, 0444);
61 module_param_array(radio_nr
, int, NULL
, 0444);
63 MODULE_PARM_DESC(video_nr
,"video device numbers");
64 MODULE_PARM_DESC(vbi_nr
,"vbi device numbers");
65 MODULE_PARM_DESC(radio_nr
,"radio device numbers");
67 static unsigned int video_debug
;
68 module_param(video_debug
,int,0644);
69 MODULE_PARM_DESC(video_debug
,"enable debug messages [video]");
71 static unsigned int irq_debug
;
72 module_param(irq_debug
,int,0644);
73 MODULE_PARM_DESC(irq_debug
,"enable debug messages [IRQ handler]");
75 static unsigned int vid_limit
= 16;
76 module_param(vid_limit
,int,0644);
77 MODULE_PARM_DESC(vid_limit
,"capture memory limit in megabytes");
79 #define dprintk(level,fmt, arg...) if (video_debug >= level) \
80 printk(KERN_DEBUG "%s/0: " fmt, core->name , ## arg)
82 /* ------------------------------------------------------------------ */
84 static LIST_HEAD(cx8800_devlist
);
86 /* ------------------------------------------------------------------- */
89 static struct cx8800_fmt formats
[] = {
91 .name
= "8 bpp, gray",
92 .fourcc
= V4L2_PIX_FMT_GREY
,
93 .cxformat
= ColorFormatY8
,
95 .flags
= FORMAT_FLAGS_PACKED
,
97 .name
= "15 bpp RGB, le",
98 .fourcc
= V4L2_PIX_FMT_RGB555
,
99 .cxformat
= ColorFormatRGB15
,
101 .flags
= FORMAT_FLAGS_PACKED
,
103 .name
= "15 bpp RGB, be",
104 .fourcc
= V4L2_PIX_FMT_RGB555X
,
105 .cxformat
= ColorFormatRGB15
| ColorFormatBSWAP
,
107 .flags
= FORMAT_FLAGS_PACKED
,
109 .name
= "16 bpp RGB, le",
110 .fourcc
= V4L2_PIX_FMT_RGB565
,
111 .cxformat
= ColorFormatRGB16
,
113 .flags
= FORMAT_FLAGS_PACKED
,
115 .name
= "16 bpp RGB, be",
116 .fourcc
= V4L2_PIX_FMT_RGB565X
,
117 .cxformat
= ColorFormatRGB16
| ColorFormatBSWAP
,
119 .flags
= FORMAT_FLAGS_PACKED
,
121 .name
= "24 bpp RGB, le",
122 .fourcc
= V4L2_PIX_FMT_BGR24
,
123 .cxformat
= ColorFormatRGB24
,
125 .flags
= FORMAT_FLAGS_PACKED
,
127 .name
= "32 bpp RGB, le",
128 .fourcc
= V4L2_PIX_FMT_BGR32
,
129 .cxformat
= ColorFormatRGB32
,
131 .flags
= FORMAT_FLAGS_PACKED
,
133 .name
= "32 bpp RGB, be",
134 .fourcc
= V4L2_PIX_FMT_RGB32
,
135 .cxformat
= ColorFormatRGB32
| ColorFormatBSWAP
| ColorFormatWSWAP
,
137 .flags
= FORMAT_FLAGS_PACKED
,
139 .name
= "4:2:2, packed, YUYV",
140 .fourcc
= V4L2_PIX_FMT_YUYV
,
141 .cxformat
= ColorFormatYUY2
,
143 .flags
= FORMAT_FLAGS_PACKED
,
145 .name
= "4:2:2, packed, UYVY",
146 .fourcc
= V4L2_PIX_FMT_UYVY
,
147 .cxformat
= ColorFormatYUY2
| ColorFormatBSWAP
,
149 .flags
= FORMAT_FLAGS_PACKED
,
153 static struct cx8800_fmt
* format_by_fourcc(unsigned int fourcc
)
157 for (i
= 0; i
< ARRAY_SIZE(formats
); i
++)
158 if (formats
[i
].fourcc
== fourcc
)
163 /* ------------------------------------------------------------------- */
165 static const struct v4l2_queryctrl no_ctl
= {
167 .flags
= V4L2_CTRL_FLAG_DISABLED
,
170 static struct cx88_ctrl cx8800_ctls
[] = {
174 .id
= V4L2_CID_BRIGHTNESS
,
175 .name
= "Brightness",
179 .default_value
= 0x7f,
180 .type
= V4L2_CTRL_TYPE_INTEGER
,
183 .reg
= MO_CONTR_BRIGHT
,
188 .id
= V4L2_CID_CONTRAST
,
193 .default_value
= 0x3f,
194 .type
= V4L2_CTRL_TYPE_INTEGER
,
197 .reg
= MO_CONTR_BRIGHT
,
207 .default_value
= 0x7f,
208 .type
= V4L2_CTRL_TYPE_INTEGER
,
215 /* strictly, this only describes only U saturation.
216 * V saturation is handled specially through code.
219 .id
= V4L2_CID_SATURATION
,
220 .name
= "Saturation",
224 .default_value
= 0x7f,
225 .type
= V4L2_CTRL_TYPE_INTEGER
,
228 .reg
= MO_UV_SATURATION
,
233 .id
= V4L2_CID_CHROMA_AGC
,
234 .name
= "Chroma AGC",
237 .default_value
= 0x1,
238 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
240 .reg
= MO_INPUT_FORMAT
,
245 .id
= V4L2_CID_COLOR_KILLER
,
246 .name
= "Color killer",
249 .default_value
= 0x1,
250 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
252 .reg
= MO_INPUT_FORMAT
,
258 .id
= V4L2_CID_AUDIO_MUTE
,
263 .type
= V4L2_CTRL_TYPE_BOOLEAN
,
266 .sreg
= SHADOW_AUD_VOL_CTL
,
271 .id
= V4L2_CID_AUDIO_VOLUME
,
276 .default_value
= 0x3f,
277 .type
= V4L2_CTRL_TYPE_INTEGER
,
280 .sreg
= SHADOW_AUD_VOL_CTL
,
285 .id
= V4L2_CID_AUDIO_BALANCE
,
290 .default_value
= 0x40,
291 .type
= V4L2_CTRL_TYPE_INTEGER
,
294 .sreg
= SHADOW_AUD_BAL_CTL
,
299 static const int CX8800_CTLS
= ARRAY_SIZE(cx8800_ctls
);
301 const u32 cx88_user_ctrls
[] = {
307 V4L2_CID_AUDIO_VOLUME
,
308 V4L2_CID_AUDIO_BALANCE
,
311 V4L2_CID_COLOR_KILLER
,
314 EXPORT_SYMBOL(cx88_user_ctrls
);
316 static const u32
*ctrl_classes
[] = {
321 int cx8800_ctrl_query(struct cx88_core
*core
, struct v4l2_queryctrl
*qctrl
)
325 if (qctrl
->id
< V4L2_CID_BASE
||
326 qctrl
->id
>= V4L2_CID_LASTP1
)
328 for (i
= 0; i
< CX8800_CTLS
; i
++)
329 if (cx8800_ctls
[i
].v
.id
== qctrl
->id
)
331 if (i
== CX8800_CTLS
) {
335 *qctrl
= cx8800_ctls
[i
].v
;
336 /* Report chroma AGC as inactive when SECAM is selected */
337 if (cx8800_ctls
[i
].v
.id
== V4L2_CID_CHROMA_AGC
&&
338 core
->tvnorm
& V4L2_STD_SECAM
)
339 qctrl
->flags
|= V4L2_CTRL_FLAG_INACTIVE
;
343 EXPORT_SYMBOL(cx8800_ctrl_query
);
345 /* ------------------------------------------------------------------- */
346 /* resource management */
348 static int res_get(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bit
)
350 struct cx88_core
*core
= dev
->core
;
351 if (fh
->resources
& bit
)
352 /* have it already allocated */
356 mutex_lock(&core
->lock
);
357 if (dev
->resources
& bit
) {
358 /* no, someone else uses it */
359 mutex_unlock(&core
->lock
);
362 /* it's free, grab it */
363 fh
->resources
|= bit
;
364 dev
->resources
|= bit
;
365 dprintk(1,"res: get %d\n",bit
);
366 mutex_unlock(&core
->lock
);
371 int res_check(struct cx8800_fh
*fh
, unsigned int bit
)
373 return (fh
->resources
& bit
);
377 int res_locked(struct cx8800_dev
*dev
, unsigned int bit
)
379 return (dev
->resources
& bit
);
383 void res_free(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bits
)
385 struct cx88_core
*core
= dev
->core
;
386 BUG_ON((fh
->resources
& bits
) != bits
);
388 mutex_lock(&core
->lock
);
389 fh
->resources
&= ~bits
;
390 dev
->resources
&= ~bits
;
391 dprintk(1,"res: put %d\n",bits
);
392 mutex_unlock(&core
->lock
);
395 /* ------------------------------------------------------------------ */
397 int cx88_video_mux(struct cx88_core
*core
, unsigned int input
)
399 /* struct cx88_core *core = dev->core; */
401 dprintk(1,"video_mux: %d [vmux=%d,gpio=0x%x,0x%x,0x%x,0x%x]\n",
402 input
, INPUT(input
).vmux
,
403 INPUT(input
).gpio0
,INPUT(input
).gpio1
,
404 INPUT(input
).gpio2
,INPUT(input
).gpio3
);
406 cx_andor(MO_INPUT_FORMAT
, 0x03 << 14, INPUT(input
).vmux
<< 14);
407 cx_write(MO_GP3_IO
, INPUT(input
).gpio3
);
408 cx_write(MO_GP0_IO
, INPUT(input
).gpio0
);
409 cx_write(MO_GP1_IO
, INPUT(input
).gpio1
);
410 cx_write(MO_GP2_IO
, INPUT(input
).gpio2
);
412 switch (INPUT(input
).type
) {
413 case CX88_VMUX_SVIDEO
:
414 cx_set(MO_AFECFG_IO
, 0x00000001);
415 cx_set(MO_INPUT_FORMAT
, 0x00010010);
416 cx_set(MO_FILTER_EVEN
, 0x00002020);
417 cx_set(MO_FILTER_ODD
, 0x00002020);
420 cx_clear(MO_AFECFG_IO
, 0x00000001);
421 cx_clear(MO_INPUT_FORMAT
, 0x00010010);
422 cx_clear(MO_FILTER_EVEN
, 0x00002020);
423 cx_clear(MO_FILTER_ODD
, 0x00002020);
427 /* if there are audioroutes defined, we have an external
428 ADC to deal with audio */
429 if (INPUT(input
).audioroute
) {
430 /* The wm8775 module has the "2" route hardwired into
431 the initialization. Some boards may use different
432 routes for different inputs. HVR-1300 surely does */
433 if (core
->board
.audio_chip
&&
434 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
435 struct v4l2_routing route
;
437 route
.input
= INPUT(input
).audioroute
;
438 cx88_call_i2c_clients(core
,
439 VIDIOC_INT_S_AUDIO_ROUTING
, &route
);
441 /* cx2388's C-ADC is connected to the tuner only.
442 When used with S-Video, that ADC is busy dealing with
443 chroma, so an external must be used for baseband audio */
444 if (INPUT(input
).type
!= CX88_VMUX_TELEVISION
) {
446 core
->tvaudio
= WW_I2SADC
;
447 cx88_set_tvaudio(core
);
450 cx_write(AUD_I2SCNTL
, 0x0);
451 cx_clear(AUD_CTL
, EN_I2SIN_ENABLE
);
457 EXPORT_SYMBOL(cx88_video_mux
);
459 /* ------------------------------------------------------------------ */
461 static int start_video_dma(struct cx8800_dev
*dev
,
462 struct cx88_dmaqueue
*q
,
463 struct cx88_buffer
*buf
)
465 struct cx88_core
*core
= dev
->core
;
467 /* setup fifo + format */
468 cx88_sram_channel_setup(core
, &cx88_sram_channels
[SRAM_CH21
],
469 buf
->bpl
, buf
->risc
.dma
);
470 cx88_set_scale(core
, buf
->vb
.width
, buf
->vb
.height
, buf
->vb
.field
);
471 cx_write(MO_COLOR_CTRL
, buf
->fmt
->cxformat
| ColorFormatGamma
);
474 cx_write(MO_VIDY_GPCNTRL
,GP_COUNT_CONTROL_RESET
);
478 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
| PCI_INT_VIDINT
);
480 /* Enables corresponding bits at PCI_INT_STAT:
481 bits 0 to 4: video, audio, transport stream, VIP, Host
483 bits 8 and 9: DMA complete for: SRC, DST
484 bits 10 and 11: BERR signal asserted for RISC: RD, WR
485 bits 12 to 15: BERR signal asserted for: BRDG, SRC, DST, IPB
487 cx_set(MO_VID_INTMSK
, 0x0f0011);
490 cx_set(VID_CAPTURE_CONTROL
,0x06);
493 cx_set(MO_DEV_CNTRL2
, (1<<5));
494 cx_set(MO_VID_DMACNTRL
, 0x11); /* Planar Y and packed FIFO and RISC enable */
500 static int stop_video_dma(struct cx8800_dev
*dev
)
502 struct cx88_core
*core
= dev
->core
;
505 cx_clear(MO_VID_DMACNTRL
, 0x11);
507 /* disable capture */
508 cx_clear(VID_CAPTURE_CONTROL
,0x06);
511 cx_clear(MO_PCI_INTMSK
, PCI_INT_VIDINT
);
512 cx_clear(MO_VID_INTMSK
, 0x0f0011);
517 static int restart_video_queue(struct cx8800_dev
*dev
,
518 struct cx88_dmaqueue
*q
)
520 struct cx88_core
*core
= dev
->core
;
521 struct cx88_buffer
*buf
, *prev
;
523 if (!list_empty(&q
->active
)) {
524 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
525 dprintk(2,"restart_queue [%p/%d]: restart dma\n",
527 start_video_dma(dev
, q
, buf
);
528 list_for_each_entry(buf
, &q
->active
, vb
.queue
)
529 buf
->count
= q
->count
++;
530 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
536 if (list_empty(&q
->queued
))
538 buf
= list_entry(q
->queued
.next
, struct cx88_buffer
, vb
.queue
);
540 list_move_tail(&buf
->vb
.queue
, &q
->active
);
541 start_video_dma(dev
, q
, buf
);
542 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
543 buf
->count
= q
->count
++;
544 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
545 dprintk(2,"[%p/%d] restart_queue - first active\n",
548 } else if (prev
->vb
.width
== buf
->vb
.width
&&
549 prev
->vb
.height
== buf
->vb
.height
&&
550 prev
->fmt
== buf
->fmt
) {
551 list_move_tail(&buf
->vb
.queue
, &q
->active
);
552 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
553 buf
->count
= q
->count
++;
554 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
555 dprintk(2,"[%p/%d] restart_queue - move to active\n",
564 /* ------------------------------------------------------------------ */
567 buffer_setup(struct videobuf_queue
*q
, unsigned int *count
, unsigned int *size
)
569 struct cx8800_fh
*fh
= q
->priv_data
;
571 *size
= fh
->fmt
->depth
*fh
->width
*fh
->height
>> 3;
574 while (*size
* *count
> vid_limit
* 1024 * 1024)
580 buffer_prepare(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
,
581 enum v4l2_field field
)
583 struct cx8800_fh
*fh
= q
->priv_data
;
584 struct cx8800_dev
*dev
= fh
->dev
;
585 struct cx88_core
*core
= dev
->core
;
586 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
587 struct videobuf_dmabuf
*dma
=videobuf_to_dma(&buf
->vb
);
588 int rc
, init_buffer
= 0;
590 BUG_ON(NULL
== fh
->fmt
);
591 if (fh
->width
< 48 || fh
->width
> norm_maxw(core
->tvnorm
) ||
592 fh
->height
< 32 || fh
->height
> norm_maxh(core
->tvnorm
))
594 buf
->vb
.size
= (fh
->width
* fh
->height
* fh
->fmt
->depth
) >> 3;
595 if (0 != buf
->vb
.baddr
&& buf
->vb
.bsize
< buf
->vb
.size
)
598 if (buf
->fmt
!= fh
->fmt
||
599 buf
->vb
.width
!= fh
->width
||
600 buf
->vb
.height
!= fh
->height
||
601 buf
->vb
.field
!= field
) {
603 buf
->vb
.width
= fh
->width
;
604 buf
->vb
.height
= fh
->height
;
605 buf
->vb
.field
= field
;
609 if (VIDEOBUF_NEEDS_INIT
== buf
->vb
.state
) {
611 if (0 != (rc
= videobuf_iolock(q
,&buf
->vb
,NULL
)))
616 buf
->bpl
= buf
->vb
.width
* buf
->fmt
->depth
>> 3;
617 switch (buf
->vb
.field
) {
619 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
620 dma
->sglist
, 0, UNSET
,
621 buf
->bpl
, 0, buf
->vb
.height
);
623 case V4L2_FIELD_BOTTOM
:
624 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
625 dma
->sglist
, UNSET
, 0,
626 buf
->bpl
, 0, buf
->vb
.height
);
628 case V4L2_FIELD_INTERLACED
:
629 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
630 dma
->sglist
, 0, buf
->bpl
,
632 buf
->vb
.height
>> 1);
634 case V4L2_FIELD_SEQ_TB
:
635 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
637 0, buf
->bpl
* (buf
->vb
.height
>> 1),
639 buf
->vb
.height
>> 1);
641 case V4L2_FIELD_SEQ_BT
:
642 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
644 buf
->bpl
* (buf
->vb
.height
>> 1), 0,
646 buf
->vb
.height
>> 1);
652 dprintk(2,"[%p/%d] buffer_prepare - %dx%d %dbpp \"%s\" - dma=0x%08lx\n",
654 fh
->width
, fh
->height
, fh
->fmt
->depth
, fh
->fmt
->name
,
655 (unsigned long)buf
->risc
.dma
);
657 buf
->vb
.state
= VIDEOBUF_PREPARED
;
661 cx88_free_buffer(q
,buf
);
666 buffer_queue(struct videobuf_queue
*vq
, struct videobuf_buffer
*vb
)
668 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
669 struct cx88_buffer
*prev
;
670 struct cx8800_fh
*fh
= vq
->priv_data
;
671 struct cx8800_dev
*dev
= fh
->dev
;
672 struct cx88_core
*core
= dev
->core
;
673 struct cx88_dmaqueue
*q
= &dev
->vidq
;
675 /* add jump to stopper */
676 buf
->risc
.jmp
[0] = cpu_to_le32(RISC_JUMP
| RISC_IRQ1
| RISC_CNT_INC
);
677 buf
->risc
.jmp
[1] = cpu_to_le32(q
->stopper
.dma
);
679 if (!list_empty(&q
->queued
)) {
680 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
681 buf
->vb
.state
= VIDEOBUF_QUEUED
;
682 dprintk(2,"[%p/%d] buffer_queue - append to queued\n",
685 } else if (list_empty(&q
->active
)) {
686 list_add_tail(&buf
->vb
.queue
,&q
->active
);
687 start_video_dma(dev
, q
, buf
);
688 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
689 buf
->count
= q
->count
++;
690 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
691 dprintk(2,"[%p/%d] buffer_queue - first active\n",
695 prev
= list_entry(q
->active
.prev
, struct cx88_buffer
, vb
.queue
);
696 if (prev
->vb
.width
== buf
->vb
.width
&&
697 prev
->vb
.height
== buf
->vb
.height
&&
698 prev
->fmt
== buf
->fmt
) {
699 list_add_tail(&buf
->vb
.queue
,&q
->active
);
700 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
701 buf
->count
= q
->count
++;
702 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
703 dprintk(2,"[%p/%d] buffer_queue - append to active\n",
707 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
708 buf
->vb
.state
= VIDEOBUF_QUEUED
;
709 dprintk(2,"[%p/%d] buffer_queue - first queued\n",
715 static void buffer_release(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
)
717 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
719 cx88_free_buffer(q
,buf
);
722 static struct videobuf_queue_ops cx8800_video_qops
= {
723 .buf_setup
= buffer_setup
,
724 .buf_prepare
= buffer_prepare
,
725 .buf_queue
= buffer_queue
,
726 .buf_release
= buffer_release
,
729 /* ------------------------------------------------------------------ */
732 /* ------------------------------------------------------------------ */
734 static struct videobuf_queue
* get_queue(struct cx8800_fh
*fh
)
737 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
739 case V4L2_BUF_TYPE_VBI_CAPTURE
:
747 static int get_ressource(struct cx8800_fh
*fh
)
750 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
751 return RESOURCE_VIDEO
;
752 case V4L2_BUF_TYPE_VBI_CAPTURE
:
760 static int video_open(struct file
*file
)
762 int minor
= video_devdata(file
)->minor
;
763 struct cx8800_dev
*h
,*dev
= NULL
;
764 struct cx88_core
*core
;
765 struct cx8800_fh
*fh
;
766 enum v4l2_buf_type type
= 0;
770 list_for_each_entry(h
, &cx8800_devlist
, devlist
) {
771 if (h
->video_dev
->minor
== minor
) {
773 type
= V4L2_BUF_TYPE_VIDEO_CAPTURE
;
775 if (h
->vbi_dev
->minor
== minor
) {
777 type
= V4L2_BUF_TYPE_VBI_CAPTURE
;
780 h
->radio_dev
->minor
== minor
) {
792 dprintk(1,"open minor=%d radio=%d type=%s\n",
793 minor
,radio
,v4l2_type_names
[type
]);
795 /* allocate + initialize per filehandle data */
796 fh
= kzalloc(sizeof(*fh
),GFP_KERNEL
);
801 file
->private_data
= fh
;
807 fh
->fmt
= format_by_fourcc(V4L2_PIX_FMT_BGR24
);
809 videobuf_queue_sg_init(&fh
->vidq
, &cx8800_video_qops
,
810 &dev
->pci
->dev
, &dev
->slock
,
811 V4L2_BUF_TYPE_VIDEO_CAPTURE
,
812 V4L2_FIELD_INTERLACED
,
813 sizeof(struct cx88_buffer
),
815 videobuf_queue_sg_init(&fh
->vbiq
, &cx8800_vbi_qops
,
816 &dev
->pci
->dev
, &dev
->slock
,
817 V4L2_BUF_TYPE_VBI_CAPTURE
,
819 sizeof(struct cx88_buffer
),
823 dprintk(1,"video_open: setting radio device\n");
824 cx_write(MO_GP3_IO
, core
->board
.radio
.gpio3
);
825 cx_write(MO_GP0_IO
, core
->board
.radio
.gpio0
);
826 cx_write(MO_GP1_IO
, core
->board
.radio
.gpio1
);
827 cx_write(MO_GP2_IO
, core
->board
.radio
.gpio2
);
828 if (core
->board
.radio
.audioroute
) {
829 if(core
->board
.audio_chip
&&
830 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
831 struct v4l2_routing route
;
833 route
.input
= core
->board
.radio
.audioroute
;
834 cx88_call_i2c_clients(core
,
835 VIDIOC_INT_S_AUDIO_ROUTING
, &route
);
838 core
->tvaudio
= WW_I2SADC
;
839 cx88_set_tvaudio(core
);
842 core
->tvaudio
= WW_FM
;
843 cx88_set_tvaudio(core
);
844 cx88_set_stereo(core
,V4L2_TUNER_MODE_STEREO
,1);
846 cx88_call_i2c_clients(core
,AUDC_SET_RADIO
,NULL
);
850 atomic_inc(&core
->users
);
856 video_read(struct file
*file
, char __user
*data
, size_t count
, loff_t
*ppos
)
858 struct cx8800_fh
*fh
= file
->private_data
;
861 case V4L2_BUF_TYPE_VIDEO_CAPTURE
:
862 if (res_locked(fh
->dev
,RESOURCE_VIDEO
))
864 return videobuf_read_one(&fh
->vidq
, data
, count
, ppos
,
865 file
->f_flags
& O_NONBLOCK
);
866 case V4L2_BUF_TYPE_VBI_CAPTURE
:
867 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
869 return videobuf_read_stream(&fh
->vbiq
, data
, count
, ppos
, 1,
870 file
->f_flags
& O_NONBLOCK
);
878 video_poll(struct file
*file
, struct poll_table_struct
*wait
)
880 struct cx8800_fh
*fh
= file
->private_data
;
881 struct cx88_buffer
*buf
;
883 if (V4L2_BUF_TYPE_VBI_CAPTURE
== fh
->type
) {
884 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
886 return videobuf_poll_stream(file
, &fh
->vbiq
, wait
);
889 if (res_check(fh
,RESOURCE_VIDEO
)) {
890 /* streaming capture */
891 if (list_empty(&fh
->vidq
.stream
))
893 buf
= list_entry(fh
->vidq
.stream
.next
,struct cx88_buffer
,vb
.stream
);
896 buf
= (struct cx88_buffer
*)fh
->vidq
.read_buf
;
900 poll_wait(file
, &buf
->vb
.done
, wait
);
901 if (buf
->vb
.state
== VIDEOBUF_DONE
||
902 buf
->vb
.state
== VIDEOBUF_ERROR
)
903 return POLLIN
|POLLRDNORM
;
907 static int video_release(struct file
*file
)
909 struct cx8800_fh
*fh
= file
->private_data
;
910 struct cx8800_dev
*dev
= fh
->dev
;
912 /* turn off overlay */
913 if (res_check(fh
, RESOURCE_OVERLAY
)) {
915 res_free(dev
,fh
,RESOURCE_OVERLAY
);
918 /* stop video capture */
919 if (res_check(fh
, RESOURCE_VIDEO
)) {
920 videobuf_queue_cancel(&fh
->vidq
);
921 res_free(dev
,fh
,RESOURCE_VIDEO
);
923 if (fh
->vidq
.read_buf
) {
924 buffer_release(&fh
->vidq
,fh
->vidq
.read_buf
);
925 kfree(fh
->vidq
.read_buf
);
928 /* stop vbi capture */
929 if (res_check(fh
, RESOURCE_VBI
)) {
930 videobuf_stop(&fh
->vbiq
);
931 res_free(dev
,fh
,RESOURCE_VBI
);
934 videobuf_mmap_free(&fh
->vidq
);
935 videobuf_mmap_free(&fh
->vbiq
);
936 file
->private_data
= NULL
;
939 if(atomic_dec_and_test(&dev
->core
->users
))
940 cx88_call_i2c_clients (dev
->core
, TUNER_SET_STANDBY
, NULL
);
946 video_mmap(struct file
*file
, struct vm_area_struct
* vma
)
948 struct cx8800_fh
*fh
= file
->private_data
;
950 return videobuf_mmap_mapper(get_queue(fh
), vma
);
953 /* ------------------------------------------------------------------ */
954 /* VIDEO CTRL IOCTLS */
956 int cx88_get_control (struct cx88_core
*core
, struct v4l2_control
*ctl
)
958 struct cx88_ctrl
*c
= NULL
;
962 for (i
= 0; i
< CX8800_CTLS
; i
++)
963 if (cx8800_ctls
[i
].v
.id
== ctl
->id
)
965 if (unlikely(NULL
== c
))
968 value
= c
->sreg
? cx_sread(c
->sreg
) : cx_read(c
->reg
);
970 case V4L2_CID_AUDIO_BALANCE
:
971 ctl
->value
= ((value
& 0x7f) < 0x40) ? ((value
& 0x7f) + 0x40)
972 : (0x7f - (value
& 0x7f));
974 case V4L2_CID_AUDIO_VOLUME
:
975 ctl
->value
= 0x3f - (value
& 0x3f);
978 ctl
->value
= ((value
+ (c
->off
<< c
->shift
)) & c
->mask
) >> c
->shift
;
981 dprintk(1,"get_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
982 ctl
->id
, c
->v
.name
, ctl
->value
, c
->reg
,
983 value
,c
->mask
, c
->sreg
? " [shadowed]" : "");
986 EXPORT_SYMBOL(cx88_get_control
);
988 int cx88_set_control(struct cx88_core
*core
, struct v4l2_control
*ctl
)
990 struct cx88_ctrl
*c
= NULL
;
994 for (i
= 0; i
< CX8800_CTLS
; i
++) {
995 if (cx8800_ctls
[i
].v
.id
== ctl
->id
) {
999 if (unlikely(NULL
== c
))
1002 if (ctl
->value
< c
->v
.minimum
)
1003 ctl
->value
= c
->v
.minimum
;
1004 if (ctl
->value
> c
->v
.maximum
)
1005 ctl
->value
= c
->v
.maximum
;
1008 case V4L2_CID_AUDIO_BALANCE
:
1009 value
= (ctl
->value
< 0x40) ? (0x7f - ctl
->value
) : (ctl
->value
- 0x40);
1011 case V4L2_CID_AUDIO_VOLUME
:
1012 value
= 0x3f - (ctl
->value
& 0x3f);
1014 case V4L2_CID_SATURATION
:
1015 /* special v_sat handling */
1017 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1019 if (core
->tvnorm
& V4L2_STD_SECAM
) {
1020 /* For SECAM, both U and V sat should be equal */
1021 value
=value
<<8|value
;
1023 /* Keeps U Saturation proportional to V Sat */
1024 value
=(value
*0x5a)/0x7f<<8|value
;
1028 case V4L2_CID_CHROMA_AGC
:
1029 /* Do not allow chroma AGC to be enabled for SECAM */
1030 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1031 if (core
->tvnorm
& V4L2_STD_SECAM
&& value
)
1035 value
= ((ctl
->value
- c
->off
) << c
->shift
) & c
->mask
;
1038 dprintk(1,"set_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
1039 ctl
->id
, c
->v
.name
, ctl
->value
, c
->reg
, value
,
1040 mask
, c
->sreg
? " [shadowed]" : "");
1042 cx_sandor(c
->sreg
, c
->reg
, mask
, value
);
1044 cx_andor(c
->reg
, mask
, value
);
1048 EXPORT_SYMBOL(cx88_set_control
);
1050 static void init_controls(struct cx88_core
*core
)
1052 struct v4l2_control ctrl
;
1055 for (i
= 0; i
< CX8800_CTLS
; i
++) {
1056 ctrl
.id
=cx8800_ctls
[i
].v
.id
;
1057 ctrl
.value
=cx8800_ctls
[i
].v
.default_value
;
1059 cx88_set_control(core
, &ctrl
);
1063 /* ------------------------------------------------------------------ */
1066 static int vidioc_g_fmt_vid_cap(struct file
*file
, void *priv
,
1067 struct v4l2_format
*f
)
1069 struct cx8800_fh
*fh
= priv
;
1071 f
->fmt
.pix
.width
= fh
->width
;
1072 f
->fmt
.pix
.height
= fh
->height
;
1073 f
->fmt
.pix
.field
= fh
->vidq
.field
;
1074 f
->fmt
.pix
.pixelformat
= fh
->fmt
->fourcc
;
1075 f
->fmt
.pix
.bytesperline
=
1076 (f
->fmt
.pix
.width
* fh
->fmt
->depth
) >> 3;
1077 f
->fmt
.pix
.sizeimage
=
1078 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1082 static int vidioc_try_fmt_vid_cap(struct file
*file
, void *priv
,
1083 struct v4l2_format
*f
)
1085 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1086 struct cx8800_fmt
*fmt
;
1087 enum v4l2_field field
;
1088 unsigned int maxw
, maxh
;
1090 fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1094 field
= f
->fmt
.pix
.field
;
1095 maxw
= norm_maxw(core
->tvnorm
);
1096 maxh
= norm_maxh(core
->tvnorm
);
1098 if (V4L2_FIELD_ANY
== field
) {
1099 field
= (f
->fmt
.pix
.height
> maxh
/2)
1100 ? V4L2_FIELD_INTERLACED
1101 : V4L2_FIELD_BOTTOM
;
1105 case V4L2_FIELD_TOP
:
1106 case V4L2_FIELD_BOTTOM
:
1109 case V4L2_FIELD_INTERLACED
:
1115 f
->fmt
.pix
.field
= field
;
1116 if (f
->fmt
.pix
.height
< 32)
1117 f
->fmt
.pix
.height
= 32;
1118 if (f
->fmt
.pix
.height
> maxh
)
1119 f
->fmt
.pix
.height
= maxh
;
1120 if (f
->fmt
.pix
.width
< 48)
1121 f
->fmt
.pix
.width
= 48;
1122 if (f
->fmt
.pix
.width
> maxw
)
1123 f
->fmt
.pix
.width
= maxw
;
1124 f
->fmt
.pix
.width
&= ~0x03;
1125 f
->fmt
.pix
.bytesperline
=
1126 (f
->fmt
.pix
.width
* fmt
->depth
) >> 3;
1127 f
->fmt
.pix
.sizeimage
=
1128 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1133 static int vidioc_s_fmt_vid_cap(struct file
*file
, void *priv
,
1134 struct v4l2_format
*f
)
1136 struct cx8800_fh
*fh
= priv
;
1137 int err
= vidioc_try_fmt_vid_cap (file
,priv
,f
);
1141 fh
->fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1142 fh
->width
= f
->fmt
.pix
.width
;
1143 fh
->height
= f
->fmt
.pix
.height
;
1144 fh
->vidq
.field
= f
->fmt
.pix
.field
;
1148 static int vidioc_querycap (struct file
*file
, void *priv
,
1149 struct v4l2_capability
*cap
)
1151 struct cx8800_dev
*dev
= ((struct cx8800_fh
*)priv
)->dev
;
1152 struct cx88_core
*core
= dev
->core
;
1154 strcpy(cap
->driver
, "cx8800");
1155 strlcpy(cap
->card
, core
->board
.name
, sizeof(cap
->card
));
1156 sprintf(cap
->bus_info
,"PCI:%s",pci_name(dev
->pci
));
1157 cap
->version
= CX88_VERSION_CODE
;
1159 V4L2_CAP_VIDEO_CAPTURE
|
1160 V4L2_CAP_READWRITE
|
1161 V4L2_CAP_STREAMING
|
1162 V4L2_CAP_VBI_CAPTURE
;
1163 if (UNSET
!= core
->board
.tuner_type
)
1164 cap
->capabilities
|= V4L2_CAP_TUNER
;
1168 static int vidioc_enum_fmt_vid_cap (struct file
*file
, void *priv
,
1169 struct v4l2_fmtdesc
*f
)
1171 if (unlikely(f
->index
>= ARRAY_SIZE(formats
)))
1174 strlcpy(f
->description
,formats
[f
->index
].name
,sizeof(f
->description
));
1175 f
->pixelformat
= formats
[f
->index
].fourcc
;
1180 #ifdef CONFIG_VIDEO_V4L1_COMPAT
1181 static int vidiocgmbuf (struct file
*file
, void *priv
, struct video_mbuf
*mbuf
)
1183 struct cx8800_fh
*fh
= priv
;
1185 return videobuf_cgmbuf (get_queue(fh
), mbuf
, 8);
1189 static int vidioc_reqbufs (struct file
*file
, void *priv
, struct v4l2_requestbuffers
*p
)
1191 struct cx8800_fh
*fh
= priv
;
1192 return (videobuf_reqbufs(get_queue(fh
), p
));
1195 static int vidioc_querybuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1197 struct cx8800_fh
*fh
= priv
;
1198 return (videobuf_querybuf(get_queue(fh
), p
));
1201 static int vidioc_qbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1203 struct cx8800_fh
*fh
= priv
;
1204 return (videobuf_qbuf(get_queue(fh
), p
));
1207 static int vidioc_dqbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1209 struct cx8800_fh
*fh
= priv
;
1210 return (videobuf_dqbuf(get_queue(fh
), p
,
1211 file
->f_flags
& O_NONBLOCK
));
1214 static int vidioc_streamon(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1216 struct cx8800_fh
*fh
= priv
;
1217 struct cx8800_dev
*dev
= fh
->dev
;
1219 /* We should remember that this driver also supports teletext, */
1220 /* so we have to test if the v4l2_buf_type is VBI capture data. */
1221 if (unlikely((fh
->type
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) &&
1222 (fh
->type
!= V4L2_BUF_TYPE_VBI_CAPTURE
)))
1225 if (unlikely(i
!= fh
->type
))
1228 if (unlikely(!res_get(dev
,fh
,get_ressource(fh
))))
1230 return videobuf_streamon(get_queue(fh
));
1233 static int vidioc_streamoff(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1235 struct cx8800_fh
*fh
= priv
;
1236 struct cx8800_dev
*dev
= fh
->dev
;
1239 if ((fh
->type
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) &&
1240 (fh
->type
!= V4L2_BUF_TYPE_VBI_CAPTURE
))
1246 res
= get_ressource(fh
);
1247 err
= videobuf_streamoff(get_queue(fh
));
1250 res_free(dev
,fh
,res
);
1254 static int vidioc_s_std (struct file
*file
, void *priv
, v4l2_std_id
*tvnorms
)
1256 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1258 mutex_lock(&core
->lock
);
1259 cx88_set_tvnorm(core
,*tvnorms
);
1260 mutex_unlock(&core
->lock
);
1265 /* only one input in this sample driver */
1266 int cx88_enum_input (struct cx88_core
*core
,struct v4l2_input
*i
)
1268 static const char *iname
[] = {
1269 [ CX88_VMUX_COMPOSITE1
] = "Composite1",
1270 [ CX88_VMUX_COMPOSITE2
] = "Composite2",
1271 [ CX88_VMUX_COMPOSITE3
] = "Composite3",
1272 [ CX88_VMUX_COMPOSITE4
] = "Composite4",
1273 [ CX88_VMUX_SVIDEO
] = "S-Video",
1274 [ CX88_VMUX_TELEVISION
] = "Television",
1275 [ CX88_VMUX_CABLE
] = "Cable TV",
1276 [ CX88_VMUX_DVB
] = "DVB",
1277 [ CX88_VMUX_DEBUG
] = "for debug only",
1284 if (0 == INPUT(n
).type
)
1286 memset(i
,0,sizeof(*i
));
1288 i
->type
= V4L2_INPUT_TYPE_CAMERA
;
1289 strcpy(i
->name
,iname
[INPUT(n
).type
]);
1290 if ((CX88_VMUX_TELEVISION
== INPUT(n
).type
) ||
1291 (CX88_VMUX_CABLE
== INPUT(n
).type
))
1292 i
->type
= V4L2_INPUT_TYPE_TUNER
;
1293 i
->std
= CX88_NORMS
;
1296 EXPORT_SYMBOL(cx88_enum_input
);
1298 static int vidioc_enum_input (struct file
*file
, void *priv
,
1299 struct v4l2_input
*i
)
1301 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1302 return cx88_enum_input (core
,i
);
1305 static int vidioc_g_input (struct file
*file
, void *priv
, unsigned int *i
)
1307 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1313 static int vidioc_s_input (struct file
*file
, void *priv
, unsigned int i
)
1315 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1320 mutex_lock(&core
->lock
);
1321 cx88_newstation(core
);
1322 cx88_video_mux(core
,i
);
1323 mutex_unlock(&core
->lock
);
1329 static int vidioc_queryctrl (struct file
*file
, void *priv
,
1330 struct v4l2_queryctrl
*qctrl
)
1332 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1334 qctrl
->id
= v4l2_ctrl_next(ctrl_classes
, qctrl
->id
);
1335 if (unlikely(qctrl
->id
== 0))
1337 return cx8800_ctrl_query(core
, qctrl
);
1340 static int vidioc_g_ctrl (struct file
*file
, void *priv
,
1341 struct v4l2_control
*ctl
)
1343 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1345 cx88_get_control(core
,ctl
);
1348 static int vidioc_s_ctrl (struct file
*file
, void *priv
,
1349 struct v4l2_control
*ctl
)
1351 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1353 cx88_set_control(core
,ctl
);
1356 static int vidioc_g_tuner (struct file
*file
, void *priv
,
1357 struct v4l2_tuner
*t
)
1359 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1362 if (unlikely(UNSET
== core
->board
.tuner_type
))
1367 strcpy(t
->name
, "Television");
1368 t
->type
= V4L2_TUNER_ANALOG_TV
;
1369 t
->capability
= V4L2_TUNER_CAP_NORM
;
1370 t
->rangehigh
= 0xffffffffUL
;
1372 cx88_get_stereo(core
,t
);
1373 reg
= cx_read(MO_DEVICE_STATUS
);
1374 t
->signal
= (reg
& (1<<5)) ? 0xffff : 0x0000;
1378 static int vidioc_s_tuner (struct file
*file
, void *priv
,
1379 struct v4l2_tuner
*t
)
1381 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1383 if (UNSET
== core
->board
.tuner_type
)
1388 cx88_set_stereo(core
, t
->audmode
, 1);
1392 static int vidioc_g_frequency (struct file
*file
, void *priv
,
1393 struct v4l2_frequency
*f
)
1395 struct cx8800_fh
*fh
= priv
;
1396 struct cx88_core
*core
= fh
->dev
->core
;
1398 if (unlikely(UNSET
== core
->board
.tuner_type
))
1401 /* f->type = fh->radio ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV; */
1402 f
->type
= fh
->radio
? V4L2_TUNER_RADIO
: V4L2_TUNER_ANALOG_TV
;
1403 f
->frequency
= core
->freq
;
1405 cx88_call_i2c_clients(core
,VIDIOC_G_FREQUENCY
,f
);
1410 int cx88_set_freq (struct cx88_core
*core
,
1411 struct v4l2_frequency
*f
)
1413 if (unlikely(UNSET
== core
->board
.tuner_type
))
1415 if (unlikely(f
->tuner
!= 0))
1418 mutex_lock(&core
->lock
);
1419 core
->freq
= f
->frequency
;
1420 cx88_newstation(core
);
1421 cx88_call_i2c_clients(core
,VIDIOC_S_FREQUENCY
,f
);
1423 /* When changing channels it is required to reset TVAUDIO */
1425 cx88_set_tvaudio(core
);
1427 mutex_unlock(&core
->lock
);
1431 EXPORT_SYMBOL(cx88_set_freq
);
1433 static int vidioc_s_frequency (struct file
*file
, void *priv
,
1434 struct v4l2_frequency
*f
)
1436 struct cx8800_fh
*fh
= priv
;
1437 struct cx88_core
*core
= fh
->dev
->core
;
1439 if (unlikely(0 == fh
->radio
&& f
->type
!= V4L2_TUNER_ANALOG_TV
))
1441 if (unlikely(1 == fh
->radio
&& f
->type
!= V4L2_TUNER_RADIO
))
1445 cx88_set_freq (core
,f
);
1448 #ifdef CONFIG_VIDEO_ADV_DEBUG
1449 static int vidioc_g_register (struct file
*file
, void *fh
,
1450 struct v4l2_dbg_register
*reg
)
1452 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1454 if (!v4l2_chip_match_host(®
->match
))
1456 /* cx2388x has a 24-bit register space */
1457 reg
->val
= cx_read(reg
->reg
& 0xffffff);
1462 static int vidioc_s_register (struct file
*file
, void *fh
,
1463 struct v4l2_dbg_register
*reg
)
1465 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1467 if (!v4l2_chip_match_host(®
->match
))
1469 cx_write(reg
->reg
& 0xffffff, reg
->val
);
1474 /* ----------------------------------------------------------- */
1475 /* RADIO ESPECIFIC IOCTLS */
1476 /* ----------------------------------------------------------- */
1478 static int radio_querycap (struct file
*file
, void *priv
,
1479 struct v4l2_capability
*cap
)
1481 struct cx8800_dev
*dev
= ((struct cx8800_fh
*)priv
)->dev
;
1482 struct cx88_core
*core
= dev
->core
;
1484 strcpy(cap
->driver
, "cx8800");
1485 strlcpy(cap
->card
, core
->board
.name
, sizeof(cap
->card
));
1486 sprintf(cap
->bus_info
,"PCI:%s", pci_name(dev
->pci
));
1487 cap
->version
= CX88_VERSION_CODE
;
1488 cap
->capabilities
= V4L2_CAP_TUNER
;
1492 static int radio_g_tuner (struct file
*file
, void *priv
,
1493 struct v4l2_tuner
*t
)
1495 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1497 if (unlikely(t
->index
> 0))
1500 strcpy(t
->name
, "Radio");
1501 t
->type
= V4L2_TUNER_RADIO
;
1503 cx88_call_i2c_clients(core
,VIDIOC_G_TUNER
,t
);
1507 static int radio_enum_input (struct file
*file
, void *priv
,
1508 struct v4l2_input
*i
)
1512 strcpy(i
->name
,"Radio");
1513 i
->type
= V4L2_INPUT_TYPE_TUNER
;
1518 static int radio_g_audio (struct file
*file
, void *priv
, struct v4l2_audio
*a
)
1520 if (unlikely(a
->index
))
1523 memset(a
,0,sizeof(*a
));
1524 strcpy(a
->name
,"Radio");
1528 /* FIXME: Should add a standard for radio */
1530 static int radio_s_tuner (struct file
*file
, void *priv
,
1531 struct v4l2_tuner
*t
)
1533 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1538 cx88_call_i2c_clients(core
,VIDIOC_S_TUNER
,t
);
1543 static int radio_s_audio (struct file
*file
, void *fh
,
1544 struct v4l2_audio
*a
)
1549 static int radio_s_input (struct file
*file
, void *fh
, unsigned int i
)
1554 static int radio_queryctrl (struct file
*file
, void *priv
,
1555 struct v4l2_queryctrl
*c
)
1559 if (c
->id
< V4L2_CID_BASE
||
1560 c
->id
>= V4L2_CID_LASTP1
)
1562 if (c
->id
== V4L2_CID_AUDIO_MUTE
) {
1563 for (i
= 0; i
< CX8800_CTLS
; i
++)
1564 if (cx8800_ctls
[i
].v
.id
== c
->id
)
1566 *c
= cx8800_ctls
[i
].v
;
1572 /* ----------------------------------------------------------- */
1574 static void cx8800_vid_timeout(unsigned long data
)
1576 struct cx8800_dev
*dev
= (struct cx8800_dev
*)data
;
1577 struct cx88_core
*core
= dev
->core
;
1578 struct cx88_dmaqueue
*q
= &dev
->vidq
;
1579 struct cx88_buffer
*buf
;
1580 unsigned long flags
;
1582 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1584 cx_clear(MO_VID_DMACNTRL
, 0x11);
1585 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1587 spin_lock_irqsave(&dev
->slock
,flags
);
1588 while (!list_empty(&q
->active
)) {
1589 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
1590 list_del(&buf
->vb
.queue
);
1591 buf
->vb
.state
= VIDEOBUF_ERROR
;
1592 wake_up(&buf
->vb
.done
);
1593 printk("%s/0: [%p/%d] timeout - dma=0x%08lx\n", core
->name
,
1594 buf
, buf
->vb
.i
, (unsigned long)buf
->risc
.dma
);
1596 restart_video_queue(dev
,q
);
1597 spin_unlock_irqrestore(&dev
->slock
,flags
);
1600 static char *cx88_vid_irqs
[32] = {
1601 "y_risci1", "u_risci1", "v_risci1", "vbi_risc1",
1602 "y_risci2", "u_risci2", "v_risci2", "vbi_risc2",
1603 "y_oflow", "u_oflow", "v_oflow", "vbi_oflow",
1604 "y_sync", "u_sync", "v_sync", "vbi_sync",
1605 "opc_err", "par_err", "rip_err", "pci_abort",
1608 static void cx8800_vid_irq(struct cx8800_dev
*dev
)
1610 struct cx88_core
*core
= dev
->core
;
1611 u32 status
, mask
, count
;
1613 status
= cx_read(MO_VID_INTSTAT
);
1614 mask
= cx_read(MO_VID_INTMSK
);
1615 if (0 == (status
& mask
))
1617 cx_write(MO_VID_INTSTAT
, status
);
1618 if (irq_debug
|| (status
& mask
& ~0xff))
1619 cx88_print_irqbits(core
->name
, "irq vid",
1620 cx88_vid_irqs
, ARRAY_SIZE(cx88_vid_irqs
),
1623 /* risc op code error */
1624 if (status
& (1 << 16)) {
1625 printk(KERN_WARNING
"%s/0: video risc op code error\n",core
->name
);
1626 cx_clear(MO_VID_DMACNTRL
, 0x11);
1627 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1628 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1632 if (status
& 0x01) {
1633 spin_lock(&dev
->slock
);
1634 count
= cx_read(MO_VIDY_GPCNT
);
1635 cx88_wakeup(core
, &dev
->vidq
, count
);
1636 spin_unlock(&dev
->slock
);
1640 if (status
& 0x08) {
1641 spin_lock(&dev
->slock
);
1642 count
= cx_read(MO_VBI_GPCNT
);
1643 cx88_wakeup(core
, &dev
->vbiq
, count
);
1644 spin_unlock(&dev
->slock
);
1648 if (status
& 0x10) {
1649 dprintk(2,"stopper video\n");
1650 spin_lock(&dev
->slock
);
1651 restart_video_queue(dev
,&dev
->vidq
);
1652 spin_unlock(&dev
->slock
);
1656 if (status
& 0x80) {
1657 dprintk(2,"stopper vbi\n");
1658 spin_lock(&dev
->slock
);
1659 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
1660 spin_unlock(&dev
->slock
);
1664 static irqreturn_t
cx8800_irq(int irq
, void *dev_id
)
1666 struct cx8800_dev
*dev
= dev_id
;
1667 struct cx88_core
*core
= dev
->core
;
1669 int loop
, handled
= 0;
1671 for (loop
= 0; loop
< 10; loop
++) {
1672 status
= cx_read(MO_PCI_INTSTAT
) &
1673 (core
->pci_irqmask
| PCI_INT_VIDINT
);
1676 cx_write(MO_PCI_INTSTAT
, status
);
1679 if (status
& core
->pci_irqmask
)
1680 cx88_core_irq(core
,status
);
1681 if (status
& PCI_INT_VIDINT
)
1682 cx8800_vid_irq(dev
);
1685 printk(KERN_WARNING
"%s/0: irq loop -- clearing mask\n",
1687 cx_write(MO_PCI_INTMSK
,0);
1691 return IRQ_RETVAL(handled
);
1694 /* ----------------------------------------------------------- */
1695 /* exported stuff */
1697 static const struct v4l2_file_operations video_fops
=
1699 .owner
= THIS_MODULE
,
1701 .release
= video_release
,
1705 .ioctl
= video_ioctl2
,
1708 static const struct v4l2_ioctl_ops video_ioctl_ops
= {
1709 .vidioc_querycap
= vidioc_querycap
,
1710 .vidioc_enum_fmt_vid_cap
= vidioc_enum_fmt_vid_cap
,
1711 .vidioc_g_fmt_vid_cap
= vidioc_g_fmt_vid_cap
,
1712 .vidioc_try_fmt_vid_cap
= vidioc_try_fmt_vid_cap
,
1713 .vidioc_s_fmt_vid_cap
= vidioc_s_fmt_vid_cap
,
1714 .vidioc_g_fmt_vbi_cap
= cx8800_vbi_fmt
,
1715 .vidioc_try_fmt_vbi_cap
= cx8800_vbi_fmt
,
1716 .vidioc_s_fmt_vbi_cap
= cx8800_vbi_fmt
,
1717 .vidioc_reqbufs
= vidioc_reqbufs
,
1718 .vidioc_querybuf
= vidioc_querybuf
,
1719 .vidioc_qbuf
= vidioc_qbuf
,
1720 .vidioc_dqbuf
= vidioc_dqbuf
,
1721 .vidioc_s_std
= vidioc_s_std
,
1722 .vidioc_enum_input
= vidioc_enum_input
,
1723 .vidioc_g_input
= vidioc_g_input
,
1724 .vidioc_s_input
= vidioc_s_input
,
1725 .vidioc_queryctrl
= vidioc_queryctrl
,
1726 .vidioc_g_ctrl
= vidioc_g_ctrl
,
1727 .vidioc_s_ctrl
= vidioc_s_ctrl
,
1728 .vidioc_streamon
= vidioc_streamon
,
1729 .vidioc_streamoff
= vidioc_streamoff
,
1730 #ifdef CONFIG_VIDEO_V4L1_COMPAT
1731 .vidiocgmbuf
= vidiocgmbuf
,
1733 .vidioc_g_tuner
= vidioc_g_tuner
,
1734 .vidioc_s_tuner
= vidioc_s_tuner
,
1735 .vidioc_g_frequency
= vidioc_g_frequency
,
1736 .vidioc_s_frequency
= vidioc_s_frequency
,
1737 #ifdef CONFIG_VIDEO_ADV_DEBUG
1738 .vidioc_g_register
= vidioc_g_register
,
1739 .vidioc_s_register
= vidioc_s_register
,
1743 static struct video_device cx8800_vbi_template
;
1745 static struct video_device cx8800_video_template
= {
1746 .name
= "cx8800-video",
1747 .fops
= &video_fops
,
1749 .ioctl_ops
= &video_ioctl_ops
,
1750 .tvnorms
= CX88_NORMS
,
1751 .current_norm
= V4L2_STD_NTSC_M
,
1754 static const struct v4l2_file_operations radio_fops
=
1756 .owner
= THIS_MODULE
,
1758 .release
= video_release
,
1759 .ioctl
= video_ioctl2
,
1762 static const struct v4l2_ioctl_ops radio_ioctl_ops
= {
1763 .vidioc_querycap
= radio_querycap
,
1764 .vidioc_g_tuner
= radio_g_tuner
,
1765 .vidioc_enum_input
= radio_enum_input
,
1766 .vidioc_g_audio
= radio_g_audio
,
1767 .vidioc_s_tuner
= radio_s_tuner
,
1768 .vidioc_s_audio
= radio_s_audio
,
1769 .vidioc_s_input
= radio_s_input
,
1770 .vidioc_queryctrl
= radio_queryctrl
,
1771 .vidioc_g_ctrl
= vidioc_g_ctrl
,
1772 .vidioc_s_ctrl
= vidioc_s_ctrl
,
1773 .vidioc_g_frequency
= vidioc_g_frequency
,
1774 .vidioc_s_frequency
= vidioc_s_frequency
,
1775 #ifdef CONFIG_VIDEO_ADV_DEBUG
1776 .vidioc_g_register
= vidioc_g_register
,
1777 .vidioc_s_register
= vidioc_s_register
,
1781 static struct video_device cx8800_radio_template
= {
1782 .name
= "cx8800-radio",
1783 .fops
= &radio_fops
,
1785 .ioctl_ops
= &radio_ioctl_ops
,
1788 /* ----------------------------------------------------------- */
1790 static void cx8800_unregister_video(struct cx8800_dev
*dev
)
1792 if (dev
->radio_dev
) {
1793 if (-1 != dev
->radio_dev
->minor
)
1794 video_unregister_device(dev
->radio_dev
);
1796 video_device_release(dev
->radio_dev
);
1797 dev
->radio_dev
= NULL
;
1800 if (-1 != dev
->vbi_dev
->minor
)
1801 video_unregister_device(dev
->vbi_dev
);
1803 video_device_release(dev
->vbi_dev
);
1804 dev
->vbi_dev
= NULL
;
1806 if (dev
->video_dev
) {
1807 if (-1 != dev
->video_dev
->minor
)
1808 video_unregister_device(dev
->video_dev
);
1810 video_device_release(dev
->video_dev
);
1811 dev
->video_dev
= NULL
;
1815 static int __devinit
cx8800_initdev(struct pci_dev
*pci_dev
,
1816 const struct pci_device_id
*pci_id
)
1818 struct cx8800_dev
*dev
;
1819 struct cx88_core
*core
;
1823 dev
= kzalloc(sizeof(*dev
),GFP_KERNEL
);
1829 if (pci_enable_device(pci_dev
)) {
1833 core
= cx88_core_get(dev
->pci
);
1840 /* print pci info */
1841 pci_read_config_byte(pci_dev
, PCI_CLASS_REVISION
, &dev
->pci_rev
);
1842 pci_read_config_byte(pci_dev
, PCI_LATENCY_TIMER
, &dev
->pci_lat
);
1843 printk(KERN_INFO
"%s/0: found at %s, rev: %d, irq: %d, "
1844 "latency: %d, mmio: 0x%llx\n", core
->name
,
1845 pci_name(pci_dev
), dev
->pci_rev
, pci_dev
->irq
,
1846 dev
->pci_lat
,(unsigned long long)pci_resource_start(pci_dev
,0));
1848 pci_set_master(pci_dev
);
1849 if (!pci_dma_supported(pci_dev
,DMA_32BIT_MASK
)) {
1850 printk("%s/0: Oops: no 32bit PCI DMA ???\n",core
->name
);
1855 /* Initialize VBI template */
1856 memcpy( &cx8800_vbi_template
, &cx8800_video_template
,
1857 sizeof(cx8800_vbi_template
) );
1858 strcpy(cx8800_vbi_template
.name
,"cx8800-vbi");
1860 /* initialize driver struct */
1861 spin_lock_init(&dev
->slock
);
1862 core
->tvnorm
= cx8800_video_template
.current_norm
;
1864 /* init video dma queues */
1865 INIT_LIST_HEAD(&dev
->vidq
.active
);
1866 INIT_LIST_HEAD(&dev
->vidq
.queued
);
1867 dev
->vidq
.timeout
.function
= cx8800_vid_timeout
;
1868 dev
->vidq
.timeout
.data
= (unsigned long)dev
;
1869 init_timer(&dev
->vidq
.timeout
);
1870 cx88_risc_stopper(dev
->pci
,&dev
->vidq
.stopper
,
1871 MO_VID_DMACNTRL
,0x11,0x00);
1873 /* init vbi dma queues */
1874 INIT_LIST_HEAD(&dev
->vbiq
.active
);
1875 INIT_LIST_HEAD(&dev
->vbiq
.queued
);
1876 dev
->vbiq
.timeout
.function
= cx8800_vbi_timeout
;
1877 dev
->vbiq
.timeout
.data
= (unsigned long)dev
;
1878 init_timer(&dev
->vbiq
.timeout
);
1879 cx88_risc_stopper(dev
->pci
,&dev
->vbiq
.stopper
,
1880 MO_VID_DMACNTRL
,0x88,0x00);
1883 err
= request_irq(pci_dev
->irq
, cx8800_irq
,
1884 IRQF_SHARED
| IRQF_DISABLED
, core
->name
, dev
);
1886 printk(KERN_ERR
"%s/0: can't get IRQ %d\n",
1887 core
->name
,pci_dev
->irq
);
1890 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
1892 /* load and configure helper modules */
1894 if (core
->board
.audio_chip
== V4L2_IDENT_WM8775
)
1895 request_module("wm8775");
1897 switch (core
->boardnr
) {
1898 case CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD
:
1899 case CX88_BOARD_DVICO_FUSIONHDTV_7_GOLD
:
1900 request_module("rtc-isl1208");
1901 /* break intentionally omitted */
1902 case CX88_BOARD_DVICO_FUSIONHDTV_5_PCI_NANO
:
1903 request_module("ir-kbd-i2c");
1906 /* register v4l devices */
1907 dev
->video_dev
= cx88_vdev_init(core
,dev
->pci
,
1908 &cx8800_video_template
,"video");
1909 err
= video_register_device(dev
->video_dev
,VFL_TYPE_GRABBER
,
1910 video_nr
[core
->nr
]);
1912 printk(KERN_ERR
"%s/0: can't register video device\n",
1916 printk(KERN_INFO
"%s/0: registered device video%d [v4l2]\n",
1917 core
->name
, dev
->video_dev
->num
);
1919 dev
->vbi_dev
= cx88_vdev_init(core
,dev
->pci
,&cx8800_vbi_template
,"vbi");
1920 err
= video_register_device(dev
->vbi_dev
,VFL_TYPE_VBI
,
1923 printk(KERN_ERR
"%s/0: can't register vbi device\n",
1927 printk(KERN_INFO
"%s/0: registered device vbi%d\n",
1928 core
->name
, dev
->vbi_dev
->num
);
1930 if (core
->board
.radio
.type
== CX88_RADIO
) {
1931 dev
->radio_dev
= cx88_vdev_init(core
,dev
->pci
,
1932 &cx8800_radio_template
,"radio");
1933 err
= video_register_device(dev
->radio_dev
,VFL_TYPE_RADIO
,
1934 radio_nr
[core
->nr
]);
1936 printk(KERN_ERR
"%s/0: can't register radio device\n",
1940 printk(KERN_INFO
"%s/0: registered device radio%d\n",
1941 core
->name
, dev
->radio_dev
->num
);
1944 /* everything worked */
1945 list_add_tail(&dev
->devlist
,&cx8800_devlist
);
1946 pci_set_drvdata(pci_dev
,dev
);
1948 /* initial device configuration */
1949 mutex_lock(&core
->lock
);
1950 cx88_set_tvnorm(core
,core
->tvnorm
);
1951 init_controls(core
);
1952 cx88_video_mux(core
,0);
1953 mutex_unlock(&core
->lock
);
1955 /* start tvaudio thread */
1956 if (core
->board
.tuner_type
!= TUNER_ABSENT
) {
1957 core
->kthread
= kthread_run(cx88_audio_thread
, core
, "cx88 tvaudio");
1958 if (IS_ERR(core
->kthread
)) {
1959 err
= PTR_ERR(core
->kthread
);
1960 printk(KERN_ERR
"%s/0: failed to create cx88 audio thread, err=%d\n",
1967 cx8800_unregister_video(dev
);
1968 free_irq(pci_dev
->irq
, dev
);
1970 cx88_core_put(core
,dev
->pci
);
1976 static void __devexit
cx8800_finidev(struct pci_dev
*pci_dev
)
1978 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
1979 struct cx88_core
*core
= dev
->core
;
1982 if (core
->kthread
) {
1983 kthread_stop(core
->kthread
);
1984 core
->kthread
= NULL
;
1988 cx88_ir_stop(core
, core
->ir
);
1990 cx88_shutdown(core
); /* FIXME */
1991 pci_disable_device(pci_dev
);
1993 /* unregister stuff */
1995 free_irq(pci_dev
->irq
, dev
);
1996 cx8800_unregister_video(dev
);
1997 pci_set_drvdata(pci_dev
, NULL
);
2000 btcx_riscmem_free(dev
->pci
,&dev
->vidq
.stopper
);
2001 list_del(&dev
->devlist
);
2002 cx88_core_put(core
,dev
->pci
);
2007 static int cx8800_suspend(struct pci_dev
*pci_dev
, pm_message_t state
)
2009 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
2010 struct cx88_core
*core
= dev
->core
;
2012 /* stop video+vbi capture */
2013 spin_lock(&dev
->slock
);
2014 if (!list_empty(&dev
->vidq
.active
)) {
2015 printk("%s/0: suspend video\n", core
->name
);
2016 stop_video_dma(dev
);
2017 del_timer(&dev
->vidq
.timeout
);
2019 if (!list_empty(&dev
->vbiq
.active
)) {
2020 printk("%s/0: suspend vbi\n", core
->name
);
2021 cx8800_stop_vbi_dma(dev
);
2022 del_timer(&dev
->vbiq
.timeout
);
2024 spin_unlock(&dev
->slock
);
2027 cx88_ir_stop(core
, core
->ir
);
2028 /* FIXME -- shutdown device */
2029 cx88_shutdown(core
);
2031 pci_save_state(pci_dev
);
2032 if (0 != pci_set_power_state(pci_dev
, pci_choose_state(pci_dev
, state
))) {
2033 pci_disable_device(pci_dev
);
2034 dev
->state
.disabled
= 1;
2039 static int cx8800_resume(struct pci_dev
*pci_dev
)
2041 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
2042 struct cx88_core
*core
= dev
->core
;
2045 if (dev
->state
.disabled
) {
2046 err
=pci_enable_device(pci_dev
);
2048 printk(KERN_ERR
"%s/0: can't enable device\n",
2053 dev
->state
.disabled
= 0;
2055 err
= pci_set_power_state(pci_dev
, PCI_D0
);
2057 printk(KERN_ERR
"%s/0: can't set power state\n", core
->name
);
2058 pci_disable_device(pci_dev
);
2059 dev
->state
.disabled
= 1;
2063 pci_restore_state(pci_dev
);
2065 /* FIXME: re-initialize hardware */
2068 cx88_ir_start(core
, core
->ir
);
2070 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
2072 /* restart video+vbi capture */
2073 spin_lock(&dev
->slock
);
2074 if (!list_empty(&dev
->vidq
.active
)) {
2075 printk("%s/0: resume video\n", core
->name
);
2076 restart_video_queue(dev
,&dev
->vidq
);
2078 if (!list_empty(&dev
->vbiq
.active
)) {
2079 printk("%s/0: resume vbi\n", core
->name
);
2080 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
2082 spin_unlock(&dev
->slock
);
2088 /* ----------------------------------------------------------- */
2090 static struct pci_device_id cx8800_pci_tbl
[] = {
2094 .subvendor
= PCI_ANY_ID
,
2095 .subdevice
= PCI_ANY_ID
,
2097 /* --- end of list --- */
2100 MODULE_DEVICE_TABLE(pci
, cx8800_pci_tbl
);
2102 static struct pci_driver cx8800_pci_driver
= {
2104 .id_table
= cx8800_pci_tbl
,
2105 .probe
= cx8800_initdev
,
2106 .remove
= __devexit_p(cx8800_finidev
),
2108 .suspend
= cx8800_suspend
,
2109 .resume
= cx8800_resume
,
2113 static int cx8800_init(void)
2115 printk(KERN_INFO
"cx88/0: cx2388x v4l2 driver version %d.%d.%d loaded\n",
2116 (CX88_VERSION_CODE
>> 16) & 0xff,
2117 (CX88_VERSION_CODE
>> 8) & 0xff,
2118 CX88_VERSION_CODE
& 0xff);
2120 printk(KERN_INFO
"cx2388x: snapshot date %04d-%02d-%02d\n",
2121 SNAPSHOT
/10000, (SNAPSHOT
/100)%100, SNAPSHOT
%100);
2123 return pci_register_driver(&cx8800_pci_driver
);
2126 static void cx8800_fini(void)
2128 pci_unregister_driver(&cx8800_pci_driver
);
2131 module_init(cx8800_init
);
2132 module_exit(cx8800_fini
);
2134 /* ----------------------------------------------------------- */
2139 * 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