tuner-core.c 27.2 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/*
 *
 * i2c tv tuner chip device driver
 * core core, i.e. kernel interfaces, registering and so on
 */

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/string.h>
#include <linux/timer.h>
#include <linux/delay.h>
#include <linux/errno.h>
#include <linux/slab.h>
#include <linux/poll.h>
#include <linux/i2c.h>
#include <linux/types.h>
#include <linux/init.h>
18
#include <linux/videodev.h>
L
Linus Torvalds 已提交
19
#include <media/tuner.h>
20
#include <media/tuner-types.h>
21
#include <media/v4l2-common.h>
22
#include "tuner-driver.h"
23
#include "mt20xx.h"
24
#include "tda8290.h"
25
#include "tea5761.h"
26
#include "tea5767.h"
27
#include "tuner-simple.h"
L
Linus Torvalds 已提交
28 29 30 31 32

#define UNSET (-1U)

/* standard i2c insmod options */
static unsigned short normal_i2c[] = {
33
#if defined(CONFIG_TUNER_TEA5761) || (defined(CONFIG_TUNER_TEA5761_MODULE) && defined(MODULE))
34 35
	0x10,
#endif
36
	0x42, 0x43, 0x4a, 0x4b,			/* tda8290 */
37 38
	0x60, 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67,
	0x68, 0x69, 0x6a, 0x6b, 0x6c, 0x6d, 0x6e, 0x6f,
L
Linus Torvalds 已提交
39 40
	I2C_CLIENT_END
};
M
Mauro Carvalho Chehab 已提交
41

L
Linus Torvalds 已提交
42 43 44
I2C_CLIENT_INSMOD;

/* insmod options used at init time => read/only */
M
Mauro Carvalho Chehab 已提交
45
static unsigned int addr = 0;
46
static unsigned int no_autodetect = 0;
47 48
static unsigned int show_i2c = 0;

L
Linus Torvalds 已提交
49
/* insmod options used at runtime => read/write */
50
int tuner_debug = 0;
L
Linus Torvalds 已提交
51

M
Mauro Carvalho Chehab 已提交
52
static unsigned int tv_range[2] = { 44, 958 };
L
Linus Torvalds 已提交
53 54
static unsigned int radio_range[2] = { 65, 108 };

55 56 57 58
static char pal[] = "--";
static char secam[] = "--";
static char ntsc[] = "-";

59

60 61 62
module_param(addr, int, 0444);
module_param(no_autodetect, int, 0444);
module_param(show_i2c, int, 0444);
63
module_param_named(debug,tuner_debug, int, 0644);
64 65 66
module_param_string(pal, pal, sizeof(pal), 0644);
module_param_string(secam, secam, sizeof(secam), 0644);
module_param_string(ntsc, ntsc, sizeof(ntsc), 0644);
M
Mauro Carvalho Chehab 已提交
67
module_param_array(tv_range, int, NULL, 0644);
L
Linus Torvalds 已提交
68 69 70 71 72 73 74 75 76 77 78
module_param_array(radio_range, int, NULL, 0644);

MODULE_DESCRIPTION("device driver for various TV and TV+FM radio tuners");
MODULE_AUTHOR("Ralph Metzler, Gerd Knorr, Gunther Mayer");
MODULE_LICENSE("GPL");

static struct i2c_driver driver;
static struct i2c_client client_template;

/* ---------------------------------------------------------------------- */

79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112
static void fe_set_freq(struct tuner *t, unsigned int freq)
{
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;

	struct analog_parameters params = {
		.frequency = freq,
		.mode      = t->mode,
		.audmode   = t->audmode,
		.std       = t->std
	};

	if (NULL == fe_tuner_ops->set_analog_params) {
		tuner_warn("Tuner frontend module has no way to set freq\n");
		return;
	}
	fe_tuner_ops->set_analog_params(&t->fe, &params);
}

static void fe_release(struct tuner *t)
{
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;

	if (fe_tuner_ops->release)
		fe_tuner_ops->release(&t->fe);
}

static void fe_standby(struct tuner *t)
{
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;

	if (fe_tuner_ops->sleep)
		fe_tuner_ops->sleep(&t->fe);
}

113 114 115
static int fe_has_signal(struct tuner *t)
{
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
116
	u16 strength = 0;
117 118 119 120 121 122 123

	if (fe_tuner_ops->get_rf_strength)
		fe_tuner_ops->get_rf_strength(&t->fe, &strength);

	return strength;
}

124
/* Set tuner frequency,  freq in Units of 62.5kHz = 1/16MHz */
L
Linus Torvalds 已提交
125 126 127 128 129
static void set_tv_freq(struct i2c_client *c, unsigned int freq)
{
	struct tuner *t = i2c_get_clientdata(c);

	if (t->type == UNSET) {
M
Mauro Carvalho Chehab 已提交
130
		tuner_warn ("tuner type not set\n");
L
Linus Torvalds 已提交
131 132
		return;
	}
133
	if (NULL == t->ops.set_tv_freq) {
M
Mauro Carvalho Chehab 已提交
134
		tuner_warn ("Tuner has no way to set tv freq\n");
L
Linus Torvalds 已提交
135 136
		return;
	}
M
Mauro Carvalho Chehab 已提交
137 138 139 140
	if (freq < tv_range[0] * 16 || freq > tv_range[1] * 16) {
		tuner_dbg ("TV freq (%d.%02d) out of range (%d-%d)\n",
			   freq / 16, freq % 16 * 100 / 16, tv_range[0],
			   tv_range[1]);
141 142 143 144 145 146
		/* V4L2 spec: if the freq is not possible then the closest
		   possible value should be selected */
		if (freq < tv_range[0] * 16)
			freq = tv_range[0] * 16;
		else
			freq = tv_range[1] * 16;
L
Linus Torvalds 已提交
147
	}
148
	t->ops.set_tv_freq(t, freq);
L
Linus Torvalds 已提交
149 150 151 152 153 154 155
}

