1 /*
2  *  cx18 functions to query card hardware
3  *
4  *  Derived from ivtv-cards.c
5  *
6  *  Copyright (C) 2007  Hans Verkuil <hverkuil@xs4all.nl>
7  *  Copyright (C) 2008  Andy Walls <awalls@md.metrocast.net>
8  *
9  *  This program is free software; you can redistribute it and/or modify
10  *  it under the terms of the GNU General Public License as published by
11  *  the Free Software Foundation; either version 2 of the License, or
12  *  (at your option) any later version.
13  *
14  *  This program is distributed in the hope that it will be useful,
15  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  *  GNU General Public License for more details.
18  */
19 
20 /* hardware flags */
21 #define CX18_HW_TUNER			(1 << 0)
22 #define CX18_HW_TVEEPROM		(1 << 1)
23 #define CX18_HW_CS5345			(1 << 2)
24 #define CX18_HW_DVB			(1 << 3)
25 #define CX18_HW_418_AV			(1 << 4)
26 #define CX18_HW_GPIO_MUX		(1 << 5)
27 #define CX18_HW_GPIO_RESET_CTRL		(1 << 6)
28 #define CX18_HW_Z8F0811_IR_TX_HAUP	(1 << 7)
29 #define CX18_HW_Z8F0811_IR_RX_HAUP	(1 << 8)
30 #define CX18_HW_Z8F0811_IR_HAUP	(CX18_HW_Z8F0811_IR_RX_HAUP | \
31 				 CX18_HW_Z8F0811_IR_TX_HAUP)
32 
33 #define CX18_HW_IR_ANY (CX18_HW_Z8F0811_IR_RX_HAUP | \
34 			CX18_HW_Z8F0811_IR_TX_HAUP)
35 
36 /* video inputs */
37 #define	CX18_CARD_INPUT_VID_TUNER	1
38 #define	CX18_CARD_INPUT_SVIDEO1 	2
39 #define	CX18_CARD_INPUT_SVIDEO2 	3
40 #define	CX18_CARD_INPUT_COMPOSITE1 	4
41 #define	CX18_CARD_INPUT_COMPOSITE2 	5
42 #define	CX18_CARD_INPUT_COMPONENT1 	6
43 
44 /* audio inputs */
45 #define	CX18_CARD_INPUT_AUD_TUNER	1
46 #define	CX18_CARD_INPUT_LINE_IN1 	2
47 #define	CX18_CARD_INPUT_LINE_IN2 	3
48 
49 #define CX18_CARD_MAX_VIDEO_INPUTS 6
50 #define CX18_CARD_MAX_AUDIO_INPUTS 3
51 #define CX18_CARD_MAX_TUNERS  	   2
52 
53 /* V4L2 capability aliases */
54 #define CX18_CAP_ENCODER (V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_TUNER | \
55 			  V4L2_CAP_AUDIO | V4L2_CAP_READWRITE | \
56 			  V4L2_CAP_STREAMING | V4L2_CAP_VBI_CAPTURE | \
57 			  V4L2_CAP_SLICED_VBI_CAPTURE)
58 
59 struct cx18_card_video_input {
60 	u8  video_type; 	/* video input type */
61 	u8  audio_index;	/* index in cx18_card_audio_input array */
62 	u32 video_input;	/* hardware video input */
63 };
64 
65 struct cx18_card_audio_input {
66 	u8  audio_type;		/* audio input type */
67 	u32 audio_input;	/* hardware audio input */
68 	u16 muxer_input;	/* hardware muxer input for boards with a
69 				   multiplexer chip */
70 };
71 
72 struct cx18_card_pci_info {
73 	u16 device;
74 	u16 subsystem_vendor;
75 	u16 subsystem_device;
76 };
77 
78 /* GPIO definitions */
79 
80 /* The mask is the set of bits used by the operation */
81 
82 struct cx18_gpio_init { /* set initial GPIO DIR and OUT values */
83 	u32 direction; 	/* DIR setting. Leave to 0 if no init is needed */
84 	u32 initial_value;
85 };
86 
87 struct cx18_gpio_i2c_slave_reset {
88 	u32 active_lo_mask; /* GPIO outputs that reset i2c chips when low */
89 	u32 active_hi_mask; /* GPIO outputs that reset i2c chips when high */
90 	int msecs_asserted; /* time period reset must remain asserted */
91 	int msecs_recovery; /* time after deassert for chips to be ready */
92 	u32 ir_reset_mask;  /* GPIO to reset the Zilog Z8F0811 IR contoller */
93 };
94 
95 struct cx18_gpio_audio_input { 	/* select tuner/line in input */
96 	u32 mask; 		/* leave to 0 if not supported */
97 	u32 tuner;
98 	u32 linein;
99 	u32 radio;
100 };
101 
102 struct cx18_card_tuner {
103 	v4l2_std_id std; 	/* standard for which the tuner is suitable */
104 	int 	    tuner; 	/* tuner ID (from tuner.h) */
105 };
106 
107 struct cx18_card_tuner_i2c {
108 	unsigned short radio[2];/* radio tuner i2c address to probe */
109 	unsigned short demod[3];/* demodulator i2c address to probe */
110 	unsigned short tv[4];	/* tv tuner i2c addresses to probe */
111 };
112 
113 struct cx18_ddr {		/* DDR config data */
114 	u32 chip_config;
115 	u32 refresh;
116 	u32 timing1;
117 	u32 timing2;
118 	u32 tune_lane;
119 	u32 initial_emrs;
120 };
121 
122 /* for card information/parameters */
123 struct cx18_card {
124 	int type;
125 	char *name;
126 	char *comment;
127 	u32 v4l2_capabilities;
128 	u32 hw_audio_ctrl;	/* hardware used for the V4L2 controls (only
129 				   1 dev allowed currently) */
130 	u32 hw_muxer;		/* hardware used to multiplex audio input */
131 	u32 hw_all;		/* all hardware used by the board */
132 	struct cx18_card_video_input video_inputs[CX18_CARD_MAX_VIDEO_INPUTS];
133 	struct cx18_card_audio_input audio_inputs[CX18_CARD_MAX_AUDIO_INPUTS];
134 	struct cx18_card_audio_input radio_input;
135 
136 	/* GPIO card-specific settings */
137 	u8 xceive_pin; 		/* XCeive tuner GPIO reset pin */
138 	struct cx18_gpio_init 		 gpio_init;
139 	struct cx18_gpio_i2c_slave_reset gpio_i2c_slave_reset;
140 	struct cx18_gpio_audio_input    gpio_audio_input;
141 
142 	struct cx18_card_tuner tuners[CX18_CARD_MAX_TUNERS];
143 	struct cx18_card_tuner_i2c *i2c;
144 
145 	struct cx18_ddr ddr;
146 
147 	/* list of device and subsystem vendor/devices that
148 	   correspond to this card type. */
149 	const struct cx18_card_pci_info *pci_list;
150 };
151 
152 int cx18_get_input(struct cx18 *cx, u16 index, struct v4l2_input *input);
153 int cx18_get_audio_input(struct cx18 *cx, u16 index, struct v4l2_audio *input);
154 const struct cx18_card *cx18_get_card(u16 index);
155