linux/drivers/media/video/zoran.h
<<
>>
Prefs
   1/*
   2 * zoran - Iomega Buz driver
   3 *
   4 * Copyright (C) 1999 Rainer Johanni <Rainer@Johanni.de>
   5 *
   6 * based on
   7 *
   8 * zoran.0.0.3 Copyright (C) 1998 Dave Perks <dperks@ibm.net>
   9 *
  10 * and
  11 *
  12 * bttv - Bt848 frame grabber driver
  13 * Copyright (C) 1996,97,98 Ralph  Metzler (rjkm@thp.uni-koeln.de)
  14 *                        & Marcus Metzler (mocm@thp.uni-koeln.de)
  15 *
  16 * This program is free software; you can redistribute it and/or modify
  17 * it under the terms of the GNU General Public License as published by
  18 * the Free Software Foundation; either version 2 of the License, or
  19 * (at your option) any later version.
  20 *
  21 * This program is distributed in the hope that it will be useful,
  22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24 * GNU General Public License for more details.
  25 *
  26 * You should have received a copy of the GNU General Public License
  27 * along with this program; if not, write to the Free Software
  28 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  29 */
  30
  31#ifndef _BUZ_H_
  32#define _BUZ_H_
  33
  34struct zoran_requestbuffers {
  35        unsigned long count;    /* Number of buffers for MJPEG grabbing */
  36        unsigned long size;     /* Size PER BUFFER in bytes */
  37};
  38
  39struct zoran_sync {
  40        unsigned long frame;    /* number of buffer that has been free'd */
  41        unsigned long length;   /* number of code bytes in buffer (capture only) */
  42        unsigned long seq;      /* frame sequence number */
  43        struct timeval timestamp;       /* timestamp */
  44};
  45
  46struct zoran_status {
  47        int input;              /* Input channel, has to be set prior to BUZIOC_G_STATUS */
  48        int signal;             /* Returned: 1 if valid video signal detected */
  49        int norm;               /* Returned: VIDEO_MODE_PAL or VIDEO_MODE_NTSC */
  50        int color;              /* Returned: 1 if color signal detected */
  51};
  52
  53struct zoran_params {
  54
  55        /* The following parameters can only be queried */
  56
  57        int major_version;      /* Major version number of driver */
  58        int minor_version;      /* Minor version number of driver */
  59
  60        /* Main control parameters */
  61
  62        int input;              /* Input channel: 0 = Composite, 1 = S-VHS */
  63        int norm;               /* Norm: VIDEO_MODE_PAL or VIDEO_MODE_NTSC */
  64        int decimation;         /* decimation of captured video,
  65                                 * enlargement of video played back.
  66                                 * Valid values are 1, 2, 4 or 0.
  67                                 * 0 is a special value where the user
  68                                 * has full control over video scaling */
  69
  70        /* The following parameters only have to be set if decimation==0,
  71         * for other values of decimation they provide the data how the image is captured */
  72
  73        int HorDcm;             /* Horizontal decimation: 1, 2 or 4 */
  74        int VerDcm;             /* Vertical decimation: 1 or 2 */
  75        int TmpDcm;             /* Temporal decimation: 1 or 2,
  76                                 * if TmpDcm==2 in capture every second frame is dropped,
  77                                 * in playback every frame is played twice */
  78        int field_per_buff;     /* Number of fields per buffer: 1 or 2 */
  79        int img_x;              /* start of image in x direction */
  80        int img_y;              /* start of image in y direction */
  81        int img_width;          /* image width BEFORE decimation,
  82                                 * must be a multiple of HorDcm*16 */
  83        int img_height;         /* image height BEFORE decimation,
  84                                 * must be a multiple of VerDcm*8 */
  85
  86        /* --- End of parameters for decimation==0 only --- */
  87
  88        /* JPEG control parameters */
  89
  90        int quality;            /* Measure for quality of compressed images.
  91                                 * Scales linearly with the size of the compressed images.
  92                                 * Must be beetween 0 and 100, 100 is a compression
  93                                 * ratio of 1:4 */
  94
  95        int odd_even;           /* Which field should come first ??? */
  96
  97        int APPn;               /* Number of APP segment to be written, must be 0..15 */
  98        int APP_len;            /* Length of data in JPEG APPn segment */
  99        char APP_data[60];      /* Data in the JPEG APPn segment. */
 100
 101        int COM_len;            /* Length of data in JPEG COM segment */
 102        char COM_data[60];      /* Data in JPEG COM segment */
 103
 104        unsigned long jpeg_markers;     /* Which markers should go into the JPEG output.
 105                                         * Unless you exactly know what you do, leave them untouched.
 106                                         * Inluding less markers will make the resulting code
 107                                         * smaller, but there will be fewer aplications
 108                                         * which can read it.
 109                                         * The presence of the APP and COM marker is
 110                                         * influenced by APP0_len and COM_len ONLY! */
 111#define JPEG_MARKER_DHT (1<<3)  /* Define Huffman Tables */
 112#define JPEG_MARKER_DQT (1<<4)  /* Define Quantization Tables */
 113#define JPEG_MARKER_DRI (1<<5)  /* Define Restart Interval */
 114#define JPEG_MARKER_COM (1<<6)  /* Comment segment */
 115#define JPEG_MARKER_APP (1<<7)  /* App segment, driver will allways use APP0 */
 116
 117        int VFIFO_FB;           /* Flag for enabling Video Fifo Feedback.
 118                                 * If this flag is turned on and JPEG decompressing
 119                                 * is going to the screen, the decompress process
 120                                 * is stopped every time the Video Fifo is full.
 121                                 * This enables a smooth decompress to the screen
 122                                 * but the video output signal will get scrambled */
 123
 124        /* Misc */
 125
 126        char reserved[312];     /* Makes 512 bytes for this structure */
 127};
 128
 129/*
 130Private IOCTL to set up for displaying MJPEG
 131*/
 132#define BUZIOC_G_PARAMS       _IOR ('v', BASE_VIDIOCPRIVATE+0,  struct zoran_params)
 133#define BUZIOC_S_PARAMS       _IOWR('v', BASE_VIDIOCPRIVATE+1,  struct zoran_params)
 134#define BUZIOC_REQBUFS        _IOWR('v', BASE_VIDIOCPRIVATE+2,  struct zoran_requestbuffers)
 135#define BUZIOC_QBUF_CAPT      _IOW ('v', BASE_VIDIOCPRIVATE+3,  int)
 136#define BUZIOC_QBUF_PLAY      _IOW ('v', BASE_VIDIOCPRIVATE+4,  int)
 137#define BUZIOC_SYNC           _IOR ('v', BASE_VIDIOCPRIVATE+5,  struct zoran_sync)
 138#define BUZIOC_G_STATUS       _IOWR('v', BASE_VIDIOCPRIVATE+6,  struct zoran_status)
 139
 140
 141#ifdef __KERNEL__
 142
 143#define MAJOR_VERSION 0         /* driver major version */
 144#define MINOR_VERSION 9         /* driver minor version */
 145#define RELEASE_VERSION 5       /* release version */
 146
 147#define ZORAN_NAME    "ZORAN"   /* name of the device */
 148
 149#define ZR_DEVNAME(zr) ((zr)->name)
 150
 151#define   BUZ_MAX_WIDTH   (zr->timing->Wa)
 152#define   BUZ_MAX_HEIGHT  (zr->timing->Ha)
 153#define   BUZ_MIN_WIDTH    32   /* never display less than 32 pixels */
 154#define   BUZ_MIN_HEIGHT   24   /* never display less than 24 rows */
 155
 156#define BUZ_NUM_STAT_COM    4
 157#define BUZ_MASK_STAT_COM   3
 158
 159#define BUZ_MAX_FRAME     256   /* Must be a power of 2 */
 160#define BUZ_MASK_FRAME    255   /* Must be BUZ_MAX_FRAME-1 */
 161
 162#define BUZ_MAX_INPUT       16
 163
 164#if VIDEO_MAX_FRAME <= 32
 165#   define   V4L_MAX_FRAME   32
 166#elif VIDEO_MAX_FRAME <= 64
 167#   define   V4L_MAX_FRAME   64
 168#else
 169#   error   "Too many video frame buffers to handle"
 170#endif
 171#define   V4L_MASK_FRAME   (V4L_MAX_FRAME - 1)
 172
 173#define MAX_KMALLOC_MEM (128*1024)
 174
 175#include "zr36057.h"
 176
 177enum card_type {
 178        UNKNOWN = -1,
 179
 180        /* Pinnacle/Miro */
 181        DC10_old,               /* DC30 like */
 182        DC10_new,               /* DC10plus like */
 183        DC10plus,
 184        DC30,
 185        DC30plus,
 186
 187        /* Linux Media Labs */
 188        LML33,
 189        LML33R10,
 190
 191        /* Iomega */
 192        BUZ,
 193
 194        /* AverMedia */
 195        AVS6EYES,
 196
 197        /* total number of cards */
 198        NUM_CARDS
 199};
 200
 201enum zoran_codec_mode {
 202        BUZ_MODE_IDLE,          /* nothing going on */
 203        BUZ_MODE_MOTION_COMPRESS,       /* grabbing frames */
 204        BUZ_MODE_MOTION_DECOMPRESS,     /* playing frames */
 205        BUZ_MODE_STILL_COMPRESS,        /* still frame conversion */
 206        BUZ_MODE_STILL_DECOMPRESS       /* still frame conversion */
 207};
 208
 209enum zoran_buffer_state {
 210        BUZ_STATE_USER,         /* buffer is owned by application */
 211        BUZ_STATE_PEND,         /* buffer is queued in pend[] ready to feed to I/O */
 212        BUZ_STATE_DMA,          /* buffer is queued in dma[] for I/O */
 213        BUZ_STATE_DONE          /* buffer is ready to return to application */
 214};
 215
 216enum zoran_map_mode {
 217        ZORAN_MAP_MODE_RAW,
 218        ZORAN_MAP_MODE_JPG_REC,
 219#define ZORAN_MAP_MODE_JPG ZORAN_MAP_MODE_JPG_REC
 220        ZORAN_MAP_MODE_JPG_PLAY,
 221};
 222
 223enum gpio_type {
 224        GPIO_JPEG_SLEEP = 0,
 225        GPIO_JPEG_RESET,
 226        GPIO_JPEG_FRAME,
 227        GPIO_VID_DIR,
 228        GPIO_VID_EN,
 229        GPIO_VID_RESET,
 230        GPIO_CLK_SEL1,
 231        GPIO_CLK_SEL2,
 232        GPIO_MAX,
 233};
 234
 235enum gpcs_type {
 236        GPCS_JPEG_RESET = 0,
 237        GPCS_JPEG_START,
 238        GPCS_MAX,
 239};
 240
 241struct zoran_format {
 242        char *name;
 243#ifdef CONFIG_VIDEO_V4L1_COMPAT
 244        int palette;
 245#endif
 246#ifdef CONFIG_VIDEO_V4L2
 247        __u32 fourcc;
 248        int colorspace;
 249#endif
 250        int depth;
 251        __u32 flags;
 252        __u32 vfespfr;
 253};
 254/* flags */
 255#define ZORAN_FORMAT_COMPRESSED 1<<0
 256#define ZORAN_FORMAT_OVERLAY    1<<1
 257#define ZORAN_FORMAT_CAPTURE    1<<2
 258#define ZORAN_FORMAT_PLAYBACK   1<<3
 259
 260/* overlay-settings */
 261struct zoran_overlay_settings {
 262        int is_set;
 263        int x, y, width, height;        /* position */
 264        int clipcount;          /* position and number of clips */
 265        const struct zoran_format *format;      /* overlay format */
 266};
 267
 268/* v4l-capture settings */
 269struct zoran_v4l_settings {
 270        int width, height, bytesperline;        /* capture size */
 271        const struct zoran_format *format;      /* capture format */
 272};
 273
 274/* whoops, this one is undeclared if !v4l2 */
 275#ifndef CONFIG_VIDEO_V4L2
 276struct v4l2_jpegcompression {
 277        int quality;
 278        int APPn;
 279        int APP_len;
 280        char APP_data[60];
 281        int COM_len;
 282        char COM_data[60];
 283        __u32 jpeg_markers;
 284        __u8 reserved[116];
 285};
 286#endif
 287
 288/* jpg-capture/-playback settings */
 289struct zoran_jpg_settings {
 290        int decimation;         /* this bit is used to set everything to default */
 291        int HorDcm, VerDcm, TmpDcm;     /* capture decimation settings (TmpDcm=1 means both fields) */
 292        int field_per_buff, odd_even;   /* field-settings (odd_even=1 (+TmpDcm=1) means top-field-first) */
 293        int img_x, img_y, img_width, img_height;        /* crop settings (subframe capture) */
 294        struct v4l2_jpegcompression jpg_comp;   /* JPEG-specific capture settings */
 295};
 296
 297struct zoran_mapping {
 298        struct file *file;
 299        int count;
 300};
 301
 302struct zoran_jpg_buffer {
 303        struct zoran_mapping *map;
 304        u32 *frag_tab;          /* addresses of frag table */
 305        u32 frag_tab_bus;       /* same value cached to save time in ISR */
 306        enum zoran_buffer_state state;  /* non-zero if corresponding buffer is in use in grab queue */
 307        struct zoran_sync bs;   /* DONE: info to return to application */
 308};
 309
 310struct zoran_v4l_buffer {
 311        struct zoran_mapping *map;
 312        char *fbuffer;          /* virtual  address of frame buffer */
 313        unsigned long fbuffer_phys;     /* physical address of frame buffer */
 314        unsigned long fbuffer_bus;      /* bus      address of frame buffer */
 315        enum zoran_buffer_state state;  /* state: unused/pending/done */
 316        struct zoran_sync bs;   /* DONE: info to return to application */
 317};
 318
 319enum zoran_lock_activity {
 320        ZORAN_FREE,             /* free for use */
 321        ZORAN_ACTIVE,           /* active but unlocked */
 322        ZORAN_LOCKED,           /* locked */
 323};
 324
 325/* buffer collections */
 326struct zoran_jpg_struct {
 327        enum zoran_lock_activity active;        /* feature currently in use? */
 328        struct zoran_jpg_buffer buffer[BUZ_MAX_FRAME];  /* buffers */
 329        int num_buffers, buffer_size;
 330        u8 allocated;           /* Flag if buffers are allocated  */
 331        u8 ready_to_be_freed;   /* hack - see zoran_driver.c */
 332        u8 need_contiguous;     /* Flag if contiguous buffers are needed */
 333};
 334
 335struct zoran_v4l_struct {
 336        enum zoran_lock_activity active;        /* feature currently in use? */
 337        struct zoran_v4l_buffer buffer[VIDEO_MAX_FRAME];        /* buffers */
 338        int num_buffers, buffer_size;
 339        u8 allocated;           /* Flag if buffers are allocated  */
 340        u8 ready_to_be_freed;   /* hack - see zoran_driver.c */
 341};
 342
 343struct zoran;
 344
 345/* zoran_fh contains per-open() settings */
 346struct zoran_fh {
 347        struct zoran *zr;
 348
 349        enum zoran_map_mode map_mode;   /* Flag which bufferset will map by next mmap() */
 350
 351        struct zoran_overlay_settings overlay_settings;
 352        u32 *overlay_mask;      /* overlay mask */
 353        enum zoran_lock_activity overlay_active;        /* feature currently in use? */
 354
 355        struct zoran_v4l_settings v4l_settings; /* structure with a lot of things to play with */
 356        struct zoran_v4l_struct v4l_buffers;    /* V4L buffers' info */
 357
 358        struct zoran_jpg_settings jpg_settings; /* structure with a lot of things to play with */
 359        struct zoran_jpg_struct jpg_buffers;    /* MJPEG buffers' info */
 360};
 361
 362struct card_info {
 363        enum card_type type;
 364        char name[32];
 365        u16 i2c_decoder, i2c_encoder;                   /* I2C types */
 366        u16 video_vfe, video_codec;                     /* videocodec types */
 367        u16 audio_chip;                                 /* audio type */
 368        u16 vendor_id, device_id;       /* subsystem vendor/device ID */
 369
 370        int inputs;             /* number of video inputs */
 371        struct input {
 372                int muxsel;
 373                char name[32];
 374        } input[BUZ_MAX_INPUT];
 375
 376        int norms;
 377        struct tvnorm *tvn[3];  /* supported TV norms */
 378
 379        u32 jpeg_int;           /* JPEG interrupt */
 380        u32 vsync_int;          /* VSYNC interrupt */
 381        s8 gpio[GPIO_MAX];
 382        u8 gpcs[GPCS_MAX];
 383
 384        struct vfe_polarity vfe_pol;
 385        u8 gpio_pol[GPIO_MAX];
 386
 387        /* is the /GWS line conected? */
 388        u8 gws_not_connected;
 389
 390        /* avs6eyes mux setting */
 391        u8 input_mux;
 392
 393        void (*init) (struct zoran * zr);
 394};
 395
 396struct zoran {
 397        struct video_device *video_dev;
 398
 399        struct i2c_adapter i2c_adapter; /* */
 400        struct i2c_algo_bit_data i2c_algo;      /* */
 401        u32 i2cbr;
 402
 403        struct i2c_client *decoder;     /* video decoder i2c client */
 404        struct i2c_client *encoder;     /* video encoder i2c client */
 405
 406        struct videocodec *codec;       /* video codec */
 407        struct videocodec *vfe; /* video front end */
 408
 409        struct mutex resource_lock;     /* prevent evil stuff */
 410
 411        u8 initialized;         /* flag if zoran has been correctly initalized */
 412        int user;               /* number of current users */
 413        struct card_info card;
 414        struct tvnorm *timing;
 415
 416        unsigned short id;      /* number of this device */
 417        char name[32];          /* name of this device */
 418        struct pci_dev *pci_dev;        /* PCI device */
 419        unsigned char revision; /* revision of zr36057 */
 420        unsigned int zr36057_adr;       /* bus address of IO mem returned by PCI BIOS */
 421        unsigned char __iomem *zr36057_mem;/* pointer to mapped IO memory */
 422
 423        spinlock_t spinlock;    /* Spinlock */
 424
 425        /* Video for Linux parameters */
 426        int input, norm;        /* card's norm and input - norm=VIDEO_MODE_* */
 427        int hue, saturation, contrast, brightness;      /* Current picture params */
 428        struct video_buffer buffer;     /* Current buffer params */
 429        struct zoran_overlay_settings overlay_settings;
 430        u32 *overlay_mask;      /* overlay mask */
 431        enum zoran_lock_activity overlay_active;        /* feature currently in use? */
 432
 433        wait_queue_head_t v4l_capq;
 434
 435        int v4l_overlay_active; /* Overlay grab is activated */
 436        int v4l_memgrab_active; /* Memory grab is activated */
 437
 438        int v4l_grab_frame;     /* Frame number being currently grabbed */
 439#define NO_GRAB_ACTIVE (-1)
 440        unsigned long v4l_grab_seq;     /* Number of frames grabbed */
 441        struct zoran_v4l_settings v4l_settings; /* structure with a lot of things to play with */
 442
 443        /* V4L grab queue of frames pending */
 444        unsigned long v4l_pend_head;
 445        unsigned long v4l_pend_tail;
 446        unsigned long v4l_sync_tail;
 447        int v4l_pend[V4L_MAX_FRAME];
 448        struct zoran_v4l_struct v4l_buffers;    /* V4L buffers' info */
 449
 450        /* Buz MJPEG parameters */
 451        enum zoran_codec_mode codec_mode;       /* status of codec */
 452        struct zoran_jpg_settings jpg_settings; /* structure with a lot of things to play with */
 453
 454        wait_queue_head_t jpg_capq;     /* wait here for grab to finish */
 455
 456        /* grab queue counts/indices, mask with BUZ_MASK_STAT_COM before using as index */
 457        /* (dma_head - dma_tail) is number active in DMA, must be <= BUZ_NUM_STAT_COM */
 458        /* (value & BUZ_MASK_STAT_COM) corresponds to index in stat_com table */
 459        unsigned long jpg_que_head;     /* Index where to put next buffer which is queued */
 460        unsigned long jpg_dma_head;     /* Index of next buffer which goes into stat_com  */
 461        unsigned long jpg_dma_tail;     /* Index of last buffer in stat_com               */
 462        unsigned long jpg_que_tail;     /* Index of last buffer in queue                  */
 463        unsigned long jpg_seq_num;      /* count of frames since grab/play started        */
 464        unsigned long jpg_err_seq;      /* last seq_num before error                      */
 465        unsigned long jpg_err_shift;
 466        unsigned long jpg_queued_num;   /* count of frames queued since grab/play started */
 467
 468        /* zr36057's code buffer table */
 469        u32 *stat_com;          /* stat_com[i] is indexed by dma_head/tail & BUZ_MASK_STAT_COM */
 470
 471        /* (value & BUZ_MASK_FRAME) corresponds to index in pend[] queue */
 472        int jpg_pend[BUZ_MAX_FRAME];
 473
 474        /* array indexed by frame number */
 475        struct zoran_jpg_struct jpg_buffers;    /* MJPEG buffers' info */
 476
 477        /* Additional stuff for testing */
 478#ifdef CONFIG_PROC_FS
 479        struct proc_dir_entry *zoran_proc;
 480#else
 481        void *zoran_proc;
 482#endif
 483        int testing;
 484        int jpeg_error;
 485        int intr_counter_GIRQ1;
 486        int intr_counter_GIRQ0;
 487        int intr_counter_CodRepIRQ;
 488        int intr_counter_JPEGRepIRQ;
 489        int field_counter;
 490        int IRQ1_in;
 491        int IRQ1_out;
 492        int JPEG_in;
 493        int JPEG_out;
 494        int JPEG_0;
 495        int JPEG_1;
 496        int END_event_missed;
 497        int JPEG_missed;
 498        int JPEG_error;
 499        int num_errors;
 500        int JPEG_max_missed;
 501        int JPEG_min_missed;
 502
 503        u32 last_isr;
 504        unsigned long frame_num;
 505
 506        wait_queue_head_t test_q;
 507};
 508
 509/*The following should be done in more portable way. It depends on define
 510  of _ALPHA_BUZ in the Makefile.*/
 511
 512#ifdef _ALPHA_BUZ
 513#define btwrite(dat,adr)    writel((dat), zr->zr36057_adr+(adr))
 514#define btread(adr)         readl(zr->zr36057_adr+(adr))
 515#else
 516#define btwrite(dat,adr)    writel((dat), zr->zr36057_mem+(adr))
 517#define btread(adr)         readl(zr->zr36057_mem+(adr))
 518#endif
 519
 520#define btand(dat,adr)      btwrite((dat) & btread(adr), adr)
 521#define btor(dat,adr)       btwrite((dat) | btread(adr), adr)
 522#define btaor(dat,mask,adr) btwrite((dat) | ((mask) & btread(adr)), adr)
 523
 524#endif                          /* __kernel__ */
 525
 526#endif
 527