LXR linux/drivers/media/video/cx88/cx88.h

   1/*
   2 *
   3 * v4l2 device driver for cx2388x based TV cards
   4 *
   5 * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
   6 *
   7 *  This program is free software; you can redistribute it and/or modify
   8 *  it under the terms of the GNU General Public License as published by
   9 *  the Free Software Foundation; either version 2 of the License, or
  10 *  (at your option) any later version.
  11 *
  12 *  This program is distributed in the hope that it will be useful,
  13 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 *  GNU General Public License for more details.
  16 *
  17 *  You should have received a copy of the GNU General Public License
  18 *  along with this program; if not, write to the Free Software
  19 *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 */
  21
  22#include <linux/pci.h>
  23#include <linux/i2c.h>
  24#include <linux/i2c-algo-bit.h>
  25#include <linux/videodev2.h>
  26#include <linux/kdev_t.h>
  27
  28#include <media/v4l2-common.h>
  29#include <media/tuner.h>
  30#include <media/tveeprom.h>
  31#include <media/video-buf.h>
  32#include <media/cx2341x.h>
  33#include <media/video-buf-dvb.h>
  34
  35#include "btcx-risc.h"
  36#include "cx88-reg.h"
  37
  38#include <linux/version.h>
  39#include <linux/mutex.h>
  40#define CX88_VERSION_CODE KERNEL_VERSION(0,0,6)
  41
  42#ifndef TRUE
  43# define TRUE (1==1)
  44#endif
  45#ifndef FALSE
  46# define FALSE (1==0)
  47#endif
  48#define UNSET (-1U)
  49
  50#define CX88_MAXBOARDS 8
  51
  52/* Max number of inputs by card */
  53#define MAX_CX88_INPUT 8
  54
  55/* ----------------------------------------------------------- */
  56/* defines and enums                                           */
  57
  58#define FORMAT_FLAGS_PACKED       0x01
  59#define FORMAT_FLAGS_PLANAR       0x02
  60
  61#define VBI_LINE_COUNT              17
  62#define VBI_LINE_LENGTH           2048
  63
  64/* need "shadow" registers for some write-only ones ... */
  65#define SHADOW_AUD_VOL_CTL           1
  66#define SHADOW_AUD_BAL_CTL           2
  67#define SHADOW_MAX                   3
  68
  69/* FM Radio deemphasis type */
  70enum cx88_deemph_type {
  71        FM_NO_DEEMPH = 0,
  72        FM_DEEMPH_50,
  73        FM_DEEMPH_75
  74};
  75
  76/* ----------------------------------------------------------- */
  77/* tv norms                                                    */
  78
  79struct cx88_tvnorm {
  80        char                   *name;
  81        v4l2_std_id            id;
  82        u32                    cxiformat;
  83        u32                    cxoformat;
  84};
  85
  86static unsigned int inline norm_maxw(struct cx88_tvnorm *norm)
  87{
  88        return (norm->id & V4L2_STD_625_50) ? 768 : 640;
  89}
  90
  91
  92static unsigned int inline norm_maxh(struct cx88_tvnorm *norm)
  93{
  94        return (norm->id & V4L2_STD_625_50) ? 576 : 480;
  95}
  96
  97/* ----------------------------------------------------------- */
  98/* static data                                                 */
  99
 100struct cx8800_fmt {
 101        char  *name;
 102        u32   fourcc;          /* v4l2 format id */
 103        int   depth;
 104        int   flags;
 105        u32   cxformat;
 106};
 107
 108struct cx88_ctrl {
 109        struct v4l2_queryctrl  v;
 110        u32                    off;
 111        u32                    reg;
 112        u32                    sreg;
 113        u32                    mask;
 114        u32                    shift;
 115};
 116
 117/* ----------------------------------------------------------- */
 118/* SRAM memory management data (see cx88-core.c)               */
 119
 120#define SRAM_CH21 0   /* video */
 121#define SRAM_CH22 1
 122#define SRAM_CH23 2
 123#define SRAM_CH24 3   /* vbi   */
 124#define SRAM_CH25 4   /* audio */
 125#define SRAM_CH26 5
 126#define SRAM_CH28 6   /* mpeg */
 127/* more */
 128
 129struct sram_channel {
 130        char *name;
 131        u32  cmds_start;
 132        u32  ctrl_start;
 133        u32  cdt;
 134        u32  fifo_start;
 135        u32  fifo_size;
 136        u32  ptr1_reg;
 137        u32  ptr2_reg;
 138        u32  cnt1_reg;
 139        u32  cnt2_reg;
 140};
 141extern struct sram_channel cx88_sram_channels[];
 142
 143/* ----------------------------------------------------------- */
 144/* card configuration                                          */
 145
 146#define CX88_BOARD_NOAUTO               UNSET
 147#define CX88_BOARD_UNKNOWN                  0
 148#define CX88_BOARD_HAUPPAUGE                1
 149#define CX88_BOARD_GDI                      2
 150#define CX88_BOARD_PIXELVIEW                3
 151#define CX88_BOARD_ATI_WONDER_PRO           4
 152#define CX88_BOARD_WINFAST2000XP_EXPERT     5
 153#define CX88_BOARD_AVERTV_STUDIO_303        6
 154#define CX88_BOARD_MSI_TVANYWHERE_MASTER    7
 155#define CX88_BOARD_WINFAST_DV2000           8
 156#define CX88_BOARD_LEADTEK_PVR2000          9
 157#define CX88_BOARD_IODATA_GVVCP3PCI        10
 158#define CX88_BOARD_PROLINK_PLAYTVPVR       11
 159#define CX88_BOARD_ASUS_PVR_416            12
 160#define CX88_BOARD_MSI_TVANYWHERE          13
 161#define CX88_BOARD_KWORLD_DVB_T            14
 162#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
 163#define CX88_BOARD_KWORLD_LTV883           16
 164#define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q  17
 165#define CX88_BOARD_HAUPPAUGE_DVB_T1        18
 166#define CX88_BOARD_CONEXANT_DVB_T1         19
 167#define CX88_BOARD_PROVIDEO_PV259          20
 168#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
 169#define CX88_BOARD_PCHDTV_HD3000           22
 170#define CX88_BOARD_DNTV_LIVE_DVB_T         23
 171#define CX88_BOARD_HAUPPAUGE_ROSLYN        24
 172#define CX88_BOARD_DIGITALLOGIC_MEC        25
 173#define CX88_BOARD_IODATA_GVBCTV7E         26
 174#define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
 175#define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T  28
 176#define CX88_BOARD_ADSTECH_DVB_T_PCI          29
 177#define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1  30
 178#define CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD 31
 179#define CX88_BOARD_AVERMEDIA_ULTRATV_MC_550 32
 180#define CX88_BOARD_KWORLD_VSTREAM_EXPERT_DVD 33
 181#define CX88_BOARD_ATI_HDTVWONDER          34
 182#define CX88_BOARD_WINFAST_DTV1000         35
 183#define CX88_BOARD_AVERTV_303              36
 184#define CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1  37
 185#define CX88_BOARD_HAUPPAUGE_NOVASE2_S1    38
 186#define CX88_BOARD_KWORLD_DVBS_100         39
 187#define CX88_BOARD_HAUPPAUGE_HVR1100       40
 188#define CX88_BOARD_HAUPPAUGE_HVR1100LP     41
 189#define CX88_BOARD_DNTV_LIVE_DVB_T_PRO     42
 190#define CX88_BOARD_KWORLD_DVB_T_CX22702    43
 191#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_DUAL 44
 192#define CX88_BOARD_KWORLD_HARDWARE_MPEG_TV_XPERT 45
 193#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_HYBRID 46
 194#define CX88_BOARD_PCHDTV_HD5500           47
 195#define CX88_BOARD_KWORLD_MCE200_DELUXE    48
 196#define CX88_BOARD_PIXELVIEW_PLAYTV_P7000  49
 197#define CX88_BOARD_NPGTECH_REALTV_TOP10FM  50
 198#define CX88_BOARD_WINFAST_DTV2000H        51
 199#define CX88_BOARD_GENIATECH_DVBS          52
 200
 201enum cx88_itype {
 202        CX88_VMUX_COMPOSITE1 = 1,
 203        CX88_VMUX_COMPOSITE2,
 204        CX88_VMUX_COMPOSITE3,
 205        CX88_VMUX_COMPOSITE4,
 206        CX88_VMUX_SVIDEO,
 207        CX88_VMUX_TELEVISION,
 208        CX88_VMUX_CABLE,
 209        CX88_VMUX_DVB,
 210        CX88_VMUX_DEBUG,
 211        CX88_RADIO,
 212};
 213
 214struct cx88_input {
 215        enum cx88_itype type;
 216        unsigned int    vmux;
 217        u32             gpio0, gpio1, gpio2, gpio3;
 218};
 219
 220struct cx88_board {
 221        char                    *name;
 222        unsigned int            tuner_type;
 223        unsigned int            radio_type;
 224        unsigned char           tuner_addr;
 225        unsigned char           radio_addr;
 226        int                     tda9887_conf;
 227        struct cx88_input       input[MAX_CX88_INPUT];
 228        struct cx88_input       radio;
 229        unsigned int            blackbird:1;
 230        unsigned int            dvb:1;
 231};
 232
 233struct cx88_subid {
 234        u16     subvendor;
 235        u16     subdevice;
 236        u32     card;
 237};
 238
 239#define INPUT(nr) (&cx88_boards[core->board].input[nr])
 240
 241/* ----------------------------------------------------------- */
 242/* device / file handle status                                 */
 243
 244#define RESOURCE_OVERLAY       1
 245#define RESOURCE_VIDEO         2
 246#define RESOURCE_VBI           4
 247
 248#define BUFFER_TIMEOUT     (HZ/2)  /* 0.5 seconds */
 249
 250/* buffer for one video frame */
 251struct cx88_buffer {
 252        /* common v4l buffer stuff -- must be first */
 253        struct videobuf_buffer vb;
 254
 255        /* cx88 specific */
 256        unsigned int           bpl;
 257        struct btcx_riscmem    risc;
 258        struct cx8800_fmt      *fmt;
 259        u32                    count;
 260};
 261
 262struct cx88_dmaqueue {
 263        struct list_head       active;
 264        struct list_head       queued;
 265        struct timer_list      timeout;
 266        struct btcx_riscmem    stopper;
 267        u32                    count;
 268};
 269
 270struct cx88_core {
 271        struct list_head           devlist;
 272        atomic_t                   refcount;
 273
 274        /* board name */
 275        int                        nr;
 276        char                       name[32];
 277
 278        /* pci stuff */
 279        int                        pci_bus;
 280        int                        pci_slot;
 281        u32                        __iomem *lmmio;
 282        u8                         __iomem *bmmio;
 283        u32                        shadow[SHADOW_MAX];
 284        int                        pci_irqmask;
 285
 286        /* i2c i/o */
 287        struct i2c_adapter         i2c_adap;
 288        struct i2c_algo_bit_data   i2c_algo;
 289        struct i2c_client          i2c_client;
 290        u32                        i2c_state, i2c_rc;
 291
 292        /* config info -- analog */
 293        unsigned int               board;
 294        unsigned int               tuner_type;
 295        unsigned int               radio_type;
 296        unsigned char              tuner_addr;
 297        unsigned char              radio_addr;
 298        unsigned int               tda9887_conf;
 299        unsigned int               has_radio;
 300
 301        /* Supported V4L _STD_ tuner formats */
 302        unsigned int               tuner_formats;
 303
 304        /* config info -- dvb */
 305        struct dvb_pll_desc        *pll_desc;
 306        unsigned int               pll_addr;
 307        int                        (*prev_set_voltage)(struct dvb_frontend* fe, fe_sec_voltage_t voltage);
 308
 309        /* state info */
 310        struct task_struct         *kthread;
 311        struct cx88_tvnorm         *tvnorm;
 312        u32                        tvaudio;
 313        u32                        audiomode_manual;
 314        u32                        audiomode_current;
 315        u32                        input;
 316        u32                        astat;
 317        u32                        use_nicam;
 318
 319        /* IR remote control state */
 320        struct cx88_IR             *ir;
 321
 322        struct mutex               lock;
 323        /* various v4l controls */
 324        u32                        freq;
 325
 326        /* cx88-video needs to access cx8802 for hybrid tuner pll access. */
 327        struct cx8802_dev          *dvbdev;
 328};
 329
 330struct cx8800_dev;
 331struct cx8802_dev;
 332
 333/* ----------------------------------------------------------- */
 334/* function 0: video stuff                                     */
 335
 336struct cx8800_fh {
 337        struct cx8800_dev          *dev;
 338        enum v4l2_buf_type         type;
 339        int                        radio;
 340        unsigned int               resources;
 341
 342        /* video overlay */
 343        struct v4l2_window         win;
 344        struct v4l2_clip           *clips;
 345        unsigned int               nclips;
 346
 347        /* video capture */
 348        struct cx8800_fmt          *fmt;
 349        unsigned int               width,height;
 350        struct videobuf_queue      vidq;
 351
 352        /* vbi capture */
 353        struct videobuf_queue      vbiq;
 354};
 355
 356struct cx8800_suspend_state {
 357        int                        disabled;
 358};
 359
 360struct cx8800_dev {
 361        struct cx88_core           *core;
 362        struct list_head           devlist;
 363        spinlock_t                 slock;
 364
 365        /* various device info */
 366        unsigned int               resources;
 367        struct video_device        *video_dev;
 368        struct video_device        *vbi_dev;
 369        struct video_device        *radio_dev;
 370
 371        /* pci i/o */
 372        struct pci_dev             *pci;
 373        unsigned char              pci_rev,pci_lat;
 374
 375
 376        /* capture queues */
 377        struct cx88_dmaqueue       vidq;
 378        struct cx88_dmaqueue       vbiq;
 379
 380        /* various v4l controls */
 381
 382        /* other global state info */
 383        struct cx8800_suspend_state state;
 384};
 385
 386/* ----------------------------------------------------------- */
 387/* function 1: audio/alsa stuff                                */
 388/* =============> moved to cx88-alsa.c <====================== */
 389
 390
 391/* ----------------------------------------------------------- */
 392/* function 2: mpeg stuff                                      */
 393
 394struct cx8802_fh {
 395        struct cx8802_dev          *dev;
 396        struct videobuf_queue      mpegq;
 397};
 398
 399struct cx8802_suspend_state {
 400        int                        disabled;
 401};
 402
 403struct cx8802_dev {
 404        struct cx88_core           *core;
 405        spinlock_t                 slock;
 406
 407        /* pci i/o */
 408        struct pci_dev             *pci;
 409        unsigned char              pci_rev,pci_lat;
 410
 411        /* dma queues */
 412        struct cx88_dmaqueue       mpegq;
 413        u32                        ts_packet_size;
 414        u32                        ts_packet_count;
 415
 416        /* other global state info */
 417        struct cx8802_suspend_state state;
 418
 419        /* for blackbird only */
 420        struct list_head           devlist;
 421        struct video_device        *mpeg_dev;
 422        u32                        mailbox;
 423        int                        width;
 424        int                        height;
 425
 426        /* for dvb only */
 427        struct videobuf_dvb        dvb;
 428        void*                      fe_handle;
 429        int                        (*fe_release)(void *handle);
 430
 431        void                       *card_priv;
 432        /* for switching modulation types */
 433        unsigned char              ts_gen_cntrl;
 434
 435        /* mpeg params */
 436        struct cx2341x_mpeg_params params;
 437};
 438
 439/* ----------------------------------------------------------- */
 440
 441#define cx_read(reg)             readl(core->lmmio + ((reg)>>2))
 442#define cx_write(reg,value)      writel((value), core->lmmio + ((reg)>>2))
 443#define cx_writeb(reg,value)     writeb((value), core->bmmio + (reg))
 444
 445#define cx_andor(reg,mask,value) \
 446  writel((readl(core->lmmio+((reg)>>2)) & ~(mask)) |\
 447  ((value) & (mask)), core->lmmio+((reg)>>2))
 448#define cx_set(reg,bit)          cx_andor((reg),(bit),(bit))
 449#define cx_clear(reg,bit)        cx_andor((reg),(bit),0)
 450
 451#define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
 452
 453/* shadow registers */
 454#define cx_sread(sreg)              (core->shadow[sreg])
 455#define cx_swrite(sreg,reg,value) \
 456  (core->shadow[sreg] = value, \
 457   writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
 458#define cx_sandor(sreg,reg,mask,value) \
 459  (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | ((value) & (mask)), \
 460   writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
 461
 462/* ----------------------------------------------------------- */
 463/* cx88-core.c                                                 */
 464
 465extern void cx88_print_irqbits(char *name, char *tag, char **strings,
 466                               u32 bits, u32 mask);
 467
 468extern int cx88_core_irq(struct cx88_core *core, u32 status);
 469extern void cx88_wakeup(struct cx88_core *core,
 470                        struct cx88_dmaqueue *q, u32 count);
 471extern void cx88_shutdown(struct cx88_core *core);
 472extern int cx88_reset(struct cx88_core *core);
 473
 474extern int
 475cx88_risc_buffer(struct pci_dev *pci, struct btcx_riscmem *risc,
 476                 struct scatterlist *sglist,
 477                 unsigned int top_offset, unsigned int bottom_offset,
 478                 unsigned int bpl, unsigned int padding, unsigned int lines);
 479extern int
 480cx88_risc_databuffer(struct pci_dev *pci, struct btcx_riscmem *risc,
 481                     struct scatterlist *sglist, unsigned int bpl,
 482                     unsigned int lines);
 483extern int
 484cx88_risc_stopper(struct pci_dev *pci, struct btcx_riscmem *risc,
 485                  u32 reg, u32 mask, u32 value);
 486extern void
 487cx88_free_buffer(struct videobuf_queue *q, struct cx88_buffer *buf);
 488
 489extern void cx88_risc_disasm(struct cx88_core *core,
 490                             struct btcx_riscmem *risc);
 491extern int cx88_sram_channel_setup(struct cx88_core *core,
 492                                   struct sram_channel *ch,
 493                                   unsigned int bpl, u32 risc);
 494extern void cx88_sram_channel_dump(struct cx88_core *core,
 495                                   struct sram_channel *ch);
 496
 497extern int cx88_set_scale(struct cx88_core *core, unsigned int width,
 498                          unsigned int height, enum v4l2_field field);
 499extern int cx88_set_tvnorm(struct cx88_core *core, struct cx88_tvnorm *norm);
 500
 501extern struct video_device *cx88_vdev_init(struct cx88_core *core,
 502                                           struct pci_dev *pci,
 503                                           struct video_device *template,
 504                                           char *type);
 505extern struct cx88_core* cx88_core_get(struct pci_dev *pci);
 506extern void cx88_core_put(struct cx88_core *core,
 507                          struct pci_dev *pci);
 508
 509extern int cx88_start_audio_dma(struct cx88_core *core);
 510extern int cx88_stop_audio_dma(struct cx88_core *core);
 511
 512
 513/* ----------------------------------------------------------- */
 514/* cx88-vbi.c                                                  */
 515
 516void cx8800_vbi_fmt(struct cx8800_dev *dev, struct v4l2_format *f);
 517/*
 518int cx8800_start_vbi_dma(struct cx8800_dev    *dev,
 519                         struct cx88_dmaqueue *q,
 520                         struct cx88_buffer   *buf);
 521*/
 522int cx8800_stop_vbi_dma(struct cx8800_dev *dev);
 523int cx8800_restart_vbi_queue(struct cx8800_dev    *dev,
 524                             struct cx88_dmaqueue *q);
 525void cx8800_vbi_timeout(unsigned long data);
 526
 527extern struct videobuf_queue_ops cx8800_vbi_qops;
 528
 529/* ----------------------------------------------------------- */
 530/* cx88-i2c.c                                                  */
 531
 532extern int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
 533extern void cx88_call_i2c_clients(struct cx88_core *core,
 534                                  unsigned int cmd, void *arg);
 535
 536
 537/* ----------------------------------------------------------- */
 538/* cx88-cards.c                                                */
 539
 540extern struct cx88_board cx88_boards[];
 541extern const unsigned int cx88_bcount;
 542
 543extern struct cx88_subid cx88_subids[];
 544extern const unsigned int cx88_idcount;
 545
 546extern void cx88_card_list(struct cx88_core *core, struct pci_dev *pci);
 547extern void cx88_card_setup(struct cx88_core *core);
 548
 549/* ----------------------------------------------------------- */
 550/* cx88-tvaudio.c                                              */
 551
 552#define WW_NONE          1
 553#define WW_BTSC          2
 554#define WW_BG            3
 555#define WW_DK            4
 556#define WW_I             5
 557#define WW_L             6
 558#define WW_EIAJ          7
 559#define WW_I2SPT         8
 560#define WW_FM            9
 561
 562void cx88_set_tvaudio(struct cx88_core *core);
 563void cx88_newstation(struct cx88_core *core);
 564void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
 565void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
 566int cx88_audio_thread(void *data);
 567
 568/* ----------------------------------------------------------- */
 569/* cx88-input.c                                                */
 570
 571int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
 572int cx88_ir_fini(struct cx88_core *core);
 573void cx88_ir_irq(struct cx88_core *core);
 574
 575/* ----------------------------------------------------------- */
 576/* cx88-mpeg.c                                                 */
 577
 578int cx8802_buf_prepare(struct videobuf_queue *q,struct cx8802_dev *dev,
 579                        struct cx88_buffer *buf, enum v4l2_field field);
 580void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
 581void cx8802_cancel_buffers(struct cx8802_dev *dev);
 582
 583int cx8802_init_common(struct cx8802_dev *dev);
 584void cx8802_fini_common(struct cx8802_dev *dev);
 585
 586int cx8802_suspend_common(struct pci_dev *pci_dev, pm_message_t state);
 587int cx8802_resume_common(struct pci_dev *pci_dev);
 588
 589/* ----------------------------------------------------------- */
 590/* cx88-video.c                                                */
 591extern int cx88_do_ioctl(struct inode *inode, struct file *file, int radio,
 592                                struct cx88_core *core, unsigned int cmd,
 593                                void *arg, v4l2_kioctl driver_ioctl);
 594extern const u32 cx88_user_ctrls[];
 595extern int cx8800_ctrl_query(struct v4l2_queryctrl *qctrl);
 596
 597/*
 598 * Local variables:
 599 * c-basic-offset: 8
 600 * End:
 601 * kate: eol "unix"; indent-width 3; remove-trailing-space on; replace-trailing-space-save on; tab-width 8; replace-tabs off; space-indent off; mixed-indent off
 602 */
 603