From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jean Delvare Subject: Re: [Patch v3] i2c: Multiplexed I2C bus core support Date: Mon, 19 Jul 2010 17:25:48 +0200 Message-ID: <20100719172548.2d88ed73@hyperion.delvare> References: <4C36E6E2.1070307@gmx.de> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: <4C36E6E2.1070307-Mmb7MZpHnFY@public.gmane.org> Sender: linux-i2c-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Michael Lawnick Cc: Linux I2C List-Id: linux-i2c@vger.kernel.org Hi Michael, > Add multiplexed bus core support. I2C multiplexer and switches > like pca954x get instantiated as new adapters per port. >=20 > Signed-off-by: Michael Lawnick > Cc: Jean Delvare > --- > Based on kernel 2.6.35.rc2 + > [PATCH] i2c: Move adapter locking helpers to i2c-core > by Jean Delware <20100615140218.07090c90-ig7AzVSIIG7kN2dkZ6Wm7A@public.gmane.org> > >=20 > drivers/i2c/Kconfig | 11 +++ > drivers/i2c/Makefile | 1 + > drivers/i2c/i2c-core.c | 80 +++++++++++++++++---- > drivers/i2c/i2c-dev.c | 44 +++++++++++- > drivers/i2c/i2c-mux.c | 165 > +++++++++++++++++++++++++++++++++++++++++++ As you can see, your e-mail client wrapped long lines again. I had to manually fix the patch so that I could apply it... > include/linux/i2c-mux.h | 46 ++++++++++++ > include/linux/i2c.h | 8 ++ > 7 files changed, 341 insertions(+), 14 deletions(-) > create mode 100755 drivers/i2c/i2c-mux.c > create mode 100755 include/linux/i2c-mux.h A few comments below, just FYI. Nothing for you to do, the rest is up to me I think. Thanks :) > diff --git a/drivers/i2c/Kconfig b/drivers/i2c/Kconfig > index d06083f..efb48ad > --- a/drivers/i2c/Kconfig > +++ b/drivers/i2c/Kconfig > @@ -47,6 +47,17 @@ config I2C_CHARDEV > This support is also available as a module. If so, the module > will be called i2c-dev. >=20 > +config I2C_MUX > + tristate "I2C bus multiplexing support" > + depends on EXPERIMENTAL > + help > + Say Y here if you want the I2C core to support the ability to > + handle multiplexed I2C bus topologies, by presenting each > + multiplexed segment as a I2C adapter. > + > + This support is also available as a module. If so, the module > + will be called i2c-mux. > + > config I2C_HELPER_AUTO > bool "Autoselect pertinent helper modules" > default y > diff --git a/drivers/i2c/Makefile b/drivers/i2c/Makefile > index a7d9b4b..f363258 > --- a/drivers/i2c/Makefile > +++ b/drivers/i2c/Makefile > @@ -6,6 +6,7 @@ obj-$(CONFIG_I2C_BOARDINFO) +=3D i2c-boardinfo.o > obj-$(CONFIG_I2C) +=3D i2c-core.o > obj-$(CONFIG_I2C_SMBUS) +=3D i2c-smbus.o > obj-$(CONFIG_I2C_CHARDEV) +=3D i2c-dev.o > +obj-$(CONFIG_I2C_MUX) +=3D i2c-mux.o > obj-y +=3D algos/ busses/ >=20 > ifeq ($(CONFIG_I2C_DEBUG_CORE),y) > diff --git a/drivers/i2c/i2c-core.c b/drivers/i2c/i2c-core.c > index 05a147a..d46fb3e > --- a/drivers/i2c/i2c-core.c > +++ b/drivers/i2c/i2c-core.c > @@ -20,7 +20,9 @@ > /* With some changes from Ky=C3=83=C2=83=C3=82=C2=B6sti M=C3=83=C2=83= =C3=82=C2=A4lkki . > All SMBus-related things are written by Frodo Looijaard > SMBus 2.0 support by Mark Studebaker and > - Jean Delvare */ > + Jean Delvare > + Mux support by Rodolfo Giometti and > + Michael Lawnick */ >=20 > #include > #include > @@ -417,10 +419,52 @@ static int __i2c_check_addr_busy(struct device > *dev, void *addrp) > return 0; > } >=20 > +/* walk up mux tree */ > +static int i2c_check_mux_parents(struct i2c_adapter *adapter, int ad= dr) > +{ > + int result; > + > + result =3D device_for_each_child(&adapter->dev, &addr, > + __i2c_check_addr_busy); > + > + if (!result && i2c_parent_is_i2c_adapter(adapter)) > + result =3D i2c_check_mux_parents( > + to_i2c_adapter(adapter->dev.parent), addr); > + > + return result; > +} > + > +/* recurse down mux tree */ > +static int i2c_check_mux_children(struct device *dev, void *addrp) > +{ > + int result; > + > + if (dev->type =3D=3D &i2c_adapter_type) > + result =3D device_for_each_child(dev, addrp, > + i2c_check_mux_children); > + else > + result =3D __i2c_check_addr_busy(dev, addrp); > + > + return result; > +} > + > static int i2c_check_addr_busy(struct i2c_adapter *adapter, int addr= ) > { > - return device_for_each_child(&adapter->dev, &addr, > - __i2c_check_addr_busy); > + int result =3D 0; > + > + i2c_lock_adapter(adapter); > + > + if (i2c_parent_is_i2c_adapter(adapter)) > + result =3D i2c_check_mux_parents( > + to_i2c_adapter(adapter->dev.parent), addr); > + > + if (!result) > + result =3D device_for_each_child(&adapter->dev, &addr, > + i2c_check_mux_children); > + > + i2c_unlock_adapter(adapter); I'm not convinced by your locking model. Surrounding only this function with i2c_lock/unlock_adapter() doesn't really help anything, does it? As soon as the function returns, anyone can enter the check section again, while the actual device has not yet been registered and will thus not be found by device_for_each_child(). I believe that the lock should be taken, and released, in the calling function, that is in i2c_new_device(). The lock should be taken right before calling i2c_check_addr_busy(), and released only after device_register() has been called. =46or the other calling sites (i2c_detect_address and i2c_new_probed_device), I'm not even sure we need to take the lock at all. I am told that the low-level driver core code should be able to cope with device_remove() being called in the middle of device_for_each_child(). My reading of the low-level code couldn't confirm this, but I am no expert of that part of the kernel. I'm also unsure if the adapter's lock is the right lock to use. This lock is supposed to be used to serialize I/O on the adapter. There's no reason to stop I/O on the adapter just because a new client is being registered. And thinking about it some more, it could even deadlock, is the driver's probe() function does I/O (and it often does.) The core i2c lock may be suitable, even though I admit it is an abuse too, as the problem we are trying to solve is really local to the specific adapter tree and not subsystem-wide (but OTOH, the i2c core lock is used infrequently enough that it shouldn't be a problem in practice.) Anyway, I didn't expect you to solve this problem anyway. It was there before you added mux support, so it's not your problem ;) > + > + return result; > } >=20 > /** > @@ -429,7 +473,10 @@ static int i2c_check_addr_busy(struct i2c_adapte= r > *adapter, int addr) > */ > void i2c_lock_adapter(struct i2c_adapter *adapter) > { > - rt_mutex_lock(&adapter->bus_lock); > + if (i2c_parent_is_i2c_adapter(adapter)) > + i2c_lock_adapter(to_i2c_adapter(adapter->dev.parent)); > + else > + rt_mutex_lock(&adapter->bus_lock); > } > EXPORT_SYMBOL_GPL(i2c_lock_adapter); >=20 > @@ -439,7 +486,10 @@ EXPORT_SYMBOL_GPL(i2c_lock_adapter); > */ > static int i2c_trylock_adapter(struct i2c_adapter *adapter) > { > - return rt_mutex_trylock(&adapter->bus_lock); > + if (i2c_parent_is_i2c_adapter(adapter)) > + return i2c_trylock_adapter(to_i2c_adapter(adapter->dev.parent)); > + else > + return rt_mutex_trylock(&adapter->bus_lock); > } >=20 > /** > @@ -448,7 +498,10 @@ static int i2c_trylock_adapter(struct i2c_adapte= r > *adapter) > */ > void i2c_unlock_adapter(struct i2c_adapter *adapter) > { > - rt_mutex_unlock(&adapter->bus_lock); > + if (i2c_parent_is_i2c_adapter(adapter)) > + i2c_unlock_adapter(to_i2c_adapter(adapter->dev.parent)); > + else > + rt_mutex_unlock(&adapter->bus_lock); > } > EXPORT_SYMBOL_GPL(i2c_unlock_adapter); >=20 > @@ -656,9 +709,9 @@ i2c_sysfs_new_device(struct device *dev, struct > device_attribute *attr, > return -EINVAL; >=20 > /* Keep track of the added device */ > - i2c_lock_adapter(adap); > + rt_mutex_lock(&adap->bus_lock); > list_add_tail(&client->detected, &adap->userspace_clients); > - i2c_unlock_adapter(adap); > + rt_mutex_unlock(&adap->bus_lock); > dev_info(dev, "%s: Instantiated device %s at 0x%02hx\n", "new_devic= e", > info.type, info.addr); >=20 I expected us to just use i2c_lock/unlock_adapter() everywhere for simplicity. Now I have to agree that using the segment's mutex works too, as the operation is both local to the mutex and unrelated to the other use cases of i2c_lock/unlock_adapter(). But it becomes a little tricky, so it should be all documented clearly (which I will do, don't worry.) > @@ -697,7 +750,7 @@ i2c_sysfs_delete_device(struct device *dev, struc= t > device_attribute *attr, >=20 > /* Make sure the device was added through sysfs */ > res =3D -ENOENT; > - i2c_lock_adapter(adap); > + rt_mutex_lock(&adap->bus_lock); > list_for_each_entry_safe(client, next, &adap->userspace_clients, > detected) { > if (client->addr =3D=3D addr) { > @@ -710,7 +763,7 @@ i2c_sysfs_delete_device(struct device *dev, struc= t > device_attribute *attr, > break; > } > } > - i2c_unlock_adapter(adap); > + rt_mutex_unlock(&adap->bus_lock); >=20 > if (res < 0) > dev_err(dev, "%s: Can't find device in list\n", > @@ -737,10 +790,11 @@ static const struct attribute_group > *i2c_adapter_attr_groups[] =3D { > NULL > }; >=20 > -static struct device_type i2c_adapter_type =3D { > +struct device_type i2c_adapter_type =3D { > .groups =3D i2c_adapter_attr_groups, > .release =3D i2c_adapter_dev_release, > }; > +EXPORT_SYMBOL_GPL(i2c_adapter_type); >=20 > #ifdef CONFIG_I2C_COMPAT > static struct class_compat *i2c_adapter_compat_class; > @@ -995,7 +1049,7 @@ int i2c_del_adapter(struct i2c_adapter *adap) > return res; >=20 > /* Remove devices instantiated from sysfs */ > - i2c_lock_adapter(adap); > + rt_mutex_lock(&adap->bus_lock); > list_for_each_entry_safe(client, next, &adap->userspace_clients, > detected) { > dev_dbg(&adap->dev, "Removing %s at 0x%x\n", client->name, > @@ -1003,7 +1057,7 @@ int i2c_del_adapter(struct i2c_adapter *adap) > list_del(&client->detected); > i2c_unregister_device(client); > } > - i2c_unlock_adapter(adap); > + rt_mutex_unlock(&adap->bus_lock); >=20 > /* Detach any active clients. This can't fail, thus we do not > checking the returned value. */ > diff --git a/drivers/i2c/i2c-dev.c b/drivers/i2c/i2c-dev.c > index e0694e4..6717bba > --- a/drivers/i2c/i2c-dev.c > +++ b/drivers/i2c/i2c-dev.c > @@ -193,12 +193,54 @@ static int i2cdev_check(struct device *dev, voi= d > *addrp) > return dev->driver ? -EBUSY : 0; > } >=20 > +/* walk up mux tree */ > +static int i2cdev_check_mux_parents(struct i2c_adapter *adapter, int= addr) > +{ > + int result; > + > + result =3D device_for_each_child(&adapter->dev, &addr, i2cdev_check= ); > + > + if (!result && i2c_parent_is_i2c_adapter(adapter)) > + result =3D i2cdev_check_mux_parents( > + to_i2c_adapter(adapter->dev.parent), addr); > + > + return result; > +} > + > +/* recurse down mux tree */ > +static int i2cdev_check_mux_children(struct device *dev, void *addrp= ) > +{ > + int result; > + > + if (dev->type =3D=3D &i2c_adapter_type) > + result =3D device_for_each_child(dev, addrp, > + i2cdev_check_mux_children); > + else > + result =3D i2cdev_check(dev, addrp); > + > + return result; > +} > + > /* This address checking function differs from the one in i2c-core > in that it considers an address with a registered device, but no > driver bound to it, as NOT busy. */ > static int i2cdev_check_addr(struct i2c_adapter *adapter, unsigned i= nt > addr) > { > - return device_for_each_child(&adapter->dev, &addr, i2cdev_check); > + int result =3D 0; > + > + i2c_lock_adapter(adapter); > + > + if (i2c_parent_is_i2c_adapter(adapter)) > + result =3D i2cdev_check_mux_parents( > + to_i2c_adapter(adapter->dev.parent), addr); > + > + if (!result) > + result =3D device_for_each_child(&adapter->dev, &addr, > + i2cdev_check_mux_children); > + > + i2c_unlock_adapter(adapter); > + > + return result; > } >=20 > static noinline int i2cdev_ioctl_rdrw(struct i2c_client *client, > diff --git a/drivers/i2c/i2c-mux.c b/drivers/i2c/i2c-mux.c > new file mode 100755 > index 0000000..d32a484 > --- /dev/null > +++ b/drivers/i2c/i2c-mux.c > @@ -0,0 +1,165 @@ > +/* > + * Multiplexed I2C bus driver. > + * > + * Copyright (c) 2008-2009 Rodolfo Giometti > + * Copyright (c) 2008-2009 Eurotech S.p.A. > + * Copyright (c) 2009-2010 NSN GmbH & Co KG > + * > + * Simplifies access to complex multiplexed I2C bus topologies, by > presenting > + * each multiplexed bus segment as an additional I2C adapter. > + * Supports multi-level mux'ing (mux behind a mux). > + * > + * Based on: > + * i2c-virt.c from Kumar Gala > + * i2c-virtual.c from Ken Harrenstien, Copyright (c) 2004 Google, In= c. > + * i2c-virtual.c from Brian Kuschak > + * > + * This file is licensed under the terms of the GNU General Public > + * License version 2. This program is licensed "as is" without any > + * warranty of any kind, whether express or implied. > + */ > + > +#include > +#include > +#include > +#include > +#include > + > +/* multiplexer per channel data */ > +struct i2c_mux_priv { > + struct i2c_adapter adap; > + struct i2c_algorithm algo; > + > + struct i2c_adapter *parent; > + void *mux_dev; /* the mux chip/device */ > + u32 chan_id; /* the channel id */ > + > + int (*select)(struct i2c_adapter *, void *mux_dev, u32 chan_id); > + int (*deselect)(struct i2c_adapter *, void *mux_dev, u32 chan_id); > +}; > + > +static int i2c_mux_master_xfer(struct i2c_adapter *adap, > + struct i2c_msg msgs[], int num) > +{ > + struct i2c_mux_priv *priv =3D adap->algo_data; > + struct i2c_adapter *parent =3D priv->parent; > + int ret; > + > + /* Switch to the right mux port and perform the transfer. */ > + > + ret =3D priv->select(parent, priv->mux_dev, priv->chan_id); > + if (ret >=3D 0) > + ret =3D parent->algo->master_xfer(parent, msgs, num); > + if (priv->deselect) > + priv->deselect(parent, priv->mux_dev, priv->chan_id); > + > + return ret; > +} > + > +static int i2c_mux_smbus_xfer(struct i2c_adapter *adap, > + u16 addr, unsigned short flags, > + char read_write, u8 command, > + int size, union i2c_smbus_data *data) > +{ > + struct i2c_mux_priv *priv =3D adap->algo_data; > + struct i2c_adapter *parent =3D priv->parent; > + int ret; > + > + /* Select the right mux port and perform the transfer. */ > + > + ret =3D priv->select(parent, priv->mux_dev, priv->chan_id); > + if (ret >=3D 0) > + ret =3D parent->algo->smbus_xfer(parent, addr, flags, > + read_write, command, size, data); > + if (priv->deselect) > + priv->deselect(parent, priv->mux_dev, priv->chan_id); > + > + return ret; > +} > + > +/* Return the parent's functionality */ > +static u32 i2c_mux_functionality(struct i2c_adapter *adap) > +{ > + struct i2c_mux_priv *priv =3D adap->algo_data; > + struct i2c_adapter *parent =3D priv->parent; > + > + return parent->algo->functionality(parent); > +} > + > +struct i2c_adapter *i2c_add_mux_adapter(struct i2c_adapter *parent, > + void *mux_dev, u32 force_nr, u32 chan_id, > + int (*select) (struct i2c_adapter *, > + void *, u32), > + int (*deselect) (struct i2c_adapter *, > + void *, u32)) > +{ > + struct i2c_mux_priv *priv; > + int ret; > + > + priv =3D kzalloc(sizeof(struct i2c_mux_priv), GFP_KERNEL); > + if (!priv) > + return NULL; > + > + /* Set up private adapter data */ > + priv->parent =3D parent; > + priv->mux_dev =3D mux_dev; > + priv->chan_id =3D chan_id; > + priv->select =3D select; > + priv->deselect =3D deselect; > + > + /* Need to do algo dynamically because we don't know ahead > + * of time what sort of physical adapter we'll be dealing with. > + */ > + if (parent->algo->master_xfer) > + priv->algo.master_xfer =3D i2c_mux_master_xfer; > + if (parent->algo->smbus_xfer) > + priv->algo.smbus_xfer =3D i2c_mux_smbus_xfer; > + priv->algo.functionality =3D i2c_mux_functionality; > + > + /* Now fill out new adapter structure */ > + snprintf(priv->adap.name, sizeof(priv->adap.name), > + "i2c-%d-mux (chan_id %d)", i2c_adapter_id(parent), chan_id); > + priv->adap.owner =3D THIS_MODULE; > + priv->adap.id =3D parent->id; > + priv->adap.algo =3D &priv->algo; > + priv->adap.algo_data =3D priv; > + priv->adap.dev.parent =3D &parent->dev; > + > + if (force_nr) { > + priv->adap.nr =3D force_nr; > + ret =3D i2c_add_numbered_adapter(&priv->adap); > + } else { > + ret =3D i2c_add_adapter(&priv->adap); > + } > + if (ret < 0) { > + dev_err(&parent->dev, > + "failed to add mux-adapter (error=3D%d)\n", > + ret); > + kfree(priv); > + return NULL; > + } > + > + dev_info(&parent->dev, "Added multiplexed i2c bus %d\n", > + i2c_adapter_id(&priv->adap)); > + > + return &priv->adap; > +} > +EXPORT_SYMBOL_GPL(i2c_add_mux_adapter); > + > +int i2c_del_mux_adapter(struct i2c_adapter *adap) > +{ > + struct i2c_mux_priv *priv =3D adap->algo_data; > + int ret; > + > + ret =3D i2c_del_adapter(adap); > + if (ret < 0) > + return ret; > + kfree(priv); > + > + return 0; > +} > +EXPORT_SYMBOL_GPL(i2c_del_mux_adapter); > + > +MODULE_AUTHOR("Rodolfo Giometti "); > +MODULE_DESCRIPTION("I2C driver for multiplexed I2C busses"); > +MODULE_LICENSE("GPL v2"); > diff --git a/include/linux/i2c-mux.h b/include/linux/i2c-mux.h > new file mode 100755 > index 0000000..4c52ee1 > --- /dev/null > +++ b/include/linux/i2c-mux.h > @@ -0,0 +1,46 @@ > +/* > + * > + * i2c-mux.h - functions for the i2c-bus mux support > + * > + * Copyright (c) 2008-2009 Rodolfo Giometti > + * Copyright (c) 2008-2009 Eurotech S.p.A. > + * Michael Lawnick > + * > + * This program is free software; you can redistribute it and/or mod= ify > + * it under the terms of the GNU General Public License as published= by > + * the Free Software Foundation; either version 2 of the License, or > + * (at your option) any later version. > + * > + * This program is distributed in the hope that it will be useful, > + * but WITHOUT ANY WARRANTY; without even the implied warranty of > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the > + * GNU General Public License for more details. > + * > + * You should have received a copy of the GNU General Public License > + * along with this program; if not, write to the Free Software > + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. > + */ > + > +#ifndef _LINUX_I2C_MUX_H > +#define _LINUX_I2C_MUX_H > + > +#ifdef __KERNEL__ > + > +/* > + * Called to create a i2c bus on a multiplexed bus segment. > + * The mux_dev and chan_id parameters are passed to the select > + * and deselect callback functions to perform hardware-specific > + * mux control. > + */ > +struct i2c_adapter *i2c_add_mux_adapter(struct i2c_adapter *parent, > + void *mux_dev, u32 force_nr, u32 chan_id, > + int (*select) (struct i2c_adapter *adap, > + void *mux_dev, u32 chan_id), > + int (*deselect) (struct i2c_adapter *, > + void *mux_dev, u32 chan_id)); > + > +int i2c_del_mux_adapter(struct i2c_adapter *adap); > + > +#endif /* __KERNEL__ */ > + > +#endif /* _LINUX_I2C_MUX_H */ > diff --git a/include/linux/i2c.h b/include/linux/i2c.h > index f2d36bd..8f2b83a > --- a/include/linux/i2c.h > +++ b/include/linux/i2c.h > @@ -37,6 +37,7 @@ > #include /* for struct device_node */ >=20 > extern struct bus_type i2c_bus_type; > +extern struct device_type i2c_adapter_type; >=20 > /* --- General options ---------------------------------------------= --- */ >=20 > @@ -374,6 +375,13 @@ static inline void i2c_set_adapdata(struct > i2c_adapter *dev, void *data) > dev_set_drvdata(&dev->dev, data); > } >=20 > +static inline int i2c_parent_is_i2c_adapter(const struct i2c_adapter > *adapter) > +{ > + return adapter->dev.parent !=3D NULL > + && adapter->dev.parent->bus =3D=3D &i2c_bus_type > + && adapter->dev.parent->type =3D=3D &i2c_adapter_type; > +} > + > /* Adapter locking functions, exported for shared pin cases */ > void i2c_lock_adapter(struct i2c_adapter *); > void i2c_unlock_adapter(struct i2c_adapter *); --=20 Jean Delvare