Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

Apr 14-17, 2025
Register
Loading...
Note: File does not exist in v3.1.
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * This file contains driver for the Cadence Triple Timer Counter Rev 06
  4 *
  5 *  Copyright (C) 2011-2013 Xilinx
  6 *
  7 * based on arch/mips/kernel/time.c timer driver
  8 */
  9
 10#include <linux/clk.h>
 11#include <linux/interrupt.h>
 12#include <linux/clockchips.h>
 13#include <linux/clocksource.h>
 14#include <linux/of_address.h>
 15#include <linux/of_irq.h>
 16#include <linux/slab.h>
 17#include <linux/sched_clock.h>
 18
 19/*
 20 * This driver configures the 2 16/32-bit count-up timers as follows:
 21 *
 22 * T1: Timer 1, clocksource for generic timekeeping
 23 * T2: Timer 2, clockevent source for hrtimers
 24 * T3: Timer 3, <unused>
 25 *
 26 * The input frequency to the timer module for emulation is 2.5MHz which is
 27 * common to all the timer channels (T1, T2, and T3). With a pre-scaler of 32,
 28 * the timers are clocked at 78.125KHz (12.8 us resolution).
 29
 30 * The input frequency to the timer module in silicon is configurable and
 31 * obtained from device tree. The pre-scaler of 32 is used.
 32 */
 33
 34/*
 35 * Timer Register Offset Definitions of Timer 1, Increment base address by 4
 36 * and use same offsets for Timer 2
 37 */
 38#define TTC_CLK_CNTRL_OFFSET		0x00 /* Clock Control Reg, RW */
 39#define TTC_CNT_CNTRL_OFFSET		0x0C /* Counter Control Reg, RW */
 40#define TTC_COUNT_VAL_OFFSET		0x18 /* Counter Value Reg, RO */
 41#define TTC_INTR_VAL_OFFSET		0x24 /* Interval Count Reg, RW */
 42#define TTC_ISR_OFFSET		0x54 /* Interrupt Status Reg, RO */
 43#define TTC_IER_OFFSET		0x60 /* Interrupt Enable Reg, RW */
 44
 45#define TTC_CNT_CNTRL_DISABLE_MASK	0x1
 46
 47#define TTC_CLK_CNTRL_CSRC_MASK		(1 << 5)	/* clock source */
 48#define TTC_CLK_CNTRL_PSV_MASK		0x1e
 49#define TTC_CLK_CNTRL_PSV_SHIFT		1
 50
 51/*
 52 * Setup the timers to use pre-scaling, using a fixed value for now that will
 53 * work across most input frequency, but it may need to be more dynamic
 54 */
 55#define PRESCALE_EXPONENT	11	/* 2 ^ PRESCALE_EXPONENT = PRESCALE */
 56#define PRESCALE		2048	/* The exponent must match this */
 57#define CLK_CNTRL_PRESCALE	((PRESCALE_EXPONENT - 1) << 1)
 58#define CLK_CNTRL_PRESCALE_EN	1
 59#define CNT_CNTRL_RESET		(1 << 4)
 60
 61#define MAX_F_ERR 50
 62
 63/**
 64 * struct ttc_timer - This definition defines local timer structure
 65 *
 66 * @base_addr:	Base address of timer
 67 * @freq:	Timer input clock frequency
 68 * @clk:	Associated clock source
 69 * @clk_rate_change_nb	Notifier block for clock rate changes
 70 */
 71struct ttc_timer {
 72	void __iomem *base_addr;
 73	unsigned long freq;
 74	struct clk *clk;
 75	struct notifier_block clk_rate_change_nb;
 76};
 77
 78#define to_ttc_timer(x) \
 79		container_of(x, struct ttc_timer, clk_rate_change_nb)
 80
 81struct ttc_timer_clocksource {
 82	u32			scale_clk_ctrl_reg_old;
 83	u32			scale_clk_ctrl_reg_new;
 84	struct ttc_timer	ttc;
 85	struct clocksource	cs;
 86};
 87
 88#define to_ttc_timer_clksrc(x) \
 89		container_of(x, struct ttc_timer_clocksource, cs)
 90
 91struct ttc_timer_clockevent {
 92	struct ttc_timer		ttc;
 93	struct clock_event_device	ce;
 94};
 95
 96#define to_ttc_timer_clkevent(x) \
 97		container_of(x, struct ttc_timer_clockevent, ce)
 98
 99static void __iomem *ttc_sched_clock_val_reg;
