This source file includes following definitions.
- to_usbvision
 
   1 
   2 
   3 
   4 
   5 
   6 
   7 
   8 
   9 
  10 
  11 
  12 
  13 
  14 
  15 
  16 
  17 #ifndef __LINUX_USBVISION_H
  18 #define __LINUX_USBVISION_H
  19 
  20 #include <linux/list.h>
  21 #include <linux/usb.h>
  22 #include <linux/i2c.h>
  23 #include <linux/mutex.h>
  24 #include <media/v4l2-device.h>
  25 #include <media/v4l2-ctrls.h>
  26 #include <media/tuner.h>
  27 #include <linux/videodev2.h>
  28 
  29 #define USBVISION_DEBUG         
  30 
  31 #define USBVISION_PWR_REG               0x00
  32         #define USBVISION_SSPND_EN              (1 << 1)
  33         #define USBVISION_RES2                  (1 << 2)
  34         #define USBVISION_PWR_VID               (1 << 5)
  35         #define USBVISION_E2_EN                 (1 << 7)
  36 #define USBVISION_CONFIG_REG            0x01
  37 #define USBVISION_ADRS_REG              0x02
  38 #define USBVISION_ALTER_REG             0x03
  39 #define USBVISION_FORCE_ALTER_REG       0x04
  40 #define USBVISION_STATUS_REG            0x05
  41 #define USBVISION_IOPIN_REG             0x06
  42         #define USBVISION_IO_1                  (1 << 0)
  43         #define USBVISION_IO_2                  (1 << 1)
  44         #define USBVISION_AUDIO_IN              0
  45         #define USBVISION_AUDIO_TV              1
  46         #define USBVISION_AUDIO_RADIO           2
  47         #define USBVISION_AUDIO_MUTE            3
  48 #define USBVISION_SER_MODE              0x07
  49         #define USBVISION_CLK_OUT               (1 << 0)
  50         #define USBVISION_DAT_IO                (1 << 1)
  51         #define USBVISION_SENS_OUT              (1 << 2)
  52         #define USBVISION_SER_MODE_SOFT         (0 << 4)
  53         #define USBVISION_SER_MODE_SIO          (1 << 4)
  54 #define USBVISION_SER_ADRS              0x08
  55 #define USBVISION_SER_CONT              0x09
  56 #define USBVISION_SER_DAT1              0x0A
  57 #define USBVISION_SER_DAT2              0x0B
  58 #define USBVISION_SER_DAT3              0x0C
  59 #define USBVISION_SER_DAT4              0x0D
  60 #define USBVISION_EE_DATA               0x0E
  61 #define USBVISION_EE_LSBAD              0x0F
  62 #define USBVISION_EE_CONT               0x10
  63 #define USBVISION_DRM_CONT                      0x12
  64         #define USBVISION_REF                   (1 << 0)
  65         #define USBVISION_RES_UR                (1 << 2)
  66         #define USBVISION_RES_FDL               (1 << 3)
  67         #define USBVISION_RES_VDW               (1 << 4)
  68 #define USBVISION_DRM_PRM1              0x13
  69 #define USBVISION_DRM_PRM2              0x14
  70 #define USBVISION_DRM_PRM3              0x15
  71 #define USBVISION_DRM_PRM4              0x16
  72 #define USBVISION_DRM_PRM5              0x17
  73 #define USBVISION_DRM_PRM6              0x18
  74 #define USBVISION_DRM_PRM7              0x19
  75 #define USBVISION_DRM_PRM8              0x1A
  76 #define USBVISION_VIN_REG1              0x1B
  77         #define USBVISION_8_422_SYNC            0x01
  78         #define USBVISION_16_422_SYNC           0x02
  79         #define USBVISION_VSNC_POL              (1 << 3)
  80         #define USBVISION_HSNC_POL              (1 << 4)
  81         #define USBVISION_FID_POL               (1 << 5)
  82         #define USBVISION_HVALID_PO             (1 << 6)
  83         #define USBVISION_VCLK_POL              (1 << 7)
  84 #define USBVISION_VIN_REG2              0x1C
  85         #define USBVISION_AUTO_FID              (1 << 0)
  86         #define USBVISION_NONE_INTER            (1 << 1)
  87         #define USBVISION_NOHVALID              (1 << 2)
  88         #define USBVISION_UV_ID                 (1 << 3)
  89         #define USBVISION_FIX_2C                (1 << 4)
  90         #define USBVISION_SEND_FID              (1 << 5)
  91         #define USBVISION_KEEP_BLANK            (1 << 7)
  92 #define USBVISION_LXSIZE_I              0x1D
  93 #define USBVISION_MXSIZE_I              0x1E
  94 #define USBVISION_LYSIZE_I              0x1F
  95 #define USBVISION_MYSIZE_I              0x20
  96 #define USBVISION_LX_OFFST              0x21
  97 #define USBVISION_MX_OFFST              0x22
  98 #define USBVISION_LY_OFFST              0x23
  99 #define USBVISION_MY_OFFST              0x24
 100 #define USBVISION_FRM_RATE              0x25
 101 #define USBVISION_LXSIZE_O              0x26
 102 #define USBVISION_MXSIZE_O              0x27
 103 #define USBVISION_LYSIZE_O              0x28
 104 #define USBVISION_MYSIZE_O              0x29
 105 #define USBVISION_FILT_CONT             0x2A
 106 #define USBVISION_VO_MODE               0x2B
 107 #define USBVISION_INTRA_CYC             0x2C
 108 #define USBVISION_STRIP_SZ              0x2D
 109 #define USBVISION_FORCE_INTRA           0x2E
 110 #define USBVISION_FORCE_UP              0x2F
 111 #define USBVISION_BUF_THR               0x30
 112 #define USBVISION_DVI_YUV               0x31
 113 #define USBVISION_AUDIO_CONT            0x32
 114 #define USBVISION_AUD_PK_LEN            0x33
 115 #define USBVISION_BLK_PK_LEN            0x34
 116 #define USBVISION_PCM_THR1              0x38
 117 #define USBVISION_PCM_THR2              0x39
 118 #define USBVISION_DIST_THR_L            0x3A
 119 #define USBVISION_DIST_THR_H            0x3B
 120 #define USBVISION_MAX_DIST_L            0x3C
 121 #define USBVISION_MAX_DIST_H            0x3D
 122 #define USBVISION_OP_CODE               0x33
 123 
 124 #define MAX_BYTES_PER_PIXEL             4
 125 
 126 #define MIN_FRAME_WIDTH                 64
 127 #define MAX_USB_WIDTH                   320  
 128 #define MAX_FRAME_WIDTH                 320                    
 129 
 130 #define MIN_FRAME_HEIGHT                48
 131 #define MAX_USB_HEIGHT                  240  
 132 #define MAX_FRAME_HEIGHT                240                    
 133 
 134 #define MAX_FRAME_SIZE                  (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT * MAX_BYTES_PER_PIXEL)
 135 #define USBVISION_CLIPMASK_SIZE         (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT / 8) 
 136 
 137 #define USBVISION_URB_FRAMES            32
 138 
 139 #define USBVISION_NUM_HEADERMARKER      20
 140 #define USBVISION_NUMFRAMES             3  
 141 #define USBVISION_NUMSBUF               2 
 142 
 143 #define USBVISION_POWEROFF_TIME         (3 * HZ)                
 144 
 145 
 146 #define FRAMERATE_MIN   0
 147 #define FRAMERATE_MAX   31
 148 
 149 enum {
 150         ISOC_MODE_YUV422 = 0x03,
 151         ISOC_MODE_YUV420 = 0x14,
 152         ISOC_MODE_COMPRESS = 0x60,
 153 };
 154 
 155 
 156 #define RESTRICT_TO_RANGE(v, mi, ma) \
 157         { if (((int)v) < (mi)) (v) = (mi); else if ((v) > (ma)) (v) = (ma); }
 158 
 159 
 160 
 161 
 162 
 163 
 164 
 165 
 166 
 167 
 168 
 169 
 170 
 171 
 172 
 173 
 174 
 175 
 176 
 177 
 178 #define LIMIT_RGB(x) (((x) < 0) ? 0 : (((x) > 255) ? 255 : (x)))
 179 #define YUV_TO_RGB_BY_THE_BOOK(my, mu, mv, mr, mg, mb) { \
 180         int mm_y, mm_yc, mm_u, mm_v, mm_r, mm_g, mm_b; \
 181         mm_y = (my) - 16; \
 182         mm_u = (mu) - 128; \
 183         mm_v = (mv) - 128; \
 184         mm_yc = mm_y * 76284; \
 185         mm_b = (mm_yc + 132252 * mm_v) >> 16; \
 186         mm_g = (mm_yc - 53281 * mm_u - 25625 * mm_v) >> 16; \
 187         mm_r = (mm_yc + 104595 * mm_u) >> 16; \
 188         mb = LIMIT_RGB(mm_b); \
 189         mg = LIMIT_RGB(mm_g); \
 190         mr = LIMIT_RGB(mm_r); \
 191 }
 192 
 193 
 194 
 195 
 196 
 197 
 198 #define USBVISION_IS_OPERATIONAL(udevice) (\
 199         (udevice != NULL) && \
 200         ((udevice)->dev != NULL) && \
 201         ((udevice)->last_error == 0) && \
 202         (!(udevice)->remove_pending))
 203 
 204 #define I2C_USB_ADAP_MAX        16
 205 
 206 #define USBVISION_NORMS (V4L2_STD_PAL | V4L2_STD_NTSC | V4L2_STD_SECAM | V4L2_STD_PAL_M)
 207 
 208 
 209 
 210 
 211 enum scan_state {
 212         scan_state_scanning,    
 213         scan_state_lines        
 214 };
 215 
 216 
 217 enum parse_state {
 218         parse_state_continue,   
 219         parse_state_next_frame, 
 220         parse_state_out,        
 221         parse_state_end_parse   
 222 };
 223 
 224 enum frame_state {
 225         frame_state_unused,     
 226         frame_state_ready,      
 227         frame_state_grabbing,   
 228         frame_state_done,       
 229         frame_state_done_hold,  
 230         frame_state_error,      
 231 };
 232 
 233 
 234 enum stream_state {
 235         stream_off,             
 236         stream_idle,            
 237         stream_interrupt,       
 238         stream_on,              
 239 };
 240 
 241 enum isoc_state {
 242         isoc_state_in_frame,    
 243         isoc_state_no_frame,    
 244 };
 245 
 246 struct usb_device;
 247 
 248 struct usbvision_sbuf {
 249         char *data;
 250         struct urb *urb;
 251 };
 252 
 253 #define USBVISION_MAGIC_1                       0x55
 254 #define USBVISION_MAGIC_2                       0xAA
 255 #define USBVISION_HEADER_LENGTH                 0x0c
 256 #define USBVISION_SAA7111_ADDR                  0x48
 257 #define USBVISION_SAA7113_ADDR                  0x4a
 258 #define USBVISION_IIC_LRACK                     0x20
 259 #define USBVISION_IIC_LRNACK                    0x30
 260 #define USBVISION_FRAME_FORMAT_PARAM_INTRA      (1<<7)
 261 
 262 struct usbvision_v4l2_format_st {
 263         int             supported;
 264         int             bytes_per_pixel;
 265         int             depth;
 266         int             format;
 267 };
 268 #define USBVISION_SUPPORTED_PALETTES ARRAY_SIZE(usbvision_v4l2_format)
 269 
 270 struct usbvision_frame_header {
 271         unsigned char magic_1;                          
 272         unsigned char magic_2;                          
 273         unsigned char header_length;                    
 274         unsigned char frame_num;                        
 275         unsigned char frame_phase;                      
 276         unsigned char frame_latency;                    
 277         unsigned char data_format;                      
 278         unsigned char format_param;                     
 279         unsigned char frame_width_lo;                   
 280         unsigned char frame_width_hi;                   
 281         unsigned char frame_height_lo;                  
 282         unsigned char frame_height_hi;                  
 283         __u16 frame_width;                              
 284         __u16 frame_height;                             
 285 };
 286 
 287 struct usbvision_frame {
 288         char *data;                                     
 289         struct usbvision_frame_header isoc_header;      
 290 
 291         int width;                                      
 292         int height;                                     
 293         int index;                                      
 294         int frmwidth;                                   
 295         int frmheight;                                  
 296 
 297         volatile int grabstate;                         
 298         int scanstate;                                  
 299 
 300         struct list_head frame;
 301 
 302         int curline;                                    
 303 
 304         long scanlength;                                
 305         long bytes_read;                                
 306         struct usbvision_v4l2_format_st v4l2_format;    
 307         int v4l2_linesize;                              
 308         u64 ts;
 309         int sequence;                                   
 310 };
 311 
 312 #define CODEC_SAA7113   7113
 313 #define CODEC_SAA7111   7111
 314 #define CODEC_WEBCAM    3000
 315 #define BRIDGE_NT1003   1003
 316 #define BRIDGE_NT1004   1004
 317 #define BRIDGE_NT1005   1005
 318 
 319 struct usbvision_device_data_st {
 320         __u64 video_norm;
 321         const char *model_string;
 322         int interface; 
 323         __u16 codec;
 324         unsigned video_channels:3;
 325         unsigned audio_channels:2;
 326         unsigned radio:1;
 327         unsigned vbi:1;
 328         unsigned tuner:1;
 329         unsigned vin_reg1_override:1;   
 330         unsigned vin_reg2_override:1;   
 331         unsigned dvi_yuv_override:1;
 332         __u8 vin_reg1;
 333         __u8 vin_reg2;
 334         __u8 dvi_yuv;
 335         __u8 tuner_type;
 336         __s16 x_offset;
 337         __s16 y_offset;
 338 };
 339 
 340 
 341 extern struct usbvision_device_data_st usbvision_device_data[];
 342 extern struct usb_device_id usbvision_table[];
 343 
 344 struct usb_usbvision {
 345         struct v4l2_device v4l2_dev;
 346         struct v4l2_ctrl_handler hdl;
 347         struct video_device vdev;                                       
 348         struct video_device rdev;                                       
 349 
 350         
 351         struct i2c_adapter i2c_adap;
 352         int registered_i2c;
 353 
 354         struct urb *ctrl_urb;
 355         unsigned char ctrl_urb_buffer[8];
 356         int ctrl_urb_busy;
 357         struct usb_ctrlrequest ctrl_urb_setup;
 358 
 359         
 360         int have_tuner;
 361         int tuner_type;
 362         int bridge_type;                                                
 363         int radio;
 364         int video_inputs;                                               
 365         unsigned long radio_freq;
 366         unsigned long tv_freq;
 367         int audio_mute;
 368         int audio_channel;
 369         int isoc_mode;                                                  
 370         unsigned int nr;                                                
 371 
 372         
 373         struct usb_device *dev;
 374         
 375         int num_alt;            
 376         unsigned int *alt_max_pkt_size; 
 377         unsigned char iface;                                            
 378         unsigned char iface_alt;                                        
 379         unsigned char vin_reg2_preset;
 380         struct mutex v4l2_lock;
 381         int power;                                                      
 382         int user;                                                       
 383         int initialized;                                                
 384         int dev_model;                                                  
 385         enum stream_state streaming;                                    
 386         int last_error;                                                 
 387         int curwidth;                                                   
 388         int curheight;                                                  
 389         int stretch_width;                                              
 390         int stretch_height;                                             
 391         char *fbuf;                                                     
 392         int max_frame_size;                                             
 393         int fbuf_size;                                                  
 394         spinlock_t queue_lock;                                          
 395         struct list_head inqueue, outqueue;                             
 396         wait_queue_head_t wait_frame;                                   
 397         wait_queue_head_t wait_stream;                                  
 398         struct usbvision_frame *cur_frame;                              
 399         struct usbvision_frame frame[USBVISION_NUMFRAMES];              
 400         int num_frames;                                                 
 401         struct usbvision_sbuf sbuf[USBVISION_NUMSBUF];                  
 402         volatile int remove_pending;                                    
 403 
 404         
 405         unsigned char *scratch;
 406         int scratch_read_ptr;
 407         int scratch_write_ptr;
 408         int scratch_headermarker[USBVISION_NUM_HEADERMARKER];
 409         int scratch_headermarker_read_ptr;
 410         int scratch_headermarker_write_ptr;
 411         enum isoc_state isocstate;
 412         struct usbvision_v4l2_format_st palette;
 413 
 414         struct v4l2_capability vcap;                                    
 415         unsigned int ctl_input;                                         
 416         v4l2_std_id tvnorm_id;                                          
 417         unsigned char video_endp;                                       
 418 
 419         
 420         unsigned char *intra_frame_buffer;                              
 421         int block_pos;                                                  
 422         int request_intra;                                              
 423         int last_isoc_frame_num;                                        
 424         int isoc_packet_size;                                           
 425         int used_bandwidth;                                             
 426         int compr_level;                                                
 427         int last_compr_level;                                           
 428         int usb_bandwidth;                                              
 429 
 430         
 431         unsigned long isoc_urb_count;                   
 432         unsigned long urb_length;                       
 433         unsigned long isoc_data_count;                  
 434         unsigned long header_count;                     
 435         unsigned long scratch_ovf_count;                
 436         unsigned long isoc_skip_count;                  
 437         unsigned long isoc_err_count;                   
 438         unsigned long isoc_packet_count;                
 439         int isoc_measure_bandwidth_count;
 440         int frame_num;                                  
 441         int max_strip_len;                              
 442         int comprblock_pos;
 443         int strip_len_errors;                           
 444         int strip_magic_errors;
 445         int strip_line_number_errors;
 446         int compr_block_types[4];
 447 };
 448 
 449 static inline struct usb_usbvision *to_usbvision(struct v4l2_device *v4l2_dev)
 450 {
 451         return container_of(v4l2_dev, struct usb_usbvision, v4l2_dev);
 452 }
 453 
 454 #define call_all(usbvision, o, f, args...) \
 455         v4l2_device_call_all(&usbvision->v4l2_dev, 0, o, f, ##args)
 456 
 457 
 458 
 459 
 460 
 461 
 462 
 463 
 464 
 465 int usbvision_i2c_register(struct usb_usbvision *usbvision);
 466 int usbvision_i2c_unregister(struct usb_usbvision *usbvision);
 467 
 468 
 469 int usbvision_read_reg(struct usb_usbvision *usbvision, unsigned char reg);
 470 int usbvision_write_reg(struct usb_usbvision *usbvision, unsigned char reg,
 471                         unsigned char value);
 472 
 473 int usbvision_frames_alloc(struct usb_usbvision *usbvision, int number_of_frames);
 474 void usbvision_frames_free(struct usb_usbvision *usbvision);
 475 int usbvision_scratch_alloc(struct usb_usbvision *usbvision);
 476 void usbvision_scratch_free(struct usb_usbvision *usbvision);
 477 int usbvision_decompress_alloc(struct usb_usbvision *usbvision);
 478 void usbvision_decompress_free(struct usb_usbvision *usbvision);
 479 
 480 int usbvision_setup(struct usb_usbvision *usbvision, int format);
 481 int usbvision_init_isoc(struct usb_usbvision *usbvision);
 482 int usbvision_restart_isoc(struct usb_usbvision *usbvision);
 483 void usbvision_stop_isoc(struct usb_usbvision *usbvision);
 484 int usbvision_set_alternate(struct usb_usbvision *dev);
 485 
 486 int usbvision_set_audio(struct usb_usbvision *usbvision, int audio_channel);
 487 int usbvision_audio_off(struct usb_usbvision *usbvision);
 488 
 489 int usbvision_begin_streaming(struct usb_usbvision *usbvision);
 490 void usbvision_empty_framequeues(struct usb_usbvision *dev);
 491 int usbvision_stream_interrupt(struct usb_usbvision *dev);
 492 
 493 int usbvision_muxsel(struct usb_usbvision *usbvision, int channel);
 494 int usbvision_set_input(struct usb_usbvision *usbvision);
 495 int usbvision_set_output(struct usb_usbvision *usbvision, int width, int height);
 496 
 497 int usbvision_power_off(struct usb_usbvision *usbvision);
 498 int usbvision_power_on(struct usb_usbvision *usbvision);
 499 
 500 #endif