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-xc2028.h"
28
#include "tuner-simple.h"
L
Linus Torvalds 已提交
29 30 31 32 33

#define UNSET (-1U)

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

L
Linus Torvalds 已提交
43 44 45
I2C_CLIENT_INSMOD;

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

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

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

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

60

61 62 63
module_param(addr, int, 0444);
module_param(no_autodetect, int, 0444);
module_param(show_i2c, int, 0444);
64
module_param_named(debug,tuner_debug, int, 0644);
65 66 67
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 已提交
68
module_param_array(tv_range, int, NULL, 0644);
L
Linus Torvalds 已提交
69 70 71 72 73 74 75 76 77 78 79
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;

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

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 113
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);
}

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

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

	return strength;
}

125
/* Set tuner frequency,  freq in Units of 62.5kHz = 1/16MHz */
L
Linus Torvalds 已提交
126 127 128 129 130
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 已提交
131
		tuner_warn ("tuner type not set\n");
L
Linus Torvalds 已提交
132 133
		return;
	}
134
	if (NULL == t->ops.set_tv_freq) {
M
Mauro Carvalho Chehab 已提交
135
		tuner_warn ("Tuner has no way to set tv freq\n");
L
Linus Torvalds 已提交
136 137
		return;
	}
M
Mauro Carvalho Chehab 已提交
138 139 140 141
	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]);
142 143 144 145 146 147
		/* 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 已提交
148
	}
149
	t->ops.set_tv_freq(t, freq);
L
Linus Torvalds 已提交
150 151 152 153 154 155 156
}

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 已提交
157
		tuner_warn ("tuner type not set\n");
L
Linus Torvalds 已提交
158 159
		return;
	}
160
	if (NULL == t->ops.set_radio_freq) {
M
Mauro Carvalho Chehab 已提交
161
		tuner_warn ("tuner has no way to set radio frequency\n");
L
Linus Torvalds 已提交
162 163
		return;
	}
164
	if (freq < radio_range[0] * 16000 || freq > radio_range[1] * 16000) {
M
Mauro Carvalho Chehab 已提交
165 166 167
		tuner_dbg ("radio freq (%d.%02d) out of range (%d-%d)\n",
			   freq / 16000, freq % 16000 * 100 / 16000,
			   radio_range[0], radio_range[1]);
168 169 170 171 172 173
		/* 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 已提交
174
	}
175

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

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

202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222
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");
}

223 224 225 226 227 228 229 230 231
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 已提交
232
static void set_type(struct i2c_client *c, unsigned int type,
233
		     unsigned int new_mode_mask, unsigned int new_config,
234
		     int (*tuner_callback) (void *dev, int command,int arg))
L
Linus Torvalds 已提交
235 236
{
	struct tuner *t = i2c_get_clientdata(c);
237
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
238
	unsigned char buffer[4];
L
Linus Torvalds 已提交
239

M
Mauro Carvalho Chehab 已提交
240 241
	if (type == UNSET || type == TUNER_ABSENT) {
		tuner_dbg ("tuner 0x%02x: Tuner type absent\n",c->addr);
L
Linus Torvalds 已提交
242
		return;
M
Mauro Carvalho Chehab 已提交
243 244 245 246
	}

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

250 251 252 253 254 255 256
	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 已提交
257
	/* This code detects calls by card attach_inform */
L
Linus Torvalds 已提交
258
	if (NULL == t->i2c.dev.driver) {
M
Mauro Carvalho Chehab 已提交
259 260
		tuner_dbg ("tuner 0x%02x: called during i2c_client register by adapter's attach_inform\n", c->addr);

L
Linus Torvalds 已提交
261 262
		return;
	}
263

264
	/* discard private data, in case set_type() was previously called */
265
	if (t->ops.release)
266
		t->ops.release(t);
267 268 269 270
	else {
		kfree(t->priv);
		t->priv = NULL;
	}
271

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

337 338
	if ((fe_tuner_ops->set_analog_params) &&
	    ((NULL == t->ops.set_tv_freq) && (NULL == t->ops.set_radio_freq))) {
339 340 341 342 343 344
		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;
345
		t->ops.has_signal     = fe_has_signal;
346 347 348 349
	}

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

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

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

