bnx2x: Prevent NULL pointer dereference in kdump
[linux-2.6-block.git] / drivers / rtc / rtc-ds1307.c
CommitLineData
1abb0dc9
DB
1/*
2 * rtc-ds1307.c - RTC driver for some mostly-compatible I2C chips.
3 *
4 * Copyright (C) 2005 James Chapman (ds1337 core)
5 * Copyright (C) 2006 David Brownell
a2166858 6 * Copyright (C) 2009 Matthias Fuchs (rx8025 support)
1abb0dc9
DB
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
11 */
12
13#include <linux/module.h>
14#include <linux/init.h>
15#include <linux/slab.h>
16#include <linux/i2c.h>
17#include <linux/string.h>
18#include <linux/rtc.h>
19#include <linux/bcd.h>
eb86c306 20#include <linux/rtc/ds1307.h>
1abb0dc9 21
40ce972d
DA
22/*
23 * We can't determine type by probing, but if we expect pre-Linux code
1abb0dc9
DB
24 * to have set the chip up as a clock (turning on the oscillator and
25 * setting the date and time), Linux can ignore the non-clock features.
26 * That's a natural job for a factory or repair bench.
1abb0dc9
DB
27 */
28enum ds_type {
045e0e85
DB
29 ds_1307,
30 ds_1337,
31 ds_1338,
32 ds_1339,
33 ds_1340,
33df2ee1 34 ds_1388,
97f902b7 35 ds_3231,
045e0e85 36 m41t00,
43fcb815 37 mcp7941x,
a2166858 38 rx_8025,
32d322bc 39 last_ds_type /* always last */
40ce972d 40 /* rs5c372 too? different address... */
1abb0dc9
DB
41};
42
1abb0dc9
DB
43
44/* RTC registers don't differ much, except for the century flag */
45#define DS1307_REG_SECS 0x00 /* 00-59 */
46# define DS1307_BIT_CH 0x80
be5f59f4 47# define DS1340_BIT_nEOSC 0x80
43fcb815 48# define MCP7941X_BIT_ST 0x80
1abb0dc9
DB
49#define DS1307_REG_MIN 0x01 /* 00-59 */
50#define DS1307_REG_HOUR 0x02 /* 00-23, or 1-12{am,pm} */
c065f35c
DB
51# define DS1307_BIT_12HR 0x40 /* in REG_HOUR */
52# define DS1307_BIT_PM 0x20 /* in REG_HOUR */
1abb0dc9
DB
53# define DS1340_BIT_CENTURY_EN 0x80 /* in REG_HOUR */
54# define DS1340_BIT_CENTURY 0x40 /* in REG_HOUR */
55#define DS1307_REG_WDAY 0x03 /* 01-07 */
43fcb815 56# define MCP7941X_BIT_VBATEN 0x08
1abb0dc9
DB
57#define DS1307_REG_MDAY 0x04 /* 01-31 */
58#define DS1307_REG_MONTH 0x05 /* 01-12 */
59# define DS1337_BIT_CENTURY 0x80 /* in REG_MONTH */
60#define DS1307_REG_YEAR 0x06 /* 00-99 */
61
40ce972d
DA
62/*
63 * Other registers (control, status, alarms, trickle charge, NVRAM, etc)
045e0e85
DB
64 * start at 7, and they differ a LOT. Only control and status matter for
65 * basic RTC date and time functionality; be careful using them.
1abb0dc9 66 */
045e0e85 67#define DS1307_REG_CONTROL 0x07 /* or ds1338 */
1abb0dc9 68# define DS1307_BIT_OUT 0x80
be5f59f4 69# define DS1338_BIT_OSF 0x20
1abb0dc9
DB
70# define DS1307_BIT_SQWE 0x10
71# define DS1307_BIT_RS1 0x02
72# define DS1307_BIT_RS0 0x01
73#define DS1337_REG_CONTROL 0x0e
74# define DS1337_BIT_nEOSC 0x80
cb49a5e9 75# define DS1339_BIT_BBSQI 0x20
97f902b7 76# define DS3231_BIT_BBSQW 0x40 /* same as BBSQI */
1abb0dc9
DB
77# define DS1337_BIT_RS2 0x10
78# define DS1337_BIT_RS1 0x08
79# define DS1337_BIT_INTCN 0x04
80# define DS1337_BIT_A2IE 0x02
81# define DS1337_BIT_A1IE 0x01
045e0e85
DB
82#define DS1340_REG_CONTROL 0x07
83# define DS1340_BIT_OUT 0x80
84# define DS1340_BIT_FT 0x40
85# define DS1340_BIT_CALIB_SIGN 0x20
86# define DS1340_M_CALIBRATION 0x1f
be5f59f4
RG
87#define DS1340_REG_FLAG 0x09
88# define DS1340_BIT_OSF 0x80
1abb0dc9
DB
89#define DS1337_REG_STATUS 0x0f
90# define DS1337_BIT_OSF 0x80
91# define DS1337_BIT_A2I 0x02
92# define DS1337_BIT_A1I 0x01
cb49a5e9 93#define DS1339_REG_ALARM1_SECS 0x07
eb86c306
WS
94
95#define DS13XX_TRICKLE_CHARGER_MAGIC 0xa0
1abb0dc9 96
a2166858
MF
97#define RX8025_REG_CTRL1 0x0e
98# define RX8025_BIT_2412 0x20
99#define RX8025_REG_CTRL2 0x0f
100# define RX8025_BIT_PON 0x10
101# define RX8025_BIT_VDET 0x40
102# define RX8025_BIT_XST 0x20
1abb0dc9
DB
103
104
105struct ds1307 {
33df2ee1 106 u8 offset; /* register's offset */
cb49a5e9 107 u8 regs[11];
9eab0a78
AB
108 u16 nvram_offset;
109 struct bin_attribute *nvram;
1abb0dc9 110 enum ds_type type;
cb49a5e9
RG
111 unsigned long flags;
112#define HAS_NVRAM 0 /* bit 0 == sysfs file active */
113#define HAS_ALARM 1 /* bit 1 == irq claimed */
045e0e85 114 struct i2c_client *client;
1abb0dc9 115 struct rtc_device *rtc;
cb49a5e9 116 struct work_struct work;
0cc43a18 117 s32 (*read_block_data)(const struct i2c_client *client, u8 command,
30e7b039 118 u8 length, u8 *values);
0cc43a18 119 s32 (*write_block_data)(const struct i2c_client *client, u8 command,
30e7b039 120 u8 length, const u8 *values);
1abb0dc9
DB
121};
122
045e0e85 123struct chip_desc {
045e0e85 124 unsigned alarm:1;
9eab0a78
AB
125 u16 nvram_offset;
126 u16 nvram_size;
eb86c306 127 u16 trickle_charger_reg;
045e0e85
DB
128};
129
32d322bc
WS
130static const struct chip_desc chips[last_ds_type] = {
131 [ds_1307] = {
9eab0a78
AB
132 .nvram_offset = 8,
133 .nvram_size = 56,
32d322bc
WS
134 },
135 [ds_1337] = {
136 .alarm = 1,
137 },
138 [ds_1338] = {
9eab0a78
AB
139 .nvram_offset = 8,
140 .nvram_size = 56,
32d322bc
WS
141 },
142 [ds_1339] = {
143 .alarm = 1,
eb86c306
WS
144 .trickle_charger_reg = 0x10,
145 },
146 [ds_1340] = {
147 .trickle_charger_reg = 0x08,
148 },
149 [ds_1388] = {
150 .trickle_charger_reg = 0x0a,
32d322bc
WS
151 },
152 [ds_3231] = {
153 .alarm = 1,
154 },
9eab0a78
AB
155 [mcp7941x] = {
156 /* this is battery backed SRAM */
157 .nvram_offset = 0x20,
158 .nvram_size = 0x40,
159 },
32d322bc 160};
045e0e85 161
3760f736
JD
162static const struct i2c_device_id ds1307_id[] = {
163 { "ds1307", ds_1307 },
164 { "ds1337", ds_1337 },
165 { "ds1338", ds_1338 },
166 { "ds1339", ds_1339 },
33df2ee1 167 { "ds1388", ds_1388 },
3760f736 168 { "ds1340", ds_1340 },
97f902b7 169 { "ds3231", ds_3231 },
3760f736 170 { "m41t00", m41t00 },
43fcb815 171 { "mcp7941x", mcp7941x },
31c1771c 172 { "pt7c4338", ds_1307 },
a2166858 173 { "rx8025", rx_8025 },
3760f736
JD
174 { }
175};
176MODULE_DEVICE_TABLE(i2c, ds1307_id);
1abb0dc9 177
cb49a5e9
RG
178/*----------------------------------------------------------------------*/
179
30e7b039
ES
180#define BLOCK_DATA_MAX_TRIES 10
181
0cc43a18
JD
182static s32 ds1307_read_block_data_once(const struct i2c_client *client,
183 u8 command, u8 length, u8 *values)
30e7b039
ES
184{
185 s32 i, data;
186
187 for (i = 0; i < length; i++) {
188 data = i2c_smbus_read_byte_data(client, command + i);
189 if (data < 0)
190 return data;
191 values[i] = data;
192 }
193 return i;
194}
195
0cc43a18 196static s32 ds1307_read_block_data(const struct i2c_client *client, u8 command,
30e7b039
ES
197 u8 length, u8 *values)
198{
199 u8 oldvalues[I2C_SMBUS_BLOCK_MAX];
200 s32 ret;
201 int tries = 0;
202
203 dev_dbg(&client->dev, "ds1307_read_block_data (length=%d)\n", length);
204 ret = ds1307_read_block_data_once(client, command, length, values);
205 if (ret < 0)
206 return ret;
207 do {
208 if (++tries > BLOCK_DATA_MAX_TRIES) {
209 dev_err(&client->dev,
210 "ds1307_read_block_data failed\n");
211 return -EIO;
212 }
213 memcpy(oldvalues, values, length);
214 ret = ds1307_read_block_data_once(client, command, length,
215 values);
216 if (ret < 0)
217 return ret;
218 } while (memcmp(oldvalues, values, length));
219 return length;
220}
221
0cc43a18 222static s32 ds1307_write_block_data(const struct i2c_client *client, u8 command,
30e7b039
ES
223 u8 length, const u8 *values)
224{
225 u8 currvalues[I2C_SMBUS_BLOCK_MAX];
226 int tries = 0;
227
228 dev_dbg(&client->dev, "ds1307_write_block_data (length=%d)\n", length);
229 do {
230 s32 i, ret;
231
232 if (++tries > BLOCK_DATA_MAX_TRIES) {
233 dev_err(&client->dev,
234 "ds1307_write_block_data failed\n");
235 return -EIO;
236 }
237 for (i = 0; i < length; i++) {
238 ret = i2c_smbus_write_byte_data(client, command + i,
239 values[i]);
240 if (ret < 0)
241 return ret;
242 }
243 ret = ds1307_read_block_data_once(client, command, length,
244 currvalues);
245 if (ret < 0)
246 return ret;
247 } while (memcmp(currvalues, values, length));
248 return length;
249}
250
251/*----------------------------------------------------------------------*/
252
cb49a5e9
RG
253/*
254 * The IRQ logic includes a "real" handler running in IRQ context just
255 * long enough to schedule this workqueue entry. We need a task context
256 * to talk to the RTC, since I2C I/O calls require that; and disable the
257 * IRQ until we clear its status on the chip, so that this handler can
258 * work with any type of triggering (not just falling edge).
259 *
260 * The ds1337 and ds1339 both have two alarms, but we only use the first
261 * one (with a "seconds" field). For ds1337 we expect nINTA is our alarm
262 * signal; ds1339 chips have only one alarm signal.
263 */
264static void ds1307_work(struct work_struct *work)
265{
266 struct ds1307 *ds1307;
267 struct i2c_client *client;
268 struct mutex *lock;
269 int stat, control;
270
271 ds1307 = container_of(work, struct ds1307, work);
272 client = ds1307->client;
273 lock = &ds1307->rtc->ops_lock;
274
275 mutex_lock(lock);
276 stat = i2c_smbus_read_byte_data(client, DS1337_REG_STATUS);
277 if (stat < 0)
278 goto out;
279
280 if (stat & DS1337_BIT_A1I) {
281 stat &= ~DS1337_BIT_A1I;
282 i2c_smbus_write_byte_data(client, DS1337_REG_STATUS, stat);
283
284 control = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);
285 if (control < 0)
286 goto out;
287
288 control &= ~DS1337_BIT_A1IE;
289 i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, control);
290
cb49a5e9 291 rtc_update_irq(ds1307->rtc, 1, RTC_AF | RTC_IRQF);
cb49a5e9
RG
292 }
293
294out:
295 if (test_bit(HAS_ALARM, &ds1307->flags))
296 enable_irq(client->irq);
297 mutex_unlock(lock);
298}
299
300static irqreturn_t ds1307_irq(int irq, void *dev_id)
301{
302 struct i2c_client *client = dev_id;
303 struct ds1307 *ds1307 = i2c_get_clientdata(client);
304
305 disable_irq_nosync(irq);
306 schedule_work(&ds1307->work);
307 return IRQ_HANDLED;
308}
309
310/*----------------------------------------------------------------------*/
311
1abb0dc9
DB
312static int ds1307_get_time(struct device *dev, struct rtc_time *t)
313{
314 struct ds1307 *ds1307 = dev_get_drvdata(dev);
315 int tmp;
316
045e0e85 317 /* read the RTC date and time registers all at once */
30e7b039 318 tmp = ds1307->read_block_data(ds1307->client,
33df2ee1 319 ds1307->offset, 7, ds1307->regs);
fed40b73 320 if (tmp != 7) {
1abb0dc9
DB
321 dev_err(dev, "%s error %d\n", "read", tmp);
322 return -EIO;
323 }
324
01a4ca16 325 dev_dbg(dev, "%s: %7ph\n", "read", ds1307->regs);
1abb0dc9 326
fe20ba70
AB
327 t->tm_sec = bcd2bin(ds1307->regs[DS1307_REG_SECS] & 0x7f);
328 t->tm_min = bcd2bin(ds1307->regs[DS1307_REG_MIN] & 0x7f);
1abb0dc9 329 tmp = ds1307->regs[DS1307_REG_HOUR] & 0x3f;
fe20ba70
AB
330 t->tm_hour = bcd2bin(tmp);
331 t->tm_wday = bcd2bin(ds1307->regs[DS1307_REG_WDAY] & 0x07) - 1;
332 t->tm_mday = bcd2bin(ds1307->regs[DS1307_REG_MDAY] & 0x3f);
1abb0dc9 333 tmp = ds1307->regs[DS1307_REG_MONTH] & 0x1f;
fe20ba70 334 t->tm_mon = bcd2bin(tmp) - 1;
1abb0dc9
DB
335
336 /* assume 20YY not 19YY, and ignore DS1337_BIT_CENTURY */
fe20ba70 337 t->tm_year = bcd2bin(ds1307->regs[DS1307_REG_YEAR]) + 100;
1abb0dc9
DB
338
339 dev_dbg(dev, "%s secs=%d, mins=%d, "
340 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
341 "read", t->tm_sec, t->tm_min,
342 t->tm_hour, t->tm_mday,
343 t->tm_mon, t->tm_year, t->tm_wday);
344
045e0e85
DB
345 /* initial clock setting can be undefined */
346 return rtc_valid_tm(t);
1abb0dc9
DB
347}
348
349static int ds1307_set_time(struct device *dev, struct rtc_time *t)
350{
351 struct ds1307 *ds1307 = dev_get_drvdata(dev);
352 int result;
353 int tmp;
354 u8 *buf = ds1307->regs;
355
356 dev_dbg(dev, "%s secs=%d, mins=%d, "
357 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
11966adc
JG
358 "write", t->tm_sec, t->tm_min,
359 t->tm_hour, t->tm_mday,
360 t->tm_mon, t->tm_year, t->tm_wday);
1abb0dc9 361
fe20ba70
AB
362 buf[DS1307_REG_SECS] = bin2bcd(t->tm_sec);
363 buf[DS1307_REG_MIN] = bin2bcd(t->tm_min);
364 buf[DS1307_REG_HOUR] = bin2bcd(t->tm_hour);
365 buf[DS1307_REG_WDAY] = bin2bcd(t->tm_wday + 1);
366 buf[DS1307_REG_MDAY] = bin2bcd(t->tm_mday);
367 buf[DS1307_REG_MONTH] = bin2bcd(t->tm_mon + 1);
1abb0dc9
DB
368
369 /* assume 20YY not 19YY */
370 tmp = t->tm_year - 100;
fe20ba70 371 buf[DS1307_REG_YEAR] = bin2bcd(tmp);
1abb0dc9 372
be5f59f4
RG
373 switch (ds1307->type) {
374 case ds_1337:
375 case ds_1339:
97f902b7 376 case ds_3231:
1abb0dc9 377 buf[DS1307_REG_MONTH] |= DS1337_BIT_CENTURY;
be5f59f4
RG
378 break;
379 case ds_1340:
1abb0dc9
DB
380 buf[DS1307_REG_HOUR] |= DS1340_BIT_CENTURY_EN
381 | DS1340_BIT_CENTURY;
be5f59f4 382 break;
43fcb815 383 case mcp7941x:
40ce972d
DA
384 /*
385 * these bits were cleared when preparing the date/time
386 * values and need to be set again before writing the
387 * buffer out to the device.
388 */
43fcb815
DA
389 buf[DS1307_REG_SECS] |= MCP7941X_BIT_ST;
390 buf[DS1307_REG_WDAY] |= MCP7941X_BIT_VBATEN;
391 break;
be5f59f4
RG
392 default:
393 break;
394 }
1abb0dc9 395
01a4ca16 396 dev_dbg(dev, "%s: %7ph\n", "write", buf);
1abb0dc9 397
33df2ee1
JT
398 result = ds1307->write_block_data(ds1307->client,
399 ds1307->offset, 7, buf);
fed40b73
BS
400 if (result < 0) {
401 dev_err(dev, "%s error %d\n", "write", result);
402 return result;
1abb0dc9
DB
403 }
404 return 0;
405}
406
74d88eb2 407static int ds1337_read_alarm(struct device *dev, struct rtc_wkalrm *t)
cb49a5e9
RG
408{
409 struct i2c_client *client = to_i2c_client(dev);
410 struct ds1307 *ds1307 = i2c_get_clientdata(client);
411 int ret;
412
413 if (!test_bit(HAS_ALARM, &ds1307->flags))
414 return -EINVAL;
415
416 /* read all ALARM1, ALARM2, and status registers at once */
30e7b039 417 ret = ds1307->read_block_data(client,
fed40b73
BS
418 DS1339_REG_ALARM1_SECS, 9, ds1307->regs);
419 if (ret != 9) {
cb49a5e9
RG
420 dev_err(dev, "%s error %d\n", "alarm read", ret);
421 return -EIO;
422 }
423
424 dev_dbg(dev, "%s: %02x %02x %02x %02x, %02x %02x %02x, %02x %02x\n",
425 "alarm read",
426 ds1307->regs[0], ds1307->regs[1],
427 ds1307->regs[2], ds1307->regs[3],
428 ds1307->regs[4], ds1307->regs[5],
429 ds1307->regs[6], ds1307->regs[7],
430 ds1307->regs[8]);
431
40ce972d
DA
432 /*
433 * report alarm time (ALARM1); assume 24 hour and day-of-month modes,
cb49a5e9
RG
434 * and that all four fields are checked matches
435 */
436 t->time.tm_sec = bcd2bin(ds1307->regs[0] & 0x7f);
437 t->time.tm_min = bcd2bin(ds1307->regs[1] & 0x7f);
438 t->time.tm_hour = bcd2bin(ds1307->regs[2] & 0x3f);
439 t->time.tm_mday = bcd2bin(ds1307->regs[3] & 0x3f);
440 t->time.tm_mon = -1;
441 t->time.tm_year = -1;
442 t->time.tm_wday = -1;
443 t->time.tm_yday = -1;
444 t->time.tm_isdst = -1;
445
446 /* ... and status */
447 t->enabled = !!(ds1307->regs[7] & DS1337_BIT_A1IE);
448 t->pending = !!(ds1307->regs[8] & DS1337_BIT_A1I);
449
450 dev_dbg(dev, "%s secs=%d, mins=%d, "
451 "hours=%d, mday=%d, enabled=%d, pending=%d\n",
452 "alarm read", t->time.tm_sec, t->time.tm_min,
453 t->time.tm_hour, t->time.tm_mday,
454 t->enabled, t->pending);
455
456 return 0;
457}
458
74d88eb2 459static int ds1337_set_alarm(struct device *dev, struct rtc_wkalrm *t)
cb49a5e9 460{
40ce972d 461 struct i2c_client *client = to_i2c_client(dev);
cb49a5e9
RG
462 struct ds1307 *ds1307 = i2c_get_clientdata(client);
463 unsigned char *buf = ds1307->regs;
464 u8 control, status;
465 int ret;
466
467 if (!test_bit(HAS_ALARM, &ds1307->flags))
468 return -EINVAL;
469
470 dev_dbg(dev, "%s secs=%d, mins=%d, "
471 "hours=%d, mday=%d, enabled=%d, pending=%d\n",
472 "alarm set", t->time.tm_sec, t->time.tm_min,
473 t->time.tm_hour, t->time.tm_mday,
474 t->enabled, t->pending);
475
476 /* read current status of both alarms and the chip */
30e7b039 477 ret = ds1307->read_block_data(client,
fed40b73
BS
478 DS1339_REG_ALARM1_SECS, 9, buf);
479 if (ret != 9) {
cb49a5e9
RG
480 dev_err(dev, "%s error %d\n", "alarm write", ret);
481 return -EIO;
482 }
483 control = ds1307->regs[7];
484 status = ds1307->regs[8];
485
486 dev_dbg(dev, "%s: %02x %02x %02x %02x, %02x %02x %02x, %02x %02x\n",
487 "alarm set (old status)",
488 ds1307->regs[0], ds1307->regs[1],
489 ds1307->regs[2], ds1307->regs[3],
490 ds1307->regs[4], ds1307->regs[5],
491 ds1307->regs[6], control, status);
492
493 /* set ALARM1, using 24 hour and day-of-month modes */
cb49a5e9
RG
494 buf[0] = bin2bcd(t->time.tm_sec);
495 buf[1] = bin2bcd(t->time.tm_min);
496 buf[2] = bin2bcd(t->time.tm_hour);
497 buf[3] = bin2bcd(t->time.tm_mday);
498
499 /* set ALARM2 to non-garbage */
500 buf[4] = 0;
501 buf[5] = 0;
502 buf[6] = 0;
503
504 /* optionally enable ALARM1 */
505 buf[7] = control & ~(DS1337_BIT_A1IE | DS1337_BIT_A2IE);
506 if (t->enabled) {
507 dev_dbg(dev, "alarm IRQ armed\n");
508 buf[7] |= DS1337_BIT_A1IE; /* only ALARM1 is used */
509 }
510 buf[8] = status & ~(DS1337_BIT_A1I | DS1337_BIT_A2I);
511
30e7b039 512 ret = ds1307->write_block_data(client,
fed40b73
BS
513 DS1339_REG_ALARM1_SECS, 9, buf);
514 if (ret < 0) {
cb49a5e9 515 dev_err(dev, "can't set alarm time\n");
fed40b73 516 return ret;
cb49a5e9
RG
517 }
518
519 return 0;
520}
521
16380c15 522static int ds1307_alarm_irq_enable(struct device *dev, unsigned int enabled)
cb49a5e9
RG
523{
524 struct i2c_client *client = to_i2c_client(dev);
525 struct ds1307 *ds1307 = i2c_get_clientdata(client);
526 int ret;
527
16380c15
JS
528 if (!test_bit(HAS_ALARM, &ds1307->flags))
529 return -ENOTTY;
cb49a5e9 530
16380c15
JS
531 ret = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);
532 if (ret < 0)
533 return ret;
cb49a5e9 534
16380c15 535 if (enabled)
cb49a5e9 536 ret |= DS1337_BIT_A1IE;
16380c15
JS
537 else
538 ret &= ~DS1337_BIT_A1IE;
cb49a5e9 539
16380c15
JS
540 ret = i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, ret);
541 if (ret < 0)
542 return ret;
cb49a5e9
RG
543
544 return 0;
545}
546
ff8371ac 547static const struct rtc_class_ops ds13xx_rtc_ops = {
1abb0dc9
DB
548 .read_time = ds1307_get_time,
549 .set_time = ds1307_set_time,
74d88eb2
JR
550 .read_alarm = ds1337_read_alarm,
551 .set_alarm = ds1337_set_alarm,
16380c15 552 .alarm_irq_enable = ds1307_alarm_irq_enable,
1abb0dc9
DB
553};
554
682d73f6
DB
555/*----------------------------------------------------------------------*/
556
682d73f6 557static ssize_t
2c3c8bea
CW
558ds1307_nvram_read(struct file *filp, struct kobject *kobj,
559 struct bin_attribute *attr,
682d73f6
DB
560 char *buf, loff_t off, size_t count)
561{
562 struct i2c_client *client;
563 struct ds1307 *ds1307;
682d73f6
DB
564 int result;
565
fcd8db00 566 client = kobj_to_i2c_client(kobj);
682d73f6
DB
567 ds1307 = i2c_get_clientdata(client);
568
9eab0a78 569 if (unlikely(off >= ds1307->nvram->size))
682d73f6 570 return 0;
9eab0a78
AB
571 if ((off + count) > ds1307->nvram->size)
572 count = ds1307->nvram->size - off;
682d73f6
DB
573 if (unlikely(!count))
574 return count;
575
9eab0a78
AB
576 result = ds1307->read_block_data(client, ds1307->nvram_offset + off,
577 count, buf);
fed40b73 578 if (result < 0)
682d73f6 579 dev_err(&client->dev, "%s error %d\n", "nvram read", result);
fed40b73 580 return result;
682d73f6
DB
581}
582
583static ssize_t
2c3c8bea
CW
584ds1307_nvram_write(struct file *filp, struct kobject *kobj,
585 struct bin_attribute *attr,
682d73f6
DB
586 char *buf, loff_t off, size_t count)
587{
588 struct i2c_client *client;
30e7b039 589 struct ds1307 *ds1307;
fed40b73 590 int result;
682d73f6 591
fcd8db00 592 client = kobj_to_i2c_client(kobj);
30e7b039 593 ds1307 = i2c_get_clientdata(client);
682d73f6 594
9eab0a78 595 if (unlikely(off >= ds1307->nvram->size))
682d73f6 596 return -EFBIG;
9eab0a78
AB
597 if ((off + count) > ds1307->nvram->size)
598 count = ds1307->nvram->size - off;
682d73f6
DB
599 if (unlikely(!count))
600 return count;
601
9eab0a78
AB
602 result = ds1307->write_block_data(client, ds1307->nvram_offset + off,
603 count, buf);
fed40b73
BS
604 if (result < 0) {
605 dev_err(&client->dev, "%s error %d\n", "nvram write", result);
606 return result;
607 }
608 return count;
682d73f6
DB
609}
610
682d73f6
DB
611/*----------------------------------------------------------------------*/
612
5a167f45
GKH
613static int ds1307_probe(struct i2c_client *client,
614 const struct i2c_device_id *id)
1abb0dc9
DB
615{
616 struct ds1307 *ds1307;
617 int err = -ENODEV;
1abb0dc9 618 int tmp;
3760f736 619 const struct chip_desc *chip = &chips[id->driver_data];
c065f35c 620 struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
cb49a5e9 621 int want_irq = false;
fed40b73 622 unsigned char *buf;
eb86c306 623 struct ds1307_platform_data *pdata = client->dev.platform_data;
97f902b7
WS
624 static const int bbsqi_bitpos[] = {
625 [ds_1337] = 0,
626 [ds_1339] = DS1339_BIT_BBSQI,
627 [ds_3231] = DS3231_BIT_BBSQW,
628 };
1abb0dc9 629
30e7b039
ES
630 if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA)
631 && !i2c_check_functionality(adapter, I2C_FUNC_SMBUS_I2C_BLOCK))
c065f35c
DB
632 return -EIO;
633
40ce972d
DA
634 ds1307 = kzalloc(sizeof(struct ds1307), GFP_KERNEL);
635 if (!ds1307)
c065f35c 636 return -ENOMEM;
045e0e85 637
1abb0dc9 638 i2c_set_clientdata(client, ds1307);
33df2ee1
JT
639
640 ds1307->client = client;
641 ds1307->type = id->driver_data;
33df2ee1 642
eb86c306
WS
643 if (pdata && pdata->trickle_charger_setup && chip->trickle_charger_reg)
644 i2c_smbus_write_byte_data(client, chip->trickle_charger_reg,
645 DS13XX_TRICKLE_CHARGER_MAGIC | pdata->trickle_charger_setup);
646
fed40b73 647 buf = ds1307->regs;
30e7b039
ES
648 if (i2c_check_functionality(adapter, I2C_FUNC_SMBUS_I2C_BLOCK)) {
649 ds1307->read_block_data = i2c_smbus_read_i2c_block_data;
650 ds1307->write_block_data = i2c_smbus_write_i2c_block_data;
651 } else {
652 ds1307->read_block_data = ds1307_read_block_data;
653 ds1307->write_block_data = ds1307_write_block_data;
654 }
045e0e85
DB
655
656 switch (ds1307->type) {
657 case ds_1337:
658 case ds_1339:
97f902b7 659 case ds_3231:
be5f59f4 660 /* get registers that the "rtc" read below won't read... */
30e7b039 661 tmp = ds1307->read_block_data(ds1307->client,
fed40b73 662 DS1337_REG_CONTROL, 2, buf);
1abb0dc9
DB
663 if (tmp != 2) {
664 pr_debug("read error %d\n", tmp);
665 err = -EIO;
666 goto exit_free;
667 }
668
be5f59f4
RG
669 /* oscillator off? turn it on, so clock can tick. */
670 if (ds1307->regs[0] & DS1337_BIT_nEOSC)
cb49a5e9
RG
671 ds1307->regs[0] &= ~DS1337_BIT_nEOSC;
672
40ce972d
DA
673 /*
674 * Using IRQ? Disable the square wave and both alarms.
97f902b7
WS
675 * For some variants, be sure alarms can trigger when we're
676 * running on Vbackup (BBSQI/BBSQW)
cb49a5e9 677 */
b24a7267
WS
678 if (ds1307->client->irq > 0 && chip->alarm) {
679 INIT_WORK(&ds1307->work, ds1307_work);
680
97f902b7
WS
681 ds1307->regs[0] |= DS1337_BIT_INTCN
682 | bbsqi_bitpos[ds1307->type];
cb49a5e9 683 ds1307->regs[0] &= ~(DS1337_BIT_A2IE | DS1337_BIT_A1IE);
b24a7267
WS
684
685 want_irq = true;
cb49a5e9
RG
686 }
687
688 i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL,
689 ds1307->regs[0]);
be5f59f4
RG
690
691 /* oscillator fault? clear flag, and warn */
692 if (ds1307->regs[1] & DS1337_BIT_OSF) {
693 i2c_smbus_write_byte_data(client, DS1337_REG_STATUS,
694 ds1307->regs[1] & ~DS1337_BIT_OSF);
695 dev_warn(&client->dev, "SET TIME!\n");
1abb0dc9 696 }
045e0e85 697 break;
a2166858
MF
698
699 case rx_8025:
700 tmp = i2c_smbus_read_i2c_block_data(ds1307->client,
701 RX8025_REG_CTRL1 << 4 | 0x08, 2, buf);
702 if (tmp != 2) {
703 pr_debug("read error %d\n", tmp);
704 err = -EIO;
705 goto exit_free;
706 }
707
708 /* oscillator off? turn it on, so clock can tick. */
709 if (!(ds1307->regs[1] & RX8025_BIT_XST)) {
710 ds1307->regs[1] |= RX8025_BIT_XST;
711 i2c_smbus_write_byte_data(client,
712 RX8025_REG_CTRL2 << 4 | 0x08,
713 ds1307->regs[1]);
714 dev_warn(&client->dev,
715 "oscillator stop detected - SET TIME!\n");
716 }
717
718 if (ds1307->regs[1] & RX8025_BIT_PON) {
719 ds1307->regs[1] &= ~RX8025_BIT_PON;
720 i2c_smbus_write_byte_data(client,
721 RX8025_REG_CTRL2 << 4 | 0x08,
722 ds1307->regs[1]);
723 dev_warn(&client->dev, "power-on detected\n");
724 }
725
726 if (ds1307->regs[1] & RX8025_BIT_VDET) {
727 ds1307->regs[1] &= ~RX8025_BIT_VDET;
728 i2c_smbus_write_byte_data(client,
729 RX8025_REG_CTRL2 << 4 | 0x08,
730 ds1307->regs[1]);
731 dev_warn(&client->dev, "voltage drop detected\n");
732 }
733
734 /* make sure we are running in 24hour mode */
735 if (!(ds1307->regs[0] & RX8025_BIT_2412)) {
736 u8 hour;
737
738 /* switch to 24 hour mode */
739 i2c_smbus_write_byte_data(client,
740 RX8025_REG_CTRL1 << 4 | 0x08,
741 ds1307->regs[0] |
742 RX8025_BIT_2412);
743
744 tmp = i2c_smbus_read_i2c_block_data(ds1307->client,
745 RX8025_REG_CTRL1 << 4 | 0x08, 2, buf);
746 if (tmp != 2) {
747 pr_debug("read error %d\n", tmp);
748 err = -EIO;
749 goto exit_free;
750 }
751
752 /* correct hour */
753 hour = bcd2bin(ds1307->regs[DS1307_REG_HOUR]);
754 if (hour == 12)
755 hour = 0;
756 if (ds1307->regs[DS1307_REG_HOUR] & DS1307_BIT_PM)
757 hour += 12;
758
759 i2c_smbus_write_byte_data(client,
760 DS1307_REG_HOUR << 4 | 0x08,
761 hour);
762 }
763 break;
33df2ee1
JT
764 case ds_1388:
765 ds1307->offset = 1; /* Seconds starts at 1 */
766 break;
045e0e85
DB
767 default:
768 break;
769 }
1abb0dc9
DB
770
771read_rtc:
772 /* read RTC registers */
96fc3a45 773 tmp = ds1307->read_block_data(ds1307->client, ds1307->offset, 8, buf);
fed40b73 774 if (tmp != 8) {
1abb0dc9
DB
775 pr_debug("read error %d\n", tmp);
776 err = -EIO;
777 goto exit_free;
778 }
779
40ce972d
DA
780 /*
781 * minimal sanity checking; some chips (like DS1340) don't
1abb0dc9
DB
782 * specify the extra bits as must-be-zero, but there are
783 * still a few values that are clearly out-of-range.
784 */
785 tmp = ds1307->regs[DS1307_REG_SECS];
045e0e85
DB
786 switch (ds1307->type) {
787 case ds_1307:
045e0e85 788 case m41t00:
be5f59f4 789 /* clock halted? turn it on, so clock can tick. */
045e0e85 790 if (tmp & DS1307_BIT_CH) {
be5f59f4
RG
791 i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
792 dev_warn(&client->dev, "SET TIME!\n");
045e0e85 793 goto read_rtc;
1abb0dc9 794 }
045e0e85 795 break;
be5f59f4
RG
796 case ds_1338:
797 /* clock halted? turn it on, so clock can tick. */
045e0e85 798 if (tmp & DS1307_BIT_CH)
be5f59f4
RG
799 i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
800
801 /* oscillator fault? clear flag, and warn */
802 if (ds1307->regs[DS1307_REG_CONTROL] & DS1338_BIT_OSF) {
803 i2c_smbus_write_byte_data(client, DS1307_REG_CONTROL,
bd16f9eb 804 ds1307->regs[DS1307_REG_CONTROL]
be5f59f4
RG
805 & ~DS1338_BIT_OSF);
806 dev_warn(&client->dev, "SET TIME!\n");
807 goto read_rtc;
808 }
045e0e85 809 break;
fcd8db00
R
810 case ds_1340:
811 /* clock halted? turn it on, so clock can tick. */
812 if (tmp & DS1340_BIT_nEOSC)
813 i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
814
815 tmp = i2c_smbus_read_byte_data(client, DS1340_REG_FLAG);
816 if (tmp < 0) {
817 pr_debug("read error %d\n", tmp);
818 err = -EIO;
819 goto exit_free;
820 }
821
822 /* oscillator fault? clear flag, and warn */
823 if (tmp & DS1340_BIT_OSF) {
824 i2c_smbus_write_byte_data(client, DS1340_REG_FLAG, 0);
825 dev_warn(&client->dev, "SET TIME!\n");
826 }
43fcb815
DA
827 break;
828 case mcp7941x:
829 /* make sure that the backup battery is enabled */
830 if (!(ds1307->regs[DS1307_REG_WDAY] & MCP7941X_BIT_VBATEN)) {
831 i2c_smbus_write_byte_data(client, DS1307_REG_WDAY,
832 ds1307->regs[DS1307_REG_WDAY]
833 | MCP7941X_BIT_VBATEN);
834 }
835
836 /* clock halted? turn it on, so clock can tick. */
837 if (!(tmp & MCP7941X_BIT_ST)) {
838 i2c_smbus_write_byte_data(client, DS1307_REG_SECS,
839 MCP7941X_BIT_ST);
840 dev_warn(&client->dev, "SET TIME!\n");
841 goto read_rtc;
842 }
843
fcd8db00 844 break;
32d322bc 845 default:
045e0e85 846 break;
1abb0dc9 847 }
045e0e85 848
1abb0dc9 849 tmp = ds1307->regs[DS1307_REG_HOUR];
c065f35c
DB
850 switch (ds1307->type) {
851 case ds_1340:
852 case m41t00:
40ce972d
DA
853 /*
854 * NOTE: ignores century bits; fix before deploying
c065f35c
DB
855 * systems that will run through year 2100.
856 */
857 break;
a2166858
MF
858 case rx_8025:
859 break;
c065f35c
DB
860 default:
861 if (!(tmp & DS1307_BIT_12HR))
862 break;
863
40ce972d
DA
864 /*
865 * Be sure we're in 24 hour mode. Multi-master systems
c065f35c
DB
866 * take note...
867 */
fe20ba70 868 tmp = bcd2bin(tmp & 0x1f);
c065f35c
DB
869 if (tmp == 12)
870 tmp = 0;
871 if (ds1307->regs[DS1307_REG_HOUR] & DS1307_BIT_PM)
872 tmp += 12;
1abb0dc9 873 i2c_smbus_write_byte_data(client,
96fc3a45 874 ds1307->offset + DS1307_REG_HOUR,
fe20ba70 875 bin2bcd(tmp));
1abb0dc9
DB
876 }
877
1abb0dc9
DB
878 ds1307->rtc = rtc_device_register(client->name, &client->dev,
879 &ds13xx_rtc_ops, THIS_MODULE);
880 if (IS_ERR(ds1307->rtc)) {
881 err = PTR_ERR(ds1307->rtc);
882 dev_err(&client->dev,
883 "unable to register the class device\n");
c065f35c 884 goto exit_free;
1abb0dc9
DB
885 }
886
cb49a5e9 887 if (want_irq) {
43d15bcd 888 err = request_irq(client->irq, ds1307_irq, IRQF_SHARED,
cb49a5e9
RG
889 ds1307->rtc->name, client);
890 if (err) {
891 dev_err(&client->dev,
892 "unable to request IRQ!\n");
893 goto exit_irq;
894 }
26b3c01f
AV
895
896 device_set_wakeup_capable(&client->dev, 1);
cb49a5e9
RG
897 set_bit(HAS_ALARM, &ds1307->flags);
898 dev_dbg(&client->dev, "got IRQ %d\n", client->irq);
899 }
900
9eab0a78
AB
901 if (chip->nvram_size) {
902 ds1307->nvram = kzalloc(sizeof(struct bin_attribute),
903 GFP_KERNEL);
904 if (!ds1307->nvram) {
905 err = -ENOMEM;
906 goto exit_nvram;
907 }
908 ds1307->nvram->attr.name = "nvram";
909 ds1307->nvram->attr.mode = S_IRUGO | S_IWUSR;
3f5ec5e0 910 sysfs_bin_attr_init(ds1307->nvram);
9eab0a78
AB
911 ds1307->nvram->read = ds1307_nvram_read,
912 ds1307->nvram->write = ds1307_nvram_write,
913 ds1307->nvram->size = chip->nvram_size;
914 ds1307->nvram_offset = chip->nvram_offset;
915 err = sysfs_create_bin_file(&client->dev.kobj, ds1307->nvram);
916 if (err) {
917 kfree(ds1307->nvram);
918 goto exit_nvram;
682d73f6 919 }
9eab0a78
AB
920 set_bit(HAS_NVRAM, &ds1307->flags);
921 dev_info(&client->dev, "%zu bytes nvram\n", ds1307->nvram->size);
682d73f6
DB
922 }
923
1abb0dc9
DB
924 return 0;
925
9eab0a78 926exit_nvram:
cb49a5e9 927exit_irq:
72445af8 928 rtc_device_unregister(ds1307->rtc);
1abb0dc9
DB
929exit_free:
930 kfree(ds1307);
1abb0dc9
DB
931 return err;
932}
933
5a167f45 934static int ds1307_remove(struct i2c_client *client)
1abb0dc9 935{
40ce972d 936 struct ds1307 *ds1307 = i2c_get_clientdata(client);
cb49a5e9
RG
937
938 if (test_and_clear_bit(HAS_ALARM, &ds1307->flags)) {
939 free_irq(client->irq, client);
940 cancel_work_sync(&ds1307->work);
941 }
1abb0dc9 942
9eab0a78
AB
943 if (test_and_clear_bit(HAS_NVRAM, &ds1307->flags)) {
944 sysfs_remove_bin_file(&client->dev.kobj, ds1307->nvram);
945 kfree(ds1307->nvram);
946 }
682d73f6 947
1abb0dc9 948 rtc_device_unregister(ds1307->rtc);
1abb0dc9
DB
949 kfree(ds1307);
950 return 0;
951}
952
953static struct i2c_driver ds1307_driver = {
954 .driver = {
c065f35c 955 .name = "rtc-ds1307",
1abb0dc9
DB
956 .owner = THIS_MODULE,
957 },
c065f35c 958 .probe = ds1307_probe,
5a167f45 959 .remove = ds1307_remove,
3760f736 960 .id_table = ds1307_id,
1abb0dc9
DB
961};
962
0abc9201 963module_i2c_driver(ds1307_driver);
1abb0dc9
DB
964
965MODULE_DESCRIPTION("RTC driver for DS1307 and similar chips");
966MODULE_LICENSE("GPL");