361 lines
8.8 KiB
C
361 lines
8.8 KiB
C
// SPDX-License-Identifier: GPL-2.0-or-later
|
|
/*
|
|
* Synopsys DesignWare I2C adapter driver.
|
|
*
|
|
* Based on the TI DAVINCI I2C adapter driver.
|
|
*
|
|
* Copyright (C) 2006 Texas Instruments.
|
|
* Copyright (C) 2007 MontaVista Software Inc.
|
|
* Copyright (C) 2009 Provigent Ltd.
|
|
*/
|
|
#include <linux/clk.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/export.h>
|
|
#include <linux/errno.h>
|
|
#include <linux/err.h>
|
|
#include <linux/i2c.h>
|
|
#include <linux/interrupt.h>
|
|
#include <linux/io.h>
|
|
#include <linux/module.h>
|
|
#include <linux/pm_runtime.h>
|
|
#include <linux/swab.h>
|
|
|
|
#include "i2c-designware-core.h"
|
|
|
|
static char *abort_sources[] = {
|
|
[ABRT_7B_ADDR_NOACK] =
|
|
"slave address not acknowledged (7bit mode)",
|
|
[ABRT_10ADDR1_NOACK] =
|
|
"first address byte not acknowledged (10bit mode)",
|
|
[ABRT_10ADDR2_NOACK] =
|
|
"second address byte not acknowledged (10bit mode)",
|
|
[ABRT_TXDATA_NOACK] =
|
|
"data not acknowledged",
|
|
[ABRT_GCALL_NOACK] =
|
|
"no acknowledgement for a general call",
|
|
[ABRT_GCALL_READ] =
|
|
"read after general call",
|
|
[ABRT_SBYTE_ACKDET] =
|
|
"start byte acknowledged",
|
|
[ABRT_SBYTE_NORSTRT] =
|
|
"trying to send start byte when restart is disabled",
|
|
[ABRT_10B_RD_NORSTRT] =
|
|
"trying to read when restart is disabled (10bit mode)",
|
|
[ABRT_MASTER_DIS] =
|
|
"trying to use disabled adapter",
|
|
[ARB_LOST] =
|
|
"lost arbitration",
|
|
[ABRT_SLAVE_FLUSH_TXFIFO] =
|
|
"read command so flush old data in the TX FIFO",
|
|
[ABRT_SLAVE_ARBLOST] =
|
|
"slave lost the bus while transmitting data to a remote master",
|
|
[ABRT_SLAVE_RD_INTX] =
|
|
"incorrect slave-transmitter mode configuration",
|
|
};
|
|
|
|
u32 dw_readl(struct dw_i2c_dev *dev, int offset)
|
|
{
|
|
u32 value;
|
|
|
|
if (dev->flags & ACCESS_16BIT)
|
|
value = readw_relaxed(dev->base + offset) |
|
|
(readw_relaxed(dev->base + offset + 2) << 16);
|
|
else
|
|
value = readl_relaxed(dev->base + offset);
|
|
|
|
if (dev->flags & ACCESS_SWAP)
|
|
return swab32(value);
|
|
else
|
|
return value;
|
|
}
|
|
|
|
void dw_writel(struct dw_i2c_dev *dev, u32 b, int offset)
|
|
{
|
|
if (dev->flags & ACCESS_SWAP)
|
|
b = swab32(b);
|
|
|
|
if (dev->flags & ACCESS_16BIT) {
|
|
writew_relaxed((u16)b, dev->base + offset);
|
|
writew_relaxed((u16)(b >> 16), dev->base + offset + 2);
|
|
} else {
|
|
writel_relaxed(b, dev->base + offset);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* i2c_dw_set_reg_access() - Set register access flags
|
|
* @dev: device private data
|
|
*
|
|
* Autodetects needed register access mode and sets access flags accordingly.
|
|
* This must be called before doing any other register access.
|
|
*/
|
|
int i2c_dw_set_reg_access(struct dw_i2c_dev *dev)
|
|
{
|
|
u32 reg;
|
|
int ret;
|
|
|
|
ret = i2c_dw_acquire_lock(dev);
|
|
if (ret)
|
|
return ret;
|
|
|
|
reg = dw_readl(dev, DW_IC_COMP_TYPE);
|
|
i2c_dw_release_lock(dev);
|
|
|
|
if (reg == swab32(DW_IC_COMP_TYPE_VALUE)) {
|
|
/* Configure register endianess access */
|
|
dev->flags |= ACCESS_SWAP;
|
|
} else if (reg == (DW_IC_COMP_TYPE_VALUE & 0x0000ffff)) {
|
|
/* Configure register access mode 16bit */
|
|
dev->flags |= ACCESS_16BIT;
|
|
} else if (reg != DW_IC_COMP_TYPE_VALUE) {
|
|
dev_err(dev->dev,
|
|
"Unknown Synopsys component type: 0x%08x\n", reg);
|
|
return -ENODEV;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
u32 i2c_dw_scl_hcnt(u32 ic_clk, u32 tSYMBOL, u32 tf, int cond, int offset)
|
|
{
|
|
/*
|
|
* DesignWare I2C core doesn't seem to have solid strategy to meet
|
|
* the tHD;STA timing spec. Configuring _HCNT based on tHIGH spec
|
|
* will result in violation of the tHD;STA spec.
|
|
*/
|
|
if (cond)
|
|
/*
|
|
* Conditional expression:
|
|
*
|
|
* IC_[FS]S_SCL_HCNT + (1+4+3) >= IC_CLK * tHIGH
|
|
*
|
|
* This is based on the DW manuals, and represents an ideal
|
|
* configuration. The resulting I2C bus speed will be
|
|
* faster than any of the others.
|
|
*
|
|
* If your hardware is free from tHD;STA issue, try this one.
|
|
*/
|
|
return (ic_clk * tSYMBOL + 500000) / 1000000 - 8 + offset;
|
|
else
|
|
/*
|
|
* Conditional expression:
|
|
*
|
|
* IC_[FS]S_SCL_HCNT + 3 >= IC_CLK * (tHD;STA + tf)
|
|
*
|
|
* This is just experimental rule; the tHD;STA period turned
|
|
* out to be proportinal to (_HCNT + 3). With this setting,
|
|
* we could meet both tHIGH and tHD;STA timing specs.
|
|
*
|
|
* If unsure, you'd better to take this alternative.
|
|
*
|
|
* The reason why we need to take into account "tf" here,
|
|
* is the same as described in i2c_dw_scl_lcnt().
|
|
*/
|
|
return (ic_clk * (tSYMBOL + tf) + 500000) / 1000000
|
|
- 3 + offset;
|
|
}
|
|
|
|
u32 i2c_dw_scl_lcnt(u32 ic_clk, u32 tLOW, u32 tf, int offset)
|
|
{
|
|
/*
|
|
* Conditional expression:
|
|
*
|
|
* IC_[FS]S_SCL_LCNT + 1 >= IC_CLK * (tLOW + tf)
|
|
*
|
|
* DW I2C core starts counting the SCL CNTs for the LOW period
|
|
* of the SCL clock (tLOW) as soon as it pulls the SCL line.
|
|
* In order to meet the tLOW timing spec, we need to take into
|
|
* account the fall time of SCL signal (tf). Default tf value
|
|
* should be 0.3 us, for safety.
|
|
*/
|
|
return ((ic_clk * (tLOW + tf) + 500000) / 1000000) - 1 + offset;
|
|
}
|
|
|
|
int i2c_dw_set_sda_hold(struct dw_i2c_dev *dev)
|
|
{
|
|
u32 reg;
|
|
int ret;
|
|
|
|
ret = i2c_dw_acquire_lock(dev);
|
|
if (ret)
|
|
return ret;
|
|
|
|
/* Configure SDA Hold Time if required */
|
|
reg = dw_readl(dev, DW_IC_COMP_VERSION);
|
|
if (reg >= DW_IC_SDA_HOLD_MIN_VERS) {
|
|
if (!dev->sda_hold_time) {
|
|
/* Keep previous hold time setting if no one set it */
|
|
dev->sda_hold_time = dw_readl(dev, DW_IC_SDA_HOLD);
|
|
}
|
|
|
|
/*
|
|
* Workaround for avoiding TX arbitration lost in case I2C
|
|
* slave pulls SDA down "too quickly" after falling egde of
|
|
* SCL by enabling non-zero SDA RX hold. Specification says it
|
|
* extends incoming SDA low to high transition while SCL is
|
|
* high but it apprears to help also above issue.
|
|
*/
|
|
if (!(dev->sda_hold_time & DW_IC_SDA_HOLD_RX_MASK))
|
|
dev->sda_hold_time |= 1 << DW_IC_SDA_HOLD_RX_SHIFT;
|
|
|
|
dev_dbg(dev->dev, "SDA Hold Time TX:RX = %d:%d\n",
|
|
dev->sda_hold_time & ~(u32)DW_IC_SDA_HOLD_RX_MASK,
|
|
dev->sda_hold_time >> DW_IC_SDA_HOLD_RX_SHIFT);
|
|
} else if (dev->sda_hold_time) {
|
|
dev_warn(dev->dev,
|
|
"Hardware too old to adjust SDA hold time.\n");
|
|
dev->sda_hold_time = 0;
|
|
}
|
|
|
|
i2c_dw_release_lock(dev);
|
|
|
|
return 0;
|
|
}
|
|
|
|
void __i2c_dw_disable(struct dw_i2c_dev *dev)
|
|
{
|
|
int timeout = 100;
|
|
|
|
do {
|
|
__i2c_dw_disable_nowait(dev);
|
|
/*
|
|
* The enable status register may be unimplemented, but
|
|
* in that case this test reads zero and exits the loop.
|
|
*/
|
|
if ((dw_readl(dev, DW_IC_ENABLE_STATUS) & 1) == 0)
|
|
return;
|
|
|
|
/*
|
|
* Wait 10 times the signaling period of the highest I2C
|
|
* transfer supported by the driver (for 400KHz this is
|
|
* 25us) as described in the DesignWare I2C databook.
|
|
*/
|
|
usleep_range(25, 250);
|
|
} while (timeout--);
|
|
|
|
dev_warn(dev->dev, "timeout in disabling adapter\n");
|
|
}
|
|
|
|
unsigned long i2c_dw_clk_rate(struct dw_i2c_dev *dev)
|
|
{
|
|
/*
|
|
* Clock is not necessary if we got LCNT/HCNT values directly from
|
|
* the platform code.
|
|
*/
|
|
if (WARN_ON_ONCE(!dev->get_clk_rate_khz))
|
|
return 0;
|
|
return dev->get_clk_rate_khz(dev);
|
|
}
|
|
|
|
int i2c_dw_prepare_clk(struct dw_i2c_dev *dev, bool prepare)
|
|
{
|
|
if (IS_ERR(dev->clk))
|
|
return PTR_ERR(dev->clk);
|
|
|
|
if (prepare)
|
|
return clk_prepare_enable(dev->clk);
|
|
|
|
clk_disable_unprepare(dev->clk);
|
|
return 0;
|
|
}
|
|
EXPORT_SYMBOL_GPL(i2c_dw_prepare_clk);
|
|
|
|
int i2c_dw_acquire_lock(struct dw_i2c_dev *dev)
|
|
{
|
|
int ret;
|
|
|
|
if (!dev->acquire_lock)
|
|
return 0;
|
|
|
|
ret = dev->acquire_lock(dev);
|
|
if (!ret)
|
|
return 0;
|
|
|
|
dev_err(dev->dev, "couldn't acquire bus ownership\n");
|
|
|
|
return ret;
|
|
}
|
|
|
|
void i2c_dw_release_lock(struct dw_i2c_dev *dev)
|
|
{
|
|
if (dev->release_lock)
|
|
dev->release_lock(dev);
|
|
}
|
|
|
|
/*
|
|
* Waiting for bus not busy
|
|
*/
|
|
int i2c_dw_wait_bus_not_busy(struct dw_i2c_dev *dev)
|
|
{
|
|
int timeout = TIMEOUT;
|
|
|
|
while (dw_readl(dev, DW_IC_STATUS) & DW_IC_STATUS_ACTIVITY) {
|
|
if (timeout <= 0) {
|
|
dev_warn(dev->dev, "timeout waiting for bus ready\n");
|
|
i2c_recover_bus(&dev->adapter);
|
|
|
|
if (dw_readl(dev, DW_IC_STATUS) & DW_IC_STATUS_ACTIVITY)
|
|
return -ETIMEDOUT;
|
|
return 0;
|
|
}
|
|
timeout--;
|
|
usleep_range(1000, 1100);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
int i2c_dw_handle_tx_abort(struct dw_i2c_dev *dev)
|
|
{
|
|
unsigned long abort_source = dev->abort_source;
|
|
int i;
|
|
|
|
if (abort_source & DW_IC_TX_ABRT_NOACK) {
|
|
for_each_set_bit(i, &abort_source, ARRAY_SIZE(abort_sources))
|
|
dev_dbg(dev->dev,
|
|
"%s: %s\n", __func__, abort_sources[i]);
|
|
return -EREMOTEIO;
|
|
}
|
|
|
|
for_each_set_bit(i, &abort_source, ARRAY_SIZE(abort_sources))
|
|
dev_err(dev->dev, "%s: %s\n", __func__, abort_sources[i]);
|
|
|
|
if (abort_source & DW_IC_TX_ARB_LOST)
|
|
return -EAGAIN;
|
|
else if (abort_source & DW_IC_TX_ABRT_GCALL_READ)
|
|
return -EINVAL; /* wrong msgs[] data */
|
|
else
|
|
return -EIO;
|
|
}
|
|
|
|
u32 i2c_dw_func(struct i2c_adapter *adap)
|
|
{
|
|
struct dw_i2c_dev *dev = i2c_get_adapdata(adap);
|
|
|
|
return dev->functionality;
|
|
}
|
|
|
|
void i2c_dw_disable(struct dw_i2c_dev *dev)
|
|
{
|
|
/* Disable controller */
|
|
__i2c_dw_disable(dev);
|
|
|
|
/* Disable all interupts */
|
|
dw_writel(dev, 0, DW_IC_INTR_MASK);
|
|
dw_readl(dev, DW_IC_CLR_INTR);
|
|
}
|
|
|
|
void i2c_dw_disable_int(struct dw_i2c_dev *dev)
|
|
{
|
|
dw_writel(dev, 0, DW_IC_INTR_MASK);
|
|
}
|
|
|
|
u32 i2c_dw_read_comp_param(struct dw_i2c_dev *dev)
|
|
{
|
|
return dw_readl(dev, DW_IC_COMP_PARAM_1);
|
|
}
|
|
EXPORT_SYMBOL_GPL(i2c_dw_read_comp_param);
|
|
|
|
MODULE_DESCRIPTION("Synopsys DesignWare I2C bus adapter core");
|
|
MODULE_LICENSE("GPL");
|