2 * v4l2 device driver for cx2388x based TV cards
4 * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
20 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
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 #include <linux/refcount.h>
29 #include <media/v4l2-device.h>
30 #include <media/v4l2-fh.h>
31 #include <media/tuner.h>
32 #include <media/tveeprom.h>
33 #include <media/videobuf2-dma-sg.h>
34 #include <media/drv-intf/cx2341x.h>
35 #include <media/videobuf2-dvb.h>
36 #include <media/i2c/ir-kbd-i2c.h>
37 #include <media/i2c/wm8775.h>
40 #include "tuner-xc2028.h"
42 #include <linux/mutex.h>
44 #define CX88_VERSION "1.0.0"
48 #define CX88_MAXBOARDS 8
50 /* Max number of inputs by card */
51 #define MAX_CX88_INPUT 8
53 /* ----------------------------------------------------------- */
54 /* defines and enums */
56 /* Currently unsupported by the driver: PAL/H, NTSC/Kr, SECAM/LC */
57 #define CX88_NORMS (V4L2_STD_ALL \
59 & ~V4L2_STD_NTSC_M_KR \
62 #define FORMAT_FLAGS_PACKED 0x01
63 #define FORMAT_FLAGS_PLANAR 0x02
65 #define VBI_LINE_PAL_COUNT 18
66 #define VBI_LINE_NTSC_COUNT 12
67 #define VBI_LINE_LENGTH 2048
69 #define AUD_RDS_LINES 4
71 /* need "shadow" registers for some write-only ones ... */
72 #define SHADOW_AUD_VOL_CTL 1
73 #define SHADOW_AUD_BAL_CTL 2
76 /* FM Radio deemphasis type */
77 enum cx88_deemph_type {
83 enum cx88_board_type {
89 enum cx8802_board_access {
90 CX8802_DRVCTL_SHARED = 1,
91 CX8802_DRVCTL_EXCLUSIVE = 2,
94 /* ----------------------------------------------------------- */
97 static inline unsigned int norm_maxw(v4l2_std_id norm)
102 static inline unsigned int norm_maxh(v4l2_std_id norm)
104 return (norm & V4L2_STD_525_60) ? 480 : 576;
107 /* ----------------------------------------------------------- */
112 u32 fourcc; /* v4l2 format id */
118 /* ----------------------------------------------------------- */
119 /* SRAM memory management data (see cx88-core.c) */
121 #define SRAM_CH21 0 /* video */
124 #define SRAM_CH24 3 /* vbi */
125 #define SRAM_CH25 4 /* audio */
127 #define SRAM_CH28 6 /* mpeg */
128 #define SRAM_CH27 7 /* audio rds */
131 struct sram_channel {
144 extern const struct sram_channel cx88_sram_channels[];
146 /* ----------------------------------------------------------- */
147 /* card configuration */
149 #define CX88_BOARD_NOAUTO UNSET
150 #define CX88_BOARD_UNKNOWN 0
151 #define CX88_BOARD_HAUPPAUGE 1
152 #define CX88_BOARD_GDI 2
153 #define CX88_BOARD_PIXELVIEW 3
154 #define CX88_BOARD_ATI_WONDER_PRO 4
155 #define CX88_BOARD_WINFAST2000XP_EXPERT 5
156 #define CX88_BOARD_AVERTV_STUDIO_303 6
157 #define CX88_BOARD_MSI_TVANYWHERE_MASTER 7
158 #define CX88_BOARD_WINFAST_DV2000 8
159 #define CX88_BOARD_LEADTEK_PVR2000 9
160 #define CX88_BOARD_IODATA_GVVCP3PCI 10
161 #define CX88_BOARD_PROLINK_PLAYTVPVR 11
162 #define CX88_BOARD_ASUS_PVR_416 12
163 #define CX88_BOARD_MSI_TVANYWHERE 13
164 #define CX88_BOARD_KWORLD_DVB_T 14
165 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
166 #define CX88_BOARD_KWORLD_LTV883 16
167 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q 17
168 #define CX88_BOARD_HAUPPAUGE_DVB_T1 18
169 #define CX88_BOARD_CONEXANT_DVB_T1 19
170 #define CX88_BOARD_PROVIDEO_PV259 20
171 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
172 #define CX88_BOARD_PCHDTV_HD3000 22
173 #define CX88_BOARD_DNTV_LIVE_DVB_T 23
174 #define CX88_BOARD_HAUPPAUGE_ROSLYN 24
175 #define CX88_BOARD_DIGITALLOGIC_MEC 25
176 #define CX88_BOARD_IODATA_GVBCTV7E 26
177 #define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
178 #define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T 28
179 #define CX88_BOARD_ADSTECH_DVB_T_PCI 29
180 #define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1 30
181 #define CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD 31
182 #define CX88_BOARD_AVERMEDIA_ULTRATV_MC_550 32
183 #define CX88_BOARD_KWORLD_VSTREAM_EXPERT_DVD 33
184 #define CX88_BOARD_ATI_HDTVWONDER 34
185 #define CX88_BOARD_WINFAST_DTV1000 35
186 #define CX88_BOARD_AVERTV_303 36
187 #define CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1 37
188 #define CX88_BOARD_HAUPPAUGE_NOVASE2_S1 38
189 #define CX88_BOARD_KWORLD_DVBS_100 39
190 #define CX88_BOARD_HAUPPAUGE_HVR1100 40
191 #define CX88_BOARD_HAUPPAUGE_HVR1100LP 41
192 #define CX88_BOARD_DNTV_LIVE_DVB_T_PRO 42
193 #define CX88_BOARD_KWORLD_DVB_T_CX22702 43
194 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_DUAL 44
195 #define CX88_BOARD_KWORLD_HARDWARE_MPEG_TV_XPERT 45
196 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_HYBRID 46
197 #define CX88_BOARD_PCHDTV_HD5500 47
198 #define CX88_BOARD_KWORLD_MCE200_DELUXE 48
199 #define CX88_BOARD_PIXELVIEW_PLAYTV_P7000 49
200 #define CX88_BOARD_NPGTECH_REALTV_TOP10FM 50
201 #define CX88_BOARD_WINFAST_DTV2000H 51
202 #define CX88_BOARD_GENIATECH_DVBS 52
203 #define CX88_BOARD_HAUPPAUGE_HVR3000 53
204 #define CX88_BOARD_NORWOOD_MICRO 54
205 #define CX88_BOARD_TE_DTV_250_OEM_SWANN 55
206 #define CX88_BOARD_HAUPPAUGE_HVR1300 56
207 #define CX88_BOARD_ADSTECH_PTV_390 57
208 #define CX88_BOARD_PINNACLE_PCTV_HD_800i 58
209 #define CX88_BOARD_DVICO_FUSIONHDTV_5_PCI_NANO 59
210 #define CX88_BOARD_PINNACLE_HYBRID_PCTV 60
211 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL 61
212 #define CX88_BOARD_POWERCOLOR_REAL_ANGEL 62
213 #define CX88_BOARD_GENIATECH_X8000_MT 63
214 #define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PRO 64
215 #define CX88_BOARD_DVICO_FUSIONHDTV_7_GOLD 65
216 #define CX88_BOARD_PROLINK_PV_8000GT 66
217 #define CX88_BOARD_KWORLD_ATSC_120 67
218 #define CX88_BOARD_HAUPPAUGE_HVR4000 68
219 #define CX88_BOARD_HAUPPAUGE_HVR4000LITE 69
220 #define CX88_BOARD_TEVII_S460 70
221 #define CX88_BOARD_OMICOM_SS4_PCI 71
222 #define CX88_BOARD_TBS_8920 72
223 #define CX88_BOARD_TEVII_S420 73
224 #define CX88_BOARD_PROLINK_PV_GLOBAL_XTREME 74
225 #define CX88_BOARD_PROF_7300 75
226 #define CX88_BOARD_SATTRADE_ST4200 76
227 #define CX88_BOARD_TBS_8910 77
228 #define CX88_BOARD_PROF_6200 78
229 #define CX88_BOARD_TERRATEC_CINERGY_HT_PCI_MKII 79
230 #define CX88_BOARD_HAUPPAUGE_IRONLY 80
231 #define CX88_BOARD_WINFAST_DTV1800H 81
232 #define CX88_BOARD_WINFAST_DTV2000H_J 82
233 #define CX88_BOARD_PROF_7301 83
234 #define CX88_BOARD_SAMSUNG_SMT_7020 84
235 #define CX88_BOARD_TWINHAN_VP1027_DVBS 85
236 #define CX88_BOARD_TEVII_S464 86
237 #define CX88_BOARD_WINFAST_DTV2000H_PLUS 87
238 #define CX88_BOARD_WINFAST_DTV1800H_XC4000 88
239 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL_6F36 89
240 #define CX88_BOARD_WINFAST_TV2000_XP_GLOBAL_6F43 90
243 CX88_VMUX_COMPOSITE1 = 1,
244 CX88_VMUX_COMPOSITE2,
245 CX88_VMUX_COMPOSITE3,
246 CX88_VMUX_COMPOSITE4,
248 CX88_VMUX_TELEVISION,
256 enum cx88_itype type;
257 u32 gpio0, gpio1, gpio2, gpio3;
259 unsigned int audioroute:4;
262 enum cx88_audio_chip {
263 CX88_AUDIO_WM8775 = 1,
269 unsigned int tuner_type;
270 unsigned int radio_type;
271 unsigned char tuner_addr;
272 unsigned char radio_addr;
274 struct cx88_input input[MAX_CX88_INPUT];
275 struct cx88_input radio;
276 enum cx88_board_type mpeg;
277 enum cx88_audio_chip audio_chip;
280 /* Used for I2S devices */
304 #define INPUT(nr) (core->board.input[nr])
306 /* ----------------------------------------------------------- */
307 /* device / file handle status */
309 #define RESOURCE_OVERLAY 1
310 #define RESOURCE_VIDEO 2
311 #define RESOURCE_VBI 4
313 #define BUFFER_TIMEOUT msecs_to_jiffies(2000)
315 struct cx88_riscmem {
322 /* buffer for one video frame */
324 /* common v4l buffer stuff -- must be first */
325 struct vb2_v4l2_buffer vb;
326 struct list_head list;
330 struct cx88_riscmem risc;
333 struct cx88_dmaqueue {
334 struct list_head active;
342 struct list_head devlist;
355 u32 shadow[SHADOW_MAX];
359 struct i2c_adapter i2c_adap;
360 struct i2c_algo_bit_data i2c_algo;
361 struct i2c_client i2c_client;
362 u32 i2c_state, i2c_rc;
364 /* config info -- analog */
365 struct v4l2_device v4l2_dev;
366 struct v4l2_ctrl_handler video_hdl;
367 struct v4l2_ctrl *chroma_agc;
368 struct v4l2_ctrl_handler audio_hdl;
369 struct v4l2_subdev *sd_wm8775;
370 struct i2c_client *i2c_rtc;
371 unsigned int boardnr;
372 struct cx88_board board;
374 /* Supported V4L _STD_ tuner formats */
375 unsigned int tuner_formats;
377 /* config info -- dvb */
378 #if IS_ENABLED(CONFIG_VIDEO_CX88_DVB)
379 int (*prev_set_voltage)(struct dvb_frontend *fe,
380 enum fe_sec_voltage voltage);
382 void (*gate_ctrl)(struct cx88_core *core, int open);
385 struct task_struct *kthread;
387 unsigned int width, height;
389 enum cx88_tvaudio tvaudio;
390 u32 audiomode_manual;
391 u32 audiomode_current;
393 u32 last_analog_input;
396 unsigned long last_change;
398 /* IR remote control state */
401 /* I2C remote data */
402 struct IR_i2c_init_data init_data;
403 struct wm8775_platform_data wm8775_data;
406 /* various v4l controls */
410 * cx88-video needs to access cx8802 for hybrid tuner pll access and
411 * for vb2_is_busy() checks.
413 struct cx8802_dev *dvbdev;
414 /* cx88-blackbird needs to access cx8800 for vb2_is_busy() checks */
415 struct cx8800_dev *v4ldev;
416 enum cx88_board_type active_type_id;
421 static inline struct cx88_core *to_core(struct v4l2_device *v4l2_dev)
423 return container_of(v4l2_dev, struct cx88_core, v4l2_dev);
426 #define call_hw(core, grpid, o, f, args...) \
428 if (!core->i2c_rc) { \
429 if (core->gate_ctrl) \
430 core->gate_ctrl(core, 1); \
431 v4l2_device_call_all(&core->v4l2_dev, \
432 grpid, o, f, ##args); \
433 if (core->gate_ctrl) \
434 core->gate_ctrl(core, 0); \
438 #define call_all(core, o, f, args...) call_hw(core, 0, o, f, ##args)
440 #define WM8775_GID (1 << 0)
442 #define wm8775_s_ctrl(core, id, val) \
444 struct v4l2_ctrl *ctrl_ = \
445 v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);\
446 if (ctrl_ && !core->i2c_rc) { \
447 if (core->gate_ctrl) \
448 core->gate_ctrl(core, 1); \
449 v4l2_ctrl_s_ctrl(ctrl_, val); \
450 if (core->gate_ctrl) \
451 core->gate_ctrl(core, 0); \
455 #define wm8775_g_ctrl(core, id) \
457 struct v4l2_ctrl *ctrl_ = \
458 v4l2_ctrl_find(core->sd_wm8775->ctrl_handler, id);\
460 if (ctrl_ && !core->i2c_rc) { \
461 if (core->gate_ctrl) \
462 core->gate_ctrl(core, 1); \
463 val = v4l2_ctrl_g_ctrl(ctrl_); \
464 if (core->gate_ctrl) \
465 core->gate_ctrl(core, 0); \
470 /* ----------------------------------------------------------- */
471 /* function 0: video stuff */
473 struct cx8800_suspend_state {
478 struct cx88_core *core;
481 /* various device info */
482 unsigned int resources;
483 struct video_device video_dev;
484 struct video_device vbi_dev;
485 struct video_device radio_dev;
489 unsigned char pci_rev, pci_lat;
491 const struct cx8800_fmt *fmt;
494 struct cx88_dmaqueue vidq;
495 struct vb2_queue vb2_vidq;
496 struct cx88_dmaqueue vbiq;
497 struct vb2_queue vb2_vbiq;
499 /* various v4l controls */
501 /* other global state info */
502 struct cx8800_suspend_state state;
505 /* ----------------------------------------------------------- */
506 /* function 1: audio/alsa stuff */
507 /* =============> moved to cx88-alsa.c <====================== */
509 /* ----------------------------------------------------------- */
510 /* function 2: mpeg stuff */
512 struct cx8802_suspend_state {
516 struct cx8802_driver {
517 struct cx88_core *core;
519 /* List of drivers attached to device */
520 struct list_head drvlist;
522 /* Type of driver and access required */
523 enum cx88_board_type type_id;
524 enum cx8802_board_access hw_access;
526 /* MPEG 8802 internal only */
527 int (*suspend)(struct pci_dev *pci_dev, pm_message_t state);
528 int (*resume)(struct pci_dev *pci_dev);
530 /* Callers to the following functions must hold core->lock */
532 /* MPEG 8802 -> mini driver - Driver probe and configuration */
533 int (*probe)(struct cx8802_driver *drv);
534 int (*remove)(struct cx8802_driver *drv);
536 /* MPEG 8802 -> mini driver - Access for hardware control */
537 int (*advise_acquire)(struct cx8802_driver *drv);
538 int (*advise_release)(struct cx8802_driver *drv);
540 /* MPEG 8802 <- mini driver - Access for hardware control */
541 int (*request_acquire)(struct cx8802_driver *drv);
542 int (*request_release)(struct cx8802_driver *drv);
546 struct cx88_core *core;
551 unsigned char pci_rev, pci_lat;
554 struct cx88_dmaqueue mpegq;
555 struct vb2_queue vb2_mpegq;
559 /* other global state info */
560 struct cx8802_suspend_state state;
562 /* for blackbird only */
563 struct list_head devlist;
564 #if IS_ENABLED(CONFIG_VIDEO_CX88_BLACKBIRD)
565 struct video_device mpeg_dev;
569 struct cx2341x_handler cxhdl;
573 #if IS_ENABLED(CONFIG_VIDEO_CX88_DVB)
575 struct vb2_dvb_frontends frontends;
578 #if IS_ENABLED(CONFIG_VIDEO_CX88_VP3054)
579 /* For VP3045 secondary I2C bus support */
580 struct vp3054_i2c_state *vp3054;
582 /* for switching modulation types */
583 unsigned char ts_gen_cntrl;
585 /* List of attached drivers; must hold core->lock to access */
586 struct list_head drvlist;
588 struct work_struct request_module_wk;
591 /* ----------------------------------------------------------- */
593 #define cx_read(reg) readl(core->lmmio + ((reg) >> 2))
594 #define cx_write(reg, value) writel((value), core->lmmio + ((reg) >> 2))
595 #define cx_writeb(reg, value) writeb((value), core->bmmio + (reg))
597 #define cx_andor(reg, mask, value) \
598 writel((readl(core->lmmio + ((reg) >> 2)) & ~(mask)) |\
599 ((value) & (mask)), core->lmmio + ((reg) >> 2))
600 #define cx_set(reg, bit) cx_andor((reg), (bit), (bit))
601 #define cx_clear(reg, bit) cx_andor((reg), (bit), 0)
603 #define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
605 /* shadow registers */
606 #define cx_sread(sreg) (core->shadow[sreg])
607 #define cx_swrite(sreg, reg, value) \
608 (core->shadow[sreg] = value, \
609 writel(core->shadow[sreg], core->lmmio + ((reg) >> 2)))
610 #define cx_sandor(sreg, reg, mask, value) \
611 (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | \
612 ((value) & (mask)), \
613 writel(core->shadow[sreg], \
614 core->lmmio + ((reg) >> 2)))
616 /* ----------------------------------------------------------- */
619 extern unsigned int cx88_core_debug;
621 void cx88_print_irqbits(const char *tag, const char *strings[],
622 int len, u32 bits, u32 mask);
624 int cx88_core_irq(struct cx88_core *core, u32 status);
625 void cx88_wakeup(struct cx88_core *core,
626 struct cx88_dmaqueue *q, u32 count);
627 void cx88_shutdown(struct cx88_core *core);
628 int cx88_reset(struct cx88_core *core);
631 cx88_risc_buffer(struct pci_dev *pci, struct cx88_riscmem *risc,
632 struct scatterlist *sglist,
633 unsigned int top_offset, unsigned int bottom_offset,
634 unsigned int bpl, unsigned int padding, unsigned int lines);
636 cx88_risc_databuffer(struct pci_dev *pci, struct cx88_riscmem *risc,
637 struct scatterlist *sglist, unsigned int bpl,
638 unsigned int lines, unsigned int lpi);
640 void cx88_risc_disasm(struct cx88_core *core,
641 struct cx88_riscmem *risc);
642 int cx88_sram_channel_setup(struct cx88_core *core,
643 const struct sram_channel *ch,
644 unsigned int bpl, u32 risc);
645 void cx88_sram_channel_dump(struct cx88_core *core,
646 const struct sram_channel *ch);
648 int cx88_set_scale(struct cx88_core *core, unsigned int width,
649 unsigned int height, enum v4l2_field field);
650 int cx88_set_tvnorm(struct cx88_core *core, v4l2_std_id norm);
652 void cx88_vdev_init(struct cx88_core *core,
654 struct video_device *vfd,
655 const struct video_device *template_,
657 struct cx88_core *cx88_core_get(struct pci_dev *pci);
658 void cx88_core_put(struct cx88_core *core,
659 struct pci_dev *pci);
661 int cx88_start_audio_dma(struct cx88_core *core);
662 int cx88_stop_audio_dma(struct cx88_core *core);
664 /* ----------------------------------------------------------- */
667 /* Can be used as g_vbi_fmt, try_vbi_fmt and s_vbi_fmt */
668 int cx8800_vbi_fmt(struct file *file, void *priv,
669 struct v4l2_format *f);
671 void cx8800_stop_vbi_dma(struct cx8800_dev *dev);
672 int cx8800_restart_vbi_queue(struct cx8800_dev *dev, struct cx88_dmaqueue *q);
674 extern const struct vb2_ops cx8800_vbi_qops;
676 /* ----------------------------------------------------------- */
679 int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
681 /* ----------------------------------------------------------- */
684 int cx88_tuner_callback(void *dev, int component, int command, int arg);
685 int cx88_get_resources(const struct cx88_core *core,
686 struct pci_dev *pci);
687 struct cx88_core *cx88_core_create(struct pci_dev *pci, int nr);
688 void cx88_setup_xc3028(struct cx88_core *core, struct xc2028_ctrl *ctl);
690 /* ----------------------------------------------------------- */
693 void cx88_set_tvaudio(struct cx88_core *core);
694 void cx88_newstation(struct cx88_core *core);
695 void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
696 void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
697 int cx88_audio_thread(void *data);
699 int cx8802_register_driver(struct cx8802_driver *drv);
700 int cx8802_unregister_driver(struct cx8802_driver *drv);
702 /* Caller must hold core->lock */
703 struct cx8802_driver *cx8802_get_driver(struct cx8802_dev *dev,
704 enum cx88_board_type btype);
706 /* ----------------------------------------------------------- */
709 s32 cx88_dsp_detect_stereo_sap(struct cx88_core *core);
711 /* ----------------------------------------------------------- */
714 int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
715 int cx88_ir_fini(struct cx88_core *core);
716 void cx88_ir_irq(struct cx88_core *core);
717 int cx88_ir_start(struct cx88_core *core);
718 void cx88_ir_stop(struct cx88_core *core);
719 void cx88_i2c_init_ir(struct cx88_core *core);
721 /* ----------------------------------------------------------- */
724 int cx8802_buf_prepare(struct vb2_queue *q, struct cx8802_dev *dev,
725 struct cx88_buffer *buf);
726 void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
727 void cx8802_cancel_buffers(struct cx8802_dev *dev);
728 int cx8802_start_dma(struct cx8802_dev *dev,
729 struct cx88_dmaqueue *q,
730 struct cx88_buffer *buf);
732 /* ----------------------------------------------------------- */
734 int cx88_enum_input(struct cx88_core *core, struct v4l2_input *i);
735 int cx88_set_freq(struct cx88_core *core, const struct v4l2_frequency *f);
736 int cx88_video_mux(struct cx88_core *core, unsigned int input);
737 void cx88_querycap(struct file *file, struct cx88_core *core,
738 struct v4l2_capability *cap);