2 * SuperH On-Chip RTC Support
4 * Copyright (C) 2006 - 2009 Paul Mundt
5 * Copyright (C) 2006 Jamie Lenehan
6 * Copyright (C) 2008 Angelo Castello
8 * Based on the old arch/sh/kernel/cpu/rtc.c by:
11 * Copyright (C) 1999 Tetsuya Okada & Niibe Yutaka
13 * This file is subject to the terms and conditions of the GNU General Public
14 * License. See the file "COPYING" in the main directory of this archive
17 #include <linux/module.h>
18 #include <linux/kernel.h>
19 #include <linux/bcd.h>
20 #include <linux/rtc.h>
21 #include <linux/init.h>
22 #include <linux/platform_device.h>
23 #include <linux/seq_file.h>
24 #include <linux/interrupt.h>
25 #include <linux/spinlock.h>
27 #include <linux/log2.h>
28 #include <linux/clk.h>
29 #include <linux/slab.h>
33 /* Default values for RZ/A RTC */
34 #define rtc_reg_size sizeof(u16)
35 #define RTC_BIT_INVERTED 0 /* no chip bugs */
36 #define RTC_CAP_4_DIGIT_YEAR (1 << 0)
37 #define RTC_DEF_CAPABILITIES RTC_CAP_4_DIGIT_YEAR
40 #define DRV_NAME "sh-rtc"
42 #define RTC_REG(r) ((r) * rtc_reg_size)
44 #define R64CNT RTC_REG(0)
46 #define RSECCNT RTC_REG(1) /* RTC sec */
47 #define RMINCNT RTC_REG(2) /* RTC min */
48 #define RHRCNT RTC_REG(3) /* RTC hour */
49 #define RWKCNT RTC_REG(4) /* RTC week */
50 #define RDAYCNT RTC_REG(5) /* RTC day */
51 #define RMONCNT RTC_REG(6) /* RTC month */
52 #define RYRCNT RTC_REG(7) /* RTC year */
53 #define RSECAR RTC_REG(8) /* ALARM sec */
54 #define RMINAR RTC_REG(9) /* ALARM min */
55 #define RHRAR RTC_REG(10) /* ALARM hour */
56 #define RWKAR RTC_REG(11) /* ALARM week */
57 #define RDAYAR RTC_REG(12) /* ALARM day */
58 #define RMONAR RTC_REG(13) /* ALARM month */
59 #define RCR1 RTC_REG(14) /* Control */
60 #define RCR2 RTC_REG(15) /* Control */
63 * Note on RYRAR and RCR3: Up until this point most of the register
64 * definitions are consistent across all of the available parts. However,
65 * the placement of the optional RYRAR and RCR3 (the RYRAR control
66 * register used to control RYRCNT/RYRAR compare) varies considerably
67 * across various parts, occasionally being mapped in to a completely
68 * unrelated address space. For proper RYRAR support a separate resource
69 * would have to be handed off, but as this is purely optional in
70 * practice, we simply opt not to support it, thereby keeping the code
71 * quite a bit more simplified.
74 /* ALARM Bits - or with BCD encoded value */
75 #define AR_ENB 0x80 /* Enable for alarm cmp */
78 #define PF_HP 0x100 /* Enable Half Period to support 8,32,128Hz */
79 #define PF_COUNT 0x200 /* Half periodic counter */
80 #define PF_OXS 0x400 /* Periodic One x Second */
81 #define PF_KOU 0x800 /* Kernel or User periodic request 1=kernel */
85 #define RCR1_CF 0x80 /* Carry Flag */
86 #define RCR1_CIE 0x10 /* Carry Interrupt Enable */
87 #define RCR1_AIE 0x08 /* Alarm Interrupt Enable */
88 #define RCR1_AF 0x01 /* Alarm Flag */
91 #define RCR2_PEF 0x80 /* PEriodic interrupt Flag */
92 #define RCR2_PESMASK 0x70 /* Periodic interrupt Set */
93 #define RCR2_RTCEN 0x08 /* ENable RTC */
94 #define RCR2_ADJ 0x04 /* ADJustment (30-second) */
95 #define RCR2_RESET 0x02 /* Reset bit */
96 #define RCR2_START 0x01 /* Start bit */
99 void __iomem *regbase;
100 unsigned long regsize;
101 struct resource *res;
106 struct rtc_device *rtc_dev;
108 unsigned long capabilities; /* See asm/rtc.h for cap bits */
109 unsigned short periodic_freq;
112 static int __sh_rtc_interrupt(struct sh_rtc *rtc)
114 unsigned int tmp, pending;
116 tmp = readb(rtc->regbase + RCR1);
117 pending = tmp & RCR1_CF;
119 writeb(tmp, rtc->regbase + RCR1);
121 /* Users have requested One x Second IRQ */
122 if (pending && rtc->periodic_freq & PF_OXS)
123 rtc_update_irq(rtc->rtc_dev, 1, RTC_UF | RTC_IRQF);
128 static int __sh_rtc_alarm(struct sh_rtc *rtc)
130 unsigned int tmp, pending;
132 tmp = readb(rtc->regbase + RCR1);
133 pending = tmp & RCR1_AF;
134 tmp &= ~(RCR1_AF | RCR1_AIE);
135 writeb(tmp, rtc->regbase + RCR1);
138 rtc_update_irq(rtc->rtc_dev, 1, RTC_AF | RTC_IRQF);
143 static int __sh_rtc_periodic(struct sh_rtc *rtc)
145 struct rtc_device *rtc_dev = rtc->rtc_dev;
146 struct rtc_task *irq_task;
147 unsigned int tmp, pending;
149 tmp = readb(rtc->regbase + RCR2);
150 pending = tmp & RCR2_PEF;
152 writeb(tmp, rtc->regbase + RCR2);
157 /* Half period enabled than one skipped and the next notified */
158 if ((rtc->periodic_freq & PF_HP) && (rtc->periodic_freq & PF_COUNT))
159 rtc->periodic_freq &= ~PF_COUNT;
161 if (rtc->periodic_freq & PF_HP)
162 rtc->periodic_freq |= PF_COUNT;
163 if (rtc->periodic_freq & PF_KOU) {
164 spin_lock(&rtc_dev->irq_task_lock);
165 irq_task = rtc_dev->irq_task;
167 irq_task->func(irq_task->private_data);
168 spin_unlock(&rtc_dev->irq_task_lock);
170 rtc_update_irq(rtc->rtc_dev, 1, RTC_PF | RTC_IRQF);
176 static irqreturn_t sh_rtc_interrupt(int irq, void *dev_id)
178 struct sh_rtc *rtc = dev_id;
181 spin_lock(&rtc->lock);
182 ret = __sh_rtc_interrupt(rtc);
183 spin_unlock(&rtc->lock);
185 return IRQ_RETVAL(ret);
188 static irqreturn_t sh_rtc_alarm(int irq, void *dev_id)
190 struct sh_rtc *rtc = dev_id;
193 spin_lock(&rtc->lock);
194 ret = __sh_rtc_alarm(rtc);
195 spin_unlock(&rtc->lock);
197 return IRQ_RETVAL(ret);
200 static irqreturn_t sh_rtc_periodic(int irq, void *dev_id)
202 struct sh_rtc *rtc = dev_id;
205 spin_lock(&rtc->lock);
206 ret = __sh_rtc_periodic(rtc);
207 spin_unlock(&rtc->lock);
209 return IRQ_RETVAL(ret);
212 static irqreturn_t sh_rtc_shared(int irq, void *dev_id)
214 struct sh_rtc *rtc = dev_id;
217 spin_lock(&rtc->lock);
218 ret = __sh_rtc_interrupt(rtc);
219 ret |= __sh_rtc_alarm(rtc);
220 ret |= __sh_rtc_periodic(rtc);
221 spin_unlock(&rtc->lock);
223 return IRQ_RETVAL(ret);
226 static int sh_rtc_irq_set_state(struct device *dev, int enable)
228 struct sh_rtc *rtc = dev_get_drvdata(dev);
231 spin_lock_irq(&rtc->lock);
233 tmp = readb(rtc->regbase + RCR2);
236 rtc->periodic_freq |= PF_KOU;
237 tmp &= ~RCR2_PEF; /* Clear PES bit */
238 tmp |= (rtc->periodic_freq & ~PF_HP); /* Set PES2-0 */
240 rtc->periodic_freq &= ~PF_KOU;
241 tmp &= ~(RCR2_PESMASK | RCR2_PEF);
244 writeb(tmp, rtc->regbase + RCR2);
246 spin_unlock_irq(&rtc->lock);
251 static int sh_rtc_irq_set_freq(struct device *dev, int freq)
253 struct sh_rtc *rtc = dev_get_drvdata(dev);
256 spin_lock_irq(&rtc->lock);
257 tmp = rtc->periodic_freq & PF_MASK;
261 rtc->periodic_freq = 0x00;
264 rtc->periodic_freq = 0x60;
267 rtc->periodic_freq = 0x50;
270 rtc->periodic_freq = 0x40;
273 rtc->periodic_freq = 0x30 | PF_HP;
276 rtc->periodic_freq = 0x30;
279 rtc->periodic_freq = 0x20 | PF_HP;
282 rtc->periodic_freq = 0x20;
285 rtc->periodic_freq = 0x10 | PF_HP;
288 rtc->periodic_freq = 0x10;
295 rtc->periodic_freq |= tmp;
297 spin_unlock_irq(&rtc->lock);
301 static inline void sh_rtc_setaie(struct device *dev, unsigned int enable)
303 struct sh_rtc *rtc = dev_get_drvdata(dev);
306 spin_lock_irq(&rtc->lock);
308 tmp = readb(rtc->regbase + RCR1);
315 writeb(tmp, rtc->regbase + RCR1);
317 spin_unlock_irq(&rtc->lock);
320 static int sh_rtc_proc(struct device *dev, struct seq_file *seq)
322 struct sh_rtc *rtc = dev_get_drvdata(dev);
325 tmp = readb(rtc->regbase + RCR1);
326 seq_printf(seq, "carry_IRQ\t: %s\n", (tmp & RCR1_CIE) ? "yes" : "no");
328 tmp = readb(rtc->regbase + RCR2);
329 seq_printf(seq, "periodic_IRQ\t: %s\n",
330 (tmp & RCR2_PESMASK) ? "yes" : "no");
335 static inline void sh_rtc_setcie(struct device *dev, unsigned int enable)
337 struct sh_rtc *rtc = dev_get_drvdata(dev);
340 spin_lock_irq(&rtc->lock);
342 tmp = readb(rtc->regbase + RCR1);
349 writeb(tmp, rtc->regbase + RCR1);
351 spin_unlock_irq(&rtc->lock);
354 static int sh_rtc_alarm_irq_enable(struct device *dev, unsigned int enabled)
356 sh_rtc_setaie(dev, enabled);
360 static int sh_rtc_read_time(struct device *dev, struct rtc_time *tm)
362 struct sh_rtc *rtc = dev_get_drvdata(dev);
363 unsigned int sec128, sec2, yr, yr100, cf_bit;
368 spin_lock_irq(&rtc->lock);
370 tmp = readb(rtc->regbase + RCR1);
371 tmp &= ~RCR1_CF; /* Clear CF-bit */
373 writeb(tmp, rtc->regbase + RCR1);
375 sec128 = readb(rtc->regbase + R64CNT);
377 tm->tm_sec = bcd2bin(readb(rtc->regbase + RSECCNT));
378 tm->tm_min = bcd2bin(readb(rtc->regbase + RMINCNT));
379 tm->tm_hour = bcd2bin(readb(rtc->regbase + RHRCNT));
380 tm->tm_wday = bcd2bin(readb(rtc->regbase + RWKCNT));
381 tm->tm_mday = bcd2bin(readb(rtc->regbase + RDAYCNT));
382 tm->tm_mon = bcd2bin(readb(rtc->regbase + RMONCNT)) - 1;
384 if (rtc->capabilities & RTC_CAP_4_DIGIT_YEAR) {
385 yr = readw(rtc->regbase + RYRCNT);
386 yr100 = bcd2bin(yr >> 8);
389 yr = readb(rtc->regbase + RYRCNT);
390 yr100 = bcd2bin((yr == 0x99) ? 0x19 : 0x20);
393 tm->tm_year = (yr100 * 100 + bcd2bin(yr)) - 1900;
395 sec2 = readb(rtc->regbase + R64CNT);
396 cf_bit = readb(rtc->regbase + RCR1) & RCR1_CF;
398 spin_unlock_irq(&rtc->lock);
399 } while (cf_bit != 0 || ((sec128 ^ sec2) & RTC_BIT_INVERTED) != 0);
401 #if RTC_BIT_INVERTED != 0
402 if ((sec128 & RTC_BIT_INVERTED))
406 /* only keep the carry interrupt enabled if UIE is on */
407 if (!(rtc->periodic_freq & PF_OXS))
408 sh_rtc_setcie(dev, 0);
410 dev_dbg(dev, "%s: tm is secs=%d, mins=%d, hours=%d, "
411 "mday=%d, mon=%d, year=%d, wday=%d\n",
413 tm->tm_sec, tm->tm_min, tm->tm_hour,
414 tm->tm_mday, tm->tm_mon + 1, tm->tm_year, tm->tm_wday);
419 static int sh_rtc_set_time(struct device *dev, struct rtc_time *tm)
421 struct sh_rtc *rtc = dev_get_drvdata(dev);
425 spin_lock_irq(&rtc->lock);
427 /* Reset pre-scaler & stop RTC */
428 tmp = readb(rtc->regbase + RCR2);
431 writeb(tmp, rtc->regbase + RCR2);
433 writeb(bin2bcd(tm->tm_sec), rtc->regbase + RSECCNT);
434 writeb(bin2bcd(tm->tm_min), rtc->regbase + RMINCNT);
435 writeb(bin2bcd(tm->tm_hour), rtc->regbase + RHRCNT);
436 writeb(bin2bcd(tm->tm_wday), rtc->regbase + RWKCNT);
437 writeb(bin2bcd(tm->tm_mday), rtc->regbase + RDAYCNT);
438 writeb(bin2bcd(tm->tm_mon + 1), rtc->regbase + RMONCNT);
440 if (rtc->capabilities & RTC_CAP_4_DIGIT_YEAR) {
441 year = (bin2bcd((tm->tm_year + 1900) / 100) << 8) |
442 bin2bcd(tm->tm_year % 100);
443 writew(year, rtc->regbase + RYRCNT);
445 year = tm->tm_year % 100;
446 writeb(bin2bcd(year), rtc->regbase + RYRCNT);
450 tmp = readb(rtc->regbase + RCR2);
452 tmp |= RCR2_RTCEN | RCR2_START;
453 writeb(tmp, rtc->regbase + RCR2);
455 spin_unlock_irq(&rtc->lock);
460 static inline int sh_rtc_read_alarm_value(struct sh_rtc *rtc, int reg_off)
463 int value = 0xff; /* return 0xff for ignored values */
465 byte = readb(rtc->regbase + reg_off);
467 byte &= ~AR_ENB; /* strip the enable bit */
468 value = bcd2bin(byte);
474 static int sh_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *wkalrm)
476 struct sh_rtc *rtc = dev_get_drvdata(dev);
477 struct rtc_time *tm = &wkalrm->time;
479 spin_lock_irq(&rtc->lock);
481 tm->tm_sec = sh_rtc_read_alarm_value(rtc, RSECAR);
482 tm->tm_min = sh_rtc_read_alarm_value(rtc, RMINAR);
483 tm->tm_hour = sh_rtc_read_alarm_value(rtc, RHRAR);
484 tm->tm_wday = sh_rtc_read_alarm_value(rtc, RWKAR);
485 tm->tm_mday = sh_rtc_read_alarm_value(rtc, RDAYAR);
486 tm->tm_mon = sh_rtc_read_alarm_value(rtc, RMONAR);
488 tm->tm_mon -= 1; /* RTC is 1-12, tm_mon is 0-11 */
490 wkalrm->enabled = (readb(rtc->regbase + RCR1) & RCR1_AIE) ? 1 : 0;
492 spin_unlock_irq(&rtc->lock);
497 static inline void sh_rtc_write_alarm_value(struct sh_rtc *rtc,
498 int value, int reg_off)
500 /* < 0 for a value that is ignored */
502 writeb(0, rtc->regbase + reg_off);
504 writeb(bin2bcd(value) | AR_ENB, rtc->regbase + reg_off);
507 static int sh_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *wkalrm)
509 struct sh_rtc *rtc = dev_get_drvdata(dev);
511 struct rtc_time *tm = &wkalrm->time;
514 spin_lock_irq(&rtc->lock);
516 /* disable alarm interrupt and clear the alarm flag */
517 rcr1 = readb(rtc->regbase + RCR1);
518 rcr1 &= ~(RCR1_AF | RCR1_AIE);
519 writeb(rcr1, rtc->regbase + RCR1);
522 sh_rtc_write_alarm_value(rtc, tm->tm_sec, RSECAR);
523 sh_rtc_write_alarm_value(rtc, tm->tm_min, RMINAR);
524 sh_rtc_write_alarm_value(rtc, tm->tm_hour, RHRAR);
525 sh_rtc_write_alarm_value(rtc, tm->tm_wday, RWKAR);
526 sh_rtc_write_alarm_value(rtc, tm->tm_mday, RDAYAR);
530 sh_rtc_write_alarm_value(rtc, mon, RMONAR);
532 if (wkalrm->enabled) {
534 writeb(rcr1, rtc->regbase + RCR1);
537 spin_unlock_irq(&rtc->lock);
542 static const struct rtc_class_ops sh_rtc_ops = {
543 .read_time = sh_rtc_read_time,
544 .set_time = sh_rtc_set_time,
545 .read_alarm = sh_rtc_read_alarm,
546 .set_alarm = sh_rtc_set_alarm,
548 .alarm_irq_enable = sh_rtc_alarm_irq_enable,
551 static int __init sh_rtc_probe(struct platform_device *pdev)
554 struct resource *res;
559 rtc = devm_kzalloc(&pdev->dev, sizeof(*rtc), GFP_KERNEL);
563 spin_lock_init(&rtc->lock);
565 /* get periodic/carry/alarm irqs */
566 ret = platform_get_irq(pdev, 0);
567 if (unlikely(ret <= 0)) {
568 dev_err(&pdev->dev, "No IRQ resource\n");
572 rtc->periodic_irq = ret;
573 rtc->carry_irq = platform_get_irq(pdev, 1);
574 rtc->alarm_irq = platform_get_irq(pdev, 2);
576 res = platform_get_resource(pdev, IORESOURCE_IO, 0);
578 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
579 if (unlikely(res == NULL)) {
580 dev_err(&pdev->dev, "No IO resource\n");
584 rtc->regsize = resource_size(res);
586 rtc->res = devm_request_mem_region(&pdev->dev, res->start,
587 rtc->regsize, pdev->name);
588 if (unlikely(!rtc->res))
591 rtc->regbase = devm_ioremap_nocache(&pdev->dev, rtc->res->start,
593 if (unlikely(!rtc->regbase))
596 if (!pdev->dev.of_node) {
598 /* With a single device, the clock id is still "rtc0" */
602 snprintf(clk_name, sizeof(clk_name), "rtc%d", clk_id);
604 snprintf(clk_name, sizeof(clk_name), "fck");
606 rtc->clk = devm_clk_get(&pdev->dev, clk_name);
607 if (IS_ERR(rtc->clk)) {
609 * No error handling for rtc->clk intentionally, not all
610 * platforms will have a unique clock for the RTC, and
611 * the clk API can handle the struct clk pointer being
617 clk_enable(rtc->clk);
619 rtc->capabilities = RTC_DEF_CAPABILITIES;
622 if (dev_get_platdata(&pdev->dev)) {
623 struct sh_rtc_platform_info *pinfo =
624 dev_get_platdata(&pdev->dev);
627 * Some CPUs have special capabilities in addition to the
628 * default set. Add those in here.
630 rtc->capabilities |= pinfo->capabilities;
634 if (rtc->carry_irq <= 0) {
635 /* register shared periodic/carry/alarm irq */
636 ret = devm_request_irq(&pdev->dev, rtc->periodic_irq,
637 sh_rtc_shared, 0, "sh-rtc", rtc);
640 "request IRQ failed with %d, IRQ %d\n", ret,
645 /* register periodic/carry/alarm irqs */
646 ret = devm_request_irq(&pdev->dev, rtc->periodic_irq,
647 sh_rtc_periodic, 0, "sh-rtc period", rtc);
650 "request period IRQ failed with %d, IRQ %d\n",
651 ret, rtc->periodic_irq);
655 ret = devm_request_irq(&pdev->dev, rtc->carry_irq,
656 sh_rtc_interrupt, 0, "sh-rtc carry", rtc);
659 "request carry IRQ failed with %d, IRQ %d\n",
660 ret, rtc->carry_irq);
664 ret = devm_request_irq(&pdev->dev, rtc->alarm_irq,
665 sh_rtc_alarm, 0, "sh-rtc alarm", rtc);
668 "request alarm IRQ failed with %d, IRQ %d\n",
669 ret, rtc->alarm_irq);
674 platform_set_drvdata(pdev, rtc);
676 /* everything disabled by default */
677 sh_rtc_irq_set_freq(&pdev->dev, 0);
678 sh_rtc_irq_set_state(&pdev->dev, 0);
679 sh_rtc_setaie(&pdev->dev, 0);
680 sh_rtc_setcie(&pdev->dev, 0);
682 rtc->rtc_dev = devm_rtc_device_register(&pdev->dev, "sh",
683 &sh_rtc_ops, THIS_MODULE);
684 if (IS_ERR(rtc->rtc_dev)) {
685 ret = PTR_ERR(rtc->rtc_dev);
689 rtc->rtc_dev->max_user_freq = 256;
691 /* reset rtc to epoch 0 if time is invalid */
692 if (rtc_read_time(rtc->rtc_dev, &r) < 0) {
693 rtc_time_to_tm(0, &r);
694 rtc_set_time(rtc->rtc_dev, &r);
697 device_init_wakeup(&pdev->dev, 1);
701 clk_disable(rtc->clk);
706 static int __exit sh_rtc_remove(struct platform_device *pdev)
708 struct sh_rtc *rtc = platform_get_drvdata(pdev);
710 sh_rtc_irq_set_state(&pdev->dev, 0);
712 sh_rtc_setaie(&pdev->dev, 0);
713 sh_rtc_setcie(&pdev->dev, 0);
715 clk_disable(rtc->clk);
720 static void sh_rtc_set_irq_wake(struct device *dev, int enabled)
722 struct sh_rtc *rtc = dev_get_drvdata(dev);
724 irq_set_irq_wake(rtc->periodic_irq, enabled);
726 if (rtc->carry_irq > 0) {
727 irq_set_irq_wake(rtc->carry_irq, enabled);
728 irq_set_irq_wake(rtc->alarm_irq, enabled);
732 static int __maybe_unused sh_rtc_suspend(struct device *dev)
734 if (device_may_wakeup(dev))
735 sh_rtc_set_irq_wake(dev, 1);
740 static int __maybe_unused sh_rtc_resume(struct device *dev)
742 if (device_may_wakeup(dev))
743 sh_rtc_set_irq_wake(dev, 0);
748 static SIMPLE_DEV_PM_OPS(sh_rtc_pm_ops, sh_rtc_suspend, sh_rtc_resume);
750 static const struct of_device_id sh_rtc_of_match[] = {
751 { .compatible = "renesas,sh-rtc", },
754 MODULE_DEVICE_TABLE(of, sh_rtc_of_match);
756 static struct platform_driver sh_rtc_platform_driver = {
759 .pm = &sh_rtc_pm_ops,
760 .of_match_table = sh_rtc_of_match,
762 .remove = __exit_p(sh_rtc_remove),
765 module_platform_driver_probe(sh_rtc_platform_driver, sh_rtc_probe);
767 MODULE_DESCRIPTION("SuperH on-chip RTC driver");
771 MODULE_LICENSE("GPL");
772 MODULE_ALIAS("platform:" DRV_NAME);