2 em28xx-cards.c - driver for Empia EM2800/EM2820/2840 USB
5 Copyright (C) 2005 Ludovico Cavedon <cavedon@sssup.it>
6 Markus Rechberger <mrechberger@gmail.com>
7 Mauro Carvalho Chehab <mchehab@infradead.org>
8 Sascha Sommer <saschasommer@freenet.de>
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 #include <linux/init.h>
26 #include <linux/module.h>
27 #include <linux/delay.h>
28 #include <linux/i2c.h>
29 #include <linux/usb.h>
30 #include <media/tuner.h>
31 #include <media/msp3400.h>
32 #include <media/saa7115.h>
33 #include <media/tvp5150.h>
34 #include <media/tveeprom.h>
35 #include <media/audiochip.h>
36 #include <media/v4l2-common.h>
39 #include "tuner-xc2028.h"
41 static int tuner = -1;
42 module_param(tuner, int, 0444);
43 MODULE_PARM_DESC(tuner, "tuner type");
45 struct em28xx_hash_table {
51 struct em28xx_board em28xx_boards[] = {
52 [EM2800_BOARD_UNKNOWN] = {
53 .name = "Unknown EM2800 video grabber",
56 .tda9887_conf = TDA9887_PRESENT,
58 .decoder = EM28XX_SAA7113,
60 .type = EM28XX_VMUX_COMPOSITE1,
61 .vmux = SAA7115_COMPOSITE0,
64 .type = EM28XX_VMUX_SVIDEO,
65 .vmux = SAA7115_SVIDEO3,
69 [EM2820_BOARD_UNKNOWN] = {
70 .name = "Unknown EM2750/28xx video grabber",
73 [EM2820_BOARD_KWORLD_PVRTV2800RF] = {
74 .name = "Kworld PVR TV 2800 RF",
77 .tda9887_conf = TDA9887_PRESENT,
79 .decoder = EM28XX_SAA7113,
81 .type = EM28XX_VMUX_COMPOSITE1,
82 .vmux = SAA7115_COMPOSITE0,
85 .type = EM28XX_VMUX_SVIDEO,
86 .vmux = SAA7115_SVIDEO3,
90 [EM2820_BOARD_TERRATEC_CINERGY_250] = {
91 .name = "Terratec Cinergy 250 USB",
93 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
94 .tda9887_conf = TDA9887_PRESENT,
96 .decoder = EM28XX_SAA7113,
98 .type = EM28XX_VMUX_TELEVISION,
99 .vmux = SAA7115_COMPOSITE2,
102 .type = EM28XX_VMUX_COMPOSITE1,
103 .vmux = SAA7115_COMPOSITE0,
106 .type = EM28XX_VMUX_SVIDEO,
107 .vmux = SAA7115_SVIDEO3,
111 [EM2820_BOARD_PINNACLE_USB_2] = {
112 .name = "Pinnacle PCTV USB 2",
114 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
115 .tda9887_conf = TDA9887_PRESENT,
117 .decoder = EM28XX_SAA7113,
119 .type = EM28XX_VMUX_TELEVISION,
120 .vmux = SAA7115_COMPOSITE2,
123 .type = EM28XX_VMUX_COMPOSITE1,
124 .vmux = SAA7115_COMPOSITE0,
127 .type = EM28XX_VMUX_SVIDEO,
128 .vmux = SAA7115_SVIDEO3,
132 [EM2820_BOARD_HAUPPAUGE_WINTV_USB_2] = {
133 .name = "Hauppauge WinTV USB 2",
135 .tuner_type = TUNER_PHILIPS_FM1236_MK3,
136 .tda9887_conf = TDA9887_PRESENT |
137 TDA9887_PORT1_ACTIVE|
138 TDA9887_PORT2_ACTIVE,
140 .decoder = EM28XX_TVP5150,
142 /*FIXME: S-Video not tested */
144 .type = EM28XX_VMUX_TELEVISION,
145 .vmux = TVP5150_COMPOSITE0,
146 .amux = MSP_INPUT_DEFAULT,
148 .type = EM28XX_VMUX_SVIDEO,
149 .vmux = TVP5150_SVIDEO,
150 .amux = MSP_INPUT(MSP_IN_SCART1, MSP_IN_TUNER1,
151 MSP_DSP_IN_SCART, MSP_DSP_IN_SCART),
154 [EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900] = {
155 .name = "Hauppauge WinTV HVR 900",
157 .tda9887_conf = TDA9887_PRESENT,
158 .tuner_type = TUNER_XC2028,
161 .decoder = EM28XX_TVP5150,
163 .type = EM28XX_VMUX_TELEVISION,
164 .vmux = TVP5150_COMPOSITE0,
167 .type = EM28XX_VMUX_COMPOSITE1,
168 .vmux = TVP5150_COMPOSITE1,
171 .type = EM28XX_VMUX_SVIDEO,
172 .vmux = TVP5150_SVIDEO,
176 [EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950] = {
177 .name = "Hauppauge WinTV HVR 950",
179 .tda9887_conf = TDA9887_PRESENT,
180 .tuner_type = TUNER_XC2028,
182 .decoder = EM28XX_TVP5150,
184 .type = EM28XX_VMUX_TELEVISION,
185 .vmux = TVP5150_COMPOSITE0,
188 .type = EM28XX_VMUX_COMPOSITE1,
189 .vmux = TVP5150_COMPOSITE1,
192 .type = EM28XX_VMUX_SVIDEO,
193 .vmux = TVP5150_SVIDEO,
197 [EM2880_BOARD_TERRATEC_HYBRID_XS] = {
198 .name = "Terratec Hybrid XS",
200 .tda9887_conf = TDA9887_PRESENT,
202 .tuner_type = TUNER_XC2028,
203 .decoder = EM28XX_TVP5150,
205 .type = EM28XX_VMUX_TELEVISION,
206 .vmux = TVP5150_COMPOSITE0,
209 .type = EM28XX_VMUX_COMPOSITE1,
210 .vmux = TVP5150_COMPOSITE1,
213 .type = EM28XX_VMUX_SVIDEO,
214 .vmux = TVP5150_SVIDEO,
218 /* maybe there's a reason behind it why Terratec sells the Hybrid XS
219 as Prodigy XS with a different PID, let's keep it separated for now
220 maybe we'll need it lateron */
221 [EM2880_BOARD_TERRATEC_PRODIGY_XS] = {
222 .name = "Terratec Prodigy XS",
224 .tda9887_conf = TDA9887_PRESENT,
226 .tuner_type = TUNER_XC2028,
227 .decoder = EM28XX_TVP5150,
229 .type = EM28XX_VMUX_TELEVISION,
230 .vmux = TVP5150_COMPOSITE0,
233 .type = EM28XX_VMUX_COMPOSITE1,
234 .vmux = TVP5150_COMPOSITE1,
237 .type = EM28XX_VMUX_SVIDEO,
238 .vmux = TVP5150_SVIDEO,
242 [EM2820_BOARD_MSI_VOX_USB_2] = {
243 .name = "MSI VOX USB 2.0",
245 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
246 .tda9887_conf = TDA9887_PRESENT |
247 TDA9887_PORT1_ACTIVE |
248 TDA9887_PORT2_ACTIVE,
250 .decoder = EM28XX_SAA7114,
252 .type = EM28XX_VMUX_TELEVISION,
253 .vmux = SAA7115_COMPOSITE4,
256 .type = EM28XX_VMUX_COMPOSITE1,
257 .vmux = SAA7115_COMPOSITE0,
260 .type = EM28XX_VMUX_SVIDEO,
261 .vmux = SAA7115_SVIDEO3,
265 [EM2800_BOARD_TERRATEC_CINERGY_200] = {
266 .name = "Terratec Cinergy 200 USB",
269 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
270 .tda9887_conf = TDA9887_PRESENT,
272 .decoder = EM28XX_SAA7113,
274 .type = EM28XX_VMUX_TELEVISION,
275 .vmux = SAA7115_COMPOSITE2,
278 .type = EM28XX_VMUX_COMPOSITE1,
279 .vmux = SAA7115_COMPOSITE0,
282 .type = EM28XX_VMUX_SVIDEO,
283 .vmux = SAA7115_SVIDEO3,
287 [EM2800_BOARD_LEADTEK_WINFAST_USBII] = {
288 .name = "Leadtek Winfast USB II",
291 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
292 .tda9887_conf = TDA9887_PRESENT,
294 .decoder = EM28XX_SAA7113,
296 .type = EM28XX_VMUX_TELEVISION,
297 .vmux = SAA7115_COMPOSITE2,
300 .type = EM28XX_VMUX_COMPOSITE1,
301 .vmux = SAA7115_COMPOSITE0,
304 .type = EM28XX_VMUX_SVIDEO,
305 .vmux = SAA7115_SVIDEO3,
309 [EM2800_BOARD_KWORLD_USB2800] = {
310 .name = "Kworld USB2800",
313 .tuner_type = TUNER_PHILIPS_ATSC,
314 .tda9887_conf = TDA9887_PRESENT,
316 .decoder = EM28XX_SAA7113,
318 .type = EM28XX_VMUX_TELEVISION,
319 .vmux = SAA7115_COMPOSITE2,
322 .type = EM28XX_VMUX_COMPOSITE1,
323 .vmux = SAA7115_COMPOSITE0,
326 .type = EM28XX_VMUX_SVIDEO,
327 .vmux = SAA7115_SVIDEO3,
331 [EM2820_BOARD_PINNACLE_DVC_90] = {
332 .name = "Pinnacle Dazzle DVC 90/DVC 100",
335 .decoder = EM28XX_SAA7113,
337 .type = EM28XX_VMUX_COMPOSITE1,
338 .vmux = SAA7115_COMPOSITE0,
341 .type = EM28XX_VMUX_SVIDEO,
342 .vmux = SAA7115_SVIDEO3,
346 [EM2800_BOARD_VGEAR_POCKETTV] = {
347 .name = "V-Gear PocketTV",
350 .tuner_type = TUNER_LG_PAL_NEW_TAPC,
351 .tda9887_conf = TDA9887_PRESENT,
353 .decoder = EM28XX_SAA7113,
355 .type = EM28XX_VMUX_TELEVISION,
356 .vmux = SAA7115_COMPOSITE2,
359 .type = EM28XX_VMUX_COMPOSITE1,
360 .vmux = SAA7115_COMPOSITE0,
363 .type = EM28XX_VMUX_SVIDEO,
364 .vmux = SAA7115_SVIDEO3,
368 [EM2820_BOARD_PROLINK_PLAYTV_USB2] = {
369 .name = "Pixelview Prolink PlayTV USB 2.0",
371 .tda9887_conf = TDA9887_PRESENT,
373 .decoder = EM28XX_SAA7113,
375 .type = EM28XX_VMUX_TELEVISION,
376 .vmux = SAA7115_COMPOSITE2,
379 .type = EM28XX_VMUX_COMPOSITE1,
380 .vmux = SAA7115_COMPOSITE0,
383 .type = EM28XX_VMUX_SVIDEO,
384 .vmux = SAA7115_SVIDEO3,
389 const unsigned int em28xx_bcount = ARRAY_SIZE(em28xx_boards);
391 /* table of devices that work with this driver */
392 struct usb_device_id em28xx_id_table [] = {
393 { USB_DEVICE(0xeb1a, 0x2750),
394 .driver_info = EM2820_BOARD_UNKNOWN },
395 { USB_DEVICE(0xeb1a, 0x2800),
396 .driver_info = EM2800_BOARD_UNKNOWN },
397 { USB_DEVICE(0xeb1a, 0x2820),
398 .driver_info = EM2820_BOARD_UNKNOWN },
399 { USB_DEVICE(0xeb1a, 0x2821),
400 .driver_info = EM2820_BOARD_UNKNOWN },
401 { USB_DEVICE(0xeb1a, 0x2860),
402 .driver_info = EM2820_BOARD_UNKNOWN },
403 { USB_DEVICE(0xeb1a, 0x2861),
404 .driver_info = EM2820_BOARD_UNKNOWN },
405 { USB_DEVICE(0xeb1a, 0x2870),
406 .driver_info = EM2820_BOARD_UNKNOWN },
407 { USB_DEVICE(0xeb1a, 0x2881),
408 .driver_info = EM2820_BOARD_UNKNOWN },
409 { USB_DEVICE(0xeb1a, 0x2883),
410 .driver_info = EM2820_BOARD_UNKNOWN },
411 { USB_DEVICE(0x0ccd, 0x0036),
412 .driver_info = EM2820_BOARD_TERRATEC_CINERGY_250 },
413 { USB_DEVICE(0x2304, 0x0208),
414 .driver_info = EM2820_BOARD_PINNACLE_USB_2 },
415 { USB_DEVICE(0x2040, 0x4200),
416 .driver_info = EM2820_BOARD_HAUPPAUGE_WINTV_USB_2 },
417 { USB_DEVICE(0x2304, 0x0207),
418 .driver_info = EM2820_BOARD_PINNACLE_DVC_90 },
419 { USB_DEVICE(0x2304, 0x021a),
420 .driver_info = EM2820_BOARD_PINNACLE_DVC_90 },
421 { USB_DEVICE(0x2040, 0x6500),
422 .driver_info = EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900 },
423 { USB_DEVICE(0x2040, 0x6513),
424 .driver_info = EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950 },
425 { USB_DEVICE(0x0ccd, 0x0042),
426 .driver_info = EM2880_BOARD_TERRATEC_HYBRID_XS },
427 { USB_DEVICE(0x0ccd, 0x0047),
428 .driver_info = EM2880_BOARD_TERRATEC_PRODIGY_XS },
431 MODULE_DEVICE_TABLE(usb, em28xx_id_table);
433 /* EEPROM hash table for devices with generic USB IDs */
434 static struct em28xx_hash_table em28xx_eeprom_hash [] = {
435 /* P/N: SA 60002070465 Tuner: TVF7533-MF */
436 {0x6ce05a8f, EM2820_BOARD_PROLINK_PLAYTV_USB2, TUNER_YMEC_TVF_5533MF},
439 /* I2C devicelist hash table for devices with generic USB IDs */
440 static struct em28xx_hash_table em28xx_i2c_hash[] = {
441 {0xb06a32c3, EM2800_BOARD_TERRATEC_CINERGY_200, TUNER_LG_PAL_NEW_TAPC},
442 {0xf51200e3, EM2800_BOARD_VGEAR_POCKETTV, TUNER_LG_PAL_NEW_TAPC},
445 /* Since em28xx_pre_card_setup() requires a proper dev->model,
446 * this won't work for boards with generic PCI IDs
448 void em28xx_pre_card_setup(struct em28xx *dev)
450 /* request some modules */
451 switch (dev->model) {
452 case EM2880_BOARD_TERRATEC_PRODIGY_XS:
453 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900:
454 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950:
455 case EM2880_BOARD_TERRATEC_HYBRID_XS:
456 /* reset through GPIO? */
457 em28xx_write_regs_req(dev, 0x00, 0x08, "\x7d", 1);
462 static int em28xx_tuner_callback(void *ptr, int command, int arg)
465 struct em28xx *dev = ptr;
467 if (dev->tuner_type != TUNER_XC2028)
471 case XC2028_TUNER_RESET:
472 /* FIXME: This is device-dependent */
473 dev->em28xx_write_regs_req(dev, 0x00, 0x48, "\x00", 1);
474 dev->em28xx_write_regs_req(dev, 0x00, 0x12, "\x67", 1);
482 static void em28xx_config_tuner(struct em28xx *dev)
484 struct v4l2_priv_tun_config xc2028_cfg;
485 struct xc2028_ctrl ctl;
486 struct tuner_setup tun_setup;
487 struct v4l2_frequency f;
492 tun_setup.mode_mask = T_ANALOG_TV | T_RADIO;
493 tun_setup.type = dev->tuner_type;
494 tun_setup.addr = dev->tuner_addr;
495 tun_setup.tuner_callback = em28xx_tuner_callback;
497 em28xx_i2c_call_clients(dev, TUNER_SET_TYPE_ADDR, &tun_setup);
499 if (dev->tuner_type == TUNER_XC2028) {
500 memset(&ctl, 0, sizeof(ctl));
502 ctl.fname = XC2028_DEFAULT_FIRMWARE;
504 ctl.mts = em28xx_boards[dev->model].mts_firmware;
506 xc2028_cfg.tuner = TUNER_XC2028;
507 xc2028_cfg.priv = &ctl;
509 em28xx_i2c_call_clients(dev, TUNER_SET_CONFIG, &xc2028_cfg);
512 /* configure tuner */
514 f.type = V4L2_TUNER_ANALOG_TV;
515 f.frequency = 9076; /* just a magic number */
516 dev->ctl_freq = f.frequency;
517 em28xx_i2c_call_clients(dev, VIDIOC_S_FREQUENCY, &f);
520 static int em28xx_hint_board(struct em28xx *dev)
524 /* HINT method: EEPROM
526 * This method works only for boards with eeprom.
527 * Uses a hash of all eeprom bytes. The hash should be
528 * unique for a vendor/tuner pair.
529 * There are a high chance that tuners for different
530 * video standards produce different hashes.
532 for (i = 0; i < ARRAY_SIZE(em28xx_eeprom_hash); i++) {
533 if (dev->hash == em28xx_eeprom_hash[i].hash) {
534 dev->model = em28xx_eeprom_hash[i].model;
535 dev->tuner_type = em28xx_eeprom_hash[i].tuner;
537 em28xx_errdev("Your board has no unique USB ID.\n");
538 em28xx_errdev("A hint were successfully done, "
539 "based on eeprom hash.\n");
540 em28xx_errdev("This method is not 100%% failproof.\n");
541 em28xx_errdev("If the board were missdetected, "
542 "please email this log to:\n");
543 em28xx_errdev("\tV4L Mailing List "
544 " <video4linux-list@redhat.com>\n");
545 em28xx_errdev("Board detected as %s\n",
546 em28xx_boards[dev->model].name);
552 /* HINT method: I2C attached devices
554 * This method works for all boards.
555 * Uses a hash of i2c scanned devices.
556 * Devices with the same i2c attached chips will
557 * be considered equal.
558 * This method is less precise than the eeprom one.
561 /* user did not request i2c scanning => do it now */
563 em28xx_do_i2c_scan(dev);
565 for (i = 0; i < ARRAY_SIZE(em28xx_i2c_hash); i++) {
566 if (dev->i2c_hash == em28xx_i2c_hash[i].hash) {
567 dev->model = em28xx_i2c_hash[i].model;
568 dev->tuner_type = em28xx_i2c_hash[i].tuner;
569 em28xx_errdev("Your board has no unique USB ID.\n");
570 em28xx_errdev("A hint were successfully done, "
571 "based on i2c devicelist hash.\n");
572 em28xx_errdev("This method is not 100%% failproof.\n");
573 em28xx_errdev("If the board were missdetected, "
574 "please email this log to:\n");
575 em28xx_errdev("\tV4L Mailing List "
576 " <video4linux-list@redhat.com>\n");
577 em28xx_errdev("Board detected as %s\n",
578 em28xx_boards[dev->model].name);
584 em28xx_errdev("Your board has no unique USB ID and thus need a "
585 "hint to be detected.\n");
586 em28xx_errdev("You may try to use card=<n> insmod option to "
587 "workaround that.\n");
588 em28xx_errdev("Please send an email with this log to:\n");
589 em28xx_errdev("\tV4L Mailing List <video4linux-list@redhat.com>\n");
590 em28xx_errdev("Board eeprom hash is 0x%08lx\n", dev->hash);
591 em28xx_errdev("Board i2c devicelist hash is 0x%08lx\n", dev->i2c_hash);
593 em28xx_errdev("Here is a list of valid choices for the card=<n>"
594 " insmod option:\n");
595 for (i = 0; i < em28xx_bcount; i++) {
596 em28xx_errdev(" card=%d -> %s\n",
597 i, em28xx_boards[i].name);
603 static void em28xx_set_model(struct em28xx *dev)
605 dev->is_em2800 = em28xx_boards[dev->model].is_em2800;
606 dev->has_tuner = em28xx_boards[dev->model].has_tuner;
607 dev->has_msp34xx = em28xx_boards[dev->model].has_msp34xx;
608 dev->tda9887_conf = em28xx_boards[dev->model].tda9887_conf;
609 dev->decoder = em28xx_boards[dev->model].decoder;
610 dev->video_inputs = em28xx_boards[dev->model].vchannels;
612 if (!em28xx_boards[dev->model].has_tuner)
613 dev->tuner_type = UNSET;
616 void em28xx_card_setup(struct em28xx *dev)
618 em28xx_set_model(dev);
620 dev->tuner_type = em28xx_boards[dev->model].tuner_type;
622 /* request some modules */
623 switch (dev->model) {
624 case EM2820_BOARD_HAUPPAUGE_WINTV_USB_2:
625 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900:
626 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950:
629 #ifdef CONFIG_MODULES
630 request_module("tveeprom");
632 /* Call first TVeeprom */
634 dev->i2c_client.addr = 0xa0 >> 1;
635 tveeprom_hauppauge_analog(&dev->i2c_client, &tv, dev->eedata);
637 dev->tuner_type = tv.tuner_type;
638 if (tv.audio_processor == AUDIO_CHIP_MSP34XX) {
639 dev->i2s_speed = 2048000;
640 dev->has_msp34xx = 1;
642 #ifdef CONFIG_MODULES
644 request_module("ir-kbd-i2c");
646 /* FIXME: Should also retrieve decoder processor type */
650 case EM2820_BOARD_KWORLD_PVRTV2800RF:
651 /* GPIO enables sound on KWORLD PVR TV 2800RF */
652 em28xx_write_regs_req(dev, 0x00, 0x08, "\xf9", 1);
654 case EM2820_BOARD_UNKNOWN:
655 case EM2800_BOARD_UNKNOWN:
656 if (!em28xx_hint_board(dev))
657 em28xx_set_model(dev);
660 /* Allow override tuner type by a module parameter */
662 dev->tuner_type = tuner;
664 #ifdef CONFIG_MODULES
665 /* request some modules */
666 if (dev->has_msp34xx)
667 request_module("msp3400");
668 if (dev->decoder == EM28XX_SAA7113 || dev->decoder == EM28XX_SAA7114)
669 request_module("saa7115");
670 if (dev->decoder == EM28XX_TVP5150)
671 request_module("tvp5150");
673 request_module("tuner");
676 em28xx_config_tuner(dev);