static void set_radio_freq(struct i2c_client *c, unsigned int freq)
{
	struct tuner *t = i2c_get_clientdata(c);

	if (t->type == UNSET) {
M
Mauro Carvalho Chehab 已提交
156
		tuner_warn ("tuner type not set\n");
L
Linus Torvalds 已提交
157 158
		return;
	}
159
	if (NULL == t->ops.set_radio_freq) {
M
Mauro Carvalho Chehab 已提交
160
		tuner_warn ("tuner has no way to set radio frequency\n");
L
Linus Torvalds 已提交
161 162
		return;
	}
163
	if (freq < radio_range[0] * 16000 || freq > radio_range[1] * 16000) {
M
Mauro Carvalho Chehab 已提交
164 165 166
		tuner_dbg ("radio freq (%d.%02d) out of range (%d-%d)\n",
			   freq / 16000, freq % 16000 * 100 / 16000,
			   radio_range[0], radio_range[1]);
167 168 169 170 171 172
		/* V4L2 spec: if the freq is not possible then the closest
		   possible value should be selected */
		if (freq < radio_range[0] * 16000)
			freq = radio_range[0] * 16000;
		else
			freq = radio_range[1] * 16000;
L
Linus Torvalds 已提交
173
	}
174

175
	t->ops.set_radio_freq(t, freq);
L
Linus Torvalds 已提交
176 177 178 179 180 181 182 183 184
}

static void set_freq(struct i2c_client *c, unsigned long freq)
{
	struct tuner *t = i2c_get_clientdata(c);

	switch (t->mode) {
	case V4L2_TUNER_RADIO:
		tuner_dbg("radio freq set to %lu.%02lu\n",
M
Mauro Carvalho Chehab 已提交
185 186
			  freq / 16000, freq % 16000 * 100 / 16000);
		set_radio_freq(c, freq);
187
		t->radio_freq = freq;
L
Linus Torvalds 已提交
188 189 190 191
		break;
	case V4L2_TUNER_ANALOG_TV:
	case V4L2_TUNER_DIGITAL_TV:
		tuner_dbg("tv freq set to %lu.%02lu\n",
M
Mauro Carvalho Chehab 已提交
192
			  freq / 16, freq % 16 * 100 / 16);
L
Linus Torvalds 已提交
193
		set_tv_freq(c, freq);
194
		t->tv_freq = freq;
L
Linus Torvalds 已提交
195
		break;
196 197
	default:
		tuner_dbg("freq set: unknown mode: 0x%04x!\n",t->mode);
L
Linus Torvalds 已提交
198 199 200
	}
}

201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221
static void tuner_i2c_address_check(struct tuner *t)
{
	if ((t->type == UNSET || t->type == TUNER_ABSENT) ||
	    ((t->i2c.addr < 0x64) || (t->i2c.addr > 0x6f)))
		return;

	tuner_warn("====================== WARNING! ======================\n");
	tuner_warn("Support for tuners in i2c address range 0x64 thru 0x6f\n");
	tuner_warn("will soon be dropped. This message indicates that your\n");
	tuner_warn("hardware has a %s tuner at i2c address 0x%02x.\n",
		   t->i2c.name, t->i2c.addr);
	tuner_warn("To ensure continued support for your device, please\n");
	tuner_warn("send a copy of this message, along with full dmesg\n");
	tuner_warn("output to v4l-dvb-maintainer@linuxtv.org\n");
	tuner_warn("Please use subject line: \"obsolete tuner i2c address.\"\n");
	tuner_warn("driver: %s, addr: 0x%02x, type: %d (%s)\n",
		   t->i2c.adapter->name, t->i2c.addr, t->type,
		   tuners[t->type].name);
	tuner_warn("====================== WARNING! ======================\n");
}

222 223 224 225 226 227 228 229 230
static void attach_tda8290(struct tuner *t)
{
	struct tda8290_config cfg = {
		.lna_cfg        = &t->config,
		.tuner_callback = t->tuner_callback
	};
	tda8290_attach(&t->fe, t->i2c.adapter, t->i2c.addr, &cfg);
}

231 232 233 234 235 236 237 238 239
static void attach_simple_tuner(struct tuner *t)
{
	struct simple_tuner_config cfg = {
		.type = t->type,
		.tun  = &tuners[t->type]
	};
	simple_tuner_attach(&t->fe, t->i2c.adapter, t->i2c.addr, &cfg);
}

M
Mauro Carvalho Chehab 已提交
240
static void set_type(struct i2c_client *c, unsigned int type,
241
		     unsigned int new_mode_mask, unsigned int new_config,
242
		     int (*tuner_callback) (void *dev, int command,int arg))
