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>
43 #include <media/v4l2-event.h>
44 #include <media/wm8775.h>
46 MODULE_DESCRIPTION("v4l2 driver module for cx2388x based TV cards");
47 MODULE_AUTHOR("Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]");
48 MODULE_LICENSE("GPL");
49 MODULE_VERSION(CX88_VERSION
);
51 /* ------------------------------------------------------------------ */
53 static unsigned int video_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
54 static unsigned int vbi_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
55 static unsigned int radio_nr
[] = {[0 ... (CX88_MAXBOARDS
- 1)] = UNSET
};
57 module_param_array(video_nr
, int, NULL
, 0444);
58 module_param_array(vbi_nr
, int, NULL
, 0444);
59 module_param_array(radio_nr
, int, NULL
, 0444);
61 MODULE_PARM_DESC(video_nr
,"video device numbers");
62 MODULE_PARM_DESC(vbi_nr
,"vbi device numbers");
63 MODULE_PARM_DESC(radio_nr
,"radio device numbers");
65 static unsigned int video_debug
;
66 module_param(video_debug
,int,0644);
67 MODULE_PARM_DESC(video_debug
,"enable debug messages [video]");
69 static unsigned int irq_debug
;
70 module_param(irq_debug
,int,0644);
71 MODULE_PARM_DESC(irq_debug
,"enable debug messages [IRQ handler]");
73 static unsigned int vid_limit
= 16;
74 module_param(vid_limit
,int,0644);
75 MODULE_PARM_DESC(vid_limit
,"capture memory limit in megabytes");
77 #define dprintk(level,fmt, arg...) if (video_debug >= level) \
78 printk(KERN_DEBUG "%s/0: " fmt, core->name , ## arg)
80 /* ------------------------------------------------------------------- */
83 static const struct cx8800_fmt formats
[] = {
85 .name
= "8 bpp, gray",
86 .fourcc
= V4L2_PIX_FMT_GREY
,
87 .cxformat
= ColorFormatY8
,
89 .flags
= FORMAT_FLAGS_PACKED
,
91 .name
= "15 bpp RGB, le",
92 .fourcc
= V4L2_PIX_FMT_RGB555
,
93 .cxformat
= ColorFormatRGB15
,
95 .flags
= FORMAT_FLAGS_PACKED
,
97 .name
= "15 bpp RGB, be",
98 .fourcc
= V4L2_PIX_FMT_RGB555X
,
99 .cxformat
= ColorFormatRGB15
| ColorFormatBSWAP
,
101 .flags
= FORMAT_FLAGS_PACKED
,
103 .name
= "16 bpp RGB, le",
104 .fourcc
= V4L2_PIX_FMT_RGB565
,
105 .cxformat
= ColorFormatRGB16
,
107 .flags
= FORMAT_FLAGS_PACKED
,
109 .name
= "16 bpp RGB, be",
110 .fourcc
= V4L2_PIX_FMT_RGB565X
,
111 .cxformat
= ColorFormatRGB16
| ColorFormatBSWAP
,
113 .flags
= FORMAT_FLAGS_PACKED
,
115 .name
= "24 bpp RGB, le",
116 .fourcc
= V4L2_PIX_FMT_BGR24
,
117 .cxformat
= ColorFormatRGB24
,
119 .flags
= FORMAT_FLAGS_PACKED
,
121 .name
= "32 bpp RGB, le",
122 .fourcc
= V4L2_PIX_FMT_BGR32
,
123 .cxformat
= ColorFormatRGB32
,
125 .flags
= FORMAT_FLAGS_PACKED
,
127 .name
= "32 bpp RGB, be",
128 .fourcc
= V4L2_PIX_FMT_RGB32
,
129 .cxformat
= ColorFormatRGB32
| ColorFormatBSWAP
| ColorFormatWSWAP
,
131 .flags
= FORMAT_FLAGS_PACKED
,
133 .name
= "4:2:2, packed, YUYV",
134 .fourcc
= V4L2_PIX_FMT_YUYV
,
135 .cxformat
= ColorFormatYUY2
,
137 .flags
= FORMAT_FLAGS_PACKED
,
139 .name
= "4:2:2, packed, UYVY",
140 .fourcc
= V4L2_PIX_FMT_UYVY
,
141 .cxformat
= ColorFormatYUY2
| ColorFormatBSWAP
,
143 .flags
= FORMAT_FLAGS_PACKED
,
147 static const struct cx8800_fmt
* format_by_fourcc(unsigned int fourcc
)
151 for (i
= 0; i
< ARRAY_SIZE(formats
); i
++)
152 if (formats
[i
].fourcc
== fourcc
)
157 /* ------------------------------------------------------------------- */
160 /* control information */
167 /* control register information */
175 static const struct cx88_ctrl cx8800_vid_ctls
[] = {
178 .id
= V4L2_CID_BRIGHTNESS
,
182 .default_value
= 0x7f,
184 .reg
= MO_CONTR_BRIGHT
,
188 .id
= V4L2_CID_CONTRAST
,
192 .default_value
= 0x3f,
194 .reg
= MO_CONTR_BRIGHT
,
202 .default_value
= 0x7f,
208 /* strictly, this only describes only U saturation.
209 * V saturation is handled specially through code.
211 .id
= V4L2_CID_SATURATION
,
215 .default_value
= 0x7f,
217 .reg
= MO_UV_SATURATION
,
221 .id
= V4L2_CID_SHARPNESS
,
225 .default_value
= 0x0,
227 /* NOTE: the value is converted and written to both even
228 and odd registers in the code */
229 .reg
= MO_FILTER_ODD
,
233 .id
= V4L2_CID_CHROMA_AGC
,
236 .default_value
= 0x1,
237 .reg
= MO_INPUT_FORMAT
,
241 .id
= V4L2_CID_COLOR_KILLER
,
244 .default_value
= 0x1,
245 .reg
= MO_INPUT_FORMAT
,
249 .id
= V4L2_CID_BAND_STOP_FILTER
,
253 .default_value
= 0x0,
261 static const struct cx88_ctrl cx8800_aud_ctls
[] = {
264 .id
= V4L2_CID_AUDIO_MUTE
,
269 .sreg
= SHADOW_AUD_VOL_CTL
,
273 .id
= V4L2_CID_AUDIO_VOLUME
,
277 .default_value
= 0x3f,
279 .sreg
= SHADOW_AUD_VOL_CTL
,
283 .id
= V4L2_CID_AUDIO_BALANCE
,
287 .default_value
= 0x40,
289 .sreg
= SHADOW_AUD_BAL_CTL
,
296 CX8800_VID_CTLS
= ARRAY_SIZE(cx8800_vid_ctls
),
297 CX8800_AUD_CTLS
= ARRAY_SIZE(cx8800_aud_ctls
),
300 /* ------------------------------------------------------------------- */
301 /* resource management */
303 static int res_get(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bit
)
305 struct cx88_core
*core
= dev
->core
;
306 if (fh
->resources
& bit
)
307 /* have it already allocated */
311 mutex_lock(&core
->lock
);
312 if (dev
->resources
& bit
) {
313 /* no, someone else uses it */
314 mutex_unlock(&core
->lock
);
317 /* it's free, grab it */
318 fh
->resources
|= bit
;
319 dev
->resources
|= bit
;
320 dprintk(1,"res: get %d\n",bit
);
321 mutex_unlock(&core
->lock
);
326 int res_check(struct cx8800_fh
*fh
, unsigned int bit
)
328 return (fh
->resources
& bit
);
332 int res_locked(struct cx8800_dev
*dev
, unsigned int bit
)
334 return (dev
->resources
& bit
);
338 void res_free(struct cx8800_dev
*dev
, struct cx8800_fh
*fh
, unsigned int bits
)
340 struct cx88_core
*core
= dev
->core
;
341 BUG_ON((fh
->resources
& bits
) != bits
);
343 mutex_lock(&core
->lock
);
344 fh
->resources
&= ~bits
;
345 dev
->resources
&= ~bits
;
346 dprintk(1,"res: put %d\n",bits
);
347 mutex_unlock(&core
->lock
);
350 /* ------------------------------------------------------------------ */
352 int cx88_video_mux(struct cx88_core
*core
, unsigned int input
)
354 /* struct cx88_core *core = dev->core; */
356 dprintk(1,"video_mux: %d [vmux=%d,gpio=0x%x,0x%x,0x%x,0x%x]\n",
357 input
, INPUT(input
).vmux
,
358 INPUT(input
).gpio0
,INPUT(input
).gpio1
,
359 INPUT(input
).gpio2
,INPUT(input
).gpio3
);
361 cx_andor(MO_INPUT_FORMAT
, 0x03 << 14, INPUT(input
).vmux
<< 14);
362 cx_write(MO_GP3_IO
, INPUT(input
).gpio3
);
363 cx_write(MO_GP0_IO
, INPUT(input
).gpio0
);
364 cx_write(MO_GP1_IO
, INPUT(input
).gpio1
);
365 cx_write(MO_GP2_IO
, INPUT(input
).gpio2
);
367 switch (INPUT(input
).type
) {
368 case CX88_VMUX_SVIDEO
:
369 cx_set(MO_AFECFG_IO
, 0x00000001);
370 cx_set(MO_INPUT_FORMAT
, 0x00010010);
371 cx_set(MO_FILTER_EVEN
, 0x00002020);
372 cx_set(MO_FILTER_ODD
, 0x00002020);
375 cx_clear(MO_AFECFG_IO
, 0x00000001);
376 cx_clear(MO_INPUT_FORMAT
, 0x00010010);
377 cx_clear(MO_FILTER_EVEN
, 0x00002020);
378 cx_clear(MO_FILTER_ODD
, 0x00002020);
382 /* if there are audioroutes defined, we have an external
383 ADC to deal with audio */
384 if (INPUT(input
).audioroute
) {
385 /* The wm8775 module has the "2" route hardwired into
386 the initialization. Some boards may use different
387 routes for different inputs. HVR-1300 surely does */
388 if (core
->board
.audio_chip
&&
389 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
390 call_all(core
, audio
, s_routing
,
391 INPUT(input
).audioroute
, 0, 0);
393 /* cx2388's C-ADC is connected to the tuner only.
394 When used with S-Video, that ADC is busy dealing with
395 chroma, so an external must be used for baseband audio */
396 if (INPUT(input
).type
!= CX88_VMUX_TELEVISION
&&
397 INPUT(input
).type
!= CX88_VMUX_CABLE
) {
399 core
->tvaudio
= WW_I2SADC
;
400 cx88_set_tvaudio(core
);
403 cx_write(AUD_I2SCNTL
, 0x0);
404 cx_clear(AUD_CTL
, EN_I2SIN_ENABLE
);
410 EXPORT_SYMBOL(cx88_video_mux
);
412 /* ------------------------------------------------------------------ */
414 static int start_video_dma(struct cx8800_dev
*dev
,
415 struct cx88_dmaqueue
*q
,
416 struct cx88_buffer
*buf
)
418 struct cx88_core
*core
= dev
->core
;
420 /* setup fifo + format */
421 cx88_sram_channel_setup(core
, &cx88_sram_channels
[SRAM_CH21
],
422 buf
->bpl
, buf
->risc
.dma
);
423 cx88_set_scale(core
, buf
->vb
.width
, buf
->vb
.height
, buf
->vb
.field
);
424 cx_write(MO_COLOR_CTRL
, buf
->fmt
->cxformat
| ColorFormatGamma
);
427 cx_write(MO_VIDY_GPCNTRL
,GP_COUNT_CONTROL_RESET
);
431 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
| PCI_INT_VIDINT
);
433 /* Enables corresponding bits at PCI_INT_STAT:
434 bits 0 to 4: video, audio, transport stream, VIP, Host
436 bits 8 and 9: DMA complete for: SRC, DST
437 bits 10 and 11: BERR signal asserted for RISC: RD, WR
438 bits 12 to 15: BERR signal asserted for: BRDG, SRC, DST, IPB
440 cx_set(MO_VID_INTMSK
, 0x0f0011);
443 cx_set(VID_CAPTURE_CONTROL
,0x06);
446 cx_set(MO_DEV_CNTRL2
, (1<<5));
447 cx_set(MO_VID_DMACNTRL
, 0x11); /* Planar Y and packed FIFO and RISC enable */
453 static int stop_video_dma(struct cx8800_dev
*dev
)
455 struct cx88_core
*core
= dev
->core
;
458 cx_clear(MO_VID_DMACNTRL
, 0x11);
460 /* disable capture */
461 cx_clear(VID_CAPTURE_CONTROL
,0x06);
464 cx_clear(MO_PCI_INTMSK
, PCI_INT_VIDINT
);
465 cx_clear(MO_VID_INTMSK
, 0x0f0011);
470 static int restart_video_queue(struct cx8800_dev
*dev
,
471 struct cx88_dmaqueue
*q
)
473 struct cx88_core
*core
= dev
->core
;
474 struct cx88_buffer
*buf
, *prev
;
476 if (!list_empty(&q
->active
)) {
477 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
478 dprintk(2,"restart_queue [%p/%d]: restart dma\n",
480 start_video_dma(dev
, q
, buf
);
481 list_for_each_entry(buf
, &q
->active
, vb
.queue
)
482 buf
->count
= q
->count
++;
483 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
489 if (list_empty(&q
->queued
))
491 buf
= list_entry(q
->queued
.next
, struct cx88_buffer
, vb
.queue
);
493 list_move_tail(&buf
->vb
.queue
, &q
->active
);
494 start_video_dma(dev
, q
, buf
);
495 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
496 buf
->count
= q
->count
++;
497 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
498 dprintk(2,"[%p/%d] restart_queue - first active\n",
501 } else if (prev
->vb
.width
== buf
->vb
.width
&&
502 prev
->vb
.height
== buf
->vb
.height
&&
503 prev
->fmt
== buf
->fmt
) {
504 list_move_tail(&buf
->vb
.queue
, &q
->active
);
505 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
506 buf
->count
= q
->count
++;
507 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
508 dprintk(2,"[%p/%d] restart_queue - move to active\n",
517 /* ------------------------------------------------------------------ */
520 buffer_setup(struct videobuf_queue
*q
, unsigned int *count
, unsigned int *size
)
522 struct cx8800_fh
*fh
= q
->priv_data
;
523 struct cx8800_dev
*dev
= fh
->dev
;
525 *size
= dev
->fmt
->depth
* dev
->width
* dev
->height
>> 3;
528 if (*size
* *count
> vid_limit
* 1024 * 1024)
529 *count
= (vid_limit
* 1024 * 1024) / *size
;
534 buffer_prepare(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
,
535 enum v4l2_field field
)
537 struct cx8800_fh
*fh
= q
->priv_data
;
538 struct cx8800_dev
*dev
= fh
->dev
;
539 struct cx88_core
*core
= dev
->core
;
540 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
541 struct videobuf_dmabuf
*dma
=videobuf_to_dma(&buf
->vb
);
542 int rc
, init_buffer
= 0;
544 BUG_ON(NULL
== dev
->fmt
);
545 if (dev
->width
< 48 || dev
->width
> norm_maxw(core
->tvnorm
) ||
546 dev
->height
< 32 || dev
->height
> norm_maxh(core
->tvnorm
))
548 buf
->vb
.size
= (dev
->width
* dev
->height
* dev
->fmt
->depth
) >> 3;
549 if (0 != buf
->vb
.baddr
&& buf
->vb
.bsize
< buf
->vb
.size
)
552 if (buf
->fmt
!= dev
->fmt
||
553 buf
->vb
.width
!= dev
->width
||
554 buf
->vb
.height
!= dev
->height
||
555 buf
->vb
.field
!= field
) {
557 buf
->vb
.width
= dev
->width
;
558 buf
->vb
.height
= dev
->height
;
559 buf
->vb
.field
= field
;
563 if (VIDEOBUF_NEEDS_INIT
== buf
->vb
.state
) {
565 if (0 != (rc
= videobuf_iolock(q
,&buf
->vb
,NULL
)))
570 buf
->bpl
= buf
->vb
.width
* buf
->fmt
->depth
>> 3;
571 switch (buf
->vb
.field
) {
573 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
574 dma
->sglist
, 0, UNSET
,
575 buf
->bpl
, 0, buf
->vb
.height
);
577 case V4L2_FIELD_BOTTOM
:
578 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
579 dma
->sglist
, UNSET
, 0,
580 buf
->bpl
, 0, buf
->vb
.height
);
582 case V4L2_FIELD_INTERLACED
:
583 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
584 dma
->sglist
, 0, buf
->bpl
,
586 buf
->vb
.height
>> 1);
588 case V4L2_FIELD_SEQ_TB
:
589 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
591 0, buf
->bpl
* (buf
->vb
.height
>> 1),
593 buf
->vb
.height
>> 1);
595 case V4L2_FIELD_SEQ_BT
:
596 cx88_risc_buffer(dev
->pci
, &buf
->risc
,
598 buf
->bpl
* (buf
->vb
.height
>> 1), 0,
600 buf
->vb
.height
>> 1);
606 dprintk(2,"[%p/%d] buffer_prepare - %dx%d %dbpp \"%s\" - dma=0x%08lx\n",
608 dev
->width
, dev
->height
, dev
->fmt
->depth
, dev
->fmt
->name
,
609 (unsigned long)buf
->risc
.dma
);
611 buf
->vb
.state
= VIDEOBUF_PREPARED
;
615 cx88_free_buffer(q
,buf
);
620 buffer_queue(struct videobuf_queue
*vq
, struct videobuf_buffer
*vb
)
622 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
623 struct cx88_buffer
*prev
;
624 struct cx8800_fh
*fh
= vq
->priv_data
;
625 struct cx8800_dev
*dev
= fh
->dev
;
626 struct cx88_core
*core
= dev
->core
;
627 struct cx88_dmaqueue
*q
= &dev
->vidq
;
629 /* add jump to stopper */
630 buf
->risc
.jmp
[0] = cpu_to_le32(RISC_JUMP
| RISC_IRQ1
| RISC_CNT_INC
);
631 buf
->risc
.jmp
[1] = cpu_to_le32(q
->stopper
.dma
);
633 if (!list_empty(&q
->queued
)) {
634 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
635 buf
->vb
.state
= VIDEOBUF_QUEUED
;
636 dprintk(2,"[%p/%d] buffer_queue - append to queued\n",
639 } else if (list_empty(&q
->active
)) {
640 list_add_tail(&buf
->vb
.queue
,&q
->active
);
641 start_video_dma(dev
, q
, buf
);
642 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
643 buf
->count
= q
->count
++;
644 mod_timer(&q
->timeout
, jiffies
+BUFFER_TIMEOUT
);
645 dprintk(2,"[%p/%d] buffer_queue - first active\n",
649 prev
= list_entry(q
->active
.prev
, struct cx88_buffer
, vb
.queue
);
650 if (prev
->vb
.width
== buf
->vb
.width
&&
651 prev
->vb
.height
== buf
->vb
.height
&&
652 prev
->fmt
== buf
->fmt
) {
653 list_add_tail(&buf
->vb
.queue
,&q
->active
);
654 buf
->vb
.state
= VIDEOBUF_ACTIVE
;
655 buf
->count
= q
->count
++;
656 prev
->risc
.jmp
[1] = cpu_to_le32(buf
->risc
.dma
);
657 dprintk(2,"[%p/%d] buffer_queue - append to active\n",
661 list_add_tail(&buf
->vb
.queue
,&q
->queued
);
662 buf
->vb
.state
= VIDEOBUF_QUEUED
;
663 dprintk(2,"[%p/%d] buffer_queue - first queued\n",
669 static void buffer_release(struct videobuf_queue
*q
, struct videobuf_buffer
*vb
)
671 struct cx88_buffer
*buf
= container_of(vb
,struct cx88_buffer
,vb
);
673 cx88_free_buffer(q
,buf
);
676 static const struct videobuf_queue_ops cx8800_video_qops
= {
677 .buf_setup
= buffer_setup
,
678 .buf_prepare
= buffer_prepare
,
679 .buf_queue
= buffer_queue
,
680 .buf_release
= buffer_release
,
683 /* ------------------------------------------------------------------ */
686 /* ------------------------------------------------------------------ */
688 static struct videobuf_queue
*get_queue(struct file
*file
)
690 struct video_device
*vdev
= video_devdata(file
);
691 struct cx8800_fh
*fh
= file
->private_data
;
693 switch (vdev
->vfl_type
) {
694 case VFL_TYPE_GRABBER
:
704 static int get_resource(struct file
*file
)
706 struct video_device
*vdev
= video_devdata(file
);
708 switch (vdev
->vfl_type
) {
709 case VFL_TYPE_GRABBER
:
710 return RESOURCE_VIDEO
;
719 static int video_open(struct file
*file
)
721 struct video_device
*vdev
= video_devdata(file
);
722 struct cx8800_dev
*dev
= video_drvdata(file
);
723 struct cx88_core
*core
= dev
->core
;
724 struct cx8800_fh
*fh
;
725 enum v4l2_buf_type type
= 0;
728 switch (vdev
->vfl_type
) {
729 case VFL_TYPE_GRABBER
:
730 type
= V4L2_BUF_TYPE_VIDEO_CAPTURE
;
733 type
= V4L2_BUF_TYPE_VBI_CAPTURE
;
740 dprintk(1, "open dev=%s radio=%d type=%s\n",
741 video_device_node_name(vdev
), radio
, v4l2_type_names
[type
]);
743 /* allocate + initialize per filehandle data */
744 fh
= kzalloc(sizeof(*fh
),GFP_KERNEL
);
748 v4l2_fh_init(&fh
->fh
, vdev
);
749 file
->private_data
= fh
;
752 mutex_lock(&core
->lock
);
754 videobuf_queue_sg_init(&fh
->vidq
, &cx8800_video_qops
,
755 &dev
->pci
->dev
, &dev
->slock
,
756 V4L2_BUF_TYPE_VIDEO_CAPTURE
,
757 V4L2_FIELD_INTERLACED
,
758 sizeof(struct cx88_buffer
),
760 videobuf_queue_sg_init(&fh
->vbiq
, &cx8800_vbi_qops
,
761 &dev
->pci
->dev
, &dev
->slock
,
762 V4L2_BUF_TYPE_VBI_CAPTURE
,
764 sizeof(struct cx88_buffer
),
767 if (vdev
->vfl_type
== VFL_TYPE_RADIO
) {
768 dprintk(1,"video_open: setting radio device\n");
769 cx_write(MO_GP3_IO
, core
->board
.radio
.gpio3
);
770 cx_write(MO_GP0_IO
, core
->board
.radio
.gpio0
);
771 cx_write(MO_GP1_IO
, core
->board
.radio
.gpio1
);
772 cx_write(MO_GP2_IO
, core
->board
.radio
.gpio2
);
773 if (core
->board
.radio
.audioroute
) {
774 if(core
->board
.audio_chip
&&
775 core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
776 call_all(core
, audio
, s_routing
,
777 core
->board
.radio
.audioroute
, 0, 0);
780 core
->tvaudio
= WW_I2SADC
;
781 cx88_set_tvaudio(core
);
784 core
->tvaudio
= WW_FM
;
785 cx88_set_tvaudio(core
);
786 cx88_set_stereo(core
,V4L2_TUNER_MODE_STEREO
,1);
788 call_all(core
, tuner
, s_radio
);
792 mutex_unlock(&core
->lock
);
793 v4l2_fh_add(&fh
->fh
);
799 video_read(struct file
*file
, char __user
*data
, size_t count
, loff_t
*ppos
)
801 struct video_device
*vdev
= video_devdata(file
);
802 struct cx8800_fh
*fh
= file
->private_data
;
804 switch (vdev
->vfl_type
) {
805 case VFL_TYPE_GRABBER
:
806 if (res_locked(fh
->dev
,RESOURCE_VIDEO
))
808 return videobuf_read_one(&fh
->vidq
, data
, count
, ppos
,
809 file
->f_flags
& O_NONBLOCK
);
811 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
813 return videobuf_read_stream(&fh
->vbiq
, data
, count
, ppos
, 1,
814 file
->f_flags
& O_NONBLOCK
);
822 video_poll(struct file
*file
, struct poll_table_struct
*wait
)
824 struct video_device
*vdev
= video_devdata(file
);
825 struct cx8800_fh
*fh
= file
->private_data
;
826 struct cx88_buffer
*buf
;
827 unsigned int rc
= v4l2_ctrl_poll(file
, wait
);
829 if (vdev
->vfl_type
== VFL_TYPE_VBI
) {
830 if (!res_get(fh
->dev
,fh
,RESOURCE_VBI
))
832 return rc
| videobuf_poll_stream(file
, &fh
->vbiq
, wait
);
834 mutex_lock(&fh
->vidq
.vb_lock
);
835 if (res_check(fh
,RESOURCE_VIDEO
)) {
836 /* streaming capture */
837 if (list_empty(&fh
->vidq
.stream
))
839 buf
= list_entry(fh
->vidq
.stream
.next
,struct cx88_buffer
,vb
.stream
);
842 buf
= (struct cx88_buffer
*)fh
->vidq
.read_buf
;
846 poll_wait(file
, &buf
->vb
.done
, wait
);
847 if (buf
->vb
.state
== VIDEOBUF_DONE
||
848 buf
->vb
.state
== VIDEOBUF_ERROR
)
849 rc
|= POLLIN
|POLLRDNORM
;
851 mutex_unlock(&fh
->vidq
.vb_lock
);
855 static int video_release(struct file
*file
)
857 struct cx8800_fh
*fh
= file
->private_data
;
858 struct cx8800_dev
*dev
= fh
->dev
;
860 /* turn off overlay */
861 if (res_check(fh
, RESOURCE_OVERLAY
)) {
863 res_free(dev
,fh
,RESOURCE_OVERLAY
);
866 /* stop video capture */
867 if (res_check(fh
, RESOURCE_VIDEO
)) {
868 videobuf_queue_cancel(&fh
->vidq
);
869 res_free(dev
,fh
,RESOURCE_VIDEO
);
871 if (fh
->vidq
.read_buf
) {
872 buffer_release(&fh
->vidq
,fh
->vidq
.read_buf
);
873 kfree(fh
->vidq
.read_buf
);
876 /* stop vbi capture */
877 if (res_check(fh
, RESOURCE_VBI
)) {
878 videobuf_stop(&fh
->vbiq
);
879 res_free(dev
,fh
,RESOURCE_VBI
);
882 videobuf_mmap_free(&fh
->vidq
);
883 videobuf_mmap_free(&fh
->vbiq
);
885 mutex_lock(&dev
->core
->lock
);
886 v4l2_fh_del(&fh
->fh
);
887 v4l2_fh_exit(&fh
->fh
);
888 file
->private_data
= NULL
;
892 if (!dev
->core
->users
)
893 call_all(dev
->core
, core
, s_power
, 0);
894 mutex_unlock(&dev
->core
->lock
);
900 video_mmap(struct file
*file
, struct vm_area_struct
* vma
)
902 return videobuf_mmap_mapper(get_queue(file
), vma
);
905 /* ------------------------------------------------------------------ */
906 /* VIDEO CTRL IOCTLS */
908 static int cx8800_s_vid_ctrl(struct v4l2_ctrl
*ctrl
)
910 struct cx88_core
*core
=
911 container_of(ctrl
->handler
, struct cx88_core
, video_hdl
);
912 const struct cx88_ctrl
*cc
= ctrl
->priv
;
917 case V4L2_CID_SATURATION
:
918 /* special v_sat handling */
920 value
= ((ctrl
->val
- cc
->off
) << cc
->shift
) & cc
->mask
;
922 if (core
->tvnorm
& V4L2_STD_SECAM
) {
923 /* For SECAM, both U and V sat should be equal */
924 value
= value
<< 8 | value
;
926 /* Keeps U Saturation proportional to V Sat */
927 value
= (value
* 0x5a) / 0x7f << 8 | value
;
931 case V4L2_CID_SHARPNESS
:
932 /* 0b000, 0b100, 0b101, 0b110, or 0b111 */
933 value
= (ctrl
->val
< 1 ? 0 : ((ctrl
->val
+ 3) << 7));
934 /* needs to be set for both fields */
935 cx_andor(MO_FILTER_EVEN
, mask
, value
);
937 case V4L2_CID_CHROMA_AGC
:
938 value
= ((ctrl
->val
- cc
->off
) << cc
->shift
) & cc
->mask
;
941 value
= ((ctrl
->val
- cc
->off
) << cc
->shift
) & cc
->mask
;
944 dprintk(1, "set_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
945 ctrl
->id
, ctrl
->name
, ctrl
->val
, cc
->reg
, value
,
946 mask
, cc
->sreg
? " [shadowed]" : "");
948 cx_sandor(cc
->sreg
, cc
->reg
, mask
, value
);
950 cx_andor(cc
->reg
, mask
, value
);
954 static int cx8800_s_aud_ctrl(struct v4l2_ctrl
*ctrl
)
956 struct cx88_core
*core
=
957 container_of(ctrl
->handler
, struct cx88_core
, audio_hdl
);
958 const struct cx88_ctrl
*cc
= ctrl
->priv
;
961 /* Pass changes onto any WM8775 */
962 if (core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
964 case V4L2_CID_AUDIO_MUTE
:
965 wm8775_s_ctrl(core
, ctrl
->id
, ctrl
->val
);
967 case V4L2_CID_AUDIO_VOLUME
:
968 wm8775_s_ctrl(core
, ctrl
->id
, (ctrl
->val
) ?
969 (0x90 + ctrl
->val
) << 8 : 0);
971 case V4L2_CID_AUDIO_BALANCE
:
972 wm8775_s_ctrl(core
, ctrl
->id
, ctrl
->val
<< 9);
981 case V4L2_CID_AUDIO_BALANCE
:
982 value
= (ctrl
->val
< 0x40) ? (0x7f - ctrl
->val
) : (ctrl
->val
- 0x40);
984 case V4L2_CID_AUDIO_VOLUME
:
985 value
= 0x3f - (ctrl
->val
& 0x3f);
988 value
= ((ctrl
->val
- cc
->off
) << cc
->shift
) & cc
->mask
;
991 dprintk(1,"set_control id=0x%X(%s) ctrl=0x%02x, reg=0x%02x val=0x%02x (mask 0x%02x)%s\n",
992 ctrl
->id
, ctrl
->name
, ctrl
->val
, cc
->reg
, value
,
993 mask
, cc
->sreg
? " [shadowed]" : "");
995 cx_sandor(cc
->sreg
, cc
->reg
, mask
, value
);
997 cx_andor(cc
->reg
, mask
, value
);
1001 /* ------------------------------------------------------------------ */
1004 static int vidioc_g_fmt_vid_cap(struct file
*file
, void *priv
,
1005 struct v4l2_format
*f
)
1007 struct cx8800_fh
*fh
= priv
;
1008 struct cx8800_dev
*dev
= fh
->dev
;
1010 f
->fmt
.pix
.width
= dev
->width
;
1011 f
->fmt
.pix
.height
= dev
->height
;
1012 f
->fmt
.pix
.field
= fh
->vidq
.field
;
1013 f
->fmt
.pix
.pixelformat
= dev
->fmt
->fourcc
;
1014 f
->fmt
.pix
.bytesperline
=
1015 (f
->fmt
.pix
.width
* dev
->fmt
->depth
) >> 3;
1016 f
->fmt
.pix
.sizeimage
=
1017 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1018 f
->fmt
.pix
.colorspace
= V4L2_COLORSPACE_SMPTE170M
;
1022 static int vidioc_try_fmt_vid_cap(struct file
*file
, void *priv
,
1023 struct v4l2_format
*f
)
1025 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1026 const struct cx8800_fmt
*fmt
;
1027 enum v4l2_field field
;
1028 unsigned int maxw
, maxh
;
1030 fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1034 field
= f
->fmt
.pix
.field
;
1035 maxw
= norm_maxw(core
->tvnorm
);
1036 maxh
= norm_maxh(core
->tvnorm
);
1038 if (V4L2_FIELD_ANY
== field
) {
1039 field
= (f
->fmt
.pix
.height
> maxh
/2)
1040 ? V4L2_FIELD_INTERLACED
1041 : V4L2_FIELD_BOTTOM
;
1045 case V4L2_FIELD_TOP
:
1046 case V4L2_FIELD_BOTTOM
:
1049 case V4L2_FIELD_INTERLACED
:
1055 f
->fmt
.pix
.field
= field
;
1056 v4l_bound_align_image(&f
->fmt
.pix
.width
, 48, maxw
, 2,
1057 &f
->fmt
.pix
.height
, 32, maxh
, 0, 0);
1058 f
->fmt
.pix
.bytesperline
=
1059 (f
->fmt
.pix
.width
* fmt
->depth
) >> 3;
1060 f
->fmt
.pix
.sizeimage
=
1061 f
->fmt
.pix
.height
* f
->fmt
.pix
.bytesperline
;
1066 static int vidioc_s_fmt_vid_cap(struct file
*file
, void *priv
,
1067 struct v4l2_format
*f
)
1069 struct cx8800_fh
*fh
= priv
;
1070 struct cx8800_dev
*dev
= fh
->dev
;
1071 int err
= vidioc_try_fmt_vid_cap (file
,priv
,f
);
1075 dev
->fmt
= format_by_fourcc(f
->fmt
.pix
.pixelformat
);
1076 dev
->width
= f
->fmt
.pix
.width
;
1077 dev
->height
= f
->fmt
.pix
.height
;
1078 fh
->vidq
.field
= f
->fmt
.pix
.field
;
1082 void cx88_querycap(struct file
*file
, struct cx88_core
*core
,
1083 struct v4l2_capability
*cap
)
1085 struct video_device
*vdev
= video_devdata(file
);
1087 strlcpy(cap
->card
, core
->board
.name
, sizeof(cap
->card
));
1088 cap
->device_caps
= V4L2_CAP_READWRITE
| V4L2_CAP_STREAMING
;
1089 if (UNSET
!= core
->board
.tuner_type
)
1090 cap
->device_caps
|= V4L2_CAP_TUNER
;
1091 switch (vdev
->vfl_type
) {
1092 case VFL_TYPE_RADIO
:
1093 cap
->device_caps
= V4L2_CAP_RADIO
| V4L2_CAP_TUNER
;
1095 case VFL_TYPE_GRABBER
:
1096 cap
->device_caps
|= V4L2_CAP_VIDEO_CAPTURE
;
1099 cap
->device_caps
|= V4L2_CAP_VBI_CAPTURE
;
1102 cap
->capabilities
= cap
->device_caps
| V4L2_CAP_VIDEO_CAPTURE
|
1103 V4L2_CAP_VBI_CAPTURE
| V4L2_CAP_DEVICE_CAPS
;
1104 if (core
->board
.radio
.type
== CX88_RADIO
)
1105 cap
->capabilities
|= V4L2_CAP_RADIO
;
1107 EXPORT_SYMBOL(cx88_querycap
);
1109 static int vidioc_querycap(struct file
*file
, void *priv
,
1110 struct v4l2_capability
*cap
)
1112 struct cx8800_dev
*dev
= ((struct cx8800_fh
*)priv
)->dev
;
1113 struct cx88_core
*core
= dev
->core
;
1115 strcpy(cap
->driver
, "cx8800");
1116 sprintf(cap
->bus_info
, "PCI:%s", pci_name(dev
->pci
));
1117 cx88_querycap(file
, core
, cap
);
1121 static int vidioc_enum_fmt_vid_cap (struct file
*file
, void *priv
,
1122 struct v4l2_fmtdesc
*f
)
1124 if (unlikely(f
->index
>= ARRAY_SIZE(formats
)))
1127 strlcpy(f
->description
,formats
[f
->index
].name
,sizeof(f
->description
));
1128 f
->pixelformat
= formats
[f
->index
].fourcc
;
1133 static int vidioc_reqbufs (struct file
*file
, void *priv
, struct v4l2_requestbuffers
*p
)
1135 return videobuf_reqbufs(get_queue(file
), p
);
1138 static int vidioc_querybuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1140 return videobuf_querybuf(get_queue(file
), p
);
1143 static int vidioc_qbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1145 return videobuf_qbuf(get_queue(file
), p
);
1148 static int vidioc_dqbuf (struct file
*file
, void *priv
, struct v4l2_buffer
*p
)
1150 return videobuf_dqbuf(get_queue(file
), p
,
1151 file
->f_flags
& O_NONBLOCK
);
1154 static int vidioc_streamon(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1156 struct video_device
*vdev
= video_devdata(file
);
1157 struct cx8800_fh
*fh
= priv
;
1158 struct cx8800_dev
*dev
= fh
->dev
;
1160 if ((vdev
->vfl_type
== VFL_TYPE_GRABBER
&& i
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) ||
1161 (vdev
->vfl_type
== VFL_TYPE_VBI
&& i
!= V4L2_BUF_TYPE_VBI_CAPTURE
))
1164 if (unlikely(!res_get(dev
, fh
, get_resource(file
))))
1166 return videobuf_streamon(get_queue(file
));
1169 static int vidioc_streamoff(struct file
*file
, void *priv
, enum v4l2_buf_type i
)
1171 struct video_device
*vdev
= video_devdata(file
);
1172 struct cx8800_fh
*fh
= priv
;
1173 struct cx8800_dev
*dev
= fh
->dev
;
1176 if ((vdev
->vfl_type
== VFL_TYPE_GRABBER
&& i
!= V4L2_BUF_TYPE_VIDEO_CAPTURE
) ||
1177 (vdev
->vfl_type
== VFL_TYPE_VBI
&& i
!= V4L2_BUF_TYPE_VBI_CAPTURE
))
1180 res
= get_resource(file
);
1181 err
= videobuf_streamoff(get_queue(file
));
1184 res_free(dev
,fh
,res
);
1188 static int vidioc_g_std(struct file
*file
, void *priv
, v4l2_std_id
*tvnorm
)
1190 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1192 *tvnorm
= core
->tvnorm
;
1196 static int vidioc_s_std(struct file
*file
, void *priv
, v4l2_std_id tvnorms
)
1198 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1200 mutex_lock(&core
->lock
);
1201 cx88_set_tvnorm(core
, tvnorms
);
1202 mutex_unlock(&core
->lock
);
1207 /* only one input in this sample driver */
1208 int cx88_enum_input (struct cx88_core
*core
,struct v4l2_input
*i
)
1210 static const char * const iname
[] = {
1211 [ CX88_VMUX_COMPOSITE1
] = "Composite1",
1212 [ CX88_VMUX_COMPOSITE2
] = "Composite2",
1213 [ CX88_VMUX_COMPOSITE3
] = "Composite3",
1214 [ CX88_VMUX_COMPOSITE4
] = "Composite4",
1215 [ CX88_VMUX_SVIDEO
] = "S-Video",
1216 [ CX88_VMUX_TELEVISION
] = "Television",
1217 [ CX88_VMUX_CABLE
] = "Cable TV",
1218 [ CX88_VMUX_DVB
] = "DVB",
1219 [ CX88_VMUX_DEBUG
] = "for debug only",
1221 unsigned int n
= i
->index
;
1225 if (0 == INPUT(n
).type
)
1227 i
->type
= V4L2_INPUT_TYPE_CAMERA
;
1228 strcpy(i
->name
,iname
[INPUT(n
).type
]);
1229 if ((CX88_VMUX_TELEVISION
== INPUT(n
).type
) ||
1230 (CX88_VMUX_CABLE
== INPUT(n
).type
)) {
1231 i
->type
= V4L2_INPUT_TYPE_TUNER
;
1233 i
->std
= CX88_NORMS
;
1236 EXPORT_SYMBOL(cx88_enum_input
);
1238 static int vidioc_enum_input (struct file
*file
, void *priv
,
1239 struct v4l2_input
*i
)
1241 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1242 return cx88_enum_input (core
,i
);
1245 static int vidioc_g_input (struct file
*file
, void *priv
, unsigned int *i
)
1247 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1253 static int vidioc_s_input (struct file
*file
, void *priv
, unsigned int i
)
1255 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1259 if (0 == INPUT(i
).type
)
1262 mutex_lock(&core
->lock
);
1263 cx88_newstation(core
);
1264 cx88_video_mux(core
,i
);
1265 mutex_unlock(&core
->lock
);
1269 static int vidioc_g_tuner (struct file
*file
, void *priv
,
1270 struct v4l2_tuner
*t
)
1272 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1275 if (unlikely(UNSET
== core
->board
.tuner_type
))
1280 strcpy(t
->name
, "Television");
1281 t
->capability
= V4L2_TUNER_CAP_NORM
;
1282 t
->rangehigh
= 0xffffffffUL
;
1283 call_all(core
, tuner
, g_tuner
, t
);
1285 cx88_get_stereo(core
,t
);
1286 reg
= cx_read(MO_DEVICE_STATUS
);
1287 t
->signal
= (reg
& (1<<5)) ? 0xffff : 0x0000;
1291 static int vidioc_s_tuner (struct file
*file
, void *priv
,
1292 const struct v4l2_tuner
*t
)
1294 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1296 if (UNSET
== core
->board
.tuner_type
)
1301 cx88_set_stereo(core
, t
->audmode
, 1);
1305 static int vidioc_g_frequency (struct file
*file
, void *priv
,
1306 struct v4l2_frequency
*f
)
1308 struct cx8800_fh
*fh
= priv
;
1309 struct cx88_core
*core
= fh
->dev
->core
;
1311 if (unlikely(UNSET
== core
->board
.tuner_type
))
1316 f
->frequency
= core
->freq
;
1318 call_all(core
, tuner
, g_frequency
, f
);
1323 int cx88_set_freq (struct cx88_core
*core
,
1324 const struct v4l2_frequency
*f
)
1326 struct v4l2_frequency new_freq
= *f
;
1328 if (unlikely(UNSET
== core
->board
.tuner_type
))
1330 if (unlikely(f
->tuner
!= 0))
1333 mutex_lock(&core
->lock
);
1334 cx88_newstation(core
);
1335 call_all(core
, tuner
, s_frequency
, f
);
1336 call_all(core
, tuner
, g_frequency
, &new_freq
);
1337 core
->freq
= new_freq
.frequency
;
1339 /* When changing channels it is required to reset TVAUDIO */
1341 cx88_set_tvaudio(core
);
1343 mutex_unlock(&core
->lock
);
1347 EXPORT_SYMBOL(cx88_set_freq
);
1349 static int vidioc_s_frequency (struct file
*file
, void *priv
,
1350 const struct v4l2_frequency
*f
)
1352 struct cx8800_fh
*fh
= priv
;
1353 struct cx88_core
*core
= fh
->dev
->core
;
1355 return cx88_set_freq(core
, f
);
1358 static int vidioc_g_chip_ident(struct file
*file
, void *priv
,
1359 struct v4l2_dbg_chip_ident
*chip
)
1361 if (!v4l2_chip_match_host(&chip
->match
))
1364 chip
->ident
= V4L2_IDENT_UNKNOWN
;
1368 #ifdef CONFIG_VIDEO_ADV_DEBUG
1369 static int vidioc_g_register (struct file
*file
, void *fh
,
1370 struct v4l2_dbg_register
*reg
)
1372 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1374 if (!v4l2_chip_match_host(®
->match
))
1376 /* cx2388x has a 24-bit register space */
1377 reg
->val
= cx_read(reg
->reg
& 0xffffff);
1382 static int vidioc_s_register (struct file
*file
, void *fh
,
1383 const struct v4l2_dbg_register
*reg
)
1385 struct cx88_core
*core
= ((struct cx8800_fh
*)fh
)->dev
->core
;
1387 if (!v4l2_chip_match_host(®
->match
))
1389 cx_write(reg
->reg
& 0xffffff, reg
->val
);
1394 /* ----------------------------------------------------------- */
1395 /* RADIO ESPECIFIC IOCTLS */
1396 /* ----------------------------------------------------------- */
1398 static int radio_g_tuner (struct file
*file
, void *priv
,
1399 struct v4l2_tuner
*t
)
1401 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1403 if (unlikely(t
->index
> 0))
1406 strcpy(t
->name
, "Radio");
1408 call_all(core
, tuner
, g_tuner
, t
);
1412 static int radio_s_tuner (struct file
*file
, void *priv
,
1413 const struct v4l2_tuner
*t
)
1415 struct cx88_core
*core
= ((struct cx8800_fh
*)priv
)->dev
->core
;
1420 call_all(core
, tuner
, s_tuner
, t
);
1424 /* ----------------------------------------------------------- */
1426 static void cx8800_vid_timeout(unsigned long data
)
1428 struct cx8800_dev
*dev
= (struct cx8800_dev
*)data
;
1429 struct cx88_core
*core
= dev
->core
;
1430 struct cx88_dmaqueue
*q
= &dev
->vidq
;
1431 struct cx88_buffer
*buf
;
1432 unsigned long flags
;
1434 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1436 cx_clear(MO_VID_DMACNTRL
, 0x11);
1437 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1439 spin_lock_irqsave(&dev
->slock
,flags
);
1440 while (!list_empty(&q
->active
)) {
1441 buf
= list_entry(q
->active
.next
, struct cx88_buffer
, vb
.queue
);
1442 list_del(&buf
->vb
.queue
);
1443 buf
->vb
.state
= VIDEOBUF_ERROR
;
1444 wake_up(&buf
->vb
.done
);
1445 printk("%s/0: [%p/%d] timeout - dma=0x%08lx\n", core
->name
,
1446 buf
, buf
->vb
.i
, (unsigned long)buf
->risc
.dma
);
1448 restart_video_queue(dev
,q
);
1449 spin_unlock_irqrestore(&dev
->slock
,flags
);
1452 static const char *cx88_vid_irqs
[32] = {
1453 "y_risci1", "u_risci1", "v_risci1", "vbi_risc1",
1454 "y_risci2", "u_risci2", "v_risci2", "vbi_risc2",
1455 "y_oflow", "u_oflow", "v_oflow", "vbi_oflow",
1456 "y_sync", "u_sync", "v_sync", "vbi_sync",
1457 "opc_err", "par_err", "rip_err", "pci_abort",
1460 static void cx8800_vid_irq(struct cx8800_dev
*dev
)
1462 struct cx88_core
*core
= dev
->core
;
1463 u32 status
, mask
, count
;
1465 status
= cx_read(MO_VID_INTSTAT
);
1466 mask
= cx_read(MO_VID_INTMSK
);
1467 if (0 == (status
& mask
))
1469 cx_write(MO_VID_INTSTAT
, status
);
1470 if (irq_debug
|| (status
& mask
& ~0xff))
1471 cx88_print_irqbits(core
->name
, "irq vid",
1472 cx88_vid_irqs
, ARRAY_SIZE(cx88_vid_irqs
),
1475 /* risc op code error */
1476 if (status
& (1 << 16)) {
1477 printk(KERN_WARNING
"%s/0: video risc op code error\n",core
->name
);
1478 cx_clear(MO_VID_DMACNTRL
, 0x11);
1479 cx_clear(VID_CAPTURE_CONTROL
, 0x06);
1480 cx88_sram_channel_dump(core
, &cx88_sram_channels
[SRAM_CH21
]);
1484 if (status
& 0x01) {
1485 spin_lock(&dev
->slock
);
1486 count
= cx_read(MO_VIDY_GPCNT
);
1487 cx88_wakeup(core
, &dev
->vidq
, count
);
1488 spin_unlock(&dev
->slock
);
1492 if (status
& 0x08) {
1493 spin_lock(&dev
->slock
);
1494 count
= cx_read(MO_VBI_GPCNT
);
1495 cx88_wakeup(core
, &dev
->vbiq
, count
);
1496 spin_unlock(&dev
->slock
);
1500 if (status
& 0x10) {
1501 dprintk(2,"stopper video\n");
1502 spin_lock(&dev
->slock
);
1503 restart_video_queue(dev
,&dev
->vidq
);
1504 spin_unlock(&dev
->slock
);
1508 if (status
& 0x80) {
1509 dprintk(2,"stopper vbi\n");
1510 spin_lock(&dev
->slock
);
1511 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
1512 spin_unlock(&dev
->slock
);
1516 static irqreturn_t
cx8800_irq(int irq
, void *dev_id
)
1518 struct cx8800_dev
*dev
= dev_id
;
1519 struct cx88_core
*core
= dev
->core
;
1521 int loop
, handled
= 0;
1523 for (loop
= 0; loop
< 10; loop
++) {
1524 status
= cx_read(MO_PCI_INTSTAT
) &
1525 (core
->pci_irqmask
| PCI_INT_VIDINT
);
1528 cx_write(MO_PCI_INTSTAT
, status
);
1531 if (status
& core
->pci_irqmask
)
1532 cx88_core_irq(core
,status
);
1533 if (status
& PCI_INT_VIDINT
)
1534 cx8800_vid_irq(dev
);
1537 printk(KERN_WARNING
"%s/0: irq loop -- clearing mask\n",
1539 cx_write(MO_PCI_INTMSK
,0);
1543 return IRQ_RETVAL(handled
);
1546 /* ----------------------------------------------------------- */
1547 /* exported stuff */
1549 static const struct v4l2_file_operations video_fops
=
1551 .owner
= THIS_MODULE
,
1553 .release
= video_release
,
1557 .unlocked_ioctl
= video_ioctl2
,
1560 static const struct v4l2_ioctl_ops video_ioctl_ops
= {
1561 .vidioc_querycap
= vidioc_querycap
,
1562 .vidioc_enum_fmt_vid_cap
= vidioc_enum_fmt_vid_cap
,
1563 .vidioc_g_fmt_vid_cap
= vidioc_g_fmt_vid_cap
,
1564 .vidioc_try_fmt_vid_cap
= vidioc_try_fmt_vid_cap
,
1565 .vidioc_s_fmt_vid_cap
= vidioc_s_fmt_vid_cap
,
1566 .vidioc_reqbufs
= vidioc_reqbufs
,
1567 .vidioc_querybuf
= vidioc_querybuf
,
1568 .vidioc_qbuf
= vidioc_qbuf
,
1569 .vidioc_dqbuf
= vidioc_dqbuf
,
1570 .vidioc_g_std
= vidioc_g_std
,
1571 .vidioc_s_std
= vidioc_s_std
,
1572 .vidioc_enum_input
= vidioc_enum_input
,
1573 .vidioc_g_input
= vidioc_g_input
,
1574 .vidioc_s_input
= vidioc_s_input
,
1575 .vidioc_streamon
= vidioc_streamon
,
1576 .vidioc_streamoff
= vidioc_streamoff
,
1577 .vidioc_g_tuner
= vidioc_g_tuner
,
1578 .vidioc_s_tuner
= vidioc_s_tuner
,
1579 .vidioc_g_frequency
= vidioc_g_frequency
,
1580 .vidioc_s_frequency
= vidioc_s_frequency
,
1581 .vidioc_subscribe_event
= v4l2_ctrl_subscribe_event
,
1582 .vidioc_unsubscribe_event
= v4l2_event_unsubscribe
,
1583 .vidioc_g_chip_ident
= vidioc_g_chip_ident
,
1584 #ifdef CONFIG_VIDEO_ADV_DEBUG
1585 .vidioc_g_register
= vidioc_g_register
,
1586 .vidioc_s_register
= vidioc_s_register
,
1590 static const struct video_device cx8800_video_template
= {
1591 .name
= "cx8800-video",
1592 .fops
= &video_fops
,
1593 .ioctl_ops
= &video_ioctl_ops
,
1594 .tvnorms
= CX88_NORMS
,
1597 static const struct v4l2_ioctl_ops vbi_ioctl_ops
= {
1598 .vidioc_querycap
= vidioc_querycap
,
1599 .vidioc_g_fmt_vbi_cap
= cx8800_vbi_fmt
,
1600 .vidioc_try_fmt_vbi_cap
= cx8800_vbi_fmt
,
1601 .vidioc_s_fmt_vbi_cap
= cx8800_vbi_fmt
,
1602 .vidioc_reqbufs
= vidioc_reqbufs
,
1603 .vidioc_querybuf
= vidioc_querybuf
,
1604 .vidioc_qbuf
= vidioc_qbuf
,
1605 .vidioc_dqbuf
= vidioc_dqbuf
,
1606 .vidioc_g_std
= vidioc_g_std
,
1607 .vidioc_s_std
= vidioc_s_std
,
1608 .vidioc_enum_input
= vidioc_enum_input
,
1609 .vidioc_g_input
= vidioc_g_input
,
1610 .vidioc_s_input
= vidioc_s_input
,
1611 .vidioc_streamon
= vidioc_streamon
,
1612 .vidioc_streamoff
= vidioc_streamoff
,
1613 .vidioc_g_tuner
= vidioc_g_tuner
,
1614 .vidioc_s_tuner
= vidioc_s_tuner
,
1615 .vidioc_g_frequency
= vidioc_g_frequency
,
1616 .vidioc_s_frequency
= vidioc_s_frequency
,
1617 .vidioc_g_chip_ident
= vidioc_g_chip_ident
,
1618 #ifdef CONFIG_VIDEO_ADV_DEBUG
1619 .vidioc_g_register
= vidioc_g_register
,
1620 .vidioc_s_register
= vidioc_s_register
,
1624 static const struct video_device cx8800_vbi_template
= {
1625 .name
= "cx8800-vbi",
1626 .fops
= &video_fops
,
1627 .ioctl_ops
= &vbi_ioctl_ops
,
1628 .tvnorms
= CX88_NORMS
,
1631 static const struct v4l2_file_operations radio_fops
=
1633 .owner
= THIS_MODULE
,
1635 .poll
= v4l2_ctrl_poll
,
1636 .release
= video_release
,
1637 .unlocked_ioctl
= video_ioctl2
,
1640 static const struct v4l2_ioctl_ops radio_ioctl_ops
= {
1641 .vidioc_querycap
= vidioc_querycap
,
1642 .vidioc_g_tuner
= radio_g_tuner
,
1643 .vidioc_s_tuner
= radio_s_tuner
,
1644 .vidioc_g_frequency
= vidioc_g_frequency
,
1645 .vidioc_s_frequency
= vidioc_s_frequency
,
1646 .vidioc_subscribe_event
= v4l2_ctrl_subscribe_event
,
1647 .vidioc_unsubscribe_event
= v4l2_event_unsubscribe
,
1648 .vidioc_g_chip_ident
= vidioc_g_chip_ident
,
1649 #ifdef CONFIG_VIDEO_ADV_DEBUG
1650 .vidioc_g_register
= vidioc_g_register
,
1651 .vidioc_s_register
= vidioc_s_register
,
1655 static const struct video_device cx8800_radio_template
= {
1656 .name
= "cx8800-radio",
1657 .fops
= &radio_fops
,
1658 .ioctl_ops
= &radio_ioctl_ops
,
1661 static const struct v4l2_ctrl_ops cx8800_ctrl_vid_ops
= {
1662 .s_ctrl
= cx8800_s_vid_ctrl
,
1665 static const struct v4l2_ctrl_ops cx8800_ctrl_aud_ops
= {
1666 .s_ctrl
= cx8800_s_aud_ctrl
,
1669 /* ----------------------------------------------------------- */
1671 static void cx8800_unregister_video(struct cx8800_dev
*dev
)
1673 if (dev
->radio_dev
) {
1674 if (video_is_registered(dev
->radio_dev
))
1675 video_unregister_device(dev
->radio_dev
);
1677 video_device_release(dev
->radio_dev
);
1678 dev
->radio_dev
= NULL
;
1681 if (video_is_registered(dev
->vbi_dev
))
1682 video_unregister_device(dev
->vbi_dev
);
1684 video_device_release(dev
->vbi_dev
);
1685 dev
->vbi_dev
= NULL
;
1687 if (dev
->video_dev
) {
1688 if (video_is_registered(dev
->video_dev
))
1689 video_unregister_device(dev
->video_dev
);
1691 video_device_release(dev
->video_dev
);
1692 dev
->video_dev
= NULL
;
1696 static int cx8800_initdev(struct pci_dev
*pci_dev
,
1697 const struct pci_device_id
*pci_id
)
1699 struct cx8800_dev
*dev
;
1700 struct cx88_core
*core
;
1704 dev
= kzalloc(sizeof(*dev
),GFP_KERNEL
);
1710 if (pci_enable_device(pci_dev
)) {
1714 core
= cx88_core_get(dev
->pci
);
1721 /* print pci info */
1722 dev
->pci_rev
= pci_dev
->revision
;
1723 pci_read_config_byte(pci_dev
, PCI_LATENCY_TIMER
, &dev
->pci_lat
);
1724 printk(KERN_INFO
"%s/0: found at %s, rev: %d, irq: %d, "
1725 "latency: %d, mmio: 0x%llx\n", core
->name
,
1726 pci_name(pci_dev
), dev
->pci_rev
, pci_dev
->irq
,
1727 dev
->pci_lat
,(unsigned long long)pci_resource_start(pci_dev
,0));
1729 pci_set_master(pci_dev
);
1730 if (!pci_dma_supported(pci_dev
,DMA_BIT_MASK(32))) {
1731 printk("%s/0: Oops: no 32bit PCI DMA ???\n",core
->name
);
1736 /* initialize driver struct */
1737 spin_lock_init(&dev
->slock
);
1738 core
->tvnorm
= V4L2_STD_NTSC_M
;
1740 /* init video dma queues */
1741 INIT_LIST_HEAD(&dev
->vidq
.active
);
1742 INIT_LIST_HEAD(&dev
->vidq
.queued
);
1743 dev
->vidq
.timeout
.function
= cx8800_vid_timeout
;
1744 dev
->vidq
.timeout
.data
= (unsigned long)dev
;
1745 init_timer(&dev
->vidq
.timeout
);
1746 cx88_risc_stopper(dev
->pci
,&dev
->vidq
.stopper
,
1747 MO_VID_DMACNTRL
,0x11,0x00);
1749 /* init vbi dma queues */
1750 INIT_LIST_HEAD(&dev
->vbiq
.active
);
1751 INIT_LIST_HEAD(&dev
->vbiq
.queued
);
1752 dev
->vbiq
.timeout
.function
= cx8800_vbi_timeout
;
1753 dev
->vbiq
.timeout
.data
= (unsigned long)dev
;
1754 init_timer(&dev
->vbiq
.timeout
);
1755 cx88_risc_stopper(dev
->pci
,&dev
->vbiq
.stopper
,
1756 MO_VID_DMACNTRL
,0x88,0x00);
1759 err
= request_irq(pci_dev
->irq
, cx8800_irq
,
1760 IRQF_SHARED
| IRQF_DISABLED
, core
->name
, dev
);
1762 printk(KERN_ERR
"%s/0: can't get IRQ %d\n",
1763 core
->name
,pci_dev
->irq
);
1766 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
1768 for (i
= 0; i
< CX8800_AUD_CTLS
; i
++) {
1769 const struct cx88_ctrl
*cc
= &cx8800_aud_ctls
[i
];
1770 struct v4l2_ctrl
*vc
;
1772 vc
= v4l2_ctrl_new_std(&core
->audio_hdl
, &cx8800_ctrl_aud_ops
,
1773 cc
->id
, cc
->minimum
, cc
->maximum
, cc
->step
, cc
->default_value
);
1775 err
= core
->audio_hdl
.error
;
1778 vc
->priv
= (void *)cc
;
1781 for (i
= 0; i
< CX8800_VID_CTLS
; i
++) {
1782 const struct cx88_ctrl
*cc
= &cx8800_vid_ctls
[i
];
1783 struct v4l2_ctrl
*vc
;
1785 vc
= v4l2_ctrl_new_std(&core
->video_hdl
, &cx8800_ctrl_vid_ops
,
1786 cc
->id
, cc
->minimum
, cc
->maximum
, cc
->step
, cc
->default_value
);
1788 err
= core
->video_hdl
.error
;
1791 vc
->priv
= (void *)cc
;
1792 if (vc
->id
== V4L2_CID_CHROMA_AGC
)
1793 core
->chroma_agc
= vc
;
1795 v4l2_ctrl_add_handler(&core
->video_hdl
, &core
->audio_hdl
, NULL
);
1797 /* load and configure helper modules */
1799 if (core
->board
.audio_chip
== V4L2_IDENT_WM8775
) {
1800 struct i2c_board_info wm8775_info
= {
1803 .platform_data
= &core
->wm8775_data
,
1805 struct v4l2_subdev
*sd
;
1807 if (core
->boardnr
== CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1
)
1808 core
->wm8775_data
.is_nova_s
= true;
1810 core
->wm8775_data
.is_nova_s
= false;
1812 sd
= v4l2_i2c_new_subdev_board(&core
->v4l2_dev
, &core
->i2c_adap
,
1813 &wm8775_info
, NULL
);
1815 core
->sd_wm8775
= sd
;
1816 sd
->grp_id
= WM8775_GID
;
1820 if (core
->board
.audio_chip
== V4L2_IDENT_TVAUDIO
) {
1821 /* This probes for a tda9874 as is used on some
1822 Pixelview Ultra boards. */
1823 v4l2_i2c_new_subdev(&core
->v4l2_dev
, &core
->i2c_adap
,
1824 "tvaudio", 0, I2C_ADDRS(0xb0 >> 1));
1827 switch (core
->boardnr
) {
1828 case CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD
:
1829 case CX88_BOARD_DVICO_FUSIONHDTV_7_GOLD
: {
1830 static const struct i2c_board_info rtc_info
= {
1831 I2C_BOARD_INFO("isl1208", 0x6f)
1834 request_module("rtc-isl1208");
1835 core
->i2c_rtc
= i2c_new_device(&core
->i2c_adap
, &rtc_info
);
1837 /* break intentionally omitted */
1838 case CX88_BOARD_DVICO_FUSIONHDTV_5_PCI_NANO
:
1839 request_module("ir-kbd-i2c");
1842 /* Sets device info at pci_dev */
1843 pci_set_drvdata(pci_dev
, dev
);
1847 dev
->fmt
= format_by_fourcc(V4L2_PIX_FMT_BGR24
);
1849 /* initial device configuration */
1850 mutex_lock(&core
->lock
);
1851 cx88_set_tvnorm(core
, core
->tvnorm
);
1852 v4l2_ctrl_handler_setup(&core
->video_hdl
);
1853 v4l2_ctrl_handler_setup(&core
->audio_hdl
);
1854 cx88_video_mux(core
, 0);
1856 /* register v4l devices */
1857 dev
->video_dev
= cx88_vdev_init(core
,dev
->pci
,
1858 &cx8800_video_template
,"video");
1859 video_set_drvdata(dev
->video_dev
, dev
);
1860 dev
->video_dev
->ctrl_handler
= &core
->video_hdl
;
1861 err
= video_register_device(dev
->video_dev
,VFL_TYPE_GRABBER
,
1862 video_nr
[core
->nr
]);
1864 printk(KERN_ERR
"%s/0: can't register video device\n",
1868 printk(KERN_INFO
"%s/0: registered device %s [v4l2]\n",
1869 core
->name
, video_device_node_name(dev
->video_dev
));
1871 dev
->vbi_dev
= cx88_vdev_init(core
,dev
->pci
,&cx8800_vbi_template
,"vbi");
1872 video_set_drvdata(dev
->vbi_dev
, dev
);
1873 err
= video_register_device(dev
->vbi_dev
,VFL_TYPE_VBI
,
1876 printk(KERN_ERR
"%s/0: can't register vbi device\n",
1880 printk(KERN_INFO
"%s/0: registered device %s\n",
1881 core
->name
, video_device_node_name(dev
->vbi_dev
));
1883 if (core
->board
.radio
.type
== CX88_RADIO
) {
1884 dev
->radio_dev
= cx88_vdev_init(core
,dev
->pci
,
1885 &cx8800_radio_template
,"radio");
1886 video_set_drvdata(dev
->radio_dev
, dev
);
1887 dev
->radio_dev
->ctrl_handler
= &core
->audio_hdl
;
1888 err
= video_register_device(dev
->radio_dev
,VFL_TYPE_RADIO
,
1889 radio_nr
[core
->nr
]);
1891 printk(KERN_ERR
"%s/0: can't register radio device\n",
1895 printk(KERN_INFO
"%s/0: registered device %s\n",
1896 core
->name
, video_device_node_name(dev
->radio_dev
));
1899 /* start tvaudio thread */
1900 if (core
->board
.tuner_type
!= TUNER_ABSENT
) {
1901 core
->kthread
= kthread_run(cx88_audio_thread
, core
, "cx88 tvaudio");
1902 if (IS_ERR(core
->kthread
)) {
1903 err
= PTR_ERR(core
->kthread
);
1904 printk(KERN_ERR
"%s/0: failed to create cx88 audio thread, err=%d\n",
1908 mutex_unlock(&core
->lock
);
1913 cx8800_unregister_video(dev
);
1914 free_irq(pci_dev
->irq
, dev
);
1915 mutex_unlock(&core
->lock
);
1917 cx88_core_put(core
,dev
->pci
);
1923 static void cx8800_finidev(struct pci_dev
*pci_dev
)
1925 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
1926 struct cx88_core
*core
= dev
->core
;
1929 if (core
->kthread
) {
1930 kthread_stop(core
->kthread
);
1931 core
->kthread
= NULL
;
1937 cx88_shutdown(core
); /* FIXME */
1938 pci_disable_device(pci_dev
);
1940 /* unregister stuff */
1942 free_irq(pci_dev
->irq
, dev
);
1943 cx8800_unregister_video(dev
);
1944 pci_set_drvdata(pci_dev
, NULL
);
1947 btcx_riscmem_free(dev
->pci
,&dev
->vidq
.stopper
);
1948 cx88_core_put(core
,dev
->pci
);
1953 static int cx8800_suspend(struct pci_dev
*pci_dev
, pm_message_t state
)
1955 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
1956 struct cx88_core
*core
= dev
->core
;
1957 unsigned long flags
;
1959 /* stop video+vbi capture */
1960 spin_lock_irqsave(&dev
->slock
, flags
);
1961 if (!list_empty(&dev
->vidq
.active
)) {
1962 printk("%s/0: suspend video\n", core
->name
);
1963 stop_video_dma(dev
);
1964 del_timer(&dev
->vidq
.timeout
);
1966 if (!list_empty(&dev
->vbiq
.active
)) {
1967 printk("%s/0: suspend vbi\n", core
->name
);
1968 cx8800_stop_vbi_dma(dev
);
1969 del_timer(&dev
->vbiq
.timeout
);
1971 spin_unlock_irqrestore(&dev
->slock
, flags
);
1975 /* FIXME -- shutdown device */
1976 cx88_shutdown(core
);
1978 pci_save_state(pci_dev
);
1979 if (0 != pci_set_power_state(pci_dev
, pci_choose_state(pci_dev
, state
))) {
1980 pci_disable_device(pci_dev
);
1981 dev
->state
.disabled
= 1;
1986 static int cx8800_resume(struct pci_dev
*pci_dev
)
1988 struct cx8800_dev
*dev
= pci_get_drvdata(pci_dev
);
1989 struct cx88_core
*core
= dev
->core
;
1990 unsigned long flags
;
1993 if (dev
->state
.disabled
) {
1994 err
=pci_enable_device(pci_dev
);
1996 printk(KERN_ERR
"%s/0: can't enable device\n",
2001 dev
->state
.disabled
= 0;
2003 err
= pci_set_power_state(pci_dev
, PCI_D0
);
2005 printk(KERN_ERR
"%s/0: can't set power state\n", core
->name
);
2006 pci_disable_device(pci_dev
);
2007 dev
->state
.disabled
= 1;
2011 pci_restore_state(pci_dev
);
2013 /* FIXME: re-initialize hardware */
2016 cx88_ir_start(core
);
2018 cx_set(MO_PCI_INTMSK
, core
->pci_irqmask
);
2020 /* restart video+vbi capture */
2021 spin_lock_irqsave(&dev
->slock
, flags
);
2022 if (!list_empty(&dev
->vidq
.active
)) {
2023 printk("%s/0: resume video\n", core
->name
);
2024 restart_video_queue(dev
,&dev
->vidq
);
2026 if (!list_empty(&dev
->vbiq
.active
)) {
2027 printk("%s/0: resume vbi\n", core
->name
);
2028 cx8800_restart_vbi_queue(dev
,&dev
->vbiq
);
2030 spin_unlock_irqrestore(&dev
->slock
, flags
);
2036 /* ----------------------------------------------------------- */
2038 static const struct pci_device_id cx8800_pci_tbl
[] = {
2042 .subvendor
= PCI_ANY_ID
,
2043 .subdevice
= PCI_ANY_ID
,
2045 /* --- end of list --- */
2048 MODULE_DEVICE_TABLE(pci
, cx8800_pci_tbl
);
2050 static struct pci_driver cx8800_pci_driver
= {
2052 .id_table
= cx8800_pci_tbl
,
2053 .probe
= cx8800_initdev
,
2054 .remove
= cx8800_finidev
,
2056 .suspend
= cx8800_suspend
,
2057 .resume
= cx8800_resume
,
2061 static int __init
cx8800_init(void)
2063 printk(KERN_INFO
"cx88/0: cx2388x v4l2 driver version %s loaded\n",
2065 return pci_register_driver(&cx8800_pci_driver
);
2068 static void __exit
cx8800_fini(void)
2070 pci_unregister_driver(&cx8800_pci_driver
);
2073 module_init(cx8800_init
);
2074 module_exit(cx8800_fini
);