• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2005-2006 Micronas USA Inc.
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License (Version 2) as
6  * published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software Foundation,
15  * Inc., 59 Temple Place - Suite 330, Boston MA 02111-1307, USA.
16  */
17 
18 /*
19  * This is the private include file for the go7007 driver.  It should not
20  * be included by anybody but the driver itself, and especially not by
21  * user-space applications.
22  */
23 
24 struct go7007;
25 
26 /* IDs to activate board-specific support code */
27 #define GO7007_BOARDID_MATRIX_II	0
28 #define GO7007_BOARDID_MATRIX_RELOAD	1
29 #define GO7007_BOARDID_STAR_TREK	2
30 #define GO7007_BOARDID_PCI_VOYAGER	3
31 #define GO7007_BOARDID_XMEN		4
32 #define GO7007_BOARDID_XMEN_II		5
33 #define GO7007_BOARDID_XMEN_III		6
34 #define GO7007_BOARDID_MATRIX_REV	7
35 #define GO7007_BOARDID_PX_M402U		16
36 #define GO7007_BOARDID_PX_TV402U_ANY	17 /* need to check tuner model */
37 #define GO7007_BOARDID_PX_TV402U_NA	18 /* detected NTSC tuner */
38 #define GO7007_BOARDID_PX_TV402U_EU	19 /* detected PAL tuner */
39 #define GO7007_BOARDID_PX_TV402U_JP	20 /* detected NTSC-J tuner */
40 #define GO7007_BOARDID_LIFEVIEW_LR192	21 /* TV Walker Ultra */
41 #define GO7007_BOARDID_ENDURA		22
42 #define GO7007_BOARDID_ADLINK_MPG24	23
43 #define GO7007_BOARDID_SENSORAY_2250	24 /* Sensoray 2250/2251 */
44 
45 /* Various characteristics of each board */
46 #define GO7007_BOARD_HAS_AUDIO		(1<<0)
47 #define GO7007_BOARD_USE_ONBOARD_I2C	(1<<1)
48 #define GO7007_BOARD_HAS_TUNER		(1<<2)
49 
50 /* Characteristics of sensor devices */
51 #define GO7007_SENSOR_VALID_POLAR	(1<<0)
52 #define GO7007_SENSOR_HREF_POLAR	(1<<1)
53 #define GO7007_SENSOR_VREF_POLAR	(1<<2)
54 #define GO7007_SENSOR_FIELD_ID_POLAR	(1<<3)
55 #define GO7007_SENSOR_BIT_WIDTH		(1<<4)
56 #define GO7007_SENSOR_VALID_ENABLE	(1<<5)
57 #define GO7007_SENSOR_656		(1<<6)
58 #define GO7007_SENSOR_CONFIG_MASK	0x7f
59 #define GO7007_SENSOR_TV		(1<<7)
60 #define GO7007_SENSOR_VBI		(1<<8)
61 #define GO7007_SENSOR_SCALING		(1<<9)
62 
63 /* Characteristics of audio sensor devices */
64 #define GO7007_AUDIO_I2S_MODE_1		(1)
65 #define GO7007_AUDIO_I2S_MODE_2		(2)
66 #define GO7007_AUDIO_I2S_MODE_3		(3)
67 #define GO7007_AUDIO_BCLK_POLAR		(1<<2)
68 #define GO7007_AUDIO_WORD_14		(14<<4)
69 #define GO7007_AUDIO_WORD_16		(16<<4)
70 #define GO7007_AUDIO_ONE_CHANNEL	(1<<11)
71 #define GO7007_AUDIO_I2S_MASTER		(1<<16)
72 #define GO7007_AUDIO_OKI_MODE		(1<<17)
73 
74 struct go7007_board_info {
75 	char *firmware;
76 	unsigned int flags;
77 	int hpi_buffer_cap;
78 	unsigned int sensor_flags;
79 	int sensor_width;
80 	int sensor_height;
81 	int sensor_framerate;
82 	int sensor_h_offset;
83 	int sensor_v_offset;
84 	unsigned int audio_flags;
85 	int audio_rate;
86 	int audio_bclk_div;
87 	int audio_main_div;
88 	int num_i2c_devs;
89 	struct {
90 		int id;
91 		int addr;
92 	} i2c_devs[4];
93 	int num_inputs;
94 	struct {
95 		int video_input;
96 		int audio_input;
97 		char *name;
98 	} inputs[4];
99 };
100 
101 struct go7007_hpi_ops {
102 	int (*interface_reset)(struct go7007 *go);
103 	int (*write_interrupt)(struct go7007 *go, int addr, int data);
104 	int (*read_interrupt)(struct go7007 *go);
105 	int (*stream_start)(struct go7007 *go);
106 	int (*stream_stop)(struct go7007 *go);
107 	int (*send_firmware)(struct go7007 *go, u8 *data, int len);
108 	int (*send_command)(struct go7007 *go, unsigned int cmd, void *arg);
109 };
110 
111 /* The video buffer size must be a multiple of PAGE_SIZE */
112 #define	GO7007_BUF_PAGES	(128 * 1024 / PAGE_SIZE)
113 #define	GO7007_BUF_SIZE		(GO7007_BUF_PAGES << PAGE_SHIFT)
114 
115 struct go7007_buffer {
116 	struct go7007 *go; /* Reverse reference for VMA ops */
117 	int index; /* Reverse reference for DQBUF */
118 	enum { BUF_STATE_IDLE, BUF_STATE_QUEUED, BUF_STATE_DONE } state;
119 	u32 seq;
120 	struct timeval timestamp;
121 	struct list_head stream;
122 	struct page *pages[GO7007_BUF_PAGES + 1]; /* extra for straddling */
123 	unsigned long user_addr;
124 	unsigned int page_count;
125 	unsigned int offset;
126 	unsigned int bytesused;
127 	unsigned int frame_offset;
128 	u32 modet_active;
129 	int mapped;
130 };
131 
132 struct go7007_file {
133 	struct go7007 *go;
134 	struct semaphore lock;
135 	int buf_count;
136 	struct go7007_buffer *bufs;
137 };
138 
139 #define	GO7007_FORMAT_MJPEG	0
140 #define GO7007_FORMAT_MPEG4	1
141 #define GO7007_FORMAT_MPEG1	2
142 #define GO7007_FORMAT_MPEG2	3
143 #define GO7007_FORMAT_H263	4
144 
145 #define GO7007_RATIO_1_1	0
146 #define GO7007_RATIO_4_3	1
147 #define GO7007_RATIO_16_9	2
148 
149 enum go7007_parser_state {
150 	STATE_DATA,
151 	STATE_00,
152 	STATE_00_00,
153 	STATE_00_00_01,
154 	STATE_FF,
155 	STATE_VBI_LEN_A,
156 	STATE_VBI_LEN_B,
157 	STATE_MODET_MAP,
158 	STATE_UNPARSED,
159 };
160 
161 struct go7007 {
162 	struct device *dev;
163 	struct go7007_board_info *board_info;
164 	unsigned int board_id;
165 	int tuner_type;
166 	int channel_number; /* for multi-channel boards like Adlink PCI-MPG24 */
167 	char name[64];
168 	struct video_device *video_dev;
169 	int ref_count;
170 	enum { STATUS_INIT, STATUS_ONLINE, STATUS_SHUTDOWN } status;
171 	spinlock_t spinlock;
172 	struct semaphore hw_lock;
173 	int streaming;
174 	int in_use;
175 	int audio_enabled;
176 
177 	/* Video input */
178 	int input;
179 	enum { GO7007_STD_NTSC, GO7007_STD_PAL, GO7007_STD_OTHER } standard;
180 	int sensor_framerate;
181 	int width;
182 	int height;
183 	int encoder_h_offset;
184 	int encoder_v_offset;
185 	unsigned int encoder_h_halve:1;
186 	unsigned int encoder_v_halve:1;
187 	unsigned int encoder_subsample:1;
188 
189 	/* Encoder config */
190 	int format;
191 	int bitrate;
192 	int fps_scale;
193 	int pali;
194 	int aspect_ratio;
195 	int gop_size;
196 	unsigned int ipb:1;
197 	unsigned int closed_gop:1;
198 	unsigned int repeat_seqhead:1;
199 	unsigned int seq_header_enable:1;
200 	unsigned int gop_header_enable:1;
201 	unsigned int dvd_mode:1;
202 	unsigned int interlace_coding:1;
203 
204 	/* Motion detection */
205 	unsigned int modet_enable:1;
206 	struct {
207 		unsigned int enable:1;
208 		int pixel_threshold;
209 		int motion_threshold;
210 		int mb_threshold;
211 	} modet[4];
212 	unsigned char modet_map[1624];
213 	unsigned char active_map[216];
214 
215 	/* Video streaming */
216 	struct go7007_buffer *active_buf;
217 	enum go7007_parser_state state;
218 	int parse_length;
219 	u16 modet_word;
220 	int seen_frame;
221 	u32 next_seq;
222 	struct list_head stream;
223 	wait_queue_head_t frame_waitq;
224 
225 	/* Audio streaming */
226 	void (*audio_deliver)(struct go7007 *go, u8 *buf, int length);
227 	void *snd_context;
228 
229 	/* I2C */
230 	int i2c_adapter_online;
231 	struct i2c_adapter i2c_adapter;
232 
233 	/* HPI driver */
234 	struct go7007_hpi_ops *hpi_ops;
235 	void *hpi_context;
236 	int interrupt_available;
237 	wait_queue_head_t interrupt_waitq;
238 	unsigned short interrupt_value;
239 	unsigned short interrupt_data;
240 };
241 
242 /* All of these must be called with the hpi_lock semaphore held! */
243 #define go7007_interface_reset(go) \
244 			((go)->hpi_ops->interface_reset(go))
245 #define	go7007_write_interrupt(go, x, y) \
246 			((go)->hpi_ops->write_interrupt)((go), (x), (y))
247 #define go7007_stream_start(go) \
248 			((go)->hpi_ops->stream_start(go))
249 #define go7007_stream_stop(go) \
250 			((go)->hpi_ops->stream_stop(go))
251 #define	go7007_send_firmware(go, x, y) \
252 			((go)->hpi_ops->send_firmware)((go), (x), (y))
253 #define go7007_write_addr(go, x, y) \
254 			((go)->hpi_ops->write_interrupt)((go), (x)|0x8000, (y))
255 
256 /* go7007-driver.c */
257 int go7007_read_addr(struct go7007 *go, u16 addr, u16 *data);
258 int go7007_read_interrupt(struct go7007 *go, u16 *value, u16 *data);
259 int go7007_boot_encoder(struct go7007 *go, int init_i2c);
260 int go7007_reset_encoder(struct go7007 *go);
261 int go7007_register_encoder(struct go7007 *go);
262 int go7007_start_encoder(struct go7007 *go);
263 void go7007_parse_video_stream(struct go7007 *go, u8 *buf, int length);
264 struct go7007 *go7007_alloc(struct go7007_board_info *board,
265 					struct device *dev);
266 void go7007_remove(struct go7007 *go);
267 
268 /* go7007-fw.c */
269 int go7007_construct_fw_image(struct go7007 *go, u8 **fw, int *fwlen);
270 
271 /* go7007-i2c.c */
272 int go7007_i2c_init(struct go7007 *go);
273 int go7007_i2c_remove(struct go7007 *go);
274 
275 /* go7007-v4l2.c */
276 int go7007_v4l2_init(struct go7007 *go);
277 void go7007_v4l2_remove(struct go7007 *go);
278 
279 /* snd-go7007.c */
280 int go7007_snd_init(struct go7007 *go);
281 int go7007_snd_remove(struct go7007 *go);
282