L
Linus Torvalds 已提交
243 244
{
	struct tuner *t = i2c_get_clientdata(c);
245
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
246
	unsigned char buffer[4];
L
Linus Torvalds 已提交
247

M
Mauro Carvalho Chehab 已提交
248 249
	if (type == UNSET || type == TUNER_ABSENT) {
		tuner_dbg ("tuner 0x%02x: Tuner type absent\n",c->addr);
L
Linus Torvalds 已提交
250
		return;
M
Mauro Carvalho Chehab 已提交
251 252 253 254
	}

	if (type >= tuner_count) {
		tuner_warn ("tuner 0x%02x: Tuner count greater than %d\n",c->addr,tuner_count);
L
Linus Torvalds 已提交
255
		return;
M
Mauro Carvalho Chehab 已提交
256
	}
L
Linus Torvalds 已提交
257

258 259 260 261 262 263 264
	t->type = type;
	t->config = new_config;
	if (tuner_callback != NULL) {
		tuner_dbg("defining GPIO callback\n");
		t->tuner_callback = tuner_callback;
	}

M
Mauro Carvalho Chehab 已提交
265
	/* This code detects calls by card attach_inform */
L
Linus Torvalds 已提交
266
	if (NULL == t->i2c.dev.driver) {
M
Mauro Carvalho Chehab 已提交
267 268
		tuner_dbg ("tuner 0x%02x: called during i2c_client register by adapter's attach_inform\n", c->addr);

L
Linus Torvalds 已提交
269 270
		return;
	}
271

272
	/* discard private data, in case set_type() was previously called */
273
	if (t->ops.release)
274
		t->ops.release(t);
275 276 277 278
	else {
		kfree(t->priv);
		t->priv = NULL;
	}
279

L
Linus Torvalds 已提交
280 281
	switch (t->type) {
	case TUNER_MT2032:
282
		microtune_attach(&t->fe, t->i2c.adapter, t->i2c.addr);
L
Linus Torvalds 已提交
283 284
		break;
	case TUNER_PHILIPS_TDA8290:
285 286
	{
		attach_tda8290(t);
L
Linus Torvalds 已提交
287
		break;
288
	}
289
	case TUNER_TEA5767:
290
		if (tea5767_attach(&t->fe, t->i2c.adapter, t->i2c.addr) == NULL) {
M
Mauro Carvalho Chehab 已提交
291 292 293 294 295
			t->type = TUNER_ABSENT;
			t->mode_mask = T_UNINITIALIZED;
			return;
		}
		t->mode_mask = T_RADIO;
296
		break;
297
	case TUNER_TEA5761:
298
		if (tea5761_attach(&t->fe, t->i2c.adapter, t->i2c.addr) == NULL) {
299 300
			t->type = TUNER_ABSENT;
			t->mode_mask = T_UNINITIALIZED;
301
			return;
302 303 304
		}
		t->mode_mask = T_RADIO;
		break;
305 306 307 308 309
	case TUNER_PHILIPS_FMD1216ME_MK3:
		buffer[0] = 0x0b;
		buffer[1] = 0xdc;
		buffer[2] = 0x9c;
		buffer[3] = 0x60;
M
Mauro Carvalho Chehab 已提交
310
		i2c_master_send(c, buffer, 4);
311 312 313
		mdelay(1);
		buffer[2] = 0x86;
		buffer[3] = 0x54;
M
Mauro Carvalho Chehab 已提交
314
		i2c_master_send(c, buffer, 4);
315
		attach_simple_tuner(t);
316
		break;
317 318 319 320 321 322
	case TUNER_PHILIPS_TD1316:
		buffer[0] = 0x0b;
		buffer[1] = 0xdc;
		buffer[2] = 0x86;
		buffer[3] = 0xa4;
		i2c_master_send(c,buffer,4);
323
		attach_simple_tuner(t);
324
		break;
325 326 327
	case TUNER_XC2028:
		xc2028_tuner_init(c);
		break;
328
	case TUNER_TDA9887:
329
		tda9887_tuner_init(t);
330
		break;
L
Linus Torvalds 已提交
331
	default:
332
		attach_simple_tuner(t);
L
Linus Torvalds 已提交
333 334
		break;
	}
M
Mauro Carvalho Chehab 已提交
335

336 337 338 339 340 341 342
	if (fe_tuner_ops->set_analog_params) {
		strlcpy(t->i2c.name, fe_tuner_ops->info.name, sizeof(t->i2c.name));

		t->ops.set_tv_freq    = fe_set_freq;
		t->ops.set_radio_freq = fe_set_freq;
		t->ops.standby        = fe_standby;
		t->ops.release        = fe_release;
343
		t->ops.has_signal     = fe_has_signal;
344 345 346 347
	}

	tuner_info("type set to %s\n", t->i2c.name);

M
Mauro Carvalho Chehab 已提交
348 349 350
	if (t->mode_mask == T_UNINITIALIZED)
		t->mode_mask = new_mode_mask;

351
	set_freq(c, (V4L2_TUNER_RADIO == t->mode) ? t->radio_freq : t->tv_freq);
M
Mauro Carvalho Chehab 已提交
352
	tuner_dbg("%s %s I2C addr 0x%02x with type %d used for 0x%02x\n",
353
		  c->adapter->name, c->driver->driver.name, c->addr << 1, type,
M
Mauro Carvalho Chehab 已提交
354
		  t->mode_mask);
355
	tuner_i2c_address_check(t);
L
Linus Torvalds 已提交
356 357
}

M
Mauro Carvalho Chehab 已提交
358 359 360 361 362 363 364 365 366 367 368 369
/*
 * This function apply tuner config to tuner specified
 * by tun_setup structure. I addr is unset, then admin status
 * and tun addr status is more precise then current status,
 * it's applied. Otherwise status and type are applied only to
 * tuner with exactly the same addr.
*/

static void set_addr(struct i2c_client *c, struct tuner_setup *tun_setup)
{
	struct tuner *t = i2c_get_clientdata(c);

370 371
	tuner_dbg("set addr for type %i\n", t->type);

372 373 374 375
	if ( (t->type == UNSET && ((tun_setup->addr == ADDR_UNSET) &&
		(t->mode_mask & tun_setup->mode_mask))) ||
		(tun_setup->addr == c->addr)) {
			set_type(c, tun_setup->type, tun_setup->mode_mask,
376
				 tun_setup->config, tun_setup->tuner_callback);
M
Mauro Carvalho Chehab 已提交
377 378
	}
}
379

M
Mauro Carvalho Chehab 已提交
380
static inline int check_mode(struct tuner *t, char *cmd)
381
{
382 383 384 385 386 387 388 389 390 391 392 393 394 395
	if ((1 << t->mode & t->mode_mask) == 0) {
		return EINVAL;
	}

	switch (t->mode) {
	case V4L2_TUNER_RADIO:
		tuner_dbg("Cmd %s accepted for radio\n", cmd);
		break;
	case V4L2_TUNER_ANALOG_TV:
		tuner_dbg("Cmd %s accepted for analog TV\n", cmd);
		break;
	case V4L2_TUNER_DIGITAL_TV:
		tuner_dbg("Cmd %s accepted for digital TV\n", cmd);
		break;
396
	}
397
	return 0;
398 399
}

