2 hexium_gemini.c - v4l2 driver for Hexium Gemini frame grabber cards
4 Visit http://www.mihu.de/linux/saa7146/ and follow the link
5 to "hexium" for further details about this card.
7 Copyright (C) 2003 Michael Hunold <michael@mihu.de>
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #define DEBUG_VARIABLE debug
26 #include <media/saa7146_vv.h>
27 #include <linux/module.h>
30 module_param(debug
, int, 0);
31 MODULE_PARM_DESC(debug
, "debug verbosity");
33 /* global variables */
34 static int hexium_num
;
36 #define HEXIUM_GEMINI 4
37 #define HEXIUM_GEMINI_DUAL 5
39 #define HEXIUM_INPUTS 9
40 static struct v4l2_input hexium_inputs
[HEXIUM_INPUTS
] = {
41 { 0, "CVBS 1", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
42 { 1, "CVBS 2", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
43 { 2, "CVBS 3", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
44 { 3, "CVBS 4", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
45 { 4, "CVBS 5", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
46 { 5, "CVBS 6", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
47 { 6, "Y/C 1", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
48 { 7, "Y/C 2", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
49 { 8, "Y/C 3", V4L2_INPUT_TYPE_CAMERA
, 2, 0, V4L2_STD_PAL_BG
|V4L2_STD_NTSC_M
, 0, V4L2_IN_CAP_STD
},
52 #define HEXIUM_AUDIOS 0
60 #define HEXIUM_CONTROLS 1
61 static struct v4l2_queryctrl hexium_controls
[] = {
62 { V4L2_CID_PRIVATE_BASE
, V4L2_CTRL_TYPE_BOOLEAN
, "B/W", 0, 1, 1, 0, 0 },
65 #define HEXIUM_GEMINI_V_1_0 1
66 #define HEXIUM_GEMINI_DUAL_V_1_0 2
72 struct video_device
*video_dev
;
73 struct i2c_adapter i2c_adapter
;
75 int cur_input
; /* current input */
76 v4l2_std_id cur_std
; /* current standard */
77 int cur_bw
; /* current black/white status */
80 /* Samsung KS0127B decoder default registers */
81 static u8 hexium_ks0127b
[0x100]={
82 /*00*/ 0x00,0x52,0x30,0x40,0x01,0x0C,0x2A,0x10,
83 /*08*/ 0x00,0x00,0x00,0x60,0x00,0x00,0x0F,0x06,
84 /*10*/ 0x00,0x00,0xE4,0xC0,0x00,0x00,0x00,0x00,
85 /*18*/ 0x14,0x9B,0xFE,0xFF,0xFC,0xFF,0x03,0x22,
86 /*20*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
87 /*28*/ 0x00,0x00,0x00,0x00,0x00,0x2C,0x9B,0x00,
88 /*30*/ 0x00,0x00,0x10,0x80,0x80,0x10,0x80,0x80,
89 /*38*/ 0x01,0x04,0x00,0x00,0x00,0x29,0xC0,0x00,
90 /*40*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
91 /*48*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
92 /*50*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
93 /*58*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
94 /*60*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
95 /*68*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
96 /*70*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
97 /*78*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
98 /*80*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
99 /*88*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
100 /*90*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
101 /*98*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
102 /*A0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
103 /*A8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
104 /*B0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
105 /*B8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
106 /*C0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
107 /*C8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
108 /*D0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
109 /*D8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
110 /*E0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
111 /*E8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
112 /*F0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
113 /*F8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00
116 static struct hexium_data hexium_pal
[] = {
117 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
120 static struct hexium_data hexium_pal_bw
[] = {
121 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
124 static struct hexium_data hexium_ntsc
[] = {
125 { 0x01, 0x53 }, { 0x12, 0x04 }, { 0x2D, 0x23 }, { 0x2E, 0x81 }, { -1 , 0xFF }
128 static struct hexium_data hexium_ntsc_bw
[] = {
129 { 0x01, 0x53 }, { 0x12, 0x04 }, { 0x2D, 0x23 }, { 0x2E, 0x81 }, { -1 , 0xFF }
132 static struct hexium_data hexium_secam
[] = {
133 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
136 static struct hexium_data hexium_input_select
[] = {
148 /* fixme: h_offset = 0 for Hexium Gemini *Dual*, which
149 are currently *not* supported*/
150 static struct saa7146_standard hexium_standards
[] = {
152 .name
= "PAL", .id
= V4L2_STD_PAL
,
153 .v_offset
= 28, .v_field
= 288,
154 .h_offset
= 1, .h_pixels
= 680,
155 .v_max_out
= 576, .h_max_out
= 768,
157 .name
= "NTSC", .id
= V4L2_STD_NTSC
,
158 .v_offset
= 28, .v_field
= 240,
159 .h_offset
= 1, .h_pixels
= 640,
160 .v_max_out
= 480, .h_max_out
= 640,
162 .name
= "SECAM", .id
= V4L2_STD_SECAM
,
163 .v_offset
= 28, .v_field
= 288,
164 .h_offset
= 1, .h_pixels
= 720,
165 .v_max_out
= 576, .h_max_out
= 768,
169 /* bring hardware to a sane state. this has to be done, just in case someone
170 wants to capture from this device before it has been properly initialized.
171 the capture engine would badly fail, because no valid signal arrives on the
172 saa7146, thus leading to timeouts and stuff. */
173 static int hexium_init_done(struct saa7146_dev
*dev
)
175 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
176 union i2c_smbus_data data
;
179 DEB_D(("hexium_init_done called.\n"));
181 /* initialize the helper ics to useful values */
182 for (i
= 0; i
< sizeof(hexium_ks0127b
); i
++) {
183 data
.byte
= hexium_ks0127b
[i
];
184 if (0 != i2c_smbus_xfer(&hexium
->i2c_adapter
, 0x6c, 0, I2C_SMBUS_WRITE
, i
, I2C_SMBUS_BYTE_DATA
, &data
)) {
185 printk("hexium_gemini: hexium_init_done() failed for address 0x%02x\n", i
);
192 static int hexium_set_input(struct hexium
*hexium
, int input
)
194 union i2c_smbus_data data
;
198 data
.byte
= hexium_input_select
[input
].byte
;
199 if (0 != i2c_smbus_xfer(&hexium
->i2c_adapter
, 0x6c, 0, I2C_SMBUS_WRITE
, hexium_input_select
[input
].adr
, I2C_SMBUS_BYTE_DATA
, &data
)) {
206 static int hexium_set_standard(struct hexium
*hexium
, struct hexium_data
*vdec
)
208 union i2c_smbus_data data
;
213 while (vdec
[i
].adr
!= -1) {
214 data
.byte
= vdec
[i
].byte
;
215 if (0 != i2c_smbus_xfer(&hexium
->i2c_adapter
, 0x6c, 0, I2C_SMBUS_WRITE
, vdec
[i
].adr
, I2C_SMBUS_BYTE_DATA
, &data
)) {
216 printk("hexium_init_done: hexium_set_standard() failed for address 0x%02x\n", i
);
224 static int vidioc_enum_input(struct file
*file
, void *fh
, struct v4l2_input
*i
)
226 DEB_EE(("VIDIOC_ENUMINPUT %d.\n", i
->index
));
228 if (i
->index
>= HEXIUM_INPUTS
)
231 memcpy(i
, &hexium_inputs
[i
->index
], sizeof(struct v4l2_input
));
233 DEB_D(("v4l2_ioctl: VIDIOC_ENUMINPUT %d.\n", i
->index
));
237 static int vidioc_g_input(struct file
*file
, void *fh
, unsigned int *input
)
239 struct saa7146_dev
*dev
= ((struct saa7146_fh
*)fh
)->dev
;
240 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
242 *input
= hexium
->cur_input
;
244 DEB_D(("VIDIOC_G_INPUT: %d\n", *input
));
248 static int vidioc_s_input(struct file
*file
, void *fh
, unsigned int input
)
250 struct saa7146_dev
*dev
= ((struct saa7146_fh
*)fh
)->dev
;
251 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
253 DEB_EE(("VIDIOC_S_INPUT %d.\n", input
));
255 if (input
>= HEXIUM_INPUTS
)
258 hexium
->cur_input
= input
;
259 hexium_set_input(hexium
, input
);
263 /* the saa7146 provides some controls (brightness, contrast, saturation)
264 which gets registered *after* this function. because of this we have
265 to return with a value != 0 even if the function succeeded.. */
266 static int vidioc_queryctrl(struct file
*file
, void *fh
, struct v4l2_queryctrl
*qc
)
268 struct saa7146_dev
*dev
= ((struct saa7146_fh
*)fh
)->dev
;
271 for (i
= HEXIUM_CONTROLS
- 1; i
>= 0; i
--) {
272 if (hexium_controls
[i
].id
== qc
->id
) {
273 *qc
= hexium_controls
[i
];
274 DEB_D(("VIDIOC_QUERYCTRL %d.\n", qc
->id
));
278 return dev
->ext_vv_data
->core_ops
->vidioc_queryctrl(file
, fh
, qc
);
281 static int vidioc_g_ctrl(struct file
*file
, void *fh
, struct v4l2_control
*vc
)
283 struct saa7146_dev
*dev
= ((struct saa7146_fh
*)fh
)->dev
;
284 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
287 for (i
= HEXIUM_CONTROLS
- 1; i
>= 0; i
--) {
288 if (hexium_controls
[i
].id
== vc
->id
)
293 return dev
->ext_vv_data
->core_ops
->vidioc_g_ctrl(file
, fh
, vc
);
295 if (vc
->id
== V4L2_CID_PRIVATE_BASE
) {
296 vc
->value
= hexium
->cur_bw
;
297 DEB_D(("VIDIOC_G_CTRL BW:%d.\n", vc
->value
));
303 static int vidioc_s_ctrl(struct file
*file
, void *fh
, struct v4l2_control
*vc
)
305 struct saa7146_dev
*dev
= ((struct saa7146_fh
*)fh
)->dev
;
306 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
309 for (i
= HEXIUM_CONTROLS
- 1; i
>= 0; i
--) {
310 if (hexium_controls
[i
].id
== vc
->id
)
315 return dev
->ext_vv_data
->core_ops
->vidioc_s_ctrl(file
, fh
, vc
);
317 if (vc
->id
== V4L2_CID_PRIVATE_BASE
)
318 hexium
->cur_bw
= vc
->value
;
320 DEB_D(("VIDIOC_S_CTRL BW:%d.\n", hexium
->cur_bw
));
322 if (0 == hexium
->cur_bw
&& V4L2_STD_PAL
== hexium
->cur_std
) {
323 hexium_set_standard(hexium
, hexium_pal
);
326 if (0 == hexium
->cur_bw
&& V4L2_STD_NTSC
== hexium
->cur_std
) {
327 hexium_set_standard(hexium
, hexium_ntsc
);
330 if (0 == hexium
->cur_bw
&& V4L2_STD_SECAM
== hexium
->cur_std
) {
331 hexium_set_standard(hexium
, hexium_secam
);
334 if (1 == hexium
->cur_bw
&& V4L2_STD_PAL
== hexium
->cur_std
) {
335 hexium_set_standard(hexium
, hexium_pal_bw
);
338 if (1 == hexium
->cur_bw
&& V4L2_STD_NTSC
== hexium
->cur_std
) {
339 hexium_set_standard(hexium
, hexium_ntsc_bw
);
342 if (1 == hexium
->cur_bw
&& V4L2_STD_SECAM
== hexium
->cur_std
)
343 /* fixme: is there no bw secam mode? */
350 static struct saa7146_ext_vv vv_data
;
352 /* this function only gets called when the probing was successful */
353 static int hexium_attach(struct saa7146_dev
*dev
, struct saa7146_pci_extension_data
*info
)
355 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
360 hexium
= kzalloc(sizeof(struct hexium
), GFP_KERNEL
);
361 if (NULL
== hexium
) {
362 printk("hexium_gemini: not enough kernel memory in hexium_attach().\n");
365 dev
->ext_priv
= hexium
;
367 /* enable i2c-port pins */
368 saa7146_write(dev
, MC1
, (MASK_08
| MASK_24
| MASK_10
| MASK_26
));
370 hexium
->i2c_adapter
= (struct i2c_adapter
) {
371 .name
= "hexium gemini",
373 saa7146_i2c_adapter_prepare(dev
, &hexium
->i2c_adapter
, SAA7146_I2C_BUS_BIT_RATE_480
);
374 if (i2c_add_adapter(&hexium
->i2c_adapter
) < 0) {
375 DEB_S(("cannot register i2c-device. skipping.\n"));
380 /* set HWControl GPIO number 2 */
381 saa7146_setgpio(dev
, 2, SAA7146_GPIO_OUTHI
);
383 saa7146_write(dev
, DD1_INIT
, 0x07000700);
384 saa7146_write(dev
, DD1_STREAM_B
, 0x00000000);
385 saa7146_write(dev
, MC2
, (MASK_09
| MASK_25
| MASK_10
| MASK_26
));
388 hexium
->cur_input
= 0;
389 hexium_init_done(dev
);
391 hexium_set_standard(hexium
, hexium_pal
);
392 hexium
->cur_std
= V4L2_STD_PAL
;
394 hexium_set_input(hexium
, 0);
395 hexium
->cur_input
= 0;
397 saa7146_vv_init(dev
, &vv_data
);
398 vv_data
.ops
.vidioc_queryctrl
= vidioc_queryctrl
;
399 vv_data
.ops
.vidioc_g_ctrl
= vidioc_g_ctrl
;
400 vv_data
.ops
.vidioc_s_ctrl
= vidioc_s_ctrl
;
401 vv_data
.ops
.vidioc_enum_input
= vidioc_enum_input
;
402 vv_data
.ops
.vidioc_g_input
= vidioc_g_input
;
403 vv_data
.ops
.vidioc_s_input
= vidioc_s_input
;
404 ret
= saa7146_register_device(&hexium
->video_dev
, dev
, "hexium gemini", VFL_TYPE_GRABBER
);
406 printk("hexium_gemini: cannot register capture v4l2 device. skipping.\n");
410 printk("hexium_gemini: found 'hexium gemini' frame grabber-%d.\n", hexium_num
);
416 static int hexium_detach(struct saa7146_dev
*dev
)
418 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
420 DEB_EE(("dev:%p\n", dev
));
422 saa7146_unregister_device(&hexium
->video_dev
, dev
);
423 saa7146_vv_release(dev
);
427 i2c_del_adapter(&hexium
->i2c_adapter
);
432 static int std_callback(struct saa7146_dev
*dev
, struct saa7146_standard
*std
)
434 struct hexium
*hexium
= (struct hexium
*) dev
->ext_priv
;
436 if (V4L2_STD_PAL
== std
->id
) {
437 hexium_set_standard(hexium
, hexium_pal
);
438 hexium
->cur_std
= V4L2_STD_PAL
;
440 } else if (V4L2_STD_NTSC
== std
->id
) {
441 hexium_set_standard(hexium
, hexium_ntsc
);
442 hexium
->cur_std
= V4L2_STD_NTSC
;
444 } else if (V4L2_STD_SECAM
== std
->id
) {
445 hexium_set_standard(hexium
, hexium_secam
);
446 hexium
->cur_std
= V4L2_STD_SECAM
;
453 static struct saa7146_extension hexium_extension
;
455 static struct saa7146_pci_extension_data hexium_gemini_4bnc
= {
456 .ext_priv
= "Hexium Gemini (4 BNC)",
457 .ext
= &hexium_extension
,
460 static struct saa7146_pci_extension_data hexium_gemini_dual_4bnc
= {
461 .ext_priv
= "Hexium Gemini Dual (4 BNC)",
462 .ext
= &hexium_extension
,
465 static struct pci_device_id pci_tbl
[] = {
467 .vendor
= PCI_VENDOR_ID_PHILIPS
,
468 .device
= PCI_DEVICE_ID_PHILIPS_SAA7146
,
471 .driver_data
= (unsigned long) &hexium_gemini_4bnc
,
474 .vendor
= PCI_VENDOR_ID_PHILIPS
,
475 .device
= PCI_DEVICE_ID_PHILIPS_SAA7146
,
478 .driver_data
= (unsigned long) &hexium_gemini_dual_4bnc
,
485 MODULE_DEVICE_TABLE(pci
, pci_tbl
);
487 static struct saa7146_ext_vv vv_data
= {
488 .inputs
= HEXIUM_INPUTS
,
490 .stds
= &hexium_standards
[0],
491 .num_stds
= sizeof(hexium_standards
) / sizeof(struct saa7146_standard
),
492 .std_callback
= &std_callback
,
495 static struct saa7146_extension hexium_extension
= {
496 .name
= "hexium gemini",
497 .flags
= SAA7146_USE_I2C_IRQ
,
499 .pci_tbl
= &pci_tbl
[0],
500 .module
= THIS_MODULE
,
502 .attach
= hexium_attach
,
503 .detach
= hexium_detach
,
509 static int __init
hexium_init_module(void)
511 if (0 != saa7146_register_extension(&hexium_extension
)) {
512 DEB_S(("failed to register extension.\n"));
519 static void __exit
hexium_cleanup_module(void)
521 saa7146_unregister_extension(&hexium_extension
);
524 module_init(hexium_init_module
);
525 module_exit(hexium_cleanup_module
);
527 MODULE_DESCRIPTION("video4linux-2 driver for Hexium Gemini frame grabber cards");
528 MODULE_AUTHOR("Michael Hunold <michael@mihu.de>");
529 MODULE_LICENSE("GPL");