Linux 4.1.16
[linux/fpc-iii.git] / drivers / i2c / busses / i2c-axxia.c
blob32d88349086314fc739b3d5890285ac1ad28b714
1 /*
2 * This driver implements I2C master functionality using the LSI API2C
3 * controller.
5 * NOTE: The controller has a limitation in that it can only do transfers of
6 * maximum 255 bytes at a time. If a larger transfer is attempted, error code
7 * (-EINVAL) is returned.
9 * This software is licensed under the terms of the GNU General Public
10 * License version 2, as published by the Free Software Foundation, and
11 * may be copied, distributed, and modified under those terms.
13 #include <linux/clk.h>
14 #include <linux/clkdev.h>
15 #include <linux/err.h>
16 #include <linux/i2c.h>
17 #include <linux/init.h>
18 #include <linux/interrupt.h>
19 #include <linux/module.h>
20 #include <linux/io.h>
21 #include <linux/kernel.h>
22 #include <linux/platform_device.h>
24 #define SCL_WAIT_TIMEOUT_NS 25000000
25 #define I2C_XFER_TIMEOUT (msecs_to_jiffies(250))
26 #define I2C_STOP_TIMEOUT (msecs_to_jiffies(100))
27 #define FIFO_SIZE 8
29 #define GLOBAL_CONTROL 0x00
30 #define GLOBAL_MST_EN BIT(0)
31 #define GLOBAL_SLV_EN BIT(1)
32 #define GLOBAL_IBML_EN BIT(2)
33 #define INTERRUPT_STATUS 0x04
34 #define INTERRUPT_ENABLE 0x08
35 #define INT_SLV BIT(1)
36 #define INT_MST BIT(0)
37 #define WAIT_TIMER_CONTROL 0x0c
38 #define WT_EN BIT(15)
39 #define WT_VALUE(_x) ((_x) & 0x7fff)
40 #define IBML_TIMEOUT 0x10
41 #define IBML_LOW_MEXT 0x14
42 #define IBML_LOW_SEXT 0x18
43 #define TIMER_CLOCK_DIV 0x1c
44 #define I2C_BUS_MONITOR 0x20
45 #define SOFT_RESET 0x24
46 #define MST_COMMAND 0x28
47 #define CMD_BUSY (1<<3)
48 #define CMD_MANUAL (0x00 | CMD_BUSY)
49 #define CMD_AUTO (0x01 | CMD_BUSY)
50 #define MST_RX_XFER 0x2c
51 #define MST_TX_XFER 0x30
52 #define MST_ADDR_1 0x34
53 #define MST_ADDR_2 0x38
54 #define MST_DATA 0x3c
55 #define MST_TX_FIFO 0x40
56 #define MST_RX_FIFO 0x44
57 #define MST_INT_ENABLE 0x48
58 #define MST_INT_STATUS 0x4c
59 #define MST_STATUS_RFL (1 << 13) /* RX FIFO serivce */
60 #define MST_STATUS_TFL (1 << 12) /* TX FIFO service */
61 #define MST_STATUS_SNS (1 << 11) /* Manual mode done */
62 #define MST_STATUS_SS (1 << 10) /* Automatic mode done */
63 #define MST_STATUS_SCC (1 << 9) /* Stop complete */
64 #define MST_STATUS_IP (1 << 8) /* Invalid parameter */
65 #define MST_STATUS_TSS (1 << 7) /* Timeout */
66 #define MST_STATUS_AL (1 << 6) /* Arbitration lost */
67 #define MST_STATUS_ND (1 << 5) /* NAK on data phase */
68 #define MST_STATUS_NA (1 << 4) /* NAK on address phase */
69 #define MST_STATUS_NAK (MST_STATUS_NA | \
70 MST_STATUS_ND)
71 #define MST_STATUS_ERR (MST_STATUS_NAK | \
72 MST_STATUS_AL | \
73 MST_STATUS_IP | \
74 MST_STATUS_TSS)
75 #define MST_TX_BYTES_XFRD 0x50
76 #define MST_RX_BYTES_XFRD 0x54
77 #define SCL_HIGH_PERIOD 0x80
78 #define SCL_LOW_PERIOD 0x84
79 #define SPIKE_FLTR_LEN 0x88
80 #define SDA_SETUP_TIME 0x8c
81 #define SDA_HOLD_TIME 0x90
83 /**
84 * axxia_i2c_dev - I2C device context
85 * @base: pointer to register struct
86 * @msg: pointer to current message
87 * @msg_xfrd: number of bytes transferred in msg
88 * @msg_err: error code for completed message
89 * @msg_complete: xfer completion object
90 * @dev: device reference
91 * @adapter: core i2c abstraction
92 * @i2c_clk: clock reference for i2c input clock
93 * @bus_clk_rate: current i2c bus clock rate
95 struct axxia_i2c_dev {
96 void __iomem *base;
97 struct i2c_msg *msg;
98 size_t msg_xfrd;
99 int msg_err;
100 struct completion msg_complete;
101 struct device *dev;
102 struct i2c_adapter adapter;
103 struct clk *i2c_clk;
104 u32 bus_clk_rate;
107 static void i2c_int_disable(struct axxia_i2c_dev *idev, u32 mask)
109 u32 int_en;
111 int_en = readl(idev->base + MST_INT_ENABLE);
112 writel(int_en & ~mask, idev->base + MST_INT_ENABLE);
115 static void i2c_int_enable(struct axxia_i2c_dev *idev, u32 mask)
117 u32 int_en;
119 int_en = readl(idev->base + MST_INT_ENABLE);
120 writel(int_en | mask, idev->base + MST_INT_ENABLE);
124 * ns_to_clk - Convert time (ns) to clock cycles for the given clock frequency.
126 static u32 ns_to_clk(u64 ns, u32 clk_mhz)
128 return div_u64(ns * clk_mhz, 1000);
131 static int axxia_i2c_init(struct axxia_i2c_dev *idev)
133 u32 divisor = clk_get_rate(idev->i2c_clk) / idev->bus_clk_rate;
134 u32 clk_mhz = clk_get_rate(idev->i2c_clk) / 1000000;
135 u32 t_setup;
136 u32 t_high, t_low;
137 u32 tmo_clk;
138 u32 prescale;
139 unsigned long timeout;
141 dev_dbg(idev->dev, "rate=%uHz per_clk=%uMHz -> ratio=1:%u\n",
142 idev->bus_clk_rate, clk_mhz, divisor);
144 /* Reset controller */
145 writel(0x01, idev->base + SOFT_RESET);
146 timeout = jiffies + msecs_to_jiffies(100);
147 while (readl(idev->base + SOFT_RESET) & 1) {
148 if (time_after(jiffies, timeout)) {
149 dev_warn(idev->dev, "Soft reset failed\n");
150 break;
154 /* Enable Master Mode */
155 writel(0x1, idev->base + GLOBAL_CONTROL);
157 if (idev->bus_clk_rate <= 100000) {
158 /* Standard mode SCL 50/50, tSU:DAT = 250 ns */
159 t_high = divisor * 1 / 2;
160 t_low = divisor * 1 / 2;
161 t_setup = ns_to_clk(250, clk_mhz);
162 } else {
163 /* Fast mode SCL 33/66, tSU:DAT = 100 ns */
164 t_high = divisor * 1 / 3;
165 t_low = divisor * 2 / 3;
166 t_setup = ns_to_clk(100, clk_mhz);
169 /* SCL High Time */
170 writel(t_high, idev->base + SCL_HIGH_PERIOD);
171 /* SCL Low Time */
172 writel(t_low, idev->base + SCL_LOW_PERIOD);
173 /* SDA Setup Time */
174 writel(t_setup, idev->base + SDA_SETUP_TIME);
175 /* SDA Hold Time, 300ns */
176 writel(ns_to_clk(300, clk_mhz), idev->base + SDA_HOLD_TIME);
177 /* Filter <50ns spikes */
178 writel(ns_to_clk(50, clk_mhz), idev->base + SPIKE_FLTR_LEN);
180 /* Configure Time-Out Registers */
181 tmo_clk = ns_to_clk(SCL_WAIT_TIMEOUT_NS, clk_mhz);
183 /* Find prescaler value that makes tmo_clk fit in 15-bits counter. */
184 for (prescale = 0; prescale < 15; ++prescale) {
185 if (tmo_clk <= 0x7fff)
186 break;
187 tmo_clk >>= 1;
189 if (tmo_clk > 0x7fff)
190 tmo_clk = 0x7fff;
192 /* Prescale divider (log2) */
193 writel(prescale, idev->base + TIMER_CLOCK_DIV);
194 /* Timeout in divided clocks */
195 writel(WT_EN | WT_VALUE(tmo_clk), idev->base + WAIT_TIMER_CONTROL);
197 /* Mask all master interrupt bits */
198 i2c_int_disable(idev, ~0);
200 /* Interrupt enable */
201 writel(0x01, idev->base + INTERRUPT_ENABLE);
203 return 0;
206 static int i2c_m_rd(const struct i2c_msg *msg)
208 return (msg->flags & I2C_M_RD) != 0;
211 static int i2c_m_ten(const struct i2c_msg *msg)
213 return (msg->flags & I2C_M_TEN) != 0;
216 static int i2c_m_recv_len(const struct i2c_msg *msg)
218 return (msg->flags & I2C_M_RECV_LEN) != 0;
222 * axxia_i2c_empty_rx_fifo - Fetch data from RX FIFO and update SMBus block
223 * transfer length if this is the first byte of such a transfer.
225 static int axxia_i2c_empty_rx_fifo(struct axxia_i2c_dev *idev)
227 struct i2c_msg *msg = idev->msg;
228 size_t rx_fifo_avail = readl(idev->base + MST_RX_FIFO);
229 int bytes_to_transfer = min(rx_fifo_avail, msg->len - idev->msg_xfrd);
231 while (bytes_to_transfer-- > 0) {
232 int c = readl(idev->base + MST_DATA);
234 if (idev->msg_xfrd == 0 && i2c_m_recv_len(msg)) {
236 * Check length byte for SMBus block read
238 if (c <= 0 || c > I2C_SMBUS_BLOCK_MAX) {
239 idev->msg_err = -EPROTO;
240 i2c_int_disable(idev, ~0);
241 complete(&idev->msg_complete);
242 break;
244 msg->len = 1 + c;
245 writel(msg->len, idev->base + MST_RX_XFER);
247 msg->buf[idev->msg_xfrd++] = c;
250 return 0;
254 * axxia_i2c_fill_tx_fifo - Fill TX FIFO from current message buffer.
255 * @return: Number of bytes left to transfer.
257 static int axxia_i2c_fill_tx_fifo(struct axxia_i2c_dev *idev)
259 struct i2c_msg *msg = idev->msg;
260 size_t tx_fifo_avail = FIFO_SIZE - readl(idev->base + MST_TX_FIFO);
261 int bytes_to_transfer = min(tx_fifo_avail, msg->len - idev->msg_xfrd);
262 int ret = msg->len - idev->msg_xfrd - bytes_to_transfer;
264 while (bytes_to_transfer-- > 0)
265 writel(msg->buf[idev->msg_xfrd++], idev->base + MST_DATA);
267 return ret;
270 static irqreturn_t axxia_i2c_isr(int irq, void *_dev)
272 struct axxia_i2c_dev *idev = _dev;
273 u32 status;
275 if (!(readl(idev->base + INTERRUPT_STATUS) & INT_MST))
276 return IRQ_NONE;
278 /* Read interrupt status bits */
279 status = readl(idev->base + MST_INT_STATUS);
281 if (!idev->msg) {
282 dev_warn(idev->dev, "unexpected interrupt\n");
283 goto out;
286 /* RX FIFO needs service? */
287 if (i2c_m_rd(idev->msg) && (status & MST_STATUS_RFL))
288 axxia_i2c_empty_rx_fifo(idev);
290 /* TX FIFO needs service? */
291 if (!i2c_m_rd(idev->msg) && (status & MST_STATUS_TFL)) {
292 if (axxia_i2c_fill_tx_fifo(idev) == 0)
293 i2c_int_disable(idev, MST_STATUS_TFL);
296 if (status & MST_STATUS_SCC) {
297 /* Stop completed */
298 i2c_int_disable(idev, ~0);
299 complete(&idev->msg_complete);
300 } else if (status & MST_STATUS_SNS) {
301 /* Transfer done */
302 i2c_int_disable(idev, ~0);
303 if (i2c_m_rd(idev->msg) && idev->msg_xfrd < idev->msg->len)
304 axxia_i2c_empty_rx_fifo(idev);
305 complete(&idev->msg_complete);
306 } else if (unlikely(status & MST_STATUS_ERR)) {
307 /* Transfer error */
308 i2c_int_disable(idev, ~0);
309 if (status & MST_STATUS_AL)
310 idev->msg_err = -EAGAIN;
311 else if (status & MST_STATUS_NAK)
312 idev->msg_err = -ENXIO;
313 else
314 idev->msg_err = -EIO;
315 dev_dbg(idev->dev, "error %#x, addr=%#x rx=%u/%u tx=%u/%u\n",
316 status,
317 idev->msg->addr,
318 readl(idev->base + MST_RX_BYTES_XFRD),
319 readl(idev->base + MST_RX_XFER),
320 readl(idev->base + MST_TX_BYTES_XFRD),
321 readl(idev->base + MST_TX_XFER));
322 complete(&idev->msg_complete);
325 out:
326 /* Clear interrupt */
327 writel(INT_MST, idev->base + INTERRUPT_STATUS);
329 return IRQ_HANDLED;
332 static int axxia_i2c_xfer_msg(struct axxia_i2c_dev *idev, struct i2c_msg *msg)
334 u32 int_mask = MST_STATUS_ERR | MST_STATUS_SNS;
335 u32 rx_xfer, tx_xfer;
336 u32 addr_1, addr_2;
337 unsigned long time_left;
339 idev->msg = msg;
340 idev->msg_xfrd = 0;
341 idev->msg_err = 0;
342 reinit_completion(&idev->msg_complete);
344 if (i2c_m_ten(msg)) {
345 /* 10-bit address
346 * addr_1: 5'b11110 | addr[9:8] | (R/nW)
347 * addr_2: addr[7:0]
349 addr_1 = 0xF0 | ((msg->addr >> 7) & 0x06);
350 addr_2 = msg->addr & 0xFF;
351 } else {
352 /* 7-bit address
353 * addr_1: addr[6:0] | (R/nW)
354 * addr_2: dont care
356 addr_1 = (msg->addr << 1) & 0xFF;
357 addr_2 = 0;
360 if (i2c_m_rd(msg)) {
361 /* I2C read transfer */
362 rx_xfer = i2c_m_recv_len(msg) ? I2C_SMBUS_BLOCK_MAX : msg->len;
363 tx_xfer = 0;
364 addr_1 |= 1; /* Set the R/nW bit of the address */
365 } else {
366 /* I2C write transfer */
367 rx_xfer = 0;
368 tx_xfer = msg->len;
371 writel(rx_xfer, idev->base + MST_RX_XFER);
372 writel(tx_xfer, idev->base + MST_TX_XFER);
373 writel(addr_1, idev->base + MST_ADDR_1);
374 writel(addr_2, idev->base + MST_ADDR_2);
376 if (i2c_m_rd(msg))
377 int_mask |= MST_STATUS_RFL;
378 else if (axxia_i2c_fill_tx_fifo(idev) != 0)
379 int_mask |= MST_STATUS_TFL;
381 /* Start manual mode */
382 writel(CMD_MANUAL, idev->base + MST_COMMAND);
384 i2c_int_enable(idev, int_mask);
386 time_left = wait_for_completion_timeout(&idev->msg_complete,
387 I2C_XFER_TIMEOUT);
389 i2c_int_disable(idev, int_mask);
391 if (readl(idev->base + MST_COMMAND) & CMD_BUSY)
392 dev_warn(idev->dev, "busy after xfer\n");
394 if (time_left == 0)
395 idev->msg_err = -ETIMEDOUT;
397 if (unlikely(idev->msg_err) && idev->msg_err != -ENXIO)
398 axxia_i2c_init(idev);
400 return idev->msg_err;
403 static int axxia_i2c_stop(struct axxia_i2c_dev *idev)
405 u32 int_mask = MST_STATUS_ERR | MST_STATUS_SCC;
406 unsigned long time_left;
408 reinit_completion(&idev->msg_complete);
410 /* Issue stop */
411 writel(0xb, idev->base + MST_COMMAND);
412 i2c_int_enable(idev, int_mask);
413 time_left = wait_for_completion_timeout(&idev->msg_complete,
414 I2C_STOP_TIMEOUT);
415 i2c_int_disable(idev, int_mask);
416 if (time_left == 0)
417 return -ETIMEDOUT;
419 if (readl(idev->base + MST_COMMAND) & CMD_BUSY)
420 dev_warn(idev->dev, "busy after stop\n");
422 return 0;
425 static int
426 axxia_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg msgs[], int num)
428 struct axxia_i2c_dev *idev = i2c_get_adapdata(adap);
429 int i;
430 int ret = 0;
432 for (i = 0; ret == 0 && i < num; ++i)
433 ret = axxia_i2c_xfer_msg(idev, &msgs[i]);
435 axxia_i2c_stop(idev);
437 return ret ? : i;
440 static u32 axxia_i2c_func(struct i2c_adapter *adap)
442 u32 caps = (I2C_FUNC_I2C | I2C_FUNC_10BIT_ADDR |
443 I2C_FUNC_SMBUS_EMUL | I2C_FUNC_SMBUS_BLOCK_DATA);
444 return caps;
447 static const struct i2c_algorithm axxia_i2c_algo = {
448 .master_xfer = axxia_i2c_xfer,
449 .functionality = axxia_i2c_func,
452 static struct i2c_adapter_quirks axxia_i2c_quirks = {
453 .max_read_len = 255,
454 .max_write_len = 255,
457 static int axxia_i2c_probe(struct platform_device *pdev)
459 struct device_node *np = pdev->dev.of_node;
460 struct axxia_i2c_dev *idev = NULL;
461 struct resource *res;
462 void __iomem *base;
463 int irq;
464 int ret = 0;
466 idev = devm_kzalloc(&pdev->dev, sizeof(*idev), GFP_KERNEL);
467 if (!idev)
468 return -ENOMEM;
470 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
471 base = devm_ioremap_resource(&pdev->dev, res);
472 if (IS_ERR(base))
473 return PTR_ERR(base);
475 irq = platform_get_irq(pdev, 0);
476 if (irq < 0) {
477 dev_err(&pdev->dev, "missing interrupt resource\n");
478 return irq;
481 idev->i2c_clk = devm_clk_get(&pdev->dev, "i2c");
482 if (IS_ERR(idev->i2c_clk)) {
483 dev_err(&pdev->dev, "missing clock\n");
484 return PTR_ERR(idev->i2c_clk);
487 idev->base = base;
488 idev->dev = &pdev->dev;
489 init_completion(&idev->msg_complete);
491 of_property_read_u32(np, "clock-frequency", &idev->bus_clk_rate);
492 if (idev->bus_clk_rate == 0)
493 idev->bus_clk_rate = 100000; /* default clock rate */
495 ret = axxia_i2c_init(idev);
496 if (ret) {
497 dev_err(&pdev->dev, "failed to initialize\n");
498 return ret;
501 ret = devm_request_irq(&pdev->dev, irq, axxia_i2c_isr, 0,
502 pdev->name, idev);
503 if (ret) {
504 dev_err(&pdev->dev, "failed to claim IRQ%d\n", irq);
505 return ret;
508 clk_prepare_enable(idev->i2c_clk);
510 i2c_set_adapdata(&idev->adapter, idev);
511 strlcpy(idev->adapter.name, pdev->name, sizeof(idev->adapter.name));
512 idev->adapter.owner = THIS_MODULE;
513 idev->adapter.algo = &axxia_i2c_algo;
514 idev->adapter.quirks = &axxia_i2c_quirks;
515 idev->adapter.dev.parent = &pdev->dev;
516 idev->adapter.dev.of_node = pdev->dev.of_node;
518 platform_set_drvdata(pdev, idev);
520 ret = i2c_add_adapter(&idev->adapter);
521 if (ret) {
522 dev_err(&pdev->dev, "failed to add adapter\n");
523 return ret;
526 return 0;
529 static int axxia_i2c_remove(struct platform_device *pdev)
531 struct axxia_i2c_dev *idev = platform_get_drvdata(pdev);
533 clk_disable_unprepare(idev->i2c_clk);
534 i2c_del_adapter(&idev->adapter);
536 return 0;
539 /* Match table for of_platform binding */
540 static const struct of_device_id axxia_i2c_of_match[] = {
541 { .compatible = "lsi,api2c", },
545 MODULE_DEVICE_TABLE(of, axxia_i2c_of_match);
547 static struct platform_driver axxia_i2c_driver = {
548 .probe = axxia_i2c_probe,
549 .remove = axxia_i2c_remove,
550 .driver = {
551 .name = "axxia-i2c",
552 .of_match_table = axxia_i2c_of_match,
556 module_platform_driver(axxia_i2c_driver);
558 MODULE_DESCRIPTION("Axxia I2C Bus driver");
559 MODULE_AUTHOR("Anders Berg <anders.berg@lsi.com>");
560 MODULE_LICENSE("GPL v2");