blob: 4e4798d6139fd5bcede2392ca3f465e935fdf127 [file] [log] [blame]
Mike Isely989eb152007-11-26 01:53:12 -03001/*
2 *
3 * $Id$
4 *
5 * Copyright (C) 2005 Mike Isely <isely@pobox.com>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 *
20 */
21#ifndef __PVRUSB2_DEVATTR_H
22#define __PVRUSB2_DEVATTR_H
23
24#include <linux/mod_devicetable.h>
Mike Isely6a540252007-12-02 23:51:34 -030025#include <linux/videodev2.h>
Mike Isely989eb152007-11-26 01:53:12 -030026
27/*
28
29 This header defines structures used to describe attributes of a device.
30
31*/
32
33
34struct pvr2_string_table {
35 const char **lst;
36 unsigned int cnt;
37};
38
Mike Iselyf5174af2007-11-26 02:07:26 -030039#define PVR2_ROUTING_SCHEME_HAUPPAUGE 0
Mike Isely9e2e3ae2007-11-26 02:14:23 -030040#define PVR2_ROUTING_SCHEME_GOTVIEW 1
Mike Isely989eb152007-11-26 01:53:12 -030041
Mike Iselye8f5bac2008-04-22 14:45:40 -030042#define PVR2_DIGITAL_SCHEME_NONE 0
43#define PVR2_DIGITAL_SCHEME_HAUPPAUGE 1
44#define PVR2_DIGITAL_SCHEME_ONAIR 2
45
Mike Isely989eb152007-11-26 01:53:12 -030046/* This describes a particular hardware type (except for the USB device ID
47 which must live in a separate structure due to environmental
48 constraints). See the top of pvrusb2-hdw.c for where this is
49 instantiated. */
50struct pvr2_device_desc {
51 /* Single line text description of hardware */
52 const char *description;
53
54 /* Single token identifier for hardware */
55 const char *shortname;
56
57 /* List of additional client modules we need to load */
58 struct pvr2_string_table client_modules;
59
60 /* List of FX2 firmware file names we should search; if empty then
61 FX2 firmware check / load is skipped and we assume the device
62 was initialized from internal ROM. */
63 struct pvr2_string_table fx2_firmware;
64
Mike Iselyf5174af2007-11-26 02:07:26 -030065 /* Signal routing scheme used by device, contains one of
66 PVR2_ROUTING_SCHEME_XXX. Schemes have to be defined as we
67 encounter them. This is an arbitrary integer scheme id; its
68 meaning is contained entirely within the driver and is
69 interpreted by logic which must send commands to the chip-level
70 drivers (search for things which touch this field). */
71 unsigned int signal_routing_scheme;
72
Mike Iselye8f5bac2008-04-22 14:45:40 -030073 /* Control scheme to use if there is a digital tuner. This
74 contains one of PVR2_DIGITAL_SCHEME_XXX. This is an arbitrary
75 integer scheme id; its meaning is contained entirely within the
76 driver and is interpreted by logic which must control the
77 streaming pathway (search for things which touch this field). */
78 unsigned int digital_control_scheme;
79
Mike Iselyaaf78842007-11-26 02:04:11 -030080 /* V4L tuner type ID to use with this device (only used if the
81 driver could not discover the type any other way). */
82 int default_tuner_type;
83
Mike Isely6a540252007-12-02 23:51:34 -030084 /* Initial standard bits to use for this device, if not zero.
85 Anything set here is also implied as an available standard.
86 Note: This is ignored if overridden on the module load line via
87 the video_std module option. */
88 v4l2_std_id default_std_mask;
89
Mike Isely989eb152007-11-26 01:53:12 -030090 /* If set, we don't bother trying to load cx23416 firmware. */
91 char flag_skip_cx23416_firmware;
92
Mike Iselyaaf78842007-11-26 02:04:11 -030093 /* Device has a hauppauge eeprom which we can interrogate. */
94 char flag_has_hauppauge_rom;
95
Mike Isely989eb152007-11-26 01:53:12 -030096 /* Device does not require a powerup command to be issued. */
97 char flag_no_powerup;
98
99 /* Device has a cx25840 - this enables special additional logic to
100 handle it. */
101 char flag_has_cx25840;
102
103 /* Device has a wm8775 - this enables special additional logic to
104 ensure that it is found. */
105 char flag_has_wm8775;
Mike Isely056d1a82007-11-26 02:09:42 -0300106
107 /* Device has IR hardware that can be faked into looking like a
Mike Isely4ca7f702007-12-03 01:45:26 -0300108 normal Hauppauge i2c IR receiver. This is currently very
109 specific to the 24xxx device, where Hauppauge had replaced their
110 'standard' I2C IR receiver with a bunch of FPGA logic controlled
111 directly via the FX2. Turning this on tells the pvrusb2 driver
112 to virtualize the presence of the non-existant IR receiver chip and
113 implement the virtual receiver in terms of appropriate FX2
114 commands. */
Mike Isely056d1a82007-11-26 02:09:42 -0300115 char flag_has_hauppauge_custom_ir;
Mike Iselyd068c6e2008-04-22 14:45:36 -0300116
Mike Iselye8f5bac2008-04-22 14:45:40 -0300117 /* These bits define which kinds of sources the device can handle.
118 Note: Digital tuner presence is inferred by the
119 digital_control_scheme enumeration. */
Mike Isely1aaac602008-04-22 14:45:36 -0300120 char flag_has_fmradio; /* Has FM radio receiver */
121 char flag_has_analogtuner; /* Has analog tuner */
Mike Isely1aaac602008-04-22 14:45:36 -0300122 char flag_has_composite; /* Has composite input */
123 char flag_has_svideo; /* Has s-video input */
Mike Isely989eb152007-11-26 01:53:12 -0300124};
125
Mike Isely989eb152007-11-26 01:53:12 -0300126extern struct usb_device_id pvr2_device_table[];
Mike Isely989eb152007-11-26 01:53:12 -0300127
128#endif /* __PVRUSB2_HDW_INTERNAL_H */
129
130/*
131 Stuff for Emacs to see, in order to encourage consistent editing style:
132 *** Local Variables: ***
133 *** mode: c ***
134 *** fill-column: 75 ***
135 *** tab-width: 8 ***
136 *** c-basic-offset: 8 ***
137 *** End: ***
138 */