timer.h 2.27 KB
Newer Older
1 2 3 4 5 6 7 8 9
/*
 * Copyright (C) 2015 Thomas Chou <thomas@wytron.com.tw>
 *
 * SPDX-License-Identifier:	GPL-2.0+
 */

#ifndef _TIMER_H_
#define _TIMER_H_

10 11 12 13 14 15 16 17 18
/*
 * dm_timer_init - initialize a timer for time keeping. On success
 * initializes gd->timer so that lib/timer can use it for future
 * referrence.
 *
 * @return - 0 on success or error number
 */
int dm_timer_init(void);

19 20 21 22 23 24 25 26
/*
 * timer_conv_64 - convert 32-bit counter value to 64-bit
 *
 * @count: 32-bit counter value
 * @return: 64-bit counter value
 */
u64 timer_conv_64(u32 count);

27 28 29
/*
 * Get the current timer count
 *
Bin Meng's avatar
Bin Meng committed
30
 * @dev: The timer device
31 32 33
 * @count: pointer that returns the current timer count
 * @return: 0 if OK, -ve on error
 */
34
int timer_get_count(struct udevice *dev, u64 *count);
Bin Meng's avatar
Bin Meng committed
35

36 37 38
/*
 * Get the timer input clock frequency
 *
Bin Meng's avatar
Bin Meng committed
39
 * @dev: The timer device
40 41 42 43 44
 * @return: the timer input clock frequency
 */
unsigned long timer_get_rate(struct udevice *dev);

/*
Bin Meng's avatar
Bin Meng committed
45
 * struct timer_ops - Driver model timer operations
46
 *
Bin Meng's avatar
Bin Meng committed
47
 * The uclass interface is implemented by all timer devices which use
48 49 50 51 52 53
 * driver model.
 */
struct timer_ops {
	/*
	 * Get the current timer count
	 *
Bin Meng's avatar
Bin Meng committed
54
	 * @dev: The timer device
55
	 * @count: pointer that returns the current 64-bit timer count
56 57
	 * @return: 0 if OK, -ve on error
	 */
58
	int (*get_count)(struct udevice *dev, u64 *count);
59 60 61 62 63 64 65 66 67 68 69
};

/*
 * struct timer_dev_priv - information about a device used by the uclass
 *
 * @clock_rate: the timer input clock frequency
 */
struct timer_dev_priv {
	unsigned long clock_rate;
};

70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
/**
 * timer_early_get_count() - Implement timer_get_count() before driver model
 *
 * If CONFIG_TIMER_EARLY is enabled, this function wil be called to return
 * the current timer value before the proper driver model timer is ready.
 * It should be implemented by one of the timer values. This is mostly useful
 * for tracing.
 */
u64 timer_early_get_count(void);

/**
 * timer_early_get_rate() - Get the timer rate before driver model
 *
 * If CONFIG_TIMER_EARLY is enabled, this function wil be called to return
 * the current timer rate in Hz before the proper driver model timer is ready.
 * It should be implemented by one of the timer values. This is mostly useful
 * for tracing. This corresponds to the clock_rate value in struct
 * timer_dev_priv.
 */
unsigned long timer_early_get_rate(void);

91
#endif	/* _TIMER_H_ */