5 * Copyright (C) 2005 Mike Isely <isely@pobox.com>
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
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.
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
21 #ifndef __PVRUSB2_DEVATTR_H
22 #define __PVRUSB2_DEVATTR_H
24 #include <linux/mod_devicetable.h>
25 #include <linux/videodev2.h>
29 This header defines structures used to describe attributes of a device.
34 struct pvr2_string_table
{
39 #define PVR2_ROUTING_SCHEME_HAUPPAUGE 0
40 #define PVR2_ROUTING_SCHEME_GOTVIEW 1
42 #define PVR2_DIGITAL_SCHEME_NONE 0
43 #define PVR2_DIGITAL_SCHEME_HAUPPAUGE 1
44 #define PVR2_DIGITAL_SCHEME_ONAIR 2
46 #define PVR2_LED_SCHEME_NONE 0
47 #define PVR2_LED_SCHEME_HAUPPAUGE 1
49 /* This describes a particular hardware type (except for the USB device ID
50 which must live in a separate structure due to environmental
51 constraints). See the top of pvrusb2-hdw.c for where this is
53 struct pvr2_device_desc
{
54 /* Single line text description of hardware */
55 const char *description
;
57 /* Single token identifier for hardware */
58 const char *shortname
;
60 /* List of additional client modules we need to load */
61 struct pvr2_string_table client_modules
;
63 /* List of FX2 firmware file names we should search; if empty then
64 FX2 firmware check / load is skipped and we assume the device
65 was initialized from internal ROM. */
66 struct pvr2_string_table fx2_firmware
;
68 /* Signal routing scheme used by device, contains one of
69 PVR2_ROUTING_SCHEME_XXX. Schemes have to be defined as we
70 encounter them. This is an arbitrary integer scheme id; its
71 meaning is contained entirely within the driver and is
72 interpreted by logic which must send commands to the chip-level
73 drivers (search for things which touch this field). */
74 unsigned int signal_routing_scheme
;
76 /* Indicates scheme for controlling device's LED (if any). The
77 driver will turn on the LED when streaming is underway. This
78 contains one of PVR2_LED_SCHEME_XXX. */
79 unsigned int led_scheme
;
81 /* Control scheme to use if there is a digital tuner. This
82 contains one of PVR2_DIGITAL_SCHEME_XXX. This is an arbitrary
83 integer scheme id; its meaning is contained entirely within the
84 driver and is interpreted by logic which must control the
85 streaming pathway (search for things which touch this field). */
86 unsigned int digital_control_scheme
;
88 /* V4L tuner type ID to use with this device (only used if the
89 driver could not discover the type any other way). */
90 int default_tuner_type
;
92 /* Initial standard bits to use for this device, if not zero.
93 Anything set here is also implied as an available standard.
94 Note: This is ignored if overridden on the module load line via
95 the video_std module option. */
96 v4l2_std_id default_std_mask
;
98 /* If set, we don't bother trying to load cx23416 firmware. */
99 char flag_skip_cx23416_firmware
;
101 /* Device has a hauppauge eeprom which we can interrogate. */
102 char flag_has_hauppauge_rom
;
104 /* Device does not require a powerup command to be issued. */
105 char flag_no_powerup
;
107 /* Device has a cx25840 - this enables special additional logic to
109 char flag_has_cx25840
;
111 /* Device has a wm8775 - this enables special additional logic to
112 ensure that it is found. */
113 char flag_has_wm8775
;
115 /* Device has IR hardware that can be faked into looking like a
116 normal Hauppauge i2c IR receiver. This is currently very
117 specific to the 24xxx device, where Hauppauge had replaced their
118 'standard' I2C IR receiver with a bunch of FPGA logic controlled
119 directly via the FX2. Turning this on tells the pvrusb2 driver
120 to virtualize the presence of the non-existant IR receiver chip and
121 implement the virtual receiver in terms of appropriate FX2
123 char flag_has_hauppauge_custom_ir
;
125 /* These bits define which kinds of sources the device can handle.
126 Note: Digital tuner presence is inferred by the
127 digital_control_scheme enumeration. */
128 char flag_has_fmradio
; /* Has FM radio receiver */
129 char flag_has_analogtuner
; /* Has analog tuner */
130 char flag_has_composite
; /* Has composite input */
131 char flag_has_svideo
; /* Has s-video input */
134 extern struct usb_device_id pvr2_device_table
[];
136 #endif /* __PVRUSB2_HDW_INTERNAL_H */
139 Stuff for Emacs to see, in order to encourage consistent editing style:
140 *** Local Variables: ***
142 *** fill-column: 75 ***
144 *** c-basic-offset: 8 ***