Re: [PATCH resubmit 1/2] i2c: core: add device-managed version of i2c_new_dummy

From: Bartosz Golaszewski
Date: Wed Dec 06 2017 - 05:36:45 EST


2017-12-05 20:44 GMT+01:00 Heiner Kallweit <hkallweit1@xxxxxxxxx>:
> i2c_new_dummy is typically called from the probe function of the
> driver for the primary i2c client. It requires calls to
> i2c_unregister_device in the error path of the probe function and
> in the remove function.
> This can be simplified by introducing a device-managed version.
>
> Note the changed error case return value type:
> i2c_new_dummy returns NULL whilst devm_new_i2c_dummy returns an ERR_PTR.
>
> Signed-off-by: Heiner Kallweit <hkallweit1@xxxxxxxxx>
> Reviewed-by: Peter Rosin <peda@xxxxxxxxxx>
> ---
> Documentation/driver-model/devres.txt | 3 +++
> drivers/i2c/i2c-core-base.c | 39 +++++++++++++++++++++++++++++++++++
> include/linux/i2c.h | 3 +++
> 3 files changed, 45 insertions(+)
>
> diff --git a/Documentation/driver-model/devres.txt b/Documentation/driver-model/devres.txt
> index c180045eb..6e2bccf85 100644
> --- a/Documentation/driver-model/devres.txt
> +++ b/Documentation/driver-model/devres.txt
> @@ -259,6 +259,9 @@ GPIO
> devm_gpio_request_one()
> devm_gpio_free()
>
> +I2C
> + devm_i2c_new_dummy
> +
> IIO
> devm_iio_device_alloc()
> devm_iio_device_free()
> diff --git a/drivers/i2c/i2c-core-base.c b/drivers/i2c/i2c-core-base.c
> index bf52cca87..c1db67f9a 100644
> --- a/drivers/i2c/i2c-core-base.c
> +++ b/drivers/i2c/i2c-core-base.c
> @@ -820,6 +820,45 @@ struct i2c_client *i2c_new_dummy(struct i2c_adapter *adapter, u16 address)
> }
> EXPORT_SYMBOL_GPL(i2c_new_dummy);
>
> +static void devm_i2c_release_dummy(struct device *dev, void *res)
> +{
> + i2c_unregister_device(*(struct i2c_client **)res);
> +}
> +

Wolfram will have the last word here, but I would really prefer that
you wrap struct i2c_client in a separate devres (e.g. struct
i2c_dummy_devres) structure and avoid the cast. I find it a lot more
readable even if it only has a single member.

> +/**
> + * devm_i2c_new_dummy - return a new i2c device bound to a dummy driver
> + * @dev: device the managed resource is bound to
> + * @adapter: the adapter managing the device
> + * @address: seven bit address to be used
> + * Context: can sleep
> + *
> + * This is the device-managed version of i2c_new_dummy.
> + * Note the changed return value type: It returns the new i2c client
> + * or an ERR_PTR in case of an error.
> + */
> +struct i2c_client *devm_i2c_new_dummy(struct device *dev,
> + struct i2c_adapter *adapter,
> + u16 address)
> +{
> + struct i2c_client *ret, **dr;
> +
> + dr = devres_alloc(devm_i2c_release_dummy, sizeof(*dr), GFP_KERNEL);
> + if (!dr)
> + return ERR_PTR(-ENOMEM);
> +
> + ret = i2c_new_dummy(adapter, address);
> + if (!ret) {
> + devres_free(dr);
> + return ERR_PTR(-EBUSY);

This is misleading as EBUSY is not necessarily the error that cased
i2c_new_device() to fail. Return NULL here and document that users
need to use IS_ERR_OR_NULL() to check for errors.

> + }
> +
> + *dr = ret;
> + devres_add(dev, dr);
> +
> + return ret;
> +}
> +EXPORT_SYMBOL_GPL(devm_i2c_new_dummy);
> +
> /**
> * i2c_new_secondary_device - Helper to get the instantiated secondary address
> * and create the associated device
> diff --git a/include/linux/i2c.h b/include/linux/i2c.h
> index a556db976..c27eac1e1 100644
> --- a/include/linux/i2c.h
> +++ b/include/linux/i2c.h
> @@ -383,6 +383,9 @@ extern int i2c_probe_func_quick_read(struct i2c_adapter *, unsigned short addr);
> extern struct i2c_client *
> i2c_new_dummy(struct i2c_adapter *adap, u16 address);
>
> +extern struct i2c_client *
> +devm_i2c_new_dummy(struct device *dev, struct i2c_adapter *adap, u16 address);
> +
> extern struct i2c_client *
> i2c_new_secondary_device(struct i2c_client *client,
> const char *name,
> --
> 2.15.1
>
>

Thanks,
Bartosz