2 * Copyright (C) 2005-2006 Micronas USA Inc.
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.
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.
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.
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.
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
44 /* Various characteristics of each board */
45 #define GO7007_BOARD_HAS_AUDIO (1<<0)
46 #define GO7007_BOARD_USE_ONBOARD_I2C (1<<1)
47 #define GO7007_BOARD_HAS_TUNER (1<<2)
49 /* Characteristics of sensor devices */
50 #define GO7007_SENSOR_VALID_POLAR (1<<0)
51 #define GO7007_SENSOR_HREF_POLAR (1<<1)
52 #define GO7007_SENSOR_VREF_POLAR (1<<2)
53 #define GO7007_SENSOR_FIELD_ID_POLAR (1<<3)
54 #define GO7007_SENSOR_BIT_WIDTH (1<<4)
55 #define GO7007_SENSOR_VALID_ENABLE (1<<5)
56 #define GO7007_SENSOR_656 (1<<6)
57 #define GO7007_SENSOR_CONFIG_MASK 0x7f
58 #define GO7007_SENSOR_TV (1<<7)
59 #define GO7007_SENSOR_VBI (1<<8)
60 #define GO7007_SENSOR_SCALING (1<<9)
62 /* Characteristics of audio sensor devices */
63 #define GO7007_AUDIO_I2S_MODE_1 (1)
64 #define GO7007_AUDIO_I2S_MODE_2 (2)
65 #define GO7007_AUDIO_I2S_MODE_3 (3)
66 #define GO7007_AUDIO_BCLK_POLAR (1<<2)
67 #define GO7007_AUDIO_WORD_14 (14<<4)
68 #define GO7007_AUDIO_WORD_16 (16<<4)
69 #define GO7007_AUDIO_ONE_CHANNEL (1<<11)
70 #define GO7007_AUDIO_I2S_MASTER (1<<16)
71 #define GO7007_AUDIO_OKI_MODE (1<<17)
73 struct go7007_board_info {
77 unsigned int sensor_flags;
83 unsigned int audio_flags;
100 struct go7007_hpi_ops {
101 int (*interface_reset)(struct go7007 *go);
102 int (*write_interrupt)(struct go7007 *go, int addr, int data);
103 int (*read_interrupt)(struct go7007 *go);
104 int (*stream_start)(struct go7007 *go);
105 int (*stream_stop)(struct go7007 *go);
106 int (*send_firmware)(struct go7007 *go, u8 *data, int len);
107 int (*send_command)(struct go7007 *go, unsigned int cmd, void *arg);
110 /* The video buffer size must be a multiple of PAGE_SIZE */
111 #define GO7007_BUF_PAGES (128 * 1024 / PAGE_SIZE)
112 #define GO7007_BUF_SIZE (GO7007_BUF_PAGES << PAGE_SHIFT)
114 struct go7007_buffer {
115 struct go7007 *go; /* Reverse reference for VMA ops */
116 int index; /* Reverse reference for DQBUF */
117 enum { BUF_STATE_IDLE, BUF_STATE_QUEUED, BUF_STATE_DONE } state;
119 struct timeval timestamp;
120 struct list_head stream;
121 struct page *pages[GO7007_BUF_PAGES + 1]; /* extra for straddling */
122 unsigned long user_addr;
123 unsigned int page_count;
125 unsigned int bytesused;
126 unsigned int frame_offset;
133 struct semaphore lock;
135 struct go7007_buffer *bufs;
138 #define GO7007_FORMAT_MJPEG 0
139 #define GO7007_FORMAT_MPEG4 1
140 #define GO7007_FORMAT_MPEG1 2
141 #define GO7007_FORMAT_MPEG2 3
142 #define GO7007_FORMAT_H263 4
144 #define GO7007_RATIO_1_1 0
145 #define GO7007_RATIO_4_3 1
146 #define GO7007_RATIO_16_9 2
148 enum go7007_parser_state {
162 struct go7007_board_info *board_info;
163 unsigned int board_id;
165 int channel_number; /* for multi-channel boards like Adlink PCI-MPG24 */
167 struct video_device *video_dev;
169 enum { STATUS_INIT, STATUS_ONLINE, STATUS_SHUTDOWN } status;
171 struct semaphore hw_lock;
178 enum { GO7007_STD_NTSC, GO7007_STD_PAL, GO7007_STD_OTHER } standard;
179 int sensor_framerate;
182 int encoder_h_offset;
183 int encoder_v_offset;
184 unsigned int encoder_h_halve:1;
185 unsigned int encoder_v_halve:1;
186 unsigned int encoder_subsample:1;
196 unsigned int closed_gop:1;
197 unsigned int repeat_seqhead:1;
198 unsigned int seq_header_enable:1;
199 unsigned int gop_header_enable:1;
200 unsigned int dvd_mode:1;
201 unsigned int interlace_coding:1;
203 /* Motion detection */
204 unsigned int modet_enable:1;
206 unsigned int enable:1;
208 int motion_threshold;
211 unsigned char modet_map[1624];
212 unsigned char active_map[216];
214 /* Video streaming */
215 struct go7007_buffer *active_buf;
216 enum go7007_parser_state state;
221 struct list_head stream;
222 wait_queue_head_t frame_waitq;
224 /* Audio streaming */
225 void (*audio_deliver)(struct go7007 *go, u8 *buf, int length);
229 int i2c_adapter_online;
230 struct i2c_adapter i2c_adapter;
233 struct go7007_hpi_ops *hpi_ops;
235 int interrupt_available;
236 wait_queue_head_t interrupt_waitq;
237 unsigned short interrupt_value;
238 unsigned short interrupt_data;
241 /* All of these must be called with the hpi_lock semaphore held! */
242 #define go7007_interface_reset(go) \
243 ((go)->hpi_ops->interface_reset(go))
244 #define go7007_write_interrupt(go, x, y) \
245 ((go)->hpi_ops->write_interrupt)((go), (x), (y))
246 #define go7007_stream_start(go) \
247 ((go)->hpi_ops->stream_start(go))
248 #define go7007_stream_stop(go) \
249 ((go)->hpi_ops->stream_stop(go))
250 #define go7007_send_firmware(go, x, y) \
251 ((go)->hpi_ops->send_firmware)((go), (x), (y))
252 #define go7007_write_addr(go, x, y) \
253 ((go)->hpi_ops->write_interrupt)((go), (x)|0x8000, (y))
255 /* go7007-driver.c */
256 int go7007_read_addr(struct go7007 *go, u16 addr, u16 *data);
257 int go7007_read_interrupt(struct go7007 *go, u16 *value, u16 *data);
258 int go7007_boot_encoder(struct go7007 *go, int init_i2c);
259 int go7007_reset_encoder(struct go7007 *go);
260 int go7007_register_encoder(struct go7007 *go);
261 int go7007_start_encoder(struct go7007 *go);
262 void go7007_parse_video_stream(struct go7007 *go, u8 *buf, int length);
263 struct go7007 *go7007_alloc(struct go7007_board_info *board,
265 void go7007_remove(struct go7007 *go);
268 int go7007_construct_fw_image(struct go7007 *go, u8 **fw, int *fwlen);
271 int go7007_i2c_init(struct go7007 *go);
272 int go7007_i2c_remove(struct go7007 *go);
275 int go7007_v4l2_init(struct go7007 *go);
276 void go7007_v4l2_remove(struct go7007 *go);
279 int go7007_snd_init(struct go7007 *go);
280 int go7007_snd_remove(struct go7007 *go);