M
Mauro Carvalho Chehab 已提交
400
/* get more precise norm info from insmod option */
L
Linus Torvalds 已提交
401 402 403 404
static int tuner_fixup_std(struct tuner *t)
{
	if ((t->std & V4L2_STD_PAL) == V4L2_STD_PAL) {
		switch (pal[0]) {
405 406 407 408
		case '6':
			tuner_dbg ("insmod fixup: PAL => PAL-60\n");
			t->std = V4L2_STD_PAL_60;
			break;
L
Linus Torvalds 已提交
409 410 411 412
		case 'b':
		case 'B':
		case 'g':
		case 'G':
M
Mauro Carvalho Chehab 已提交
413
			tuner_dbg ("insmod fixup: PAL => PAL-BG\n");
L
Linus Torvalds 已提交
414 415 416 417
			t->std = V4L2_STD_PAL_BG;
			break;
		case 'i':
		case 'I':
M
Mauro Carvalho Chehab 已提交
418
			tuner_dbg ("insmod fixup: PAL => PAL-I\n");
L
Linus Torvalds 已提交
419 420 421 422 423 424
			t->std = V4L2_STD_PAL_I;
			break;
		case 'd':
		case 'D':
		case 'k':
		case 'K':
M
Mauro Carvalho Chehab 已提交
425
			tuner_dbg ("insmod fixup: PAL => PAL-DK\n");
L
Linus Torvalds 已提交
426 427
			t->std = V4L2_STD_PAL_DK;
			break;
M
Mauro Carvalho Chehab 已提交
428 429 430 431 432 433 434
		case 'M':
		case 'm':
			tuner_dbg ("insmod fixup: PAL => PAL-M\n");
			t->std = V4L2_STD_PAL_M;
			break;
		case 'N':
		case 'n':
435 436 437 438 439 440 441
			if (pal[1] == 'c' || pal[1] == 'C') {
				tuner_dbg("insmod fixup: PAL => PAL-Nc\n");
				t->std = V4L2_STD_PAL_Nc;
			} else {
				tuner_dbg ("insmod fixup: PAL => PAL-N\n");
				t->std = V4L2_STD_PAL_N;
			}
M
Mauro Carvalho Chehab 已提交
442
			break;
443 444 445 446 447 448
		case '-':
			/* default parameter, do nothing */
			break;
		default:
			tuner_warn ("pal= argument not recognised\n");
			break;
L
Linus Torvalds 已提交
449 450
		}
	}
M
Mauro Carvalho Chehab 已提交
451 452
	if ((t->std & V4L2_STD_SECAM) == V4L2_STD_SECAM) {
		switch (secam[0]) {
453 454 455 456 457 458 459 460 461
		case 'b':
		case 'B':
		case 'g':
		case 'G':
		case 'h':
		case 'H':
			tuner_dbg("insmod fixup: SECAM => SECAM-BGH\n");
			t->std = V4L2_STD_SECAM_B | V4L2_STD_SECAM_G | V4L2_STD_SECAM_H;
			break;
M
Mauro Carvalho Chehab 已提交
462 463 464 465 466 467 468 469 470
		case 'd':
		case 'D':
		case 'k':
		case 'K':
			tuner_dbg ("insmod fixup: SECAM => SECAM-DK\n");
			t->std = V4L2_STD_SECAM_DK;
			break;
		case 'l':
		case 'L':
471 472 473 474 475 476 477
			if ((secam[1]=='C')||(secam[1]=='c')) {
				tuner_dbg ("insmod fixup: SECAM => SECAM-L'\n");
				t->std = V4L2_STD_SECAM_LC;
			} else {
				tuner_dbg ("insmod fixup: SECAM => SECAM-L\n");
				t->std = V4L2_STD_SECAM_L;
			}
M
Mauro Carvalho Chehab 已提交
478
			break;
479 480 481 482 483 484
		case '-':
			/* default parameter, do nothing */
			break;
		default:
			tuner_warn ("secam= argument not recognised\n");
			break;
M
Mauro Carvalho Chehab 已提交
485 486 487
		}
	}

488 489 490 491 492 493 494 495 496 497 498 499
	if ((t->std & V4L2_STD_NTSC) == V4L2_STD_NTSC) {
		switch (ntsc[0]) {
		case 'm':
		case 'M':
			tuner_dbg("insmod fixup: NTSC => NTSC-M\n");
			t->std = V4L2_STD_NTSC_M;
			break;
		case 'j':
		case 'J':
			tuner_dbg("insmod fixup: NTSC => NTSC_M_JP\n");
			t->std = V4L2_STD_NTSC_M_JP;
			break;
500 501 502 503 504
		case 'k':
		case 'K':
			tuner_dbg("insmod fixup: NTSC => NTSC_M_KR\n");
			t->std = V4L2_STD_NTSC_M_KR;
			break;
505 506 507 508 509 510 511 512
		case '-':
			/* default parameter, do nothing */
			break;
		default:
			tuner_info("ntsc= argument not recognised\n");
			break;
		}
	}
L
Linus Torvalds 已提交
513 514 515
	return 0;
}

516
static void tuner_status(struct tuner *t)
517 518
{
	unsigned long freq, freq_fraction;
519
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
520 521 522 523 524 525 526 527 528
	const char *p;

	switch (t->mode) {
		case V4L2_TUNER_RADIO: 	    p = "radio"; break;
		case V4L2_TUNER_ANALOG_TV:  p = "analog TV"; break;
		case V4L2_TUNER_DIGITAL_TV: p = "digital TV"; break;
		default: p = "undefined"; break;
	}
	if (t->mode == V4L2_TUNER_RADIO) {
529 530
		freq = t->radio_freq / 16000;
		freq_fraction = (t->radio_freq % 16000) * 100 / 16000;
531
	} else {
532 533
		freq = t->tv_freq / 16;
		freq_fraction = (t->tv_freq % 16) * 100 / 16;
534 535 536
	}
	tuner_info("Tuner mode:      %s\n", p);
	tuner_info("Frequency:       %lu.%02lu MHz\n", freq, freq_fraction);
537
	tuner_info("Standard:        0x%08lx\n", (unsigned long)t->std);
538 539
	if (t->mode != V4L2_TUNER_RADIO)
	       return;
540 541 542 543 544 545 546 547 548
	if (fe_tuner_ops->get_status) {
		u32 tuner_status;

		fe_tuner_ops->get_status(&t->fe, &tuner_status);
		if (tuner_status & TUNER_STATUS_LOCKED)
			tuner_info("Tuner is locked.\n");
		if (tuner_status & TUNER_STATUS_STEREO)
			tuner_info("Stereo:          yes\n");
	}
549
	if (t->ops.has_signal) {
550
		tuner_info("Signal strength: %d\n", t->ops.has_signal(t));
551
	}
552
	if (t->ops.is_stereo) {
553
		tuner_info("Stereo:          %s\n", t->ops.is_stereo(t) ? "yes" : "no");
554 555
	}
}
556

