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",
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(0x2040, 0x6500),
420 .driver_info = EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900 },
421 { USB_DEVICE(0x2040, 0x6513),
422 .driver_info = EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950 },
423 { USB_DEVICE(0x0ccd, 0x0042),
424 .driver_info = EM2880_BOARD_TERRATEC_HYBRID_XS },
425 { USB_DEVICE(0x0ccd, 0x0047),
426 .driver_info = EM2880_BOARD_TERRATEC_PRODIGY_XS },
429 MODULE_DEVICE_TABLE(usb, em28xx_id_table);
431 /* EEPROM hash table for devices with generic USB IDs */
432 static struct em28xx_hash_table em28xx_eeprom_hash [] = {
433 /* P/N: SA 60002070465 Tuner: TVF7533-MF */
434 {0x6ce05a8f, EM2820_BOARD_PROLINK_PLAYTV_USB2, TUNER_YMEC_TVF_5533MF},
437 /* I2C devicelist hash table for devices with generic USB IDs */
438 static struct em28xx_hash_table em28xx_i2c_hash[] = {
439 {0xb06a32c3, EM2800_BOARD_TERRATEC_CINERGY_200, TUNER_LG_PAL_NEW_TAPC},
440 {0xf51200e3, EM2800_BOARD_VGEAR_POCKETTV, TUNER_LG_PAL_NEW_TAPC},
443 /* Since em28xx_pre_card_setup() requires a proper dev->model,
444 * this won't work for boards with generic PCI IDs
446 void em28xx_pre_card_setup(struct em28xx *dev)
448 /* request some modules */
449 switch (dev->model) {
450 case EM2880_BOARD_TERRATEC_PRODIGY_XS:
451 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900:
452 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950:
453 case EM2880_BOARD_TERRATEC_HYBRID_XS:
454 /* reset through GPIO? */
455 em28xx_write_regs_req(dev, 0x00, 0x08, "\x7d", 1);
460 static int em28xx_tuner_callback(void *ptr, int command, int arg)
463 struct em28xx *dev = ptr;
465 if (dev->tuner_type != TUNER_XC2028)
469 case XC2028_TUNER_RESET:
470 /* FIXME: This is device-dependent */
471 dev->em28xx_write_regs_req(dev, 0x00, 0x48, "\x00", 1);
472 dev->em28xx_write_regs_req(dev, 0x00, 0x12, "\x67", 1);
480 static void em28xx_config_tuner(struct em28xx *dev)
482 struct v4l2_priv_tun_config xc2028_cfg;
483 struct xc2028_ctrl ctl;
484 struct tuner_setup tun_setup;
485 struct v4l2_frequency f;
490 tun_setup.mode_mask = T_ANALOG_TV | T_RADIO;
491 tun_setup.type = dev->tuner_type;
492 tun_setup.addr = dev->tuner_addr;
493 tun_setup.tuner_callback = em28xx_tuner_callback;
495 em28xx_i2c_call_clients(dev, TUNER_SET_TYPE_ADDR, &tun_setup);
497 if (dev->tuner_type == TUNER_XC2028) {
498 memset(&ctl, 0, sizeof(ctl));
500 ctl.fname = XC2028_DEFAULT_FIRMWARE;
502 ctl.mts = em28xx_boards[dev->model].mts_firmware;
504 xc2028_cfg.tuner = TUNER_XC2028;
505 xc2028_cfg.priv = &ctl;
507 em28xx_i2c_call_clients(dev, TUNER_SET_CONFIG, &xc2028_cfg);
510 /* configure tuner */
512 f.type = V4L2_TUNER_ANALOG_TV;
513 f.frequency = 9076; /* just a magic number */
514 dev->ctl_freq = f.frequency;
515 em28xx_i2c_call_clients(dev, VIDIOC_S_FREQUENCY, &f);
518 static int em28xx_hint_board(struct em28xx *dev)
522 /* HINT method: EEPROM
524 * This method works only for boards with eeprom.
525 * Uses a hash of all eeprom bytes. The hash should be
526 * unique for a vendor/tuner pair.
527 * There are a high chance that tuners for different
528 * video standards produce different hashes.
530 for (i = 0; i < ARRAY_SIZE(em28xx_eeprom_hash); i++) {
531 if (dev->hash == em28xx_eeprom_hash[i].hash) {
532 dev->model = em28xx_eeprom_hash[i].model;
533 dev->tuner_type = em28xx_eeprom_hash[i].tuner;
535 em28xx_errdev("Your board has no unique USB ID.\n");
536 em28xx_errdev("A hint were successfully done, "
537 "based on eeprom hash.\n");
538 em28xx_errdev("This method is not 100%% failproof.\n");
539 em28xx_errdev("If the board were missdetected, "
540 "please email this log to:\n");
541 em28xx_errdev("\tV4L Mailing List "
542 " <video4linux-list@redhat.com>\n");
543 em28xx_errdev("Board detected as %s\n",
544 em28xx_boards[dev->model].name);
550 /* HINT method: I2C attached devices
552 * This method works for all boards.
553 * Uses a hash of i2c scanned devices.
554 * Devices with the same i2c attached chips will
555 * be considered equal.
556 * This method is less precise than the eeprom one.
559 /* user did not request i2c scanning => do it now */
561 em28xx_do_i2c_scan(dev);
563 for (i = 0; i < ARRAY_SIZE(em28xx_i2c_hash); i++) {
564 if (dev->i2c_hash == em28xx_i2c_hash[i].hash) {
565 dev->model = em28xx_i2c_hash[i].model;
566 dev->tuner_type = em28xx_i2c_hash[i].tuner;
567 em28xx_errdev("Your board has no unique USB ID.\n");
568 em28xx_errdev("A hint were successfully done, "
569 "based on i2c devicelist hash.\n");
570 em28xx_errdev("This method is not 100%% failproof.\n");
571 em28xx_errdev("If the board were missdetected, "
572 "please email this log to:\n");
573 em28xx_errdev("\tV4L Mailing List "
574 " <video4linux-list@redhat.com>\n");
575 em28xx_errdev("Board detected as %s\n",
576 em28xx_boards[dev->model].name);
582 em28xx_errdev("Your board has no unique USB ID and thus need a "
583 "hint to be detected.\n");
584 em28xx_errdev("You may try to use card=<n> insmod option to "
585 "workaround that.\n");
586 em28xx_errdev("Please send an email with this log to:\n");
587 em28xx_errdev("\tV4L Mailing List <video4linux-list@redhat.com>\n");
588 em28xx_errdev("Board eeprom hash is 0x%08lx\n", dev->hash);
589 em28xx_errdev("Board i2c devicelist hash is 0x%08lx\n", dev->i2c_hash);
591 em28xx_errdev("Here is a list of valid choices for the card=<n>"
592 " insmod option:\n");
593 for (i = 0; i < em28xx_bcount; i++) {
594 em28xx_errdev(" card=%d -> %s\n",
595 i, em28xx_boards[i].name);
601 static void em28xx_set_model(struct em28xx *dev)
603 dev->is_em2800 = em28xx_boards[dev->model].is_em2800;
604 dev->has_tuner = em28xx_boards[dev->model].has_tuner;
605 dev->has_msp34xx = em28xx_boards[dev->model].has_msp34xx;
606 dev->tda9887_conf = em28xx_boards[dev->model].tda9887_conf;
607 dev->decoder = em28xx_boards[dev->model].decoder;
608 dev->video_inputs = em28xx_boards[dev->model].vchannels;
610 if (!em28xx_boards[dev->model].has_tuner)
611 dev->tuner_type = UNSET;
614 void em28xx_card_setup(struct em28xx *dev)
616 em28xx_set_model(dev);
618 dev->tuner_type = em28xx_boards[dev->model].tuner_type;
620 /* request some modules */
621 switch (dev->model) {
622 case EM2820_BOARD_HAUPPAUGE_WINTV_USB_2:
623 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900:
624 case EM2880_BOARD_HAUPPAUGE_WINTV_HVR_950:
627 #ifdef CONFIG_MODULES
628 request_module("tveeprom");
630 /* Call first TVeeprom */
632 dev->i2c_client.addr = 0xa0 >> 1;
633 tveeprom_hauppauge_analog(&dev->i2c_client, &tv, dev->eedata);
635 dev->tuner_type = tv.tuner_type;
636 if (tv.audio_processor == AUDIO_CHIP_MSP34XX) {
637 dev->i2s_speed = 2048000;
638 dev->has_msp34xx = 1;
640 #ifdef CONFIG_MODULES
642 request_module("ir-kbd-i2c");
644 /* FIXME: Should also retrieve decoder processor type */
648 case EM2820_BOARD_KWORLD_PVRTV2800RF:
649 /* GPIO enables sound on KWORLD PVR TV 2800RF */
650 em28xx_write_regs_req(dev, 0x00, 0x08, "\xf9", 1);
652 case EM2820_BOARD_UNKNOWN:
653 case EM2800_BOARD_UNKNOWN:
654 if (!em28xx_hint_board(dev))
655 em28xx_set_model(dev);
658 /* Allow override tuner type by a module parameter */
660 dev->tuner_type = tuner;
662 #ifdef CONFIG_MODULES
663 /* request some modules */
664 if (dev->has_msp34xx)
665 request_module("msp3400");
666 if (dev->decoder == EM28XX_SAA7113 || dev->decoder == EM28XX_SAA7114)
667 request_module("saa7115");
668 if (dev->decoder == EM28XX_TVP5150)
669 request_module("tvp5150");
671 request_module("tuner");
674 em28xx_config_tuner(dev);