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
int conf = dev->tda9887_conf;
327
struct tuner_setup tun_setup;
329
d1printk( "%s i2c attach [addr=0x%x,client=%s]\n",
330
client->driver->driver.name, client->addr, client->name);
332
/* Am I an i2c remote control? */
334
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) {
364
tun_setup.type = tuner;
365
tun_setup.addr = saa7134_boards[dev->board].tuner_addr;
366
tun_setup.config = saa7134_boards[dev->board].tuner_config;
367
tun_setup.tuner_callback = saa7134_tuner_callback;
369
if ((tun_setup.addr == ADDR_UNSET)||(tun_setup.addr == client->addr)) {
371
tun_setup.mode_mask = T_ANALOG_TV;
373
client->driver->command(client,TUNER_SET_TYPE_ADDR, &tun_setup);
377
client->driver->command(client, TDA9887_SET_CONFIG, &conf);
382
static struct i2c_algorithm saa7134_algo = {
383
.master_xfer = saa7134_i2c_xfer,
384
.functionality = functionality,
387
static struct i2c_adapter saa7134_adap_template = {
388
.owner = THIS_MODULE,
389
.class = I2C_CLASS_TV_ANALOG,
391
.id = I2C_HW_SAA7134,
392
.algo = &saa7134_algo,
393
.client_register = attach_inform,
396
static struct i2c_client saa7134_client_template = {
397
.name = "saa7134 internal",
400
/* ----------------------------------------------------------- */
403
saa7134_i2c_eeprom(struct saa7134_dev *dev, unsigned char *eedata, int len)
408
dev->i2c_client.addr = 0xa0 >> 1;
410
if (1 != (err = i2c_master_send(&dev->i2c_client,&buf,1))) {
411
printk(KERN_INFO "%s: Huh, no eeprom present (err=%d)?\n",
415
if (len != (err = i2c_master_recv(&dev->i2c_client,eedata,len))) {
416
printk(KERN_WARNING "%s: i2c eeprom read error (err=%d)\n",
420
for (i = 0; i < len; i++) {
422
printk(KERN_INFO "%s: i2c eeprom %02x:",dev->name,i);
423
printk(" %02x",eedata[i]);
430
static char *i2c_devs[128] = {
431
[ 0x20 ] = "mpeg encoder (saa6752hs)",
432
[ 0xa0 >> 1 ] = "eeprom",
433
[ 0xc0 >> 1 ] = "tuner (analog)",
434
[ 0x86 >> 1 ] = "tda9887",
437
static void do_i2c_scan(char *name, struct i2c_client *c)
442
for (i = 0; i < ARRAY_SIZE(i2c_devs); i++) {
444
rc = i2c_master_recv(c,&buf,0);
447
printk("%s: i2c scan: found device @ 0x%x [%s]\n",
448
name, i << 1, i2c_devs[i] ? i2c_devs[i] : "???");
452
void saa7134_i2c_call_clients(struct saa7134_dev *dev,
453
unsigned int cmd, void *arg)
455
BUG_ON(NULL == dev->i2c_adap.algo_data);
456
i2c_clients_command(&dev->i2c_adap, cmd, arg);
459
int saa7134_i2c_register(struct saa7134_dev *dev)
461
dev->i2c_adap = saa7134_adap_template;
462
dev->i2c_adap.dev.parent = &dev->pci->dev;
463
strcpy(dev->i2c_adap.name,dev->name);
464
dev->i2c_adap.algo_data = dev;
465
i2c_add_adapter(&dev->i2c_adap);
467
dev->i2c_client = saa7134_client_template;
468
dev->i2c_client.adapter = &dev->i2c_adap;
470
saa7134_i2c_eeprom(dev,dev->eedata,sizeof(dev->eedata));
472
do_i2c_scan(dev->name,&dev->i2c_client);
476
int saa7134_i2c_unregister(struct saa7134_dev *dev)
478
i2c_del_adapter(&dev->i2c_adap);
482
/* ----------------------------------------------------------- */