L
Linus Torvalds 已提交
557 558
/* ---------------------------------------------------------------------- */

559
/* static vars: used only in tuner_attach and tuner_probe */
M
Mauro Carvalho Chehab 已提交
560 561 562 563 564
static unsigned default_mode_mask;

/* During client attach, set_type is called by adapter's attach_inform callback.
   set_type must then be completed by tuner_attach.
 */
L
Linus Torvalds 已提交
565 566 567 568
static int tuner_attach(struct i2c_adapter *adap, int addr, int kind)
{
	struct tuner *t;

M
Mauro Carvalho Chehab 已提交
569 570
	client_template.adapter = adap;
	client_template.addr = addr;
L
Linus Torvalds 已提交
571

P
 
Panagiotis Issaris 已提交
572
	t = kzalloc(sizeof(struct tuner), GFP_KERNEL);
M
Mauro Carvalho Chehab 已提交
573 574 575
	if (NULL == t)
		return -ENOMEM;
	memcpy(&t->i2c, &client_template, sizeof(struct i2c_client));
L
Linus Torvalds 已提交
576
	i2c_set_clientdata(&t->i2c, t);
M
Mauro Carvalho Chehab 已提交
577 578 579
	t->type = UNSET;
	t->audmode = V4L2_TUNER_MODE_STEREO;
	t->mode_mask = T_UNINITIALIZED;
580
	t->ops.tuner_status = tuner_status;
M
Mauro Carvalho Chehab 已提交
581

582 583 584 585 586 587
	if (show_i2c) {
		unsigned char buffer[16];
		int i,rc;

		memset(buffer, 0, sizeof(buffer));
		rc = i2c_master_recv(&t->i2c, buffer, sizeof(buffer));
588
		tuner_info("I2C RECV = ");
589 590 591 592
		for (i=0;i<rc;i++)
			printk("%02x ",buffer[i]);
		printk("\n");
	}
593 594 595 596
	/* HACK: This test were added to avoid tuner to probe tda9840 and tea6415c on the MXB card */
	if (adap->id == I2C_HW_SAA7146 && addr < 0x4a)
		return -ENODEV;

597
	/* autodetection code based on the i2c addr */
598
	if (!no_autodetect) {
599
		switch (addr) {
600
		case 0x10:
601
			if (tea5761_autodetection(t->i2c.adapter, t->i2c.addr) != EINVAL) {
602 603 604 605 606 607 608 609 610
				t->type = TUNER_TEA5761;
				t->mode_mask = T_RADIO;
				t->mode = T_STANDBY;
				t->radio_freq = 87.5 * 16000; /* Sets freq to FM range */
				default_mode_mask &= ~T_RADIO;

				goto register_client;
			}
			break;
611 612 613
		case 0x42:
		case 0x43:
		case 0x4a:
614
		case 0x4b:
615 616
			/* If chip is not tda8290, don't register.
			   since it can be tda9887*/
617
			if (tda8290_probe(t->i2c.adapter, t->i2c.addr) == 0) {
618 619 620 621 622 623 624
				tuner_dbg("chip at addr %x is a tda8290\n", addr);
			} else {
				/* Default is being tda9887 */
				t->type = TUNER_TDA9887;
				t->mode_mask = T_RADIO | T_ANALOG_TV | T_DIGITAL_TV;
				t->mode = T_STANDBY;
				goto register_client;
625
			}
626 627
			break;
		case 0x60:
628
			if (tea5767_autodetection(t->i2c.adapter, t->i2c.addr) != EINVAL) {
629 630 631
				t->type = TUNER_TEA5767;
				t->mode_mask = T_RADIO;
				t->mode = T_STANDBY;
632
				t->radio_freq = 87.5 * 16000; /* Sets freq to FM range */
633
				default_mode_mask &= ~T_RADIO;
634

635 636 637
				goto register_client;
			}
			break;
M
Mauro Carvalho Chehab 已提交
638 639
		}
	}
L
Linus Torvalds 已提交
640

M
Mauro Carvalho Chehab 已提交
641 642 643 644
	/* Initializes only the first adapter found */
	if (default_mode_mask != T_UNINITIALIZED) {
		tuner_dbg ("Setting mode_mask to 0x%02x\n", default_mode_mask);
		t->mode_mask = default_mode_mask;
645 646
		t->tv_freq = 400 * 16; /* Sets freq to VHF High */
		t->radio_freq = 87.5 * 16000; /* Sets freq to FM range */
M
Mauro Carvalho Chehab 已提交
647 648
		default_mode_mask = T_UNINITIALIZED;
	}
649

M
Mauro Carvalho Chehab 已提交
650
	/* Should be just before return */
651 652
register_client:
	tuner_info("chip found @ 0x%x (%s)\n", addr << 1, adap->name);
M
Mauro Carvalho Chehab 已提交
653
	i2c_attach_client (&t->i2c);
654
	set_type (&t->i2c,t->type, t->mode_mask, t->config, t->tuner_callback);
L
Linus Torvalds 已提交
655 656 657 658 659 660
	return 0;
}

static int tuner_probe(struct i2c_adapter *adap)
{
	if (0 != addr) {
661 662
		normal_i2c[0] = addr;
		normal_i2c[1] = I2C_CLIENT_END;
L
Linus Torvalds 已提交
663 664
	}

665 666 667 668
	/* HACK: Ignore 0x6b and 0x6f on cx88 boards.
	 * FusionHDTV5 RT Gold has an ir receiver at 0x6b
	 * and an RTC at 0x6f which can get corrupted if probed.
	 */
669 670
	if ((adap->id == I2C_HW_B_CX2388x) ||
	    (adap->id == I2C_HW_B_CX23885)) {
671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686
		unsigned int i = 0;

		while (i < I2C_CLIENT_MAX_OPTS && ignore[i] != I2C_CLIENT_END)
			i += 2;
		if (i + 4 < I2C_CLIENT_MAX_OPTS) {
			ignore[i+0] = adap->nr;
			ignore[i+1] = 0x6b;
			ignore[i+2] = adap->nr;
			ignore[i+3] = 0x6f;
			ignore[i+4] = I2C_CLIENT_END;
		} else
			printk(KERN_WARNING "tuner: "
			       "too many options specified "
			       "in i2c probe ignore list!\n");
	}

M
Mauro Carvalho Chehab 已提交
687
	default_mode_mask = T_RADIO | T_ANALOG_TV | T_DIGITAL_TV;
688

L
Linus Torvalds 已提交
689 690 691 692 693 694 695 696
	if (adap->class & I2C_CLASS_TV_ANALOG)
		return i2c_probe(adap, &addr_data, tuner_attach);
	return 0;
}

