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 pr_fmt(fmt) KBUILD_MODNAME ": " fmt
26 #define DEBUG_VARIABLE debug
28 #include <media/saa7146_vv.h>
31 module_param(debug, int, 0);
32 MODULE_PARM_DESC(debug, "debug verbosity");
34 /* global variables */
35 static int hexium_num;
37 #define HEXIUM_GEMINI 4
38 #define HEXIUM_GEMINI_DUAL 5
40 #define HEXIUM_INPUTS 9
41 static struct v4l2_input hexium_inputs[HEXIUM_INPUTS] = {
42 { 0, "CVBS 1", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
43 { 1, "CVBS 2", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
44 { 2, "CVBS 3", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
45 { 3, "CVBS 4", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
46 { 4, "CVBS 5", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
47 { 5, "CVBS 6", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
48 { 6, "Y/C 1", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
49 { 7, "Y/C 2", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
50 { 8, "Y/C 3", V4L2_INPUT_TYPE_CAMERA, 2, 0, V4L2_STD_PAL_BG|V4L2_STD_NTSC_M, 0, V4L2_IN_CAP_STD },
53 #define HEXIUM_AUDIOS 0
61 #define HEXIUM_CONTROLS 1
62 static struct v4l2_queryctrl hexium_controls[] = {
63 { V4L2_CID_PRIVATE_BASE, V4L2_CTRL_TYPE_BOOLEAN, "B/W", 0, 1, 1, 0, 0 },
66 #define HEXIUM_GEMINI_V_1_0 1
67 #define HEXIUM_GEMINI_DUAL_V_1_0 2
73 struct video_device *video_dev;
74 struct i2c_adapter i2c_adapter;
76 int cur_input; /* current input */
77 v4l2_std_id cur_std; /* current standard */
78 int cur_bw; /* current black/white status */
81 /* Samsung KS0127B decoder default registers */
82 static u8 hexium_ks0127b[0x100]={
83 /*00*/ 0x00,0x52,0x30,0x40,0x01,0x0C,0x2A,0x10,
84 /*08*/ 0x00,0x00,0x00,0x60,0x00,0x00,0x0F,0x06,
85 /*10*/ 0x00,0x00,0xE4,0xC0,0x00,0x00,0x00,0x00,
86 /*18*/ 0x14,0x9B,0xFE,0xFF,0xFC,0xFF,0x03,0x22,
87 /*20*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
88 /*28*/ 0x00,0x00,0x00,0x00,0x00,0x2C,0x9B,0x00,
89 /*30*/ 0x00,0x00,0x10,0x80,0x80,0x10,0x80,0x80,
90 /*38*/ 0x01,0x04,0x00,0x00,0x00,0x29,0xC0,0x00,
91 /*40*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
92 /*48*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
93 /*50*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
94 /*58*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
95 /*60*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
96 /*68*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
97 /*70*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
98 /*78*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
99 /*80*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
100 /*88*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
101 /*90*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
102 /*98*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
103 /*A0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
104 /*A8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
105 /*B0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
106 /*B8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
107 /*C0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
108 /*C8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
109 /*D0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
110 /*D8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
111 /*E0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
112 /*E8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
113 /*F0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
114 /*F8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00
117 static struct hexium_data hexium_pal[] = {
118 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
121 static struct hexium_data hexium_pal_bw[] = {
122 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
125 static struct hexium_data hexium_ntsc[] = {
126 { 0x01, 0x53 }, { 0x12, 0x04 }, { 0x2D, 0x23 }, { 0x2E, 0x81 }, { -1 , 0xFF }
129 static struct hexium_data hexium_ntsc_bw[] = {
130 { 0x01, 0x53 }, { 0x12, 0x04 }, { 0x2D, 0x23 }, { 0x2E, 0x81 }, { -1 , 0xFF }
133 static struct hexium_data hexium_secam[] = {
134 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
137 static struct hexium_data hexium_input_select[] = {
149 /* fixme: h_offset = 0 for Hexium Gemini *Dual*, which
150 are currently *not* supported*/
151 static struct saa7146_standard hexium_standards[] = {
153 .name = "PAL", .id = V4L2_STD_PAL,
154 .v_offset = 28, .v_field = 288,
155 .h_offset = 1, .h_pixels = 680,
156 .v_max_out = 576, .h_max_out = 768,
158 .name = "NTSC", .id = V4L2_STD_NTSC,
159 .v_offset = 28, .v_field = 240,
160 .h_offset = 1, .h_pixels = 640,
161 .v_max_out = 480, .h_max_out = 640,
163 .name = "SECAM", .id = V4L2_STD_SECAM,
164 .v_offset = 28, .v_field = 288,
165 .h_offset = 1, .h_pixels = 720,
166 .v_max_out = 576, .h_max_out = 768,
170 /* bring hardware to a sane state. this has to be done, just in case someone
171 wants to capture from this device before it has been properly initialized.
172 the capture engine would badly fail, because no valid signal arrives on the
173 saa7146, thus leading to timeouts and stuff. */
174 static int hexium_init_done(struct saa7146_dev *dev)
176 struct hexium *hexium = (struct hexium *) dev->ext_priv;
177 union i2c_smbus_data data;
180 DEB_D("hexium_init_done called\n");
182 /* initialize the helper ics to useful values */
183 for (i = 0; i < sizeof(hexium_ks0127b); i++) {
184 data.byte = hexium_ks0127b[i];
185 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, i, I2C_SMBUS_BYTE_DATA, &data)) {
186 pr_err("hexium_init_done() failed for address 0x%02x\n",
194 static int hexium_set_input(struct hexium *hexium, int input)
196 union i2c_smbus_data data;
200 data.byte = hexium_input_select[input].byte;
201 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, hexium_input_select[input].adr, I2C_SMBUS_BYTE_DATA, &data)) {
208 static int hexium_set_standard(struct hexium *hexium, struct hexium_data *vdec)
210 union i2c_smbus_data data;
215 while (vdec[i].adr != -1) {
216 data.byte = vdec[i].byte;
217 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, vdec[i].adr, I2C_SMBUS_BYTE_DATA, &data)) {
218 pr_err("hexium_init_done: hexium_set_standard() failed for address 0x%02x\n",
227 static int vidioc_enum_input(struct file *file, void *fh, struct v4l2_input *i)
229 DEB_EE("VIDIOC_ENUMINPUT %d\n", i->index);
231 if (i->index >= HEXIUM_INPUTS)
234 memcpy(i, &hexium_inputs[i->index], sizeof(struct v4l2_input));
236 DEB_D("v4l2_ioctl: VIDIOC_ENUMINPUT %d\n", i->index);
240 static int vidioc_g_input(struct file *file, void *fh, unsigned int *input)
242 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
243 struct hexium *hexium = (struct hexium *) dev->ext_priv;
245 *input = hexium->cur_input;
247 DEB_D("VIDIOC_G_INPUT: %d\n", *input);
251 static int vidioc_s_input(struct file *file, void *fh, unsigned int input)
253 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
254 struct hexium *hexium = (struct hexium *) dev->ext_priv;
256 DEB_EE("VIDIOC_S_INPUT %d\n", input);
258 if (input >= HEXIUM_INPUTS)
261 hexium->cur_input = input;
262 hexium_set_input(hexium, input);
266 /* the saa7146 provides some controls (brightness, contrast, saturation)
267 which gets registered *after* this function. because of this we have
268 to return with a value != 0 even if the function succeeded.. */
269 static int vidioc_queryctrl(struct file *file, void *fh, struct v4l2_queryctrl *qc)
271 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
274 for (i = HEXIUM_CONTROLS - 1; i >= 0; i--) {
275 if (hexium_controls[i].id == qc->id) {
276 *qc = hexium_controls[i];
277 DEB_D("VIDIOC_QUERYCTRL %d\n", qc->id);
281 return dev->ext_vv_data->core_ops->vidioc_queryctrl(file, fh, qc);
284 static int vidioc_g_ctrl(struct file *file, void *fh, struct v4l2_control *vc)
286 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
287 struct hexium *hexium = (struct hexium *) dev->ext_priv;
290 for (i = HEXIUM_CONTROLS - 1; i >= 0; i--) {
291 if (hexium_controls[i].id == vc->id)
296 return dev->ext_vv_data->core_ops->vidioc_g_ctrl(file, fh, vc);
298 if (vc->id == V4L2_CID_PRIVATE_BASE) {
299 vc->value = hexium->cur_bw;
300 DEB_D("VIDIOC_G_CTRL BW:%d\n", vc->value);
306 static int vidioc_s_ctrl(struct file *file, void *fh, struct v4l2_control *vc)
308 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
309 struct hexium *hexium = (struct hexium *) dev->ext_priv;
312 for (i = HEXIUM_CONTROLS - 1; i >= 0; i--) {
313 if (hexium_controls[i].id == vc->id)
318 return dev->ext_vv_data->core_ops->vidioc_s_ctrl(file, fh, vc);
320 if (vc->id == V4L2_CID_PRIVATE_BASE)
321 hexium->cur_bw = vc->value;
323 DEB_D("VIDIOC_S_CTRL BW:%d\n", hexium->cur_bw);
325 if (0 == hexium->cur_bw && V4L2_STD_PAL == hexium->cur_std) {
326 hexium_set_standard(hexium, hexium_pal);
329 if (0 == hexium->cur_bw && V4L2_STD_NTSC == hexium->cur_std) {
330 hexium_set_standard(hexium, hexium_ntsc);
333 if (0 == hexium->cur_bw && V4L2_STD_SECAM == hexium->cur_std) {
334 hexium_set_standard(hexium, hexium_secam);
337 if (1 == hexium->cur_bw && V4L2_STD_PAL == hexium->cur_std) {
338 hexium_set_standard(hexium, hexium_pal_bw);
341 if (1 == hexium->cur_bw && V4L2_STD_NTSC == hexium->cur_std) {
342 hexium_set_standard(hexium, hexium_ntsc_bw);
345 if (1 == hexium->cur_bw && V4L2_STD_SECAM == hexium->cur_std)
346 /* fixme: is there no bw secam mode? */
353 static struct saa7146_ext_vv vv_data;
355 /* this function only gets called when the probing was successful */
356 static int hexium_attach(struct saa7146_dev *dev, struct saa7146_pci_extension_data *info)
358 struct hexium *hexium;
363 hexium = kzalloc(sizeof(struct hexium), GFP_KERNEL);
364 if (NULL == hexium) {
365 pr_err("not enough kernel memory in hexium_attach()\n");
368 dev->ext_priv = hexium;
370 /* enable i2c-port pins */
371 saa7146_write(dev, MC1, (MASK_08 | MASK_24 | MASK_10 | MASK_26));
373 hexium->i2c_adapter = (struct i2c_adapter) {
374 .name = "hexium gemini",
376 saa7146_i2c_adapter_prepare(dev, &hexium->i2c_adapter, SAA7146_I2C_BUS_BIT_RATE_480);
377 if (i2c_add_adapter(&hexium->i2c_adapter) < 0) {
378 DEB_S("cannot register i2c-device. skipping.\n");
383 /* set HWControl GPIO number 2 */
384 saa7146_setgpio(dev, 2, SAA7146_GPIO_OUTHI);
386 saa7146_write(dev, DD1_INIT, 0x07000700);
387 saa7146_write(dev, DD1_STREAM_B, 0x00000000);
388 saa7146_write(dev, MC2, (MASK_09 | MASK_25 | MASK_10 | MASK_26));
391 hexium->cur_input = 0;
392 hexium_init_done(dev);
394 hexium_set_standard(hexium, hexium_pal);
395 hexium->cur_std = V4L2_STD_PAL;
397 hexium_set_input(hexium, 0);
398 hexium->cur_input = 0;
400 saa7146_vv_init(dev, &vv_data);
401 vv_data.ops.vidioc_queryctrl = vidioc_queryctrl;
402 vv_data.ops.vidioc_g_ctrl = vidioc_g_ctrl;
403 vv_data.ops.vidioc_s_ctrl = vidioc_s_ctrl;
404 vv_data.ops.vidioc_enum_input = vidioc_enum_input;
405 vv_data.ops.vidioc_g_input = vidioc_g_input;
406 vv_data.ops.vidioc_s_input = vidioc_s_input;
407 ret = saa7146_register_device(&hexium->video_dev, dev, "hexium gemini", VFL_TYPE_GRABBER);
409 pr_err("cannot register capture v4l2 device. skipping.\n");
413 pr_info("found 'hexium gemini' frame grabber-%d\n", hexium_num);
419 static int hexium_detach(struct saa7146_dev *dev)
421 struct hexium *hexium = (struct hexium *) dev->ext_priv;
423 DEB_EE("dev:%p\n", dev);
425 saa7146_unregister_device(&hexium->video_dev, dev);
426 saa7146_vv_release(dev);
430 i2c_del_adapter(&hexium->i2c_adapter);
435 static int std_callback(struct saa7146_dev *dev, struct saa7146_standard *std)
437 struct hexium *hexium = (struct hexium *) dev->ext_priv;
439 if (V4L2_STD_PAL == std->id) {
440 hexium_set_standard(hexium, hexium_pal);
441 hexium->cur_std = V4L2_STD_PAL;
443 } else if (V4L2_STD_NTSC == std->id) {
444 hexium_set_standard(hexium, hexium_ntsc);
445 hexium->cur_std = V4L2_STD_NTSC;
447 } else if (V4L2_STD_SECAM == std->id) {
448 hexium_set_standard(hexium, hexium_secam);
449 hexium->cur_std = V4L2_STD_SECAM;
456 static struct saa7146_extension hexium_extension;
458 static struct saa7146_pci_extension_data hexium_gemini_4bnc = {
459 .ext_priv = "Hexium Gemini (4 BNC)",
460 .ext = &hexium_extension,
463 static struct saa7146_pci_extension_data hexium_gemini_dual_4bnc = {
464 .ext_priv = "Hexium Gemini Dual (4 BNC)",
465 .ext = &hexium_extension,
468 static struct pci_device_id pci_tbl[] = {
470 .vendor = PCI_VENDOR_ID_PHILIPS,
471 .device = PCI_DEVICE_ID_PHILIPS_SAA7146,
474 .driver_data = (unsigned long) &hexium_gemini_4bnc,
477 .vendor = PCI_VENDOR_ID_PHILIPS,
478 .device = PCI_DEVICE_ID_PHILIPS_SAA7146,
481 .driver_data = (unsigned long) &hexium_gemini_dual_4bnc,
488 MODULE_DEVICE_TABLE(pci, pci_tbl);
490 static struct saa7146_ext_vv vv_data = {
491 .inputs = HEXIUM_INPUTS,
493 .stds = &hexium_standards[0],
494 .num_stds = sizeof(hexium_standards) / sizeof(struct saa7146_standard),
495 .std_callback = &std_callback,
498 static struct saa7146_extension hexium_extension = {
499 .name = "hexium gemini",
500 .flags = SAA7146_USE_I2C_IRQ,
502 .pci_tbl = &pci_tbl[0],
503 .module = THIS_MODULE,
505 .attach = hexium_attach,
506 .detach = hexium_detach,
512 static int __init hexium_init_module(void)
514 if (0 != saa7146_register_extension(&hexium_extension)) {
515 DEB_S("failed to register extension\n");
522 static void __exit hexium_cleanup_module(void)
524 saa7146_unregister_extension(&hexium_extension);
527 module_init(hexium_init_module);
528 module_exit(hexium_cleanup_module);
530 MODULE_DESCRIPTION("video4linux-2 driver for Hexium Gemini frame grabber cards");
531 MODULE_AUTHOR("Michael Hunold <michael@mihu.de>");
532 MODULE_LICENSE("GPL");