100
101/**
102 * ttc_set_interval - Set the timer interval value
103 *
104 * @timer:	Pointer to the timer instance
105 * @cycles:	Timer interval ticks
106 **/
107static void ttc_set_interval(struct ttc_timer *timer,
108					unsigned long cycles)
109{
110	u32 ctrl_reg;
111
112	/* Disable the counter, set the counter value  and re-enable counter */
113	ctrl_reg = readl_relaxed(timer->base_addr + TTC_CNT_CNTRL_OFFSET);
114	ctrl_reg |= TTC_CNT_CNTRL_DISABLE_MASK;
115	writel_relaxed(ctrl_reg, timer->base_addr + TTC_CNT_CNTRL_OFFSET);
116
117	writel_relaxed(cycles, timer->base_addr + TTC_INTR_VAL_OFFSET);
118
119	/*
120	 * Reset the counter (0x10) so that it starts from 0, one-shot
121	 * mode makes this needed for timing to be right.
122	 */
123	ctrl_reg |= CNT_CNTRL_RESET;
124	ctrl_reg &= ~TTC_CNT_CNTRL_DISABLE_MASK;
125	writel_relaxed(ctrl_reg, timer->base_addr + TTC_CNT_CNTRL_OFFSET);
126}
127
128/**
129 * ttc_clock_event_interrupt - Clock event timer interrupt handler
130 *
131 * @irq:	IRQ number of the Timer
132 * @dev_id:	void pointer to the ttc_timer instance
133 *
134 * returns: Always IRQ_HANDLED - success
135 **/
136static irqreturn_t ttc_clock_event_interrupt(int irq, void *dev_id)
137{
138	struct ttc_timer_clockevent *ttce = dev_id;
139	struct ttc_timer *timer = &ttce->ttc;
140
141	/* Acknowledge the interrupt and call event handler */
142	readl_relaxed(timer->base_addr + TTC_ISR_OFFSET);
143
144	ttce->ce.event_handler(&ttce->ce);
145
146	return IRQ_HANDLED;
147}
148
149/**
150 * __ttc_clocksource_read - Reads the timer counter register
151 *
152 * returns: Current timer counter register value
153 **/
154static u64 __ttc_clocksource_read(struct clocksource *cs)
155{
156	struct ttc_timer *timer = &to_ttc_timer_clksrc(cs)->ttc;
157
158	return (u64)readl_relaxed(timer->base_addr +
159				TTC_COUNT_VAL_OFFSET);
160}
161
162static u64 notrace ttc_sched_clock_read(void)
163{
164	return readl_relaxed(ttc_sched_clock_val_reg);
165}
166
167/**
168 * ttc_set_next_event - Sets the time interval for next event
169 *
170 * @cycles:	Timer interval ticks
171 * @evt:	Address of clock event instance
172 *
173 * returns: Always 0 - success
174 **/
175static int ttc_set_next_event(unsigned long cycles,
176					struct clock_event_device *evt)
177{
178	struct ttc_timer_clockevent *ttce = to_ttc_timer_clkevent(evt);
179	struct ttc_timer *timer = &ttce->ttc;
180
181	ttc_set_interval(timer, cycles);
182	return 0;
183}
184
185/**
186 * ttc_set_{shutdown|oneshot|periodic} - Sets the state of timer
187 *
188 * @evt:	Address of clock event instance
189 **/
190static int ttc_shutdown(struct clock_event_device *evt)
191{
192	struct ttc_timer_clockevent *ttce = to_ttc_timer_clkevent(evt);
193	struct ttc_timer *timer = &ttce->ttc;
194	u32 ctrl_reg;
195
196	ctrl_reg = readl_relaxed(timer->base_addr + TTC_CNT_CNTRL_OFFSET);
197	ctrl_reg |= TTC_CNT_CNTRL_DISABLE_MASK;
198	writel_relaxed(ctrl_reg, timer->base_addr + TTC_CNT_CNTRL_OFFSET);
199	return 0;
200}
201
202static int ttc_set_periodic(struct clock_event_device *evt)
203{
204	struct ttc_timer_clockevent *ttce = to_ttc_timer_clkevent(evt);
205	struct ttc_timer *timer = &ttce->ttc;
206
207	ttc_set_interval(timer,
208			 DIV_ROUND_CLOSEST(ttce->ttc.freq, PRESCALE * HZ));
209	return 0;
210}
211
212static int ttc_resume(struct clock_event_device *evt)
213{
214	struct ttc_timer_clockevent *ttce = to_ttc_timer_clkevent(evt);
215	struct ttc_timer *timer = &ttce->ttc;
216	u32 ctrl_reg;
217
218	ctrl_reg = readl_relaxed(timer->base_addr + TTC_CNT_CNTRL_OFFSET);
219	ctrl_reg &= ~TTC_CNT_CNTRL_DISABLE_MASK;
220	writel_relaxed(ctrl_reg, timer->base_addr + TTC_CNT_CNTRL_OFFSET);
221	return 0;
222}
223
224static int ttc_rate_change_clocksource_cb(struct notifier_block *nb,
225		unsigned long event, void *data)
226{
227	struct clk_notifier_data *ndata = data;
228	struct ttc_timer *ttc = to_ttc_timer(nb);
229	struct ttc_timer_clocksource *ttccs = container_of(ttc,
230			struct ttc_timer_clocksource, ttc);
231
232	switch (event) {
233	case PRE_RATE_CHANGE:
234	{
235		u32 psv;
236		unsigned long factor, rate_low, rate_high;
237
238		if (ndata->new_rate > ndata->old_rate) {
239			factor = DIV_ROUND_CLOSEST(ndata->new_rate,
240					ndata->old_rate);
241			rate_low = ndata->old_rate;
242			rate_high = ndata->new_rate;
243		} else {
244			factor = DIV_ROUND_CLOSEST(ndata->old_rate,
245					ndata->new_rate);
246			rate_low = ndata->new_rate;
247			rate_high = ndata->old_rate;
248		}
249
250		if (!is_power_of_2(factor))
251				return NOTIFY_BAD;
252
253		if (abs(rate_high - (factor * rate_low)) > MAX_F_ERR)
254			return NOTIFY_BAD;
255
256		factor = __ilog2_u32(factor);
257
258		/*
259		 * store timer clock ctrl register so we can restore it in case
260		 * of an abort.
261		 */
262		ttccs->scale_clk_ctrl_reg_old =
263			readl_relaxed(ttccs->ttc.base_addr +
264			TTC_CLK_CNTRL_OFFSET);
265
266		psv = (ttccs->scale_clk_ctrl_reg_old &
267				TTC_CLK_CNTRL_PSV_MASK) >>
268				TTC_CLK_CNTRL_PSV_SHIFT;
269		if (ndata->new_rate < ndata->old_rate)
270			psv -= factor;
271		else
272			psv += factor;
273
274		/* prescaler within legal range? */
275		if (psv & ~(TTC_CLK_CNTRL_PSV_MASK >> TTC_CLK_CNTRL_PSV_SHIFT))
276			return NOTIFY_BAD;
277
278		ttccs->scale_clk_ctrl_reg_new = ttccs->scale_clk_ctrl_reg_old &
279			~TTC_CLK_CNTRL_PSV_MASK;
280		ttccs->scale_clk_ctrl_reg_new |= psv << TTC_CLK_CNTRL_PSV_SHIFT;
281
282
283		/* scale down: adjust divider in post-change notification */
284		if (ndata->new_rate < ndata->old_rate)
285			return NOTIFY_DONE;
286
287		/* scale up: adjust divider now - before frequency change */
288		writel_relaxed(ttccs->scale_clk_ctrl_reg_new,
289			       ttccs->ttc.base_addr + TTC_CLK_CNTRL_OFFSET);
290		break;
291	}
292	case POST_RATE_CHANGE:
293		/* scale up: pre-change notification did the adjustment */
294		if (ndata->new_rate > ndata->old_rate)
295			return NOTIFY_OK;
296
297		/* scale down: adjust divider now - after frequency change */
298		writel_relaxed(ttccs->scale_clk_ctrl_reg_new,
299			       ttccs->ttc.base_addr + TTC_CLK_CNTRL_OFFSET);
300		break;
301
302	case ABORT_RATE_CHANGE:
303		/* we have to undo the adjustment in case we scale up */
304		if (ndata->new_rate < ndata->old_rate)
305			return NOTIFY_OK;
306
307		/* restore original register value */
308		writel_relaxed(ttccs->scale_clk_ctrl_reg_old,
309			       ttccs->ttc.base_addr + TTC_CLK_CNTRL_OFFSET);
310		/* fall through */
311	default:
312		return NOTIFY_DONE;
313	}
314
315	return NOTIFY_DONE;
316}
317
318static int __init ttc_setup_clocksource(struct clk *clk, void __iomem *base,
319					 u32 timer_width)
320{
321	struct ttc_timer_clocksource *ttccs;
322	int err;
323
324	ttccs = kzalloc(sizeof(*ttccs), GFP_KERNEL);
325	if (!ttccs)
326		return -ENOMEM;
327
328	ttccs->ttc.clk = clk;
329
330	err = clk_prepare_enable(ttccs->ttc.clk);
331	if (err) {
332		kfree(ttccs);
333		return err;
334	}
335
336	ttccs->ttc.freq = clk_get_rate(ttccs->ttc.clk);
337
338	ttccs->ttc.clk_rate_change_nb.notifier_call =
339		ttc_rate_change_clocksource_cb;
340	ttccs->ttc.clk_rate_change_nb.next = NULL;
341
342	err = clk_notifier_register(ttccs->ttc.clk,
343				    &ttccs->ttc.clk_rate_change_nb);
344	if (err)
345		pr_warn("Unable to register clock notifier.\n");
346
347	ttccs->ttc.base_addr = base;
348	ttccs->cs.name = "ttc_clocksource";
349	ttccs->cs.rating = 200;
350	ttccs->cs.read = __ttc_clocksource_read;
351	ttccs->cs.mask = CLOCKSOURCE_MASK(timer_width);
352	ttccs->cs.flags = CLOCK_SOURCE_IS_CONTINUOUS;
353
354	/*
355	 * Setup the clock source counter to be an incrementing counter
356	 * with no interrupt and it rolls over at 0xFFFF. Pre-scale
357	 * it by 32 also. Let it start running now.
358	 */
359	writel_relaxed(0x0,  ttccs->ttc.base_addr + TTC_IER_OFFSET);
360	writel_relaxed(CLK_CNTRL_PRESCALE | CLK_CNTRL_PRESCALE_EN,
361		     ttccs->ttc.base_addr + TTC_CLK_CNTRL_OFFSET);
362	writel_relaxed(CNT_CNTRL_RESET,
363		     ttccs->ttc.base_addr + TTC_CNT_CNTRL_OFFSET);
364
365	err = clocksource_register_hz(&ttccs->cs, ttccs->ttc.freq / PRESCALE);
366	if (err) {
367		kfree(ttccs);
368		return err;
369	}
370
371	ttc_sched_clock_val_reg = base + TTC_COUNT_VAL_OFFSET;
372	sched_clock_register(ttc_sched_clock_read, timer_width,
373			     ttccs->ttc.freq / PRESCALE);
374
375	return 0;
376}
377
378static int ttc_rate_change_clockevent_cb(struct notifier_block *nb,
379		unsigned long event, void *data)
380{
381	struct clk_notifier_data *ndata = data;
382	struct ttc_timer *ttc = to_ttc_timer(nb);
383	struct ttc_timer_clockevent *ttcce = container_of(ttc,
384			struct ttc_timer_clockevent, ttc);
385
386	switch (event) {
387	case POST_RATE_CHANGE:
388		/* update cached frequency */
389		ttc->freq = ndata->new_rate;
390
391		clockevents_update_freq(&ttcce->ce, ndata->new_rate / PRESCALE);
392
393		/* fall through */
394	case PRE_RATE_CHANGE:
395	case ABORT_RATE_CHANGE:
396	default:
397		return NOTIFY_DONE;
398	}
399}
400
401static int __init ttc_setup_clockevent(struct clk *clk,
402				       void __iomem *base, u32 irq)
403{
404	struct ttc_timer_clockevent *ttcce;
405	int err;
406
407	ttcce = kzalloc(sizeof(*ttcce), GFP_KERNEL);
408	if (!ttcce)
409		return -ENOMEM;
410
411	ttcce->ttc.clk = clk;
412
413	err = clk_prepare_enable(ttcce->ttc.clk);
414	if (err) {
415		kfree(ttcce);
416		return err;
417	}
418
419	ttcce->ttc.clk_rate_change_nb.notifier_call =
420		ttc_rate_change_clockevent_cb;
421	ttcce->ttc.clk_rate_change_nb.next = NULL;
422
423	err = clk_notifier_register(ttcce->ttc.clk,
424				    &ttcce->ttc.clk_rate_change_nb);
425	if (err) {
426		pr_warn("Unable to register clock notifier.\n");
427		return err;
428	}
429
430	ttcce->ttc.freq = clk_get_rate(ttcce->ttc.clk);
431
432	ttcce->ttc.base_addr = base;
433	ttcce->ce.name = "ttc_clockevent";
434	ttcce->ce.features = CLOCK_EVT_FEAT_PERIODIC | CLOCK_EVT_FEAT_ONESHOT;
435	ttcce->ce.set_next_event = ttc_set_next_event;
436	ttcce->ce.set_state_shutdown = ttc_shutdown;
437	ttcce->ce.set_state_periodic = ttc_set_periodic;
438	ttcce->ce.set_state_oneshot = ttc_shutdown;
439	ttcce->ce.tick_resume = ttc_resume;
440	ttcce->ce.rating = 200;
441	ttcce->ce.irq = irq;
442	ttcce->ce.cpumask = cpu_possible_mask;
443
444	/*
445	 * Setup the clock event timer to be an interval timer which
446	 * is prescaled by 32 using the interval interrupt. Leave it
447	 * disabled for now.
448	 */
449	writel_relaxed(0x23, ttcce->ttc.base_addr + TTC_CNT_CNTRL_OFFSET);
450	writel_relaxed(CLK_CNTRL_PRESCALE | CLK_CNTRL_PRESCALE_EN,
451		     ttcce->ttc.base_addr + TTC_CLK_CNTRL_OFFSET);
452	writel_relaxed(0x1,  ttcce->ttc.base_addr + TTC_IER_OFFSET);
453
454	err = request_irq(irq, ttc_clock_event_interrupt,
455			  IRQF_TIMER, ttcce->ce.name, ttcce);
456	if (err) {
457		kfree(ttcce);
458		return err;
459	}
460
461	clockevents_config_and_register(&ttcce->ce,
462			ttcce->ttc.freq / PRESCALE, 1, 0xfffe);
463
464	return 0;
465}
466
467/**
468 * ttc_timer_init - Initialize the timer
469 *
470 * Initializes the timer hardware and register the clock source and clock event
471 * timers with Linux kernal timer framework
472 */
473static int __init ttc_timer_init(struct device_node *timer)
474{
475	unsigned int irq;
476	void __iomem *timer_baseaddr;
477	struct clk *clk_cs, *clk_ce;
478	static int initialized;
479	int clksel, ret;
480	u32 timer_width = 16;
481
482	if (initialized)
483		return 0;
484
485	initialized = 1;
486
487	/*
488	 * Get the 1st Triple Timer Counter (TTC) block from the device tree
489	 * and use it. Note that the event timer uses the interrupt and it's the
490	 * 2nd TTC hence the irq_of_parse_and_map(,1)
491	 */
492	timer_baseaddr = of_iomap(timer, 0);
493	if (!timer_baseaddr) {
494		pr_err("ERROR: invalid timer base address\n");
495		return -ENXIO;
496	}
497
498	irq = irq_of_parse_and_map(timer, 1);
499	if (irq <= 0) {
500		pr_err("ERROR: invalid interrupt number\n");
501		return -EINVAL;
502	}
503
504	of_property_read_u32(timer, "timer-width", &timer_width);
505
506	clksel = readl_relaxed(timer_baseaddr + TTC_CLK_CNTRL_OFFSET);
507	clksel = !!(clksel & TTC_CLK_CNTRL_CSRC_MASK);
508	clk_cs = of_clk_get(timer, clksel);
509	if (IS_ERR(clk_cs)) {
510		pr_err("ERROR: timer input clock not found\n");
511		return PTR_ERR(clk_cs);
512	}
513
514	clksel = readl_relaxed(timer_baseaddr + 4 + TTC_CLK_CNTRL_OFFSET);
515	clksel = !!(clksel & TTC_CLK_CNTRL_CSRC_MASK);
516	clk_ce = of_clk_get(timer, clksel);
517	if (IS_ERR(clk_ce)) {
518		pr_err("ERROR: timer input clock not found\n");
519		return PTR_ERR(clk_ce);
520	}
521
522	ret = ttc_setup_clocksource(clk_cs, timer_baseaddr, timer_width);
523	if (ret)
524		return ret;
525
526	ret = ttc_setup_clockevent(clk_ce, timer_baseaddr + 4, irq);
527	if (ret)
528		return ret;
529
530	pr_info("%pOFn #0 at %p, irq=%d\n", timer, timer_baseaddr, irq);
531
532	return 0;
533}
534
535TIMER_OF_DECLARE(ttc, "cdns,ttc", ttc_timer_init);