static int tuner_detach(struct i2c_client *client)
{
	struct tuner *t = i2c_get_clientdata(client);
697 698
	int err;

M
Mauro Carvalho Chehab 已提交
699
	err = i2c_detach_client(&t->i2c);
700
	if (err) {
M
Mauro Carvalho Chehab 已提交
701 702
		tuner_warn
		    ("Client deregistration failed, client not detached.\n");
703 704
		return err;
	}
L
Linus Torvalds 已提交
705

706
	if (t->ops.release)
707
		t->ops.release(t);
708 709 710
	else {
		kfree(t->priv);
	}
L
Linus Torvalds 已提交
711 712 713 714
	kfree(t);
	return 0;
}

M
Mauro Carvalho Chehab 已提交
715 716 717 718 719 720 721 722 723
/*
 * Switch tuner to other mode. If tuner support both tv and radio,
 * set another frequency to some value (This is needed for some pal
 * tuners to avoid locking). Otherwise, just put second tuner in
 * standby mode.
 */

static inline int set_mode(struct i2c_client *client, struct tuner *t, int mode, char *cmd)
{
724 725 726 727 728 729 730
	if (mode == t->mode)
		return 0;

	t->mode = mode;

	if (check_mode(t, cmd) == EINVAL) {
		t->mode = T_STANDBY;
731
		if (t->ops.standby)
732
			t->ops.standby(t);
733 734 735
		return EINVAL;
	}
	return 0;
M
Mauro Carvalho Chehab 已提交
736 737 738
}

#define switch_v4l2()	if (!t->using_v4l2) \
739 740
			    tuner_dbg("switching to v4l2\n"); \
			t->using_v4l2 = 1;
M
Mauro Carvalho Chehab 已提交
741 742 743

static inline int check_v4l2(struct tuner *t)
{
744 745 746 747
	/* bttv still uses both v4l1 and v4l2 calls to the tuner (v4l2 for
	   TV, v4l1 for radio), until that is fixed this code is disabled.
	   Otherwise the radio (v4l1) wouldn't tune after using the TV (v4l2)
	   first. */
M
Mauro Carvalho Chehab 已提交
748 749
	return 0;
}
L
Linus Torvalds 已提交
750