M
Mauro Carvalho Chehab 已提交
360 361 362 363 364 365 366 367 368 369 370 371
/*
 * 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);

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

374 375 376 377
	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,
378
				 tun_setup->config, tun_setup->tuner_callback);
M
Mauro Carvalho Chehab 已提交
379 380
	}
}
381

M
Mauro Carvalho Chehab 已提交
382
static inline int check_mode(struct tuner *t, char *cmd)
383
{
384 385 386 387 388 389 390 391 392 393 394 395 396 397
	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;
398
	}
399
	return 0;
400 401
}

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

490 491 492 493 494 495 496 497 498 499 500 501
	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;
502 503 504 505 506
		case 'k':
		case 'K':
			tuner_dbg("insmod fixup: NTSC => NTSC_M_KR\n");
			t->std = V4L2_STD_NTSC_M_KR;
			break;
507 508 509 510 511 512 513 514
		case '-':
			/* default parameter, do nothing */
			break;
		default:
			tuner_info("ntsc= argument not recognised\n");
			break;
		}
	}
L
Linus Torvalds 已提交
515 516 517
	return 0;
}

518
static void tuner_status(struct tuner *t)
519 520
{
	unsigned long freq, freq_fraction;
521
	struct dvb_tuner_ops *fe_tuner_ops = &t->fe.ops.tuner_ops;
522 523 524 525 526 527 528 529 530
	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) {
531 532
		freq = t->radio_freq / 16000;
		freq_fraction = (t->radio_freq % 16000) * 100 / 16000;
533
	} else {
534 535
		freq = t->tv_freq / 16;
		freq_fraction = (t->tv_freq % 16) * 100 / 16;
536 537 538
	}
	tuner_info("Tuner mode:      %s\n", p);
	tuner_info("Frequency:       %lu.%02lu MHz\n", freq, freq_fraction);
539
	tuner_info("Standard:        0x%08lx\n", (unsigned long)t->std);
540 541
	if (t->mode != V4L2_TUNER_RADIO)
	       return;
542 543 544 545 546 547 548 549 550
	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");
	}
551
	if (t->ops.has_signal) {
552
		tuner_info("Signal strength: %d\n", t->ops.has_signal(t));
553
	}
554
	if (t->ops.is_stereo) {
555
		tuner_info("Stereo:          %s\n", t->ops.is_stereo(t) ? "yes" : "no");
556 557
	}
}
558

L
Linus Torvalds 已提交
559 560
/* ---------------------------------------------------------------------- */

561
/* static vars: used only in tuner_attach and tuner_probe */
M
Mauro Carvalho Chehab 已提交
562 563 564 565 566
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 已提交
567 568 569 570
static int tuner_attach(struct i2c_adapter *adap, int addr, int kind)
{
	struct tuner *t;

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

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

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

		memset(buffer, 0, sizeof(buffer));
		rc = i2c_master_recv(&t->i2c, buffer, sizeof(buffer));
590
		tuner_info("I2C RECV = ");
591 592 593 594
		for (i=0;i<rc;i++)
			printk("%02x ",buffer[i]);
		printk("\n");
	}
595 596 597 598
	/* 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;

599
	/* autodetection code based on the i2c addr */
