2 * saa711x - Philips SAA711x video decoder driver version 0.0.1
4 * To do: Now, it handles only saa7113/7114. Should be improved to
5 * handle all Philips saa711x devices.
7 * Based on saa7113 driver from Dave Perks <dperks@ibm.net>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #include <linux/module.h>
25 #include <linux/init.h>
26 #include <linux/delay.h>
27 #include <linux/errno.h>
29 #include <linux/kernel.h>
30 #include <linux/major.h>
31 #include <linux/slab.h>
33 #include <linux/pci.h>
34 #include <linux/signal.h>
36 #include <asm/pgtable.h>
38 #include <linux/sched.h>
39 #include <linux/types.h>
40 #include <asm/uaccess.h>
41 #include <linux/videodev.h>
43 MODULE_DESCRIPTION("Philips SAA711x video decoder driver");
44 MODULE_AUTHOR("Dave Perks, Jose Ignacio Gijon, Joerg Heckenbach, Mark McClelland, Dwaine Garden");
45 MODULE_LICENSE("GPL");
47 #include <linux/i2c.h>
48 #include <linux/i2c-dev.h>
50 #define I2C_NAME(s) (s)->name
52 #include <linux/video_decoder.h>
55 module_param(debug, int, 0644);
56 MODULE_PARM_DESC(debug, " Set the default Debug level. Default: 0 (Off) - (0-1)");
59 #define dprintk(num, format, args...) \
62 printk(format, ##args); \
65 /* ----------------------------------------------------------------------- */
68 unsigned char reg[32];
79 #define I2C_SAA7113 0x4A
80 #define I2C_SAA7114 0x42
82 /* ----------------------------------------------------------------------- */
85 saa711x_write (struct i2c_client *client,
89 struct saa711x *decoder = i2c_get_clientdata(client);
91 decoder->reg[reg] = value;
92 return i2c_smbus_write_byte_data(client, reg, value);
96 saa711x_write_block (struct i2c_client *client,
103 /* the saa711x has an autoincrement function, use it if
104 * the adapter understands raw I2C */
105 if (i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
106 /* do raw I2C, not smbus compatible */
107 struct saa711x *decoder = i2c_get_clientdata(client);
111 msg.addr = client->addr;
114 msg.buf = (char *) block_data;
116 block_data[msg.len++] = reg = data[0];
118 block_data[msg.len++] =
119 decoder->reg[reg++] = data[1];
122 } while (len >= 2 && data[0] == reg &&
124 if ((ret = i2c_transfer(client->adapter,
129 /* do some slow I2C emulation kind of thing */
132 if ((ret = saa711x_write(client, reg,
143 saa711x_init_decoder (struct i2c_client *client,
144 struct video_decoder_init *init)
146 return saa711x_write_block(client, init->data, init->len);
150 saa711x_read (struct i2c_client *client,
153 return i2c_smbus_read_byte_data(client, reg);
156 /* ----------------------------------------------------------------------- */
158 static const unsigned char saa711x_i2c_init[] = {
159 0x00, 0x00, /* PH711x_CHIP_VERSION 00 - ID byte */
160 0x01, 0x08, /* PH711x_INCREMENT_DELAY - (1) (1) (1) (1) IDEL3 IDEL2 IDELL1 IDEL0 */
161 0x02, 0xc0, /* PH711x_ANALOG_INPUT_CONTR_1 - FUSE1 FUSE0 GUDL1 GUDL0 MODE3 MODE2 MODE1 MODE0 */
162 0x03, 0x23, /* PH711x_ANALOG_INPUT_CONTR_2 - (1) HLNRS VBSL WPOFF HOLDG GAFIX GAI28 GAI18 */
163 0x04, 0x00, /* PH711x_ANALOG_INPUT_CONTR_3 - GAI17 GAI16 GAI15 GAI14 GAI13 GAI12 GAI11 GAI10 */
164 0x05, 0x00, /* PH711x_ANALOG_INPUT_CONTR_4 - GAI27 GAI26 GAI25 GAI24 GAI23 GAI22 GAI21 GAI20 */
165 0x06, 0xeb, /* PH711x_HORIZONTAL_SYNC_START - HSB7 HSB6 HSB5 HSB4 HSB3 HSB2 HSB1 HSB0 */
166 0x07, 0xe0, /* PH711x_HORIZONTAL_SYNC_STOP - HSS7 HSS6 HSS5 HSS4 HSS3 HSS2 HSS1 HSS0 */
167 0x08, 0x88, /* PH711x_SYNC_CONTROL - AUFD FSEL FOET HTC1 HTC0 HPLL VNOI1 VNOI0 */
168 0x09, 0x00, /* PH711x_LUMINANCE_CONTROL - BYPS PREF BPSS1 BPSS0 VBLB UPTCV APER1 APER0 */
169 0x0a, 0x80, /* PH711x_LUMINANCE_BRIGHTNESS - BRIG7 BRIG6 BRIG5 BRIG4 BRIG3 BRIG2 BRIG1 BRIG0 */
170 0x0b, 0x47, /* PH711x_LUMINANCE_CONTRAST - CONT7 CONT6 CONT5 CONT4 CONT3 CONT2 CONT1 CONT0 */
171 0x0c, 0x40, /* PH711x_CHROMA_SATURATION - SATN7 SATN6 SATN5 SATN4 SATN3 SATN2 SATN1 SATN0 */
172 0x0d, 0x00, /* PH711x_CHROMA_HUE_CONTROL - HUEC7 HUEC6 HUEC5 HUEC4 HUEC3 HUEC2 HUEC1 HUEC0 */
173 0x0e, 0x01, /* PH711x_CHROMA_CONTROL - CDTO CSTD2 CSTD1 CSTD0 DCCF FCTC CHBW1 CHBW0 */
174 0x0f, 0xaa, /* PH711x_CHROMA_GAIN_CONTROL - ACGC CGAIN6 CGAIN5 CGAIN4 CGAIN3 CGAIN2 CGAIN1 CGAIN0 */
175 0x10, 0x00, /* PH711x_FORMAT_DELAY_CONTROL - OFTS1 OFTS0 HDEL1 HDEL0 VRLN YDEL2 YDEL1 YDEL0 */
176 0x11, 0x1C, /* PH711x_OUTPUT_CONTROL_1 - GPSW1 CM99 GPSW0 HLSEL OEYC OERT VIPB COLO */
177 0x12, 0x01, /* PH711x_OUTPUT_CONTROL_2 - RTSE13 RTSE12 RTSE11 RTSE10 RTSE03 RTSE02 RTSE01 RTSE00 */
178 0x13, 0x00, /* PH711x_OUTPUT_CONTROL_3 - ADLSB (1) (1) OLDSB FIDP (1) AOSL1 AOSL0 */
179 0x14, 0x00, /* RESERVED 14 - (1) (1) (1) (1) (1) (1) (1) (1) */
180 0x15, 0x00, /* PH711x_V_GATE1_START - VSTA7 VSTA6 VSTA5 VSTA4 VSTA3 VSTA2 VSTA1 VSTA0 */
181 0x16, 0x00, /* PH711x_V_GATE1_STOP - VSTO7 VSTO6 VSTO5 VSTO4 VSTO3 VSTO2 VSTO1 VSTO0 */
182 0x17, 0x00, /* PH711x_V_GATE1_MSB - (1) (1) (1) (1) (1) (1) VSTO8 VSTA8 */
186 saa711x_command (struct i2c_client *client,
190 struct saa711x *decoder = i2c_get_clientdata(client);
197 struct video_decoder_init *init = arg;
199 return saa711x_init_decoder(client, init);
201 struct video_decoder_init vdi;
202 vdi.data = saa711x_i2c_init;
203 vdi.len = sizeof(saa711x_i2c_init);
204 return saa711x_init_decoder(client, &vdi);
212 for (i = 0; i < 32; i += 16) {
215 printk(KERN_DEBUG "%s: %03x", I2C_NAME(client), i);
216 for (j = 0; j < 16; ++j) {
218 saa711x_read(client, i + j));
225 case DECODER_GET_CAPABILITIES:
227 struct video_decoder_capability *cap = arg;
229 cap->flags = VIDEO_DECODER_PAL |
231 VIDEO_DECODER_SECAM |
239 case DECODER_GET_STATUS:
245 status = saa711x_read(client, 0x1f);
246 dprintk(1, KERN_DEBUG "%s status: 0x%02x\n", I2C_NAME(client),
249 if ((status & (1 << 6)) == 0) {
250 res |= DECODER_STATUS_GOOD;
252 switch (decoder->norm) {
253 case VIDEO_MODE_NTSC:
254 res |= DECODER_STATUS_NTSC;
257 res |= DECODER_STATUS_PAL;
259 case VIDEO_MODE_SECAM:
260 res |= DECODER_STATUS_SECAM;
263 case VIDEO_MODE_AUTO:
264 if ((status & (1 << 5)) != 0) {
265 res |= DECODER_STATUS_NTSC;
267 res |= DECODER_STATUS_PAL;
271 if ((status & (1 << 0)) != 0) {
272 res |= DECODER_STATUS_COLOR;
278 case DECODER_SET_GPIO:
282 saa711x_write(client, 0x11,
283 (decoder->reg[0x11] | 0x80));
285 saa711x_write(client, 0x11,
286 (decoder->reg[0x11] & 0x7f));
291 case DECODER_SET_VBI_BYPASS:
295 saa711x_write(client, 0x13,
296 (decoder->reg[0x13] & 0xf0) | 0x0a);
298 saa711x_write(client, 0x13,
299 (decoder->reg[0x13] & 0xf0));
304 case DECODER_SET_NORM:
310 case VIDEO_MODE_NTSC:
311 saa711x_write(client, 0x08,
312 (decoder->reg[0x08] & 0x3f) | 0x40);
313 saa711x_write(client, 0x0e,
314 (decoder->reg[0x0e] & 0x8f));
318 saa711x_write(client, 0x08,
319 (decoder->reg[0x08] & 0x3f) | 0x00);
320 saa711x_write(client, 0x0e,
321 (decoder->reg[0x0e] & 0x8f));
324 case VIDEO_MODE_SECAM:
325 saa711x_write(client, 0x08,
326 (decoder->reg[0x08] & 0x3f) | 0x00);
327 saa711x_write(client, 0x0e,
328 (decoder->reg[0x0e] & 0x8f) | 0x50);
331 case VIDEO_MODE_AUTO:
332 saa711x_write(client, 0x08,
333 (decoder->reg[0x08] & 0x3f) | 0x80);
334 saa711x_write(client, 0x0e,
335 (decoder->reg[0x0e] & 0x8f));
342 decoder->norm = *iarg;
346 case DECODER_SET_INPUT:
349 if (*iarg < 0 || *iarg > 9) {
352 if (decoder->input != *iarg) {
353 decoder->input = *iarg;
355 saa711x_write(client, 0x02,
356 (decoder->reg[0x02] & 0xf0) | decoder->input);
357 /* bypass chrominance trap for modes 4..7 */
358 saa711x_write(client, 0x09,
359 (decoder->reg[0x09] & 0x7f) | ((decoder->input > 3) ? 0x80 : 0));
364 case DECODER_SET_OUTPUT:
368 /* not much choice of outputs */
375 case DECODER_ENABLE_OUTPUT:
378 int enable = (*iarg != 0);
380 if (decoder->enable != enable) {
381 decoder->enable = enable;
383 /* RJ: If output should be disabled (for
384 * playing videos), we also need a open PLL.
385 * The input is set to 0 (where no input
386 * source is connected), although this
389 * If output should be enabled, we have to
393 if (decoder->enable) {
394 saa711x_write(client, 0x02,
398 saa711x_write(client, 0x08,
399 (decoder->reg[0x08] & 0xfb));
400 saa711x_write(client, 0x11,
402 reg[0x11] & 0xf3) | 0x0c);
404 saa711x_write(client, 0x02,
405 (decoder->reg[0x02] & 0xf8));
406 saa711x_write(client, 0x08,
408 reg[0x08] & 0xfb) | 0x04);
409 saa711x_write(client, 0x11,
410 (decoder->reg[0x11] & 0xf3));
416 case DECODER_SET_PICTURE:
418 struct video_picture *pic = arg;
420 if (decoder->bright != pic->brightness) {
421 /* We want 0 to 255 we get 0-65535 */
422 decoder->bright = pic->brightness;
423 saa711x_write(client, 0x0a, decoder->bright >> 8);
425 if (decoder->contrast != pic->contrast) {
426 /* We want 0 to 127 we get 0-65535 */
427 decoder->contrast = pic->contrast;
428 saa711x_write(client, 0x0b,
429 decoder->contrast >> 9);
431 if (decoder->sat != pic->colour) {
432 /* We want 0 to 127 we get 0-65535 */
433 decoder->sat = pic->colour;
434 saa711x_write(client, 0x0c, decoder->sat >> 9);
436 if (decoder->hue != pic->hue) {
437 /* We want -128 to 127 we get 0-65535 */
438 decoder->hue = pic->hue;
439 saa711x_write(client, 0x0d,
440 (decoder->hue - 32768) >> 8);
452 /* ----------------------------------------------------------------------- */
456 * concerning the addresses: i2c wants 7 bit (without the r/w bit), so '>>1'
459 /* standard i2c insmod options */
460 static unsigned short normal_i2c[] = {
461 I2C_SAA7113>>1, /* saa7113 */
462 I2C_SAA7114>>1, /* saa7114 */
469 static struct i2c_driver i2c_driver_saa711x;
472 saa711x_detect_client (struct i2c_adapter *adapter,
477 struct i2c_client *client;
478 struct saa711x *decoder;
479 struct video_decoder_init vdi;
483 "saa711x.c: detecting saa711x client on address 0x%x\n",
486 /* Check if the adapter supports the needed features */
487 if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
490 client = kzalloc(sizeof(struct i2c_client), GFP_KERNEL);
493 client->addr = address;
494 client->adapter = adapter;
495 client->driver = &i2c_driver_saa711x;
496 strlcpy(I2C_NAME(client), "saa711x", sizeof(I2C_NAME(client)));
497 decoder = kzalloc(sizeof(struct saa711x), GFP_KERNEL);
498 if (decoder == NULL) {
502 decoder->norm = VIDEO_MODE_NTSC;
505 decoder->bright = 32768;
506 decoder->contrast = 32768;
507 decoder->hue = 32768;
508 decoder->sat = 32768;
509 i2c_set_clientdata(client, decoder);
511 i = i2c_attach_client(client);
518 vdi.data = saa711x_i2c_init;
519 vdi.len = sizeof(saa711x_i2c_init);
520 i = saa711x_init_decoder(client, &vdi);
522 dprintk(1, KERN_ERR "%s_attach error: init status %d\n",
523 I2C_NAME(client), i);
527 "%s_attach: chip version %x at address 0x%x\n",
528 I2C_NAME(client), saa711x_read(client, 0x00) >> 4,
536 saa711x_attach_adapter (struct i2c_adapter *adapter)
540 "saa711x.c: starting probe for adapter %s (0x%x)\n",
541 I2C_NAME(adapter), adapter->id);
542 return i2c_probe(adapter, &addr_data, &saa711x_detect_client);
546 saa711x_detach_client (struct i2c_client *client)
548 struct saa711x *decoder = i2c_get_clientdata(client);
551 err = i2c_detach_client(client);
562 /* ----------------------------------------------------------------------- */
564 static struct i2c_driver i2c_driver_saa711x = {
568 .id = I2C_DRIVERID_SAA711X,
569 .attach_adapter = saa711x_attach_adapter,
570 .detach_client = saa711x_detach_client,
571 .command = saa711x_command,
577 return i2c_add_driver(&i2c_driver_saa711x);
583 i2c_del_driver(&i2c_driver_saa711x);
586 module_init(saa711x_init);
587 module_exit(saa711x_exit);