2 * TI DAVINCI I2C adapter driver.
4 * Copyright (C) 2006 Texas Instruments.
5 * Copyright (C) 2007 MontaVista Software Inc.
7 * Updated by Vinod & Sudhakar Feb 2005
9 * ----------------------------------------------------------------------------
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 * ----------------------------------------------------------------------------
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/delay.h>
30 #include <linux/i2c.h>
31 #include <linux/clk.h>
32 #include <linux/errno.h>
33 #include <linux/sched.h>
34 #include <linux/err.h>
35 #include <linux/interrupt.h>
36 #include <linux/platform_device.h>
38 #include <linux/slab.h>
40 #include <mach/hardware.h>
44 /* ----- global defines ----------------------------------------------- */
46 #define DAVINCI_I2C_TIMEOUT (1*HZ)
47 #define I2C_DAVINCI_INTR_ALL (DAVINCI_I2C_IMR_AAS | \
48 DAVINCI_I2C_IMR_SCD | \
49 DAVINCI_I2C_IMR_ARDY | \
50 DAVINCI_I2C_IMR_NACK | \
53 #define DAVINCI_I2C_OAR_REG 0x00
54 #define DAVINCI_I2C_IMR_REG 0x04
55 #define DAVINCI_I2C_STR_REG 0x08
56 #define DAVINCI_I2C_CLKL_REG 0x0c
57 #define DAVINCI_I2C_CLKH_REG 0x10
58 #define DAVINCI_I2C_CNT_REG 0x14
59 #define DAVINCI_I2C_DRR_REG 0x18
60 #define DAVINCI_I2C_SAR_REG 0x1c
61 #define DAVINCI_I2C_DXR_REG 0x20
62 #define DAVINCI_I2C_MDR_REG 0x24
63 #define DAVINCI_I2C_IVR_REG 0x28
64 #define DAVINCI_I2C_EMDR_REG 0x2c
65 #define DAVINCI_I2C_PSC_REG 0x30
67 #define DAVINCI_I2C_IVR_AAS 0x07
68 #define DAVINCI_I2C_IVR_SCD 0x06
69 #define DAVINCI_I2C_IVR_XRDY 0x05
70 #define DAVINCI_I2C_IVR_RDR 0x04
71 #define DAVINCI_I2C_IVR_ARDY 0x03
72 #define DAVINCI_I2C_IVR_NACK 0x02
73 #define DAVINCI_I2C_IVR_AL 0x01
75 #define DAVINCI_I2C_STR_BB (1 << 12)
76 #define DAVINCI_I2C_STR_RSFULL (1 << 11)
77 #define DAVINCI_I2C_STR_SCD (1 << 5)
78 #define DAVINCI_I2C_STR_ARDY (1 << 2)
79 #define DAVINCI_I2C_STR_NACK (1 << 1)
80 #define DAVINCI_I2C_STR_AL (1 << 0)
82 #define DAVINCI_I2C_MDR_NACK (1 << 15)
83 #define DAVINCI_I2C_MDR_STT (1 << 13)
84 #define DAVINCI_I2C_MDR_STP (1 << 11)
85 #define DAVINCI_I2C_MDR_MST (1 << 10)
86 #define DAVINCI_I2C_MDR_TRX (1 << 9)
87 #define DAVINCI_I2C_MDR_XA (1 << 8)
88 #define DAVINCI_I2C_MDR_RM (1 << 7)
89 #define DAVINCI_I2C_MDR_IRS (1 << 5)
91 #define DAVINCI_I2C_IMR_AAS (1 << 6)
92 #define DAVINCI_I2C_IMR_SCD (1 << 5)
93 #define DAVINCI_I2C_IMR_XRDY (1 << 4)
94 #define DAVINCI_I2C_IMR_RRDY (1 << 3)
95 #define DAVINCI_I2C_IMR_ARDY (1 << 2)
96 #define DAVINCI_I2C_IMR_NACK (1 << 1)
97 #define DAVINCI_I2C_IMR_AL (1 << 0)
99 #define MOD_REG_BIT(val, mask, set) do { \
107 struct davinci_i2c_dev
{
110 struct completion cmd_complete
;
117 struct i2c_adapter adapter
;
120 /* default platform data to use if not supplied in the platform_device */
121 static struct davinci_i2c_platform_data davinci_i2c_platform_data_default
= {
126 static inline void davinci_i2c_write_reg(struct davinci_i2c_dev
*i2c_dev
,
129 __raw_writew(val
, i2c_dev
->base
+ reg
);
132 static inline u16
davinci_i2c_read_reg(struct davinci_i2c_dev
*i2c_dev
, int reg
)
134 return __raw_readw(i2c_dev
->base
+ reg
);
138 * This functions configures I2C and brings I2C out of reset.
139 * This function is called during I2C init function. This function
140 * also gets called if I2C encounters any errors.
142 static int i2c_davinci_init(struct davinci_i2c_dev
*dev
)
144 struct davinci_i2c_platform_data
*pdata
= dev
->dev
->platform_data
;
150 u32 input_clock
= clk_get_rate(dev
->clk
);
154 pdata
= &davinci_i2c_platform_data_default
;
156 /* put I2C into reset */
157 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_MDR_REG
);
158 MOD_REG_BIT(w
, DAVINCI_I2C_MDR_IRS
, 0);
159 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, w
);
161 /* NOTE: I2C Clock divider programming info
162 * As per I2C specs the following formulas provide prescaler
163 * and low/high divider values
164 * input clk --> PSC Div -----------> ICCL/H Div --> output clock
167 * output clk = module clk / (PSC + 1) [ (ICCL + d) + (ICCH + d) ]
170 * (ICCL + ICCH) = clk = (input clk / ((psc +1) * output clk)) - 2d;
172 * where if PSC == 0, d = 7,
177 /* get minimum of 7 MHz clock, but max of 12 MHz */
178 psc
= (input_clock
/ 7000000) - 1;
179 if ((input_clock
/ (psc
+ 1)) > 12000000)
180 psc
++; /* better to run under spec than over */
181 d
= (psc
>= 2) ? 5 : 7 - psc
;
183 clk
= ((input_clock
/ (psc
+ 1)) / (pdata
->bus_freq
* 1000)) - (d
<< 1);
187 davinci_i2c_write_reg(dev
, DAVINCI_I2C_PSC_REG
, psc
);
188 davinci_i2c_write_reg(dev
, DAVINCI_I2C_CLKH_REG
, clkh
);
189 davinci_i2c_write_reg(dev
, DAVINCI_I2C_CLKL_REG
, clkl
);
191 /* Respond at reserved "SMBus Host" slave address" (and zero);
192 * we seem to have no option to not respond...
194 davinci_i2c_write_reg(dev
, DAVINCI_I2C_OAR_REG
, 0x08);
196 dev_dbg(dev
->dev
, "input_clock = %d, CLK = %d\n", input_clock
, clk
);
197 dev_dbg(dev
->dev
, "PSC = %d\n",
198 davinci_i2c_read_reg(dev
, DAVINCI_I2C_PSC_REG
));
199 dev_dbg(dev
->dev
, "CLKL = %d\n",
200 davinci_i2c_read_reg(dev
, DAVINCI_I2C_CLKL_REG
));
201 dev_dbg(dev
->dev
, "CLKH = %d\n",
202 davinci_i2c_read_reg(dev
, DAVINCI_I2C_CLKH_REG
));
203 dev_dbg(dev
->dev
, "bus_freq = %dkHz, bus_delay = %d\n",
204 pdata
->bus_freq
, pdata
->bus_delay
);
206 /* Take the I2C module out of reset: */
207 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_MDR_REG
);
208 MOD_REG_BIT(w
, DAVINCI_I2C_MDR_IRS
, 1);
209 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, w
);
211 /* Enable interrupts */
212 davinci_i2c_write_reg(dev
, DAVINCI_I2C_IMR_REG
, I2C_DAVINCI_INTR_ALL
);
218 * Waiting for bus not busy
220 static int i2c_davinci_wait_bus_not_busy(struct davinci_i2c_dev
*dev
,
223 unsigned long timeout
;
225 timeout
= jiffies
+ dev
->adapter
.timeout
;
226 while (davinci_i2c_read_reg(dev
, DAVINCI_I2C_STR_REG
)
227 & DAVINCI_I2C_STR_BB
) {
228 if (time_after(jiffies
, timeout
)) {
230 "timeout waiting for bus ready\n");
241 * Low level master read/write transaction. This function is called
242 * from i2c_davinci_xfer.
245 i2c_davinci_xfer_msg(struct i2c_adapter
*adap
, struct i2c_msg
*msg
, int stop
)
247 struct davinci_i2c_dev
*dev
= i2c_get_adapdata(adap
);
248 struct davinci_i2c_platform_data
*pdata
= dev
->dev
->platform_data
;
257 pdata
= &davinci_i2c_platform_data_default
;
258 /* Introduce a delay, required for some boards (e.g Davinci EVM) */
259 if (pdata
->bus_delay
)
260 udelay(pdata
->bus_delay
);
262 /* set the slave address */
263 davinci_i2c_write_reg(dev
, DAVINCI_I2C_SAR_REG
, msg
->addr
);
266 dev
->buf_len
= msg
->len
;
268 davinci_i2c_write_reg(dev
, DAVINCI_I2C_CNT_REG
, dev
->buf_len
);
270 INIT_COMPLETION(dev
->cmd_complete
);
273 /* Take I2C out of reset, configure it as master and set the
275 flag
= DAVINCI_I2C_MDR_IRS
| DAVINCI_I2C_MDR_MST
| DAVINCI_I2C_MDR_STT
;
277 /* if the slave address is ten bit address, enable XA bit */
278 if (msg
->flags
& I2C_M_TEN
)
279 flag
|= DAVINCI_I2C_MDR_XA
;
280 if (!(msg
->flags
& I2C_M_RD
))
281 flag
|= DAVINCI_I2C_MDR_TRX
;
283 flag
|= DAVINCI_I2C_MDR_STP
;
285 /* Enable receive or transmit interrupts */
286 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_IMR_REG
);
287 if (msg
->flags
& I2C_M_RD
)
288 MOD_REG_BIT(w
, DAVINCI_I2C_IMR_RRDY
, 1);
290 MOD_REG_BIT(w
, DAVINCI_I2C_IMR_XRDY
, 1);
291 davinci_i2c_write_reg(dev
, DAVINCI_I2C_IMR_REG
, w
);
294 /* write the data into mode register */
295 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, flag
);
297 r
= wait_for_completion_interruptible_timeout(&dev
->cmd_complete
,
298 dev
->adapter
.timeout
);
300 dev_err(dev
->dev
, "controller timed out\n");
301 i2c_davinci_init(dev
);
306 /* This should be 0 if all bytes were transferred
307 * or dev->cmd_err denotes an error.
308 * A signal may have aborted the transfer.
311 dev_err(dev
->dev
, "abnormal termination buf_len=%i\n",
323 if (likely(!dev
->cmd_err
))
326 /* We have an error */
327 if (dev
->cmd_err
& DAVINCI_I2C_STR_AL
) {
328 i2c_davinci_init(dev
);
332 if (dev
->cmd_err
& DAVINCI_I2C_STR_NACK
) {
333 if (msg
->flags
& I2C_M_IGNORE_NAK
)
336 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_MDR_REG
);
337 MOD_REG_BIT(w
, DAVINCI_I2C_MDR_STP
, 1);
338 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, w
);
346 * Prepare controller for a transaction and call i2c_davinci_xfer_msg
349 i2c_davinci_xfer(struct i2c_adapter
*adap
, struct i2c_msg msgs
[], int num
)
351 struct davinci_i2c_dev
*dev
= i2c_get_adapdata(adap
);
355 dev_dbg(dev
->dev
, "%s: msgs: %d\n", __func__
, num
);
357 ret
= i2c_davinci_wait_bus_not_busy(dev
, 1);
359 dev_warn(dev
->dev
, "timeout waiting for bus ready\n");
363 for (i
= 0; i
< num
; i
++) {
364 ret
= i2c_davinci_xfer_msg(adap
, &msgs
[i
], (i
== (num
- 1)));
365 dev_dbg(dev
->dev
, "%s [%d/%d] ret: %d\n", __func__
, i
+ 1, num
,
373 static u32
i2c_davinci_func(struct i2c_adapter
*adap
)
375 return I2C_FUNC_I2C
| (I2C_FUNC_SMBUS_EMUL
& ~I2C_FUNC_SMBUS_QUICK
);
378 static void terminate_read(struct davinci_i2c_dev
*dev
)
380 u16 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_MDR_REG
);
381 w
|= DAVINCI_I2C_MDR_NACK
;
382 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, w
);
384 /* Throw away data */
385 davinci_i2c_read_reg(dev
, DAVINCI_I2C_DRR_REG
);
387 dev_err(dev
->dev
, "RDR IRQ while no data requested\n");
389 static void terminate_write(struct davinci_i2c_dev
*dev
)
391 u16 w
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_MDR_REG
);
392 w
|= DAVINCI_I2C_MDR_RM
| DAVINCI_I2C_MDR_STP
;
393 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, w
);
396 dev_dbg(dev
->dev
, "TDR IRQ while no data to send\n");
400 * Interrupt service routine. This gets called whenever an I2C interrupt
403 static irqreturn_t
i2c_davinci_isr(int this_irq
, void *dev_id
)
405 struct davinci_i2c_dev
*dev
= dev_id
;
410 while ((stat
= davinci_i2c_read_reg(dev
, DAVINCI_I2C_IVR_REG
))) {
411 dev_dbg(dev
->dev
, "%s: stat=0x%x\n", __func__
, stat
);
412 if (count
++ == 100) {
413 dev_warn(dev
->dev
, "Too much work in one IRQ\n");
418 case DAVINCI_I2C_IVR_AL
:
419 /* Arbitration lost, must retry */
420 dev
->cmd_err
|= DAVINCI_I2C_STR_AL
;
422 complete(&dev
->cmd_complete
);
425 case DAVINCI_I2C_IVR_NACK
:
426 dev
->cmd_err
|= DAVINCI_I2C_STR_NACK
;
428 complete(&dev
->cmd_complete
);
431 case DAVINCI_I2C_IVR_ARDY
:
432 davinci_i2c_write_reg(dev
,
433 DAVINCI_I2C_STR_REG
, DAVINCI_I2C_STR_ARDY
);
434 complete(&dev
->cmd_complete
);
437 case DAVINCI_I2C_IVR_RDR
:
440 davinci_i2c_read_reg(dev
,
441 DAVINCI_I2C_DRR_REG
);
446 davinci_i2c_write_reg(dev
,
448 DAVINCI_I2C_IMR_RRDY
);
450 /* signal can terminate transfer */
455 case DAVINCI_I2C_IVR_XRDY
:
457 davinci_i2c_write_reg(dev
, DAVINCI_I2C_DXR_REG
,
463 w
= davinci_i2c_read_reg(dev
,
464 DAVINCI_I2C_IMR_REG
);
465 MOD_REG_BIT(w
, DAVINCI_I2C_IMR_XRDY
, 0);
466 davinci_i2c_write_reg(dev
,
470 /* signal can terminate transfer */
471 terminate_write(dev
);
475 case DAVINCI_I2C_IVR_SCD
:
476 davinci_i2c_write_reg(dev
,
477 DAVINCI_I2C_STR_REG
, DAVINCI_I2C_STR_SCD
);
478 complete(&dev
->cmd_complete
);
481 case DAVINCI_I2C_IVR_AAS
:
482 dev_dbg(dev
->dev
, "Address as slave interrupt\n");
486 dev_warn(dev
->dev
, "Unrecognized irq stat %d\n", stat
);
491 return count
? IRQ_HANDLED
: IRQ_NONE
;
494 static struct i2c_algorithm i2c_davinci_algo
= {
495 .master_xfer
= i2c_davinci_xfer
,
496 .functionality
= i2c_davinci_func
,
499 static int davinci_i2c_probe(struct platform_device
*pdev
)
501 struct davinci_i2c_dev
*dev
;
502 struct i2c_adapter
*adap
;
503 struct resource
*mem
, *irq
, *ioarea
;
506 /* NOTE: driver uses the static register mapping */
507 mem
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
509 dev_err(&pdev
->dev
, "no mem resource?\n");
513 irq
= platform_get_resource(pdev
, IORESOURCE_IRQ
, 0);
515 dev_err(&pdev
->dev
, "no irq resource?\n");
519 ioarea
= request_mem_region(mem
->start
, resource_size(mem
),
522 dev_err(&pdev
->dev
, "I2C region already claimed\n");
526 dev
= kzalloc(sizeof(struct davinci_i2c_dev
), GFP_KERNEL
);
529 goto err_release_region
;
532 init_completion(&dev
->cmd_complete
);
533 dev
->dev
= get_device(&pdev
->dev
);
534 dev
->irq
= irq
->start
;
535 platform_set_drvdata(pdev
, dev
);
537 dev
->clk
= clk_get(&pdev
->dev
, NULL
);
538 if (IS_ERR(dev
->clk
)) {
542 clk_enable(dev
->clk
);
544 dev
->base
= (void __iomem
*)IO_ADDRESS(mem
->start
);
545 i2c_davinci_init(dev
);
547 r
= request_irq(dev
->irq
, i2c_davinci_isr
, 0, pdev
->name
, dev
);
549 dev_err(&pdev
->dev
, "failure requesting irq %i\n", dev
->irq
);
550 goto err_unuse_clocks
;
553 adap
= &dev
->adapter
;
554 i2c_set_adapdata(adap
, dev
);
555 adap
->owner
= THIS_MODULE
;
556 adap
->class = I2C_CLASS_HWMON
;
557 strlcpy(adap
->name
, "DaVinci I2C adapter", sizeof(adap
->name
));
558 adap
->algo
= &i2c_davinci_algo
;
559 adap
->dev
.parent
= &pdev
->dev
;
560 adap
->timeout
= DAVINCI_I2C_TIMEOUT
;
563 r
= i2c_add_numbered_adapter(adap
);
565 dev_err(&pdev
->dev
, "failure adding adapter\n");
572 free_irq(dev
->irq
, dev
);
574 clk_disable(dev
->clk
);
578 platform_set_drvdata(pdev
, NULL
);
579 put_device(&pdev
->dev
);
582 release_mem_region(mem
->start
, resource_size(mem
));
587 static int davinci_i2c_remove(struct platform_device
*pdev
)
589 struct davinci_i2c_dev
*dev
= platform_get_drvdata(pdev
);
590 struct resource
*mem
;
592 platform_set_drvdata(pdev
, NULL
);
593 i2c_del_adapter(&dev
->adapter
);
594 put_device(&pdev
->dev
);
596 clk_disable(dev
->clk
);
600 davinci_i2c_write_reg(dev
, DAVINCI_I2C_MDR_REG
, 0);
601 free_irq(IRQ_I2C
, dev
);
604 mem
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
605 release_mem_region(mem
->start
, resource_size(mem
));
609 /* work with hotplug and coldplug */
610 MODULE_ALIAS("platform:i2c_davinci");
612 static struct platform_driver davinci_i2c_driver
= {
613 .probe
= davinci_i2c_probe
,
614 .remove
= davinci_i2c_remove
,
616 .name
= "i2c_davinci",
617 .owner
= THIS_MODULE
,
621 /* I2C may be needed to bring up other drivers */
622 static int __init
davinci_i2c_init_driver(void)
624 return platform_driver_register(&davinci_i2c_driver
);
626 subsys_initcall(davinci_i2c_init_driver
);
628 static void __exit
davinci_i2c_exit_driver(void)
630 platform_driver_unregister(&davinci_i2c_driver
);
632 module_exit(davinci_i2c_exit_driver
);
634 MODULE_AUTHOR("Texas Instruments India");
635 MODULE_DESCRIPTION("TI DaVinci I2C bus adapter");
636 MODULE_LICENSE("GPL");