drivers/staging/go7007/go7007-priv.h

   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);