1 /* 2 * 3 * device driver for philips saa7134 based TV cards 4 * i2c interface support 5 * 6 * (c) 2001,02 Gerd Knorr <kraxel@bytesex.org> [SuSE Labs] 7 * 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. 12 * 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. 17 * 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. 21 */ 22 23 #include <linux/init.h> 24 #include <linux/list.h> 25 #include <linux/module.h> 26 #include <linux/kernel.h> 27 #include <linux/delay.h> 28 29 #include "saa7134-reg.h" 30 #include "saa7134.h" 31 #include <media/v4l2-common.h> 32 33 /* ----------------------------------------------------------- */ 34 35 static unsigned int i2c_debug; 36 module_param(i2c_debug, int, 0644); 37 MODULE_PARM_DESC(i2c_debug,"enable debug messages [i2c]"); 38 39 static unsigned int i2c_scan; 40 module_param(i2c_scan, int, 0444); 41 MODULE_PARM_DESC(i2c_scan,"scan i2c bus at insmod time"); 42 43 #define d1printk if (1 == i2c_debug) printk 44 #define d2printk if (2 == i2c_debug) printk 45 46 #define I2C_WAIT_DELAY 32 47 #define I2C_WAIT_RETRY 16 48 49 /* ----------------------------------------------------------- */ 50 51 static char *str_i2c_status[] = { 52 "IDLE", "DONE_STOP", "BUSY", "TO_SCL", "TO_ARB", "DONE_WRITE", 53 "DONE_READ", "DONE_WRITE_TO", "DONE_READ_TO", "NO_DEVICE", 54 "NO_ACKN", "BUS_ERR", "ARB_LOST", "SEQ_ERR", "ST_ERR", "SW_ERR" 55 }; 56 57 enum i2c_status { 58 IDLE = 0, // no I2C command pending 59 DONE_STOP = 1, // I2C command done and STOP executed 60 BUSY = 2, // executing I2C command 61 TO_SCL = 3, // executing I2C command, time out on clock stretching 62 TO_ARB = 4, // time out on arbitration trial, still trying 63 DONE_WRITE = 5, // I2C command done and awaiting next write command 64 DONE_READ = 6, // I2C command done and awaiting next read command 65 DONE_WRITE_TO = 7, // see 5, and time out on status echo 66 DONE_READ_TO = 8, // see 6, and time out on status echo 67 NO_DEVICE = 9, // no acknowledge on device slave address 68 NO_ACKN = 10, // no acknowledge after data byte transfer 69 BUS_ERR = 11, // bus error 70 ARB_LOST = 12, // arbitration lost during transfer 71 SEQ_ERR = 13, // erroneous programming sequence 72 ST_ERR = 14, // wrong status echoing 73 SW_ERR = 15 // software error 74 }; 75 76 static char *str_i2c_attr[] = { 77 "NOP", "STOP", "CONTINUE", "START" 78 }; 79 80 enum i2c_attr { 81 NOP = 0, // no operation on I2C bus 82 STOP = 1, // stop condition, no associated byte transfer 83 CONTINUE = 2, // continue with byte transfer 84 START = 3 // start condition with byte transfer 85 }; 86 87 static inline enum i2c_status i2c_get_status(struct saa7134_dev *dev) 88 { 89 enum i2c_status status; 90 91 status = saa_readb(SAA7134_I2C_ATTR_STATUS) & 0x0f; 92 d2printk(KERN_DEBUG "%s: i2c stat <= %s\n",dev->name, 93 str_i2c_status[status]); 94 return status; 95 } 96 97 static inline void i2c_set_status(struct saa7134_dev *dev, 98 enum i2c_status status) 99 { 100 d2printk(KERN_DEBUG "%s: i2c stat => %s\n",dev->name, 101 str_i2c_status[status]); 102 saa_andorb(SAA7134_I2C_ATTR_STATUS,0x0f,status); 103 } 104 105 static inline void i2c_set_attr(struct saa7134_dev *dev, enum i2c_attr attr) 106 { 107 d2printk(KERN_DEBUG "%s: i2c attr => %s\n",dev->name, 108 str_i2c_attr[attr]); 109 saa_andorb(SAA7134_I2C_ATTR_STATUS,0xc0,attr << 6); 110 } 111 112 static inline int i2c_is_error(enum i2c_status status) 113 { 114 switch (status) { 115 case NO_DEVICE: 116 case NO_ACKN: 117 case BUS_ERR: 118 case ARB_LOST: 119 case SEQ_ERR: 120 case ST_ERR: 121 return true; 122 default: 123 return false; 124 } 125 } 126 127 static inline int i2c_is_idle(enum i2c_status status) 128 { 129 switch (status) { 130 case IDLE: 131 case DONE_STOP: 132 return true; 133 default: 134 return false; 135 } 136 } 137 138 static inline int i2c_is_busy(enum i2c_status status) 139 { 140 switch (status) { 141 case BUSY: 142 case TO_SCL: 143 case TO_ARB: 144 return true; 145 default: 146 return false; 147 } 148 } 149 150 static int i2c_is_busy_wait(struct saa7134_dev *dev) 151 { 152 enum i2c_status status; 153 int count; 154 155 for (count = 0; count < I2C_WAIT_RETRY; count++) { 156 status = i2c_get_status(dev); 157 if (!i2c_is_busy(status)) 158 break; 159 saa_wait(I2C_WAIT_DELAY); 160 } 161 if (I2C_WAIT_RETRY == count) 162 return false; 163 return true; 164 } 165 166 static int i2c_reset(struct saa7134_dev *dev) 167 { 168 enum i2c_status status; 169 int count; 170 171 d2printk(KERN_DEBUG "%s: i2c reset\n",dev->name); 172 status = i2c_get_status(dev); 173 if (!i2c_is_error(status)) 174 return true; 175 i2c_set_status(dev,status); 176 177 for (count = 0; count < I2C_WAIT_RETRY; count++) { 178 status = i2c_get_status(dev); 179 if (!i2c_is_error(status)) 180 break; 181 udelay(I2C_WAIT_DELAY); 182 } 183 if (I2C_WAIT_RETRY == count) 184 return false; 185 186 if (!i2c_is_idle(status)) 187 return false; 188 189 i2c_set_attr(dev,NOP); 190 return true; 191 } 192 193 static inline int i2c_send_byte(struct saa7134_dev *dev, 194 enum i2c_attr attr, 195 unsigned char data) 196 { 197 enum i2c_status status; 198 __u32 dword; 199 200 /* have to write both attr + data in one 32bit word */ 201 dword = saa_readl(SAA7134_I2C_ATTR_STATUS >> 2); 202 dword &= 0x0f; 203 dword |= (attr << 6); 204 dword |= ((__u32)data << 8); 205 dword |= 0x00 << 16; /* 100 kHz */ 206 // dword |= 0x40 << 16; /* 400 kHz */ 207 dword |= 0xf0 << 24; 208 saa_writel(SAA7134_I2C_ATTR_STATUS >> 2, dword); 209 d2printk(KERN_DEBUG "%s: i2c data => 0x%x\n",dev->name,data); 210 211 if (!i2c_is_busy_wait(dev)) 212 return -EIO; 213 status = i2c_get_status(dev); 214 if (i2c_is_error(status)) 215 return -EIO; 216 return 0; 217 } 218 219 static inline int i2c_recv_byte(struct saa7134_dev *dev) 220 { 221 enum i2c_status status; 222 unsigned char data; 223 224 i2c_set_attr(dev,CONTINUE); 225 if (!i2c_is_busy_wait(dev)) 226 return -EIO; 227 status = i2c_get_status(dev); 228 if (i2c_is_error(status)) 229 return -EIO; 230 data = saa_readb(SAA7134_I2C_DATA); 231 d2printk(KERN_DEBUG "%s: i2c data <= 0x%x\n",dev->name,data); 232 return data; 233 } 234 235 static int saa7134_i2c_xfer(struct i2c_adapter *i2c_adap, 236 struct i2c_msg *msgs, int num) 237 { 238 struct saa7134_dev *dev = i2c_adap->algo_data; 239 enum i2c_status status; 240 unsigned char data; 241 int addr,rc,i,byte; 242 243 status = i2c_get_status(dev); 244 if (!i2c_is_idle(status)) 245 if (!i2c_reset(dev)) 246 return -EIO; 247 248 d2printk("start xfer\n"); 249 d1printk(KERN_DEBUG "%s: i2c xfer:",dev->name); 250 for (i = 0; i < num; i++) { 251 if (!(msgs[i].flags & I2C_M_NOSTART) || 0 == i) { 252 /* send address */ 253 d2printk("send address\n"); 254 addr = msgs[i].addr << 1; 255 if (msgs[i].flags & I2C_M_RD) 256 addr |= 1; 257 if (i > 0 && msgs[i].flags & 258 I2C_M_RD && msgs[i].addr != 0x40 && 259 msgs[i].addr != 0x41 && 260 msgs[i].addr != 0x19) { 261 /* workaround for a saa7134 i2c bug 262 * needed to talk to the mt352 demux 263 * thanks to pinnacle for the hint */ 264 int quirk = 0xfe; 265 d1printk(" [%02x quirk]",quirk); 266 i2c_send_byte(dev,START,quirk); 267 i2c_recv_byte(dev); 268 } 269 d1printk(" < %02x", addr); 270 rc = i2c_send_byte(dev,START,addr); 271 if (rc < 0) 272 goto err; 273 } 274 if (msgs[i].flags & I2C_M_RD) { 275 /* read bytes */ 276 d2printk("read bytes\n"); 277 for (byte = 0; byte < msgs[i].len; byte++) { 278 d1printk(" ="); 279 rc = i2c_recv_byte(dev); 280 if (rc < 0) 281 goto err; 282 d1printk("%02x", rc); 283 msgs[i].buf[byte] = rc; 284 } 285 /* discard mysterious extra byte when reading 286 from Samsung S5H1411. i2c bus gets error 287 if we do not. */ 288 if (0x19 == msgs[i].addr) { 289 d1printk(" ?"); 290 rc = i2c_recv_byte(dev); 291 if (rc < 0) 292 goto err; 293 d1printk("%02x", rc); 294 } 295 } else { 296 /* write bytes */ 297 d2printk("write bytes\n"); 298 for (byte = 0; byte < msgs[i].len; byte++) { 299 data = msgs[i].buf[byte]; 300 d1printk(" %02x", data); 301 rc = i2c_send_byte(dev,CONTINUE,data); 302 if (rc < 0) 303 goto err; 304 } 305 } 306 } 307 d2printk("xfer done\n"); 308 d1printk(" >"); 309 i2c_set_attr(dev,STOP); 310 rc = -EIO; 311 if (!i2c_is_busy_wait(dev)) 312 goto err; 313 status = i2c_get_status(dev); 314 if (i2c_is_error(status)) 315 goto err; 316 /* ensure that the bus is idle for at least one bit slot */ 317 msleep(1); 318 319 d1printk("\n"); 320 return num; 321 err: 322 if (1 == i2c_debug) { 323 status = i2c_get_status(dev); 324 printk(" ERROR: %s\n",str_i2c_status[status]); 325 } 326 return rc; 327 } 328 329 /* ----------------------------------------------------------- */ 330 331 static u32 functionality(struct i2c_adapter *adap) 332 { 333 return I2C_FUNC_SMBUS_EMUL; 334 } 335 336 static struct i2c_algorithm saa7134_algo = { 337 .master_xfer = saa7134_i2c_xfer, 338 .functionality = functionality, 339 }; 340 341 static struct i2c_adapter saa7134_adap_template = { 342 .owner = THIS_MODULE, 343 .name = "saa7134", 344 .algo = &saa7134_algo, 345 }; 346 347 static struct i2c_client saa7134_client_template = { 348 .name = "saa7134 internal", 349 }; 350 351 /* ----------------------------------------------------------- */ 352 353 static int 354 saa7134_i2c_eeprom(struct saa7134_dev *dev, unsigned char *eedata, int len) 355 { 356 unsigned char buf; 357 int i,err; 358 359 dev->i2c_client.addr = 0xa0 >> 1; 360 buf = 0; 361 if (1 != (err = i2c_master_send(&dev->i2c_client,&buf,1))) { 362 printk(KERN_INFO "%s: Huh, no eeprom present (err=%d)?\n", 363 dev->name,err); 364 return -1; 365 } 366 if (len != (err = i2c_master_recv(&dev->i2c_client,eedata,len))) { 367 printk(KERN_WARNING "%s: i2c eeprom read error (err=%d)\n", 368 dev->name,err); 369 return -1; 370 } 371 for (i = 0; i < len; i++) { 372 if (0 == (i % 16)) 373 printk(KERN_INFO "%s: i2c eeprom %02x:",dev->name,i); 374 printk(" %02x",eedata[i]); 375 if (15 == (i % 16)) 376 printk("\n"); 377 } 378 return 0; 379 } 380 381 static char *i2c_devs[128] = { 382 [ 0x20 ] = "mpeg encoder (saa6752hs)", 383 [ 0xa0 >> 1 ] = "eeprom", 384 [ 0xc0 >> 1 ] = "tuner (analog)", 385 [ 0x86 >> 1 ] = "tda9887", 386 [ 0x5a >> 1 ] = "remote control", 387 }; 388 389 static void do_i2c_scan(char *name, struct i2c_client *c) 390 { 391 unsigned char buf; 392 int i,rc; 393 394 for (i = 0; i < ARRAY_SIZE(i2c_devs); i++) { 395 c->addr = i; 396 rc = i2c_master_recv(c,&buf,0); 397 if (rc < 0) 398 continue; 399 printk("%s: i2c scan: found device @ 0x%x [%s]\n", 400 name, i << 1, i2c_devs[i] ? i2c_devs[i] : "???"); 401 } 402 } 403 404 int saa7134_i2c_register(struct saa7134_dev *dev) 405 { 406 dev->i2c_adap = saa7134_adap_template; 407 dev->i2c_adap.dev.parent = &dev->pci->dev; 408 strcpy(dev->i2c_adap.name,dev->name); 409 dev->i2c_adap.algo_data = dev; 410 i2c_set_adapdata(&dev->i2c_adap, &dev->v4l2_dev); 411 i2c_add_adapter(&dev->i2c_adap); 412 413 dev->i2c_client = saa7134_client_template; 414 dev->i2c_client.adapter = &dev->i2c_adap; 415 416 saa7134_i2c_eeprom(dev,dev->eedata,sizeof(dev->eedata)); 417 if (i2c_scan) 418 do_i2c_scan(dev->name,&dev->i2c_client); 419 420 /* Instantiate the IR receiver device, if present */ 421 saa7134_probe_i2c_ir(dev); 422 return 0; 423 } 424 425 int saa7134_i2c_unregister(struct saa7134_dev *dev) 426 { 427 i2c_del_adapter(&dev->i2c_adap); 428 return 0; 429 } 430