2 * Copyright 2008-2009 Freescale Semiconductor, Inc. All Rights Reserved.
3 * Copyright 2010 Orex Computed Radiography
7 * The code contained herein is licensed under the GNU General Public
8 * License. You may obtain a copy of the GNU General Public License
9 * Version 2 or later at the following locations:
11 * http://www.opensource.org/licenses/gpl-license.html
12 * http://www.gnu.org/copyleft/gpl.html
15 /* based on rtc-mc13892.c */
18 * This driver uses the 47-bit 32 kHz counter in the Freescale DryIce block
19 * to implement a Linux RTC. Times and alarms are truncated to seconds.
20 * Since the RTC framework performs API locking via rtc->ops_lock the
21 * only simultaneous accesses we need to deal with is updating DryIce
22 * registers while servicing an alarm.
24 * Note that reading the DSR (DryIce Status Register) automatically clears
25 * the WCF (Write Complete Flag). All DryIce writes are synchronized to the
26 * LP (Low Power) domain and set the WCF upon completion. Writes to the
27 * DIER (DryIce Interrupt Enable Register) are the only exception. These
28 * occur at normal bus speeds and do not set WCF. Periodic interrupts are
29 * not supported by the hardware.
33 #include <linux/clk.h>
34 #include <linux/delay.h>
35 #include <linux/module.h>
36 #include <linux/platform_device.h>
37 #include <linux/rtc.h>
38 #include <linux/sched.h>
39 #include <linux/spinlock.h>
40 #include <linux/workqueue.h>
43 /* DryIce Register Definitions */
45 #define DTCMR 0x00 /* Time Counter MSB Reg */
46 #define DTCLR 0x04 /* Time Counter LSB Reg */
48 #define DCAMR 0x08 /* Clock Alarm MSB Reg */
49 #define DCALR 0x0c /* Clock Alarm LSB Reg */
50 #define DCAMR_UNSET 0xFFFFFFFF /* doomsday - 1 sec */
52 #define DCR 0x10 /* Control Reg */
53 #define DCR_TCE (1 << 3) /* Time Counter Enable */
55 #define DSR 0x14 /* Status Reg */
56 #define DSR_WBF (1 << 10) /* Write Busy Flag */
57 #define DSR_WNF (1 << 9) /* Write Next Flag */
58 #define DSR_WCF (1 << 8) /* Write Complete Flag */
59 #define DSR_WEF (1 << 7) /* Write Error Flag */
60 #define DSR_CAF (1 << 4) /* Clock Alarm Flag */
61 #define DSR_NVF (1 << 1) /* Non-Valid Flag */
62 #define DSR_SVF (1 << 0) /* Security Violation Flag */
64 #define DIER 0x18 /* Interrupt Enable Reg */
65 #define DIER_WNIE (1 << 9) /* Write Next Interrupt Enable */
66 #define DIER_WCIE (1 << 8) /* Write Complete Interrupt Enable */
67 #define DIER_WEIE (1 << 7) /* Write Error Interrupt Enable */
68 #define DIER_CAIE (1 << 4) /* Clock Alarm Interrupt Enable */
71 * struct imxdi_dev - private imxdi rtc data
72 * @pdev: pionter to platform dev
73 * @rtc: pointer to rtc struct
74 * @ioaddr: IO registers pointer
75 * @irq: dryice normal interrupt
76 * @clk: input reference clock
77 * @dsr: copy of the DSR register
78 * @irq_lock: interrupt enable register (DIER) lock
79 * @write_wait: registers write complete queue
80 * @write_mutex: serialize registers write
81 * @work: schedule alarm work
84 struct platform_device
*pdev
;
85 struct rtc_device
*rtc
;
91 wait_queue_head_t write_wait
;
92 struct mutex write_mutex
;
93 struct work_struct work
;
97 * enable a dryice interrupt
99 static void di_int_enable(struct imxdi_dev
*imxdi
, u32 intr
)
103 spin_lock_irqsave(&imxdi
->irq_lock
, flags
);
104 __raw_writel(__raw_readl(imxdi
->ioaddr
+ DIER
) | intr
,
105 imxdi
->ioaddr
+ DIER
);
106 spin_unlock_irqrestore(&imxdi
->irq_lock
, flags
);
110 * disable a dryice interrupt
112 static void di_int_disable(struct imxdi_dev
*imxdi
, u32 intr
)
116 spin_lock_irqsave(&imxdi
->irq_lock
, flags
);
117 __raw_writel(__raw_readl(imxdi
->ioaddr
+ DIER
) & ~intr
,
118 imxdi
->ioaddr
+ DIER
);
119 spin_unlock_irqrestore(&imxdi
->irq_lock
, flags
);
123 * This function attempts to clear the dryice write-error flag.
125 * A dryice write error is similar to a bus fault and should not occur in
126 * normal operation. Clearing the flag requires another write, so the root
127 * cause of the problem may need to be fixed before the flag can be cleared.
129 static void clear_write_error(struct imxdi_dev
*imxdi
)
133 dev_warn(&imxdi
->pdev
->dev
, "WARNING: Register write error!\n");
135 /* clear the write error flag */
136 __raw_writel(DSR_WEF
, imxdi
->ioaddr
+ DSR
);
138 /* wait for it to take effect */
139 for (cnt
= 0; cnt
< 1000; cnt
++) {
140 if ((__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_WEF
) == 0)
144 dev_err(&imxdi
->pdev
->dev
,
145 "ERROR: Cannot clear write-error flag!\n");
149 * Write a dryice register and wait until it completes.
151 * This function uses interrupts to determine when the
152 * write has completed.
154 static int di_write_wait(struct imxdi_dev
*imxdi
, u32 val
, int reg
)
159 /* serialize register writes */
160 mutex_lock(&imxdi
->write_mutex
);
162 /* enable the write-complete interrupt */
163 di_int_enable(imxdi
, DIER_WCIE
);
167 /* do the register write */
168 __raw_writel(val
, imxdi
->ioaddr
+ reg
);
170 /* wait for the write to finish */
171 ret
= wait_event_interruptible_timeout(imxdi
->write_wait
,
172 imxdi
->dsr
& (DSR_WCF
| DSR_WEF
), msecs_to_jiffies(1));
176 } else if (ret
== 0) {
177 dev_warn(&imxdi
->pdev
->dev
,
178 "Write-wait timeout "
179 "val = 0x%08x reg = 0x%08x\n", val
, reg
);
182 /* check for write error */
183 if (imxdi
->dsr
& DSR_WEF
) {
184 clear_write_error(imxdi
);
189 mutex_unlock(&imxdi
->write_mutex
);
195 * read the seconds portion of the current time from the dryice time counter
197 static int dryice_rtc_read_time(struct device
*dev
, struct rtc_time
*tm
)
199 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
202 now
= __raw_readl(imxdi
->ioaddr
+ DTCMR
);
203 rtc_time_to_tm(now
, tm
);
209 * set the seconds portion of dryice time counter and clear the
212 static int dryice_rtc_set_mmss(struct device
*dev
, unsigned long secs
)
214 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
217 /* zero the fractional part first */
218 rc
= di_write_wait(imxdi
, 0, DTCLR
);
220 rc
= di_write_wait(imxdi
, secs
, DTCMR
);
225 static int dryice_rtc_alarm_irq_enable(struct device
*dev
,
226 unsigned int enabled
)
228 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
231 di_int_enable(imxdi
, DIER_CAIE
);
233 di_int_disable(imxdi
, DIER_CAIE
);
239 * read the seconds portion of the alarm register.
240 * the fractional part of the alarm register is always zero.
242 static int dryice_rtc_read_alarm(struct device
*dev
, struct rtc_wkalrm
*alarm
)
244 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
247 dcamr
= __raw_readl(imxdi
->ioaddr
+ DCAMR
);
248 rtc_time_to_tm(dcamr
, &alarm
->time
);
250 /* alarm is enabled if the interrupt is enabled */
251 alarm
->enabled
= (__raw_readl(imxdi
->ioaddr
+ DIER
) & DIER_CAIE
) != 0;
253 /* don't allow the DSR read to mess up DSR_WCF */
254 mutex_lock(&imxdi
->write_mutex
);
256 /* alarm is pending if the alarm flag is set */
257 alarm
->pending
= (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_CAF
) != 0;
259 mutex_unlock(&imxdi
->write_mutex
);
265 * set the seconds portion of dryice alarm register
267 static int dryice_rtc_set_alarm(struct device
*dev
, struct rtc_wkalrm
*alarm
)
269 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
271 unsigned long alarm_time
;
274 rc
= rtc_tm_to_time(&alarm
->time
, &alarm_time
);
278 /* don't allow setting alarm in the past */
279 now
= __raw_readl(imxdi
->ioaddr
+ DTCMR
);
280 if (alarm_time
< now
)
283 /* write the new alarm time */
284 rc
= di_write_wait(imxdi
, (u32
)alarm_time
, DCAMR
);
289 di_int_enable(imxdi
, DIER_CAIE
); /* enable alarm intr */
291 di_int_disable(imxdi
, DIER_CAIE
); /* disable alarm intr */
296 static struct rtc_class_ops dryice_rtc_ops
= {
297 .read_time
= dryice_rtc_read_time
,
298 .set_mmss
= dryice_rtc_set_mmss
,
299 .alarm_irq_enable
= dryice_rtc_alarm_irq_enable
,
300 .read_alarm
= dryice_rtc_read_alarm
,
301 .set_alarm
= dryice_rtc_set_alarm
,
305 * dryice "normal" interrupt handler
307 static irqreturn_t
dryice_norm_irq(int irq
, void *dev_id
)
309 struct imxdi_dev
*imxdi
= dev_id
;
311 irqreturn_t rc
= IRQ_NONE
;
313 dier
= __raw_readl(imxdi
->ioaddr
+ DIER
);
315 /* handle write complete and write error cases */
316 if ((dier
& DIER_WCIE
)) {
317 /*If the write wait queue is empty then there is no pending
318 operations. It means the interrupt is for DryIce -Security.
319 IRQ must be returned as none.*/
320 if (list_empty_careful(&imxdi
->write_wait
.task_list
))
323 /* DSR_WCF clears itself on DSR read */
324 dsr
= __raw_readl(imxdi
->ioaddr
+ DSR
);
325 if ((dsr
& (DSR_WCF
| DSR_WEF
))) {
326 /* mask the interrupt */
327 di_int_disable(imxdi
, DIER_WCIE
);
329 /* save the dsr value for the wait queue */
332 wake_up_interruptible(&imxdi
->write_wait
);
337 /* handle the alarm case */
338 if ((dier
& DIER_CAIE
)) {
339 /* DSR_WCF clears itself on DSR read */
340 dsr
= __raw_readl(imxdi
->ioaddr
+ DSR
);
342 /* mask the interrupt */
343 di_int_disable(imxdi
, DIER_CAIE
);
345 /* finish alarm in user context */
346 schedule_work(&imxdi
->work
);
354 * post the alarm event from user context so it can sleep
355 * on the write completion.
357 static void dryice_work(struct work_struct
*work
)
359 struct imxdi_dev
*imxdi
= container_of(work
,
360 struct imxdi_dev
, work
);
362 /* dismiss the interrupt (ignore error) */
363 di_write_wait(imxdi
, DSR_CAF
, DSR
);
365 /* pass the alarm event to the rtc framework. */
366 rtc_update_irq(imxdi
->rtc
, 1, RTC_AF
| RTC_IRQF
);
370 * probe for dryice rtc device
372 static int __init
dryice_rtc_probe(struct platform_device
*pdev
)
374 struct resource
*res
;
375 struct imxdi_dev
*imxdi
;
378 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
382 imxdi
= devm_kzalloc(&pdev
->dev
, sizeof(*imxdi
), GFP_KERNEL
);
388 if (!devm_request_mem_region(&pdev
->dev
, res
->start
, resource_size(res
),
392 imxdi
->ioaddr
= devm_ioremap(&pdev
->dev
, res
->start
,
394 if (imxdi
->ioaddr
== NULL
)
397 spin_lock_init(&imxdi
->irq_lock
);
399 imxdi
->irq
= platform_get_irq(pdev
, 0);
403 init_waitqueue_head(&imxdi
->write_wait
);
405 INIT_WORK(&imxdi
->work
, dryice_work
);
407 mutex_init(&imxdi
->write_mutex
);
409 imxdi
->clk
= devm_clk_get(&pdev
->dev
, NULL
);
410 if (IS_ERR(imxdi
->clk
))
411 return PTR_ERR(imxdi
->clk
);
412 clk_prepare_enable(imxdi
->clk
);
415 * Initialize dryice hardware
418 /* mask all interrupts */
419 __raw_writel(0, imxdi
->ioaddr
+ DIER
);
421 rc
= devm_request_irq(&pdev
->dev
, imxdi
->irq
, dryice_norm_irq
,
422 IRQF_SHARED
, pdev
->name
, imxdi
);
424 dev_warn(&pdev
->dev
, "interrupt not available.\n");
428 /* put dryice into valid state */
429 if (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_NVF
) {
430 rc
= di_write_wait(imxdi
, DSR_NVF
| DSR_SVF
, DSR
);
435 /* initialize alarm */
436 rc
= di_write_wait(imxdi
, DCAMR_UNSET
, DCAMR
);
439 rc
= di_write_wait(imxdi
, 0, DCALR
);
443 /* clear alarm flag */
444 if (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_CAF
) {
445 rc
= di_write_wait(imxdi
, DSR_CAF
, DSR
);
450 /* the timer won't count if it has never been written to */
451 if (__raw_readl(imxdi
->ioaddr
+ DTCMR
) == 0) {
452 rc
= di_write_wait(imxdi
, 0, DTCMR
);
457 /* start keeping time */
458 if (!(__raw_readl(imxdi
->ioaddr
+ DCR
) & DCR_TCE
)) {
459 rc
= di_write_wait(imxdi
,
460 __raw_readl(imxdi
->ioaddr
+ DCR
) | DCR_TCE
,
466 platform_set_drvdata(pdev
, imxdi
);
467 imxdi
->rtc
= devm_rtc_device_register(&pdev
->dev
, pdev
->name
,
468 &dryice_rtc_ops
, THIS_MODULE
);
469 if (IS_ERR(imxdi
->rtc
)) {
470 rc
= PTR_ERR(imxdi
->rtc
);
477 clk_disable_unprepare(imxdi
->clk
);
482 static int __exit
dryice_rtc_remove(struct platform_device
*pdev
)
484 struct imxdi_dev
*imxdi
= platform_get_drvdata(pdev
);
486 flush_work(&imxdi
->work
);
488 /* mask all interrupts */
489 __raw_writel(0, imxdi
->ioaddr
+ DIER
);
491 clk_disable_unprepare(imxdi
->clk
);
497 static const struct of_device_id dryice_dt_ids
[] = {
498 { .compatible
= "fsl,imx25-rtc" },
502 MODULE_DEVICE_TABLE(of
, dryice_dt_ids
);
505 static struct platform_driver dryice_rtc_driver
= {
508 .owner
= THIS_MODULE
,
509 .of_match_table
= of_match_ptr(dryice_dt_ids
),
511 .remove
= __exit_p(dryice_rtc_remove
),
514 module_platform_driver_probe(dryice_rtc_driver
, dryice_rtc_probe
);
516 MODULE_AUTHOR("Freescale Semiconductor, Inc.");
517 MODULE_AUTHOR("Baruch Siach <baruch@tkos.co.il>");
518 MODULE_DESCRIPTION("IMX DryIce Realtime Clock Driver (RTC)");
519 MODULE_LICENSE("GPL");