3 * device driver for philips saa7134 based TV cards
4 * i2c interface support
6 * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include <linux/init.h>
24 #include <linux/list.h>
25 #include <linux/module.h>
26 #include <linux/kernel.h>
27 #include <linux/slab.h>
28 #include <linux/delay.h>
30 #include "saa7134-reg.h"
32 #include <media/v4l2-common.h>
34 /* ----------------------------------------------------------- */
36 static unsigned int i2c_debug = 0;
37 module_param(i2c_debug, int, 0644);
38 MODULE_PARM_DESC(i2c_debug,"enable debug messages [i2c]");
40 static unsigned int i2c_scan = 0;
41 module_param(i2c_scan, int, 0444);
42 MODULE_PARM_DESC(i2c_scan,"scan i2c bus at insmod time");
44 #define d1printk if (1 == i2c_debug) printk
45 #define d2printk if (2 == i2c_debug) printk
47 #define I2C_WAIT_DELAY 32
48 #define I2C_WAIT_RETRY 16
50 /* ----------------------------------------------------------- */
52 static char *str_i2c_status[] = {
53 "IDLE", "DONE_STOP", "BUSY", "TO_SCL", "TO_ARB", "DONE_WRITE",
54 "DONE_READ", "DONE_WRITE_TO", "DONE_READ_TO", "NO_DEVICE",
55 "NO_ACKN", "BUS_ERR", "ARB_LOST", "SEQ_ERR", "ST_ERR", "SW_ERR"
59 IDLE = 0, // no I2C command pending
60 DONE_STOP = 1, // I2C command done and STOP executed
61 BUSY = 2, // executing I2C command
62 TO_SCL = 3, // executing I2C command, time out on clock stretching
63 TO_ARB = 4, // time out on arbitration trial, still trying
64 DONE_WRITE = 5, // I2C command done and awaiting next write command
65 DONE_READ = 6, // I2C command done and awaiting next read command
66 DONE_WRITE_TO = 7, // see 5, and time out on status echo
67 DONE_READ_TO = 8, // see 6, and time out on status echo
68 NO_DEVICE = 9, // no acknowledge on device slave address
69 NO_ACKN = 10, // no acknowledge after data byte transfer
70 BUS_ERR = 11, // bus error
71 ARB_LOST = 12, // arbitration lost during transfer
72 SEQ_ERR = 13, // erroneous programming sequence
73 ST_ERR = 14, // wrong status echoing
74 SW_ERR = 15 // software error
77 static char *str_i2c_attr[] = {
78 "NOP", "STOP", "CONTINUE", "START"
82 NOP = 0, // no operation on I2C bus
83 STOP = 1, // stop condition, no associated byte transfer
84 CONTINUE = 2, // continue with byte transfer
85 START = 3 // start condition with byte transfer
88 static inline enum i2c_status i2c_get_status(struct saa7134_dev *dev)
90 enum i2c_status status;
92 status = saa_readb(SAA7134_I2C_ATTR_STATUS) & 0x0f;
93 d2printk(KERN_DEBUG "%s: i2c stat <= %s\n",dev->name,
94 str_i2c_status[status]);
98 static inline void i2c_set_status(struct saa7134_dev *dev,
99 enum i2c_status status)
101 d2printk(KERN_DEBUG "%s: i2c stat => %s\n",dev->name,
102 str_i2c_status[status]);
103 saa_andorb(SAA7134_I2C_ATTR_STATUS,0x0f,status);
106 static inline void i2c_set_attr(struct saa7134_dev *dev, enum i2c_attr attr)
108 d2printk(KERN_DEBUG "%s: i2c attr => %s\n",dev->name,
110 saa_andorb(SAA7134_I2C_ATTR_STATUS,0xc0,attr << 6);
113 static inline int i2c_is_error(enum i2c_status status)
128 static inline int i2c_is_idle(enum i2c_status status)
139 static inline int i2c_is_busy(enum i2c_status status)
149 static int i2c_is_busy_wait(struct saa7134_dev *dev)
151 enum i2c_status status;
154 for (count = 0; count < I2C_WAIT_RETRY; count++) {
155 status = i2c_get_status(dev);
156 if (!i2c_is_busy(status))
158 saa_wait(I2C_WAIT_DELAY);
160 if (I2C_WAIT_RETRY == count)
165 static int i2c_reset(struct saa7134_dev *dev)
167 enum i2c_status status;
170 d2printk(KERN_DEBUG "%s: i2c reset\n",dev->name);
171 status = i2c_get_status(dev);
172 if (!i2c_is_error(status))
174 i2c_set_status(dev,status);
176 for (count = 0; count < I2C_WAIT_RETRY; count++) {
177 status = i2c_get_status(dev);
178 if (!i2c_is_error(status))
180 udelay(I2C_WAIT_DELAY);
182 if (I2C_WAIT_RETRY == count)
185 if (!i2c_is_idle(status))
188 i2c_set_attr(dev,NOP);
192 static inline int i2c_send_byte(struct saa7134_dev *dev,
196 enum i2c_status status;
199 /* have to write both attr + data in one 32bit word */
200 dword = saa_readl(SAA7134_I2C_ATTR_STATUS >> 2);
202 dword |= (attr << 6);
203 dword |= ((__u32)data << 8);
204 dword |= 0x00 << 16; /* 100 kHz */
205 // dword |= 0x40 << 16; /* 400 kHz */
207 saa_writel(SAA7134_I2C_ATTR_STATUS >> 2, dword);
208 d2printk(KERN_DEBUG "%s: i2c data => 0x%x\n",dev->name,data);
210 if (!i2c_is_busy_wait(dev))
212 status = i2c_get_status(dev);
213 if (i2c_is_error(status))
218 static inline int i2c_recv_byte(struct saa7134_dev *dev)
220 enum i2c_status status;
223 i2c_set_attr(dev,CONTINUE);
224 if (!i2c_is_busy_wait(dev))
226 status = i2c_get_status(dev);
227 if (i2c_is_error(status))
229 data = saa_readb(SAA7134_I2C_DATA);
230 d2printk(KERN_DEBUG "%s: i2c data <= 0x%x\n",dev->name,data);
234 static int saa7134_i2c_xfer(struct i2c_adapter *i2c_adap,
235 struct i2c_msg *msgs, int num)
237 struct saa7134_dev *dev = i2c_adap->algo_data;
238 enum i2c_status status;
242 status = i2c_get_status(dev);
243 if (!i2c_is_idle(status))
247 d2printk("start xfer\n");
248 d1printk(KERN_DEBUG "%s: i2c xfer:",dev->name);
249 for (i = 0; i < num; i++) {
250 if (!(msgs[i].flags & I2C_M_NOSTART) || 0 == i) {
252 d2printk("send address\n");
253 addr = msgs[i].addr << 1;
254 if (msgs[i].flags & I2C_M_RD)
256 if (i > 0 && msgs[i].flags & I2C_M_RD) {
257 /* workaround for a saa7134 i2c bug
258 * needed to talk to the mt352 demux
259 * thanks to pinnacle for the hint */
261 d1printk(" [%02x quirk]",quirk);
262 i2c_send_byte(dev,START,quirk);
265 d1printk(" < %02x", addr);
266 rc = i2c_send_byte(dev,START,addr);
270 if (msgs[i].flags & I2C_M_RD) {
272 d2printk("read bytes\n");
273 for (byte = 0; byte < msgs[i].len; byte++) {
275 rc = i2c_recv_byte(dev);
278 d1printk("%02x", rc);
279 msgs[i].buf[byte] = rc;
283 d2printk("write bytes\n");
284 for (byte = 0; byte < msgs[i].len; byte++) {
285 data = msgs[i].buf[byte];
286 d1printk(" %02x", data);
287 rc = i2c_send_byte(dev,CONTINUE,data);
293 d2printk("xfer done\n");
295 i2c_set_attr(dev,STOP);
297 if (!i2c_is_busy_wait(dev))
299 status = i2c_get_status(dev);
300 if (i2c_is_error(status))
302 /* ensure that the bus is idle for at least one bit slot */
308 if (1 == i2c_debug) {
309 status = i2c_get_status(dev);
310 printk(" ERROR: %s\n",str_i2c_status[status]);
315 /* ----------------------------------------------------------- */
317 static u32 functionality(struct i2c_adapter *adap)
319 return I2C_FUNC_SMBUS_EMUL;
322 static int attach_inform(struct i2c_client *client)
324 struct saa7134_dev *dev = client->adapter->algo_data;
325 int tuner = dev->tuner_type;
326 struct tuner_setup tun_setup;
328 d1printk( "%s i2c attach [addr=0x%x,client=%s]\n",
329 client->driver->driver.name, client->addr, client->name);
331 /* Am I an i2c remote control? */
333 switch (client->addr) {
339 struct IR_i2c *ir = i2c_get_clientdata(client);
340 d1printk("%s i2c IR detected (%s).\n",
341 client->driver->driver.name, ir->phys);
342 saa7134_set_i2c_ir(dev,ir);
347 if (!client->driver->command)
350 if (saa7134_boards[dev->board].radio_type != UNSET) {
352 tun_setup.type = saa7134_boards[dev->board].radio_type;
353 tun_setup.addr = saa7134_boards[dev->board].radio_addr;
355 if ((tun_setup.addr == ADDR_UNSET) || (tun_setup.addr == client->addr)) {
356 tun_setup.mode_mask = T_RADIO;
358 client->driver->command(client, TUNER_SET_TYPE_ADDR, &tun_setup);
362 if (tuner != UNSET) {
363 tun_setup.type = tuner;
364 tun_setup.addr = saa7134_boards[dev->board].tuner_addr;
365 tun_setup.config = saa7134_boards[dev->board].tuner_config;
366 tun_setup.tuner_callback = saa7134_tuner_callback;
368 if ((tun_setup.addr == ADDR_UNSET)||(tun_setup.addr == client->addr)) {
370 tun_setup.mode_mask = T_ANALOG_TV;
372 client->driver->command(client,TUNER_SET_TYPE_ADDR, &tun_setup);
375 if (tuner == TUNER_TDA9887) {
376 struct v4l2_priv_tun_config tda9887_cfg;
378 tda9887_cfg.tuner = TUNER_TDA9887;
379 tda9887_cfg.priv = &dev->tda9887_conf;
381 client->driver->command(client, TUNER_SET_CONFIG,
390 static struct i2c_algorithm saa7134_algo = {
391 .master_xfer = saa7134_i2c_xfer,
392 .functionality = functionality,
395 static struct i2c_adapter saa7134_adap_template = {
396 .owner = THIS_MODULE,
397 .class = I2C_CLASS_TV_ANALOG,
399 .id = I2C_HW_SAA7134,
400 .algo = &saa7134_algo,
401 .client_register = attach_inform,
404 static struct i2c_client saa7134_client_template = {
405 .name = "saa7134 internal",
408 /* ----------------------------------------------------------- */
411 saa7134_i2c_eeprom(struct saa7134_dev *dev, unsigned char *eedata, int len)
416 dev->i2c_client.addr = 0xa0 >> 1;
418 if (1 != (err = i2c_master_send(&dev->i2c_client,&buf,1))) {
419 printk(KERN_INFO "%s: Huh, no eeprom present (err=%d)?\n",
423 if (len != (err = i2c_master_recv(&dev->i2c_client,eedata,len))) {
424 printk(KERN_WARNING "%s: i2c eeprom read error (err=%d)\n",
428 for (i = 0; i < len; i++) {
430 printk(KERN_INFO "%s: i2c eeprom %02x:",dev->name,i);
431 printk(" %02x",eedata[i]);
438 static char *i2c_devs[128] = {
439 [ 0x20 ] = "mpeg encoder (saa6752hs)",
440 [ 0xa0 >> 1 ] = "eeprom",
441 [ 0xc0 >> 1 ] = "tuner (analog)",
442 [ 0x86 >> 1 ] = "tda9887",
443 [ 0x5a >> 1 ] = "remote control",
446 static void do_i2c_scan(char *name, struct i2c_client *c)
451 for (i = 0; i < ARRAY_SIZE(i2c_devs); i++) {
453 rc = i2c_master_recv(c,&buf,0);
456 printk("%s: i2c scan: found device @ 0x%x [%s]\n",
457 name, i << 1, i2c_devs[i] ? i2c_devs[i] : "???");
461 void saa7134_i2c_call_clients(struct saa7134_dev *dev,
462 unsigned int cmd, void *arg)
464 BUG_ON(NULL == dev->i2c_adap.algo_data);
465 i2c_clients_command(&dev->i2c_adap, cmd, arg);
468 int saa7134_i2c_register(struct saa7134_dev *dev)
470 dev->i2c_adap = saa7134_adap_template;
471 dev->i2c_adap.dev.parent = &dev->pci->dev;
472 strcpy(dev->i2c_adap.name,dev->name);
473 dev->i2c_adap.algo_data = dev;
474 i2c_add_adapter(&dev->i2c_adap);
476 dev->i2c_client = saa7134_client_template;
477 dev->i2c_client.adapter = &dev->i2c_adap;
479 saa7134_i2c_eeprom(dev,dev->eedata,sizeof(dev->eedata));
481 do_i2c_scan(dev->name,&dev->i2c_client);
485 int saa7134_i2c_unregister(struct saa7134_dev *dev)
487 i2c_del_adapter(&dev->i2c_adap);
491 /* ----------------------------------------------------------- */