V4L/DVB (3269): Allow multiple tuner params in each tuner definition
[linux-2.6] / drivers / media / video / tuner-simple.c
1 /*
2  *
3  * i2c tv tuner chip device driver
4  * controls all those simple 4-control-bytes style tuners.
5  */
6 #include <linux/delay.h>
7 #include <linux/i2c.h>
8 #include <linux/videodev.h>
9 #include <media/tuner.h>
10
11 static int offset = 0;
12 module_param(offset, int, 0666);
13 MODULE_PARM_DESC(offset,"Allows to specify an offset for tuner");
14
15 /* ---------------------------------------------------------------------- */
16
17 /* tv standard selection for Temic 4046 FM5
18    this value takes the low bits of control byte 2
19    from datasheet Rev.01, Feb.00
20      standard     BG      I       L       L2      D
21      picture IF   38.9    38.9    38.9    33.95   38.9
22      sound 1      33.4    32.9    32.4    40.45   32.4
23      sound 2      33.16
24      NICAM        33.05   32.348  33.05           33.05
25  */
26 #define TEMIC_SET_PAL_I         0x05
27 #define TEMIC_SET_PAL_DK        0x09
28 #define TEMIC_SET_PAL_L         0x0a // SECAM ?
29 #define TEMIC_SET_PAL_L2        0x0b // change IF !
30 #define TEMIC_SET_PAL_BG        0x0c
31
32 /* tv tuner system standard selection for Philips FQ1216ME
33    this value takes the low bits of control byte 2
34    from datasheet "1999 Nov 16" (supersedes "1999 Mar 23")
35      standard           BG      DK      I       L       L`
36      picture carrier    38.90   38.90   38.90   38.90   33.95
37      colour             34.47   34.47   34.47   34.47   38.38
38      sound 1            33.40   32.40   32.90   32.40   40.45
39      sound 2            33.16   -       -       -       -
40      NICAM              33.05   33.05   32.35   33.05   39.80
41  */
42 #define PHILIPS_SET_PAL_I       0x01 /* Bit 2 always zero !*/
43 #define PHILIPS_SET_PAL_BGDK    0x09
44 #define PHILIPS_SET_PAL_L2      0x0a
45 #define PHILIPS_SET_PAL_L       0x0b
46
47 /* system switching for Philips FI1216MF MK2
48    from datasheet "1996 Jul 09",
49     standard         BG     L      L'
50     picture carrier  38.90  38.90  33.95
51     colour           34.47  34.37  38.38
52     sound 1          33.40  32.40  40.45
53     sound 2          33.16  -      -
54     NICAM            33.05  33.05  39.80
55  */
56 #define PHILIPS_MF_SET_BG       0x01 /* Bit 2 must be zero, Bit 3 is system output */
57 #define PHILIPS_MF_SET_PAL_L    0x03 // France
58 #define PHILIPS_MF_SET_PAL_L2   0x02 // L'
59
60 /* Control byte */
61
62 #define TUNER_RATIO_MASK        0x06 /* Bit cb1:cb2 */
63 #define TUNER_RATIO_SELECT_50   0x00
64 #define TUNER_RATIO_SELECT_32   0x02
65 #define TUNER_RATIO_SELECT_166  0x04
66 #define TUNER_RATIO_SELECT_62   0x06
67
68 #define TUNER_CHARGE_PUMP       0x40  /* Bit cb6 */
69
70 /* Status byte */
71
72 #define TUNER_POR         0x80
73 #define TUNER_FL          0x40
74 #define TUNER_MODE        0x38
75 #define TUNER_AFC         0x07
76 #define TUNER_SIGNAL      0x07
77 #define TUNER_STEREO      0x10
78
79 #define TUNER_PLL_LOCKED   0x40
80 #define TUNER_STEREO_MK3   0x04
81
82 /* FIXME:
83  * Right now, all tuners are using the first tuner_params[] array element
84  * for analog mode. In the future, we will be merging similar tuner
85  * definitions together, such that each tuner definition will have a
86  * tuner_params struct for each available video standard. At that point,
87  * the tuner_params[] array element will be chosen based on the video
88  * standard in use.
89  *
90  */
91
92 /* ---------------------------------------------------------------------- */
93
94 static int tuner_getstatus(struct i2c_client *c)
95 {
96         unsigned char byte;
97
98         if (1 != i2c_master_recv(c,&byte,1))
99                 return 0;
100
101         return byte;
102 }
103
104 static int tuner_signal(struct i2c_client *c)
105 {
106         return (tuner_getstatus(c) & TUNER_SIGNAL) << 13;
107 }
108
109 static int tuner_stereo(struct i2c_client *c)
110 {
111         int stereo, status;
112         struct tuner *t = i2c_get_clientdata(c);
113
114         status = tuner_getstatus (c);
115
116         switch (t->type) {
117                 case TUNER_PHILIPS_FM1216ME_MK3:
118                 case TUNER_PHILIPS_FM1236_MK3:
119                 case TUNER_PHILIPS_FM1256_IH3:
120                         stereo = ((status & TUNER_SIGNAL) == TUNER_STEREO_MK3);
121                         break;
122                 default:
123                         stereo = status & TUNER_STEREO;
124         }
125
126         return stereo;
127 }
128
129
130 /* ---------------------------------------------------------------------- */
131
132 static void default_set_tv_freq(struct i2c_client *c, unsigned int freq)
133 {
134         struct tuner *t = i2c_get_clientdata(c);
135         u8 config, cb, tuneraddr;
136         u16 div;
137         struct tunertype *tun;
138         u8 buffer[4];
139         int rc, IFPCoff, i, j;
140         enum param_type desired_type;
141
142         tun = &tuners[t->type];
143
144         /* IFPCoff = Video Intermediate Frequency - Vif:
145                 940  =16*58.75  NTSC/J (Japan)
146                 732  =16*45.75  M/N STD
147                 704  =16*44     ATSC (at DVB code)
148                 632  =16*39.50  I U.K.
149                 622.4=16*38.90  B/G D/K I, L STD
150                 592  =16*37.00  D China
151                 590  =16.36.875 B Australia
152                 543.2=16*33.95  L' STD
153                 171.2=16*10.70  FM Radio (at set_radio_freq)
154         */
155
156         if (t->std == V4L2_STD_NTSC_M_JP) {
157                 IFPCoff      = 940;
158                 desired_type = TUNER_PARAM_TYPE_NTSC;
159         } else if ((t->std & V4L2_STD_MN) &&
160                   !(t->std & ~V4L2_STD_MN)) {
161                 IFPCoff      = 732;
162                 desired_type = TUNER_PARAM_TYPE_NTSC;
163         } else if (t->std == V4L2_STD_SECAM_LC) {
164                 IFPCoff      = 543;
165                 desired_type = TUNER_PARAM_TYPE_SECAM;
166         } else {
167                 IFPCoff      = 623;
168                 desired_type = TUNER_PARAM_TYPE_PAL;
169         }
170
171         for (j = 0; j < tun->count-1; j++) {
172                 if (desired_type != tun->params[j].type)
173                         continue;
174                 break;
175         }
176         for (i = 0; i < tun->params[j].count; i++) {
177                 if (freq > tun->params[j].ranges[i].limit)
178                         continue;
179                 break;
180         }
181         if (i == tun->params[j].count) {
182                 tuner_dbg("TV frequency out of range (%d > %d)",
183                                 freq, tun->params[j].ranges[i - 1].limit);
184                 freq = tun->params[j].ranges[--i].limit;
185         }
186         config = tun->params[j].ranges[i].config;
187         cb     = tun->params[j].ranges[i].cb;
188         /*  i == 0 -> VHF_LO
189          *  i == 1 -> VHF_HI
190          *  i == 2 -> UHF     */
191         tuner_dbg("tv: range %d\n",i);
192
193         div=freq + IFPCoff + offset;
194
195         tuner_dbg("Freq= %d.%02d MHz, V_IF=%d.%02d MHz, Offset=%d.%02d MHz, div=%0d\n",
196                                         freq / 16, freq % 16 * 100 / 16,
197                                         IFPCoff / 16, IFPCoff % 16 * 100 / 16,
198                                         offset / 16, offset % 16 * 100 / 16,
199                                         div);
200
201         /* tv norm specific stuff for multi-norm tuners */
202         switch (t->type) {
203         case TUNER_PHILIPS_SECAM: // FI1216MF
204                 /* 0x01 -> ??? no change ??? */
205                 /* 0x02 -> PAL BDGHI / SECAM L */
206                 /* 0x04 -> ??? PAL others / SECAM others ??? */
207                 cb &= ~0x02;
208                 if (t->std & V4L2_STD_SECAM)
209                         cb |= 0x02;
210                 break;
211
212         case TUNER_TEMIC_4046FM5:
213                 cb &= ~0x0f;
214
215                 if (t->std & V4L2_STD_PAL_BG) {
216                         cb |= TEMIC_SET_PAL_BG;
217
218                 } else if (t->std & V4L2_STD_PAL_I) {
219                         cb |= TEMIC_SET_PAL_I;
220
221                 } else if (t->std & V4L2_STD_PAL_DK) {
222                         cb |= TEMIC_SET_PAL_DK;
223
224                 } else if (t->std & V4L2_STD_SECAM_L) {
225                         cb |= TEMIC_SET_PAL_L;
226
227                 }
228                 break;
229
230         case TUNER_PHILIPS_FQ1216ME:
231                 cb &= ~0x0f;
232
233                 if (t->std & (V4L2_STD_PAL_BG|V4L2_STD_PAL_DK)) {
234                         cb |= PHILIPS_SET_PAL_BGDK;
235
236                 } else if (t->std & V4L2_STD_PAL_I) {
237                         cb |= PHILIPS_SET_PAL_I;
238
239                 } else if (t->std & V4L2_STD_SECAM_L) {
240                         cb |= PHILIPS_SET_PAL_L;
241
242                 }
243                 break;
244
245         case TUNER_PHILIPS_ATSC:
246                 /* 0x00 -> ATSC antenna input 1 */
247                 /* 0x01 -> ATSC antenna input 2 */
248                 /* 0x02 -> NTSC antenna input 1 */
249                 /* 0x03 -> NTSC antenna input 2 */
250                 cb &= ~0x03;
251                 if (!(t->std & V4L2_STD_ATSC))
252                         cb |= 2;
253                 /* FIXME: input */
254                 break;
255
256         case TUNER_MICROTUNE_4042FI5:
257                 /* Set the charge pump for fast tuning */
258                 config |= TUNER_CHARGE_PUMP;
259                 break;
260
261         case TUNER_PHILIPS_TUV1236D:
262                 /* 0x40 -> ATSC antenna input 1 */
263                 /* 0x48 -> ATSC antenna input 2 */
264                 /* 0x00 -> NTSC antenna input 1 */
265                 /* 0x08 -> NTSC antenna input 2 */
266                 buffer[0] = 0x14;
267                 buffer[1] = 0x00;
268                 buffer[2] = 0x17;
269                 buffer[3] = 0x00;
270                 cb &= ~0x40;
271                 if (t->std & V4L2_STD_ATSC) {
272                         cb |= 0x40;
273                         buffer[1] = 0x04;
274                 }
275                 /* set to the correct mode (analog or digital) */
276                 tuneraddr = c->addr;
277                 c->addr = 0x0a;
278                 if (2 != (rc = i2c_master_send(c,&buffer[0],2)))
279                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
280                 if (2 != (rc = i2c_master_send(c,&buffer[2],2)))
281                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
282                 c->addr = tuneraddr;
283                 /* FIXME: input */
284                 break;
285         }
286
287         if (tuners[t->type].params->cb_first_if_lower_freq && div < t->last_div) {
288                 buffer[0] = config;
289                 buffer[1] = cb;
290                 buffer[2] = (div>>8) & 0x7f;
291                 buffer[3] = div      & 0xff;
292         } else {
293                 buffer[0] = (div>>8) & 0x7f;
294                 buffer[1] = div      & 0xff;
295                 buffer[2] = config;
296                 buffer[3] = cb;
297         }
298         t->last_div = div;
299         tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
300                   buffer[0],buffer[1],buffer[2],buffer[3]);
301
302         if (4 != (rc = i2c_master_send(c,buffer,4)))
303                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
304
305         if (t->type == TUNER_MICROTUNE_4042FI5) {
306                 // FIXME - this may also work for other tuners
307                 unsigned long timeout = jiffies + msecs_to_jiffies(1);
308                 u8 status_byte = 0;
309
310                 /* Wait until the PLL locks */
311                 for (;;) {
312                         if (time_after(jiffies,timeout))
313                                 return;
314                         if (1 != (rc = i2c_master_recv(c,&status_byte,1))) {
315                                 tuner_warn("i2c i/o read error: rc == %d (should be 1)\n",rc);
316                                 break;
317                         }
318                         if (status_byte & TUNER_PLL_LOCKED)
319                                 break;
320                         udelay(10);
321                 }
322
323                 /* Set the charge pump for optimized phase noise figure */
324                 config &= ~TUNER_CHARGE_PUMP;
325                 buffer[0] = (div>>8) & 0x7f;
326                 buffer[1] = div      & 0xff;
327                 buffer[2] = config;
328                 buffer[3] = cb;
329                 tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
330                        buffer[0],buffer[1],buffer[2],buffer[3]);
331
332                 if (4 != (rc = i2c_master_send(c,buffer,4)))
333                         tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
334         }
335 }
336
337 static void default_set_radio_freq(struct i2c_client *c, unsigned int freq)
338 {
339         struct tunertype *tun;
340         struct tuner *t = i2c_get_clientdata(c);
341         u8 buffer[4];
342         u16 div;
343         int rc, j;
344         enum param_type desired_type = TUNER_PARAM_TYPE_RADIO;
345
346         tun = &tuners[t->type];
347
348         for (j = 0; j < tun->count-1; j++) {
349                 if (desired_type != tun->params[j].type)
350                         continue;
351                 break;
352         }
353
354         div = (20 * freq / 16000) + (int)(20*10.7); /* IF 10.7 MHz */
355         buffer[2] = (tun->params[j].ranges[0].config & ~TUNER_RATIO_MASK) | TUNER_RATIO_SELECT_50; /* 50 kHz step */
356
357         switch (t->type) {
358         case TUNER_TENA_9533_DI:
359         case TUNER_YMEC_TVF_5533MF:
360                 tuner_dbg ("This tuner doesn't have FM. Most cards has a TEA5767 for FM\n");
361                 return;
362         case TUNER_PHILIPS_FM1216ME_MK3:
363         case TUNER_PHILIPS_FM1236_MK3:
364         case TUNER_PHILIPS_FMD1216ME_MK3:
365                 buffer[3] = 0x19;
366                 break;
367         case TUNER_PHILIPS_FM1256_IH3:
368                 div = (20 * freq) / 16000 + (int)(33.3 * 20);  /* IF 33.3 MHz */
369                 buffer[3] = 0x19;
370                 break;
371         case TUNER_LG_PAL_FM:
372                 buffer[3] = 0xa5;
373                 break;
374         case TUNER_MICROTUNE_4049FM5:
375                 div = (20 * freq) / 16000 + (int)(33.3 * 20); /* IF 33.3 MHz */
376                 buffer[3] = 0xa4;
377                 break;
378         default:
379                 buffer[3] = 0xa4;
380                 break;
381         }
382         buffer[0] = (div>>8) & 0x7f;
383         buffer[1] = div      & 0xff;
384         if (tuners[t->type].params->cb_first_if_lower_freq && div < t->last_div) {
385                 buffer[0] = buffer[2];
386                 buffer[1] = buffer[3];
387                 buffer[2] = (div>>8) & 0x7f;
388                 buffer[3] = div      & 0xff;
389         } else {
390                 buffer[0] = (div>>8) & 0x7f;
391                 buffer[1] = div      & 0xff;
392         }
393
394         tuner_dbg("radio 0x%02x 0x%02x 0x%02x 0x%02x\n",
395                buffer[0],buffer[1],buffer[2],buffer[3]);
396         t->last_div = div;
397
398         if (4 != (rc = i2c_master_send(c,buffer,4)))
399                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
400 }
401
402 int default_tuner_init(struct i2c_client *c)
403 {
404         struct tuner *t = i2c_get_clientdata(c);
405
406         tuner_info("type set to %d (%s)\n",
407                    t->type, tuners[t->type].name);
408         strlcpy(c->name, tuners[t->type].name, sizeof(c->name));
409
410         t->set_tv_freq = default_set_tv_freq;
411         t->set_radio_freq = default_set_radio_freq;
412         t->has_signal = tuner_signal;
413         t->is_stereo = tuner_stereo;
414         t->standby = NULL;
415
416         return 0;
417 }
418
419 /*
420  * Overrides for Emacs so that we follow Linus's tabbing style.
421  * ---------------------------------------------------------------------------
422  * Local variables:
423  * c-basic-offset: 8
424  * End:
425  */