Message ID | 20180808153150.23444-29-brgl@bgdev.pl (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | at24: remove at24_platform_data | expand |
On Wed, Aug 8, 2018 at 6:31 PM, Bartosz Golaszewski <brgl@bgdev.pl> wrote: > From: Bartosz Golaszewski <bgolaszewski@baylibre.com> > > There are no more users of at24_platform_data. Remove the relevant > header and modify the driver code to not use it anymore. > Reviewed-by: Andy Shevchenko <andy.shevchenko@gmail.com> If you want me to test this on Intel Galileo Gen 2 board, give me a public tree from where I can pull. Thanks. > Signed-off-by: Bartosz Golaszewski <bgolaszewski@baylibre.com> > --- > MAINTAINERS | 1 - > drivers/misc/eeprom/at24.c | 127 +++++++++++++---------------- > include/linux/platform_data/at24.h | 60 -------------- > 3 files changed, 57 insertions(+), 131 deletions(-) > delete mode 100644 include/linux/platform_data/at24.h > > diff --git a/MAINTAINERS b/MAINTAINERS > index 7cebd5bba8a8..8eb87a3548f8 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -2328,7 +2328,6 @@ T: git git://git.kernel.org/pub/scm/linux/kernel/git/brgl/linux.git > S: Maintained > F: Documentation/devicetree/bindings/eeprom/at24.txt > F: drivers/misc/eeprom/at24.c > -F: include/linux/platform_data/at24.h > > ATA OVER ETHERNET (AOE) DRIVER > M: "Ed L. Cashin" <ed.cashin@acm.org> > diff --git a/drivers/misc/eeprom/at24.c b/drivers/misc/eeprom/at24.c > index f5cc517d1131..93642b4b47c5 100644 > --- a/drivers/misc/eeprom/at24.c > +++ b/drivers/misc/eeprom/at24.c > @@ -22,10 +22,24 @@ > #include <linux/i2c.h> > #include <linux/nvmem-provider.h> > #include <linux/regmap.h> > -#include <linux/platform_data/at24.h> > #include <linux/pm_runtime.h> > #include <linux/gpio/consumer.h> > > +/* Address pointer is 16 bit. */ > +#define AT24_FLAG_ADDR16 BIT(7) > +/* sysfs-entry will be read-only. */ > +#define AT24_FLAG_READONLY BIT(6) > +/* sysfs-entry will be world-readable. */ > +#define AT24_FLAG_IRUGO BIT(5) > +/* Take always 8 addresses (24c00). */ > +#define AT24_FLAG_TAKE8ADDR BIT(4) > +/* Factory-programmed serial number. */ > +#define AT24_FLAG_SERIAL BIT(3) > +/* Factory-programmed mac address. */ > +#define AT24_FLAG_MAC BIT(2) > +/* Does not auto-rollover reads to the next slave address. */ > +#define AT24_FLAG_NO_RDROL BIT(1) > + > /* > * I2C EEPROMs from most vendors are inexpensive and mostly interchangeable. > * Differences between different vendor product lines (like Atmel AT24C or > @@ -124,10 +138,6 @@ MODULE_PARM_DESC(at24_write_timeout, "Time (in ms) to try writes (default 25)"); > usleep_range(1000, 1500), op_time = jiffies) > > struct at24_chip_data { > - /* > - * these fields mirror their equivalents in > - * struct at24_platform_data > - */ > u32 byte_len; > u8 flags; > }; > @@ -467,46 +477,11 @@ static int at24_write(void *priv, unsigned int off, void *val, size_t count) > return 0; > } > > -static void at24_properties_to_pdata(struct device *dev, > - struct at24_platform_data *chip) > -{ > - int err; > - u32 val; > - > - if (device_property_present(dev, "read-only")) > - chip->flags |= AT24_FLAG_READONLY; > - if (device_property_present(dev, "no-read-rollover")) > - chip->flags |= AT24_FLAG_NO_RDROL; > - > - err = device_property_read_u32(dev, "size", &val); > - if (!err) > - chip->byte_len = val; > - > - err = device_property_read_u32(dev, "pagesize", &val); > - if (!err) { > - chip->page_size = val; > - } else { > - /* > - * This is slow, but we can't know all eeproms, so we better > - * play safe. Specifying custom eeprom-types via platform_data > - * is recommended anyhow. > - */ > - chip->page_size = 1; > - } > -} > - > -static int at24_get_pdata(struct device *dev, struct at24_platform_data *pdata) > +static const struct at24_chip_data *at24_get_chip_data(struct device *dev) > { > struct device_node *of_node = dev->of_node; > const struct at24_chip_data *cdata; > const struct i2c_device_id *id; > - struct at24_platform_data *pd; > - > - pd = dev_get_platdata(dev); > - if (pd) { > - memcpy(pdata, pd, sizeof(*pdata)); > - return 0; > - } > > id = i2c_match_id(at24_ids, to_i2c_client(dev)); > > @@ -523,13 +498,9 @@ static int at24_get_pdata(struct device *dev, struct at24_platform_data *pdata) > cdata = acpi_device_get_match_data(dev); > > if (!cdata) > - return -ENODEV; > + return ERR_PTR(-ENODEV); > > - pdata->byte_len = cdata->byte_len; > - pdata->flags = cdata->flags; > - at24_properties_to_pdata(dev, pdata); > - > - return 0; > + return cdata; > } > > static void at24_remove_dummy_clients(struct at24_data *at24) > @@ -598,8 +569,9 @@ static int at24_probe(struct i2c_client *client) > { > struct regmap_config regmap_config = { }; > struct nvmem_config nvmem_config = { }; > - struct at24_platform_data pdata = { }; > + const struct at24_chip_data *cdata; > struct device *dev = &client->dev; > + u32 byte_len, page_size, flags; > bool i2c_fn_i2c, i2c_fn_block; > unsigned int i, num_addresses; > struct at24_data *at24; > @@ -613,35 +585,54 @@ static int at24_probe(struct i2c_client *client) > i2c_fn_block = i2c_check_functionality(client->adapter, > I2C_FUNC_SMBUS_WRITE_I2C_BLOCK); > > - err = at24_get_pdata(dev, &pdata); > + cdata = at24_get_chip_data(dev); > + if (IS_ERR(cdata)) > + return PTR_ERR(cdata); > + > + err = device_property_read_u32(dev, "pagesize", &page_size); > + if (err) > + /* > + * This is slow, but we can't know all eeproms, so we better > + * play safe. Specifying custom eeprom-types via platform_data > + * is recommended anyhow. > + */ > + page_size = 1; > + > + flags = cdata->flags; > + if (device_property_present(dev, "read-only")) > + flags |= AT24_FLAG_READONLY; > + if (device_property_present(dev, "no-read-rollover")) > + flags |= AT24_FLAG_NO_RDROL; > + > + err = device_property_read_u32(dev, "size", &byte_len); > if (err) > - return err; > + byte_len = cdata->byte_len; > > if (!i2c_fn_i2c && !i2c_fn_block) > - pdata.page_size = 1; > + page_size = 1; > > - if (!pdata.page_size) { > + if (!page_size) { > dev_err(dev, "page_size must not be 0!\n"); > return -EINVAL; > } > > - if (!is_power_of_2(pdata.page_size)) > + if (!is_power_of_2(page_size)) > dev_warn(dev, "page_size looks suspicious (no power of 2)!\n"); > > - if (pdata.flags & AT24_FLAG_TAKE8ADDR) > + if (flags & AT24_FLAG_TAKE8ADDR) > num_addresses = 8; > else > - num_addresses = DIV_ROUND_UP(pdata.byte_len, > - (pdata.flags & AT24_FLAG_ADDR16) ? 65536 : 256); > + num_addresses = DIV_ROUND_UP(byte_len, > + (flags & AT24_FLAG_ADDR16) ? 65536 : 256); > > - if ((pdata.flags & AT24_FLAG_SERIAL) && (pdata.flags & AT24_FLAG_MAC)) { > + if ((flags & AT24_FLAG_SERIAL) && (flags & AT24_FLAG_MAC)) { > dev_err(dev, > "invalid device data - cannot have both AT24_FLAG_SERIAL & AT24_FLAG_MAC."); > return -EINVAL; > } > > regmap_config.val_bits = 8; > - regmap_config.reg_bits = (pdata.flags & AT24_FLAG_ADDR16) ? 16 : 8; > + regmap_config.reg_bits = (flags & AT24_FLAG_ADDR16) ? 16 : 8; > regmap_config.disable_locking = true; > > regmap = devm_regmap_init_i2c(client, ®map_config); > @@ -654,11 +645,11 @@ static int at24_probe(struct i2c_client *client) > return -ENOMEM; > > mutex_init(&at24->lock); > - at24->byte_len = pdata.byte_len; > - at24->page_size = pdata.page_size; > - at24->flags = pdata.flags; > + at24->byte_len = byte_len; > + at24->page_size = page_size; > + at24->flags = flags; > at24->num_addresses = num_addresses; > - at24->offset_adj = at24_get_offset_adj(pdata.flags, pdata.byte_len); > + at24->offset_adj = at24_get_offset_adj(flags, byte_len); > at24->client[0].client = client; > at24->client[0].regmap = regmap; > > @@ -666,10 +657,10 @@ static int at24_probe(struct i2c_client *client) > if (IS_ERR(at24->wp_gpio)) > return PTR_ERR(at24->wp_gpio); > > - writable = !(pdata.flags & AT24_FLAG_READONLY); > + writable = !(flags & AT24_FLAG_READONLY); > if (writable) { > at24->write_max = min_t(unsigned int, > - pdata.page_size, at24_io_limit); > + page_size, at24_io_limit); > if (!i2c_fn_i2c && at24->write_max > I2C_SMBUS_BLOCK_MAX) > at24->write_max = I2C_SMBUS_BLOCK_MAX; > } > @@ -712,7 +703,7 @@ static int at24_probe(struct i2c_client *client) > nvmem_config.priv = at24; > nvmem_config.stride = 1; > nvmem_config.word_size = 1; > - nvmem_config.size = pdata.byte_len; > + nvmem_config.size = byte_len; > > at24->nvmem = devm_nvmem_register(dev, &nvmem_config); > if (IS_ERR(at24->nvmem)) { > @@ -721,13 +712,9 @@ static int at24_probe(struct i2c_client *client) > } > > dev_info(dev, "%u byte %s EEPROM, %s, %u bytes/write\n", > - pdata.byte_len, client->name, > + byte_len, client->name, > writable ? "writable" : "read-only", at24->write_max); > > - /* export data to kernel code */ > - if (pdata.setup) > - pdata.setup(at24->nvmem, pdata.context); > - > return 0; > > err_clients: > diff --git a/include/linux/platform_data/at24.h b/include/linux/platform_data/at24.h > deleted file mode 100644 > index 63507ff464ee..000000000000 > --- a/include/linux/platform_data/at24.h > +++ /dev/null > @@ -1,60 +0,0 @@ > -/* > - * at24.h - platform_data for the at24 (generic eeprom) driver > - * (C) Copyright 2008 by Pengutronix > - * (C) Copyright 2012 by Wolfram Sang > - * same license as the driver > - */ > - > -#ifndef _LINUX_AT24_H > -#define _LINUX_AT24_H > - > -#include <linux/types.h> > -#include <linux/nvmem-consumer.h> > -#include <linux/bitops.h> > - > -/** > - * struct at24_platform_data - data to set up at24 (generic eeprom) driver > - * @byte_len: size of eeprom in byte > - * @page_size: number of byte which can be written in one go > - * @flags: tunable options, check AT24_FLAG_* defines > - * @setup: an optional callback invoked after eeprom is probed; enables kernel > - code to access eeprom via nvmem, see example > - * @context: optional parameter passed to setup() > - * > - * If you set up a custom eeprom type, please double-check the parameters. > - * Especially page_size needs extra care, as you risk data loss if your value > - * is bigger than what the chip actually supports! > - * > - * An example in pseudo code for a setup() callback: > - * > - * void get_mac_addr(struct nvmem_device *nvmem, void *context) > - * { > - * u8 *mac_addr = ethernet_pdata->mac_addr; > - * off_t offset = context; > - * > - * // Read MAC addr from EEPROM > - * if (nvmem_device_read(nvmem, offset, ETH_ALEN, mac_addr) == ETH_ALEN) > - * pr_info("Read MAC addr from EEPROM: %pM\n", mac_addr); > - * } > - * > - * This function pointer and context can now be set up in at24_platform_data. > - */ > - > -struct at24_platform_data { > - u32 byte_len; /* size (sum of all addr) */ > - u16 page_size; /* for writes */ > - u8 flags; > -#define AT24_FLAG_ADDR16 BIT(7) /* address pointer is 16 bit */ > -#define AT24_FLAG_READONLY BIT(6) /* sysfs-entry will be read-only */ > -#define AT24_FLAG_IRUGO BIT(5) /* sysfs-entry will be world-readable */ > -#define AT24_FLAG_TAKE8ADDR BIT(4) /* take always 8 addresses (24c00) */ > -#define AT24_FLAG_SERIAL BIT(3) /* factory-programmed serial number */ > -#define AT24_FLAG_MAC BIT(2) /* factory-programmed mac address */ > -#define AT24_FLAG_NO_RDROL BIT(1) /* does not auto-rollover reads to */ > - /* the next slave address */ > - > - void (*setup)(struct nvmem_device *nvmem, void *context); > - void *context; > -}; > - > -#endif /* _LINUX_AT24_H */ > -- > 2.18.0 >
2018-08-08 20:03 GMT+02:00 Andy Shevchenko <andy.shevchenko@gmail.com>: > On Wed, Aug 8, 2018 at 6:31 PM, Bartosz Golaszewski <brgl@bgdev.pl> wrote: >> From: Bartosz Golaszewski <bgolaszewski@baylibre.com> >> >> There are no more users of at24_platform_data. Remove the relevant >> header and modify the driver code to not use it anymore. >> > > > Reviewed-by: Andy Shevchenko <andy.shevchenko@gmail.com> > > If you want me to test this on Intel Galileo Gen 2 board, give me a > public tree from where I can pull. > Thanks. > Yes, you can pull from git@github.com:brgl/linux.git davinci-remove-at24-platform-data Bart -- To unsubscribe from this list: send the line "unsubscribe linux-omap" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
2018-08-09 13:33 GMT+02:00 Bartosz Golaszewski <brgl@bgdev.pl>: > 2018-08-08 20:03 GMT+02:00 Andy Shevchenko <andy.shevchenko@gmail.com>: >> On Wed, Aug 8, 2018 at 6:31 PM, Bartosz Golaszewski <brgl@bgdev.pl> wrote: >>> From: Bartosz Golaszewski <bgolaszewski@baylibre.com> >>> >>> There are no more users of at24_platform_data. Remove the relevant >>> header and modify the driver code to not use it anymore. >>> >> >> >> Reviewed-by: Andy Shevchenko <andy.shevchenko@gmail.com> >> >> If you want me to test this on Intel Galileo Gen 2 board, give me a >> public tree from where I can pull. >> Thanks. >> > > Yes, you can pull from git@github.com:brgl/linux.git > davinci-remove-at24-platform-data > The branch is topic/davinci-remove-at24-platform-data > Bart -- To unsubscribe from this list: send the line "unsubscribe linux-omap" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
diff --git a/MAINTAINERS b/MAINTAINERS index 7cebd5bba8a8..8eb87a3548f8 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -2328,7 +2328,6 @@ T: git git://git.kernel.org/pub/scm/linux/kernel/git/brgl/linux.git S: Maintained F: Documentation/devicetree/bindings/eeprom/at24.txt F: drivers/misc/eeprom/at24.c -F: include/linux/platform_data/at24.h ATA OVER ETHERNET (AOE) DRIVER M: "Ed L. Cashin" <ed.cashin@acm.org> diff --git a/drivers/misc/eeprom/at24.c b/drivers/misc/eeprom/at24.c index f5cc517d1131..93642b4b47c5 100644 --- a/drivers/misc/eeprom/at24.c +++ b/drivers/misc/eeprom/at24.c @@ -22,10 +22,24 @@ #include <linux/i2c.h> #include <linux/nvmem-provider.h> #include <linux/regmap.h> -#include <linux/platform_data/at24.h> #include <linux/pm_runtime.h> #include <linux/gpio/consumer.h> +/* Address pointer is 16 bit. */ +#define AT24_FLAG_ADDR16 BIT(7) +/* sysfs-entry will be read-only. */ +#define AT24_FLAG_READONLY BIT(6) +/* sysfs-entry will be world-readable. */ +#define AT24_FLAG_IRUGO BIT(5) +/* Take always 8 addresses (24c00). */ +#define AT24_FLAG_TAKE8ADDR BIT(4) +/* Factory-programmed serial number. */ +#define AT24_FLAG_SERIAL BIT(3) +/* Factory-programmed mac address. */ +#define AT24_FLAG_MAC BIT(2) +/* Does not auto-rollover reads to the next slave address. */ +#define AT24_FLAG_NO_RDROL BIT(1) + /* * I2C EEPROMs from most vendors are inexpensive and mostly interchangeable. * Differences between different vendor product lines (like Atmel AT24C or @@ -124,10 +138,6 @@ MODULE_PARM_DESC(at24_write_timeout, "Time (in ms) to try writes (default 25)"); usleep_range(1000, 1500), op_time = jiffies) struct at24_chip_data { - /* - * these fields mirror their equivalents in - * struct at24_platform_data - */ u32 byte_len; u8 flags; }; @@ -467,46 +477,11 @@ static int at24_write(void *priv, unsigned int off, void *val, size_t count) return 0; } -static void at24_properties_to_pdata(struct device *dev, - struct at24_platform_data *chip) -{ - int err; - u32 val; - - if (device_property_present(dev, "read-only")) - chip->flags |= AT24_FLAG_READONLY; - if (device_property_present(dev, "no-read-rollover")) - chip->flags |= AT24_FLAG_NO_RDROL; - - err = device_property_read_u32(dev, "size", &val); - if (!err) - chip->byte_len = val; - - err = device_property_read_u32(dev, "pagesize", &val); - if (!err) { - chip->page_size = val; - } else { - /* - * This is slow, but we can't know all eeproms, so we better - * play safe. Specifying custom eeprom-types via platform_data - * is recommended anyhow. - */ - chip->page_size = 1; - } -} - -static int at24_get_pdata(struct device *dev, struct at24_platform_data *pdata) +static const struct at24_chip_data *at24_get_chip_data(struct device *dev) { struct device_node *of_node = dev->of_node; const struct at24_chip_data *cdata; const struct i2c_device_id *id; - struct at24_platform_data *pd; - - pd = dev_get_platdata(dev); - if (pd) { - memcpy(pdata, pd, sizeof(*pdata)); - return 0; - } id = i2c_match_id(at24_ids, to_i2c_client(dev)); @@ -523,13 +498,9 @@ static int at24_get_pdata(struct device *dev, struct at24_platform_data *pdata) cdata = acpi_device_get_match_data(dev); if (!cdata) - return -ENODEV; + return ERR_PTR(-ENODEV); - pdata->byte_len = cdata->byte_len; - pdata->flags = cdata->flags; - at24_properties_to_pdata(dev, pdata); - - return 0; + return cdata; } static void at24_remove_dummy_clients(struct at24_data *at24) @@ -598,8 +569,9 @@ static int at24_probe(struct i2c_client *client) { struct regmap_config regmap_config = { }; struct nvmem_config nvmem_config = { }; - struct at24_platform_data pdata = { }; + const struct at24_chip_data *cdata; struct device *dev = &client->dev; + u32 byte_len, page_size, flags; bool i2c_fn_i2c, i2c_fn_block; unsigned int i, num_addresses; struct at24_data *at24; @@ -613,35 +585,54 @@ static int at24_probe(struct i2c_client *client) i2c_fn_block = i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_WRITE_I2C_BLOCK); - err = at24_get_pdata(dev, &pdata); + cdata = at24_get_chip_data(dev); + if (IS_ERR(cdata)) + return PTR_ERR(cdata); + + err = device_property_read_u32(dev, "pagesize", &page_size); + if (err) + /* + * This is slow, but we can't know all eeproms, so we better + * play safe. Specifying custom eeprom-types via platform_data + * is recommended anyhow. + */ + page_size = 1; + + flags = cdata->flags; + if (device_property_present(dev, "read-only")) + flags |= AT24_FLAG_READONLY; + if (device_property_present(dev, "no-read-rollover")) + flags |= AT24_FLAG_NO_RDROL; + + err = device_property_read_u32(dev, "size", &byte_len); if (err) - return err; + byte_len = cdata->byte_len; if (!i2c_fn_i2c && !i2c_fn_block) - pdata.page_size = 1; + page_size = 1; - if (!pdata.page_size) { + if (!page_size) { dev_err(dev, "page_size must not be 0!\n"); return -EINVAL; } - if (!is_power_of_2(pdata.page_size)) + if (!is_power_of_2(page_size)) dev_warn(dev, "page_size looks suspicious (no power of 2)!\n"); - if (pdata.flags & AT24_FLAG_TAKE8ADDR) + if (flags & AT24_FLAG_TAKE8ADDR) num_addresses = 8; else - num_addresses = DIV_ROUND_UP(pdata.byte_len, - (pdata.flags & AT24_FLAG_ADDR16) ? 65536 : 256); + num_addresses = DIV_ROUND_UP(byte_len, + (flags & AT24_FLAG_ADDR16) ? 65536 : 256); - if ((pdata.flags & AT24_FLAG_SERIAL) && (pdata.flags & AT24_FLAG_MAC)) { + if ((flags & AT24_FLAG_SERIAL) && (flags & AT24_FLAG_MAC)) { dev_err(dev, "invalid device data - cannot have both AT24_FLAG_SERIAL & AT24_FLAG_MAC."); return -EINVAL; } regmap_config.val_bits = 8; - regmap_config.reg_bits = (pdata.flags & AT24_FLAG_ADDR16) ? 16 : 8; + regmap_config.reg_bits = (flags & AT24_FLAG_ADDR16) ? 16 : 8; regmap_config.disable_locking = true; regmap = devm_regmap_init_i2c(client, ®map_config); @@ -654,11 +645,11 @@ static int at24_probe(struct i2c_client *client) return -ENOMEM; mutex_init(&at24->lock); - at24->byte_len = pdata.byte_len; - at24->page_size = pdata.page_size; - at24->flags = pdata.flags; + at24->byte_len = byte_len; + at24->page_size = page_size; + at24->flags = flags; at24->num_addresses = num_addresses; - at24->offset_adj = at24_get_offset_adj(pdata.flags, pdata.byte_len); + at24->offset_adj = at24_get_offset_adj(flags, byte_len); at24->client[0].client = client; at24->client[0].regmap = regmap; @@ -666,10 +657,10 @@ static int at24_probe(struct i2c_client *client) if (IS_ERR(at24->wp_gpio)) return PTR_ERR(at24->wp_gpio); - writable = !(pdata.flags & AT24_FLAG_READONLY); + writable = !(flags & AT24_FLAG_READONLY); if (writable) { at24->write_max = min_t(unsigned int, - pdata.page_size, at24_io_limit); + page_size, at24_io_limit); if (!i2c_fn_i2c && at24->write_max > I2C_SMBUS_BLOCK_MAX) at24->write_max = I2C_SMBUS_BLOCK_MAX; } @@ -712,7 +703,7 @@ static int at24_probe(struct i2c_client *client) nvmem_config.priv = at24; nvmem_config.stride = 1; nvmem_config.word_size = 1; - nvmem_config.size = pdata.byte_len; + nvmem_config.size = byte_len; at24->nvmem = devm_nvmem_register(dev, &nvmem_config); if (IS_ERR(at24->nvmem)) { @@ -721,13 +712,9 @@ static int at24_probe(struct i2c_client *client) } dev_info(dev, "%u byte %s EEPROM, %s, %u bytes/write\n", - pdata.byte_len, client->name, + byte_len, client->name, writable ? "writable" : "read-only", at24->write_max); - /* export data to kernel code */ - if (pdata.setup) - pdata.setup(at24->nvmem, pdata.context); - return 0; err_clients: diff --git a/include/linux/platform_data/at24.h b/include/linux/platform_data/at24.h deleted file mode 100644 index 63507ff464ee..000000000000 --- a/include/linux/platform_data/at24.h +++ /dev/null @@ -1,60 +0,0 @@ -/* - * at24.h - platform_data for the at24 (generic eeprom) driver - * (C) Copyright 2008 by Pengutronix - * (C) Copyright 2012 by Wolfram Sang - * same license as the driver - */ - -#ifndef _LINUX_AT24_H -#define _LINUX_AT24_H - -#include <linux/types.h> -#include <linux/nvmem-consumer.h> -#include <linux/bitops.h> - -/** - * struct at24_platform_data - data to set up at24 (generic eeprom) driver - * @byte_len: size of eeprom in byte - * @page_size: number of byte which can be written in one go - * @flags: tunable options, check AT24_FLAG_* defines - * @setup: an optional callback invoked after eeprom is probed; enables kernel - code to access eeprom via nvmem, see example - * @context: optional parameter passed to setup() - * - * If you set up a custom eeprom type, please double-check the parameters. - * Especially page_size needs extra care, as you risk data loss if your value - * is bigger than what the chip actually supports! - * - * An example in pseudo code for a setup() callback: - * - * void get_mac_addr(struct nvmem_device *nvmem, void *context) - * { - * u8 *mac_addr = ethernet_pdata->mac_addr; - * off_t offset = context; - * - * // Read MAC addr from EEPROM - * if (nvmem_device_read(nvmem, offset, ETH_ALEN, mac_addr) == ETH_ALEN) - * pr_info("Read MAC addr from EEPROM: %pM\n", mac_addr); - * } - * - * This function pointer and context can now be set up in at24_platform_data. - */ - -struct at24_platform_data { - u32 byte_len; /* size (sum of all addr) */ - u16 page_size; /* for writes */ - u8 flags; -#define AT24_FLAG_ADDR16 BIT(7) /* address pointer is 16 bit */ -#define AT24_FLAG_READONLY BIT(6) /* sysfs-entry will be read-only */ -#define AT24_FLAG_IRUGO BIT(5) /* sysfs-entry will be world-readable */ -#define AT24_FLAG_TAKE8ADDR BIT(4) /* take always 8 addresses (24c00) */ -#define AT24_FLAG_SERIAL BIT(3) /* factory-programmed serial number */ -#define AT24_FLAG_MAC BIT(2) /* factory-programmed mac address */ -#define AT24_FLAG_NO_RDROL BIT(1) /* does not auto-rollover reads to */ - /* the next slave address */ - - void (*setup)(struct nvmem_device *nvmem, void *context); - void *context; -}; - -#endif /* _LINUX_AT24_H */