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