3 * device driver for philips saa7134 based TV cards
4 * video4linux video interface
6 * (c) 2001-03 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include <linux/init.h>
24 #include <linux/list.h>
25 #include <linux/module.h>
26 #include <linux/moduleparam.h>
27 #include <linux/kernel.h>
28 #include <linux/slab.h>
30 #include "saa7134-reg.h"
33 /* Include V4L1 specific functions. Should be removed soon */
34 #include <linux/videodev.h>
36 /* ------------------------------------------------------------------ */
38 static unsigned int video_debug = 0;
39 static unsigned int gbuffers = 8;
40 static unsigned int noninterlaced = 0;
41 static unsigned int gbufsize = 720*576*4;
42 static unsigned int gbufsize_max = 720*576*4;
43 module_param(video_debug, int, 0644);
44 MODULE_PARM_DESC(video_debug,"enable debug messages [video]");
45 module_param(gbuffers, int, 0444);
46 MODULE_PARM_DESC(gbuffers,"number of capture buffers, range 2-32");
47 module_param(noninterlaced, int, 0644);
48 MODULE_PARM_DESC(noninterlaced,"video input is noninterlaced");
50 #define dprintk(fmt, arg...) if (video_debug) \
51 printk(KERN_DEBUG "%s/video: " fmt, dev->name , ## arg)
53 /* ------------------------------------------------------------------ */
54 /* Defines for Video Output Port Register at address 0x191 */
56 /* Bit 0: VIP code T bit polarity */
58 #define VP_T_CODE_P_NON_INVERTED 0x00
59 #define VP_T_CODE_P_INVERTED 0x01
61 /* ------------------------------------------------------------------ */
62 /* Defines for Video Output Port Register at address 0x195 */
64 /* Bit 2: Video output clock delay control */
66 #define VP_CLK_CTRL2_NOT_DELAYED 0x00
67 #define VP_CLK_CTRL2_DELAYED 0x04
69 /* Bit 1: Video output clock invert control */
71 #define VP_CLK_CTRL1_NON_INVERTED 0x00
72 #define VP_CLK_CTRL1_INVERTED 0x02
74 /* ------------------------------------------------------------------ */
75 /* Defines for Video Output Port Register at address 0x196 */
77 /* Bits 2 to 0: VSYNC pin video vertical sync type */
79 #define VP_VS_TYPE_MASK 0x07
81 #define VP_VS_TYPE_OFF 0x00
82 #define VP_VS_TYPE_V123 0x01
83 #define VP_VS_TYPE_V_ITU 0x02
84 #define VP_VS_TYPE_VGATE_L 0x03
85 #define VP_VS_TYPE_RESERVED1 0x04
86 #define VP_VS_TYPE_RESERVED2 0x05
87 #define VP_VS_TYPE_F_ITU 0x06
88 #define VP_VS_TYPE_SC_FID 0x07
90 /* ------------------------------------------------------------------ */
91 /* data structs for video */
93 static int video_out[][9] = {
94 [CCIR656] = { 0x00, 0xb1, 0x00, 0xa1, 0x00, 0x04, 0x06, 0x00, 0x00 },
97 static struct saa7134_format formats[] = {
100 .fourcc = V4L2_PIX_FMT_GREY,
104 .name = "15 bpp RGB, le",
105 .fourcc = V4L2_PIX_FMT_RGB555,
109 .name = "15 bpp RGB, be",
110 .fourcc = V4L2_PIX_FMT_RGB555X,
115 .name = "16 bpp RGB, le",
116 .fourcc = V4L2_PIX_FMT_RGB565,
120 .name = "16 bpp RGB, be",
121 .fourcc = V4L2_PIX_FMT_RGB565X,
126 .name = "24 bpp RGB, le",
127 .fourcc = V4L2_PIX_FMT_BGR24,
131 .name = "24 bpp RGB, be",
132 .fourcc = V4L2_PIX_FMT_RGB24,
137 .name = "32 bpp RGB, le",
138 .fourcc = V4L2_PIX_FMT_BGR32,
142 .name = "32 bpp RGB, be",
143 .fourcc = V4L2_PIX_FMT_RGB32,
149 .name = "4:2:2 packed, YUYV",
150 .fourcc = V4L2_PIX_FMT_YUYV,
156 .name = "4:2:2 packed, UYVY",
157 .fourcc = V4L2_PIX_FMT_UYVY,
162 .name = "4:2:2 planar, Y-Cb-Cr",
163 .fourcc = V4L2_PIX_FMT_YUV422P,
171 .name = "4:2:0 planar, Y-Cb-Cr",
172 .fourcc = V4L2_PIX_FMT_YUV420,
180 .name = "4:2:0 planar, Y-Cb-Cr",
181 .fourcc = V4L2_PIX_FMT_YVU420,
191 #define FORMATS ARRAY_SIZE(formats)
193 #define NORM_625_50 \
196 .video_v_start = 24, \
197 .video_v_stop = 311, \
198 .vbi_v_start_0 = 7, \
199 .vbi_v_stop_0 = 22, \
200 .vbi_v_start_1 = 319, \
203 #define NORM_525_60 \
206 .video_v_start = 23, \
207 .video_v_stop = 262, \
208 .vbi_v_start_0 = 10, \
209 .vbi_v_stop_0 = 21, \
210 .vbi_v_start_1 = 273, \
213 static struct saa7134_tvnorm tvnorms[] = {
215 .name = "PAL", /* autodetect */
219 .sync_control = 0x18,
220 .luma_control = 0x40,
221 .chroma_ctrl1 = 0x81,
223 .chroma_ctrl2 = 0x06,
228 .id = V4L2_STD_PAL_BG,
231 .sync_control = 0x18,
232 .luma_control = 0x40,
233 .chroma_ctrl1 = 0x81,
235 .chroma_ctrl2 = 0x06,
240 .id = V4L2_STD_PAL_I,
243 .sync_control = 0x18,
244 .luma_control = 0x40,
245 .chroma_ctrl1 = 0x81,
247 .chroma_ctrl2 = 0x06,
252 .id = V4L2_STD_PAL_DK,
255 .sync_control = 0x18,
256 .luma_control = 0x40,
257 .chroma_ctrl1 = 0x81,
259 .chroma_ctrl2 = 0x06,
267 .sync_control = 0x59,
268 .luma_control = 0x40,
269 .chroma_ctrl1 = 0x89,
271 .chroma_ctrl2 = 0x0e,
276 .id = V4L2_STD_SECAM,
279 .sync_control = 0x18, /* old: 0x58, */
280 .luma_control = 0x1b,
281 .chroma_ctrl1 = 0xd1,
283 .chroma_ctrl2 = 0x00,
288 .id = V4L2_STD_PAL_M,
291 .sync_control = 0x59,
292 .luma_control = 0x40,
293 .chroma_ctrl1 = 0xb9,
295 .chroma_ctrl2 = 0x0e,
300 .id = V4L2_STD_PAL_Nc,
303 .sync_control = 0x18,
304 .luma_control = 0x40,
305 .chroma_ctrl1 = 0xa1,
307 .chroma_ctrl2 = 0x06,
312 .id = V4L2_STD_PAL_60,
320 .vbi_v_start_1 = 273,
323 .sync_control = 0x18,
324 .luma_control = 0x40,
325 .chroma_ctrl1 = 0x81,
327 .chroma_ctrl2 = 0x06,
331 #define TVNORMS ARRAY_SIZE(tvnorms)
333 #define V4L2_CID_PRIVATE_INVERT (V4L2_CID_PRIVATE_BASE + 0)
334 #define V4L2_CID_PRIVATE_Y_ODD (V4L2_CID_PRIVATE_BASE + 1)
335 #define V4L2_CID_PRIVATE_Y_EVEN (V4L2_CID_PRIVATE_BASE + 2)
336 #define V4L2_CID_PRIVATE_AUTOMUTE (V4L2_CID_PRIVATE_BASE + 3)
337 #define V4L2_CID_PRIVATE_LASTP1 (V4L2_CID_PRIVATE_BASE + 4)
339 static const struct v4l2_queryctrl no_ctrl = {
341 .flags = V4L2_CTRL_FLAG_DISABLED,
343 static const struct v4l2_queryctrl video_ctrls[] = {
346 .id = V4L2_CID_BRIGHTNESS,
347 .name = "Brightness",
351 .default_value = 128,
352 .type = V4L2_CTRL_TYPE_INTEGER,
354 .id = V4L2_CID_CONTRAST,
360 .type = V4L2_CTRL_TYPE_INTEGER,
362 .id = V4L2_CID_SATURATION,
363 .name = "Saturation",
368 .type = V4L2_CTRL_TYPE_INTEGER,
376 .type = V4L2_CTRL_TYPE_INTEGER,
378 .id = V4L2_CID_HFLIP,
382 .type = V4L2_CTRL_TYPE_BOOLEAN,
386 .id = V4L2_CID_AUDIO_MUTE,
390 .type = V4L2_CTRL_TYPE_BOOLEAN,
392 .id = V4L2_CID_AUDIO_VOLUME,
398 .type = V4L2_CTRL_TYPE_INTEGER,
400 /* --- private --- */
402 .id = V4L2_CID_PRIVATE_INVERT,
406 .type = V4L2_CTRL_TYPE_BOOLEAN,
408 .id = V4L2_CID_PRIVATE_Y_ODD,
409 .name = "y offset odd field",
413 .type = V4L2_CTRL_TYPE_INTEGER,
415 .id = V4L2_CID_PRIVATE_Y_EVEN,
416 .name = "y offset even field",
420 .type = V4L2_CTRL_TYPE_INTEGER,
422 .id = V4L2_CID_PRIVATE_AUTOMUTE,
427 .type = V4L2_CTRL_TYPE_BOOLEAN,
430 static const unsigned int CTRLS = ARRAY_SIZE(video_ctrls);
432 static const struct v4l2_queryctrl* ctrl_by_id(unsigned int id)
436 for (i = 0; i < CTRLS; i++)
437 if (video_ctrls[i].id == id)
438 return video_ctrls+i;
442 static struct saa7134_format* format_by_fourcc(unsigned int fourcc)
446 for (i = 0; i < FORMATS; i++)
447 if (formats[i].fourcc == fourcc)
452 /* ----------------------------------------------------------------------- */
453 /* resource management */
455 static int res_get(struct saa7134_dev *dev, struct saa7134_fh *fh, unsigned int bit)
457 if (fh->resources & bit)
458 /* have it already allocated */
463 if (dev->resources & bit) {
464 /* no, someone else uses it */
468 /* it's free, grab it */
469 fh->resources |= bit;
470 dev->resources |= bit;
471 dprintk("res: get %d\n",bit);
477 int res_check(struct saa7134_fh *fh, unsigned int bit)
479 return (fh->resources & bit);
483 int res_locked(struct saa7134_dev *dev, unsigned int bit)
485 return (dev->resources & bit);
489 void res_free(struct saa7134_dev *dev, struct saa7134_fh *fh, unsigned int bits)
491 if ((fh->resources & bits) != bits)
495 fh->resources &= ~bits;
496 dev->resources &= ~bits;
497 dprintk("res: put %d\n",bits);
501 /* ------------------------------------------------------------------ */
503 static void set_tvnorm(struct saa7134_dev *dev, struct saa7134_tvnorm *norm)
505 int luma_control,sync_control,mux;
507 dprintk("set tv norm = %s\n",norm->name);
510 mux = card_in(dev,dev->ctl_input).vmux;
511 luma_control = norm->luma_control;
512 sync_control = norm->sync_control;
515 luma_control |= 0x80; /* svideo */
516 if (noninterlaced || dev->nosignal)
517 sync_control |= 0x20;
520 dev->crop_bounds.left = norm->h_start;
521 dev->crop_defrect.left = norm->h_start;
522 dev->crop_bounds.width = norm->h_stop - norm->h_start +1;
523 dev->crop_defrect.width = norm->h_stop - norm->h_start +1;
525 dev->crop_bounds.top = (norm->vbi_v_stop_0+1)*2;
526 dev->crop_defrect.top = norm->video_v_start*2;
527 dev->crop_bounds.height = ((norm->id & V4L2_STD_525_60) ? 524 : 624)
528 - dev->crop_bounds.top;
529 dev->crop_defrect.height = (norm->video_v_stop - norm->video_v_start +1)*2;
531 dev->crop_current = dev->crop_defrect;
533 /* setup video decoder */
534 saa_writeb(SAA7134_INCR_DELAY, 0x08);
535 saa_writeb(SAA7134_ANALOG_IN_CTRL1, 0xc0 | mux);
536 saa_writeb(SAA7134_ANALOG_IN_CTRL2, 0x00);
538 saa_writeb(SAA7134_ANALOG_IN_CTRL3, 0x90);
539 saa_writeb(SAA7134_ANALOG_IN_CTRL4, 0x90);
540 saa_writeb(SAA7134_HSYNC_START, 0xeb);
541 saa_writeb(SAA7134_HSYNC_STOP, 0xe0);
542 saa_writeb(SAA7134_SOURCE_TIMING1, norm->src_timing);
544 saa_writeb(SAA7134_SYNC_CTRL, sync_control);
545 saa_writeb(SAA7134_LUMA_CTRL, luma_control);
546 saa_writeb(SAA7134_DEC_LUMA_BRIGHT, dev->ctl_bright);
547 saa_writeb(SAA7134_DEC_LUMA_CONTRAST, dev->ctl_contrast);
549 saa_writeb(SAA7134_DEC_CHROMA_SATURATION, dev->ctl_saturation);
550 saa_writeb(SAA7134_DEC_CHROMA_HUE, dev->ctl_hue);
551 saa_writeb(SAA7134_CHROMA_CTRL1, norm->chroma_ctrl1);
552 saa_writeb(SAA7134_CHROMA_GAIN, norm->chroma_gain);
554 saa_writeb(SAA7134_CHROMA_CTRL2, norm->chroma_ctrl2);
555 saa_writeb(SAA7134_MODE_DELAY_CTRL, 0x00);
557 saa_writeb(SAA7134_ANALOG_ADC, 0x01);
558 saa_writeb(SAA7134_VGATE_START, 0x11);
559 saa_writeb(SAA7134_VGATE_STOP, 0xfe);
560 saa_writeb(SAA7134_MISC_VGATE_MSB, norm->vgate_misc);
561 saa_writeb(SAA7134_RAW_DATA_GAIN, 0x40);
562 saa_writeb(SAA7134_RAW_DATA_OFFSET, 0x80);
564 saa7134_i2c_call_clients(dev,VIDIOC_S_STD,&norm->id);
567 static void video_mux(struct saa7134_dev *dev, int input)
569 dprintk("video input = %d [%s]\n",input,card_in(dev,input).name);
570 dev->ctl_input = input;
571 set_tvnorm(dev,dev->tvnorm);
572 saa7134_tvaudio_setinput(dev,&card_in(dev,input));
575 static void set_h_prescale(struct saa7134_dev *dev, int task, int prescale)
577 static const struct {
584 /* XPSC XACL XC2_1 XDCG VPFY */
596 static const int count = ARRAY_SIZE(vals);
599 for (i = 0; i < count; i++)
600 if (vals[i].xpsc == prescale)
605 saa_writeb(SAA7134_H_PRESCALE(task), vals[i].xpsc);
606 saa_writeb(SAA7134_ACC_LENGTH(task), vals[i].xacl);
607 saa_writeb(SAA7134_LEVEL_CTRL(task),
608 (vals[i].xc2_1 << 3) | (vals[i].xdcg));
609 saa_andorb(SAA7134_FIR_PREFILTER_CTRL(task), 0x0f,
610 (vals[i].vpfy << 2) | vals[i].vpfy);
613 static void set_v_scale(struct saa7134_dev *dev, int task, int yscale)
617 saa_writeb(SAA7134_V_SCALE_RATIO1(task), yscale & 0xff);
618 saa_writeb(SAA7134_V_SCALE_RATIO2(task), yscale >> 8);
620 mirror = (dev->ctl_mirror) ? 0x02 : 0x00;
623 dprintk("yscale LPI yscale=%d\n",yscale);
624 saa_writeb(SAA7134_V_FILTER(task), 0x00 | mirror);
625 saa_writeb(SAA7134_LUMA_CONTRAST(task), 0x40);
626 saa_writeb(SAA7134_CHROMA_SATURATION(task), 0x40);
629 val = 0x40 * 1024 / yscale;
630 dprintk("yscale ACM yscale=%d val=0x%x\n",yscale,val);
631 saa_writeb(SAA7134_V_FILTER(task), 0x01 | mirror);
632 saa_writeb(SAA7134_LUMA_CONTRAST(task), val);
633 saa_writeb(SAA7134_CHROMA_SATURATION(task), val);
635 saa_writeb(SAA7134_LUMA_BRIGHT(task), 0x80);
638 static void set_size(struct saa7134_dev *dev, int task,
639 int width, int height, int interlace)
641 int prescale,xscale,yscale,y_even,y_odd;
642 int h_start, h_stop, v_start, v_stop;
643 int div = interlace ? 2 : 1;
645 /* setup video scaler */
646 h_start = dev->crop_current.left;
647 v_start = dev->crop_current.top/2;
648 h_stop = (dev->crop_current.left + dev->crop_current.width -1);
649 v_stop = (dev->crop_current.top + dev->crop_current.height -1)/2;
651 saa_writeb(SAA7134_VIDEO_H_START1(task), h_start & 0xff);
652 saa_writeb(SAA7134_VIDEO_H_START2(task), h_start >> 8);
653 saa_writeb(SAA7134_VIDEO_H_STOP1(task), h_stop & 0xff);
654 saa_writeb(SAA7134_VIDEO_H_STOP2(task), h_stop >> 8);
655 saa_writeb(SAA7134_VIDEO_V_START1(task), v_start & 0xff);
656 saa_writeb(SAA7134_VIDEO_V_START2(task), v_start >> 8);
657 saa_writeb(SAA7134_VIDEO_V_STOP1(task), v_stop & 0xff);
658 saa_writeb(SAA7134_VIDEO_V_STOP2(task), v_stop >> 8);
660 prescale = dev->crop_current.width / width;
663 xscale = 1024 * dev->crop_current.width / prescale / width;
664 yscale = 512 * div * dev->crop_current.height / height;
665 dprintk("prescale=%d xscale=%d yscale=%d\n",prescale,xscale,yscale);
666 set_h_prescale(dev,task,prescale);
667 saa_writeb(SAA7134_H_SCALE_INC1(task), xscale & 0xff);
668 saa_writeb(SAA7134_H_SCALE_INC2(task), xscale >> 8);
669 set_v_scale(dev,task,yscale);
671 saa_writeb(SAA7134_VIDEO_PIXELS1(task), width & 0xff);
672 saa_writeb(SAA7134_VIDEO_PIXELS2(task), width >> 8);
673 saa_writeb(SAA7134_VIDEO_LINES1(task), height/div & 0xff);
674 saa_writeb(SAA7134_VIDEO_LINES2(task), height/div >> 8);
676 /* deinterlace y offsets */
677 y_odd = dev->ctl_y_odd;
678 y_even = dev->ctl_y_even;
679 saa_writeb(SAA7134_V_PHASE_OFFSET0(task), y_odd);
680 saa_writeb(SAA7134_V_PHASE_OFFSET1(task), y_even);
681 saa_writeb(SAA7134_V_PHASE_OFFSET2(task), y_odd);
682 saa_writeb(SAA7134_V_PHASE_OFFSET3(task), y_even);
685 /* ------------------------------------------------------------------ */
693 static void sort_cliplist(struct cliplist *cl, int entries)
695 struct cliplist swap;
698 for (i = entries-2; i >= 0; i--) {
699 for (n = 0, j = 0; j <= i; j++) {
700 if (cl[j].position > cl[j+1].position) {
712 static void set_cliplist(struct saa7134_dev *dev, int reg,
713 struct cliplist *cl, int entries, char *name)
718 for (i = 0; i < entries; i++) {
719 winbits |= cl[i].enable;
720 winbits &= ~cl[i].disable;
721 if (i < 15 && cl[i].position == cl[i+1].position)
723 saa_writeb(reg + 0, winbits);
724 saa_writeb(reg + 2, cl[i].position & 0xff);
725 saa_writeb(reg + 3, cl[i].position >> 8);
726 dprintk("clip: %s winbits=%02x pos=%d\n",
727 name,winbits,cl[i].position);
730 for (; reg < 0x400; reg += 8) {
731 saa_writeb(reg+ 0, 0);
732 saa_writeb(reg + 1, 0);
733 saa_writeb(reg + 2, 0);
734 saa_writeb(reg + 3, 0);
738 static int clip_range(int val)
745 static int setup_clipping(struct saa7134_dev *dev, struct v4l2_clip *clips,
746 int nclips, int interlace)
748 struct cliplist col[16], row[16];
750 int div = interlace ? 2 : 1;
752 memset(col,0,sizeof(col)); cols = 0;
753 memset(row,0,sizeof(row)); rows = 0;
754 for (i = 0; i < nclips && i < 8; i++) {
755 col[cols].position = clip_range(clips[i].c.left);
756 col[cols].enable = (1 << i);
758 col[cols].position = clip_range(clips[i].c.left+clips[i].c.width);
759 col[cols].disable = (1 << i);
761 row[rows].position = clip_range(clips[i].c.top / div);
762 row[rows].enable = (1 << i);
764 row[rows].position = clip_range((clips[i].c.top + clips[i].c.height)
766 row[rows].disable = (1 << i);
769 sort_cliplist(col,cols);
770 sort_cliplist(row,rows);
771 set_cliplist(dev,0x380,col,cols,"cols");
772 set_cliplist(dev,0x384,row,rows,"rows");
776 static int verify_preview(struct saa7134_dev *dev, struct v4l2_window *win)
778 enum v4l2_field field;
781 if (NULL == dev->ovbuf.base)
783 if (NULL == dev->ovfmt)
785 if (win->w.width < 48 || win->w.height < 32)
787 if (win->clipcount > 2048)
791 maxw = dev->crop_current.width;
792 maxh = dev->crop_current.height;
794 if (V4L2_FIELD_ANY == field) {
795 field = (win->w.height > maxh/2)
796 ? V4L2_FIELD_INTERLACED
801 case V4L2_FIELD_BOTTOM:
804 case V4L2_FIELD_INTERLACED:
811 if (win->w.width > maxw)
813 if (win->w.height > maxh)
814 win->w.height = maxh;
818 static int start_preview(struct saa7134_dev *dev, struct saa7134_fh *fh)
820 unsigned long base,control,bpl;
823 err = verify_preview(dev,&fh->win);
827 dev->ovfield = fh->win.field;
828 dprintk("start_preview %dx%d+%d+%d %s field=%s\n",
829 fh->win.w.width,fh->win.w.height,
830 fh->win.w.left,fh->win.w.top,
831 dev->ovfmt->name,v4l2_field_names[dev->ovfield]);
833 /* setup window + clipping */
834 set_size(dev,TASK_B,fh->win.w.width,fh->win.w.height,
835 V4L2_FIELD_HAS_BOTH(dev->ovfield));
836 setup_clipping(dev,fh->clips,fh->nclips,
837 V4L2_FIELD_HAS_BOTH(dev->ovfield));
839 saa_andorb(SAA7134_DATA_PATH(TASK_B), 0x3f, 0x03);
841 saa_andorb(SAA7134_DATA_PATH(TASK_B), 0x3f, 0x01);
842 saa_writeb(SAA7134_OFMT_VIDEO_B, dev->ovfmt->pm | 0x20);
844 /* dma: setup channel 1 (= Video Task B) */
845 base = (unsigned long)dev->ovbuf.base;
846 base += dev->ovbuf.fmt.bytesperline * fh->win.w.top;
847 base += dev->ovfmt->depth/8 * fh->win.w.left;
848 bpl = dev->ovbuf.fmt.bytesperline;
849 control = SAA7134_RS_CONTROL_BURST_16;
850 if (dev->ovfmt->bswap)
851 control |= SAA7134_RS_CONTROL_BSWAP;
852 if (dev->ovfmt->wswap)
853 control |= SAA7134_RS_CONTROL_WSWAP;
854 if (V4L2_FIELD_HAS_BOTH(dev->ovfield)) {
855 saa_writel(SAA7134_RS_BA1(1),base);
856 saa_writel(SAA7134_RS_BA2(1),base+bpl);
857 saa_writel(SAA7134_RS_PITCH(1),bpl*2);
858 saa_writel(SAA7134_RS_CONTROL(1),control);
860 saa_writel(SAA7134_RS_BA1(1),base);
861 saa_writel(SAA7134_RS_BA2(1),base);
862 saa_writel(SAA7134_RS_PITCH(1),bpl);
863 saa_writel(SAA7134_RS_CONTROL(1),control);
868 saa7134_set_dmabits(dev);
873 static int stop_preview(struct saa7134_dev *dev, struct saa7134_fh *fh)
876 saa7134_set_dmabits(dev);
880 /* ------------------------------------------------------------------ */
882 static int buffer_activate(struct saa7134_dev *dev,
883 struct saa7134_buf *buf,
884 struct saa7134_buf *next)
886 unsigned long base,control,bpl;
887 unsigned long bpl_uv,lines_uv,base2,base3,tmp; /* planar */
889 dprintk("buffer_activate buf=%p\n",buf);
890 buf->vb.state = STATE_ACTIVE;
893 set_size(dev,TASK_A,buf->vb.width,buf->vb.height,
894 V4L2_FIELD_HAS_BOTH(buf->vb.field));
896 saa_andorb(SAA7134_DATA_PATH(TASK_A), 0x3f, 0x03);
898 saa_andorb(SAA7134_DATA_PATH(TASK_A), 0x3f, 0x01);
899 saa_writeb(SAA7134_OFMT_VIDEO_A, buf->fmt->pm);
901 /* DMA: setup channel 0 (= Video Task A0) */
902 base = saa7134_buffer_base(buf);
903 if (buf->fmt->planar)
906 bpl = (buf->vb.width * buf->fmt->depth) / 8;
907 control = SAA7134_RS_CONTROL_BURST_16 |
908 SAA7134_RS_CONTROL_ME |
909 (buf->pt->dma >> 12);
911 control |= SAA7134_RS_CONTROL_BSWAP;
913 control |= SAA7134_RS_CONTROL_WSWAP;
914 if (V4L2_FIELD_HAS_BOTH(buf->vb.field)) {
916 saa_writel(SAA7134_RS_BA1(0),base);
917 saa_writel(SAA7134_RS_BA2(0),base+bpl);
918 saa_writel(SAA7134_RS_PITCH(0),bpl*2);
921 saa_writel(SAA7134_RS_BA1(0),base);
922 saa_writel(SAA7134_RS_BA2(0),base);
923 saa_writel(SAA7134_RS_PITCH(0),bpl);
925 saa_writel(SAA7134_RS_CONTROL(0),control);
927 if (buf->fmt->planar) {
928 /* DMA: setup channel 4+5 (= planar task A) */
929 bpl_uv = bpl >> buf->fmt->hshift;
930 lines_uv = buf->vb.height >> buf->fmt->vshift;
931 base2 = base + bpl * buf->vb.height;
932 base3 = base2 + bpl_uv * lines_uv;
933 if (buf->fmt->uvswap)
934 tmp = base2, base2 = base3, base3 = tmp;
935 dprintk("uv: bpl=%ld lines=%ld base2/3=%ld/%ld\n",
936 bpl_uv,lines_uv,base2,base3);
937 if (V4L2_FIELD_HAS_BOTH(buf->vb.field)) {
939 saa_writel(SAA7134_RS_BA1(4),base2);
940 saa_writel(SAA7134_RS_BA2(4),base2+bpl_uv);
941 saa_writel(SAA7134_RS_PITCH(4),bpl_uv*2);
942 saa_writel(SAA7134_RS_BA1(5),base3);
943 saa_writel(SAA7134_RS_BA2(5),base3+bpl_uv);
944 saa_writel(SAA7134_RS_PITCH(5),bpl_uv*2);
947 saa_writel(SAA7134_RS_BA1(4),base2);
948 saa_writel(SAA7134_RS_BA2(4),base2);
949 saa_writel(SAA7134_RS_PITCH(4),bpl_uv);
950 saa_writel(SAA7134_RS_BA1(5),base3);
951 saa_writel(SAA7134_RS_BA2(5),base3);
952 saa_writel(SAA7134_RS_PITCH(5),bpl_uv);
954 saa_writel(SAA7134_RS_CONTROL(4),control);
955 saa_writel(SAA7134_RS_CONTROL(5),control);
959 saa7134_set_dmabits(dev);
960 mod_timer(&dev->video_q.timeout, jiffies+BUFFER_TIMEOUT);
964 static int buffer_prepare(struct videobuf_queue *q,
965 struct videobuf_buffer *vb,
966 enum v4l2_field field)
968 struct saa7134_fh *fh = q->priv_data;
969 struct saa7134_dev *dev = fh->dev;
970 struct saa7134_buf *buf = container_of(vb,struct saa7134_buf,vb);
977 if (fh->width < 48 ||
979 fh->width/4 > dev->crop_current.width ||
980 fh->height/4 > dev->crop_current.height ||
981 fh->width > dev->crop_bounds.width ||
982 fh->height > dev->crop_bounds.height)
984 size = (fh->width * fh->height * fh->fmt->depth) >> 3;
985 if (0 != buf->vb.baddr && buf->vb.bsize < size)
988 dprintk("buffer_prepare [%d,size=%dx%d,bytes=%d,fields=%s,%s]\n",
989 vb->i,fh->width,fh->height,size,v4l2_field_names[field],
991 if (buf->vb.width != fh->width ||
992 buf->vb.height != fh->height ||
993 buf->vb.size != size ||
994 buf->vb.field != field ||
995 buf->fmt != fh->fmt) {
996 saa7134_dma_free(dev,buf);
999 if (STATE_NEEDS_INIT == buf->vb.state) {
1000 buf->vb.width = fh->width;
1001 buf->vb.height = fh->height;
1002 buf->vb.size = size;
1003 buf->vb.field = field;
1005 buf->pt = &fh->pt_cap;
1007 err = videobuf_iolock(dev->pci,&buf->vb,&dev->ovbuf);
1010 err = saa7134_pgtable_build(dev->pci,buf->pt,
1013 saa7134_buffer_startpage(buf));
1017 buf->vb.state = STATE_PREPARED;
1018 buf->activate = buffer_activate;
1022 saa7134_dma_free(dev,buf);
1027 buffer_setup(struct videobuf_queue *q, unsigned int *count, unsigned int *size)
1029 struct saa7134_fh *fh = q->priv_data;
1031 *size = fh->fmt->depth * fh->width * fh->height >> 3;
1034 *count = saa7134_buffer_count(*size,*count);
1038 static void buffer_queue(struct videobuf_queue *q, struct videobuf_buffer *vb)
1040 struct saa7134_fh *fh = q->priv_data;
1041 struct saa7134_buf *buf = container_of(vb,struct saa7134_buf,vb);
1043 saa7134_buffer_queue(fh->dev,&fh->dev->video_q,buf);
1046 static void buffer_release(struct videobuf_queue *q, struct videobuf_buffer *vb)
1048 struct saa7134_fh *fh = q->priv_data;
1049 struct saa7134_buf *buf = container_of(vb,struct saa7134_buf,vb);
1051 saa7134_dma_free(fh->dev,buf);
1054 static struct videobuf_queue_ops video_qops = {
1055 .buf_setup = buffer_setup,
1056 .buf_prepare = buffer_prepare,
1057 .buf_queue = buffer_queue,
1058 .buf_release = buffer_release,
1061 /* ------------------------------------------------------------------ */
1063 static int get_control(struct saa7134_dev *dev, struct v4l2_control *c)
1065 const struct v4l2_queryctrl* ctrl;
1067 ctrl = ctrl_by_id(c->id);
1071 case V4L2_CID_BRIGHTNESS:
1072 c->value = dev->ctl_bright;
1075 c->value = dev->ctl_hue;
1077 case V4L2_CID_CONTRAST:
1078 c->value = dev->ctl_contrast;
1080 case V4L2_CID_SATURATION:
1081 c->value = dev->ctl_saturation;
1083 case V4L2_CID_AUDIO_MUTE:
1084 c->value = dev->ctl_mute;
1086 case V4L2_CID_AUDIO_VOLUME:
1087 c->value = dev->ctl_volume;
1089 case V4L2_CID_PRIVATE_INVERT:
1090 c->value = dev->ctl_invert;
1092 case V4L2_CID_HFLIP:
1093 c->value = dev->ctl_mirror;
1095 case V4L2_CID_PRIVATE_Y_EVEN:
1096 c->value = dev->ctl_y_even;
1098 case V4L2_CID_PRIVATE_Y_ODD:
1099 c->value = dev->ctl_y_odd;
1101 case V4L2_CID_PRIVATE_AUTOMUTE:
1102 c->value = dev->ctl_automute;
1110 static int set_control(struct saa7134_dev *dev, struct saa7134_fh *fh,
1111 struct v4l2_control *c)
1113 const struct v4l2_queryctrl* ctrl;
1114 unsigned long flags;
1115 int restart_overlay = 0;
1117 ctrl = ctrl_by_id(c->id);
1120 dprintk("set_control name=%s val=%d\n",ctrl->name,c->value);
1121 switch (ctrl->type) {
1122 case V4L2_CTRL_TYPE_BOOLEAN:
1123 case V4L2_CTRL_TYPE_MENU:
1124 case V4L2_CTRL_TYPE_INTEGER:
1125 if (c->value < ctrl->minimum)
1126 c->value = ctrl->minimum;
1127 if (c->value > ctrl->maximum)
1128 c->value = ctrl->maximum;
1134 case V4L2_CID_BRIGHTNESS:
1135 dev->ctl_bright = c->value;
1136 saa_writeb(SAA7134_DEC_LUMA_BRIGHT, dev->ctl_bright);
1139 dev->ctl_hue = c->value;
1140 saa_writeb(SAA7134_DEC_CHROMA_HUE, dev->ctl_hue);
1142 case V4L2_CID_CONTRAST:
1143 dev->ctl_contrast = c->value;
1144 saa_writeb(SAA7134_DEC_LUMA_CONTRAST,
1145 dev->ctl_invert ? -dev->ctl_contrast : dev->ctl_contrast);
1147 case V4L2_CID_SATURATION:
1148 dev->ctl_saturation = c->value;
1149 saa_writeb(SAA7134_DEC_CHROMA_SATURATION,
1150 dev->ctl_invert ? -dev->ctl_saturation : dev->ctl_saturation);
1152 case V4L2_CID_AUDIO_MUTE:
1153 dev->ctl_mute = c->value;
1154 saa7134_tvaudio_setmute(dev);
1156 case V4L2_CID_AUDIO_VOLUME:
1157 dev->ctl_volume = c->value;
1158 saa7134_tvaudio_setvolume(dev,dev->ctl_volume);
1160 case V4L2_CID_PRIVATE_INVERT:
1161 dev->ctl_invert = c->value;
1162 saa_writeb(SAA7134_DEC_LUMA_CONTRAST,
1163 dev->ctl_invert ? -dev->ctl_contrast : dev->ctl_contrast);
1164 saa_writeb(SAA7134_DEC_CHROMA_SATURATION,
1165 dev->ctl_invert ? -dev->ctl_saturation : dev->ctl_saturation);
1167 case V4L2_CID_HFLIP:
1168 dev->ctl_mirror = c->value;
1169 restart_overlay = 1;
1171 case V4L2_CID_PRIVATE_Y_EVEN:
1172 dev->ctl_y_even = c->value;
1173 restart_overlay = 1;
1175 case V4L2_CID_PRIVATE_Y_ODD:
1176 dev->ctl_y_odd = c->value;
1177 restart_overlay = 1;
1179 case V4L2_CID_PRIVATE_AUTOMUTE:
1180 dev->ctl_automute = c->value;
1181 if (dev->tda9887_conf) {
1182 if (dev->ctl_automute)
1183 dev->tda9887_conf |= TDA9887_AUTOMUTE;
1185 dev->tda9887_conf &= ~TDA9887_AUTOMUTE;
1186 saa7134_i2c_call_clients(dev, TDA9887_SET_CONFIG,
1187 &dev->tda9887_conf);
1193 if (restart_overlay && fh && res_check(fh, RESOURCE_OVERLAY)) {
1194 spin_lock_irqsave(&dev->slock,flags);
1195 stop_preview(dev,fh);
1196 start_preview(dev,fh);
1197 spin_unlock_irqrestore(&dev->slock,flags);
1202 /* ------------------------------------------------------------------ */
1204 static struct videobuf_queue* saa7134_queue(struct saa7134_fh *fh)
1206 struct videobuf_queue* q = NULL;
1209 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1212 case V4L2_BUF_TYPE_VBI_CAPTURE:
1221 static int saa7134_resource(struct saa7134_fh *fh)
1226 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1227 res = RESOURCE_VIDEO;
1229 case V4L2_BUF_TYPE_VBI_CAPTURE:
1238 static int video_open(struct inode *inode, struct file *file)
1240 int minor = iminor(inode);
1241 struct saa7134_dev *h,*dev = NULL;
1242 struct saa7134_fh *fh;
1243 struct list_head *list;
1244 enum v4l2_buf_type type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1246 list_for_each(list,&saa7134_devlist) {
1247 h = list_entry(list, struct saa7134_dev, devlist);
1248 if (h->video_dev && (h->video_dev->minor == minor))
1250 if (h->radio_dev && (h->radio_dev->minor == minor)) {
1254 if (h->vbi_dev && (h->vbi_dev->minor == minor)) {
1255 type = V4L2_BUF_TYPE_VBI_CAPTURE;
1262 dprintk("open minor=%d radio=%d type=%s\n",minor,radio,
1263 v4l2_type_names[type]);
1265 /* allocate + initialize per filehandle data */
1266 fh = kmalloc(sizeof(*fh),GFP_KERNEL);
1269 memset(fh,0,sizeof(*fh));
1270 file->private_data = fh;
1274 fh->fmt = format_by_fourcc(V4L2_PIX_FMT_BGR24);
1277 v4l2_prio_open(&dev->prio,&fh->prio);
1279 videobuf_queue_init(&fh->cap, &video_qops,
1280 dev->pci, &dev->slock,
1281 V4L2_BUF_TYPE_VIDEO_CAPTURE,
1282 V4L2_FIELD_INTERLACED,
1283 sizeof(struct saa7134_buf),
1285 videobuf_queue_init(&fh->vbi, &saa7134_vbi_qops,
1286 dev->pci, &dev->slock,
1287 V4L2_BUF_TYPE_VBI_CAPTURE,
1289 sizeof(struct saa7134_buf),
1291 saa7134_pgtable_alloc(dev->pci,&fh->pt_cap);
1292 saa7134_pgtable_alloc(dev->pci,&fh->pt_vbi);
1295 /* switch to radio mode */
1296 saa7134_tvaudio_setinput(dev,&card(dev).radio);
1297 saa7134_i2c_call_clients(dev,AUDC_SET_RADIO, NULL);
1299 /* switch to video/vbi mode */
1300 video_mux(dev,dev->ctl_input);
1306 video_read(struct file *file, char __user *data, size_t count, loff_t *ppos)
1308 struct saa7134_fh *fh = file->private_data;
1311 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1312 if (res_locked(fh->dev,RESOURCE_VIDEO))
1314 return videobuf_read_one(saa7134_queue(fh),
1316 file->f_flags & O_NONBLOCK);
1317 case V4L2_BUF_TYPE_VBI_CAPTURE:
1318 if (!res_get(fh->dev,fh,RESOURCE_VBI))
1320 return videobuf_read_stream(saa7134_queue(fh),
1321 data, count, ppos, 1,
1322 file->f_flags & O_NONBLOCK);
1331 video_poll(struct file *file, struct poll_table_struct *wait)
1333 struct saa7134_fh *fh = file->private_data;
1334 struct videobuf_buffer *buf = NULL;
1336 if (V4L2_BUF_TYPE_VBI_CAPTURE == fh->type)
1337 return videobuf_poll_stream(file, &fh->vbi, wait);
1339 if (res_check(fh,RESOURCE_VIDEO)) {
1340 if (!list_empty(&fh->cap.stream))
1341 buf = list_entry(fh->cap.stream.next, struct videobuf_buffer, stream);
1343 down(&fh->cap.lock);
1344 if (UNSET == fh->cap.read_off) {
1345 /* need to capture a new frame */
1346 if (res_locked(fh->dev,RESOURCE_VIDEO)) {
1350 if (0 != fh->cap.ops->buf_prepare(&fh->cap,fh->cap.read_buf,fh->cap.field)) {
1354 fh->cap.ops->buf_queue(&fh->cap,fh->cap.read_buf);
1355 fh->cap.read_off = 0;
1358 buf = fh->cap.read_buf;
1364 poll_wait(file, &buf->done, wait);
1365 if (buf->state == STATE_DONE ||
1366 buf->state == STATE_ERROR)
1367 return POLLIN|POLLRDNORM;
1371 static int video_release(struct inode *inode, struct file *file)
1373 struct saa7134_fh *fh = file->private_data;
1374 struct saa7134_dev *dev = fh->dev;
1375 unsigned long flags;
1377 /* turn off overlay */
1378 if (res_check(fh, RESOURCE_OVERLAY)) {
1379 spin_lock_irqsave(&dev->slock,flags);
1380 stop_preview(dev,fh);
1381 spin_unlock_irqrestore(&dev->slock,flags);
1382 res_free(dev,fh,RESOURCE_OVERLAY);
1385 /* stop video capture */
1386 if (res_check(fh, RESOURCE_VIDEO)) {
1387 videobuf_streamoff(&fh->cap);
1388 res_free(dev,fh,RESOURCE_VIDEO);
1390 if (fh->cap.read_buf) {
1391 buffer_release(&fh->cap,fh->cap.read_buf);
1392 kfree(fh->cap.read_buf);
1395 /* stop vbi capture */
1396 if (res_check(fh, RESOURCE_VBI)) {
1397 if (fh->vbi.streaming)
1398 videobuf_streamoff(&fh->vbi);
1399 if (fh->vbi.reading)
1400 videobuf_read_stop(&fh->vbi);
1401 res_free(dev,fh,RESOURCE_VBI);
1404 /* ts-capture will not work in planar mode, so turn it off Hac: 04.05*/
1405 saa_andorb(SAA7134_OFMT_VIDEO_A, 0x1f, 0);
1406 saa_andorb(SAA7134_OFMT_VIDEO_B, 0x1f, 0);
1407 saa_andorb(SAA7134_OFMT_DATA_A, 0x1f, 0);
1408 saa_andorb(SAA7134_OFMT_DATA_B, 0x1f, 0);
1410 saa7134_i2c_call_clients(dev, TUNER_SET_STANDBY, NULL);
1413 videobuf_mmap_free(&fh->cap);
1414 videobuf_mmap_free(&fh->vbi);
1415 saa7134_pgtable_free(dev->pci,&fh->pt_cap);
1416 saa7134_pgtable_free(dev->pci,&fh->pt_vbi);
1418 v4l2_prio_close(&dev->prio,&fh->prio);
1419 file->private_data = NULL;
1425 video_mmap(struct file *file, struct vm_area_struct * vma)
1427 struct saa7134_fh *fh = file->private_data;
1429 return videobuf_mmap_mapper(saa7134_queue(fh), vma);
1432 /* ------------------------------------------------------------------ */
1434 static void saa7134_vbi_fmt(struct saa7134_dev *dev, struct v4l2_format *f)
1436 struct saa7134_tvnorm *norm = dev->tvnorm;
1438 f->fmt.vbi.sampling_rate = 6750000 * 4;
1439 f->fmt.vbi.samples_per_line = 2048 /* VBI_LINE_LENGTH */;
1440 f->fmt.vbi.sample_format = V4L2_PIX_FMT_GREY;
1441 f->fmt.vbi.offset = 64 * 4;
1442 f->fmt.vbi.start[0] = norm->vbi_v_start_0;
1443 f->fmt.vbi.count[0] = norm->vbi_v_stop_0 - norm->vbi_v_start_0 +1;
1444 f->fmt.vbi.start[1] = norm->vbi_v_start_1;
1445 f->fmt.vbi.count[1] = f->fmt.vbi.count[0];
1446 f->fmt.vbi.flags = 0; /* VBI_UNSYNC VBI_INTERLACED */
1450 static int saa7134_g_fmt(struct saa7134_dev *dev, struct saa7134_fh *fh,
1451 struct v4l2_format *f)
1454 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1455 memset(&f->fmt.pix,0,sizeof(f->fmt.pix));
1456 f->fmt.pix.width = fh->width;
1457 f->fmt.pix.height = fh->height;
1458 f->fmt.pix.field = fh->cap.field;
1459 f->fmt.pix.pixelformat = fh->fmt->fourcc;
1460 f->fmt.pix.bytesperline =
1461 (f->fmt.pix.width * fh->fmt->depth) >> 3;
1462 f->fmt.pix.sizeimage =
1463 f->fmt.pix.height * f->fmt.pix.bytesperline;
1465 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1466 f->fmt.win = fh->win;
1468 case V4L2_BUF_TYPE_VBI_CAPTURE:
1469 saa7134_vbi_fmt(dev,f);
1476 static int saa7134_try_fmt(struct saa7134_dev *dev, struct saa7134_fh *fh,
1477 struct v4l2_format *f)
1482 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1484 struct saa7134_format *fmt;
1485 enum v4l2_field field;
1486 unsigned int maxw, maxh;
1488 fmt = format_by_fourcc(f->fmt.pix.pixelformat);
1492 field = f->fmt.pix.field;
1493 maxw = min(dev->crop_current.width*4, dev->crop_bounds.width);
1494 maxh = min(dev->crop_current.height*4, dev->crop_bounds.height);
1496 if (V4L2_FIELD_ANY == field) {
1497 field = (f->fmt.pix.height > maxh/2)
1498 ? V4L2_FIELD_INTERLACED
1499 : V4L2_FIELD_BOTTOM;
1502 case V4L2_FIELD_TOP:
1503 case V4L2_FIELD_BOTTOM:
1506 case V4L2_FIELD_INTERLACED:
1512 f->fmt.pix.field = field;
1513 if (f->fmt.pix.width < 48)
1514 f->fmt.pix.width = 48;
1515 if (f->fmt.pix.height < 32)
1516 f->fmt.pix.height = 32;
1517 if (f->fmt.pix.width > maxw)
1518 f->fmt.pix.width = maxw;
1519 if (f->fmt.pix.height > maxh)
1520 f->fmt.pix.height = maxh;
1521 f->fmt.pix.width &= ~0x03;
1522 f->fmt.pix.bytesperline =
1523 (f->fmt.pix.width * fmt->depth) >> 3;
1524 f->fmt.pix.sizeimage =
1525 f->fmt.pix.height * f->fmt.pix.bytesperline;
1529 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1530 err = verify_preview(dev,&f->fmt.win);
1534 case V4L2_BUF_TYPE_VBI_CAPTURE:
1535 saa7134_vbi_fmt(dev,f);
1542 static int saa7134_s_fmt(struct saa7134_dev *dev, struct saa7134_fh *fh,
1543 struct v4l2_format *f)
1545 unsigned long flags;
1549 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1550 err = saa7134_try_fmt(dev,fh,f);
1554 fh->fmt = format_by_fourcc(f->fmt.pix.pixelformat);
1555 fh->width = f->fmt.pix.width;
1556 fh->height = f->fmt.pix.height;
1557 fh->cap.field = f->fmt.pix.field;
1559 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1560 err = verify_preview(dev,&f->fmt.win);
1565 fh->win = f->fmt.win;
1566 fh->nclips = f->fmt.win.clipcount;
1569 if (copy_from_user(fh->clips,f->fmt.win.clips,
1570 sizeof(struct v4l2_clip)*fh->nclips)) {
1575 if (res_check(fh, RESOURCE_OVERLAY)) {
1576 spin_lock_irqsave(&dev->slock,flags);
1577 stop_preview(dev,fh);
1578 start_preview(dev,fh);
1579 spin_unlock_irqrestore(&dev->slock,flags);
1583 case V4L2_BUF_TYPE_VBI_CAPTURE:
1584 saa7134_vbi_fmt(dev,f);
1591 int saa7134_common_ioctl(struct saa7134_dev *dev,
1592 unsigned int cmd, void *arg)
1597 case VIDIOC_QUERYCTRL:
1599 const struct v4l2_queryctrl *ctrl;
1600 struct v4l2_queryctrl *c = arg;
1602 if ((c->id < V4L2_CID_BASE ||
1603 c->id >= V4L2_CID_LASTP1) &&
1604 (c->id < V4L2_CID_PRIVATE_BASE ||
1605 c->id >= V4L2_CID_PRIVATE_LASTP1))
1607 ctrl = ctrl_by_id(c->id);
1608 *c = (NULL != ctrl) ? *ctrl : no_ctrl;
1612 return get_control(dev,arg);
1616 err = set_control(dev,NULL,arg);
1620 /* --- input switching --------------------------------------- */
1621 case VIDIOC_ENUMINPUT:
1623 struct v4l2_input *i = arg;
1627 if (n >= SAA7134_INPUT_MAX)
1629 if (NULL == card_in(dev,i->index).name)
1631 memset(i,0,sizeof(*i));
1633 i->type = V4L2_INPUT_TYPE_CAMERA;
1634 strcpy(i->name,card_in(dev,n).name);
1635 if (card_in(dev,n).tv)
1636 i->type = V4L2_INPUT_TYPE_TUNER;
1638 if (n == dev->ctl_input) {
1639 int v1 = saa_readb(SAA7134_STATUS_VIDEO1);
1640 int v2 = saa_readb(SAA7134_STATUS_VIDEO2);
1642 if (0 != (v1 & 0x40))
1643 i->status |= V4L2_IN_ST_NO_H_LOCK;
1644 if (0 != (v2 & 0x40))
1645 i->status |= V4L2_IN_ST_NO_SYNC;
1646 if (0 != (v2 & 0x0e))
1647 i->status |= V4L2_IN_ST_MACROVISION;
1649 for (n = 0; n < TVNORMS; n++)
1650 i->std |= tvnorms[n].id;
1653 case VIDIOC_G_INPUT:
1656 *i = dev->ctl_input;
1659 case VIDIOC_S_INPUT:
1663 if (*i < 0 || *i >= SAA7134_INPUT_MAX)
1665 if (NULL == card_in(dev,*i).name)
1676 EXPORT_SYMBOL(saa7134_common_ioctl);
1679 * This function is _not_ called directly, but from
1680 * video_generic_ioctl (and maybe others). userspace
1681 * copying is done already, arg is a kernel pointer.
1683 static int video_do_ioctl(struct inode *inode, struct file *file,
1684 unsigned int cmd, void *arg)
1686 struct saa7134_fh *fh = file->private_data;
1687 struct saa7134_dev *dev = fh->dev;
1688 unsigned long flags;
1691 if (video_debug > 1)
1692 saa7134_print_ioctl(dev->name,cmd);
1697 case VIDIOC_S_INPUT:
1698 case VIDIOC_S_TUNER:
1699 case VIDIOC_S_FREQUENCY:
1700 err = v4l2_prio_check(&dev->prio,&fh->prio);
1706 case VIDIOC_QUERYCAP:
1708 struct v4l2_capability *cap = arg;
1709 unsigned int tuner_type = dev->tuner_type;
1711 memset(cap,0,sizeof(*cap));
1712 strcpy(cap->driver, "saa7134");
1713 strlcpy(cap->card, saa7134_boards[dev->board].name,
1715 sprintf(cap->bus_info,"PCI:%s",pci_name(dev->pci));
1716 cap->version = SAA7134_VERSION_CODE;
1718 V4L2_CAP_VIDEO_CAPTURE |
1719 V4L2_CAP_VIDEO_OVERLAY |
1720 V4L2_CAP_VBI_CAPTURE |
1721 V4L2_CAP_READWRITE |
1722 V4L2_CAP_STREAMING |
1725 if ((tuner_type == TUNER_ABSENT) || (tuner_type == UNSET))
1726 cap->capabilities &= ~V4L2_CAP_TUNER;
1731 /* --- tv standards ------------------------------------------ */
1732 case VIDIOC_ENUMSTD:
1734 struct v4l2_standard *e = arg;
1740 err = v4l2_video_std_construct(e, tvnorms[e->index].id,
1741 tvnorms[e->index].name);
1749 v4l2_std_id *id = arg;
1751 *id = dev->tvnorm->id;
1756 v4l2_std_id *id = arg;
1759 for (i = 0; i < TVNORMS; i++)
1760 if (*id == tvnorms[i].id)
1763 for (i = 0; i < TVNORMS; i++)
1764 if (*id & tvnorms[i].id)
1770 if (res_check(fh, RESOURCE_OVERLAY)) {
1771 spin_lock_irqsave(&dev->slock,flags);
1772 stop_preview(dev,fh);
1773 set_tvnorm(dev,&tvnorms[i]);
1774 start_preview(dev,fh);
1775 spin_unlock_irqrestore(&dev->slock,flags);
1777 set_tvnorm(dev,&tvnorms[i]);
1778 saa7134_tvaudio_do_scan(dev);
1783 case VIDIOC_CROPCAP:
1785 struct v4l2_cropcap *cap = arg;
1787 if (cap->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
1788 cap->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)
1790 cap->bounds = dev->crop_bounds;
1791 cap->defrect = dev->crop_defrect;
1792 cap->pixelaspect.numerator = 1;
1793 cap->pixelaspect.denominator = 1;
1794 if (dev->tvnorm->id & V4L2_STD_525_60) {
1795 cap->pixelaspect.numerator = 11;
1796 cap->pixelaspect.denominator = 10;
1798 if (dev->tvnorm->id & V4L2_STD_625_50) {
1799 cap->pixelaspect.numerator = 54;
1800 cap->pixelaspect.denominator = 59;
1807 struct v4l2_crop * crop = arg;
1809 if (crop->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
1810 crop->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)
1812 crop->c = dev->crop_current;
1817 struct v4l2_crop *crop = arg;
1818 struct v4l2_rect *b = &dev->crop_bounds;
1820 if (crop->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
1821 crop->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)
1823 if (crop->c.height < 0)
1825 if (crop->c.width < 0)
1828 if (res_locked(fh->dev,RESOURCE_OVERLAY))
1830 if (res_locked(fh->dev,RESOURCE_VIDEO))
1833 if (crop->c.top < b->top)
1834 crop->c.top = b->top;
1835 if (crop->c.top > b->top + b->height)
1836 crop->c.top = b->top + b->height;
1837 if (crop->c.height > b->top - crop->c.top + b->height)
1838 crop->c.height = b->top - crop->c.top + b->height;
1840 if (crop->c.left < b->left)
1841 crop->c.left = b->left;
1842 if (crop->c.left > b->left + b->width)
1843 crop->c.left = b->left + b->width;
1844 if (crop->c.width > b->left - crop->c.left + b->width)
1845 crop->c.width = b->left - crop->c.left + b->width;
1847 dev->crop_current = crop->c;
1851 /* --- tuner ioctls ------------------------------------------ */
1852 case VIDIOC_G_TUNER:
1854 struct v4l2_tuner *t = arg;
1859 memset(t,0,sizeof(*t));
1860 for (n = 0; n < SAA7134_INPUT_MAX; n++)
1861 if (card_in(dev,n).tv)
1863 if (NULL != card_in(dev,n).name) {
1864 strcpy(t->name, "Television");
1865 t->type = V4L2_TUNER_ANALOG_TV;
1866 t->capability = V4L2_TUNER_CAP_NORM |
1867 V4L2_TUNER_CAP_STEREO |
1868 V4L2_TUNER_CAP_LANG1 |
1869 V4L2_TUNER_CAP_LANG2;
1870 t->rangehigh = 0xffffffffUL;
1871 t->rxsubchans = saa7134_tvaudio_getstereo(dev);
1872 t->audmode = saa7134_tvaudio_rx2mode(t->rxsubchans);
1874 if (0 != (saa_readb(SAA7134_STATUS_VIDEO1) & 0x03))
1878 case VIDIOC_S_TUNER:
1880 struct v4l2_tuner *t = arg;
1883 mode = dev->thread.mode;
1884 if (UNSET == mode) {
1885 rx = saa7134_tvaudio_getstereo(dev);
1886 mode = saa7134_tvaudio_rx2mode(t->rxsubchans);
1888 if (mode != t->audmode) {
1889 dev->thread.mode = t->audmode;
1893 case VIDIOC_G_FREQUENCY:
1895 struct v4l2_frequency *f = arg;
1897 memset(f,0,sizeof(*f));
1898 f->type = fh->radio ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
1899 f->frequency = dev->ctl_freq;
1902 case VIDIOC_S_FREQUENCY:
1904 struct v4l2_frequency *f = arg;
1908 if (0 == fh->radio && V4L2_TUNER_ANALOG_TV != f->type)
1910 if (1 == fh->radio && V4L2_TUNER_RADIO != f->type)
1913 dev->ctl_freq = f->frequency;
1915 saa7134_i2c_call_clients(dev,VIDIOC_S_FREQUENCY,f);
1917 saa7134_tvaudio_do_scan(dev);
1922 /* --- control ioctls ---------------------------------------- */
1923 case VIDIOC_ENUMINPUT:
1924 case VIDIOC_G_INPUT:
1925 case VIDIOC_S_INPUT:
1926 case VIDIOC_QUERYCTRL:
1929 return saa7134_common_ioctl(dev, cmd, arg);
1931 case VIDIOC_G_AUDIO:
1933 struct v4l2_audio *a = arg;
1935 memset(a,0,sizeof(*a));
1936 strcpy(a->name,"audio");
1939 case VIDIOC_S_AUDIO:
1943 struct v4l2_captureparm *parm = arg;
1944 memset(parm,0,sizeof(*parm));
1948 case VIDIOC_G_PRIORITY:
1950 enum v4l2_priority *p = arg;
1952 *p = v4l2_prio_max(&dev->prio);
1955 case VIDIOC_S_PRIORITY:
1957 enum v4l2_priority *prio = arg;
1959 return v4l2_prio_change(&dev->prio, &fh->prio, *prio);
1962 /* --- preview ioctls ---------------------------------------- */
1963 case VIDIOC_ENUM_FMT:
1965 struct v4l2_fmtdesc *f = arg;
1966 enum v4l2_buf_type type;
1972 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1973 case V4L2_BUF_TYPE_VIDEO_OVERLAY:
1974 if (index >= FORMATS)
1976 if (f->type == V4L2_BUF_TYPE_VIDEO_OVERLAY &&
1977 formats[index].planar)
1979 memset(f,0,sizeof(*f));
1982 strlcpy(f->description,formats[index].name,sizeof(f->description));
1983 f->pixelformat = formats[index].fourcc;
1985 case V4L2_BUF_TYPE_VBI_CAPTURE:
1988 memset(f,0,sizeof(*f));
1991 f->pixelformat = V4L2_PIX_FMT_GREY;
1992 strcpy(f->description,"vbi data");
2001 struct v4l2_framebuffer *fb = arg;
2004 fb->capability = V4L2_FBUF_CAP_LIST_CLIPPING;
2009 struct v4l2_framebuffer *fb = arg;
2010 struct saa7134_format *fmt;
2012 if(!capable(CAP_SYS_ADMIN) &&
2013 !capable(CAP_SYS_RAWIO))
2017 fmt = format_by_fourcc(fb->fmt.pixelformat);
2024 if (0 == dev->ovbuf.fmt.bytesperline)
2025 dev->ovbuf.fmt.bytesperline =
2026 dev->ovbuf.fmt.width*fmt->depth/8;
2029 case VIDIOC_OVERLAY:
2034 if (!res_get(dev,fh,RESOURCE_OVERLAY))
2036 spin_lock_irqsave(&dev->slock,flags);
2037 start_preview(dev,fh);
2038 spin_unlock_irqrestore(&dev->slock,flags);
2041 if (!res_check(fh, RESOURCE_OVERLAY))
2043 spin_lock_irqsave(&dev->slock,flags);
2044 stop_preview(dev,fh);
2045 spin_unlock_irqrestore(&dev->slock,flags);
2046 res_free(dev,fh,RESOURCE_OVERLAY);
2051 /* --- capture ioctls ---------------------------------------- */
2054 struct v4l2_format *f = arg;
2055 return saa7134_g_fmt(dev,fh,f);
2059 struct v4l2_format *f = arg;
2060 return saa7134_s_fmt(dev,fh,f);
2062 case VIDIOC_TRY_FMT:
2064 struct v4l2_format *f = arg;
2065 return saa7134_try_fmt(dev,fh,f);
2070 struct video_mbuf *mbuf = arg;
2071 struct videobuf_queue *q;
2072 struct v4l2_requestbuffers req;
2075 q = saa7134_queue(fh);
2076 memset(&req,0,sizeof(req));
2078 req.count = gbuffers;
2079 req.memory = V4L2_MEMORY_MMAP;
2080 err = videobuf_reqbufs(q,&req);
2083 memset(mbuf,0,sizeof(*mbuf));
2084 mbuf->frames = req.count;
2086 for (i = 0; i < mbuf->frames; i++) {
2087 mbuf->offsets[i] = q->bufs[i]->boff;
2088 mbuf->size += q->bufs[i]->bsize;
2093 case VIDIOC_REQBUFS:
2094 return videobuf_reqbufs(saa7134_queue(fh),arg);
2096 case VIDIOC_QUERYBUF:
2097 return videobuf_querybuf(saa7134_queue(fh),arg);
2100 return videobuf_qbuf(saa7134_queue(fh),arg);
2103 return videobuf_dqbuf(saa7134_queue(fh),arg,
2104 file->f_flags & O_NONBLOCK);
2106 case VIDIOC_STREAMON:
2108 int res = saa7134_resource(fh);
2110 if (!res_get(dev,fh,res))
2112 return videobuf_streamon(saa7134_queue(fh));
2114 case VIDIOC_STREAMOFF:
2116 int res = saa7134_resource(fh);
2118 err = videobuf_streamoff(saa7134_queue(fh));
2121 res_free(dev,fh,res);
2126 return v4l_compat_translate_ioctl(inode,file,cmd,arg,
2132 static int video_ioctl(struct inode *inode, struct file *file,
2133 unsigned int cmd, unsigned long arg)
2135 return video_usercopy(inode, file, cmd, arg, video_do_ioctl);
2138 static int radio_do_ioctl(struct inode *inode, struct file *file,
2139 unsigned int cmd, void *arg)
2141 struct saa7134_fh *fh = file->private_data;
2142 struct saa7134_dev *dev = fh->dev;
2144 if (video_debug > 1)
2145 saa7134_print_ioctl(dev->name,cmd);
2147 case VIDIOC_QUERYCAP:
2149 struct v4l2_capability *cap = arg;
2151 memset(cap,0,sizeof(*cap));
2152 strcpy(cap->driver, "saa7134");
2153 strlcpy(cap->card, saa7134_boards[dev->board].name,
2155 sprintf(cap->bus_info,"PCI:%s",pci_name(dev->pci));
2156 cap->version = SAA7134_VERSION_CODE;
2157 cap->capabilities = V4L2_CAP_TUNER;
2160 case VIDIOC_G_TUNER:
2162 struct v4l2_tuner *t = arg;
2167 memset(t,0,sizeof(*t));
2168 strcpy(t->name, "Radio");
2169 t->type = V4L2_TUNER_RADIO;
2171 saa7134_i2c_call_clients(dev, VIDIOC_G_TUNER, t);
2175 case VIDIOC_S_TUNER:
2177 struct v4l2_tuner *t = arg;
2182 saa7134_i2c_call_clients(dev,VIDIOC_S_TUNER,t);
2186 case VIDIOC_ENUMINPUT:
2188 struct v4l2_input *i = arg;
2192 strcpy(i->name,"Radio");
2193 i->type = V4L2_INPUT_TYPE_TUNER;
2196 case VIDIOC_G_INPUT:
2202 case VIDIOC_G_AUDIO:
2204 struct v4l2_audio *a = arg;
2206 memset(a,0,sizeof(*a));
2207 strcpy(a->name,"Radio");
2212 v4l2_std_id *id = arg;
2216 case VIDIOC_S_AUDIO:
2217 case VIDIOC_S_INPUT:
2221 case VIDIOC_QUERYCTRL:
2223 const struct v4l2_queryctrl *ctrl;
2224 struct v4l2_queryctrl *c = arg;
2226 if (c->id < V4L2_CID_BASE ||
2227 c->id >= V4L2_CID_LASTP1)
2229 if (c->id == V4L2_CID_AUDIO_MUTE) {
2230 ctrl = ctrl_by_id(c->id);
2239 case VIDIOC_G_FREQUENCY:
2240 case VIDIOC_S_FREQUENCY:
2241 return video_do_ioctl(inode,file,cmd,arg);
2244 return v4l_compat_translate_ioctl(inode,file,cmd,arg,
2250 static int radio_ioctl(struct inode *inode, struct file *file,
2251 unsigned int cmd, unsigned long arg)
2253 return video_usercopy(inode, file, cmd, arg, radio_do_ioctl);
2256 static struct file_operations video_fops =
2258 .owner = THIS_MODULE,
2260 .release = video_release,
2264 .ioctl = video_ioctl,
2265 .llseek = no_llseek,
2268 static struct file_operations radio_fops =
2270 .owner = THIS_MODULE,
2272 .release = video_release,
2273 .ioctl = radio_ioctl,
2274 .llseek = no_llseek,
2277 /* ----------------------------------------------------------- */
2278 /* exported stuff */
2280 struct video_device saa7134_video_template =
2282 .name = "saa7134-video",
2283 .type = VID_TYPE_CAPTURE|VID_TYPE_TUNER|VID_TYPE_OVERLAY|
2284 VID_TYPE_CLIPPING|VID_TYPE_SCALES,
2286 .fops = &video_fops,
2290 struct video_device saa7134_vbi_template =
2292 .name = "saa7134-vbi",
2293 .type = VID_TYPE_TUNER|VID_TYPE_TELETEXT,
2295 .fops = &video_fops,
2299 struct video_device saa7134_radio_template =
2301 .name = "saa7134-radio",
2302 .type = VID_TYPE_TUNER,
2304 .fops = &radio_fops,
2308 int saa7134_video_init1(struct saa7134_dev *dev)
2310 /* sanitycheck insmod options */
2311 if (gbuffers < 2 || gbuffers > VIDEO_MAX_FRAME)
2313 if (gbufsize < 0 || gbufsize > gbufsize_max)
2314 gbufsize = gbufsize_max;
2315 gbufsize = (gbufsize + PAGE_SIZE - 1) & PAGE_MASK;
2317 /* put some sensible defaults into the data structures ... */
2318 dev->ctl_bright = ctrl_by_id(V4L2_CID_BRIGHTNESS)->default_value;
2319 dev->ctl_contrast = ctrl_by_id(V4L2_CID_CONTRAST)->default_value;
2320 dev->ctl_hue = ctrl_by_id(V4L2_CID_HUE)->default_value;
2321 dev->ctl_saturation = ctrl_by_id(V4L2_CID_SATURATION)->default_value;
2322 dev->ctl_volume = ctrl_by_id(V4L2_CID_AUDIO_VOLUME)->default_value;
2323 dev->ctl_mute = 1; // ctrl_by_id(V4L2_CID_AUDIO_MUTE)->default_value;
2324 dev->ctl_invert = ctrl_by_id(V4L2_CID_PRIVATE_INVERT)->default_value;
2325 dev->ctl_automute = ctrl_by_id(V4L2_CID_PRIVATE_AUTOMUTE)->default_value;
2327 if (dev->tda9887_conf && dev->ctl_automute)
2328 dev->tda9887_conf |= TDA9887_AUTOMUTE;
2331 INIT_LIST_HEAD(&dev->video_q.queue);
2332 init_timer(&dev->video_q.timeout);
2333 dev->video_q.timeout.function = saa7134_buffer_timeout;
2334 dev->video_q.timeout.data = (unsigned long)(&dev->video_q);
2335 dev->video_q.dev = dev;
2337 if (saa7134_boards[dev->board].video_out) {
2338 /* enable video output */
2339 int vo = saa7134_boards[dev->board].video_out;
2341 unsigned int vid_port_opts = saa7134_boards[dev->board].vid_port_opts;
2342 saa_writeb(SAA7134_VIDEO_PORT_CTRL0, video_out[vo][0]);
2343 video_reg = video_out[vo][1];
2344 if (vid_port_opts & SET_T_CODE_POLARITY_NON_INVERTED)
2345 video_reg &= ~VP_T_CODE_P_INVERTED;
2346 saa_writeb(SAA7134_VIDEO_PORT_CTRL1, video_reg);
2347 saa_writeb(SAA7134_VIDEO_PORT_CTRL2, video_out[vo][2]);
2348 saa_writeb(SAA7134_VIDEO_PORT_CTRL3, video_out[vo][3]);
2349 saa_writeb(SAA7134_VIDEO_PORT_CTRL4, video_out[vo][4]);
2350 video_reg = video_out[vo][5];
2351 if (vid_port_opts & SET_CLOCK_NOT_DELAYED)
2352 video_reg &= ~VP_CLK_CTRL2_DELAYED;
2353 if (vid_port_opts & SET_CLOCK_INVERTED)
2354 video_reg |= VP_CLK_CTRL1_INVERTED;
2355 saa_writeb(SAA7134_VIDEO_PORT_CTRL5, video_reg);
2356 video_reg = video_out[vo][6];
2357 if (vid_port_opts & SET_VSYNC_OFF) {
2358 video_reg &= ~VP_VS_TYPE_MASK;
2359 video_reg |= VP_VS_TYPE_OFF;
2361 saa_writeb(SAA7134_VIDEO_PORT_CTRL6, video_reg);
2362 saa_writeb(SAA7134_VIDEO_PORT_CTRL7, video_out[vo][7]);
2363 saa_writeb(SAA7134_VIDEO_PORT_CTRL8, video_out[vo][8]);
2369 int saa7134_video_init2(struct saa7134_dev *dev)
2372 set_tvnorm(dev,&tvnorms[0]);
2374 saa7134_tvaudio_setmute(dev);
2375 saa7134_tvaudio_setvolume(dev,dev->ctl_volume);
2379 int saa7134_video_fini(struct saa7134_dev *dev)
2385 void saa7134_irq_video_intl(struct saa7134_dev *dev)
2387 static const char *st[] = {
2388 "(no signal)", "NTSC", "PAL", "SECAM" };
2391 st1 = saa_readb(SAA7134_STATUS_VIDEO1);
2392 st2 = saa_readb(SAA7134_STATUS_VIDEO2);
2393 dprintk("DCSDT: pll: %s, sync: %s, norm: %s\n",
2394 (st1 & 0x40) ? "not locked" : "locked",
2395 (st2 & 0x40) ? "no" : "yes",
2397 dev->nosignal = (st1 & 0x40) || (st2 & 0x40);
2399 if (dev->nosignal) {
2400 /* no video signal -> mute audio */
2401 if (dev->ctl_automute)
2403 saa7134_tvaudio_setmute(dev);
2404 saa_setb(SAA7134_SYNC_CTRL, 0x20);
2406 /* wake up tvaudio audio carrier scan thread */
2407 saa7134_tvaudio_do_scan(dev);
2409 saa_clearb(SAA7134_SYNC_CTRL, 0x20);
2411 if (dev->mops && dev->mops->signal_change)
2412 dev->mops->signal_change(dev);
2415 void saa7134_irq_video_done(struct saa7134_dev *dev, unsigned long status)
2417 enum v4l2_field field;
2419 spin_lock(&dev->slock);
2420 if (dev->video_q.curr) {
2421 dev->video_fieldcount++;
2422 field = dev->video_q.curr->vb.field;
2423 if (V4L2_FIELD_HAS_BOTH(field)) {
2424 /* make sure we have seen both fields */
2425 if ((status & 0x10) == 0x00) {
2426 dev->video_q.curr->top_seen = 1;
2429 if (!dev->video_q.curr->top_seen)
2431 } else if (field == V4L2_FIELD_TOP) {
2432 if ((status & 0x10) != 0x10)
2434 } else if (field == V4L2_FIELD_BOTTOM) {
2435 if ((status & 0x10) != 0x00)
2438 dev->video_q.curr->vb.field_count = dev->video_fieldcount;
2439 saa7134_buffer_finish(dev,&dev->video_q,STATE_DONE);
2441 saa7134_buffer_next(dev,&dev->video_q);
2444 spin_unlock(&dev->slock);
2447 /* ----------------------------------------------------------- */