1 |
62 |
marcus.erl |
/*
|
2 |
|
|
* saa7191.h - Philips SAA7191 video decoder driver
|
3 |
|
|
*
|
4 |
|
|
* Copyright (C) 2003 Ladislav Michl <ladis@linux-mips.org>
|
5 |
|
|
* Copyright (C) 2004,2005 Mikael Nousiainen <tmnousia@cc.hut.fi>
|
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 version 2 as
|
9 |
|
|
* published by the Free Software Foundation.
|
10 |
|
|
*/
|
11 |
|
|
|
12 |
|
|
#ifndef _SAA7191_H_
|
13 |
|
|
#define _SAA7191_H_
|
14 |
|
|
|
15 |
|
|
/* Philips SAA7191 DMSD I2C bus address */
|
16 |
|
|
#define SAA7191_ADDR 0x8a
|
17 |
|
|
|
18 |
|
|
/* Register subaddresses. */
|
19 |
|
|
#define SAA7191_REG_IDEL 0x00
|
20 |
|
|
#define SAA7191_REG_HSYB 0x01
|
21 |
|
|
#define SAA7191_REG_HSYS 0x02
|
22 |
|
|
#define SAA7191_REG_HCLB 0x03
|
23 |
|
|
#define SAA7191_REG_HCLS 0x04
|
24 |
|
|
#define SAA7191_REG_HPHI 0x05
|
25 |
|
|
#define SAA7191_REG_LUMA 0x06
|
26 |
|
|
#define SAA7191_REG_HUEC 0x07
|
27 |
|
|
#define SAA7191_REG_CKTQ 0x08 /* bits 3-7 */
|
28 |
|
|
#define SAA7191_REG_CKTS 0x09 /* bits 3-7 */
|
29 |
|
|
#define SAA7191_REG_PLSE 0x0a
|
30 |
|
|
#define SAA7191_REG_SESE 0x0b
|
31 |
|
|
#define SAA7191_REG_GAIN 0x0c
|
32 |
|
|
#define SAA7191_REG_STDC 0x0d
|
33 |
|
|
#define SAA7191_REG_IOCK 0x0e
|
34 |
|
|
#define SAA7191_REG_CTL3 0x0f
|
35 |
|
|
#define SAA7191_REG_CTL4 0x10
|
36 |
|
|
#define SAA7191_REG_CHCV 0x11
|
37 |
|
|
#define SAA7191_REG_HS6B 0x14
|
38 |
|
|
#define SAA7191_REG_HS6S 0x15
|
39 |
|
|
#define SAA7191_REG_HC6B 0x16
|
40 |
|
|
#define SAA7191_REG_HC6S 0x17
|
41 |
|
|
#define SAA7191_REG_HP6I 0x18
|
42 |
|
|
#define SAA7191_REG_STATUS 0xff /* not really a subaddress */
|
43 |
|
|
|
44 |
|
|
/* Status Register definitions */
|
45 |
|
|
#define SAA7191_STATUS_CODE 0x01 /* color detected flag */
|
46 |
|
|
#define SAA7191_STATUS_FIDT 0x20 /* signal type 50/60 Hz */
|
47 |
|
|
#define SAA7191_STATUS_HLCK 0x40 /* PLL unlocked(1)/locked(0) */
|
48 |
|
|
#define SAA7191_STATUS_STTC 0x80 /* tv/vtr time constant */
|
49 |
|
|
|
50 |
|
|
/* Luminance Control Register definitions */
|
51 |
|
|
/* input mode select bit:
|
52 |
|
|
* 0=CVBS (chrominance trap active), 1=S-Video (trap bypassed) */
|
53 |
|
|
#define SAA7191_LUMA_BYPS 0x80
|
54 |
|
|
/* pre-filter (only when chrominance trap is active) */
|
55 |
|
|
#define SAA7191_LUMA_PREF 0x40
|
56 |
|
|
/* aperture bandpass to select different characteristics with maximums
|
57 |
|
|
* (bits 4-5) */
|
58 |
|
|
#define SAA7191_LUMA_BPSS_MASK 0x30
|
59 |
|
|
#define SAA7191_LUMA_BPSS_SHIFT 4
|
60 |
|
|
#define SAA7191_LUMA_BPSS_3 0x30
|
61 |
|
|
#define SAA7191_LUMA_BPSS_2 0x20
|
62 |
|
|
#define SAA7191_LUMA_BPSS_1 0x10
|
63 |
|
|
#define SAA7191_LUMA_BPSS_0 0x00
|
64 |
|
|
/* coring range for high frequency components according to 8-bit luminance
|
65 |
|
|
* (bits 2-3)
|
66 |
|
|
* 0=coring off, n= (+-)n LSB */
|
67 |
|
|
#define SAA7191_LUMA_CORI_MASK 0x0c
|
68 |
|
|
#define SAA7191_LUMA_CORI_SHIFT 2
|
69 |
|
|
#define SAA7191_LUMA_CORI_3 0x0c
|
70 |
|
|
#define SAA7191_LUMA_CORI_2 0x08
|
71 |
|
|
#define SAA7191_LUMA_CORI_1 0x04
|
72 |
|
|
#define SAA7191_LUMA_CORI_0 0x00
|
73 |
|
|
/* aperture bandpass filter weights high frequency components of luminance
|
74 |
|
|
* signal (bits 0-1)
|
75 |
|
|
* 0=factor 0, 1=0.25, 2=0.5, 3=1 */
|
76 |
|
|
#define SAA7191_LUMA_APER_MASK 0x03
|
77 |
|
|
#define SAA7191_LUMA_APER_SHIFT 0
|
78 |
|
|
#define SAA7191_LUMA_APER_3 0x03
|
79 |
|
|
#define SAA7191_LUMA_APER_2 0x02
|
80 |
|
|
#define SAA7191_LUMA_APER_1 0x01
|
81 |
|
|
#define SAA7191_LUMA_APER_0 0x00
|
82 |
|
|
|
83 |
|
|
/* Chrominance Gain Control Settings Register definitions */
|
84 |
|
|
/* colour on: 0=automatic colour-killer enabled, 1=forced colour on */
|
85 |
|
|
#define SAA7191_GAIN_COLO 0x80
|
86 |
|
|
/* chrominance gain control (AGC filter)
|
87 |
|
|
* 0=loop filter time constant slow, 1=medium, 2=fast, 3=actual gain */
|
88 |
|
|
#define SAA7191_GAIN_LFIS_MASK 0x60
|
89 |
|
|
#define SAA7191_GAIN_LFIS_SHIFT 5
|
90 |
|
|
#define SAA7191_GAIN_LFIS_3 0x60
|
91 |
|
|
#define SAA7191_GAIN_LFIS_2 0x40
|
92 |
|
|
#define SAA7191_GAIN_LFIS_1 0x20
|
93 |
|
|
#define SAA7191_GAIN_LFIS_0 0x00
|
94 |
|
|
|
95 |
|
|
/* Standard/Mode Control Register definitions */
|
96 |
|
|
/* tv/vtr mode bit: 0=TV mode (slow time constant),
|
97 |
|
|
* 1=VTR mode (fast time constant) */
|
98 |
|
|
#define SAA7191_STDC_VTRC 0x80
|
99 |
|
|
/* SAA7191B-specific functions enable (RTCO, ODD and GPSW0 outputs)
|
100 |
|
|
* 0=outputs set to high-impedance (circuit equals SAA7191), 1=enabled */
|
101 |
|
|
#define SAA7191_STDC_NFEN 0x08
|
102 |
|
|
/* HREF generation: 0=like SAA7191, 1=HREF is 8xLLC2 clocks earlier */
|
103 |
|
|
#define SAA7191_STDC_HRMV 0x04
|
104 |
|
|
/* general purpose switch 0
|
105 |
|
|
* (not used with VINO afaik) */
|
106 |
|
|
#define SAA7191_STDC_GPSW0 0x02
|
107 |
|
|
/* SECAM mode bit: 0=other standards, 1=SECAM */
|
108 |
|
|
#define SAA7191_STDC_SECS 0x01
|
109 |
|
|
|
110 |
|
|
/* I/O and Clock Control Register definitions */
|
111 |
|
|
/* horizontal clock PLL: 0=PLL closed,
|
112 |
|
|
* 1=PLL circuit open and horizontal freq fixed */
|
113 |
|
|
#define SAA7191_IOCK_HPLL 0x80
|
114 |
|
|
/* colour-difference output enable (outputs UV0-UV7) */
|
115 |
|
|
#define SAA7191_IOCK_OEDC 0x40
|
116 |
|
|
/* H-sync output enable */
|
117 |
|
|
#define SAA7191_IOCK_OEHS 0x20
|
118 |
|
|
/* V-sync output enable */
|
119 |
|
|
#define SAA7191_IOCK_OEVS 0x10
|
120 |
|
|
/* luminance output enable (outputs Y0-Y7) */
|
121 |
|
|
#define SAA7191_IOCK_OEDY 0x08
|
122 |
|
|
/* S-VHS bit (chrominance from CVBS or from chrominance input):
|
123 |
|
|
* 0=controlled by BYPS-bit, 1=from chrominance input */
|
124 |
|
|
#define SAA7191_IOCK_CHRS 0x04
|
125 |
|
|
/* general purpose switch 2
|
126 |
|
|
* VINO-specific: 0=used with CVBS, 1=used with S-Video */
|
127 |
|
|
#define SAA7191_IOCK_GPSW2 0x02
|
128 |
|
|
/* general purpose switch 1 */
|
129 |
|
|
/* VINO-specific: 0=always, 1=not used!*/
|
130 |
|
|
#define SAA7191_IOCK_GPSW1 0x01
|
131 |
|
|
|
132 |
|
|
/* Miscellaneous Control #1 Register definitions */
|
133 |
|
|
/* automatic field detection (50/60Hz standard) */
|
134 |
|
|
#define SAA7191_CTL3_AUFD 0x80
|
135 |
|
|
/* field select: (if AUFD=0)
|
136 |
|
|
* 0=50Hz (625 lines), 1=60Hz (525 lines) */
|
137 |
|
|
#define SAA7191_CTL3_FSEL 0x40
|
138 |
|
|
/* SECAM cross-colour reduction enable */
|
139 |
|
|
#define SAA7191_CTL3_SXCR 0x20
|
140 |
|
|
/* sync and clamping pulse enable (HCL and HSY outputs) */
|
141 |
|
|
#define SAA7191_CTL3_SCEN 0x10
|
142 |
|
|
/* output format: 0=4:1:1, 1=4:2:2 (4:2:2 for VINO) */
|
143 |
|
|
#define SAA7191_CTL3_OFTS 0x08
|
144 |
|
|
/* luminance delay compensation
|
145 |
|
|
* 0=0*2/LLC, 1=+1*2/LLC, 2=+2*2/LLC, 3=+3*2/LLC,
|
146 |
|
|
* 4=-4*2/LLC, 5=-3*2/LLC, 6=-2*2/LLC, 7=-1*2/LLC
|
147 |
|
|
* step size = 2/LLC = 67.8ns for 50Hz, 81.5ns for 60Hz */
|
148 |
|
|
#define SAA7191_CTL3_YDEL_MASK 0x07
|
149 |
|
|
#define SAA7191_CTL3_YDEL_SHIFT 0
|
150 |
|
|
#define SAA7191_CTL3_YDEL2 0x04
|
151 |
|
|
#define SAA7191_CTL3_YDEL1 0x02
|
152 |
|
|
#define SAA7191_CTL3_YDEL0 0x01
|
153 |
|
|
|
154 |
|
|
/* Miscellaneous Control #2 Register definitions */
|
155 |
|
|
/* select HREF position
|
156 |
|
|
* 0=normal, HREF is matched to YUV output port,
|
157 |
|
|
* 1=HREF is matched to CVBS input port */
|
158 |
|
|
#define SAA7191_CTL4_HRFS 0x04
|
159 |
|
|
/* vertical noise reduction
|
160 |
|
|
* 0=normal, 1=searching window, 2=auto-deflection, 3=reduction bypassed */
|
161 |
|
|
#define SAA7191_CTL4_VNOI_MASK 0x03
|
162 |
|
|
#define SAA7191_CTL4_VNOI_SHIFT 0
|
163 |
|
|
#define SAA7191_CTL4_VNOI_3 0x03
|
164 |
|
|
#define SAA7191_CTL4_VNOI_2 0x02
|
165 |
|
|
#define SAA7191_CTL4_VNOI_1 0x01
|
166 |
|
|
#define SAA7191_CTL4_VNOI_0 0x00
|
167 |
|
|
|
168 |
|
|
/* Chrominance Gain Control Register definitions
|
169 |
|
|
* - for QAM-modulated input signals, effects output amplitude
|
170 |
|
|
* (SECAM gain fixed)
|
171 |
|
|
* (nominal values for UV CCIR level) */
|
172 |
|
|
#define SAA7191_CHCV_NTSC 0x2c
|
173 |
|
|
#define SAA7191_CHCV_PAL 0x59
|
174 |
|
|
|
175 |
|
|
/* Driver interface definitions */
|
176 |
|
|
#define SAA7191_INPUT_COMPOSITE 0
|
177 |
|
|
#define SAA7191_INPUT_SVIDEO 1
|
178 |
|
|
|
179 |
|
|
#define SAA7191_NORM_AUTO 0
|
180 |
|
|
#define SAA7191_NORM_PAL 1
|
181 |
|
|
#define SAA7191_NORM_NTSC 2
|
182 |
|
|
#define SAA7191_NORM_SECAM 3
|
183 |
|
|
#define SAA7191_NORM_AUTO_EXT 4 /* extended auto-detection */
|
184 |
|
|
|
185 |
|
|
struct saa7191_status {
|
186 |
|
|
/* 0=no signal, 1=signal detected */
|
187 |
|
|
int signal;
|
188 |
|
|
/* 0=50hz (pal) signal, 1=60hz (ntsc) signal */
|
189 |
|
|
int signal_60hz;
|
190 |
|
|
/* 0=no color detected, 1=color detected */
|
191 |
|
|
int color;
|
192 |
|
|
|
193 |
|
|
/* current SAA7191_INPUT_ */
|
194 |
|
|
int input;
|
195 |
|
|
/* current SAA7191_NORM_ */
|
196 |
|
|
int norm;
|
197 |
|
|
};
|
198 |
|
|
|
199 |
|
|
#define SAA7191_BANDPASS_MIN 0x00
|
200 |
|
|
#define SAA7191_BANDPASS_MAX 0x03
|
201 |
|
|
#define SAA7191_BANDPASS_DEFAULT 0x00
|
202 |
|
|
|
203 |
|
|
#define SAA7191_BANDPASS_WEIGHT_MIN 0x00
|
204 |
|
|
#define SAA7191_BANDPASS_WEIGHT_MAX 0x03
|
205 |
|
|
#define SAA7191_BANDPASS_WEIGHT_DEFAULT 0x01
|
206 |
|
|
|
207 |
|
|
#define SAA7191_CORING_MIN 0x00
|
208 |
|
|
#define SAA7191_CORING_MAX 0x03
|
209 |
|
|
#define SAA7191_CORING_DEFAULT 0x00
|
210 |
|
|
|
211 |
|
|
#define SAA7191_HUE_MIN 0x00
|
212 |
|
|
#define SAA7191_HUE_MAX 0xff
|
213 |
|
|
#define SAA7191_HUE_DEFAULT 0x80
|
214 |
|
|
|
215 |
|
|
#define SAA7191_VTRC_MIN 0x00
|
216 |
|
|
#define SAA7191_VTRC_MAX 0x01
|
217 |
|
|
#define SAA7191_VTRC_DEFAULT 0x00
|
218 |
|
|
|
219 |
|
|
#define SAA7191_FORCE_COLOUR_MIN 0x00
|
220 |
|
|
#define SAA7191_FORCE_COLOUR_MAX 0x01
|
221 |
|
|
#define SAA7191_FORCE_COLOUR_DEFAULT 0x00
|
222 |
|
|
|
223 |
|
|
#define SAA7191_CHROMA_GAIN_MIN 0x00
|
224 |
|
|
#define SAA7191_CHROMA_GAIN_MAX 0x03
|
225 |
|
|
#define SAA7191_CHROMA_GAIN_DEFAULT 0x00
|
226 |
|
|
|
227 |
|
|
#define SAA7191_LUMA_DELAY_MIN -0x04
|
228 |
|
|
#define SAA7191_LUMA_DELAY_MAX 0x03
|
229 |
|
|
#define SAA7191_LUMA_DELAY_DEFAULT 0x01
|
230 |
|
|
|
231 |
|
|
#define SAA7191_VNR_MIN 0x00
|
232 |
|
|
#define SAA7191_VNR_MAX 0x03
|
233 |
|
|
#define SAA7191_VNR_DEFAULT 0x00
|
234 |
|
|
|
235 |
|
|
#define SAA7191_CONTROL_BANDPASS 0
|
236 |
|
|
#define SAA7191_CONTROL_BANDPASS_WEIGHT 1
|
237 |
|
|
#define SAA7191_CONTROL_CORING 2
|
238 |
|
|
#define SAA7191_CONTROL_FORCE_COLOUR 3 /* boolean */
|
239 |
|
|
#define SAA7191_CONTROL_CHROMA_GAIN 4
|
240 |
|
|
#define SAA7191_CONTROL_HUE 5
|
241 |
|
|
#define SAA7191_CONTROL_VTRC 6 /* boolean */
|
242 |
|
|
#define SAA7191_CONTROL_LUMA_DELAY 7
|
243 |
|
|
#define SAA7191_CONTROL_VNR 8
|
244 |
|
|
|
245 |
|
|
struct saa7191_control {
|
246 |
|
|
u8 type;
|
247 |
|
|
s32 value;
|
248 |
|
|
};
|
249 |
|
|
|
250 |
|
|
#define DECODER_SAA7191_GET_STATUS _IOR('d', 195, struct saa7191_status)
|
251 |
|
|
#define DECODER_SAA7191_SET_NORM _IOW('d', 196, int)
|
252 |
|
|
#define DECODER_SAA7191_GET_CONTROL _IOR('d', 197, struct saa7191_control)
|
253 |
|
|
#define DECODER_SAA7191_SET_CONTROL _IOW('d', 198, struct saa7191_control)
|
254 |
|
|
|
255 |
|
|
#endif
|