1 // SPDX-License-Identifier: GPL-2.0-or-later
3 hexium_gemini.c - v4l2 driver for Hexium Gemini frame grabber cards
5 Visit http://www.mihu.de/linux/saa7146/ and follow the link
6 to "hexium" for further details about this card.
8 Copyright (C) 2003 Michael Hunold <michael@mihu.de>
12 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14 #define DEBUG_VARIABLE debug
16 #include <media/drv-intf/saa7146_vv.h>
17 #include <linux/module.h>
18 #include <linux/kernel.h>
21 module_param(debug, int, 0);
22 MODULE_PARM_DESC(debug, "debug verbosity");
24 /* global variables */
25 static int hexium_num;
27 #define HEXIUM_GEMINI 4
28 #define HEXIUM_GEMINI_DUAL 5
30 #define HEXIUM_INPUTS 9
31 static struct v4l2_input hexium_inputs[HEXIUM_INPUTS] = {
32 { 0, "CVBS 1", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
33 { 1, "CVBS 2", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
34 { 2, "CVBS 3", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
35 { 3, "CVBS 4", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
36 { 4, "CVBS 5", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
37 { 5, "CVBS 6", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
38 { 6, "Y/C 1", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
39 { 7, "Y/C 2", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
40 { 8, "Y/C 3", V4L2_INPUT_TYPE_CAMERA, 0, 0, V4L2_STD_ALL, 0, V4L2_IN_CAP_STD },
43 #define HEXIUM_AUDIOS 0
51 #define HEXIUM_GEMINI_V_1_0 1
52 #define HEXIUM_GEMINI_DUAL_V_1_0 2
58 struct video_device video_dev;
59 struct i2c_adapter i2c_adapter;
61 int cur_input; /* current input */
62 v4l2_std_id cur_std; /* current standard */
65 /* Samsung KS0127B decoder default registers */
66 static u8 hexium_ks0127b[0x100]={
67 /*00*/ 0x00,0x52,0x30,0x40,0x01,0x0C,0x2A,0x10,
68 /*08*/ 0x00,0x00,0x00,0x60,0x00,0x00,0x0F,0x06,
69 /*10*/ 0x00,0x00,0xE4,0xC0,0x00,0x00,0x00,0x00,
70 /*18*/ 0x14,0x9B,0xFE,0xFF,0xFC,0xFF,0x03,0x22,
71 /*20*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
72 /*28*/ 0x00,0x00,0x00,0x00,0x00,0x2C,0x9B,0x00,
73 /*30*/ 0x00,0x00,0x10,0x80,0x80,0x10,0x80,0x80,
74 /*38*/ 0x01,0x04,0x00,0x00,0x00,0x29,0xC0,0x00,
75 /*40*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
76 /*48*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
77 /*50*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
78 /*58*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
79 /*60*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
80 /*68*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
81 /*70*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
82 /*78*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
83 /*80*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
84 /*88*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
85 /*90*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
86 /*98*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
87 /*A0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
88 /*A8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
89 /*B0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
90 /*B8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
91 /*C0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
92 /*C8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
93 /*D0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
94 /*D8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
95 /*E0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
96 /*E8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
97 /*F0*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
98 /*F8*/ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00
101 static struct hexium_data hexium_pal[] = {
102 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
105 static struct hexium_data hexium_ntsc[] = {
106 { 0x01, 0x53 }, { 0x12, 0x04 }, { 0x2D, 0x23 }, { 0x2E, 0x81 }, { -1 , 0xFF }
109 static struct hexium_data hexium_secam[] = {
110 { 0x01, 0x52 }, { 0x12, 0x64 }, { 0x2D, 0x2C }, { 0x2E, 0x9B }, { -1 , 0xFF }
113 static struct hexium_data hexium_input_select[] = {
125 /* fixme: h_offset = 0 for Hexium Gemini *Dual*, which
126 are currently *not* supported*/
127 static struct saa7146_standard hexium_standards[] = {
129 .name = "PAL", .id = V4L2_STD_PAL,
130 .v_offset = 28, .v_field = 288,
131 .h_offset = 1, .h_pixels = 680,
132 .v_max_out = 576, .h_max_out = 768,
134 .name = "NTSC", .id = V4L2_STD_NTSC,
135 .v_offset = 28, .v_field = 240,
136 .h_offset = 1, .h_pixels = 640,
137 .v_max_out = 480, .h_max_out = 640,
139 .name = "SECAM", .id = V4L2_STD_SECAM,
140 .v_offset = 28, .v_field = 288,
141 .h_offset = 1, .h_pixels = 720,
142 .v_max_out = 576, .h_max_out = 768,
146 /* bring hardware to a sane state. this has to be done, just in case someone
147 wants to capture from this device before it has been properly initialized.
148 the capture engine would badly fail, because no valid signal arrives on the
149 saa7146, thus leading to timeouts and stuff. */
150 static int hexium_init_done(struct saa7146_dev *dev)
152 struct hexium *hexium = (struct hexium *) dev->ext_priv;
153 union i2c_smbus_data data;
156 DEB_D("hexium_init_done called\n");
158 /* initialize the helper ics to useful values */
159 for (i = 0; i < sizeof(hexium_ks0127b); i++) {
160 data.byte = hexium_ks0127b[i];
161 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, i, I2C_SMBUS_BYTE_DATA, &data)) {
162 pr_err("hexium_init_done() failed for address 0x%02x\n",
170 static int hexium_set_input(struct hexium *hexium, int input)
172 union i2c_smbus_data data;
176 data.byte = hexium_input_select[input].byte;
177 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, hexium_input_select[input].adr, I2C_SMBUS_BYTE_DATA, &data)) {
184 static int hexium_set_standard(struct hexium *hexium, struct hexium_data *vdec)
186 union i2c_smbus_data data;
191 while (vdec[i].adr != -1) {
192 data.byte = vdec[i].byte;
193 if (0 != i2c_smbus_xfer(&hexium->i2c_adapter, 0x6c, 0, I2C_SMBUS_WRITE, vdec[i].adr, I2C_SMBUS_BYTE_DATA, &data)) {
194 pr_err("hexium_init_done: hexium_set_standard() failed for address 0x%02x\n",
203 static int vidioc_enum_input(struct file *file, void *fh, struct v4l2_input *i)
205 DEB_EE("VIDIOC_ENUMINPUT %d\n", i->index);
207 if (i->index >= HEXIUM_INPUTS)
210 memcpy(i, &hexium_inputs[i->index], sizeof(struct v4l2_input));
212 DEB_D("v4l2_ioctl: VIDIOC_ENUMINPUT %d\n", i->index);
216 static int vidioc_g_input(struct file *file, void *fh, unsigned int *input)
218 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
219 struct hexium *hexium = (struct hexium *) dev->ext_priv;
221 *input = hexium->cur_input;
223 DEB_D("VIDIOC_G_INPUT: %d\n", *input);
227 static int vidioc_s_input(struct file *file, void *fh, unsigned int input)
229 struct saa7146_dev *dev = ((struct saa7146_fh *)fh)->dev;
230 struct hexium *hexium = (struct hexium *) dev->ext_priv;
232 DEB_EE("VIDIOC_S_INPUT %d\n", input);
234 if (input >= HEXIUM_INPUTS)
237 hexium->cur_input = input;
238 hexium_set_input(hexium, input);
242 static struct saa7146_ext_vv vv_data;
244 /* this function only gets called when the probing was successful */
245 static int hexium_attach(struct saa7146_dev *dev, struct saa7146_pci_extension_data *info)
247 struct hexium *hexium;
252 hexium = kzalloc(sizeof(*hexium), GFP_KERNEL);
256 dev->ext_priv = hexium;
258 /* enable i2c-port pins */
259 saa7146_write(dev, MC1, (MASK_08 | MASK_24 | MASK_10 | MASK_26));
261 strscpy(hexium->i2c_adapter.name, "hexium gemini",
262 sizeof(hexium->i2c_adapter.name));
263 saa7146_i2c_adapter_prepare(dev, &hexium->i2c_adapter, SAA7146_I2C_BUS_BIT_RATE_480);
264 if (i2c_add_adapter(&hexium->i2c_adapter) < 0) {
265 DEB_S("cannot register i2c-device. skipping.\n");
270 /* set HWControl GPIO number 2 */
271 saa7146_setgpio(dev, 2, SAA7146_GPIO_OUTHI);
273 saa7146_write(dev, DD1_INIT, 0x07000700);
274 saa7146_write(dev, DD1_STREAM_B, 0x00000000);
275 saa7146_write(dev, MC2, (MASK_09 | MASK_25 | MASK_10 | MASK_26));
278 hexium->cur_input = 0;
279 hexium_init_done(dev);
281 hexium_set_standard(hexium, hexium_pal);
282 hexium->cur_std = V4L2_STD_PAL;
284 hexium_set_input(hexium, 0);
285 hexium->cur_input = 0;
287 ret = saa7146_vv_init(dev, &vv_data);
289 i2c_del_adapter(&hexium->i2c_adapter);
294 vv_data.vid_ops.vidioc_enum_input = vidioc_enum_input;
295 vv_data.vid_ops.vidioc_g_input = vidioc_g_input;
296 vv_data.vid_ops.vidioc_s_input = vidioc_s_input;
297 ret = saa7146_register_device(&hexium->video_dev, dev, "hexium gemini", VFL_TYPE_VIDEO);
299 pr_err("cannot register capture v4l2 device. skipping.\n");
300 saa7146_vv_release(dev);
301 i2c_del_adapter(&hexium->i2c_adapter);
306 pr_info("found 'hexium gemini' frame grabber-%d\n", hexium_num);
312 static int hexium_detach(struct saa7146_dev *dev)
314 struct hexium *hexium = (struct hexium *) dev->ext_priv;
316 DEB_EE("dev:%p\n", dev);
318 saa7146_unregister_device(&hexium->video_dev, dev);
319 saa7146_vv_release(dev);
323 i2c_del_adapter(&hexium->i2c_adapter);
328 static int std_callback(struct saa7146_dev *dev, struct saa7146_standard *std)
330 struct hexium *hexium = (struct hexium *) dev->ext_priv;
332 if (V4L2_STD_PAL == std->id) {
333 hexium_set_standard(hexium, hexium_pal);
334 hexium->cur_std = V4L2_STD_PAL;
336 } else if (V4L2_STD_NTSC == std->id) {
337 hexium_set_standard(hexium, hexium_ntsc);
338 hexium->cur_std = V4L2_STD_NTSC;
340 } else if (V4L2_STD_SECAM == std->id) {
341 hexium_set_standard(hexium, hexium_secam);
342 hexium->cur_std = V4L2_STD_SECAM;
349 static struct saa7146_extension hexium_extension;
351 static struct saa7146_pci_extension_data hexium_gemini_4bnc = {
352 .ext_priv = "Hexium Gemini (4 BNC)",
353 .ext = &hexium_extension,
356 static struct saa7146_pci_extension_data hexium_gemini_dual_4bnc = {
357 .ext_priv = "Hexium Gemini Dual (4 BNC)",
358 .ext = &hexium_extension,
361 static const struct pci_device_id pci_tbl[] = {
363 .vendor = PCI_VENDOR_ID_PHILIPS,
364 .device = PCI_DEVICE_ID_PHILIPS_SAA7146,
367 .driver_data = (unsigned long) &hexium_gemini_4bnc,
370 .vendor = PCI_VENDOR_ID_PHILIPS,
371 .device = PCI_DEVICE_ID_PHILIPS_SAA7146,
374 .driver_data = (unsigned long) &hexium_gemini_dual_4bnc,
381 MODULE_DEVICE_TABLE(pci, pci_tbl);
383 static struct saa7146_ext_vv vv_data = {
384 .inputs = HEXIUM_INPUTS,
386 .stds = &hexium_standards[0],
387 .num_stds = ARRAY_SIZE(hexium_standards),
388 .std_callback = &std_callback,
391 static struct saa7146_extension hexium_extension = {
392 .name = "hexium gemini",
393 .flags = SAA7146_USE_I2C_IRQ,
395 .pci_tbl = &pci_tbl[0],
396 .module = THIS_MODULE,
398 .attach = hexium_attach,
399 .detach = hexium_detach,
405 static int __init hexium_init_module(void)
407 if (0 != saa7146_register_extension(&hexium_extension)) {
408 DEB_S("failed to register extension\n");
415 static void __exit hexium_cleanup_module(void)
417 saa7146_unregister_extension(&hexium_extension);
420 module_init(hexium_init_module);
421 module_exit(hexium_cleanup_module);
423 MODULE_DESCRIPTION("video4linux-2 driver for Hexium Gemini frame grabber cards");
424 MODULE_AUTHOR("Michael Hunold <michael@mihu.de>");
425 MODULE_LICENSE("GPL");