M
Mauro Carvalho Chehab 已提交
751
static int tuner_command(struct i2c_client *client, unsigned int cmd, void *arg)
L
Linus Torvalds 已提交
752 753
{
	struct tuner *t = i2c_get_clientdata(client);
754
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
L
Linus Torvalds 已提交
755

756
	if (tuner_debug>1)
757 758
		v4l_i2c_print_ioctl(&(t->i2c),cmd);

M
Mauro Carvalho Chehab 已提交
759
	switch (cmd) {
L
Linus Torvalds 已提交
760
	/* --- configuration --- */
761
	case TUNER_SET_TYPE_ADDR:
762
		tuner_dbg ("Calling set_type_addr for type=%d, addr=0x%02x, mode=0x%02x, config=0x%02x\n",
M
Mauro Carvalho Chehab 已提交
763 764
				((struct tuner_setup *)arg)->type,
				((struct tuner_setup *)arg)->addr,
765 766
				((struct tuner_setup *)arg)->mode_mask,
				((struct tuner_setup *)arg)->config);
M
Mauro Carvalho Chehab 已提交
767 768

		set_addr(client, (struct tuner_setup *)arg);
769
		break;
L
Linus Torvalds 已提交
770
	case AUDC_SET_RADIO:
771 772 773 774 775
		if (set_mode(client, t, V4L2_TUNER_RADIO, "AUDC_SET_RADIO")
				== EINVAL)
			return 0;
		if (t->radio_freq)
			set_freq(client, t->radio_freq);
L
Linus Torvalds 已提交
776
		break;
777
	case TUNER_SET_STANDBY:
778 779
		if (check_mode(t, "TUNER_SET_STANDBY") == EINVAL)
			return 0;
780
		t->mode = T_STANDBY;
781
		if (t->ops.standby)
782
			t->ops.standby(t);
783
		break;
784
#ifdef CONFIG_VIDEO_V4L1
785 786 787 788 789 790 791 792
	case VIDIOCSAUDIO:
		if (check_mode(t, "VIDIOCSAUDIO") == EINVAL)
			return 0;
		if (check_v4l2(t) == EINVAL)
			return 0;

		/* Should be implemented, since bttv calls it */
		tuner_dbg("VIDIOCSAUDIO not implemented.\n");
M
Mauro Carvalho Chehab 已提交
793
		break;
L
Linus Torvalds 已提交
794
	case VIDIOCSCHAN:
M
Mauro Carvalho Chehab 已提交
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814
		{
			static const v4l2_std_id map[] = {
				[VIDEO_MODE_PAL] = V4L2_STD_PAL,
				[VIDEO_MODE_NTSC] = V4L2_STD_NTSC_M,
				[VIDEO_MODE_SECAM] = V4L2_STD_SECAM,
				[4 /* bttv */ ] = V4L2_STD_PAL_M,
				[5 /* bttv */ ] = V4L2_STD_PAL_N,
				[6 /* bttv */ ] = V4L2_STD_NTSC_M_JP,
			};
			struct video_channel *vc = arg;

			if (check_v4l2(t) == EINVAL)
				return 0;

			if (set_mode(client,t,V4L2_TUNER_ANALOG_TV, "VIDIOCSCHAN")==EINVAL)
				return 0;

			if (vc->norm < ARRAY_SIZE(map))
				t->std = map[vc->norm];
			tuner_fixup_std(t);
815 816
			if (t->tv_freq)
				set_tv_freq(client, t->tv_freq);
M
Mauro Carvalho Chehab 已提交
817 818
			return 0;
		}
L
Linus Torvalds 已提交
819
	case VIDIOCSFREQ:
M
Mauro Carvalho Chehab 已提交
820 821
		{
			unsigned long *v = arg;
L
Linus Torvalds 已提交
822

M
Mauro Carvalho Chehab 已提交
823 824 825 826 827 828 829 830
			if (check_mode(t, "VIDIOCSFREQ") == EINVAL)
				return 0;
			if (check_v4l2(t) == EINVAL)
				return 0;

			set_freq(client, *v);
			return 0;
		}
L
Linus Torvalds 已提交
831
	case VIDIOCGTUNER:
M
Mauro Carvalho Chehab 已提交
832 833 834 835 836 837 838 839 840
		{
			struct video_tuner *vt = arg;

			if (check_mode(t, "VIDIOCGTUNER") == EINVAL)
				return 0;
			if (check_v4l2(t) == EINVAL)
				return 0;

			if (V4L2_TUNER_RADIO == t->mode) {
841 842 843 844
				if (fe_tuner_ops->get_status) {
					u32 tuner_status;

					fe_tuner_ops->get_status(&t->fe, &tuner_status);
845 846 847 848
					if (tuner_status & TUNER_STATUS_STEREO)
						vt->flags |= VIDEO_TUNER_STEREO_ON;
					else
						vt->flags &= ~VIDEO_TUNER_STEREO_ON;
849 850 851 852 853 854 855 856 857
				} else {
					if (t->ops.is_stereo) {
						if (t->ops.is_stereo(t))
							vt->flags |=
								VIDEO_TUNER_STEREO_ON;
						else
							vt->flags &=
								~VIDEO_TUNER_STEREO_ON;
					}
M
Mauro Carvalho Chehab 已提交
858
				}
859 860 861
				if (t->ops.has_signal)
					vt->signal = t->ops.has_signal(t);

M
Mauro Carvalho Chehab 已提交
862
				vt->flags |= VIDEO_TUNER_LOW;	/* Allow freqs at 62.5 Hz */
863

M
Mauro Carvalho Chehab 已提交
864 865
				vt->rangelow = radio_range[0] * 16000;
				vt->rangehigh = radio_range[1] * 16000;
866

M
Mauro Carvalho Chehab 已提交
867 868 869 870
			} else {
				vt->rangelow = tv_range[0] * 16;
				vt->rangehigh = tv_range[1] * 16;
			}
871

M
Mauro Carvalho Chehab 已提交
872 873
			return 0;
		}
L
Linus Torvalds 已提交
874
	case VIDIOCGAUDIO:
M
Mauro Carvalho Chehab 已提交
875 876 877 878 879 880 881 882
		{
			struct video_audio *va = arg;

			if (check_mode(t, "VIDIOCGAUDIO") == EINVAL)
				return 0;
			if (check_v4l2(t) == EINVAL)
				return 0;

883 884 885 886 887 888 889 890 891 892 893
			if (V4L2_TUNER_RADIO == t->mode) {
				if (fe_tuner_ops->get_status) {
					u32 tuner_status;

					fe_tuner_ops->get_status(&t->fe, &tuner_status);
					va->mode = (tuner_status & TUNER_STATUS_STEREO)
					    ? VIDEO_SOUND_STEREO : VIDEO_SOUND_MONO;
				} else if (t->ops.is_stereo)
					va->mode = t->ops.is_stereo(t)
					    ? VIDEO_SOUND_STEREO : VIDEO_SOUND_MONO;
			}
M
Mauro Carvalho Chehab 已提交
894 895
			return 0;
		}
896
#endif
897 898 899 900 901 902 903
	case TUNER_SET_CONFIG:
	{
		struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
		struct v4l2_priv_tun_config *cfg = arg;

		if (t->type != cfg->tuner)
			break;
L
Linus Torvalds 已提交
904

905 906
		if (t->type == TUNER_TDA9887) {
			t->tda9887_config = *(unsigned int *)cfg->priv;
907
			set_freq(client, t->tv_freq);
908
			break;
909
		}
910 911 912 913 914 915 916 917

		if (NULL == fe_tuner_ops->set_config) {
			tuner_warn("Tuner frontend module has no way to "
				   "set config\n");
			break;
		}
		fe_tuner_ops->set_config(&t->fe, cfg->priv);

918
		break;
919
	}
920 921 922
	/* --- v4l ioctls --- */
	/* take care: bttv does userspace copying, we'll get a
	   kernel pointer here... */
L
Linus Torvalds 已提交
923
	case VIDIOC_S_STD:
M
Mauro Carvalho Chehab 已提交
924 925
		{
			v4l2_std_id *id = arg;
L
Linus Torvalds 已提交
926

M
Mauro Carvalho Chehab 已提交
927 928 929
			if (set_mode (client, t, V4L2_TUNER_ANALOG_TV, "VIDIOC_S_STD")
					== EINVAL)
				return 0;
930

M
Mauro Carvalho Chehab 已提交
931 932 933 934
			switch_v4l2();

			t->std = *id;
			tuner_fixup_std(t);
935 936
			if (t->tv_freq)
				set_freq(client, t->tv_freq);
M
Mauro Carvalho Chehab 已提交
937 938
			break;
		}
L
Linus Torvalds 已提交
939
	case VIDIOC_S_FREQUENCY:
M
Mauro Carvalho Chehab 已提交
940 941 942
		{
			struct v4l2_frequency *f = arg;

943 944 945
			if (set_mode (client, t, f->type, "VIDIOC_S_FREQUENCY")
					== EINVAL)
				return 0;
M
Mauro Carvalho Chehab 已提交
946
			switch_v4l2();
947
			set_freq(client,f->frequency);
948

M
Mauro Carvalho Chehab 已提交
949 950 951 952 953 954 955 956 957 958
			break;
		}
	case VIDIOC_G_FREQUENCY:
		{
			struct v4l2_frequency *f = arg;

			if (check_mode(t, "VIDIOC_G_FREQUENCY") == EINVAL)
				return 0;
			switch_v4l2();
			f->type = t->mode;
959 960 961 962 963 964 965 966 967
			if (fe_tuner_ops->get_frequency) {
				u32 abs_freq;

				fe_tuner_ops->get_frequency(&t->fe, &abs_freq);
				f->frequency = (V4L2_TUNER_RADIO == t->mode) ?
					(abs_freq * 2 + 125/2) / 125 :
					(abs_freq + 62500/2) / 62500;
				break;
			}
968 969
			f->frequency = (V4L2_TUNER_RADIO == t->mode) ?
				t->radio_freq : t->tv_freq;
M
Mauro Carvalho Chehab 已提交
970 971
			break;
		}
L
Linus Torvalds 已提交
972
	case VIDIOC_G_TUNER:
M
Mauro Carvalho Chehab 已提交
973 974 975 976 977 978 979
		{
			struct v4l2_tuner *tuner = arg;

			if (check_mode(t, "VIDIOC_G_TUNER") == EINVAL)
				return 0;
			switch_v4l2();

980
			tuner->type = t->mode;
981
			if (t->ops.get_afc)
982
				tuner->afc=t->ops.get_afc(t);
983 984
			if (t->mode == V4L2_TUNER_ANALOG_TV)
				tuner->capability |= V4L2_TUNER_CAP_NORM;
985
			if (t->mode != V4L2_TUNER_RADIO) {
M
Mauro Carvalho Chehab 已提交
986 987
				tuner->rangelow = tv_range[0] * 16;
				tuner->rangehigh = tv_range[1] * 16;
988 989 990 991 992 993
				break;
			}

			/* radio mode */
			tuner->rxsubchans =
				V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
994 995 996 997 998
			if (fe_tuner_ops->get_status) {
				u32 tuner_status;

				fe_tuner_ops->get_status(&t->fe, &tuner_status);
				tuner->rxsubchans = (tuner_status & TUNER_STATUS_STEREO) ?
999
					V4L2_TUNER_SUB_STEREO : V4L2_TUNER_SUB_MONO;
1000 1001 1002 1003 1004
			} else {
				if (t->ops.is_stereo) {
					tuner->rxsubchans = t->ops.is_stereo(t) ?
						V4L2_TUNER_SUB_STEREO : V4L2_TUNER_SUB_MONO;
				}
1005
			}
1006 1007
			if (t->ops.has_signal)
				tuner->signal = t->ops.has_signal(t);
1008 1009 1010 1011 1012
			tuner->capability |=
			    V4L2_TUNER_CAP_LOW | V4L2_TUNER_CAP_STEREO;
			tuner->audmode = t->audmode;
			tuner->rangelow = radio_range[0] * 16000;
			tuner->rangehigh = radio_range[1] * 16000;
M
Mauro Carvalho Chehab 已提交
1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023
			break;
		}
	case VIDIOC_S_TUNER:
		{
			struct v4l2_tuner *tuner = arg;

			if (check_mode(t, "VIDIOC_S_TUNER") == EINVAL)
				return 0;

			switch_v4l2();

1024 1025 1026 1027 1028
			/* do nothing unless we're a radio tuner */
			if (t->mode != V4L2_TUNER_RADIO)
				break;
			t->audmode = tuner->audmode;
			set_radio_freq(client, t->radio_freq);
M
Mauro Carvalho Chehab 已提交
1029
			break;
1030
		}
1031
	case VIDIOC_LOG_STATUS:
1032
		if (t->ops.tuner_status)
1033
			t->ops.tuner_status(t);
1034
		break;
L
Linus Torvalds 已提交
1035 1036 1037 1038 1039
	}

	return 0;
}

