blob: 7836c9cec5578a559170e1c356284f795f6be409 [file] [log] [blame]
David Brownell53e84b62008-07-23 21:30:36 -07001/*
2 * rtc-ds1305.c -- driver for DS1305 and DS1306 SPI RTC chips
3 *
4 * Copyright (C) 2008 David Brownell
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
9 *
10 */
11#include <linux/kernel.h>
12#include <linux/init.h>
13#include <linux/bcd.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090014#include <linux/slab.h>
David Brownell53e84b62008-07-23 21:30:36 -070015#include <linux/rtc.h>
16#include <linux/workqueue.h>
17
18#include <linux/spi/spi.h>
19#include <linux/spi/ds1305.h>
20
21
22/*
23 * Registers ... mask DS1305_WRITE into register address to write,
24 * otherwise you're reading it. All non-bitmask values are BCD.
25 */
26#define DS1305_WRITE 0x80
27
28
29/* RTC date/time ... the main special cases are that we:
30 * - Need fancy "hours" encoding in 12hour mode
31 * - Don't rely on the "day-of-week" field (or tm_wday)
32 * - Are a 21st-century clock (2000 <= year < 2100)
33 */
34#define DS1305_RTC_LEN 7 /* bytes for RTC regs */
35
36#define DS1305_SEC 0x00 /* register addresses */
37#define DS1305_MIN 0x01
38#define DS1305_HOUR 0x02
39# define DS1305_HR_12 0x40 /* set == 12 hr mode */
40# define DS1305_HR_PM 0x20 /* set == PM (12hr mode) */
41#define DS1305_WDAY 0x03
42#define DS1305_MDAY 0x04
43#define DS1305_MON 0x05
44#define DS1305_YEAR 0x06
45
46
47/* The two alarms have only sec/min/hour/wday fields (ALM_LEN).
48 * DS1305_ALM_DISABLE disables a match field (some combos are bad).
49 *
50 * NOTE that since we don't use WDAY, we limit ourselves to alarms
51 * only one day into the future (vs potentially up to a week).
52 *
53 * NOTE ALSO that while we could generate once-a-second IRQs (UIE), we
54 * don't currently support them. We'd either need to do it only when
55 * no alarm is pending (not the standard model), or to use the second
56 * alarm (implying that this is a DS1305 not DS1306, *and* that either
57 * it's wired up a second IRQ we know, or that INTCN is set)
58 */
59#define DS1305_ALM_LEN 4 /* bytes for ALM regs */
60#define DS1305_ALM_DISABLE 0x80
61
62#define DS1305_ALM0(r) (0x07 + (r)) /* register addresses */
63#define DS1305_ALM1(r) (0x0b + (r))
64
65
66/* three control registers */
67#define DS1305_CONTROL_LEN 3 /* bytes of control regs */
68
69#define DS1305_CONTROL 0x0f /* register addresses */
70# define DS1305_nEOSC 0x80 /* low enables oscillator */
71# define DS1305_WP 0x40 /* write protect */
72# define DS1305_INTCN 0x04 /* clear == only int0 used */
73# define DS1306_1HZ 0x04 /* enable 1Hz output */
74# define DS1305_AEI1 0x02 /* enable ALM1 IRQ */
75# define DS1305_AEI0 0x01 /* enable ALM0 IRQ */
76#define DS1305_STATUS 0x10
77/* status has just AEIx bits, mirrored as IRQFx */
78#define DS1305_TRICKLE 0x11
79/* trickle bits are defined in <linux/spi/ds1305.h> */
80
81/* a bunch of NVRAM */
82#define DS1305_NVRAM_LEN 96 /* bytes of NVRAM */
83
84#define DS1305_NVRAM 0x20 /* register addresses */
85
86
87struct ds1305 {
88 struct spi_device *spi;
89 struct rtc_device *rtc;
90
91 struct work_struct work;
92
93 unsigned long flags;
94#define FLAG_EXITING 0
95
96 bool hr12;
97 u8 ctrl[DS1305_CONTROL_LEN];
98};
99
100
101/*----------------------------------------------------------------------*/
102
103/*
104 * Utilities ... tolerate 12-hour AM/PM notation in case of non-Linux
105 * software (like a bootloader) which may require it.
106 */
107
108static unsigned bcd2hour(u8 bcd)
109{
110 if (bcd & DS1305_HR_12) {
111 unsigned hour = 0;
112
113 bcd &= ~DS1305_HR_12;
114 if (bcd & DS1305_HR_PM) {
115 hour = 12;
116 bcd &= ~DS1305_HR_PM;
117 }
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700118 hour += bcd2bin(bcd);
David Brownell53e84b62008-07-23 21:30:36 -0700119 return hour - 1;
120 }
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700121 return bcd2bin(bcd);
David Brownell53e84b62008-07-23 21:30:36 -0700122}
123
124static u8 hour2bcd(bool hr12, int hour)
125{
126 if (hr12) {
127 hour++;
128 if (hour <= 12)
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700129 return DS1305_HR_12 | bin2bcd(hour);
David Brownell53e84b62008-07-23 21:30:36 -0700130 hour -= 12;
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700131 return DS1305_HR_12 | DS1305_HR_PM | bin2bcd(hour);
David Brownell53e84b62008-07-23 21:30:36 -0700132 }
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700133 return bin2bcd(hour);
David Brownell53e84b62008-07-23 21:30:36 -0700134}
135
136/*----------------------------------------------------------------------*/
137
138/*
139 * Interface to RTC framework
140 */
141
142#ifdef CONFIG_RTC_INTF_DEV
143
144/*
145 * Context: caller holds rtc->ops_lock (to protect ds1305->ctrl)
146 */
147static int ds1305_ioctl(struct device *dev, unsigned cmd, unsigned long arg)
148{
149 struct ds1305 *ds1305 = dev_get_drvdata(dev);
150 u8 buf[2];
151 int status = -ENOIOCTLCMD;
152
153 buf[0] = DS1305_WRITE | DS1305_CONTROL;
154 buf[1] = ds1305->ctrl[0];
155
156 switch (cmd) {
157 case RTC_AIE_OFF:
158 status = 0;
159 if (!(buf[1] & DS1305_AEI0))
160 goto done;
161 buf[1] &= ~DS1305_AEI0;
162 break;
163
164 case RTC_AIE_ON:
165 status = 0;
166 if (ds1305->ctrl[0] & DS1305_AEI0)
167 goto done;
168 buf[1] |= DS1305_AEI0;
169 break;
170 }
171 if (status == 0) {
172 status = spi_write_then_read(ds1305->spi, buf, sizeof buf,
173 NULL, 0);
174 if (status >= 0)
175 ds1305->ctrl[0] = buf[1];
176 }
177
178done:
179 return status;
180}
181
182#else
183#define ds1305_ioctl NULL
184#endif
185
186/*
187 * Get/set of date and time is pretty normal.
188 */
189
190static int ds1305_get_time(struct device *dev, struct rtc_time *time)
191{
192 struct ds1305 *ds1305 = dev_get_drvdata(dev);
193 u8 addr = DS1305_SEC;
194 u8 buf[DS1305_RTC_LEN];
195 int status;
196
197 /* Use write-then-read to get all the date/time registers
198 * since dma from stack is nonportable
199 */
200 status = spi_write_then_read(ds1305->spi, &addr, sizeof addr,
201 buf, sizeof buf);
202 if (status < 0)
203 return status;
204
205 dev_vdbg(dev, "%s: %02x %02x %02x, %02x %02x %02x %02x\n",
206 "read", buf[0], buf[1], buf[2], buf[3],
207 buf[4], buf[5], buf[6]);
208
209 /* Decode the registers */
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700210 time->tm_sec = bcd2bin(buf[DS1305_SEC]);
211 time->tm_min = bcd2bin(buf[DS1305_MIN]);
David Brownell53e84b62008-07-23 21:30:36 -0700212 time->tm_hour = bcd2hour(buf[DS1305_HOUR]);
213 time->tm_wday = buf[DS1305_WDAY] - 1;
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700214 time->tm_mday = bcd2bin(buf[DS1305_MDAY]);
215 time->tm_mon = bcd2bin(buf[DS1305_MON]) - 1;
216 time->tm_year = bcd2bin(buf[DS1305_YEAR]) + 100;
David Brownell53e84b62008-07-23 21:30:36 -0700217
218 dev_vdbg(dev, "%s secs=%d, mins=%d, "
219 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
220 "read", time->tm_sec, time->tm_min,
221 time->tm_hour, time->tm_mday,
222 time->tm_mon, time->tm_year, time->tm_wday);
223
224 /* Time may not be set */
225 return rtc_valid_tm(time);
226}
227
228static int ds1305_set_time(struct device *dev, struct rtc_time *time)
229{
230 struct ds1305 *ds1305 = dev_get_drvdata(dev);
231 u8 buf[1 + DS1305_RTC_LEN];
232 u8 *bp = buf;
233
234 dev_vdbg(dev, "%s secs=%d, mins=%d, "
235 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
236 "write", time->tm_sec, time->tm_min,
237 time->tm_hour, time->tm_mday,
238 time->tm_mon, time->tm_year, time->tm_wday);
239
240 /* Write registers starting at the first time/date address. */
241 *bp++ = DS1305_WRITE | DS1305_SEC;
242
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700243 *bp++ = bin2bcd(time->tm_sec);
244 *bp++ = bin2bcd(time->tm_min);
David Brownell53e84b62008-07-23 21:30:36 -0700245 *bp++ = hour2bcd(ds1305->hr12, time->tm_hour);
246 *bp++ = (time->tm_wday < 7) ? (time->tm_wday + 1) : 1;
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700247 *bp++ = bin2bcd(time->tm_mday);
248 *bp++ = bin2bcd(time->tm_mon + 1);
249 *bp++ = bin2bcd(time->tm_year - 100);
David Brownell53e84b62008-07-23 21:30:36 -0700250
251 dev_dbg(dev, "%s: %02x %02x %02x, %02x %02x %02x %02x\n",
252 "write", buf[1], buf[2], buf[3],
253 buf[4], buf[5], buf[6], buf[7]);
254
255 /* use write-then-read since dma from stack is nonportable */
256 return spi_write_then_read(ds1305->spi, buf, sizeof buf,
257 NULL, 0);
258}
259
260/*
261 * Get/set of alarm is a bit funky:
262 *
263 * - First there's the inherent raciness of getting the (partitioned)
264 * status of an alarm that could trigger while we're reading parts
265 * of that status.
266 *
267 * - Second there's its limited range (we could increase it a bit by
268 * relying on WDAY), which means it will easily roll over.
269 *
270 * - Third there's the choice of two alarms and alarm signals.
271 * Here we use ALM0 and expect that nINT0 (open drain) is used;
272 * that's the only real option for DS1306 runtime alarms, and is
273 * natural on DS1305.
274 *
275 * - Fourth, there's also ALM1, and a second interrupt signal:
276 * + On DS1305 ALM1 uses nINT1 (when INTCN=1) else nINT0;
277 * + On DS1306 ALM1 only uses INT1 (an active high pulse)
278 * and it won't work when VCC1 is active.
279 *
280 * So to be most general, we should probably set both alarms to the
281 * same value, letting ALM1 be the wakeup event source on DS1306
282 * and handling several wiring options on DS1305.
283 *
284 * - Fifth, we support the polled mode (as well as possible; why not?)
285 * even when no interrupt line is wired to an IRQ.
286 */
287
288/*
289 * Context: caller holds rtc->ops_lock (to protect ds1305->ctrl)
290 */
291static int ds1305_get_alarm(struct device *dev, struct rtc_wkalrm *alm)
292{
293 struct ds1305 *ds1305 = dev_get_drvdata(dev);
294 struct spi_device *spi = ds1305->spi;
295 u8 addr;
296 int status;
297 u8 buf[DS1305_ALM_LEN];
298
299 /* Refresh control register cache BEFORE reading ALM0 registers,
300 * since reading alarm registers acks any pending IRQ. That
301 * makes returning "pending" status a bit of a lie, but that bit
302 * of EFI status is at best fragile anyway (given IRQ handlers).
303 */
304 addr = DS1305_CONTROL;
305 status = spi_write_then_read(spi, &addr, sizeof addr,
306 ds1305->ctrl, sizeof ds1305->ctrl);
307 if (status < 0)
308 return status;
309
310 alm->enabled = !!(ds1305->ctrl[0] & DS1305_AEI0);
311 alm->pending = !!(ds1305->ctrl[1] & DS1305_AEI0);
312
313 /* get and check ALM0 registers */
314 addr = DS1305_ALM0(DS1305_SEC);
315 status = spi_write_then_read(spi, &addr, sizeof addr,
316 buf, sizeof buf);
317 if (status < 0)
318 return status;
319
320 dev_vdbg(dev, "%s: %02x %02x %02x %02x\n",
321 "alm0 read", buf[DS1305_SEC], buf[DS1305_MIN],
322 buf[DS1305_HOUR], buf[DS1305_WDAY]);
323
324 if ((DS1305_ALM_DISABLE & buf[DS1305_SEC])
325 || (DS1305_ALM_DISABLE & buf[DS1305_MIN])
326 || (DS1305_ALM_DISABLE & buf[DS1305_HOUR]))
327 return -EIO;
328
329 /* Stuff these values into alm->time and let RTC framework code
330 * fill in the rest ... and also handle rollover to tomorrow when
331 * that's needed.
332 */
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700333 alm->time.tm_sec = bcd2bin(buf[DS1305_SEC]);
334 alm->time.tm_min = bcd2bin(buf[DS1305_MIN]);
David Brownell53e84b62008-07-23 21:30:36 -0700335 alm->time.tm_hour = bcd2hour(buf[DS1305_HOUR]);
336 alm->time.tm_mday = -1;
337 alm->time.tm_mon = -1;
338 alm->time.tm_year = -1;
339 /* next three fields are unused by Linux */
340 alm->time.tm_wday = -1;
341 alm->time.tm_mday = -1;
342 alm->time.tm_isdst = -1;
343
344 return 0;
345}
346
347/*
348 * Context: caller holds rtc->ops_lock (to protect ds1305->ctrl)
349 */
350static int ds1305_set_alarm(struct device *dev, struct rtc_wkalrm *alm)
351{
352 struct ds1305 *ds1305 = dev_get_drvdata(dev);
353 struct spi_device *spi = ds1305->spi;
354 unsigned long now, later;
355 struct rtc_time tm;
356 int status;
357 u8 buf[1 + DS1305_ALM_LEN];
358
359 /* convert desired alarm to time_t */
360 status = rtc_tm_to_time(&alm->time, &later);
361 if (status < 0)
362 return status;
363
364 /* Read current time as time_t */
365 status = ds1305_get_time(dev, &tm);
366 if (status < 0)
367 return status;
368 status = rtc_tm_to_time(&tm, &now);
369 if (status < 0)
370 return status;
371
372 /* make sure alarm fires within the next 24 hours */
373 if (later <= now)
374 return -EINVAL;
375 if ((later - now) > 24 * 60 * 60)
376 return -EDOM;
377
378 /* disable alarm if needed */
379 if (ds1305->ctrl[0] & DS1305_AEI0) {
380 ds1305->ctrl[0] &= ~DS1305_AEI0;
381
382 buf[0] = DS1305_WRITE | DS1305_CONTROL;
383 buf[1] = ds1305->ctrl[0];
384 status = spi_write_then_read(ds1305->spi, buf, 2, NULL, 0);
385 if (status < 0)
386 return status;
387 }
388
389 /* write alarm */
390 buf[0] = DS1305_WRITE | DS1305_ALM0(DS1305_SEC);
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700391 buf[1 + DS1305_SEC] = bin2bcd(alm->time.tm_sec);
392 buf[1 + DS1305_MIN] = bin2bcd(alm->time.tm_min);
David Brownell53e84b62008-07-23 21:30:36 -0700393 buf[1 + DS1305_HOUR] = hour2bcd(ds1305->hr12, alm->time.tm_hour);
394 buf[1 + DS1305_WDAY] = DS1305_ALM_DISABLE;
395
396 dev_dbg(dev, "%s: %02x %02x %02x %02x\n",
397 "alm0 write", buf[1 + DS1305_SEC], buf[1 + DS1305_MIN],
398 buf[1 + DS1305_HOUR], buf[1 + DS1305_WDAY]);
399
400 status = spi_write_then_read(spi, buf, sizeof buf, NULL, 0);
401 if (status < 0)
402 return status;
403
404 /* enable alarm if requested */
405 if (alm->enabled) {
406 ds1305->ctrl[0] |= DS1305_AEI0;
407
408 buf[0] = DS1305_WRITE | DS1305_CONTROL;
409 buf[1] = ds1305->ctrl[0];
410 status = spi_write_then_read(ds1305->spi, buf, 2, NULL, 0);
411 }
412
413 return status;
414}
415
416#ifdef CONFIG_PROC_FS
417
418static int ds1305_proc(struct device *dev, struct seq_file *seq)
419{
420 struct ds1305 *ds1305 = dev_get_drvdata(dev);
421 char *diodes = "no";
422 char *resistors = "";
423
424 /* ctrl[2] is treated as read-only; no locking needed */
425 if ((ds1305->ctrl[2] & 0xf0) == DS1305_TRICKLE_MAGIC) {
426 switch (ds1305->ctrl[2] & 0x0c) {
427 case DS1305_TRICKLE_DS2:
428 diodes = "2 diodes, ";
429 break;
430 case DS1305_TRICKLE_DS1:
431 diodes = "1 diode, ";
432 break;
433 default:
434 goto done;
435 }
436 switch (ds1305->ctrl[2] & 0x03) {
437 case DS1305_TRICKLE_2K:
438 resistors = "2k Ohm";
439 break;
440 case DS1305_TRICKLE_4K:
441 resistors = "4k Ohm";
442 break;
443 case DS1305_TRICKLE_8K:
444 resistors = "8k Ohm";
445 break;
446 default:
447 diodes = "no";
448 break;
449 }
450 }
451
452done:
453 return seq_printf(seq,
454 "trickle_charge\t: %s%s\n",
455 diodes, resistors);
456}
457
458#else
459#define ds1305_proc NULL
460#endif
461
462static const struct rtc_class_ops ds1305_ops = {
463 .ioctl = ds1305_ioctl,
464 .read_time = ds1305_get_time,
465 .set_time = ds1305_set_time,
466 .read_alarm = ds1305_get_alarm,
467 .set_alarm = ds1305_set_alarm,
468 .proc = ds1305_proc,
469};
470
471static void ds1305_work(struct work_struct *work)
472{
473 struct ds1305 *ds1305 = container_of(work, struct ds1305, work);
474 struct mutex *lock = &ds1305->rtc->ops_lock;
475 struct spi_device *spi = ds1305->spi;
476 u8 buf[3];
477 int status;
478
479 /* lock to protect ds1305->ctrl */
480 mutex_lock(lock);
481
482 /* Disable the IRQ, and clear its status ... for now, we "know"
483 * that if more than one alarm is active, they're in sync.
484 * Note that reading ALM data registers also clears IRQ status.
485 */
486 ds1305->ctrl[0] &= ~(DS1305_AEI1 | DS1305_AEI0);
487 ds1305->ctrl[1] = 0;
488
489 buf[0] = DS1305_WRITE | DS1305_CONTROL;
490 buf[1] = ds1305->ctrl[0];
491 buf[2] = 0;
492
493 status = spi_write_then_read(spi, buf, sizeof buf,
494 NULL, 0);
495 if (status < 0)
496 dev_dbg(&spi->dev, "clear irq --> %d\n", status);
497
498 mutex_unlock(lock);
499
500 if (!test_bit(FLAG_EXITING, &ds1305->flags))
501 enable_irq(spi->irq);
502
David Brownell53e84b62008-07-23 21:30:36 -0700503 rtc_update_irq(ds1305->rtc, 1, RTC_AF | RTC_IRQF);
David Brownell53e84b62008-07-23 21:30:36 -0700504}
505
506/*
507 * This "real" IRQ handler hands off to a workqueue mostly to allow
508 * mutex locking for ds1305->ctrl ... unlike I2C, we could issue async
509 * I/O requests in IRQ context (to clear the IRQ status).
510 */
511static irqreturn_t ds1305_irq(int irq, void *p)
512{
513 struct ds1305 *ds1305 = p;
514
515 disable_irq(irq);
516 schedule_work(&ds1305->work);
517 return IRQ_HANDLED;
518}
519
520/*----------------------------------------------------------------------*/
521
522/*
523 * Interface for NVRAM
524 */
525
526static void msg_init(struct spi_message *m, struct spi_transfer *x,
527 u8 *addr, size_t count, char *tx, char *rx)
528{
529 spi_message_init(m);
530 memset(x, 0, 2 * sizeof(*x));
531
532 x->tx_buf = addr;
533 x->len = 1;
534 spi_message_add_tail(x, m);
535
536 x++;
537
538 x->tx_buf = tx;
539 x->rx_buf = rx;
540 x->len = count;
541 spi_message_add_tail(x, m);
542}
543
544static ssize_t
545ds1305_nvram_read(struct kobject *kobj, struct bin_attribute *attr,
546 char *buf, loff_t off, size_t count)
547{
548 struct spi_device *spi;
549 u8 addr;
550 struct spi_message m;
551 struct spi_transfer x[2];
552 int status;
553
554 spi = container_of(kobj, struct spi_device, dev.kobj);
555
556 if (unlikely(off >= DS1305_NVRAM_LEN))
557 return 0;
558 if (count >= DS1305_NVRAM_LEN)
559 count = DS1305_NVRAM_LEN;
560 if ((off + count) > DS1305_NVRAM_LEN)
561 count = DS1305_NVRAM_LEN - off;
562 if (unlikely(!count))
563 return count;
564
565 addr = DS1305_NVRAM + off;
566 msg_init(&m, x, &addr, count, NULL, buf);
567
568 status = spi_sync(spi, &m);
569 if (status < 0)
570 dev_err(&spi->dev, "nvram %s error %d\n", "read", status);
571 return (status < 0) ? status : count;
572}
573
574static ssize_t
575ds1305_nvram_write(struct kobject *kobj, struct bin_attribute *attr,
576 char *buf, loff_t off, size_t count)
577{
578 struct spi_device *spi;
579 u8 addr;
580 struct spi_message m;
581 struct spi_transfer x[2];
582 int status;
583
584 spi = container_of(kobj, struct spi_device, dev.kobj);
585
586 if (unlikely(off >= DS1305_NVRAM_LEN))
587 return -EFBIG;
588 if (count >= DS1305_NVRAM_LEN)
589 count = DS1305_NVRAM_LEN;
590 if ((off + count) > DS1305_NVRAM_LEN)
591 count = DS1305_NVRAM_LEN - off;
592 if (unlikely(!count))
593 return count;
594
595 addr = (DS1305_WRITE | DS1305_NVRAM) + off;
596 msg_init(&m, x, &addr, count, buf, NULL);
597
598 status = spi_sync(spi, &m);
599 if (status < 0)
600 dev_err(&spi->dev, "nvram %s error %d\n", "write", status);
601 return (status < 0) ? status : count;
602}
603
604static struct bin_attribute nvram = {
605 .attr.name = "nvram",
606 .attr.mode = S_IRUGO | S_IWUSR,
David Brownell53e84b62008-07-23 21:30:36 -0700607 .read = ds1305_nvram_read,
608 .write = ds1305_nvram_write,
609 .size = DS1305_NVRAM_LEN,
610};
611
612/*----------------------------------------------------------------------*/
613
614/*
615 * Interface to SPI stack
616 */
617
618static int __devinit ds1305_probe(struct spi_device *spi)
619{
620 struct ds1305 *ds1305;
David Brownell53e84b62008-07-23 21:30:36 -0700621 int status;
622 u8 addr, value;
623 struct ds1305_platform_data *pdata = spi->dev.platform_data;
624 bool write_ctrl = false;
625
626 /* Sanity check board setup data. This may be hooked up
627 * in 3wire mode, but we don't care. Note that unless
628 * there's an inverter in place, this needs SPI_CS_HIGH!
629 */
630 if ((spi->bits_per_word && spi->bits_per_word != 8)
631 || (spi->max_speed_hz > 2000000)
632 || !(spi->mode & SPI_CPHA))
633 return -EINVAL;
634
635 /* set up driver data */
636 ds1305 = kzalloc(sizeof *ds1305, GFP_KERNEL);
637 if (!ds1305)
638 return -ENOMEM;
639 ds1305->spi = spi;
640 spi_set_drvdata(spi, ds1305);
641
642 /* read and cache control registers */
643 addr = DS1305_CONTROL;
644 status = spi_write_then_read(spi, &addr, sizeof addr,
645 ds1305->ctrl, sizeof ds1305->ctrl);
646 if (status < 0) {
647 dev_dbg(&spi->dev, "can't %s, %d\n",
648 "read", status);
649 goto fail0;
650 }
651
652 dev_dbg(&spi->dev, "ctrl %s: %02x %02x %02x\n",
653 "read", ds1305->ctrl[0],
654 ds1305->ctrl[1], ds1305->ctrl[2]);
655
656 /* Sanity check register values ... partially compensating for the
657 * fact that SPI has no device handshake. A pullup on MISO would
658 * make these tests fail; but not all systems will have one. If
659 * some register is neither 0x00 nor 0xff, a chip is likely there.
660 */
661 if ((ds1305->ctrl[0] & 0x38) != 0 || (ds1305->ctrl[1] & 0xfc) != 0) {
662 dev_dbg(&spi->dev, "RTC chip is not present\n");
663 status = -ENODEV;
664 goto fail0;
665 }
666 if (ds1305->ctrl[2] == 0)
667 dev_dbg(&spi->dev, "chip may not be present\n");
668
669 /* enable writes if needed ... if we were paranoid it would
670 * make sense to enable them only when absolutely necessary.
671 */
672 if (ds1305->ctrl[0] & DS1305_WP) {
673 u8 buf[2];
674
675 ds1305->ctrl[0] &= ~DS1305_WP;
676
677 buf[0] = DS1305_WRITE | DS1305_CONTROL;
678 buf[1] = ds1305->ctrl[0];
679 status = spi_write_then_read(spi, buf, sizeof buf, NULL, 0);
680
681 dev_dbg(&spi->dev, "clear WP --> %d\n", status);
682 if (status < 0)
683 goto fail0;
684 }
685
686 /* on DS1305, maybe start oscillator; like most low power
687 * oscillators, it may take a second to stabilize
688 */
689 if (ds1305->ctrl[0] & DS1305_nEOSC) {
690 ds1305->ctrl[0] &= ~DS1305_nEOSC;
691 write_ctrl = true;
692 dev_warn(&spi->dev, "SET TIME!\n");
693 }
694
695 /* ack any pending IRQs */
696 if (ds1305->ctrl[1]) {
697 ds1305->ctrl[1] = 0;
698 write_ctrl = true;
699 }
700
701 /* this may need one-time (re)init */
702 if (pdata) {
703 /* maybe enable trickle charge */
704 if (((ds1305->ctrl[2] & 0xf0) != DS1305_TRICKLE_MAGIC)) {
705 ds1305->ctrl[2] = DS1305_TRICKLE_MAGIC
706 | pdata->trickle;
707 write_ctrl = true;
708 }
709
710 /* on DS1306, configure 1 Hz signal */
711 if (pdata->is_ds1306) {
712 if (pdata->en_1hz) {
713 if (!(ds1305->ctrl[0] & DS1306_1HZ)) {
714 ds1305->ctrl[0] |= DS1306_1HZ;
715 write_ctrl = true;
716 }
717 } else {
718 if (ds1305->ctrl[0] & DS1306_1HZ) {
719 ds1305->ctrl[0] &= ~DS1306_1HZ;
720 write_ctrl = true;
721 }
722 }
723 }
724 }
725
726 if (write_ctrl) {
727 u8 buf[4];
728
729 buf[0] = DS1305_WRITE | DS1305_CONTROL;
730 buf[1] = ds1305->ctrl[0];
731 buf[2] = ds1305->ctrl[1];
732 buf[3] = ds1305->ctrl[2];
733 status = spi_write_then_read(spi, buf, sizeof buf, NULL, 0);
734 if (status < 0) {
735 dev_dbg(&spi->dev, "can't %s, %d\n",
736 "write", status);
737 goto fail0;
738 }
739
740 dev_dbg(&spi->dev, "ctrl %s: %02x %02x %02x\n",
741 "write", ds1305->ctrl[0],
742 ds1305->ctrl[1], ds1305->ctrl[2]);
743 }
744
745 /* see if non-Linux software set up AM/PM mode */
746 addr = DS1305_HOUR;
747 status = spi_write_then_read(spi, &addr, sizeof addr,
748 &value, sizeof value);
749 if (status < 0) {
750 dev_dbg(&spi->dev, "read HOUR --> %d\n", status);
751 goto fail0;
752 }
753
754 ds1305->hr12 = (DS1305_HR_12 & value) != 0;
755 if (ds1305->hr12)
756 dev_dbg(&spi->dev, "AM/PM\n");
757
758 /* register RTC ... from here on, ds1305->ctrl needs locking */
Alessandro Zummob74d2ca2009-12-15 16:45:53 -0800759 ds1305->rtc = rtc_device_register("ds1305", &spi->dev,
David Brownell53e84b62008-07-23 21:30:36 -0700760 &ds1305_ops, THIS_MODULE);
Alessandro Zummob74d2ca2009-12-15 16:45:53 -0800761 if (IS_ERR(ds1305->rtc)) {
762 status = PTR_ERR(ds1305->rtc);
David Brownell53e84b62008-07-23 21:30:36 -0700763 dev_dbg(&spi->dev, "register rtc --> %d\n", status);
764 goto fail0;
765 }
David Brownell53e84b62008-07-23 21:30:36 -0700766
767 /* Maybe set up alarm IRQ; be ready to handle it triggering right
768 * away. NOTE that we don't share this. The signal is active low,
769 * and we can't ack it before a SPI message delay. We temporarily
770 * disable the IRQ until it's acked, which lets us work with more
771 * IRQ trigger modes (not all IRQ controllers can do falling edge).
772 */
773 if (spi->irq) {
774 INIT_WORK(&ds1305->work, ds1305_work);
775 status = request_irq(spi->irq, ds1305_irq,
Alessandro Zummob74d2ca2009-12-15 16:45:53 -0800776 0, dev_name(&ds1305->rtc->dev), ds1305);
David Brownell53e84b62008-07-23 21:30:36 -0700777 if (status < 0) {
778 dev_dbg(&spi->dev, "request_irq %d --> %d\n",
779 spi->irq, status);
780 goto fail1;
781 }
Anton Vorontsov26b3c012009-12-17 15:27:23 -0800782
783 device_set_wakeup_capable(&spi->dev, 1);
David Brownell53e84b62008-07-23 21:30:36 -0700784 }
785
786 /* export NVRAM */
787 status = sysfs_create_bin_file(&spi->dev.kobj, &nvram);
788 if (status < 0) {
789 dev_dbg(&spi->dev, "register nvram --> %d\n", status);
790 goto fail2;
791 }
792
793 return 0;
794
795fail2:
796 free_irq(spi->irq, ds1305);
797fail1:
Alessandro Zummob74d2ca2009-12-15 16:45:53 -0800798 rtc_device_unregister(ds1305->rtc);
David Brownell53e84b62008-07-23 21:30:36 -0700799fail0:
800 kfree(ds1305);
801 return status;
802}
803
804static int __devexit ds1305_remove(struct spi_device *spi)
805{
Alessandro Zummob74d2ca2009-12-15 16:45:53 -0800806 struct ds1305 *ds1305 = spi_get_drvdata(spi);
David Brownell53e84b62008-07-23 21:30:36 -0700807
808 sysfs_remove_bin_file(&spi->dev.kobj, &nvram);
809
810 /* carefully shut down irq and workqueue, if present */
811 if (spi->irq) {
812 set_bit(FLAG_EXITING, &ds1305->flags);
813 free_irq(spi->irq, ds1305);
814 flush_scheduled_work();
815 }
816
817 rtc_device_unregister(ds1305->rtc);
818 spi_set_drvdata(spi, NULL);
819 kfree(ds1305);
820 return 0;
821}
822
823static struct spi_driver ds1305_driver = {
824 .driver.name = "rtc-ds1305",
825 .driver.owner = THIS_MODULE,
826 .probe = ds1305_probe,
827 .remove = __devexit_p(ds1305_remove),
828 /* REVISIT add suspend/resume */
829};
830
831static int __init ds1305_init(void)
832{
833 return spi_register_driver(&ds1305_driver);
834}
835module_init(ds1305_init);
836
837static void __exit ds1305_exit(void)
838{
839 spi_unregister_driver(&ds1305_driver);
840}
841module_exit(ds1305_exit);
842
843MODULE_DESCRIPTION("RTC driver for DS1305 and DS1306 chips");
844MODULE_LICENSE("GPL");
Anton Vorontsove0626e32009-09-22 16:46:08 -0700845MODULE_ALIAS("spi:rtc-ds1305");