2 * SuperH Mobile I2C Controller
4 * Copyright (C) 2008 Magnus Damm
6 * Portions of the code based on out-of-tree driver i2c-sh7343.c
7 * Copyright (c) 2006 Carlos Munoz <carlos@kenati.com>
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
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #include <linux/kernel.h>
24 #include <linux/module.h>
25 #include <linux/init.h>
26 #include <linux/delay.h>
27 #include <linux/platform_device.h>
28 #include <linux/interrupt.h>
29 #include <linux/i2c.h>
30 #include <linux/err.h>
31 #include <linux/clk.h>
34 /* Transmit operation: */
44 /* BUS: S A8 ACK D8(1) ACK P */
45 /* IRQ: DTE WAIT WAIT */
51 /* BUS: S A8 ACK D8(1) ACK D8(2) ACK P */
52 /* IRQ: DTE WAIT WAIT WAIT */
55 /* ICDR: A8 D8(1) D8(2) */
57 /* 3 bytes or more, +---------+ gets repeated */
60 /* Receive operation: */
62 /* 0 byte receive - not supported since slave may hold SDA low */
64 /* 1 byte receive [TX] | [RX] */
65 /* BUS: S A8 ACK | D8(1) ACK P */
66 /* IRQ: DTE WAIT | WAIT DTE */
67 /* ICIC: -DTE | +DTE */
68 /* ICCR: 0x94 0x81 | 0xc0 */
69 /* ICDR: A8 | D8(1) */
71 /* 2 byte receive [TX]| [RX] */
72 /* BUS: S A8 ACK | D8(1) ACK D8(2) ACK P */
73 /* IRQ: DTE WAIT | WAIT WAIT DTE */
74 /* ICIC: -DTE | +DTE */
75 /* ICCR: 0x94 0x81 | 0xc0 */
76 /* ICDR: A8 | D8(1) D8(2) */
78 /* 3 byte receive [TX] | [RX] */
79 /* BUS: S A8 ACK | D8(1) ACK D8(2) ACK D8(3) ACK P */
80 /* IRQ: DTE WAIT | WAIT WAIT WAIT DTE */
81 /* ICIC: -DTE | +DTE */
82 /* ICCR: 0x94 0x81 | 0xc0 */
83 /* ICDR: A8 | D8(1) D8(2) D8(3) */
85 /* 4 bytes or more, this part is repeated +---------+ */
88 /* Interrupt order and BUSY flag */
90 /* SDA ___\___XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAAAAAAAAA___/ */
91 /* SCL \_/1\_/2\_/3\_/4\_/5\_/6\_/7\_/8\___/9\_____/ */
93 /* S D7 D6 D5 D4 D3 D2 D1 D0 P */
95 /* WAIT IRQ ________________________________/ \___________ */
96 /* TACK IRQ ____________________________________/ \_______ */
97 /* DTE IRQ __________________________________________/ \_ */
98 /* AL IRQ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX */
99 /* _______________________________________________ */
103 enum sh_mobile_i2c_op {
114 struct sh_mobile_i2c_data {
117 struct i2c_adapter adap;
124 wait_queue_head_t wait;
130 #define NORMAL_SPEED 100000 /* FAST_SPEED 400000 */
132 /* Register offsets */
133 #define ICDR(pd) (pd->reg + 0x00)
134 #define ICCR(pd) (pd->reg + 0x04)
135 #define ICSR(pd) (pd->reg + 0x08)
136 #define ICIC(pd) (pd->reg + 0x0c)
137 #define ICCL(pd) (pd->reg + 0x10)
138 #define ICCH(pd) (pd->reg + 0x14)
141 #define ICCR_ICE 0x80
142 #define ICCR_RACK 0x40
143 #define ICCR_TRS 0x10
144 #define ICCR_BBSY 0x04
145 #define ICCR_SCP 0x01
147 #define ICSR_SCLM 0x80
148 #define ICSR_SDAM 0x40
150 #define ICSR_BUSY 0x10
152 #define ICSR_TACK 0x04
153 #define ICSR_WAIT 0x02
154 #define ICSR_DTE 0x01
156 #define ICIC_ALE 0x08
157 #define ICIC_TACKE 0x04
158 #define ICIC_WAITE 0x02
159 #define ICIC_DTEE 0x01
161 static void activate_ch(struct sh_mobile_i2c_data *pd)
163 /* Make sure the clock is enabled */
166 /* Enable channel and configure rx ack */
167 iowrite8(ioread8(ICCR(pd)) | ICCR_ICE, ICCR(pd));
169 /* Mask all interrupts */
170 iowrite8(0, ICIC(pd));
173 iowrite8(pd->iccl, ICCL(pd));
174 iowrite8(pd->icch, ICCH(pd));
177 static void deactivate_ch(struct sh_mobile_i2c_data *pd)
179 /* Clear/disable interrupts */
180 iowrite8(0, ICSR(pd));
181 iowrite8(0, ICIC(pd));
183 /* Disable channel */
184 iowrite8(ioread8(ICCR(pd)) & ~ICCR_ICE, ICCR(pd));
187 clk_disable(pd->clk);
190 static unsigned char i2c_op(struct sh_mobile_i2c_data *pd,
191 enum sh_mobile_i2c_op op, unsigned char data)
193 unsigned char ret = 0;
196 dev_dbg(pd->dev, "op %d, data in 0x%02x\n", op, data);
198 spin_lock_irqsave(&pd->lock, flags);
201 case OP_START: /* issue start and trigger DTE interrupt */
202 iowrite8(0x94, ICCR(pd));
204 case OP_TX_FIRST: /* disable DTE interrupt and write data */
205 iowrite8(ICIC_WAITE | ICIC_ALE | ICIC_TACKE, ICIC(pd));
206 iowrite8(data, ICDR(pd));
208 case OP_TX: /* write data */
209 iowrite8(data, ICDR(pd));
211 case OP_TX_STOP: /* write data and issue a stop afterwards */
212 iowrite8(data, ICDR(pd));
213 iowrite8(0x90, ICCR(pd));
215 case OP_TX_TO_RX: /* select read mode */
216 iowrite8(0x81, ICCR(pd));
218 case OP_RX: /* just read data */
219 ret = ioread8(ICDR(pd));
221 case OP_RX_STOP: /* enable DTE interrupt, issue stop */
222 iowrite8(ICIC_DTEE | ICIC_WAITE | ICIC_ALE | ICIC_TACKE,
224 iowrite8(0xc0, ICCR(pd));
226 case OP_RX_STOP_DATA: /* enable DTE interrupt, read data, issue stop */
227 iowrite8(ICIC_DTEE | ICIC_WAITE | ICIC_ALE | ICIC_TACKE,
229 ret = ioread8(ICDR(pd));
230 iowrite8(0xc0, ICCR(pd));
234 spin_unlock_irqrestore(&pd->lock, flags);
236 dev_dbg(pd->dev, "op %d, data out 0x%02x\n", op, ret);
240 static int sh_mobile_i2c_is_first_byte(struct sh_mobile_i2c_data *pd)
248 static int sh_mobile_i2c_is_last_byte(struct sh_mobile_i2c_data *pd)
250 if (pd->pos == (pd->msg->len - 1))
256 static void sh_mobile_i2c_get_data(struct sh_mobile_i2c_data *pd,
261 *buf = (pd->msg->addr & 0x7f) << 1;
262 *buf |= (pd->msg->flags & I2C_M_RD) ? 1 : 0;
265 *buf = pd->msg->buf[pd->pos];
269 static int sh_mobile_i2c_isr_tx(struct sh_mobile_i2c_data *pd)
273 if (pd->pos == pd->msg->len)
276 sh_mobile_i2c_get_data(pd, &data);
278 if (sh_mobile_i2c_is_last_byte(pd))
279 i2c_op(pd, OP_TX_STOP, data);
280 else if (sh_mobile_i2c_is_first_byte(pd))
281 i2c_op(pd, OP_TX_FIRST, data);
283 i2c_op(pd, OP_TX, data);
289 static int sh_mobile_i2c_isr_rx(struct sh_mobile_i2c_data *pd)
296 sh_mobile_i2c_get_data(pd, &data);
298 if (sh_mobile_i2c_is_first_byte(pd))
299 i2c_op(pd, OP_TX_FIRST, data);
301 i2c_op(pd, OP_TX, data);
306 i2c_op(pd, OP_TX_TO_RX, 0);
310 real_pos = pd->pos - 2;
312 if (pd->pos == pd->msg->len) {
314 i2c_op(pd, OP_RX_STOP, 0);
317 data = i2c_op(pd, OP_RX_STOP_DATA, 0);
319 data = i2c_op(pd, OP_RX, 0);
322 pd->msg->buf[real_pos] = data;
326 return pd->pos == (pd->msg->len + 2);
329 static irqreturn_t sh_mobile_i2c_isr(int irq, void *dev_id)
331 struct platform_device *dev = dev_id;
332 struct sh_mobile_i2c_data *pd = platform_get_drvdata(dev);
336 sr = ioread8(ICSR(pd));
337 pd->sr |= sr; /* remember state */
339 dev_dbg(pd->dev, "i2c_isr 0x%02x 0x%02x %s %d %d!\n", sr, pd->sr,
340 (pd->msg->flags & I2C_M_RD) ? "read" : "write",
341 pd->pos, pd->msg->len);
343 if (sr & (ICSR_AL | ICSR_TACK)) {
344 /* don't interrupt transaction - continue to issue stop */
345 iowrite8(sr & ~(ICSR_AL | ICSR_TACK), ICSR(pd));
347 } else if (pd->msg->flags & I2C_M_RD)
348 wakeup = sh_mobile_i2c_isr_rx(pd);
350 wakeup = sh_mobile_i2c_isr_tx(pd);
352 if (sr & ICSR_WAIT) /* TODO: add delay here to support slow acks */
353 iowrite8(sr & ~ICSR_WAIT, ICSR(pd));
363 static int start_ch(struct sh_mobile_i2c_data *pd, struct i2c_msg *usr_msg)
365 if (usr_msg->len == 0 && (usr_msg->flags & I2C_M_RD)) {
366 dev_err(pd->dev, "Unsupported zero length i2c read\n");
370 /* Initialize channel registers */
371 iowrite8(ioread8(ICCR(pd)) & ~ICCR_ICE, ICCR(pd));
373 /* Enable channel and configure rx ack */
374 iowrite8(ioread8(ICCR(pd)) | ICCR_ICE, ICCR(pd));
377 iowrite8(pd->iccl, ICCL(pd));
378 iowrite8(pd->icch, ICCH(pd));
384 /* Enable all interrupts to begin with */
385 iowrite8(ICIC_WAITE | ICIC_ALE | ICIC_TACKE | ICIC_DTEE, ICIC(pd));
389 static int sh_mobile_i2c_xfer(struct i2c_adapter *adapter,
390 struct i2c_msg *msgs,
393 struct sh_mobile_i2c_data *pd = i2c_get_adapdata(adapter);
397 int i, k, retry_count;
401 /* Process all messages */
402 for (i = 0; i < num; i++) {
405 err = start_ch(pd, msg);
409 i2c_op(pd, OP_START, 0);
411 /* The interrupt handler takes care of the rest... */
412 k = wait_event_timeout(pd->wait,
413 pd->sr & (ICSR_TACK | SW_DONE),
416 dev_err(pd->dev, "Transfer request timed out\n");
420 val = ioread8(ICSR(pd));
422 dev_dbg(pd->dev, "val 0x%02x pd->sr 0x%02x\n", val, pd->sr);
424 /* the interrupt handler may wake us up before the
425 * transfer is finished, so poll the hardware
428 if (val & ICSR_BUSY) {
434 dev_err(pd->dev, "Polling timed out\n");
438 /* handle missing acknowledge and arbitration lost */
439 if ((val | pd->sr) & (ICSR_TACK | ICSR_AL)) {
452 static u32 sh_mobile_i2c_func(struct i2c_adapter *adapter)
454 return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
457 static struct i2c_algorithm sh_mobile_i2c_algorithm = {
458 .functionality = sh_mobile_i2c_func,
459 .master_xfer = sh_mobile_i2c_xfer,
462 static void sh_mobile_i2c_setup_channel(struct platform_device *dev)
464 struct sh_mobile_i2c_data *pd = platform_get_drvdata(dev);
465 unsigned long peripheral_clk = clk_get_rate(pd->clk);
470 spin_lock_init(&pd->lock);
471 init_waitqueue_head(&pd->wait);
473 /* Calculate the value for iccl. From the data sheet:
474 * iccl = (p clock / transfer rate) * (L / (L + H))
475 * where L and H are the SCL low/high ratio (5/4 in this case).
476 * We also round off the result.
478 num = peripheral_clk * 5;
479 denom = NORMAL_SPEED * 9;
480 tmp = num * 10 / denom;
482 pd->iccl = (u_int8_t)((num/denom) + 1);
484 pd->iccl = (u_int8_t)(num/denom);
486 /* Calculate the value for icch. From the data sheet:
487 icch = (p clock / transfer rate) * (H / (L + H)) */
488 num = peripheral_clk * 4;
489 tmp = num * 10 / denom;
491 pd->icch = (u_int8_t)((num/denom) + 1);
493 pd->icch = (u_int8_t)(num/denom);
496 static int sh_mobile_i2c_hook_irqs(struct platform_device *dev, int hook)
498 struct resource *res;
504 while ((res = platform_get_resource(dev, IORESOURCE_IRQ, k))) {
505 for (n = res->start; hook && n <= res->end; n++) {
506 if (request_irq(n, sh_mobile_i2c_isr, IRQF_DISABLED,
507 dev->dev.bus_id, dev))
514 return k > 0 ? 0 : -ENOENT;
520 for (q = k; k >= 0; k--) {
521 for (m = n; m >= res->start; m--)
524 res = platform_get_resource(dev, IORESOURCE_IRQ, k - 1);
531 static int sh_mobile_i2c_probe(struct platform_device *dev)
533 struct sh_mobile_i2c_data *pd;
534 struct i2c_adapter *adap;
535 struct resource *res;
539 pd = kzalloc(sizeof(struct sh_mobile_i2c_data), GFP_KERNEL);
541 dev_err(&dev->dev, "cannot allocate private data\n");
545 pd->clk = clk_get(&dev->dev, "peripheral_clk");
546 if (IS_ERR(pd->clk)) {
547 dev_err(&dev->dev, "cannot get peripheral clock\n");
548 ret = PTR_ERR(pd->clk);
552 ret = sh_mobile_i2c_hook_irqs(dev, 1);
554 dev_err(&dev->dev, "cannot request IRQ\n");
559 platform_set_drvdata(dev, pd);
561 res = platform_get_resource(dev, IORESOURCE_MEM, 0);
563 dev_err(&dev->dev, "cannot find IO resource\n");
568 size = (res->end - res->start) + 1;
570 pd->reg = ioremap(res->start, size);
571 if (pd->reg == NULL) {
572 dev_err(&dev->dev, "cannot map IO\n");
577 /* setup the private data */
579 i2c_set_adapdata(adap, pd);
581 adap->owner = THIS_MODULE;
582 adap->algo = &sh_mobile_i2c_algorithm;
583 adap->dev.parent = &dev->dev;
587 strlcpy(adap->name, dev->name, sizeof(adap->name));
589 sh_mobile_i2c_setup_channel(dev);
591 ret = i2c_add_numbered_adapter(adap);
593 dev_err(&dev->dev, "cannot add numbered adapter\n");
602 sh_mobile_i2c_hook_irqs(dev, 0);
610 static int sh_mobile_i2c_remove(struct platform_device *dev)
612 struct sh_mobile_i2c_data *pd = platform_get_drvdata(dev);
614 i2c_del_adapter(&pd->adap);
616 sh_mobile_i2c_hook_irqs(dev, 0);
622 static struct platform_driver sh_mobile_i2c_driver = {
624 .name = "i2c-sh_mobile",
625 .owner = THIS_MODULE,
627 .probe = sh_mobile_i2c_probe,
628 .remove = sh_mobile_i2c_remove,
631 static int __init sh_mobile_i2c_adap_init(void)
633 return platform_driver_register(&sh_mobile_i2c_driver);
636 static void __exit sh_mobile_i2c_adap_exit(void)
638 platform_driver_unregister(&sh_mobile_i2c_driver);
641 module_init(sh_mobile_i2c_adap_init);
642 module_exit(sh_mobile_i2c_adap_exit);
644 MODULE_DESCRIPTION("SuperH Mobile I2C Bus Controller driver");
645 MODULE_AUTHOR("Magnus Damm");
646 MODULE_LICENSE("GPL v2");