1040
static int tuner_suspend(struct i2c_client *c, pm_message_t state)
L
Linus Torvalds 已提交
1041
{
M
Mauro Carvalho Chehab 已提交
1042
	struct tuner *t = i2c_get_clientdata (c);
L
Linus Torvalds 已提交
1043

M
Mauro Carvalho Chehab 已提交
1044
	tuner_dbg ("suspend\n");
L
Linus Torvalds 已提交
1045 1046 1047 1048
	/* FIXME: power down ??? */
	return 0;
}

1049
static int tuner_resume(struct i2c_client *c)
L
Linus Torvalds 已提交
1050
{
M
Mauro Carvalho Chehab 已提交
1051
	struct tuner *t = i2c_get_clientdata (c);
L
Linus Torvalds 已提交
1052

M
Mauro Carvalho Chehab 已提交
1053
	tuner_dbg ("resume\n");
1054 1055 1056 1057 1058 1059 1060
	if (V4L2_TUNER_RADIO == t->mode) {
		if (t->radio_freq)
			set_freq(c, t->radio_freq);
	} else {
		if (t->tv_freq)
			set_freq(c, t->tv_freq);
	}
L
Linus Torvalds 已提交
1061 1062 1063 1064 1065 1066
	return 0;
}

/* ----------------------------------------------------------------------- */

static struct i2c_driver driver = {
M
Mauro Carvalho Chehab 已提交
1067 1068 1069 1070
	.id = I2C_DRIVERID_TUNER,
	.attach_adapter = tuner_probe,
	.detach_client = tuner_detach,
	.command = tuner_command,
1071 1072
	.suspend = tuner_suspend,
	.resume  = tuner_resume,
L
Linus Torvalds 已提交
1073
	.driver = {
1074 1075
		.name    = "tuner",
	},
L
Linus Torvalds 已提交
1076
};
M
Mauro Carvalho Chehab 已提交
1077
static struct i2c_client client_template = {
1078
	.name = "(tuner unset)",
M
Mauro Carvalho Chehab 已提交
1079
	.driver = &driver,
L
Linus Torvalds 已提交
1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101
};

static int __init tuner_init_module(void)
{
	return i2c_add_driver(&driver);
}

static void __exit tuner_cleanup_module(void)
{
	i2c_del_driver(&driver);
}

module_init(tuner_init_module);
module_exit(tuner_cleanup_module);

/*
 * Overrides for Emacs so that we follow Linus's tabbing style.
 * ---------------------------------------------------------------------------
 * Local variables:
 * c-basic-offset: 8
 * End:
 */