tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1#include <linux/module.h>
2#include <linux/moduleparam.h>
3#include <linux/kernel.h>
4#include <linux/i2c.h>
5#include <linux/types.h>
6#include <linux/videodev.h>
7#include <linux/init.h>
8#include <linux/errno.h>
9#include <linux/slab.h>
10#include <linux/delay.h>
11
12#include <media/v4l2-common.h>
13#include <media/tuner.h>
14
15
16/* Chips:
17 TDA9885 (PAL, NTSC)
18 TDA9886 (PAL, SECAM, NTSC)
19 TDA9887 (PAL, SECAM, NTSC, FM Radio)
20
21 Used as part of several tuners
22*/
23
24#define tda9887_info(fmt, arg...) do {\
25 printk(KERN_INFO "%s %d-%04x: " fmt, t->i2c.name, \
26 i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
27#define tda9887_dbg(fmt, arg...) do {\
28 if (tuner_debug) \
29 printk(KERN_INFO "%s %d-%04x: " fmt, t->i2c.name, \
30 i2c_adapter_id(t->i2c.adapter), t->i2c.addr , ##arg); } while (0)
31
32
33/* ---------------------------------------------------------------------- */
34
35#define UNSET (-1U)
36
37struct tvnorm {
38 v4l2_std_id std;
39 char *name;
40 unsigned char b;
41 unsigned char c;
42 unsigned char e;
43};
44
45/* ---------------------------------------------------------------------- */
46
47//
48// TDA defines
49//
50
51//// first reg (b)
52#define cVideoTrapBypassOFF 0x00 // bit b0
53#define cVideoTrapBypassON 0x01 // bit b0
54
55#define cAutoMuteFmInactive 0x00 // bit b1
56#define cAutoMuteFmActive 0x02 // bit b1
57
58#define cIntercarrier 0x00 // bit b2
59#define cQSS 0x04 // bit b2
60
61#define cPositiveAmTV 0x00 // bit b3:4
62#define cFmRadio 0x08 // bit b3:4
63#define cNegativeFmTV 0x10 // bit b3:4
64
65
66#define cForcedMuteAudioON 0x20 // bit b5
67#define cForcedMuteAudioOFF 0x00 // bit b5
68
69#define cOutputPort1Active 0x00 // bit b6
70#define cOutputPort1Inactive 0x40 // bit b6
71
72#define cOutputPort2Active 0x00 // bit b7
73#define cOutputPort2Inactive 0x80 // bit b7
74
75
76//// second reg (c)
77#define cDeemphasisOFF 0x00 // bit c5
78#define cDeemphasisON 0x20 // bit c5
79
80#define cDeemphasis75 0x00 // bit c6
81#define cDeemphasis50 0x40 // bit c6
82
83#define cAudioGain0 0x00 // bit c7
84#define cAudioGain6 0x80 // bit c7
85
86#define cTopMask 0x1f // bit c0:4
87#define cTopDefault 0x10 // bit c0:4
88
89//// third reg (e)
90#define cAudioIF_4_5 0x00 // bit e0:1
91#define cAudioIF_5_5 0x01 // bit e0:1
92#define cAudioIF_6_0 0x02 // bit e0:1
93#define cAudioIF_6_5 0x03 // bit e0:1
94
95
96#define cVideoIF_58_75 0x00 // bit e2:4
97#define cVideoIF_45_75 0x04 // bit e2:4
98#define cVideoIF_38_90 0x08 // bit e2:4
99#define cVideoIF_38_00 0x0C // bit e2:4
100#define cVideoIF_33_90 0x10 // bit e2:4
101#define cVideoIF_33_40 0x14 // bit e2:4
102#define cRadioIF_45_75 0x18 // bit e2:4
103#define cRadioIF_38_90 0x1C // bit e2:4
104
105
106#define cTunerGainNormal 0x00 // bit e5
107#define cTunerGainLow 0x20 // bit e5
108
109#define cGating_18 0x00 // bit e6
110#define cGating_36 0x40 // bit e6
111
112#define cAgcOutON 0x80 // bit e7
113#define cAgcOutOFF 0x00 // bit e7
114
115/* ---------------------------------------------------------------------- */
116
117static struct tvnorm tvnorms[] = {
118 {
119 .std = V4L2_STD_PAL_BG | V4L2_STD_PAL_H | V4L2_STD_PAL_N,
120 .name = "PAL-BGHN",
121 .b = ( cNegativeFmTV |
122 cQSS ),
123 .c = ( cDeemphasisON |
124 cDeemphasis50 |
125 cTopDefault),
126 .e = ( cGating_36 |
127 cAudioIF_5_5 |
128 cVideoIF_38_90 ),
129 },{
130 .std = V4L2_STD_PAL_I,
131 .name = "PAL-I",
132 .b = ( cNegativeFmTV |
133 cQSS ),
134 .c = ( cDeemphasisON |
135 cDeemphasis50 |
136 cTopDefault),
137 .e = ( cGating_36 |
138 cAudioIF_6_0 |
139 cVideoIF_38_90 ),
140 },{
141 .std = V4L2_STD_PAL_DK,
142 .name = "PAL-DK",
143 .b = ( cNegativeFmTV |
144 cQSS ),
145 .c = ( cDeemphasisON |
146 cDeemphasis50 |
147 cTopDefault),
148 .e = ( cGating_36 |
149 cAudioIF_6_5 |
150 cVideoIF_38_90 ),
151 },{
152 .std = V4L2_STD_PAL_M | V4L2_STD_PAL_Nc,
153 .name = "PAL-M/Nc",
154 .b = ( cNegativeFmTV |
155 cQSS ),
156 .c = ( cDeemphasisON |
157 cDeemphasis75 |
158 cTopDefault),
159 .e = ( cGating_36 |
160 cAudioIF_4_5 |
161 cVideoIF_45_75 ),
162 },{
163 .std = V4L2_STD_SECAM_B | V4L2_STD_SECAM_G | V4L2_STD_SECAM_H,
164 .name = "SECAM-BGH",
165 .b = ( cPositiveAmTV |
166 cQSS ),
167 .c = ( cTopDefault),
168 .e = ( cGating_36 |
169 cAudioIF_5_5 |
170 cVideoIF_38_90 ),
171 },{
172 .std = V4L2_STD_SECAM_L,
173 .name = "SECAM-L",
174 .b = ( cPositiveAmTV |
175 cQSS ),
176 .c = ( cTopDefault),
177 .e = ( cGating_36 |
178 cAudioIF_6_5 |
179 cVideoIF_38_90 ),
180 },{
181 .std = V4L2_STD_SECAM_LC,
182 .name = "SECAM-L'",
183 .b = ( cOutputPort2Inactive |
184 cPositiveAmTV |
185 cQSS ),
186 .c = ( cTopDefault),
187 .e = ( cGating_36 |
188 cAudioIF_6_5 |
189 cVideoIF_33_90 ),
190 },{
191 .std = V4L2_STD_SECAM_DK,
192 .name = "SECAM-DK",
193 .b = ( cNegativeFmTV |
194 cQSS ),
195 .c = ( cDeemphasisON |
196 cDeemphasis50 |
197 cTopDefault),
198 .e = ( cGating_36 |
199 cAudioIF_6_5 |
200 cVideoIF_38_90 ),
201 },{
202 .std = V4L2_STD_NTSC_M | V4L2_STD_NTSC_M_KR,
203 .name = "NTSC-M",
204 .b = ( cNegativeFmTV |
205 cQSS ),
206 .c = ( cDeemphasisON |
207 cDeemphasis75 |
208 cTopDefault),
209 .e = ( cGating_36 |
210 cAudioIF_4_5 |
211 cVideoIF_45_75 ),
212 },{
213 .std = V4L2_STD_NTSC_M_JP,
214 .name = "NTSC-M-JP",
215 .b = ( cNegativeFmTV |
216 cQSS ),
217 .c = ( cDeemphasisON |
218 cDeemphasis50 |
219 cTopDefault),
220 .e = ( cGating_36 |
221 cAudioIF_4_5 |
222 cVideoIF_58_75 ),
223 }
224};
225
226static struct tvnorm radio_stereo = {
227 .name = "Radio Stereo",
228 .b = ( cFmRadio |
229 cQSS ),
230 .c = ( cDeemphasisOFF |
231 cAudioGain6 |
232 cTopDefault),
233 .e = ( cTunerGainLow |
234 cAudioIF_5_5 |
235 cRadioIF_38_90 ),
236};
237
238static struct tvnorm radio_mono = {
239 .name = "Radio Mono",
240 .b = ( cFmRadio |
241 cQSS ),
242 .c = ( cDeemphasisON |
243 cDeemphasis75 |
244 cTopDefault),
245 .e = ( cTunerGainLow |
246 cAudioIF_5_5 |
247 cRadioIF_38_90 ),
248};
249
250/* ---------------------------------------------------------------------- */
251
252static void dump_read_message(struct tuner *t, unsigned char *buf)
253{
254 static char *afc[16] = {
255 "- 12.5 kHz",
256 "- 37.5 kHz",
257 "- 62.5 kHz",
258 "- 87.5 kHz",
259 "-112.5 kHz",
260 "-137.5 kHz",
261 "-162.5 kHz",
262 "-187.5 kHz [min]",
263 "+187.5 kHz [max]",
264 "+162.5 kHz",
265 "+137.5 kHz",
266 "+112.5 kHz",
267 "+ 87.5 kHz",
268 "+ 62.5 kHz",
269 "+ 37.5 kHz",
270 "+ 12.5 kHz",
271 };
272 tda9887_info("read: 0x%2x\n", buf[0]);
273 tda9887_info(" after power on : %s\n", (buf[0] & 0x01) ? "yes" : "no");
274 tda9887_info(" afc : %s\n", afc[(buf[0] >> 1) & 0x0f]);
275 tda9887_info(" fmif level : %s\n", (buf[0] & 0x20) ? "high" : "low");
276 tda9887_info(" afc window : %s\n", (buf[0] & 0x40) ? "in" : "out");
277 tda9887_info(" vfi level : %s\n", (buf[0] & 0x80) ? "high" : "low");
278}
279
280static void dump_write_message(struct tuner *t, unsigned char *buf)
281{
282 static char *sound[4] = {
283 "AM/TV",
284 "FM/radio",
285 "FM/TV",
286 "FM/radio"
287 };
288 static char *adjust[32] = {
289 "-16", "-15", "-14", "-13", "-12", "-11", "-10", "-9",
290 "-8", "-7", "-6", "-5", "-4", "-3", "-2", "-1",
291 "0", "+1", "+2", "+3", "+4", "+5", "+6", "+7",
292 "+8", "+9", "+10", "+11", "+12", "+13", "+14", "+15"
293 };
294 static char *deemph[4] = {
295 "no", "no", "75", "50"
296 };
297 static char *carrier[4] = {
298 "4.5 MHz",
299 "5.5 MHz",
300 "6.0 MHz",
301 "6.5 MHz / AM"
302 };
303 static char *vif[8] = {
304 "58.75 MHz",
305 "45.75 MHz",
306 "38.9 MHz",
307 "38.0 MHz",
308 "33.9 MHz",
309 "33.4 MHz",
310 "45.75 MHz + pin13",
311 "38.9 MHz + pin13",
312 };
313 static char *rif[4] = {
314 "44 MHz",
315 "52 MHz",
316 "52 MHz",
317 "44 MHz",
318 };
319
320 tda9887_info("write: byte B 0x%02x\n",buf[1]);
321 tda9887_info(" B0 video mode : %s\n",
322 (buf[1] & 0x01) ? "video trap" : "sound trap");
323 tda9887_info(" B1 auto mute fm : %s\n",
324 (buf[1] & 0x02) ? "yes" : "no");
325 tda9887_info(" B2 carrier mode : %s\n",
326 (buf[1] & 0x04) ? "QSS" : "Intercarrier");
327 tda9887_info(" B3-4 tv sound/radio : %s\n",
328 sound[(buf[1] & 0x18) >> 3]);
329 tda9887_info(" B5 force mute audio: %s\n",
330 (buf[1] & 0x20) ? "yes" : "no");
331 tda9887_info(" B6 output port 1 : %s\n",
332 (buf[1] & 0x40) ? "high (inactive)" : "low (active)");
333 tda9887_info(" B7 output port 2 : %s\n",
334 (buf[1] & 0x80) ? "high (inactive)" : "low (active)");
335
336 tda9887_info("write: byte C 0x%02x\n",buf[2]);
337 tda9887_info(" C0-4 top adjustment : %s dB\n", adjust[buf[2] & 0x1f]);
338 tda9887_info(" C5-6 de-emphasis : %s\n", deemph[(buf[2] & 0x60) >> 5]);
339 tda9887_info(" C7 audio gain : %s\n",
340 (buf[2] & 0x80) ? "-6" : "0");
341
342 tda9887_info("write: byte E 0x%02x\n",buf[3]);
343 tda9887_info(" E0-1 sound carrier : %s\n",
344 carrier[(buf[3] & 0x03)]);
345 tda9887_info(" E6 l pll gating : %s\n",
346 (buf[3] & 0x40) ? "36" : "13");
347
348 if (buf[1] & 0x08) {
349 /* radio */
350 tda9887_info(" E2-4 video if : %s\n",
351 rif[(buf[3] & 0x0c) >> 2]);
352 tda9887_info(" E7 vif agc output : %s\n",
353 (buf[3] & 0x80)
354 ? ((buf[3] & 0x10) ? "fm-agc radio" : "sif-agc radio")
355 : "fm radio carrier afc");
356 } else {
357 /* video */
358 tda9887_info(" E2-4 video if : %s\n",
359 vif[(buf[3] & 0x1c) >> 2]);
360 tda9887_info(" E5 tuner gain : %s\n",
361 (buf[3] & 0x80)
362 ? ((buf[3] & 0x20) ? "external" : "normal")
363 : ((buf[3] & 0x20) ? "minimum" : "normal"));
364 tda9887_info(" E7 vif agc output : %s\n",
365 (buf[3] & 0x80)
366 ? ((buf[3] & 0x20)
367 ? "pin3 port, pin22 vif agc out"
368 : "pin22 port, pin3 vif acg ext in")
369 : "pin3+pin22 port");
370 }
371 tda9887_info("--\n");
372}
373
374/* ---------------------------------------------------------------------- */
375
376static int tda9887_set_tvnorm(struct tuner *t, char *buf)
377{
378 struct tvnorm *norm = NULL;
379 int i;
380
381 if (t->mode == V4L2_TUNER_RADIO) {
382 if (t->audmode == V4L2_TUNER_MODE_MONO)
383 norm = &radio_mono;
384 else
385 norm = &radio_stereo;
386 } else {
387 for (i = 0; i < ARRAY_SIZE(tvnorms); i++) {
388 if (tvnorms[i].std & t->std) {
389 norm = tvnorms+i;
390 break;
391 }
392 }
393 }
394 if (NULL == norm) {
395 tda9887_dbg("Unsupported tvnorm entry - audio muted\n");
396 return -1;
397 }
398
399 tda9887_dbg("configure for: %s\n",norm->name);
400 buf[1] = norm->b;
401 buf[2] = norm->c;
402 buf[3] = norm->e;
403 return 0;
404}
405
406static unsigned int port1 = UNSET;
407static unsigned int port2 = UNSET;
408static unsigned int qss = UNSET;
409static unsigned int adjust = UNSET;
410
411module_param(port1, int, 0644);
412module_param(port2, int, 0644);
413module_param(qss, int, 0644);
414module_param(adjust, int, 0644);
415
416static int tda9887_set_insmod(struct tuner *t, char *buf)
417{
418 if (UNSET != port1) {
419 if (port1)
420 buf[1] |= cOutputPort1Inactive;
421 else
422 buf[1] &= ~cOutputPort1Inactive;
423 }
424 if (UNSET != port2) {
425 if (port2)
426 buf[1] |= cOutputPort2Inactive;
427 else
428 buf[1] &= ~cOutputPort2Inactive;
429 }
430
431 if (UNSET != qss) {
432 if (qss)
433 buf[1] |= cQSS;
434 else
435 buf[1] &= ~cQSS;
436 }
437
438 if (adjust >= 0x00 && adjust < 0x20) {
439 buf[2] &= ~cTopMask;
440 buf[2] |= adjust;
441 }
442 return 0;
443}
444
445static int tda9887_set_config(struct tuner *t, char *buf)
446{
447 if (t->tda9887_config & TDA9887_PORT1_ACTIVE)
448 buf[1] &= ~cOutputPort1Inactive;
449 if (t->tda9887_config & TDA9887_PORT1_INACTIVE)
450 buf[1] |= cOutputPort1Inactive;
451 if (t->tda9887_config & TDA9887_PORT2_ACTIVE)
452 buf[1] &= ~cOutputPort2Inactive;
453 if (t->tda9887_config & TDA9887_PORT2_INACTIVE)
454 buf[1] |= cOutputPort2Inactive;
455
456 if (t->tda9887_config & TDA9887_QSS)
457 buf[1] |= cQSS;
458 if (t->tda9887_config & TDA9887_INTERCARRIER)
459 buf[1] &= ~cQSS;
460
461 if (t->tda9887_config & TDA9887_AUTOMUTE)
462 buf[1] |= cAutoMuteFmActive;
463 if (t->tda9887_config & TDA9887_DEEMPHASIS_MASK) {
464 buf[2] &= ~0x60;
465 switch (t->tda9887_config & TDA9887_DEEMPHASIS_MASK) {
466 case TDA9887_DEEMPHASIS_NONE:
467 buf[2] |= cDeemphasisOFF;
468 break;
469 case TDA9887_DEEMPHASIS_50:
470 buf[2] |= cDeemphasisON | cDeemphasis50;
471 break;
472 case TDA9887_DEEMPHASIS_75:
473 buf[2] |= cDeemphasisON | cDeemphasis75;
474 break;
475 }
476 }
477 if (t->tda9887_config & TDA9887_TOP_SET) {
478 buf[2] &= ~cTopMask;
479 buf[2] |= (t->tda9887_config >> 8) & cTopMask;
480 }
481 if ((t->tda9887_config & TDA9887_INTERCARRIER_NTSC) && (t->std & V4L2_STD_NTSC))
482 buf[1] &= ~cQSS;
483 return 0;
484}
485
486/* ---------------------------------------------------------------------- */
487
488static int tda9887_status(struct tuner *t)
489{
490 unsigned char buf[1];
491 int rc;
492
493 memset(buf,0,sizeof(buf));
494 if (1 != (rc = i2c_master_recv(&t->i2c,buf,1)))
495 tda9887_info("i2c i/o error: rc == %d (should be 1)\n",rc);
496 dump_read_message(t, buf);
497 return 0;
498}
499
500static void tda9887_configure(struct i2c_client *client)
501{
502 struct tuner *t = i2c_get_clientdata(client);
503 int rc;
504
505 memset(t->tda9887_data,0,sizeof(t->tda9887_data));
506 tda9887_set_tvnorm(t,t->tda9887_data);
507
508 /* A note on the port settings:
509 These settings tend to depend on the specifics of the board.
510 By default they are set to inactive (bit value 1) by this driver,
511 overwriting any changes made by the tvnorm. This means that it
512 is the responsibility of the module using the tda9887 to set
513 these values in case of changes in the tvnorm.
514 In many cases port 2 should be made active (0) when selecting
515 SECAM-L, and port 2 should remain inactive (1) for SECAM-L'.
516
517 For the other standards the tda9887 application note says that
518 the ports should be set to active (0), but, again, that may
519 differ depending on the precise hardware configuration.
520 */
521 t->tda9887_data[1] |= cOutputPort1Inactive;
522 t->tda9887_data[1] |= cOutputPort2Inactive;
523
524 tda9887_set_config(t,t->tda9887_data);
525 tda9887_set_insmod(t,t->tda9887_data);
526
527 if (t->mode == T_STANDBY) {
528 t->tda9887_data[1] |= cForcedMuteAudioON;
529 }
530
531 tda9887_dbg("writing: b=0x%02x c=0x%02x e=0x%02x\n",
532 t->tda9887_data[1],t->tda9887_data[2],t->tda9887_data[3]);
533 if (tuner_debug > 1)
534 dump_write_message(t, t->tda9887_data);
535
536 if (4 != (rc = i2c_master_send(&t->i2c,t->tda9887_data,4)))
537 tda9887_info("i2c i/o error: rc == %d (should be 4)\n",rc);
538
539 if (tuner_debug > 2) {
540 msleep_interruptible(1000);
541 tda9887_status(t);
542 }
543}
544
545/* ---------------------------------------------------------------------- */
546
547static void tda9887_tuner_status(struct i2c_client *client)
548{
549 struct tuner *t = i2c_get_clientdata(client);
550 tda9887_info("Data bytes: b=0x%02x c=0x%02x e=0x%02x\n", t->tda9887_data[1], t->tda9887_data[2], t->tda9887_data[3]);
551}
552
553static int tda9887_get_afc(struct i2c_client *client)
554{
555 struct tuner *t = i2c_get_clientdata(client);
556 static int AFC_BITS_2_kHz[] = {
557 -12500, -37500, -62500, -97500,
558 -112500, -137500, -162500, -187500,
559 187500, 162500, 137500, 112500,
560 97500 , 62500, 37500 , 12500
561 };
562 int afc=0;
563 __u8 reg = 0;
564
565 if (1 == i2c_master_recv(&t->i2c,®,1))
566 afc = AFC_BITS_2_kHz[(reg>>1)&0x0f];
567
568 return afc;
569}
570
571static void tda9887_standby(struct i2c_client *client)
572{
573 tda9887_configure(client);
574}
575
576static void tda9887_set_freq(struct i2c_client *client, unsigned int freq)
577{
578 tda9887_configure(client);
579}
580
581int tda9887_tuner_init(struct i2c_client *c)
582{
583 struct tuner *t = i2c_get_clientdata(c);
584
585 strlcpy(c->name, "tda9887", sizeof(c->name));
586
587 tda9887_info("tda988[5/6/7] found @ 0x%x (%s)\n", t->i2c.addr,
588 t->i2c.driver->driver.name);
589
590 t->set_tv_freq = tda9887_set_freq;
591 t->set_radio_freq = tda9887_set_freq;
592 t->standby = tda9887_standby;
593 t->tuner_status = tda9887_tuner_status;
594 t->get_afc = tda9887_get_afc;
595
596 return 0;
597}
598
599/*
600 * Overrides for Emacs so that we follow Linus's tabbing style.
601 * ---------------------------------------------------------------------------
602 * Local variables:
603 * c-basic-offset: 8
604 * End:
605 */