xref: /linux/drivers/rtc/rtc-jz4740.c (revision f2527d8f566a45fa00ee5abd04d1c9476d4d704f)
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  *  Copyright (C) 2009-2010, Lars-Peter Clausen <lars@metafoo.de>
4  *  Copyright (C) 2010, Paul Cercueil <paul@crapouillou.net>
5  *	 JZ4740 SoC RTC driver
6  */
7 
8 #include <linux/clk.h>
9 #include <linux/io.h>
10 #include <linux/kernel.h>
11 #include <linux/module.h>
12 #include <linux/of_device.h>
13 #include <linux/platform_device.h>
14 #include <linux/pm_wakeirq.h>
15 #include <linux/reboot.h>
16 #include <linux/rtc.h>
17 #include <linux/slab.h>
18 #include <linux/spinlock.h>
19 
20 #define JZ_REG_RTC_CTRL		0x00
21 #define JZ_REG_RTC_SEC		0x04
22 #define JZ_REG_RTC_SEC_ALARM	0x08
23 #define JZ_REG_RTC_REGULATOR	0x0C
24 #define JZ_REG_RTC_HIBERNATE	0x20
25 #define JZ_REG_RTC_WAKEUP_FILTER	0x24
26 #define JZ_REG_RTC_RESET_COUNTER	0x28
27 #define JZ_REG_RTC_SCRATCHPAD	0x34
28 
29 /* The following are present on the jz4780 */
30 #define JZ_REG_RTC_WENR	0x3C
31 #define JZ_RTC_WENR_WEN	BIT(31)
32 
33 #define JZ_RTC_CTRL_WRDY	BIT(7)
34 #define JZ_RTC_CTRL_1HZ		BIT(6)
35 #define JZ_RTC_CTRL_1HZ_IRQ	BIT(5)
36 #define JZ_RTC_CTRL_AF		BIT(4)
37 #define JZ_RTC_CTRL_AF_IRQ	BIT(3)
38 #define JZ_RTC_CTRL_AE		BIT(2)
39 #define JZ_RTC_CTRL_ENABLE	BIT(0)
40 
41 /* Magic value to enable writes on jz4780 */
42 #define JZ_RTC_WENR_MAGIC	0xA55A
43 
44 #define JZ_RTC_WAKEUP_FILTER_MASK	0x0000FFE0
45 #define JZ_RTC_RESET_COUNTER_MASK	0x00000FE0
46 
47 enum jz4740_rtc_type {
48 	ID_JZ4740,
49 	ID_JZ4760,
50 	ID_JZ4780,
51 };
52 
53 struct jz4740_rtc {
54 	void __iomem *base;
55 	enum jz4740_rtc_type type;
56 
57 	struct rtc_device *rtc;
58 
59 	spinlock_t lock;
60 };
61 
62 static struct device *dev_for_power_off;
63 
64 static inline uint32_t jz4740_rtc_reg_read(struct jz4740_rtc *rtc, size_t reg)
65 {
66 	return readl(rtc->base + reg);
67 }
68 
69 static int jz4740_rtc_wait_write_ready(struct jz4740_rtc *rtc)
70 {
71 	uint32_t ctrl;
72 	int timeout = 10000;
73 
74 	do {
75 		ctrl = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_CTRL);
76 	} while (!(ctrl & JZ_RTC_CTRL_WRDY) && --timeout);
77 
78 	return timeout ? 0 : -EIO;
79 }
80 
81 static inline int jz4780_rtc_enable_write(struct jz4740_rtc *rtc)
82 {
83 	uint32_t ctrl;
84 	int ret, timeout = 10000;
85 
86 	ret = jz4740_rtc_wait_write_ready(rtc);
87 	if (ret != 0)
88 		return ret;
89 
90 	writel(JZ_RTC_WENR_MAGIC, rtc->base + JZ_REG_RTC_WENR);
91 
92 	do {
93 		ctrl = readl(rtc->base + JZ_REG_RTC_WENR);
94 	} while (!(ctrl & JZ_RTC_WENR_WEN) && --timeout);
95 
96 	return timeout ? 0 : -EIO;
97 }
98 
99 static inline int jz4740_rtc_reg_write(struct jz4740_rtc *rtc, size_t reg,
100 	uint32_t val)
101 {
102 	int ret = 0;
103 
104 	if (rtc->type >= ID_JZ4760)
105 		ret = jz4780_rtc_enable_write(rtc);
106 	if (ret == 0)
107 		ret = jz4740_rtc_wait_write_ready(rtc);
108 	if (ret == 0)
109 		writel(val, rtc->base + reg);
110 
111 	return ret;
112 }
113 
114 static int jz4740_rtc_ctrl_set_bits(struct jz4740_rtc *rtc, uint32_t mask,
115 	bool set)
116 {
117 	int ret;
118 	unsigned long flags;
119 	uint32_t ctrl;
120 
121 	spin_lock_irqsave(&rtc->lock, flags);
122 
123 	ctrl = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_CTRL);
124 
125 	/* Don't clear interrupt flags by accident */
126 	ctrl |= JZ_RTC_CTRL_1HZ | JZ_RTC_CTRL_AF;
127 
128 	if (set)
129 		ctrl |= mask;
130 	else
131 		ctrl &= ~mask;
132 
133 	ret = jz4740_rtc_reg_write(rtc, JZ_REG_RTC_CTRL, ctrl);
134 
135 	spin_unlock_irqrestore(&rtc->lock, flags);
136 
137 	return ret;
138 }
139 
140 static int jz4740_rtc_read_time(struct device *dev, struct rtc_time *time)
141 {
142 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
143 	uint32_t secs, secs2;
144 	int timeout = 5;
145 
146 	if (jz4740_rtc_reg_read(rtc, JZ_REG_RTC_SCRATCHPAD) != 0x12345678)
147 		return -EINVAL;
148 
149 	/* If the seconds register is read while it is updated, it can contain a
150 	 * bogus value. This can be avoided by making sure that two consecutive
151 	 * reads have the same value.
152 	 */
153 	secs = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_SEC);
154 	secs2 = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_SEC);
155 
156 	while (secs != secs2 && --timeout) {
157 		secs = secs2;
158 		secs2 = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_SEC);
159 	}
160 
161 	if (timeout == 0)
162 		return -EIO;
163 
164 	rtc_time64_to_tm(secs, time);
165 
166 	return 0;
167 }
168 
169 static int jz4740_rtc_set_time(struct device *dev, struct rtc_time *time)
170 {
171 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
172 	int ret;
173 
174 	ret = jz4740_rtc_reg_write(rtc, JZ_REG_RTC_SEC, rtc_tm_to_time64(time));
175 	if (ret)
176 		return ret;
177 
178 	return jz4740_rtc_reg_write(rtc, JZ_REG_RTC_SCRATCHPAD, 0x12345678);
179 }
180 
181 static int jz4740_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
182 {
183 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
184 	uint32_t secs;
185 	uint32_t ctrl;
186 
187 	secs = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_SEC_ALARM);
188 
189 	ctrl = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_CTRL);
190 
191 	alrm->enabled = !!(ctrl & JZ_RTC_CTRL_AE);
192 	alrm->pending = !!(ctrl & JZ_RTC_CTRL_AF);
193 
194 	rtc_time64_to_tm(secs, &alrm->time);
195 
196 	return 0;
197 }
198 
199 static int jz4740_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
200 {
201 	int ret;
202 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
203 	uint32_t secs = lower_32_bits(rtc_tm_to_time64(&alrm->time));
204 
205 	ret = jz4740_rtc_reg_write(rtc, JZ_REG_RTC_SEC_ALARM, secs);
206 	if (!ret)
207 		ret = jz4740_rtc_ctrl_set_bits(rtc,
208 			JZ_RTC_CTRL_AE | JZ_RTC_CTRL_AF_IRQ, alrm->enabled);
209 
210 	return ret;
211 }
212 
213 static int jz4740_rtc_alarm_irq_enable(struct device *dev, unsigned int enable)
214 {
215 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
216 	return jz4740_rtc_ctrl_set_bits(rtc, JZ_RTC_CTRL_AF_IRQ, enable);
217 }
218 
219 static const struct rtc_class_ops jz4740_rtc_ops = {
220 	.read_time	= jz4740_rtc_read_time,
221 	.set_time	= jz4740_rtc_set_time,
222 	.read_alarm	= jz4740_rtc_read_alarm,
223 	.set_alarm	= jz4740_rtc_set_alarm,
224 	.alarm_irq_enable = jz4740_rtc_alarm_irq_enable,
225 };
226 
227 static irqreturn_t jz4740_rtc_irq(int irq, void *data)
228 {
229 	struct jz4740_rtc *rtc = data;
230 	uint32_t ctrl;
231 	unsigned long events = 0;
232 
233 	ctrl = jz4740_rtc_reg_read(rtc, JZ_REG_RTC_CTRL);
234 
235 	if (ctrl & JZ_RTC_CTRL_1HZ)
236 		events |= (RTC_UF | RTC_IRQF);
237 
238 	if (ctrl & JZ_RTC_CTRL_AF)
239 		events |= (RTC_AF | RTC_IRQF);
240 
241 	rtc_update_irq(rtc->rtc, 1, events);
242 
243 	jz4740_rtc_ctrl_set_bits(rtc, JZ_RTC_CTRL_1HZ | JZ_RTC_CTRL_AF, false);
244 
245 	return IRQ_HANDLED;
246 }
247 
248 static void jz4740_rtc_poweroff(struct device *dev)
249 {
250 	struct jz4740_rtc *rtc = dev_get_drvdata(dev);
251 	jz4740_rtc_reg_write(rtc, JZ_REG_RTC_HIBERNATE, 1);
252 }
253 
254 static void jz4740_rtc_power_off(void)
255 {
256 	jz4740_rtc_poweroff(dev_for_power_off);
257 	kernel_halt();
258 }
259 
260 static const struct of_device_id jz4740_rtc_of_match[] = {
261 	{ .compatible = "ingenic,jz4740-rtc", .data = (void *)ID_JZ4740 },
262 	{ .compatible = "ingenic,jz4760-rtc", .data = (void *)ID_JZ4760 },
263 	{ .compatible = "ingenic,jz4780-rtc", .data = (void *)ID_JZ4780 },
264 	{},
265 };
266 MODULE_DEVICE_TABLE(of, jz4740_rtc_of_match);
267 
268 static void jz4740_rtc_set_wakeup_params(struct jz4740_rtc *rtc,
269 					 struct device_node *np,
270 					 unsigned long rate)
271 {
272 	unsigned long wakeup_ticks, reset_ticks;
273 	unsigned int min_wakeup_pin_assert_time = 60; /* Default: 60ms */
274 	unsigned int reset_pin_assert_time = 100; /* Default: 100ms */
275 
276 	of_property_read_u32(np, "ingenic,reset-pin-assert-time-ms",
277 			     &reset_pin_assert_time);
278 	of_property_read_u32(np, "ingenic,min-wakeup-pin-assert-time-ms",
279 			     &min_wakeup_pin_assert_time);
280 
281 	/*
282 	 * Set minimum wakeup pin assertion time: 100 ms.
283 	 * Range is 0 to 2 sec if RTC is clocked at 32 kHz.
284 	 */
285 	wakeup_ticks = (min_wakeup_pin_assert_time * rate) / 1000;
286 	if (wakeup_ticks < JZ_RTC_WAKEUP_FILTER_MASK)
287 		wakeup_ticks &= JZ_RTC_WAKEUP_FILTER_MASK;
288 	else
289 		wakeup_ticks = JZ_RTC_WAKEUP_FILTER_MASK;
290 	jz4740_rtc_reg_write(rtc, JZ_REG_RTC_WAKEUP_FILTER, wakeup_ticks);
291 
292 	/*
293 	 * Set reset pin low-level assertion time after wakeup: 60 ms.
294 	 * Range is 0 to 125 ms if RTC is clocked at 32 kHz.
295 	 */
296 	reset_ticks = (reset_pin_assert_time * rate) / 1000;
297 	if (reset_ticks < JZ_RTC_RESET_COUNTER_MASK)
298 		reset_ticks &= JZ_RTC_RESET_COUNTER_MASK;
299 	else
300 		reset_ticks = JZ_RTC_RESET_COUNTER_MASK;
301 	jz4740_rtc_reg_write(rtc, JZ_REG_RTC_RESET_COUNTER, reset_ticks);
302 }
303 
304 static int jz4740_rtc_probe(struct platform_device *pdev)
305 {
306 	struct device *dev = &pdev->dev;
307 	struct device_node *np = dev->of_node;
308 	struct jz4740_rtc *rtc;
309 	unsigned long rate;
310 	struct clk *clk;
311 	int ret, irq;
312 
313 	rtc = devm_kzalloc(dev, sizeof(*rtc), GFP_KERNEL);
314 	if (!rtc)
315 		return -ENOMEM;
316 
317 	rtc->type = (enum jz4740_rtc_type)device_get_match_data(dev);
318 
319 	irq = platform_get_irq(pdev, 0);
320 	if (irq < 0)
321 		return irq;
322 
323 	rtc->base = devm_platform_ioremap_resource(pdev, 0);
324 	if (IS_ERR(rtc->base))
325 		return PTR_ERR(rtc->base);
326 
327 	clk = devm_clk_get_enabled(dev, "rtc");
328 	if (IS_ERR(clk))
329 		return dev_err_probe(dev, PTR_ERR(clk), "Failed to get RTC clock\n");
330 
331 	spin_lock_init(&rtc->lock);
332 
333 	platform_set_drvdata(pdev, rtc);
334 
335 	device_init_wakeup(dev, 1);
336 
337 	ret = dev_pm_set_wake_irq(dev, irq);
338 	if (ret) {
339 		dev_err(dev, "Failed to set wake irq: %d\n", ret);
340 		return ret;
341 	}
342 
343 	rtc->rtc = devm_rtc_allocate_device(dev);
344 	if (IS_ERR(rtc->rtc)) {
345 		ret = PTR_ERR(rtc->rtc);
346 		dev_err(dev, "Failed to allocate rtc device: %d\n", ret);
347 		return ret;
348 	}
349 
350 	rtc->rtc->ops = &jz4740_rtc_ops;
351 	rtc->rtc->range_max = U32_MAX;
352 
353 	rate = clk_get_rate(clk);
354 	jz4740_rtc_set_wakeup_params(rtc, np, rate);
355 
356 	/* Each 1 Hz pulse should happen after (rate) ticks */
357 	jz4740_rtc_reg_write(rtc, JZ_REG_RTC_REGULATOR, rate - 1);
358 
359 	ret = devm_rtc_register_device(rtc->rtc);
360 	if (ret)
361 		return ret;
362 
363 	ret = devm_request_irq(dev, irq, jz4740_rtc_irq, 0,
364 			       pdev->name, rtc);
365 	if (ret) {
366 		dev_err(dev, "Failed to request rtc irq: %d\n", ret);
367 		return ret;
368 	}
369 
370 	if (of_device_is_system_power_controller(np)) {
371 		dev_for_power_off = dev;
372 
373 		if (!pm_power_off)
374 			pm_power_off = jz4740_rtc_power_off;
375 		else
376 			dev_warn(dev, "Poweroff handler already present!\n");
377 	}
378 
379 	return 0;
380 }
381 
382 static struct platform_driver jz4740_rtc_driver = {
383 	.probe	 = jz4740_rtc_probe,
384 	.driver	 = {
385 		.name  = "jz4740-rtc",
386 		.of_match_table = jz4740_rtc_of_match,
387 	},
388 };
389 
390 module_platform_driver(jz4740_rtc_driver);
391 
392 MODULE_AUTHOR("Lars-Peter Clausen <lars@metafoo.de>");
393 MODULE_LICENSE("GPL");
394 MODULE_DESCRIPTION("RTC driver for the JZ4740 SoC\n");
395 MODULE_ALIAS("platform:jz4740-rtc");
396