1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * Actions Semiconductor Owl SoC's I2C driver
4 *
5 * Copyright (c) 2014 Actions Semi Inc.
6 * Author: David Liu <liuwei@actions-semi.com>
7 *
8 * Copyright (c) 2018 Linaro Ltd.
9 * Author: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
10 */
11
12#include <linux/clk.h>
13#include <linux/delay.h>
14#include <linux/i2c.h>
15#include <linux/interrupt.h>
16#include <linux/io.h>
17#include <linux/iopoll.h>
18#include <linux/module.h>
19#include <linux/of.h>
20#include <linux/platform_device.h>
21
22/* I2C registers */
23#define OWL_I2C_REG_CTL 0x0000
24#define OWL_I2C_REG_CLKDIV 0x0004
25#define OWL_I2C_REG_STAT 0x0008
26#define OWL_I2C_REG_ADDR 0x000C
27#define OWL_I2C_REG_TXDAT 0x0010
28#define OWL_I2C_REG_RXDAT 0x0014
29#define OWL_I2C_REG_CMD 0x0018
30#define OWL_I2C_REG_FIFOCTL 0x001C
31#define OWL_I2C_REG_FIFOSTAT 0x0020
32#define OWL_I2C_REG_DATCNT 0x0024
33#define OWL_I2C_REG_RCNT 0x0028
34
35/* I2Cx_CTL Bit Mask */
36#define OWL_I2C_CTL_RB BIT(1)
37#define OWL_I2C_CTL_GBCC(x) (((x) & 0x3) << 2)
38#define OWL_I2C_CTL_GBCC_NONE OWL_I2C_CTL_GBCC(0)
39#define OWL_I2C_CTL_GBCC_START OWL_I2C_CTL_GBCC(1)
40#define OWL_I2C_CTL_GBCC_STOP OWL_I2C_CTL_GBCC(2)
41#define OWL_I2C_CTL_GBCC_RSTART OWL_I2C_CTL_GBCC(3)
42#define OWL_I2C_CTL_IRQE BIT(5)
43#define OWL_I2C_CTL_EN BIT(7)
44#define OWL_I2C_CTL_AE BIT(8)
45#define OWL_I2C_CTL_SHSM BIT(10)
46
47#define OWL_I2C_DIV_FACTOR(x) ((x) & 0xff)
48
49/* I2Cx_STAT Bit Mask */
50#define OWL_I2C_STAT_RACK BIT(0)
51#define OWL_I2C_STAT_BEB BIT(1)
52#define OWL_I2C_STAT_IRQP BIT(2)
53#define OWL_I2C_STAT_LAB BIT(3)
54#define OWL_I2C_STAT_STPD BIT(4)
55#define OWL_I2C_STAT_STAD BIT(5)
56#define OWL_I2C_STAT_BBB BIT(6)
57#define OWL_I2C_STAT_TCB BIT(7)
58#define OWL_I2C_STAT_LBST BIT(8)
59#define OWL_I2C_STAT_SAMB BIT(9)
60#define OWL_I2C_STAT_SRGC BIT(10)
61
62/* I2Cx_CMD Bit Mask */
63#define OWL_I2C_CMD_SBE BIT(0)
64#define OWL_I2C_CMD_RBE BIT(4)
65#define OWL_I2C_CMD_DE BIT(8)
66#define OWL_I2C_CMD_NS BIT(9)
67#define OWL_I2C_CMD_SE BIT(10)
68#define OWL_I2C_CMD_MSS BIT(11)
69#define OWL_I2C_CMD_WRS BIT(12)
70#define OWL_I2C_CMD_SECL BIT(15)
71
72#define OWL_I2C_CMD_AS(x) (((x) & 0x7) << 1)
73#define OWL_I2C_CMD_SAS(x) (((x) & 0x7) << 5)
74
75/* I2Cx_FIFOCTL Bit Mask */
76#define OWL_I2C_FIFOCTL_NIB BIT(0)
77#define OWL_I2C_FIFOCTL_RFR BIT(1)
78#define OWL_I2C_FIFOCTL_TFR BIT(2)
79
80/* I2Cc_FIFOSTAT Bit Mask */
81#define OWL_I2C_FIFOSTAT_CECB BIT(0)
82#define OWL_I2C_FIFOSTAT_RNB BIT(1)
83#define OWL_I2C_FIFOSTAT_RFE BIT(2)
84#define OWL_I2C_FIFOSTAT_TFF BIT(5)
85#define OWL_I2C_FIFOSTAT_TFD GENMASK(23, 16)
86#define OWL_I2C_FIFOSTAT_RFD GENMASK(15, 8)
87
88/* I2C bus timeout */
89#define OWL_I2C_TIMEOUT_MS (4 * 1000)
90#define OWL_I2C_TIMEOUT msecs_to_jiffies(OWL_I2C_TIMEOUT_MS)
91
92#define OWL_I2C_MAX_RETRIES 50
93
94struct owl_i2c_dev {
95 struct i2c_adapter adap;
96 struct i2c_msg *msg;
97 struct completion msg_complete;
98 struct clk *clk;
99 spinlock_t lock;
100 void __iomem *base;
101 unsigned long clk_rate;
102 u32 bus_freq;
103 u32 msg_ptr;
104 int err;
105};
106
107static void owl_i2c_update_reg(void __iomem *reg, unsigned int val, bool state)
108{
109 unsigned int regval;
110
111 regval = readl(addr: reg);
112
113 if (state)
114 regval |= val;
115 else
116 regval &= ~val;
117
118 writel(val: regval, addr: reg);
119}
120
121static void owl_i2c_reset(struct owl_i2c_dev *i2c_dev)
122{
123 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_CTL,
124 OWL_I2C_CTL_EN, state: false);
125 mdelay(1);
126 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_CTL,
127 OWL_I2C_CTL_EN, state: true);
128
129 /* Clear status registers */
130 writel(val: 0, addr: i2c_dev->base + OWL_I2C_REG_STAT);
131}
132
133static int owl_i2c_reset_fifo(struct owl_i2c_dev *i2c_dev)
134{
135 unsigned int val, timeout = 0;
136
137 /* Reset FIFO */
138 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_FIFOCTL,
139 OWL_I2C_FIFOCTL_RFR | OWL_I2C_FIFOCTL_TFR,
140 state: true);
141
142 /* Wait 50ms for FIFO reset complete */
143 do {
144 val = readl(addr: i2c_dev->base + OWL_I2C_REG_FIFOCTL);
145 if (!(val & (OWL_I2C_FIFOCTL_RFR | OWL_I2C_FIFOCTL_TFR)))
146 break;
147 usleep_range(min: 500, max: 1000);
148 } while (timeout++ < OWL_I2C_MAX_RETRIES);
149
150 if (timeout > OWL_I2C_MAX_RETRIES) {
151 dev_err(&i2c_dev->adap.dev, "FIFO reset timeout\n");
152 return -ETIMEDOUT;
153 }
154
155 return 0;
156}
157
158static void owl_i2c_set_freq(struct owl_i2c_dev *i2c_dev)
159{
160 unsigned int val;
161
162 val = DIV_ROUND_UP(i2c_dev->clk_rate, i2c_dev->bus_freq * 16);
163
164 /* Set clock divider factor */
165 writel(OWL_I2C_DIV_FACTOR(val), addr: i2c_dev->base + OWL_I2C_REG_CLKDIV);
166}
167
168static void owl_i2c_xfer_data(struct owl_i2c_dev *i2c_dev)
169{
170 struct i2c_msg *msg = i2c_dev->msg;
171 unsigned int stat, fifostat;
172
173 i2c_dev->err = 0;
174
175 /* Handle NACK from slave */
176 fifostat = readl(addr: i2c_dev->base + OWL_I2C_REG_FIFOSTAT);
177 if (fifostat & OWL_I2C_FIFOSTAT_RNB) {
178 i2c_dev->err = -ENXIO;
179 /* Clear NACK error bit by writing "1" */
180 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_FIFOSTAT,
181 OWL_I2C_FIFOSTAT_RNB, state: true);
182 return;
183 }
184
185 /* Handle bus error */
186 stat = readl(addr: i2c_dev->base + OWL_I2C_REG_STAT);
187 if (stat & OWL_I2C_STAT_BEB) {
188 i2c_dev->err = -EIO;
189 /* Clear BUS error bit by writing "1" */
190 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_STAT,
191 OWL_I2C_STAT_BEB, state: true);
192 return;
193 }
194
195 /* Handle FIFO read */
196 if (msg->flags & I2C_M_RD) {
197 while ((readl(addr: i2c_dev->base + OWL_I2C_REG_FIFOSTAT) &
198 OWL_I2C_FIFOSTAT_RFE) && i2c_dev->msg_ptr < msg->len) {
199 msg->buf[i2c_dev->msg_ptr++] = readl(addr: i2c_dev->base +
200 OWL_I2C_REG_RXDAT);
201 }
202 } else {
203 /* Handle the remaining bytes which were not sent */
204 while (!(readl(addr: i2c_dev->base + OWL_I2C_REG_FIFOSTAT) &
205 OWL_I2C_FIFOSTAT_TFF) && i2c_dev->msg_ptr < msg->len) {
206 writel(val: msg->buf[i2c_dev->msg_ptr++],
207 addr: i2c_dev->base + OWL_I2C_REG_TXDAT);
208 }
209 }
210}
211
212static irqreturn_t owl_i2c_interrupt(int irq, void *_dev)
213{
214 struct owl_i2c_dev *i2c_dev = _dev;
215
216 spin_lock(lock: &i2c_dev->lock);
217
218 owl_i2c_xfer_data(i2c_dev);
219
220 /* Clear pending interrupts */
221 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_STAT,
222 OWL_I2C_STAT_IRQP, state: true);
223
224 complete_all(&i2c_dev->msg_complete);
225 spin_unlock(lock: &i2c_dev->lock);
226
227 return IRQ_HANDLED;
228}
229
230static u32 owl_i2c_func(struct i2c_adapter *adap)
231{
232 return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
233}
234
235static int owl_i2c_check_bus_busy(struct i2c_adapter *adap)
236{
237 struct owl_i2c_dev *i2c_dev = i2c_get_adapdata(adap);
238 unsigned long timeout;
239
240 /* Check for Bus busy */
241 timeout = jiffies + OWL_I2C_TIMEOUT;
242 while (readl(addr: i2c_dev->base + OWL_I2C_REG_STAT) & OWL_I2C_STAT_BBB) {
243 if (time_after(jiffies, timeout)) {
244 dev_err(&adap->dev, "Bus busy timeout\n");
245 return -ETIMEDOUT;
246 }
247 }
248
249 return 0;
250}
251
252static int owl_i2c_xfer_common(struct i2c_adapter *adap, struct i2c_msg *msgs,
253 int num, bool atomic)
254{
255 struct owl_i2c_dev *i2c_dev = i2c_get_adapdata(adap);
256 struct i2c_msg *msg;
257 unsigned long time_left, flags;
258 unsigned int i2c_cmd, val;
259 unsigned int addr;
260 int ret, idx;
261
262 spin_lock_irqsave(&i2c_dev->lock, flags);
263
264 /* Reset I2C controller */
265 owl_i2c_reset(i2c_dev);
266
267 /* Set bus frequency */
268 owl_i2c_set_freq(i2c_dev);
269
270 /*
271 * Spinlock should be released before calling reset FIFO and
272 * bus busy check since those functions may sleep
273 */
274 spin_unlock_irqrestore(lock: &i2c_dev->lock, flags);
275
276 /* Reset FIFO */
277 ret = owl_i2c_reset_fifo(i2c_dev);
278 if (ret)
279 goto unlocked_err_exit;
280
281 /* Check for bus busy */
282 ret = owl_i2c_check_bus_busy(adap);
283 if (ret)
284 goto unlocked_err_exit;
285
286 spin_lock_irqsave(&i2c_dev->lock, flags);
287
288 /* Check for Arbitration lost */
289 val = readl(addr: i2c_dev->base + OWL_I2C_REG_STAT);
290 if (val & OWL_I2C_STAT_LAB) {
291 val &= ~OWL_I2C_STAT_LAB;
292 writel(val, addr: i2c_dev->base + OWL_I2C_REG_STAT);
293 ret = -EAGAIN;
294 goto err_exit;
295 }
296
297 if (!atomic)
298 reinit_completion(x: &i2c_dev->msg_complete);
299
300 /* Enable/disable I2C controller interrupt */
301 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_CTL,
302 OWL_I2C_CTL_IRQE, state: !atomic);
303
304 /*
305 * Select: FIFO enable, Master mode, Stop enable, Data count enable,
306 * Send start bit
307 */
308 i2c_cmd = OWL_I2C_CMD_SECL | OWL_I2C_CMD_MSS | OWL_I2C_CMD_SE |
309 OWL_I2C_CMD_NS | OWL_I2C_CMD_DE | OWL_I2C_CMD_SBE;
310
311 /* Handle repeated start condition */
312 if (num > 1) {
313 /* Set internal address length and enable repeated start */
314 i2c_cmd |= OWL_I2C_CMD_AS(msgs[0].len + 1) |
315 OWL_I2C_CMD_SAS(1) | OWL_I2C_CMD_RBE;
316
317 /* Write slave address */
318 addr = i2c_8bit_addr_from_msg(msg: &msgs[0]);
319 writel(val: addr, addr: i2c_dev->base + OWL_I2C_REG_TXDAT);
320
321 /* Write internal register address */
322 for (idx = 0; idx < msgs[0].len; idx++)
323 writel(val: msgs[0].buf[idx],
324 addr: i2c_dev->base + OWL_I2C_REG_TXDAT);
325
326 msg = &msgs[1];
327 } else {
328 /* Set address length */
329 i2c_cmd |= OWL_I2C_CMD_AS(1);
330 msg = &msgs[0];
331 }
332
333 i2c_dev->msg = msg;
334 i2c_dev->msg_ptr = 0;
335
336 /* Set data count for the message */
337 writel(val: msg->len, addr: i2c_dev->base + OWL_I2C_REG_DATCNT);
338
339 addr = i2c_8bit_addr_from_msg(msg);
340 writel(val: addr, addr: i2c_dev->base + OWL_I2C_REG_TXDAT);
341
342 if (!(msg->flags & I2C_M_RD)) {
343 /* Write data to FIFO */
344 for (idx = 0; idx < msg->len; idx++) {
345 /* Check for FIFO full */
346 if (readl(addr: i2c_dev->base + OWL_I2C_REG_FIFOSTAT) &
347 OWL_I2C_FIFOSTAT_TFF)
348 break;
349
350 writel(val: msg->buf[idx],
351 addr: i2c_dev->base + OWL_I2C_REG_TXDAT);
352 }
353
354 i2c_dev->msg_ptr = idx;
355 }
356
357 /* Ignore the NACK if needed */
358 if (msg->flags & I2C_M_IGNORE_NAK)
359 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_FIFOCTL,
360 OWL_I2C_FIFOCTL_NIB, state: true);
361 else
362 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_FIFOCTL,
363 OWL_I2C_FIFOCTL_NIB, state: false);
364
365 /* Start the transfer */
366 writel(val: i2c_cmd, addr: i2c_dev->base + OWL_I2C_REG_CMD);
367
368 spin_unlock_irqrestore(lock: &i2c_dev->lock, flags);
369
370 if (atomic) {
371 /* Wait for Command Execute Completed or NACK Error bits */
372 ret = readl_poll_timeout_atomic(i2c_dev->base + OWL_I2C_REG_FIFOSTAT,
373 val, val & (OWL_I2C_FIFOSTAT_CECB |
374 OWL_I2C_FIFOSTAT_RNB),
375 10, OWL_I2C_TIMEOUT_MS * 1000);
376 } else {
377 time_left = wait_for_completion_timeout(x: &i2c_dev->msg_complete,
378 timeout: adap->timeout);
379 if (!time_left)
380 ret = -ETIMEDOUT;
381 }
382
383 spin_lock_irqsave(&i2c_dev->lock, flags);
384
385 if (ret) {
386 dev_err(&adap->dev, "Transaction timed out\n");
387 /* Send stop condition and release the bus */
388 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_CTL,
389 OWL_I2C_CTL_GBCC_STOP | OWL_I2C_CTL_RB,
390 state: true);
391 goto err_exit;
392 }
393
394 if (atomic)
395 owl_i2c_xfer_data(i2c_dev);
396
397 ret = i2c_dev->err < 0 ? i2c_dev->err : num;
398
399err_exit:
400 spin_unlock_irqrestore(lock: &i2c_dev->lock, flags);
401
402unlocked_err_exit:
403 /* Disable I2C controller */
404 owl_i2c_update_reg(reg: i2c_dev->base + OWL_I2C_REG_CTL,
405 OWL_I2C_CTL_EN, state: false);
406
407 return ret;
408}
409
410static int owl_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg *msgs,
411 int num)
412{
413 return owl_i2c_xfer_common(adap, msgs, num, atomic: false);
414}
415
416static int owl_i2c_xfer_atomic(struct i2c_adapter *adap,
417 struct i2c_msg *msgs, int num)
418{
419 return owl_i2c_xfer_common(adap, msgs, num, atomic: true);
420}
421
422static const struct i2c_algorithm owl_i2c_algorithm = {
423 .master_xfer = owl_i2c_xfer,
424 .master_xfer_atomic = owl_i2c_xfer_atomic,
425 .functionality = owl_i2c_func,
426};
427
428static const struct i2c_adapter_quirks owl_i2c_quirks = {
429 .flags = I2C_AQ_COMB | I2C_AQ_COMB_WRITE_FIRST,
430 .max_read_len = 240,
431 .max_write_len = 240,
432 .max_comb_1st_msg_len = 6,
433 .max_comb_2nd_msg_len = 240,
434};
435
436static int owl_i2c_probe(struct platform_device *pdev)
437{
438 struct device *dev = &pdev->dev;
439 struct owl_i2c_dev *i2c_dev;
440 int ret, irq;
441
442 i2c_dev = devm_kzalloc(dev, size: sizeof(*i2c_dev), GFP_KERNEL);
443 if (!i2c_dev)
444 return -ENOMEM;
445
446 i2c_dev->base = devm_platform_ioremap_resource(pdev, index: 0);
447 if (IS_ERR(ptr: i2c_dev->base))
448 return PTR_ERR(ptr: i2c_dev->base);
449
450 irq = platform_get_irq(pdev, 0);
451 if (irq < 0)
452 return irq;
453
454 if (of_property_read_u32(np: dev->of_node, propname: "clock-frequency",
455 out_value: &i2c_dev->bus_freq))
456 i2c_dev->bus_freq = I2C_MAX_STANDARD_MODE_FREQ;
457
458 /* We support only frequencies of 100k and 400k for now */
459 if (i2c_dev->bus_freq != I2C_MAX_STANDARD_MODE_FREQ &&
460 i2c_dev->bus_freq != I2C_MAX_FAST_MODE_FREQ) {
461 dev_err(dev, "invalid clock-frequency %d\n", i2c_dev->bus_freq);
462 return -EINVAL;
463 }
464
465 i2c_dev->clk = devm_clk_get_enabled(dev, NULL);
466 if (IS_ERR(ptr: i2c_dev->clk)) {
467 dev_err(dev, "failed to enable clock\n");
468 return PTR_ERR(ptr: i2c_dev->clk);
469 }
470
471 i2c_dev->clk_rate = clk_get_rate(clk: i2c_dev->clk);
472 if (!i2c_dev->clk_rate) {
473 dev_err(dev, "input clock rate should not be zero\n");
474 return -EINVAL;
475 }
476
477 init_completion(x: &i2c_dev->msg_complete);
478 spin_lock_init(&i2c_dev->lock);
479 i2c_dev->adap.owner = THIS_MODULE;
480 i2c_dev->adap.algo = &owl_i2c_algorithm;
481 i2c_dev->adap.timeout = OWL_I2C_TIMEOUT;
482 i2c_dev->adap.quirks = &owl_i2c_quirks;
483 i2c_dev->adap.dev.parent = dev;
484 i2c_dev->adap.dev.of_node = dev->of_node;
485 snprintf(buf: i2c_dev->adap.name, size: sizeof(i2c_dev->adap.name),
486 fmt: "%s", "OWL I2C adapter");
487 i2c_set_adapdata(adap: &i2c_dev->adap, data: i2c_dev);
488
489 platform_set_drvdata(pdev, data: i2c_dev);
490
491 ret = devm_request_irq(dev, irq, handler: owl_i2c_interrupt, irqflags: 0, devname: pdev->name,
492 dev_id: i2c_dev);
493 if (ret) {
494 dev_err(dev, "failed to request irq %d\n", irq);
495 return ret;
496 }
497
498 return i2c_add_adapter(adap: &i2c_dev->adap);
499}
500
501static const struct of_device_id owl_i2c_of_match[] = {
502 { .compatible = "actions,s500-i2c" },
503 { .compatible = "actions,s700-i2c" },
504 { .compatible = "actions,s900-i2c" },
505 { /* sentinel */ }
506};
507MODULE_DEVICE_TABLE(of, owl_i2c_of_match);
508
509static struct platform_driver owl_i2c_driver = {
510 .probe = owl_i2c_probe,
511 .driver = {
512 .name = "owl-i2c",
513 .of_match_table = owl_i2c_of_match,
514 .probe_type = PROBE_PREFER_ASYNCHRONOUS,
515 },
516};
517module_platform_driver(owl_i2c_driver);
518
519MODULE_AUTHOR("David Liu <liuwei@actions-semi.com>");
520MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>");
521MODULE_DESCRIPTION("Actions Semiconductor Owl SoC's I2C driver");
522MODULE_LICENSE("GPL");
523

source code of linux/drivers/i2c/busses/i2c-owl.c