i2c: Support I2C controllers with multiple ports

Certain chips have I2C ports mapped to the same controller. In this
case, it's necessary to lock out access to the controller during use.
This configuration can be supported by adding CONFIG_I2C_MULTI_PORT_CONTROLLER,
which can be defined at the chip level, along with an API function to
map port index to controller index.

BUG=chrome-os-partner:38335,chrome-os-partner:38945
TEST=Manual with subsequent commit. Verify that i2cscan is functional on
strago.
BRANCH=None

Signed-off-by: Shawn Nematbakhsh <shawnn@chromium.org>
Change-Id: I37ffa661a2ad6cd2235cef2ee77637cc3ab92523
Reviewed-on: https://chromium-review.googlesource.com/265942
Reviewed-by: Alec Berg <alecaberg@chromium.org>
Reviewed-by: Kevin K Wong <kevin.k.wong@intel.com>

1 files changed, 29 insertions, 9 deletions

diff --git a/include/i2c.h b/include/i2c.h
index a4e105ddac..753efa0aec 100644
--- a/include/i2c.h
+++ b/include/i2c.h
@@ -134,20 +134,28 @@ void i2c_lock(int port, int lock);
  */
 void i2c_set_timeout(int port, uint32_t timeout);
 
-/* Read a 16-bit register from the slave at 8-bit slave address <slaveaddr>, at
- * the specified 8-bit <offset> in the slave's address space. */
+/**
+ * Read a 16-bit register from the slave at 8-bit slave address <slaveaddr>, at
+ * the specified 8-bit <offset> in the slave's address space.
+ */
 int i2c_read16(int port, int slave_addr, int offset, int *data);
 
-/* Write a 16-bit register to the slave at 8-bit slave address <slaveaddr>, at
- * the specified 8-bit <offset> in the slave's address space. */
+/**
+ * Write a 16-bit register to the slave at 8-bit slave address <slaveaddr>, at
+ * the specified 8-bit <offset> in the slave's address space.
+ */
 int i2c_write16(int port, int slave_addr, int offset, int data);
 
-/* Read an 8-bit register from the slave at 8-bit slave address <slaveaddr>, at
- * the specified 8-bit <offset> in the slave's address space. */
+/**
+ * Read an 8-bit register from the slave at 8-bit slave address <slaveaddr>, at
+ * the specified 8-bit <offset> in the slave's address space.
+ */
 int i2c_read8(int port, int slave_addr, int offset, int *data);
 
-/* Write an 8-bit register to the slave at 8-bit slave address <slaveaddr>, at
- * the specified 8-bit <offset> in the slave's address space. */
+/**
+ * Write an 8-bit register to the slave at 8-bit slave address <slaveaddr>, at
+ * the specified 8-bit <offset> in the slave's address space.
+ */
 int i2c_write8(int port, int slave_addr, int offset, int data);
 
 /**
@@ -164,7 +172,8 @@ int i2c_is_busy(int port);
  */
 int i2c_unwedge(int port);
 
-/* Read ascii string using smbus read block protocol.
+/**
+ * Read ascii string using smbus read block protocol.
  * Read bytestream from <slaveaddr>:<offset> with format:
  *     [length_N] [byte_0] [byte_1] ... [byte_N-1]
  *
@@ -176,4 +185,15 @@ int i2c_unwedge(int port);
 int i2c_read_string(int port, int slave_addr, int offset, uint8_t *data,
 			int len);
 
+/**
+ * Convert port number to controller number, for multi-port controllers.
+ * This function will only be called if CONFIG_I2C_MULTI_PORT_CONTROLLER is
+ * defined.
+ *
+ * @parm port I2C port
+ *
+ * @return controller number, or -1 on invalid parameter
+ */
+int i2c_port_to_controller(int port);
+
 #endif  /* __CROS_EC_I2C_H */