600
	if (!no_autodetect) {
601
		switch (addr) {
602
		case 0x10:
603
			if (tea5761_autodetection(t->i2c.adapter, t->i2c.addr) != EINVAL) {
604 605 606 607 608 609 610 611 612
				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;
613 614 615
		case 0x42:
		case 0x43:
		case 0x4a:
616
		case 0x4b:
617 618
			/* If chip is not tda8290, don't register.
			   since it can be tda9887*/
619
			if (tda8290_probe(t) == 0) {
620 621 622 623 624 625 626
				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;
627
			}
628 629
			break;
		case 0x60:
630
			if (tea5767_autodetection(t->i2c.adapter, t->i2c.addr) != EINVAL) {
631 632 633
				t->type = TUNER_TEA5767;
				t->mode_mask = T_RADIO;
				t->mode = T_STANDBY;
634
				t->radio_freq = 87.5 * 16000; /* Sets freq to FM range */
635
				default_mode_mask &= ~T_RADIO;
636

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

M
Mauro Carvalho Chehab 已提交
643 644 645 646
	/* 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;
647 648
		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 已提交
649 650
		default_mode_mask = T_UNINITIALIZED;
	}
651

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

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

667 668 669 670
	/* 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.
	 */
671 672
	if ((adap->id == I2C_HW_B_CX2388x) ||
	    (adap->id == I2C_HW_B_CX23885)) {
673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688
		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 已提交
689
	default_mode_mask = T_RADIO | T_ANALOG_TV | T_DIGITAL_TV;
690

L
Linus Torvalds 已提交
691 692 693 694 695 696 697 698
	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);
699 700
	int err;

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

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

M
Mauro Carvalho Chehab 已提交
717 718 719 720 721 722 723 724 725
/*
 * 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)
{
726 727 728 729 730 731 732
	if (mode == t->mode)
		return 0;

	t->mode = mode;

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

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

static inline int check_v4l2(struct tuner *t)
{
746 747 748 749
	/* 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 已提交
750 751
	return 0;
}
L
Linus Torvalds 已提交
752

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

758
	if (tuner_debug>1)
759 760
		v4l_i2c_print_ioctl(&(t->i2c),cmd);

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

		set_addr(client, (struct tuner_setup *)arg);
771
		break;
L
Linus Torvalds 已提交
772
	case AUDC_SET_RADIO:
773 774 775 776 777
		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 已提交
778
		break;
779
	case TUNER_SET_STANDBY:
780 781
		if (check_mode(t, "TUNER_SET_STANDBY") == EINVAL)
			return 0;
782
		t->mode = T_STANDBY;
783
		if (t->ops.standby)
784
			t->ops.standby(t);
785
		break;
786
#ifdef CONFIG_VIDEO_V4L1
787 788 789 790 791 792 793 794
	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 已提交
795
		break;
L
Linus Torvalds 已提交
796
	case VIDIOCSCHAN:
M
Mauro Carvalho Chehab 已提交
797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816
		{
			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);
817 818
			if (t->tv_freq)
				set_tv_freq(client, t->tv_freq);
M
Mauro Carvalho Chehab 已提交
819 820
			return 0;
		}
L
Linus Torvalds 已提交
821
	case VIDIOCSFREQ:
M
Mauro Carvalho Chehab 已提交
822 823
		{
			unsigned long *v = arg;
L
Linus Torvalds 已提交
824

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

			set_freq(client, *v);
			return 0;
		}
L
Linus Torvalds 已提交
833
	case VIDIOCGTUNER:
M
Mauro Carvalho Chehab 已提交
834 835 836 837 838 839 840 841 842
		{
			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) {
843 844 845 846
				if (fe_tuner_ops->get_status) {
					u32 tuner_status;

					fe_tuner_ops->get_status(&t->fe, &tuner_status);
847 848 849 850
					if (tuner_status & TUNER_STATUS_STEREO)
						vt->flags |= VIDEO_TUNER_STEREO_ON;
					else
						vt->flags &= ~VIDEO_TUNER_STEREO_ON;
851 852 853 854 855 856 857 858 859
				} 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 已提交
860
				}
861 862 863
				if (t->ops.has_signal)
					vt->signal = t->ops.has_signal(t);

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

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

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

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

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

885 886 887 888 889 890 891 892 893 894 895
			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 已提交
896 897
			return 0;
		}
898
#endif
899 900 901 902 903 904 905
	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 已提交
906

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

		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);

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

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

M
Mauro Carvalho Chehab 已提交
933 934 935 936
			switch_v4l2();

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

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

M
Mauro Carvalho Chehab 已提交
951 952 953 954 955 956 957 958 959 960
			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;
961 962 963 964 965 966 967 968 969
			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;
			}
970 971
			f->frequency = (V4L2_TUNER_RADIO == t->mode) ?
				t->radio_freq : t->tv_freq;
M
Mauro Carvalho Chehab 已提交
972 973
			break;
		}
L
Linus Torvalds 已提交
974
	case VIDIOC_G_TUNER:
M
Mauro Carvalho Chehab 已提交
975 976 977 978 979 980 981
		{
			struct v4l2_tuner *tuner = arg;

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

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

			/* radio mode */
			tuner->rxsubchans =
				V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
996 997 998 999 1000
			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) ?
1001
					V4L2_TUNER_SUB_STEREO : V4L2_TUNER_SUB_MONO;
1002 1003 1004 1005 1006
			} else {
				if (t->ops.is_stereo) {
					tuner->rxsubchans = t->ops.is_stereo(t) ?
						V4L2_TUNER_SUB_STEREO : V4L2_TUNER_SUB_MONO;
				}
1007
			}
1008 1009
			if (t->ops.has_signal)
				tuner->signal = t->ops.has_signal(t);
1010 1011 1012 1013 1014
			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 已提交
1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025
			break;
		}
	case VIDIOC_S_TUNER:
		{
			struct v4l2_tuner *tuner = arg;

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

			switch_v4l2();

1026 1027 1028 1029 1030
			/* 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 已提交
1031
			break;
1032
		}
1033
	case VIDIOC_LOG_STATUS:
1034
		if (t->ops.tuner_status)
1035
			t->ops.tuner_status(t);
1036
		break;
L
Linus Torvalds 已提交
1037 1038 1039 1040 1041
	}

	return 0;
}

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

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

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

M
Mauro Carvalho Chehab 已提交
1055
	tuner_dbg ("resume\n");
1056 1057 1058 1059 1060 1061 1062
	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 已提交
1063 1064 1065 1066 1067 1068
	return 0;
}

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

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

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:
 */