3  * RTC subsystem, interface functions
11 #include <linux/rtc.h>
18 #include <trace/events/rtc.h>
20 static int rtc_timer_enqueue(struct rtc_device *rtc, struct rtc_timer *timer);
21 static void rtc_timer_remove(struct rtc_device *rtc, struct rtc_timer *timer);
23 static void rtc_add_offset(struct rtc_device *rtc, struct rtc_time *tm)  in rtc_add_offset()  argument
27 	if (!rtc->offset_secs)  in rtc_add_offset()
33 	 * Since the reading time values from RTC device are always in the RTC  in rtc_add_offset()
38 	if ((rtc->start_secs > rtc->range_min && secs >= rtc->start_secs) ||  in rtc_add_offset()
39 	    (rtc->start_secs < rtc->range_min &&  in rtc_add_offset()
40 	     secs <= (rtc->start_secs + rtc->range_max - rtc->range_min)))  in rtc_add_offset()
43 	rtc_time64_to_tm(secs + rtc->offset_secs, tm);  in rtc_add_offset()
46 static void rtc_subtract_offset(struct rtc_device *rtc, struct rtc_time *tm)  in rtc_subtract_offset()  argument
50 	if (!rtc->offset_secs)  in rtc_subtract_offset()
56 	 * If the setting time values are in the valid range of RTC hardware  in rtc_subtract_offset()
57 	 * device, then no need to subtract the offset when setting time to RTC  in rtc_subtract_offset()
59 	 * values are valid for RTC hardware device.  in rtc_subtract_offset()
61 	if (secs >= rtc->range_min && secs <= rtc->range_max)  in rtc_subtract_offset()
64 	rtc_time64_to_tm(secs - rtc->offset_secs, tm);  in rtc_subtract_offset()
67 static int rtc_valid_range(struct rtc_device *rtc, struct rtc_time *tm)  in rtc_valid_range()  argument
69 	if (rtc->range_min != rtc->range_max) {  in rtc_valid_range()
71 		time64_t range_min = rtc->set_start_time ? rtc->start_secs :  in rtc_valid_range()
72 			rtc->range_min;  in rtc_valid_range()
73 		timeu64_t range_max = rtc->set_start_time ?  in rtc_valid_range()
74 			(rtc->start_secs + rtc->range_max - rtc->range_min) :  in rtc_valid_range()
75 			rtc->range_max;  in rtc_valid_range()
84 static int __rtc_read_time(struct rtc_device *rtc, struct rtc_time *tm)  in __rtc_read_time()  argument
88 	if (!rtc->ops) {  in __rtc_read_time()
90 	} else if (!rtc->ops->read_time) {  in __rtc_read_time()
94 		err = rtc->ops->read_time(rtc->dev.parent, tm);  in __rtc_read_time()
96 			dev_dbg(&rtc->dev, "read_time: fail to read: %d\n",  in __rtc_read_time()
101 		rtc_add_offset(rtc, tm);  in __rtc_read_time()
105 			dev_dbg(&rtc->dev, "read_time: rtc_time isn't valid\n");  in __rtc_read_time()
110 int rtc_read_time(struct rtc_device *rtc, struct rtc_time *tm)  in rtc_read_time()  argument
114 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_read_time()
118 	err = __rtc_read_time(rtc, tm);  in rtc_read_time()
119 	mutex_unlock(&rtc->ops_lock);  in rtc_read_time()
126 int rtc_set_time(struct rtc_device *rtc, struct rtc_time *tm)  in rtc_set_time()  argument
134 	err = rtc_valid_range(rtc, tm);  in rtc_set_time()
138 	rtc_subtract_offset(rtc, tm);  in rtc_set_time()
141 	uie = rtc->uie_rtctimer.enabled || rtc->uie_irq_active;  in rtc_set_time()
143 	uie = rtc->uie_rtctimer.enabled;  in rtc_set_time()
146 		err = rtc_update_irq_enable(rtc, 0);  in rtc_set_time()
151 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_set_time()
155 	if (!rtc->ops)  in rtc_set_time()
157 	else if (rtc->ops->set_time)  in rtc_set_time()
158 		err = rtc->ops->set_time(rtc->dev.parent, tm);  in rtc_set_time()
162 	pm_stay_awake(rtc->dev.parent);  in rtc_set_time()
163 	mutex_unlock(&rtc->ops_lock);  in rtc_set_time()
165 	schedule_work(&rtc->irqwork);  in rtc_set_time()
168 		err = rtc_update_irq_enable(rtc, 1);  in rtc_set_time()
178 static int rtc_read_alarm_internal(struct rtc_device *rtc,  in rtc_read_alarm_internal()  argument
183 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_read_alarm_internal()
187 	if (!rtc->ops) {  in rtc_read_alarm_internal()
189 	} else if (!test_bit(RTC_FEATURE_ALARM, rtc->features) || !rtc->ops->read_alarm) {  in rtc_read_alarm_internal()
203 		err = rtc->ops->read_alarm(rtc->dev.parent, alarm);  in rtc_read_alarm_internal()
206 	mutex_unlock(&rtc->ops_lock);  in rtc_read_alarm_internal()
212 int __rtc_read_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)  in __rtc_read_alarm()  argument
221 	/* The lower level RTC driver may return -1 in some fields,  in __rtc_read_alarm()
234 	 * a current RTC timestamp for any missing (-1) values.  The  in __rtc_read_alarm()
235 	 * RTC driver prevents "periodic alarm" modes.  in __rtc_read_alarm()
237 	 * But this can be racey, because some fields of the RTC timestamp  in __rtc_read_alarm()
238 	 * may have wrapped in the interval since we read the RTC alarm,  in __rtc_read_alarm()
245 	 * So, we must first read the RTC timestamp,  in __rtc_read_alarm()
246 	 * then read the RTC alarm value,  in __rtc_read_alarm()
247 	 * and then read a second RTC timestamp.  in __rtc_read_alarm()
258 	 * but since more than one lower level RTC implementation needs it,  in __rtc_read_alarm()
263 	err = rtc_read_time(rtc, &before);  in __rtc_read_alarm()
271 		/* get the RTC alarm values, which may be incomplete */  in __rtc_read_alarm()
272 		err = rtc_read_alarm_internal(rtc, alarm);  in __rtc_read_alarm()
278 			rtc_add_offset(rtc, &alarm->time);  in __rtc_read_alarm()
283 		err = rtc_read_time(rtc, &now);  in __rtc_read_alarm()
339 		dev_dbg(&rtc->dev, "alarm rollover: %s\n", "day");  in __rtc_read_alarm()
350 		dev_dbg(&rtc->dev, "alarm rollover: %s\n", "month");  in __rtc_read_alarm()
365 		dev_dbg(&rtc->dev, "alarm rollover: %s\n", "year");  in __rtc_read_alarm()
373 		dev_warn(&rtc->dev, "alarm rollover not handled\n");  in __rtc_read_alarm()
380 		dev_warn(&rtc->dev, "invalid alarm value: %ptR\n",  in __rtc_read_alarm()
386 int rtc_read_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)  in rtc_read_alarm()  argument
390 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_read_alarm()
393 	if (!rtc->ops) {  in rtc_read_alarm()
395 	} else if (!test_bit(RTC_FEATURE_ALARM, rtc->features) || !rtc->ops->read_alarm) {  in rtc_read_alarm()
399 		alarm->enabled = rtc->aie_timer.enabled;  in rtc_read_alarm()
400 		alarm->time = rtc_ktime_to_tm(rtc->aie_timer.node.expires);  in rtc_read_alarm()
402 	mutex_unlock(&rtc->ops_lock);  in rtc_read_alarm()
409 static int __rtc_set_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)  in __rtc_set_alarm()  argument
422 	err = __rtc_read_time(rtc, &tm);  in __rtc_set_alarm()
435 	rtc_subtract_offset(rtc, &alarm->time);  in __rtc_set_alarm()
437 	if (!rtc->ops)  in __rtc_set_alarm()
439 	else if (!test_bit(RTC_FEATURE_ALARM, rtc->features))  in __rtc_set_alarm()
442 		err = rtc->ops->set_alarm(rtc->dev.parent, alarm);  in __rtc_set_alarm()
448 int rtc_set_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)  in rtc_set_alarm()  argument
452 	if (!rtc->ops)  in rtc_set_alarm()
454 	else if (!test_bit(RTC_FEATURE_ALARM, rtc->features))  in rtc_set_alarm()
461 	err = rtc_valid_range(rtc, &alarm->time);  in rtc_set_alarm()
465 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_set_alarm()
468 	if (rtc->aie_timer.enabled)  in rtc_set_alarm()
469 		rtc_timer_remove(rtc, &rtc->aie_timer);  in rtc_set_alarm()
471 	rtc->aie_timer.node.expires = rtc_tm_to_ktime(alarm->time);  in rtc_set_alarm()
472 	rtc->aie_timer.period = 0;  in rtc_set_alarm()
474 		err = rtc_timer_enqueue(rtc, &rtc->aie_timer);  in rtc_set_alarm()
476 	mutex_unlock(&rtc->ops_lock);  in rtc_set_alarm()
483 int rtc_initialize_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)  in rtc_initialize_alarm()  argument
492 	err = rtc_read_time(rtc, &now);  in rtc_initialize_alarm()
496 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_initialize_alarm()
500 	rtc->aie_timer.node.expires = rtc_tm_to_ktime(alarm->time);  in rtc_initialize_alarm()
501 	rtc->aie_timer.period = 0;  in rtc_initialize_alarm()
505 			 rtc->aie_timer.node.expires)) {  in rtc_initialize_alarm()
506 		rtc->aie_timer.enabled = 1;  in rtc_initialize_alarm()
507 		timerqueue_add(&rtc->timerqueue, &rtc->aie_timer.node);  in rtc_initialize_alarm()
508 		trace_rtc_timer_enqueue(&rtc->aie_timer);  in rtc_initialize_alarm()
510 	mutex_unlock(&rtc->ops_lock);  in rtc_initialize_alarm()
515 int rtc_alarm_irq_enable(struct rtc_device *rtc, unsigned int enabled)  in rtc_alarm_irq_enable()  argument
519 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_alarm_irq_enable()
523 	if (rtc->aie_timer.enabled != enabled) {  in rtc_alarm_irq_enable()
525 			err = rtc_timer_enqueue(rtc, &rtc->aie_timer);  in rtc_alarm_irq_enable()
527 			rtc_timer_remove(rtc, &rtc->aie_timer);  in rtc_alarm_irq_enable()
532 	else if (!rtc->ops)  in rtc_alarm_irq_enable()
534 	else if (!test_bit(RTC_FEATURE_ALARM, rtc->features) || !rtc->ops->alarm_irq_enable)  in rtc_alarm_irq_enable()
537 		err = rtc->ops->alarm_irq_enable(rtc->dev.parent, enabled);  in rtc_alarm_irq_enable()
539 	mutex_unlock(&rtc->ops_lock);  in rtc_alarm_irq_enable()
546 int rtc_update_irq_enable(struct rtc_device *rtc, unsigned int enabled)  in rtc_update_irq_enable()  argument
550 	err = mutex_lock_interruptible(&rtc->ops_lock);  in rtc_update_irq_enable()
555 	if (enabled == 0 && rtc->uie_irq_active) {  in rtc_update_irq_enable()
556 		mutex_unlock(&rtc->ops_lock);  in rtc_update_irq_enable()
557 		return rtc_dev_update_irq_enable_emul(rtc, 0);  in rtc_update_irq_enable()
561 	if (rtc->uie_rtctimer.enabled == enabled)  in rtc_update_irq_enable()
564 	if (rtc->uie_unsupported || !test_bit(RTC_FEATURE_ALARM, rtc->features)) {  in rtc_update_irq_enable()
565 		mutex_unlock(&rtc->ops_lock);  in rtc_update_irq_enable()
567 		return rtc_dev_update_irq_enable_emul(rtc, enabled);  in rtc_update_irq_enable()
577 		err = __rtc_read_time(rtc, &tm);  in rtc_update_irq_enable()
582 		rtc->uie_rtctimer.node.expires = ktime_add(now, onesec);  in rtc_update_irq_enable()
583 		rtc->uie_rtctimer.period = ktime_set(1, 0);  in rtc_update_irq_enable()
584 		err = rtc_timer_enqueue(rtc, &rtc->uie_rtctimer);  in rtc_update_irq_enable()
586 		rtc_timer_remove(rtc, &rtc->uie_rtctimer);  in rtc_update_irq_enable()
590 	mutex_unlock(&rtc->ops_lock);  in rtc_update_irq_enable()
598  * @rtc: pointer to the rtc device
606 void rtc_handle_legacy_irq(struct rtc_device *rtc, int num, int mode)  in rtc_handle_legacy_irq()  argument
611 	spin_lock_irqsave(&rtc->irq_lock, flags);  in rtc_handle_legacy_irq()
612 	rtc->irq_data = (rtc->irq_data + (num << 8)) | (RTC_IRQF | mode);  in rtc_handle_legacy_irq()
613 	spin_unlock_irqrestore(&rtc->irq_lock, flags);  in rtc_handle_legacy_irq()
615 	wake_up_interruptible(&rtc->irq_queue);  in rtc_handle_legacy_irq()
616 	kill_fasync(&rtc->async_queue, SIGIO, POLL_IN);  in rtc_handle_legacy_irq()
621  * @rtc: pointer to the rtc_device
625 void rtc_aie_update_irq(struct rtc_device *rtc)  in rtc_aie_update_irq()  argument
627 	rtc_handle_legacy_irq(rtc, 1, RTC_AF);  in rtc_aie_update_irq()
632  * @rtc: pointer to the rtc_device
636 void rtc_uie_update_irq(struct rtc_device *rtc)  in rtc_uie_update_irq()  argument
638 	rtc_handle_legacy_irq(rtc, 1,  RTC_UF);  in rtc_uie_update_irq()
651 	struct rtc_device *rtc;  in rtc_pie_update_irq()  local
655 	rtc = container_of(timer, struct rtc_device, pie_timer);  in rtc_pie_update_irq()
657 	period = NSEC_PER_SEC / rtc->irq_freq;  in rtc_pie_update_irq()
660 	rtc_handle_legacy_irq(rtc, count, RTC_PF);  in rtc_pie_update_irq()
666  * rtc_update_irq - Triggered when a RTC interrupt occurs.
667  * @rtc: the rtc device
672 void rtc_update_irq(struct rtc_device *rtc,  in rtc_update_irq()  argument
675 	if (IS_ERR_OR_NULL(rtc))  in rtc_update_irq()
678 	pm_stay_awake(rtc->dev.parent);  in rtc_update_irq()
679 	schedule_work(&rtc->irqwork);  in rtc_update_irq()
686 	struct rtc_device *rtc = NULL;  in rtc_class_open()  local
690 		rtc = to_rtc_device(dev);  in rtc_class_open()
692 	if (rtc) {  in rtc_class_open()
693 		if (!try_module_get(rtc->owner)) {  in rtc_class_open()
695 			rtc = NULL;  in rtc_class_open()
699 	return rtc;  in rtc_class_open()
703 void rtc_class_close(struct rtc_device *rtc)  in rtc_class_close()  argument
705 	module_put(rtc->owner);  in rtc_class_close()
706 	put_device(&rtc->dev);  in rtc_class_close()
710 static int rtc_update_hrtimer(struct rtc_device *rtc, int enabled)  in rtc_update_hrtimer()  argument
719 	 * could be blocked on rtc->irq_task_lock and hrtimer_cancel()  in rtc_update_hrtimer()
722 	if (hrtimer_try_to_cancel(&rtc->pie_timer) < 0)  in rtc_update_hrtimer()
726 		ktime_t period = NSEC_PER_SEC / rtc->irq_freq;  in rtc_update_hrtimer()
728 		hrtimer_start(&rtc->pie_timer, period, HRTIMER_MODE_REL);  in rtc_update_hrtimer()
735  * @rtc: the rtc device
742 int rtc_irq_set_state(struct rtc_device *rtc, int enabled)  in rtc_irq_set_state()  argument
746 	while (rtc_update_hrtimer(rtc, enabled) < 0)  in rtc_irq_set_state()
749 	rtc->pie_enabled = enabled;  in rtc_irq_set_state()
757  * @rtc: the rtc device
764 int rtc_irq_set_freq(struct rtc_device *rtc, int freq)  in rtc_irq_set_freq()  argument
771 	rtc->irq_freq = freq;  in rtc_irq_set_freq()
772 	while (rtc->pie_enabled && rtc_update_hrtimer(rtc, 1) < 0)  in rtc_irq_set_freq()
781  * @rtc: rtc device
784  * Enqueues a timer onto the rtc devices timerqueue and sets
791 static int rtc_timer_enqueue(struct rtc_device *rtc, struct rtc_timer *timer)  in rtc_timer_enqueue()  argument
793 	struct timerqueue_node *next = timerqueue_getnext(&rtc->timerqueue);  in rtc_timer_enqueue()
798 	__rtc_read_time(rtc, &tm);  in rtc_timer_enqueue()
808 	timerqueue_add(&rtc->timerqueue, &timer->node);  in rtc_timer_enqueue()
816 		err = __rtc_set_alarm(rtc, &alarm);  in rtc_timer_enqueue()
818 			pm_stay_awake(rtc->dev.parent);  in rtc_timer_enqueue()
819 			schedule_work(&rtc->irqwork);  in rtc_timer_enqueue()
821 			timerqueue_del(&rtc->timerqueue, &timer->node);  in rtc_timer_enqueue()
830 static void rtc_alarm_disable(struct rtc_device *rtc)  in rtc_alarm_disable()  argument
832 	if (!rtc->ops || !test_bit(RTC_FEATURE_ALARM, rtc->features) || !rtc->ops->alarm_irq_enable)  in rtc_alarm_disable()
835 	rtc->ops->alarm_irq_enable(rtc->dev.parent, false);  in rtc_alarm_disable()
841  * @rtc: rtc device
844  * Removes a timer onto the rtc devices timerqueue and sets
851 static void rtc_timer_remove(struct rtc_device *rtc, struct rtc_timer *timer)  in rtc_timer_remove()  argument
853 	struct timerqueue_node *next = timerqueue_getnext(&rtc->timerqueue);  in rtc_timer_remove()
855 	timerqueue_del(&rtc->timerqueue, &timer->node);  in rtc_timer_remove()
862 		next = timerqueue_getnext(&rtc->timerqueue);  in rtc_timer_remove()
864 			rtc_alarm_disable(rtc);  in rtc_timer_remove()
869 		err = __rtc_set_alarm(rtc, &alarm);  in rtc_timer_remove()
871 			pm_stay_awake(rtc->dev.parent);  in rtc_timer_remove()
872 			schedule_work(&rtc->irqwork);  in rtc_timer_remove()
878  * rtc_timer_do_work - Expires rtc timers
881  * Expires rtc timers. Reprograms next alarm event if needed.
893 	struct rtc_device *rtc =  in rtc_timer_do_work()  local
896 	mutex_lock(&rtc->ops_lock);  in rtc_timer_do_work()
898 	__rtc_read_time(rtc, &tm);  in rtc_timer_do_work()
900 	while ((next = timerqueue_getnext(&rtc->timerqueue))) {  in rtc_timer_do_work()
906 		timerqueue_del(&rtc->timerqueue, &timer->node);  in rtc_timer_do_work()
910 			timer->func(timer->rtc);  in rtc_timer_do_work()
918 			timerqueue_add(&rtc->timerqueue, &timer->node);  in rtc_timer_do_work()
932 		err = __rtc_set_alarm(rtc, &alarm);  in rtc_timer_do_work()
940 			timerqueue_del(&rtc->timerqueue, &timer->node);  in rtc_timer_do_work()
943 			dev_err(&rtc->dev, "__rtc_set_alarm: err=%d\n", err);  in rtc_timer_do_work()
947 		rtc_alarm_disable(rtc);  in rtc_timer_do_work()
950 	pm_relax(rtc->dev.parent);  in rtc_timer_do_work()
951 	mutex_unlock(&rtc->ops_lock);  in rtc_timer_do_work()
957  * @rtc: pointer to the rtc_device
962 		    struct rtc_device *rtc)  in rtc_timer_init()  argument
967 	timer->rtc = rtc;  in rtc_timer_init()
971  * @ rtc: rtc device to be used
978 int rtc_timer_start(struct rtc_device *rtc, struct rtc_timer *timer,  in rtc_timer_start()  argument
983 	mutex_lock(&rtc->ops_lock);  in rtc_timer_start()
985 		rtc_timer_remove(rtc, timer);  in rtc_timer_start()
990 	ret = rtc_timer_enqueue(rtc, timer);  in rtc_timer_start()
992 	mutex_unlock(&rtc->ops_lock);  in rtc_timer_start()
997  * @ rtc: rtc device to be used
1002 void rtc_timer_cancel(struct rtc_device *rtc, struct rtc_timer *timer)  in rtc_timer_cancel()  argument
1004 	mutex_lock(&rtc->ops_lock);  in rtc_timer_cancel()
1006 		rtc_timer_remove(rtc, timer);  in rtc_timer_cancel()
1007 	mutex_unlock(&rtc->ops_lock);  in rtc_timer_cancel()
1011  * rtc_read_offset - Read the amount of rtc offset in parts per billion
1012  * @rtc: rtc device to be used
1017  * Kernel interface to read rtc clock offset
1019  * If read_offset() is not implemented for the rtc, return -EINVAL
1021 int rtc_read_offset(struct rtc_device *rtc, long *offset)  in rtc_read_offset()  argument
1025 	if (!rtc->ops)  in rtc_read_offset()
1028 	if (!rtc->ops->read_offset)  in rtc_read_offset()
1031 	mutex_lock(&rtc->ops_lock);  in rtc_read_offset()
1032 	ret = rtc->ops->read_offset(rtc->dev.parent, offset);  in rtc_read_offset()
1033 	mutex_unlock(&rtc->ops_lock);  in rtc_read_offset()
1041  * @rtc: rtc device to be used
1044  * Some rtc's allow an adjustment to the average duration of a second
1050  * where t0 is the measured length of 1 RTC second with offset = 0
1052  * Kernel interface to adjust an rtc clock offset.
1054  * If the rtc offset is not setable (or not implemented), return -EINVAL
1056 int rtc_set_offset(struct rtc_device *rtc, long offset)  in rtc_set_offset()  argument
1060 	if (!rtc->ops)  in rtc_set_offset()
1063 	if (!rtc->ops->set_offset)  in rtc_set_offset()
1066 	mutex_lock(&rtc->ops_lock);  in rtc_set_offset()
1067 	ret = rtc->ops->set_offset(rtc->dev.parent, offset);  in rtc_set_offset()
1068 	mutex_unlock(&rtc->ops_lock);  in rtc_set_offset()