2 * Copyright (C) 2017 Spreadtrum Communications Inc.
4 * SPDX-License-Identifier: GPL-2.0
7 #include <linux/bitops.h>
8 #include <linux/delay.h>
10 #include <linux/module.h>
12 #include <linux/platform_device.h>
13 #include <linux/regmap.h>
14 #include <linux/rtc.h>
16 #define SPRD_RTC_SEC_CNT_VALUE 0x0
17 #define SPRD_RTC_MIN_CNT_VALUE 0x4
18 #define SPRD_RTC_HOUR_CNT_VALUE 0x8
19 #define SPRD_RTC_DAY_CNT_VALUE 0xc
20 #define SPRD_RTC_SEC_CNT_UPD 0x10
21 #define SPRD_RTC_MIN_CNT_UPD 0x14
22 #define SPRD_RTC_HOUR_CNT_UPD 0x18
23 #define SPRD_RTC_DAY_CNT_UPD 0x1c
24 #define SPRD_RTC_SEC_ALM_UPD 0x20
25 #define SPRD_RTC_MIN_ALM_UPD 0x24
26 #define SPRD_RTC_HOUR_ALM_UPD 0x28
27 #define SPRD_RTC_DAY_ALM_UPD 0x2c
28 #define SPRD_RTC_INT_EN 0x30
29 #define SPRD_RTC_INT_RAW_STS 0x34
30 #define SPRD_RTC_INT_CLR 0x38
31 #define SPRD_RTC_INT_MASK_STS 0x3C
32 #define SPRD_RTC_SEC_ALM_VALUE 0x40
33 #define SPRD_RTC_MIN_ALM_VALUE 0x44
34 #define SPRD_RTC_HOUR_ALM_VALUE 0x48
35 #define SPRD_RTC_DAY_ALM_VALUE 0x4c
36 #define SPRD_RTC_SPG_VALUE 0x50
37 #define SPRD_RTC_SPG_UPD 0x54
38 #define SPRD_RTC_PWR_CTRL 0x58
39 #define SPRD_RTC_PWR_STS 0x5c
40 #define SPRD_RTC_SEC_AUXALM_UPD 0x60
41 #define SPRD_RTC_MIN_AUXALM_UPD 0x64
42 #define SPRD_RTC_HOUR_AUXALM_UPD 0x68
43 #define SPRD_RTC_DAY_AUXALM_UPD 0x6c
45 /* BIT & MASK definition for SPRD_RTC_INT_* registers */
46 #define SPRD_RTC_SEC_EN BIT(0)
47 #define SPRD_RTC_MIN_EN BIT(1)
48 #define SPRD_RTC_HOUR_EN BIT(2)
49 #define SPRD_RTC_DAY_EN BIT(3)
50 #define SPRD_RTC_ALARM_EN BIT(4)
51 #define SPRD_RTC_HRS_FORMAT_EN BIT(5)
52 #define SPRD_RTC_AUXALM_EN BIT(6)
53 #define SPRD_RTC_SPG_UPD_EN BIT(7)
54 #define SPRD_RTC_SEC_UPD_EN BIT(8)
55 #define SPRD_RTC_MIN_UPD_EN BIT(9)
56 #define SPRD_RTC_HOUR_UPD_EN BIT(10)
57 #define SPRD_RTC_DAY_UPD_EN BIT(11)
58 #define SPRD_RTC_ALMSEC_UPD_EN BIT(12)
59 #define SPRD_RTC_ALMMIN_UPD_EN BIT(13)
60 #define SPRD_RTC_ALMHOUR_UPD_EN BIT(14)
61 #define SPRD_RTC_ALMDAY_UPD_EN BIT(15)
62 #define SPRD_RTC_INT_MASK GENMASK(15, 0)
64 #define SPRD_RTC_TIME_INT_MASK \
65 (SPRD_RTC_SEC_UPD_EN | SPRD_RTC_MIN_UPD_EN | \
66 SPRD_RTC_HOUR_UPD_EN | SPRD_RTC_DAY_UPD_EN)
68 #define SPRD_RTC_ALMTIME_INT_MASK \
69 (SPRD_RTC_ALMSEC_UPD_EN | SPRD_RTC_ALMMIN_UPD_EN | \
70 SPRD_RTC_ALMHOUR_UPD_EN | SPRD_RTC_ALMDAY_UPD_EN)
72 #define SPRD_RTC_ALM_INT_MASK \
73 (SPRD_RTC_SEC_EN | SPRD_RTC_MIN_EN | \
74 SPRD_RTC_HOUR_EN | SPRD_RTC_DAY_EN | \
75 SPRD_RTC_ALARM_EN | SPRD_RTC_AUXALM_EN)
77 /* second/minute/hour/day values mask definition */
78 #define SPRD_RTC_SEC_MASK GENMASK(5, 0)
79 #define SPRD_RTC_MIN_MASK GENMASK(5, 0)
80 #define SPRD_RTC_HOUR_MASK GENMASK(4, 0)
81 #define SPRD_RTC_DAY_MASK GENMASK(15, 0)
83 /* alarm lock definition for SPRD_RTC_SPG_UPD register */
84 #define SPRD_RTC_ALMLOCK_MASK GENMASK(7, 0)
85 #define SPRD_RTC_ALM_UNLOCK 0xa5
86 #define SPRD_RTC_ALM_LOCK (~SPRD_RTC_ALM_UNLOCK & \
87 SPRD_RTC_ALMLOCK_MASK)
89 /* SPG values definition for SPRD_RTC_SPG_UPD register */
90 #define SPRD_RTC_POWEROFF_ALM_FLAG BIT(8)
92 /* power control/status definition */
93 #define SPRD_RTC_POWER_RESET_VALUE 0x96
94 #define SPRD_RTC_POWER_STS_CLEAR GENMASK(7, 0)
95 #define SPRD_RTC_POWER_STS_SHIFT 8
96 #define SPRD_RTC_POWER_STS_VALID \
97 (~SPRD_RTC_POWER_RESET_VALUE << SPRD_RTC_POWER_STS_SHIFT)
99 /* timeout of synchronizing time and alarm registers (us) */
100 #define SPRD_RTC_POLL_TIMEOUT 200000
101 #define SPRD_RTC_POLL_DELAY_US 20000
104 struct rtc_device *rtc;
105 struct regmap *regmap;
113 * The Spreadtrum RTC controller has 3 groups registers, including time, normal
114 * alarm and auxiliary alarm. The time group registers are used to set RTC time,
115 * the normal alarm registers are used to set normal alarm, and the auxiliary
116 * alarm registers are used to set auxiliary alarm. Both alarm event and
117 * auxiliary alarm event can wake up system from deep sleep, but only alarm
118 * event can power up system from power down status.
120 enum sprd_rtc_reg_types {
126 static int sprd_rtc_clear_alarm_ints(struct sprd_rtc *rtc)
128 return regmap_write(rtc->regmap, rtc->base + SPRD_RTC_INT_CLR,
129 SPRD_RTC_ALM_INT_MASK);
132 static int sprd_rtc_lock_alarm(struct sprd_rtc *rtc, bool lock)
137 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_SPG_VALUE, &val);
141 val &= ~SPRD_RTC_ALMLOCK_MASK;
143 val |= SPRD_RTC_ALM_LOCK;
145 val |= SPRD_RTC_ALM_UNLOCK | SPRD_RTC_POWEROFF_ALM_FLAG;
147 ret = regmap_write(rtc->regmap, rtc->base + SPRD_RTC_SPG_UPD, val);
151 /* wait until the SPG value is updated successfully */
152 ret = regmap_read_poll_timeout(rtc->regmap,
153 rtc->base + SPRD_RTC_INT_RAW_STS, val,
154 (val & SPRD_RTC_SPG_UPD_EN),
155 SPRD_RTC_POLL_DELAY_US,
156 SPRD_RTC_POLL_TIMEOUT);
158 dev_err(rtc->dev, "failed to update SPG value:%d\n", ret);
162 return regmap_write(rtc->regmap, rtc->base + SPRD_RTC_INT_CLR,
163 SPRD_RTC_SPG_UPD_EN);
166 static int sprd_rtc_get_secs(struct sprd_rtc *rtc, enum sprd_rtc_reg_types type,
169 u32 sec_reg, min_reg, hour_reg, day_reg;
170 u32 val, sec, min, hour, day;
175 sec_reg = SPRD_RTC_SEC_CNT_VALUE;
176 min_reg = SPRD_RTC_MIN_CNT_VALUE;
177 hour_reg = SPRD_RTC_HOUR_CNT_VALUE;
178 day_reg = SPRD_RTC_DAY_CNT_VALUE;
181 sec_reg = SPRD_RTC_SEC_ALM_VALUE;
182 min_reg = SPRD_RTC_MIN_ALM_VALUE;
183 hour_reg = SPRD_RTC_HOUR_ALM_VALUE;
184 day_reg = SPRD_RTC_DAY_ALM_VALUE;
186 case SPRD_RTC_AUX_ALARM:
187 sec_reg = SPRD_RTC_SEC_AUXALM_UPD;
188 min_reg = SPRD_RTC_MIN_AUXALM_UPD;
189 hour_reg = SPRD_RTC_HOUR_AUXALM_UPD;
190 day_reg = SPRD_RTC_DAY_AUXALM_UPD;
196 ret = regmap_read(rtc->regmap, rtc->base + sec_reg, &val);
200 sec = val & SPRD_RTC_SEC_MASK;
202 ret = regmap_read(rtc->regmap, rtc->base + min_reg, &val);
206 min = val & SPRD_RTC_MIN_MASK;
208 ret = regmap_read(rtc->regmap, rtc->base + hour_reg, &val);
212 hour = val & SPRD_RTC_HOUR_MASK;
214 ret = regmap_read(rtc->regmap, rtc->base + day_reg, &val);
218 day = val & SPRD_RTC_DAY_MASK;
219 *secs = (((time64_t)(day * 24) + hour) * 60 + min) * 60 + sec;
223 static int sprd_rtc_set_secs(struct sprd_rtc *rtc, enum sprd_rtc_reg_types type,
226 u32 sec_reg, min_reg, hour_reg, day_reg, sts_mask;
227 u32 sec, min, hour, day, val;
230 /* convert seconds to RTC time format */
231 day = div_s64_rem(secs, 86400, &rem);
235 sec = rem - min * 60;
239 sec_reg = SPRD_RTC_SEC_CNT_UPD;
240 min_reg = SPRD_RTC_MIN_CNT_UPD;
241 hour_reg = SPRD_RTC_HOUR_CNT_UPD;
242 day_reg = SPRD_RTC_DAY_CNT_UPD;
243 sts_mask = SPRD_RTC_TIME_INT_MASK;
246 sec_reg = SPRD_RTC_SEC_ALM_UPD;
247 min_reg = SPRD_RTC_MIN_ALM_UPD;
248 hour_reg = SPRD_RTC_HOUR_ALM_UPD;
249 day_reg = SPRD_RTC_DAY_ALM_UPD;
250 sts_mask = SPRD_RTC_ALMTIME_INT_MASK;
252 case SPRD_RTC_AUX_ALARM:
253 sec_reg = SPRD_RTC_SEC_AUXALM_UPD;
254 min_reg = SPRD_RTC_MIN_AUXALM_UPD;
255 hour_reg = SPRD_RTC_HOUR_AUXALM_UPD;
256 day_reg = SPRD_RTC_DAY_AUXALM_UPD;
263 ret = regmap_write(rtc->regmap, rtc->base + sec_reg, sec);
267 ret = regmap_write(rtc->regmap, rtc->base + min_reg, min);
271 ret = regmap_write(rtc->regmap, rtc->base + hour_reg, hour);
275 ret = regmap_write(rtc->regmap, rtc->base + day_reg, day);
279 if (type == SPRD_RTC_AUX_ALARM)
283 * Since the time and normal alarm registers are put in always-power-on
284 * region supplied by VDDRTC, then these registers changing time will
285 * be very long, about 125ms. Thus here we should wait until all
286 * values are updated successfully.
288 ret = regmap_read_poll_timeout(rtc->regmap,
289 rtc->base + SPRD_RTC_INT_RAW_STS, val,
290 ((val & sts_mask) == sts_mask),
291 SPRD_RTC_POLL_DELAY_US,
292 SPRD_RTC_POLL_TIMEOUT);
294 dev_err(rtc->dev, "set time/alarm values timeout\n");
298 return regmap_write(rtc->regmap, rtc->base + SPRD_RTC_INT_CLR,
302 static int sprd_rtc_read_aux_alarm(struct device *dev, struct rtc_wkalrm *alrm)
304 struct sprd_rtc *rtc = dev_get_drvdata(dev);
309 ret = sprd_rtc_get_secs(rtc, SPRD_RTC_AUX_ALARM, &secs);
313 rtc_time64_to_tm(secs, &alrm->time);
315 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_INT_EN, &val);
319 alrm->enabled = !!(val & SPRD_RTC_AUXALM_EN);
321 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_INT_RAW_STS, &val);
325 alrm->pending = !!(val & SPRD_RTC_AUXALM_EN);
329 static int sprd_rtc_set_aux_alarm(struct device *dev, struct rtc_wkalrm *alrm)
331 struct sprd_rtc *rtc = dev_get_drvdata(dev);
332 time64_t secs = rtc_tm_to_time64(&alrm->time);
335 /* clear the auxiliary alarm interrupt status */
336 ret = regmap_write(rtc->regmap, rtc->base + SPRD_RTC_INT_CLR,
341 ret = sprd_rtc_set_secs(rtc, SPRD_RTC_AUX_ALARM, secs);
346 ret = regmap_update_bits(rtc->regmap,
347 rtc->base + SPRD_RTC_INT_EN,
351 ret = regmap_update_bits(rtc->regmap,
352 rtc->base + SPRD_RTC_INT_EN,
353 SPRD_RTC_AUXALM_EN, 0);
359 static int sprd_rtc_read_time(struct device *dev, struct rtc_time *tm)
361 struct sprd_rtc *rtc = dev_get_drvdata(dev);
366 dev_warn(dev, "RTC values are invalid\n");
370 ret = sprd_rtc_get_secs(rtc, SPRD_RTC_TIME, &secs);
374 rtc_time64_to_tm(secs, tm);
378 static int sprd_rtc_set_time(struct device *dev, struct rtc_time *tm)
380 struct sprd_rtc *rtc = dev_get_drvdata(dev);
381 time64_t secs = rtc_tm_to_time64(tm);
384 ret = sprd_rtc_set_secs(rtc, SPRD_RTC_TIME, secs);
389 /* Clear RTC power status firstly */
390 ret = regmap_write(rtc->regmap, rtc->base + SPRD_RTC_PWR_CTRL,
391 SPRD_RTC_POWER_STS_CLEAR);
396 * Set RTC power status to indicate now RTC has valid time
399 ret = regmap_write(rtc->regmap, rtc->base + SPRD_RTC_PWR_CTRL,
400 SPRD_RTC_POWER_STS_VALID);
410 static int sprd_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
412 struct sprd_rtc *rtc = dev_get_drvdata(dev);
418 * Before RTC device is registered, it will check to see if there is an
419 * alarm already set in RTC hardware, and we always read the normal
420 * alarm at this time.
422 * Or if aie_timer is enabled, we should get the normal alarm time.
423 * Otherwise we should get auxiliary alarm time.
425 if (rtc->rtc && rtc->rtc->registered && rtc->rtc->aie_timer.enabled == 0)
426 return sprd_rtc_read_aux_alarm(dev, alrm);
428 ret = sprd_rtc_get_secs(rtc, SPRD_RTC_ALARM, &secs);
432 rtc_time64_to_tm(secs, &alrm->time);
434 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_INT_EN, &val);
438 alrm->enabled = !!(val & SPRD_RTC_ALARM_EN);
440 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_INT_RAW_STS, &val);
444 alrm->pending = !!(val & SPRD_RTC_ALARM_EN);
448 static int sprd_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
450 struct sprd_rtc *rtc = dev_get_drvdata(dev);
451 time64_t secs = rtc_tm_to_time64(&alrm->time);
452 struct rtc_time aie_time =
453 rtc_ktime_to_tm(rtc->rtc->aie_timer.node.expires);
457 * We have 2 groups alarms: normal alarm and auxiliary alarm. Since
458 * both normal alarm event and auxiliary alarm event can wake up system
459 * from deep sleep, but only alarm event can power up system from power
460 * down status. Moreover we do not need to poll about 125ms when
461 * updating auxiliary alarm registers. Thus we usually set auxiliary
462 * alarm when wake up system from deep sleep, and for other scenarios,
463 * we should set normal alarm with polling status.
465 * So here we check if the alarm time is set by aie_timer, if yes, we
466 * should set normal alarm, if not, we should set auxiliary alarm which
467 * means it is just a wake event.
469 if (!rtc->rtc->aie_timer.enabled || rtc_tm_sub(&aie_time, &alrm->time))
470 return sprd_rtc_set_aux_alarm(dev, alrm);
472 /* clear the alarm interrupt status firstly */
473 ret = regmap_write(rtc->regmap, rtc->base + SPRD_RTC_INT_CLR,
478 ret = sprd_rtc_set_secs(rtc, SPRD_RTC_ALARM, secs);
483 ret = regmap_update_bits(rtc->regmap,
484 rtc->base + SPRD_RTC_INT_EN,
490 /* unlock the alarm to enable the alarm function. */
491 ret = sprd_rtc_lock_alarm(rtc, false);
493 regmap_update_bits(rtc->regmap,
494 rtc->base + SPRD_RTC_INT_EN,
495 SPRD_RTC_ALARM_EN, 0);
498 * Lock the alarm function in case fake alarm event will power
501 ret = sprd_rtc_lock_alarm(rtc, true);
507 static int sprd_rtc_alarm_irq_enable(struct device *dev, unsigned int enabled)
509 struct sprd_rtc *rtc = dev_get_drvdata(dev);
513 ret = regmap_update_bits(rtc->regmap,
514 rtc->base + SPRD_RTC_INT_EN,
515 SPRD_RTC_ALARM_EN | SPRD_RTC_AUXALM_EN,
516 SPRD_RTC_ALARM_EN | SPRD_RTC_AUXALM_EN);
520 ret = sprd_rtc_lock_alarm(rtc, false);
522 regmap_update_bits(rtc->regmap, rtc->base + SPRD_RTC_INT_EN,
523 SPRD_RTC_ALARM_EN | SPRD_RTC_AUXALM_EN, 0);
525 ret = sprd_rtc_lock_alarm(rtc, true);
531 static const struct rtc_class_ops sprd_rtc_ops = {
532 .read_time = sprd_rtc_read_time,
533 .set_time = sprd_rtc_set_time,
534 .read_alarm = sprd_rtc_read_alarm,
535 .set_alarm = sprd_rtc_set_alarm,
536 .alarm_irq_enable = sprd_rtc_alarm_irq_enable,
539 static irqreturn_t sprd_rtc_handler(int irq, void *dev_id)
541 struct sprd_rtc *rtc = dev_id;
544 ret = sprd_rtc_clear_alarm_ints(rtc);
546 return IRQ_RETVAL(ret);
548 rtc_update_irq(rtc->rtc, 1, RTC_AF | RTC_IRQF);
552 static int sprd_rtc_check_power_down(struct sprd_rtc *rtc)
557 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_PWR_STS, &val);
562 * If the RTC power status value is SPRD_RTC_POWER_RESET_VALUE, which
563 * means the RTC has been powered down, so the RTC time values are
566 rtc->valid = val == SPRD_RTC_POWER_RESET_VALUE ? false : true;
570 static int sprd_rtc_check_alarm_int(struct sprd_rtc *rtc)
575 ret = regmap_read(rtc->regmap, rtc->base + SPRD_RTC_SPG_VALUE, &val);
580 * The SPRD_RTC_INT_EN register is not put in always-power-on region
581 * supplied by VDDRTC, so we should check if we need enable the alarm
582 * interrupt when system booting.
584 * If we have set SPRD_RTC_POWEROFF_ALM_FLAG which is saved in
585 * always-power-on region, that means we have set one alarm last time,
586 * so we should enable the alarm interrupt to help RTC core to see if
587 * there is an alarm already set in RTC hardware.
589 if (!(val & SPRD_RTC_POWEROFF_ALM_FLAG))
592 return regmap_update_bits(rtc->regmap, rtc->base + SPRD_RTC_INT_EN,
593 SPRD_RTC_ALARM_EN, SPRD_RTC_ALARM_EN);
596 static int sprd_rtc_probe(struct platform_device *pdev)
598 struct device_node *node = pdev->dev.of_node;
599 struct sprd_rtc *rtc;
602 rtc = devm_kzalloc(&pdev->dev, sizeof(*rtc), GFP_KERNEL);
606 rtc->regmap = dev_get_regmap(pdev->dev.parent, NULL);
610 ret = of_property_read_u32(node, "reg", &rtc->base);
612 dev_err(&pdev->dev, "failed to get RTC base address\n");
616 rtc->irq = platform_get_irq(pdev, 0);
620 rtc->rtc = devm_rtc_allocate_device(&pdev->dev);
621 if (IS_ERR(rtc->rtc))
622 return PTR_ERR(rtc->rtc);
624 rtc->dev = &pdev->dev;
625 platform_set_drvdata(pdev, rtc);
627 /* check if we need set the alarm interrupt */
628 ret = sprd_rtc_check_alarm_int(rtc);
630 dev_err(&pdev->dev, "failed to check RTC alarm interrupt\n");
634 /* check if RTC time values are valid */
635 ret = sprd_rtc_check_power_down(rtc);
637 dev_err(&pdev->dev, "failed to check RTC time values\n");
641 ret = devm_request_threaded_irq(&pdev->dev, rtc->irq, NULL,
643 IRQF_ONESHOT | IRQF_EARLY_RESUME,
646 dev_err(&pdev->dev, "failed to request RTC irq\n");
650 device_init_wakeup(&pdev->dev, 1);
652 rtc->rtc->ops = &sprd_rtc_ops;
653 rtc->rtc->range_min = 0;
654 rtc->rtc->range_max = 5662310399LL;
655 ret = rtc_register_device(rtc->rtc);
657 device_init_wakeup(&pdev->dev, 0);
664 static const struct of_device_id sprd_rtc_of_match[] = {
665 { .compatible = "sprd,sc2731-rtc", },
668 MODULE_DEVICE_TABLE(of, sprd_rtc_of_match);
670 static struct platform_driver sprd_rtc_driver = {
673 .of_match_table = sprd_rtc_of_match,
675 .probe = sprd_rtc_probe,
677 module_platform_driver(sprd_rtc_driver);
679 MODULE_LICENSE("GPL v2");
680 MODULE_DESCRIPTION("Spreadtrum RTC Device Driver");
681 MODULE_AUTHOR("Baolin Wang <baolin.wang@spreadtrum.com>");