blob: f871439d499db82ae5066db731e96aad7659de74 [file] [log] [blame]
Wolfram Sang2b7a5052008-07-14 22:38:35 +02001/*
2 * at24.c - handle most I2C EEPROMs
3 *
4 * Copyright (C) 2005-2007 David Brownell
5 * Copyright (C) 2008 Wolfram Sang, Pengutronix
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 */
12#include <linux/kernel.h>
13#include <linux/init.h>
14#include <linux/module.h>
Javier Martinez Canillas7f2a2f02017-10-01 12:49:48 +020015#include <linux/of_device.h>
Wolfram Sang2b7a5052008-07-14 22:38:35 +020016#include <linux/slab.h>
17#include <linux/delay.h>
18#include <linux/mutex.h>
Wolfram Sang2b7a5052008-07-14 22:38:35 +020019#include <linux/mod_devicetable.h>
20#include <linux/log2.h>
21#include <linux/bitops.h>
22#include <linux/jiffies.h>
Ben Gardnerdd905a62017-02-09 11:36:08 -060023#include <linux/property.h>
Andy Shevchenko40d8edc2015-10-23 12:16:44 +030024#include <linux/acpi.h>
Wolfram Sang2b7a5052008-07-14 22:38:35 +020025#include <linux/i2c.h>
Andrew Lunn57d15552016-02-26 20:59:20 +010026#include <linux/nvmem-provider.h>
Heiner Kallweit5c015252017-11-28 21:51:40 +010027#include <linux/regmap.h>
Vivien Didelot25f73ed2013-09-27 15:06:28 -040028#include <linux/platform_data/at24.h>
Divagar Mohandass98e82012017-10-10 11:30:37 +053029#include <linux/pm_runtime.h>
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +010030#include <linux/gpio/consumer.h>
Wolfram Sang2b7a5052008-07-14 22:38:35 +020031
32/*
33 * I2C EEPROMs from most vendors are inexpensive and mostly interchangeable.
34 * Differences between different vendor product lines (like Atmel AT24C or
35 * MicroChip 24LC, etc) won't much matter for typical read/write access.
36 * There are also I2C RAM chips, likewise interchangeable. One example
37 * would be the PCF8570, which acts like a 24c02 EEPROM (256 bytes).
38 *
39 * However, misconfiguration can lose data. "Set 16-bit memory address"
40 * to a part with 8-bit addressing will overwrite data. Writing with too
41 * big a page size also loses data. And it's not safe to assume that the
42 * conventional addresses 0x50..0x57 only hold eeproms; a PCF8563 RTC
43 * uses 0x51, for just one example.
44 *
45 * Accordingly, explicit board-specific configuration data should be used
46 * in almost all cases. (One partial exception is an SMBus used to access
47 * "SPD" data for DRAM sticks. Those only use 24c02 EEPROMs.)
48 *
49 * So this driver uses "new style" I2C driver binding, expecting to be
50 * told what devices exist. That may be in arch/X/mach-Y/board-Z.c or
51 * similar kernel-resident tables; or, configuration data coming from
52 * a bootloader.
53 *
54 * Other than binding model, current differences from "eeprom" driver are
55 * that this one handles write access and isn't restricted to 24c02 devices.
56 * It also handles larger devices (32 kbit and up) with two-byte addresses,
57 * which won't work on pure SMBus systems.
58 */
59
Heiner Kallweit5c015252017-11-28 21:51:40 +010060struct at24_client {
61 struct i2c_client *client;
62 struct regmap *regmap;
63};
64
Wolfram Sang2b7a5052008-07-14 22:38:35 +020065struct at24_data {
Wolfram Sang2b7a5052008-07-14 22:38:35 +020066 /*
67 * Lock protects against activities from other Linux tasks,
68 * but not from changes by other I2C masters.
69 */
70 struct mutex lock;
Wolfram Sang2b7a5052008-07-14 22:38:35 +020071
Bartosz Golaszewskiaa4ce222017-12-13 11:56:23 +010072 unsigned int write_max;
73 unsigned int num_addresses;
Heiner Kallweit4bb5c13c2017-11-28 21:51:50 +010074 unsigned int offset_adj;
Wolfram Sang2b7a5052008-07-14 22:38:35 +020075
Bartosz Golaszewski7c280662018-03-19 10:17:17 +010076 u32 byte_len;
77 u16 page_size;
78 u8 flags;
79
Andrew Lunn57d15552016-02-26 20:59:20 +010080 struct nvmem_device *nvmem;
81
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +010082 struct gpio_desc *wp_gpio;
83
Wolfram Sang2b7a5052008-07-14 22:38:35 +020084 /*
85 * Some chips tie up multiple I2C addresses; dummy devices reserve
86 * them for us, and we'll use them with SMBus calls.
87 */
Heiner Kallweit5c015252017-11-28 21:51:40 +010088 struct at24_client client[];
Wolfram Sang2b7a5052008-07-14 22:38:35 +020089};
90
91/*
92 * This parameter is to help this driver avoid blocking other drivers out
93 * of I2C for potentially troublesome amounts of time. With a 100 kHz I2C
94 * clock, one 256 byte read takes about 1/43 second which is excessive;
95 * but the 1/170 second it takes at 400 kHz may be quite reasonable; and
96 * at 1 MHz (Fm+) a 1/430 second delay could easily be invisible.
97 *
98 * This value is forced to be a power of two so that writes align on pages.
99 */
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100100static unsigned int at24_io_limit = 128;
101module_param_named(io_limit, at24_io_limit, uint, 0);
102MODULE_PARM_DESC(at24_io_limit, "Maximum bytes per I/O (default 128)");
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200103
104/*
105 * Specs often allow 5 msec for a page write, sometimes 20 msec;
106 * it's important to recover from write timeouts.
107 */
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100108static unsigned int at24_write_timeout = 25;
109module_param_named(write_timeout, at24_write_timeout, uint, 0);
110MODULE_PARM_DESC(at24_write_timeout, "Time (in ms) to try writes (default 25)");
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200111
Bartosz Golaszewski9344a812016-06-06 10:48:47 +0200112/*
113 * Both reads and writes fail if the previous write didn't complete yet. This
114 * macro loops a few times waiting at least long enough for one entire page
Bartosz Golaszewski24da3cc2016-07-17 20:40:06 +0200115 * write to work while making sure that at least one iteration is run before
116 * checking the break condition.
Bartosz Golaszewski9344a812016-06-06 10:48:47 +0200117 *
118 * It takes two parameters: a variable in which the future timeout in jiffies
119 * will be stored and a temporary variable holding the time of the last
120 * iteration of processing the request. Both should be unsigned integers
121 * holding at least 32 bits.
122 */
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100123#define at24_loop_until_timeout(tout, op_time) \
124 for (tout = jiffies + msecs_to_jiffies(at24_write_timeout), \
125 op_time = 0; \
Bartosz Golaszewski24da3cc2016-07-17 20:40:06 +0200126 op_time ? time_before(op_time, tout) : true; \
Bartosz Golaszewski9344a812016-06-06 10:48:47 +0200127 usleep_range(1000, 1500), op_time = jiffies)
128
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500129struct at24_chip_data {
130 /*
131 * these fields mirror their equivalents in
132 * struct at24_platform_data
133 */
134 u32 byte_len;
135 u8 flags;
136};
137
138#define AT24_CHIP_DATA(_name, _len, _flags) \
139 static const struct at24_chip_data _name = { \
140 .byte_len = _len, .flags = _flags, \
141 }
142
143/* needs 8 addresses as A0-A2 are ignored */
144AT24_CHIP_DATA(at24_data_24c00, 128 / 8, AT24_FLAG_TAKE8ADDR);
145/* old variants can't be handled with this generic entry! */
146AT24_CHIP_DATA(at24_data_24c01, 1024 / 8, 0);
147AT24_CHIP_DATA(at24_data_24cs01, 16,
148 AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
149AT24_CHIP_DATA(at24_data_24c02, 2048 / 8, 0);
150AT24_CHIP_DATA(at24_data_24cs02, 16,
151 AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
152AT24_CHIP_DATA(at24_data_24mac402, 48 / 8,
153 AT24_FLAG_MAC | AT24_FLAG_READONLY);
154AT24_CHIP_DATA(at24_data_24mac602, 64 / 8,
155 AT24_FLAG_MAC | AT24_FLAG_READONLY);
156/* spd is a 24c02 in memory DIMMs */
157AT24_CHIP_DATA(at24_data_spd, 2048 / 8,
158 AT24_FLAG_READONLY | AT24_FLAG_IRUGO);
159AT24_CHIP_DATA(at24_data_24c04, 4096 / 8, 0);
160AT24_CHIP_DATA(at24_data_24cs04, 16,
161 AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
162/* 24rf08 quirk is handled at i2c-core */
163AT24_CHIP_DATA(at24_data_24c08, 8192 / 8, 0);
164AT24_CHIP_DATA(at24_data_24cs08, 16,
165 AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
166AT24_CHIP_DATA(at24_data_24c16, 16384 / 8, 0);
167AT24_CHIP_DATA(at24_data_24cs16, 16,
168 AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
169AT24_CHIP_DATA(at24_data_24c32, 32768 / 8, AT24_FLAG_ADDR16);
170AT24_CHIP_DATA(at24_data_24cs32, 16,
171 AT24_FLAG_ADDR16 | AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
172AT24_CHIP_DATA(at24_data_24c64, 65536 / 8, AT24_FLAG_ADDR16);
173AT24_CHIP_DATA(at24_data_24cs64, 16,
174 AT24_FLAG_ADDR16 | AT24_FLAG_SERIAL | AT24_FLAG_READONLY);
175AT24_CHIP_DATA(at24_data_24c128, 131072 / 8, AT24_FLAG_ADDR16);
176AT24_CHIP_DATA(at24_data_24c256, 262144 / 8, AT24_FLAG_ADDR16);
177AT24_CHIP_DATA(at24_data_24c512, 524288 / 8, AT24_FLAG_ADDR16);
178AT24_CHIP_DATA(at24_data_24c1024, 1048576 / 8, AT24_FLAG_ADDR16);
179/* identical to 24c08 ? */
180AT24_CHIP_DATA(at24_data_INT3499, 8192 / 8, 0);
181
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200182static const struct i2c_device_id at24_ids[] = {
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500183 { "24c00", (kernel_ulong_t)&at24_data_24c00 },
184 { "24c01", (kernel_ulong_t)&at24_data_24c01 },
185 { "24cs01", (kernel_ulong_t)&at24_data_24cs01 },
186 { "24c02", (kernel_ulong_t)&at24_data_24c02 },
187 { "24cs02", (kernel_ulong_t)&at24_data_24cs02 },
188 { "24mac402", (kernel_ulong_t)&at24_data_24mac402 },
189 { "24mac602", (kernel_ulong_t)&at24_data_24mac602 },
190 { "spd", (kernel_ulong_t)&at24_data_spd },
191 { "24c04", (kernel_ulong_t)&at24_data_24c04 },
192 { "24cs04", (kernel_ulong_t)&at24_data_24cs04 },
193 { "24c08", (kernel_ulong_t)&at24_data_24c08 },
194 { "24cs08", (kernel_ulong_t)&at24_data_24cs08 },
195 { "24c16", (kernel_ulong_t)&at24_data_24c16 },
196 { "24cs16", (kernel_ulong_t)&at24_data_24cs16 },
197 { "24c32", (kernel_ulong_t)&at24_data_24c32 },
198 { "24cs32", (kernel_ulong_t)&at24_data_24cs32 },
199 { "24c64", (kernel_ulong_t)&at24_data_24c64 },
200 { "24cs64", (kernel_ulong_t)&at24_data_24cs64 },
201 { "24c128", (kernel_ulong_t)&at24_data_24c128 },
202 { "24c256", (kernel_ulong_t)&at24_data_24c256 },
203 { "24c512", (kernel_ulong_t)&at24_data_24c512 },
204 { "24c1024", (kernel_ulong_t)&at24_data_24c1024 },
205 { "at24", 0 },
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200206 { /* END OF LIST */ }
207};
208MODULE_DEVICE_TABLE(i2c, at24_ids);
209
Javier Martinez Canillas7f2a2f02017-10-01 12:49:48 +0200210static const struct of_device_id at24_of_match[] = {
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500211 { .compatible = "atmel,24c00", .data = &at24_data_24c00 },
212 { .compatible = "atmel,24c01", .data = &at24_data_24c01 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100213 { .compatible = "atmel,24cs01", .data = &at24_data_24cs01 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500214 { .compatible = "atmel,24c02", .data = &at24_data_24c02 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100215 { .compatible = "atmel,24cs02", .data = &at24_data_24cs02 },
216 { .compatible = "atmel,24mac402", .data = &at24_data_24mac402 },
217 { .compatible = "atmel,24mac602", .data = &at24_data_24mac602 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500218 { .compatible = "atmel,spd", .data = &at24_data_spd },
219 { .compatible = "atmel,24c04", .data = &at24_data_24c04 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100220 { .compatible = "atmel,24cs04", .data = &at24_data_24cs04 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500221 { .compatible = "atmel,24c08", .data = &at24_data_24c08 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100222 { .compatible = "atmel,24cs08", .data = &at24_data_24cs08 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500223 { .compatible = "atmel,24c16", .data = &at24_data_24c16 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100224 { .compatible = "atmel,24cs16", .data = &at24_data_24cs16 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500225 { .compatible = "atmel,24c32", .data = &at24_data_24c32 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100226 { .compatible = "atmel,24cs32", .data = &at24_data_24cs32 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500227 { .compatible = "atmel,24c64", .data = &at24_data_24c64 },
Bartosz Golaszewski0f30aca2017-12-28 11:49:13 +0100228 { .compatible = "atmel,24cs64", .data = &at24_data_24cs64 },
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500229 { .compatible = "atmel,24c128", .data = &at24_data_24c128 },
230 { .compatible = "atmel,24c256", .data = &at24_data_24c256 },
231 { .compatible = "atmel,24c512", .data = &at24_data_24c512 },
232 { .compatible = "atmel,24c1024", .data = &at24_data_24c1024 },
233 { /* END OF LIST */ },
Javier Martinez Canillas7f2a2f02017-10-01 12:49:48 +0200234};
235MODULE_DEVICE_TABLE(of, at24_of_match);
236
Andy Shevchenko40d8edc2015-10-23 12:16:44 +0300237static const struct acpi_device_id at24_acpi_ids[] = {
Sven Van Asbroeckb680f4f2017-12-20 11:48:56 -0500238 { "INT3499", (kernel_ulong_t)&at24_data_INT3499 },
239 { /* END OF LIST */ }
Andy Shevchenko40d8edc2015-10-23 12:16:44 +0300240};
241MODULE_DEVICE_TABLE(acpi, at24_acpi_ids);
242
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200243/*
244 * This routine supports chips which consume multiple I2C addresses. It
245 * computes the addressing information to be used for a given r/w request.
246 * Assumes that sanity checks for offset happened at sysfs-layer.
Bartosz Golaszewski9afd68662016-06-06 10:48:48 +0200247 *
248 * Slave address and byte offset derive from the offset. Always
249 * set the byte address; on a multi-master board, another master
250 * may have changed the chip's "current" address pointer.
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200251 */
Heiner Kallweit46049482017-11-28 21:51:42 +0100252static struct at24_client *at24_translate_offset(struct at24_data *at24,
253 unsigned int *offset)
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200254{
Bartosz Golaszewskiaa4ce222017-12-13 11:56:23 +0100255 unsigned int i;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200256
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100257 if (at24->flags & AT24_FLAG_ADDR16) {
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200258 i = *offset >> 16;
259 *offset &= 0xffff;
260 } else {
261 i = *offset >> 8;
262 *offset &= 0xff;
263 }
264
Heiner Kallweit46049482017-11-28 21:51:42 +0100265 return &at24->client[i];
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200266}
267
Bartosz Golaszewskif1a640c2018-03-19 10:17:14 +0100268static struct device *at24_base_client_dev(struct at24_data *at24)
269{
270 return &at24->client[0].client->dev;
271}
272
Sven Van Asbroecke32213f2017-12-08 11:28:30 -0500273static size_t at24_adjust_read_count(struct at24_data *at24,
274 unsigned int offset, size_t count)
275{
276 unsigned int bits;
277 size_t remainder;
278
279 /*
280 * In case of multi-address chips that don't rollover reads to
281 * the next slave address: truncate the count to the slave boundary,
282 * so that the read never straddles slaves.
283 */
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100284 if (at24->flags & AT24_FLAG_NO_RDROL) {
285 bits = (at24->flags & AT24_FLAG_ADDR16) ? 16 : 8;
Sven Van Asbroecke32213f2017-12-08 11:28:30 -0500286 remainder = BIT(bits) - offset;
287 if (count > remainder)
288 count = remainder;
289 }
290
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100291 if (count > at24_io_limit)
292 count = at24_io_limit;
Sven Van Asbroecke32213f2017-12-08 11:28:30 -0500293
294 return count;
295}
296
Heiner Kallweit4bb5c13c2017-11-28 21:51:50 +0100297static ssize_t at24_regmap_read(struct at24_data *at24, char *buf,
298 unsigned int offset, size_t count)
299{
300 unsigned long timeout, read_time;
301 struct at24_client *at24_client;
302 struct i2c_client *client;
303 struct regmap *regmap;
304 int ret;
305
306 at24_client = at24_translate_offset(at24, &offset);
307 regmap = at24_client->regmap;
308 client = at24_client->client;
Sven Van Asbroecke32213f2017-12-08 11:28:30 -0500309 count = at24_adjust_read_count(at24, offset, count);
Heiner Kallweit4bb5c13c2017-11-28 21:51:50 +0100310
311 /* adjust offset for mac and serial read ops */
312 offset += at24->offset_adj;
313
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100314 at24_loop_until_timeout(timeout, read_time) {
Heiner Kallweit4bb5c13c2017-11-28 21:51:50 +0100315 ret = regmap_bulk_read(regmap, offset, buf, count);
316 dev_dbg(&client->dev, "read %zu@%d --> %d (%ld)\n",
317 count, offset, ret, jiffies);
318 if (!ret)
319 return count;
320 }
321
322 return -ETIMEDOUT;
323}
324
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200325/*
326 * Note that if the hardware write-protect pin is pulled high, the whole
327 * chip is normally write protected. But there are plenty of product
328 * variants here, including OTP fuses and partial chip protect.
329 *
Bartosz Golaszewskicd0c8612016-06-06 10:48:49 +0200330 * We only use page mode writes; the alternative is sloooow. These routines
331 * write at most one page.
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200332 */
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200333
Bartosz Golaszewskicd0c8612016-06-06 10:48:49 +0200334static size_t at24_adjust_write_count(struct at24_data *at24,
335 unsigned int offset, size_t count)
336{
Bartosz Golaszewskiaa4ce222017-12-13 11:56:23 +0100337 unsigned int next_page;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200338
339 /* write_max is at most a page */
340 if (count > at24->write_max)
341 count = at24->write_max;
342
343 /* Never roll over backwards, to the start of this page */
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100344 next_page = roundup(offset + 1, at24->page_size);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200345 if (offset + count > next_page)
346 count = next_page - offset;
347
Bartosz Golaszewskicd0c8612016-06-06 10:48:49 +0200348 return count;
349}
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200350
Heiner Kallweit8e5888e2017-11-28 21:51:45 +0100351static ssize_t at24_regmap_write(struct at24_data *at24, const char *buf,
352 unsigned int offset, size_t count)
353{
354 unsigned long timeout, write_time;
355 struct at24_client *at24_client;
356 struct i2c_client *client;
357 struct regmap *regmap;
358 int ret;
359
360 at24_client = at24_translate_offset(at24, &offset);
361 regmap = at24_client->regmap;
362 client = at24_client->client;
363 count = at24_adjust_write_count(at24, offset, count);
364
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100365 at24_loop_until_timeout(timeout, write_time) {
Heiner Kallweit8e5888e2017-11-28 21:51:45 +0100366 ret = regmap_bulk_write(regmap, offset, buf, count);
367 dev_dbg(&client->dev, "write %zu@%d --> %d (%ld)\n",
368 count, offset, ret, jiffies);
369 if (!ret)
370 return count;
371 }
372
373 return -ETIMEDOUT;
374}
375
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200376static int at24_read(void *priv, unsigned int off, void *val, size_t count)
377{
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100378 struct at24_data *at24;
379 struct device *dev;
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200380 char *buf = val;
Divagar Mohandass98e82012017-10-10 11:30:37 +0530381 int ret;
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200382
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100383 at24 = priv;
Bartosz Golaszewskif1a640c2018-03-19 10:17:14 +0100384 dev = at24_base_client_dev(at24);
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100385
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200386 if (unlikely(!count))
387 return count;
388
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100389 if (off + count > at24->byte_len)
Heiner Kallweitd9bcd462017-11-24 07:47:50 +0100390 return -EINVAL;
391
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500392 ret = pm_runtime_get_sync(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530393 if (ret < 0) {
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500394 pm_runtime_put_noidle(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530395 return ret;
396 }
397
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200398 /*
399 * Read data from chip, protecting against concurrent updates
400 * from this host, but not from other I2C masters.
401 */
402 mutex_lock(&at24->lock);
403
404 while (count) {
Bartosz Golaszewskieb27fde2018-03-19 10:17:06 +0100405 ret = at24_regmap_read(at24, buf, off, count);
406 if (ret < 0) {
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200407 mutex_unlock(&at24->lock);
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500408 pm_runtime_put(dev);
Bartosz Golaszewskieb27fde2018-03-19 10:17:06 +0100409 return ret;
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200410 }
Bartosz Golaszewskieb27fde2018-03-19 10:17:06 +0100411 buf += ret;
412 off += ret;
413 count -= ret;
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200414 }
415
416 mutex_unlock(&at24->lock);
417
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500418 pm_runtime_put(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530419
Bartosz Golaszewskid5bc0042016-06-06 10:48:44 +0200420 return 0;
421}
422
Srinivas Kandagatlacf0361a2016-04-24 20:28:06 +0100423static int at24_write(void *priv, unsigned int off, void *val, size_t count)
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200424{
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100425 struct at24_data *at24;
426 struct device *dev;
Srinivas Kandagatlacf0361a2016-04-24 20:28:06 +0100427 char *buf = val;
Divagar Mohandass98e82012017-10-10 11:30:37 +0530428 int ret;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200429
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100430 at24 = priv;
Bartosz Golaszewskif1a640c2018-03-19 10:17:14 +0100431 dev = at24_base_client_dev(at24);
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100432
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200433 if (unlikely(!count))
Srinivas Kandagatlacf0361a2016-04-24 20:28:06 +0100434 return -EINVAL;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200435
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100436 if (off + count > at24->byte_len)
Heiner Kallweitd9bcd462017-11-24 07:47:50 +0100437 return -EINVAL;
438
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500439 ret = pm_runtime_get_sync(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530440 if (ret < 0) {
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500441 pm_runtime_put_noidle(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530442 return ret;
443 }
444
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200445 /*
446 * Write data to chip, protecting against concurrent updates
447 * from this host, but not from other I2C masters.
448 */
449 mutex_lock(&at24->lock);
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +0100450 gpiod_set_value_cansleep(at24->wp_gpio, 0);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200451
452 while (count) {
Bartosz Golaszewskic4fee332018-03-19 10:17:07 +0100453 ret = at24_regmap_write(at24, buf, off, count);
454 if (ret < 0) {
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +0100455 gpiod_set_value_cansleep(at24->wp_gpio, 1);
Srinivas Kandagatlacf0361a2016-04-24 20:28:06 +0100456 mutex_unlock(&at24->lock);
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500457 pm_runtime_put(dev);
Bartosz Golaszewskic4fee332018-03-19 10:17:07 +0100458 return ret;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200459 }
Bartosz Golaszewskic4fee332018-03-19 10:17:07 +0100460 buf += ret;
461 off += ret;
462 count -= ret;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200463 }
464
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +0100465 gpiod_set_value_cansleep(at24->wp_gpio, 1);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200466 mutex_unlock(&at24->lock);
467
Sakari Ailusf9ecc832017-12-01 13:37:12 -0500468 pm_runtime_put(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530469
Andrew Lunn57d15552016-02-26 20:59:20 +0100470 return 0;
471}
472
Bartosz Golaszewski1f77d182018-03-19 10:17:10 +0100473static void at24_properties_to_pdata(struct device *dev,
474 struct at24_platform_data *chip)
Wolfram Sang9ed030d2010-11-17 13:00:48 +0100475{
Ben Gardnerdd905a62017-02-09 11:36:08 -0600476 int err;
477 u32 val;
Wolfram Sang9ed030d2010-11-17 13:00:48 +0100478
Ben Gardnerdd905a62017-02-09 11:36:08 -0600479 if (device_property_present(dev, "read-only"))
480 chip->flags |= AT24_FLAG_READONLY;
Sven Van Asbroecke32213f2017-12-08 11:28:30 -0500481 if (device_property_present(dev, "no-read-rollover"))
482 chip->flags |= AT24_FLAG_NO_RDROL;
Ben Gardnerdd905a62017-02-09 11:36:08 -0600483
Divagar Mohandassdbc1ab92017-10-10 11:30:36 +0530484 err = device_property_read_u32(dev, "size", &val);
485 if (!err)
486 chip->byte_len = val;
487
Ben Gardnerdd905a62017-02-09 11:36:08 -0600488 err = device_property_read_u32(dev, "pagesize", &val);
489 if (!err) {
490 chip->page_size = val;
491 } else {
492 /*
493 * This is slow, but we can't know all eeproms, so we better
494 * play safe. Specifying custom eeprom-types via platform_data
495 * is recommended anyhow.
496 */
497 chip->page_size = 1;
Wolfram Sang9ed030d2010-11-17 13:00:48 +0100498 }
499}
Wolfram Sang9ed030d2010-11-17 13:00:48 +0100500
Bartosz Golaszewskifeb2f192018-03-19 10:17:16 +0100501static int at24_get_pdata(struct device *dev, struct at24_platform_data *pdata)
502{
503 struct device_node *of_node = dev->of_node;
504 const struct at24_chip_data *cdata;
505 const struct i2c_device_id *id;
506 struct at24_platform_data *pd;
507
508 pd = dev_get_platdata(dev);
509 if (pd) {
510 memcpy(pdata, pd, sizeof(*pdata));
511 return 0;
512 }
513
514 id = i2c_match_id(at24_ids, to_i2c_client(dev));
515
516 /*
517 * The I2C core allows OF nodes compatibles to match against the
518 * I2C device ID table as a fallback, so check not only if an OF
519 * node is present but also if it matches an OF device ID entry.
520 */
521 if (of_node && of_match_device(at24_of_match, dev))
522 cdata = of_device_get_match_data(dev);
523 else if (id)
524 cdata = (void *)&id->driver_data;
525 else
526 cdata = acpi_device_get_match_data(dev);
527
528 if (!cdata)
529 return -ENODEV;
530
531 pdata->byte_len = cdata->byte_len;
532 pdata->flags = cdata->flags;
533 at24_properties_to_pdata(dev, pdata);
534
535 return 0;
536}
537
Heiner Kallweit4bb5c13c2017-11-28 21:51:50 +0100538static unsigned int at24_get_offset_adj(u8 flags, unsigned int byte_len)
539{
540 if (flags & AT24_FLAG_MAC) {
541 /* EUI-48 starts from 0x9a, EUI-64 from 0x98 */
542 return 0xa0 - byte_len;
543 } else if (flags & AT24_FLAG_SERIAL && flags & AT24_FLAG_ADDR16) {
544 /*
545 * For 16 bit address pointers, the word address must contain
546 * a '10' sequence in bits 11 and 10 regardless of the
547 * intended position of the address pointer.
548 */
549 return 0x0800;
550 } else if (flags & AT24_FLAG_SERIAL) {
551 /*
552 * Otherwise the word address must begin with a '10' sequence,
553 * regardless of the intended address.
554 */
555 return 0x0080;
556 } else {
557 return 0;
558 }
559}
560
Bartosz Golaszewski48b6a7d2018-03-19 10:17:15 +0100561static int at24_probe(struct i2c_client *client)
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200562{
Bartosz Golaszewskieef69392017-12-18 18:24:43 +0100563 struct regmap_config regmap_config = { };
Bartosz Golaszewski8cdc4e72018-03-19 10:17:02 +0100564 struct nvmem_config nvmem_config = { };
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100565 struct at24_platform_data pdata = { };
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100566 struct device *dev = &client->dev;
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100567 unsigned int i, num_addresses;
568 struct at24_data *at24;
Bartosz Golaszewski551a1262018-03-19 10:17:18 +0100569 struct regmap *regmap;
Bartosz Golaszewski11288b72018-03-19 10:17:13 +0100570 size_t at24_size;
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100571 bool writable;
Bartosz Golaszewski00f0ea72016-08-12 13:32:57 +0200572 u8 test_byte;
Bartosz Golaszewski5ca2b5b2018-03-19 10:17:03 +0100573 int err;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200574
Bartosz Golaszewskifeb2f192018-03-19 10:17:16 +0100575 err = at24_get_pdata(dev, &pdata);
576 if (err)
577 return err;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200578
Bartosz Golaszewski551a1262018-03-19 10:17:18 +0100579 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C) &&
580 !i2c_check_functionality(client->adapter,
581 I2C_FUNC_SMBUS_WRITE_I2C_BLOCK))
582 pdata.page_size = 1;
583
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100584 if (!pdata.page_size) {
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100585 dev_err(dev, "page_size must not be 0!\n");
Nikolay Balandinf0ac2362013-05-28 13:00:20 -0700586 return -EINVAL;
Wolfram Sang45efe842010-11-17 13:00:49 +0100587 }
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100588 if (!is_power_of_2(pdata.page_size))
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100589 dev_warn(dev, "page_size looks suspicious (no power of 2)!\n");
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200590
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100591 if (pdata.flags & AT24_FLAG_TAKE8ADDR)
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200592 num_addresses = 8;
593 else
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100594 num_addresses = DIV_ROUND_UP(pdata.byte_len,
595 (pdata.flags & AT24_FLAG_ADDR16) ? 65536 : 256);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200596
Bartosz Golaszewski551a1262018-03-19 10:17:18 +0100597 if ((pdata.flags & AT24_FLAG_SERIAL) && (pdata.flags & AT24_FLAG_MAC)) {
598 dev_err(dev,
599 "invalid device data - cannot have both AT24_FLAG_SERIAL & AT24_FLAG_MAC.");
600 return -EINVAL;
601 }
602
Bartosz Golaszewskieef69392017-12-18 18:24:43 +0100603 regmap_config.val_bits = 8;
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100604 regmap_config.reg_bits = (pdata.flags & AT24_FLAG_ADDR16) ? 16 : 8;
Bartosz Golaszewskid1543162018-03-19 10:17:01 +0100605 regmap_config.disable_locking = true;
Heiner Kallweit5c015252017-11-28 21:51:40 +0100606
Bartosz Golaszewski551a1262018-03-19 10:17:18 +0100607 regmap = devm_regmap_init_i2c(client, &regmap_config);
608 if (IS_ERR(regmap))
609 return PTR_ERR(regmap);
610
Bartosz Golaszewski11288b72018-03-19 10:17:13 +0100611 at24_size = sizeof(*at24) + num_addresses * sizeof(struct at24_client);
612 at24 = devm_kzalloc(dev, at24_size, GFP_KERNEL);
Nikolay Balandinf0ac2362013-05-28 13:00:20 -0700613 if (!at24)
614 return -ENOMEM;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200615
616 mutex_init(&at24->lock);
Bartosz Golaszewski7c280662018-03-19 10:17:17 +0100617 at24->byte_len = pdata.byte_len;
618 at24->page_size = pdata.page_size;
619 at24->flags = pdata.flags;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200620 at24->num_addresses = num_addresses;
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100621 at24->offset_adj = at24_get_offset_adj(pdata.flags, pdata.byte_len);
Bartosz Golaszewski551a1262018-03-19 10:17:18 +0100622 at24->client[0].client = client;
623 at24->client[0].regmap = regmap;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200624
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100625 at24->wp_gpio = devm_gpiod_get_optional(dev, "wp", GPIOD_OUT_HIGH);
Bartosz Golaszewski6ce261e2017-12-19 11:28:54 +0100626 if (IS_ERR(at24->wp_gpio))
627 return PTR_ERR(at24->wp_gpio);
628
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100629 writable = !(pdata.flags & AT24_FLAG_READONLY);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200630 if (writable) {
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100631 at24->write_max = min_t(unsigned int,
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100632 pdata.page_size, at24_io_limit);
Heiner Kallweita23727c2017-11-28 21:51:54 +0100633 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C) &&
634 at24->write_max > I2C_SMBUS_BLOCK_MAX)
635 at24->write_max = I2C_SMBUS_BLOCK_MAX;
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200636 }
637
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200638 /* use dummy devices for multiple-address chips */
639 for (i = 1; i < num_addresses; i++) {
Heiner Kallweit5c015252017-11-28 21:51:40 +0100640 at24->client[i].client = i2c_new_dummy(client->adapter,
641 client->addr + i);
642 if (!at24->client[i].client) {
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100643 dev_err(dev, "address 0x%02x unavailable\n",
644 client->addr + i);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200645 err = -EADDRINUSE;
646 goto err_clients;
647 }
Heiner Kallweit5c015252017-11-28 21:51:40 +0100648 at24->client[i].regmap = devm_regmap_init_i2c(
Bartosz Golaszewskieef69392017-12-18 18:24:43 +0100649 at24->client[i].client,
650 &regmap_config);
Heiner Kallweit5c015252017-11-28 21:51:40 +0100651 if (IS_ERR(at24->client[i].regmap)) {
652 err = PTR_ERR(at24->client[i].regmap);
653 goto err_clients;
654 }
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200655 }
656
Bartosz Golaszewski00f0ea72016-08-12 13:32:57 +0200657 i2c_set_clientdata(client, at24);
658
Divagar Mohandass98e82012017-10-10 11:30:37 +0530659 /* enable runtime pm */
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100660 pm_runtime_set_active(dev);
661 pm_runtime_enable(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530662
Bartosz Golaszewski00f0ea72016-08-12 13:32:57 +0200663 /*
664 * Perform a one-byte test read to verify that the
665 * chip is functional.
666 */
667 err = at24_read(at24, 0, &test_byte, 1);
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100668 pm_runtime_idle(dev);
Bartosz Golaszewski00f0ea72016-08-12 13:32:57 +0200669 if (err) {
670 err = -ENODEV;
671 goto err_clients;
672 }
673
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100674 nvmem_config.name = dev_name(dev);
675 nvmem_config.dev = dev;
Bartosz Golaszewski8cdc4e72018-03-19 10:17:02 +0100676 nvmem_config.read_only = !writable;
677 nvmem_config.root_only = true;
678 nvmem_config.owner = THIS_MODULE;
679 nvmem_config.compat = true;
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100680 nvmem_config.base_dev = dev;
Bartosz Golaszewski8cdc4e72018-03-19 10:17:02 +0100681 nvmem_config.reg_read = at24_read;
682 nvmem_config.reg_write = at24_write;
683 nvmem_config.priv = at24;
684 nvmem_config.stride = 1;
685 nvmem_config.word_size = 1;
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100686 nvmem_config.size = pdata.byte_len;
Andrew Lunn57d15552016-02-26 20:59:20 +0100687
Bartosz Golaszewski8cdc4e72018-03-19 10:17:02 +0100688 at24->nvmem = nvmem_register(&nvmem_config);
Andrew Lunn57d15552016-02-26 20:59:20 +0100689
690 if (IS_ERR(at24->nvmem)) {
691 err = PTR_ERR(at24->nvmem);
692 goto err_clients;
693 }
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200694
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100695 dev_info(dev, "%u byte %s EEPROM, %s, %u bytes/write\n",
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100696 pdata.byte_len, client->name,
Wolfram Sang9ed030d2010-11-17 13:00:48 +0100697 writable ? "writable" : "read-only", at24->write_max);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200698
Kevin Hilman7274ec82009-04-02 16:56:57 -0700699 /* export data to kernel code */
Bartosz Golaszewskif2adff62018-03-19 10:17:11 +0100700 if (pdata.setup)
701 pdata.setup(at24->nvmem, pdata.context);
Kevin Hilman7274ec82009-04-02 16:56:57 -0700702
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200703 return 0;
704
705err_clients:
706 for (i = 1; i < num_addresses; i++)
Heiner Kallweit5c015252017-11-28 21:51:40 +0100707 if (at24->client[i].client)
708 i2c_unregister_device(at24->client[i].client);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200709
Bartosz Golaszewski021c7d72018-03-19 10:17:12 +0100710 pm_runtime_disable(dev);
Divagar Mohandass98e82012017-10-10 11:30:37 +0530711
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200712 return err;
713}
714
Bill Pemberton486a5c22012-11-19 13:26:02 -0500715static int at24_remove(struct i2c_client *client)
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200716{
717 struct at24_data *at24;
718 int i;
719
720 at24 = i2c_get_clientdata(client);
Andrew Lunn57d15552016-02-26 20:59:20 +0100721
722 nvmem_unregister(at24->nvmem);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200723
724 for (i = 1; i < at24->num_addresses; i++)
Heiner Kallweit5c015252017-11-28 21:51:40 +0100725 i2c_unregister_device(at24->client[i].client);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200726
Divagar Mohandass98e82012017-10-10 11:30:37 +0530727 pm_runtime_disable(&client->dev);
728 pm_runtime_set_suspended(&client->dev);
729
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200730 return 0;
731}
732
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200733static struct i2c_driver at24_driver = {
734 .driver = {
735 .name = "at24",
Javier Martinez Canillas7f2a2f02017-10-01 12:49:48 +0200736 .of_match_table = at24_of_match,
Andy Shevchenko40d8edc2015-10-23 12:16:44 +0300737 .acpi_match_table = ACPI_PTR(at24_acpi_ids),
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200738 },
Bartosz Golaszewski48b6a7d2018-03-19 10:17:15 +0100739 .probe_new = at24_probe,
Bill Pemberton2d6bed92012-11-19 13:21:23 -0500740 .remove = at24_remove,
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200741 .id_table = at24_ids,
742};
743
744static int __init at24_init(void)
745{
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100746 if (!at24_io_limit) {
747 pr_err("at24: at24_io_limit must not be 0!\n");
Wolfram Sang45efe842010-11-17 13:00:49 +0100748 return -EINVAL;
749 }
750
Bartosz Golaszewskiec3c2d52017-12-18 18:16:46 +0100751 at24_io_limit = rounddown_pow_of_two(at24_io_limit);
Wolfram Sang2b7a5052008-07-14 22:38:35 +0200752 return i2c_add_driver(&at24_driver);
753}
754module_init(at24_init);
755
756static void __exit at24_exit(void)
757{
758 i2c_del_driver(&at24_driver);
759}
760module_exit(at24_exit);
761
762MODULE_DESCRIPTION("Driver for most I2C EEPROMs");
763MODULE_AUTHOR("David Brownell and Wolfram Sang");
764MODULE_LICENSE("GPL");