1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Real Time Clock interface for StrongARM SA1x00 and XScale PXA2xx
5 * Copyright (c) 2000 Nils Faerber
7 * Based on rtc.c by Paul Gortmaker
9 * Original Driver by Nils Faerber <nils@kernelconcepts.de>
12 * CIH <cih@coventive.com>
13 * Nicolas Pitre <nico@fluxnic.net>
14 * Andrew Christian <andrew.christian@hp.com>
16 * Converted to the RTC subsystem and Driver Model
17 * by Richard Purdie <rpurdie@rpsys.net>
20 #include <linux/platform_device.h>
21 #include <linux/module.h>
22 #include <linux/clk.h>
23 #include <linux/rtc.h>
24 #include <linux/init.h>
26 #include <linux/interrupt.h>
27 #include <linux/slab.h>
28 #include <linux/string.h>
31 #include <linux/bitops.h>
34 #define RTSR_HZE BIT(3) /* HZ interrupt enable */
35 #define RTSR_ALE BIT(2) /* RTC alarm interrupt enable */
36 #define RTSR_HZ BIT(1) /* HZ rising-edge detected */
37 #define RTSR_AL BIT(0) /* RTC alarm detected */
39 #include "rtc-sa1100.h"
41 #define RTC_DEF_DIVIDER (32768 - 1)
42 #define RTC_DEF_TRIM 0
46 static irqreturn_t sa1100_rtc_interrupt(int irq, void *dev_id)
48 struct sa1100_rtc *info = dev_get_drvdata(dev_id);
49 struct rtc_device *rtc = info->rtc;
51 unsigned long events = 0;
53 spin_lock(&info->lock);
55 rtsr = readl_relaxed(info->rtsr);
56 /* clear interrupt sources */
57 writel_relaxed(0, info->rtsr);
58 /* Fix for a nasty initialization problem the in SA11xx RTSR register.
59 * See also the comments in sa1100_rtc_probe(). */
60 if (rtsr & (RTSR_ALE | RTSR_HZE)) {
61 /* This is the original code, before there was the if test
62 * above. This code does not clear interrupts that were not
64 writel_relaxed((RTSR_AL | RTSR_HZ) & (rtsr >> 2), info->rtsr);
66 /* For some reason, it is possible to enter this routine
67 * without interruptions enabled, it has been tested with
68 * several units (Bug in SA11xx chip?).
70 * This situation leads to an infinite "loop" of interrupt
71 * routine calling and as a result the processor seems to
72 * lock on its first call to open(). */
73 writel_relaxed(RTSR_AL | RTSR_HZ, info->rtsr);
76 /* clear alarm interrupt if it has occurred */
79 writel_relaxed(rtsr & (RTSR_ALE | RTSR_HZE), info->rtsr);
81 /* update irq data & counter */
83 events |= RTC_AF | RTC_IRQF;
85 events |= RTC_UF | RTC_IRQF;
87 rtc_update_irq(rtc, 1, events);
89 spin_unlock(&info->lock);
94 static int sa1100_rtc_alarm_irq_enable(struct device *dev, unsigned int enabled)
97 struct sa1100_rtc *info = dev_get_drvdata(dev);
99 spin_lock_irq(&info->lock);
100 rtsr = readl_relaxed(info->rtsr);
105 writel_relaxed(rtsr, info->rtsr);
106 spin_unlock_irq(&info->lock);
110 static int sa1100_rtc_read_time(struct device *dev, struct rtc_time *tm)
112 struct sa1100_rtc *info = dev_get_drvdata(dev);
114 rtc_time64_to_tm(readl_relaxed(info->rcnr), tm);
118 static int sa1100_rtc_set_time(struct device *dev, struct rtc_time *tm)
120 struct sa1100_rtc *info = dev_get_drvdata(dev);
122 writel_relaxed(rtc_tm_to_time64(tm), info->rcnr);
127 static int sa1100_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
130 struct sa1100_rtc *info = dev_get_drvdata(dev);
132 rtsr = readl_relaxed(info->rtsr);
133 alrm->enabled = (rtsr & RTSR_ALE) ? 1 : 0;
134 alrm->pending = (rtsr & RTSR_AL) ? 1 : 0;
138 static int sa1100_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
140 struct sa1100_rtc *info = dev_get_drvdata(dev);
142 spin_lock_irq(&info->lock);
143 writel_relaxed(readl_relaxed(info->rtsr) &
144 (RTSR_HZE | RTSR_ALE | RTSR_AL), info->rtsr);
145 writel_relaxed(rtc_tm_to_time64(&alrm->time), info->rtar);
147 writel_relaxed(readl_relaxed(info->rtsr) | RTSR_ALE, info->rtsr);
149 writel_relaxed(readl_relaxed(info->rtsr) & ~RTSR_ALE, info->rtsr);
150 spin_unlock_irq(&info->lock);
155 static int sa1100_rtc_proc(struct device *dev, struct seq_file *seq)
157 struct sa1100_rtc *info = dev_get_drvdata(dev);
159 seq_printf(seq, "trim/divider\t\t: 0x%08x\n", readl_relaxed(info->rttr));
160 seq_printf(seq, "RTSR\t\t\t: 0x%08x\n", readl_relaxed(info->rtsr));
165 static const struct rtc_class_ops sa1100_rtc_ops = {
166 .read_time = sa1100_rtc_read_time,
167 .set_time = sa1100_rtc_set_time,
168 .read_alarm = sa1100_rtc_read_alarm,
169 .set_alarm = sa1100_rtc_set_alarm,
170 .proc = sa1100_rtc_proc,
171 .alarm_irq_enable = sa1100_rtc_alarm_irq_enable,
174 int sa1100_rtc_init(struct platform_device *pdev, struct sa1100_rtc *info)
178 spin_lock_init(&info->lock);
180 info->clk = devm_clk_get(&pdev->dev, NULL);
181 if (IS_ERR(info->clk)) {
182 dev_err(&pdev->dev, "failed to find rtc clock source\n");
183 return PTR_ERR(info->clk);
186 ret = clk_prepare_enable(info->clk);
190 * According to the manual we should be able to let RTTR be zero
191 * and then a default diviser for a 32.768KHz clock is used.
192 * Apparently this doesn't work, at least for my SA1110 rev 5.
193 * If the clock divider is uninitialized then reset it to the
194 * default value to get the 1Hz clock.
196 if (readl_relaxed(info->rttr) == 0) {
197 writel_relaxed(RTC_DEF_DIVIDER + (RTC_DEF_TRIM << 16), info->rttr);
198 dev_warn(&pdev->dev, "warning: "
199 "initializing default clock divider/trim value\n");
200 /* The current RTC value probably doesn't make sense either */
201 writel_relaxed(0, info->rcnr);
204 info->rtc->ops = &sa1100_rtc_ops;
205 info->rtc->max_user_freq = RTC_FREQ;
206 info->rtc->range_max = U32_MAX;
208 ret = devm_rtc_register_device(info->rtc);
210 clk_disable_unprepare(info->clk);
214 /* Fix for a nasty initialization problem the in SA11xx RTSR register.
215 * See also the comments in sa1100_rtc_interrupt().
217 * Sometimes bit 1 of the RTSR (RTSR_HZ) will wake up 1, which means an
218 * interrupt pending, even though interrupts were never enabled.
219 * In this case, this bit it must be reset before enabling
220 * interruptions to avoid a nonexistent interrupt to occur.
222 * In principle, the same problem would apply to bit 0, although it has
223 * never been observed to happen.
225 * This issue is addressed both here and in sa1100_rtc_interrupt().
226 * If the issue is not addressed here, in the times when the processor
227 * wakes up with the bit set there will be one spurious interrupt.
229 * The issue is also dealt with in sa1100_rtc_interrupt() to be on the
230 * safe side, once the condition that lead to this strange
231 * initialization is unknown and could in principle happen during
234 * Notice that clearing bit 1 and 0 is accomplished by writting ONES to
235 * the corresponding bits in RTSR. */
236 writel_relaxed(RTSR_AL | RTSR_HZ, info->rtsr);
240 EXPORT_SYMBOL_GPL(sa1100_rtc_init);
242 static int sa1100_rtc_probe(struct platform_device *pdev)
244 struct sa1100_rtc *info;
246 int irq_1hz, irq_alarm;
249 irq_1hz = platform_get_irq_byname(pdev, "rtc 1Hz");
250 irq_alarm = platform_get_irq_byname(pdev, "rtc alarm");
251 if (irq_1hz < 0 || irq_alarm < 0)
254 info = devm_kzalloc(&pdev->dev, sizeof(struct sa1100_rtc), GFP_KERNEL);
257 info->irq_1hz = irq_1hz;
258 info->irq_alarm = irq_alarm;
260 info->rtc = devm_rtc_allocate_device(&pdev->dev);
261 if (IS_ERR(info->rtc))
262 return PTR_ERR(info->rtc);
264 ret = devm_request_irq(&pdev->dev, irq_1hz, sa1100_rtc_interrupt, 0,
265 "rtc 1Hz", &pdev->dev);
267 dev_err(&pdev->dev, "IRQ %d already in use.\n", irq_1hz);
270 ret = devm_request_irq(&pdev->dev, irq_alarm, sa1100_rtc_interrupt, 0,
271 "rtc Alrm", &pdev->dev);
273 dev_err(&pdev->dev, "IRQ %d already in use.\n", irq_alarm);
277 base = devm_platform_ioremap_resource(pdev, 0);
279 return PTR_ERR(base);
281 if (IS_ENABLED(CONFIG_ARCH_SA1100) ||
282 of_device_is_compatible(pdev->dev.of_node, "mrvl,sa1100-rtc")) {
283 info->rcnr = base + 0x04;
284 info->rtsr = base + 0x10;
285 info->rtar = base + 0x00;
286 info->rttr = base + 0x08;
288 info->rcnr = base + 0x0;
289 info->rtsr = base + 0x8;
290 info->rtar = base + 0x4;
291 info->rttr = base + 0xc;
294 platform_set_drvdata(pdev, info);
295 device_init_wakeup(&pdev->dev, 1);
297 return sa1100_rtc_init(pdev, info);
300 static int sa1100_rtc_remove(struct platform_device *pdev)
302 struct sa1100_rtc *info = platform_get_drvdata(pdev);
305 spin_lock_irq(&info->lock);
306 writel_relaxed(0, info->rtsr);
307 spin_unlock_irq(&info->lock);
308 clk_disable_unprepare(info->clk);
314 #ifdef CONFIG_PM_SLEEP
315 static int sa1100_rtc_suspend(struct device *dev)
317 struct sa1100_rtc *info = dev_get_drvdata(dev);
318 if (device_may_wakeup(dev))
319 enable_irq_wake(info->irq_alarm);
323 static int sa1100_rtc_resume(struct device *dev)
325 struct sa1100_rtc *info = dev_get_drvdata(dev);
326 if (device_may_wakeup(dev))
327 disable_irq_wake(info->irq_alarm);
332 static SIMPLE_DEV_PM_OPS(sa1100_rtc_pm_ops, sa1100_rtc_suspend,
336 static const struct of_device_id sa1100_rtc_dt_ids[] = {
337 { .compatible = "mrvl,sa1100-rtc", },
338 { .compatible = "mrvl,mmp-rtc", },
341 MODULE_DEVICE_TABLE(of, sa1100_rtc_dt_ids);
344 static struct platform_driver sa1100_rtc_driver = {
345 .probe = sa1100_rtc_probe,
346 .remove = sa1100_rtc_remove,
348 .name = "sa1100-rtc",
349 .pm = &sa1100_rtc_pm_ops,
350 .of_match_table = of_match_ptr(sa1100_rtc_dt_ids),
354 module_platform_driver(sa1100_rtc_driver);
356 MODULE_AUTHOR("Richard Purdie <rpurdie@rpsys.net>");
357 MODULE_DESCRIPTION("SA11x0/PXA2xx Realtime Clock Driver (RTC)");
358 MODULE_LICENSE("GPL");
359 MODULE_ALIAS("platform:sa1100-rtc");