[GitHub/mt8127/android_kernel_alcatel_ttab.git] / include / linux / clocksource.h

/*  linux/include/linux/clocksource.h
 *
 *  This file contains the structure definitions for clocksources.
 *
 *  If you are not a clocksource, or timekeeping code, you should
 *  not be including this file!
 */
#ifndef _LINUX_CLOCKSOURCE_H
#define _LINUX_CLOCKSOURCE_H

#include <linux/types.h>
#include <linux/timex.h>
#include <linux/time.h>
#include <linux/list.h>
#include <linux/cache.h>
#include <linux/timer.h>
#include <linux/init.h>
#include <asm/div64.h>
#include <asm/io.h>

/* clocksource cycle base type */
typedef u64 cycle_t;
struct clocksource;

#ifdef CONFIG_ARCH_CLOCKSOURCE_DATA
#include <asm/clocksource.h>
#endif

/**
 * struct cyclecounter - hardware abstraction for a free running counter
 *	Provides completely state-free accessors to the underlying hardware.
 *	Depending on which hardware it reads, the cycle counter may wrap
 *	around quickly. Locking rules (if necessary) have to be defined
 *	by the implementor and user of specific instances of this API.
 *
 * @read:		returns the current cycle value
 * @mask:		bitmask for two's complement
 *			subtraction of non 64 bit counters,
 *			see CLOCKSOURCE_MASK() helper macro
 * @mult:		cycle to nanosecond multiplier
 * @shift:		cycle to nanosecond divisor (power of two)
 */
struct cyclecounter {
	cycle_t (*read)(const struct cyclecounter *cc);
	cycle_t mask;
	u32 mult;
	u32 shift;
};

/**
 * struct timecounter - layer above a %struct cyclecounter which counts nanoseconds
 *	Contains the state needed by timecounter_read() to detect
 *	cycle counter wrap around. Initialize with
 *	timecounter_init(). Also used to convert cycle counts into the
 *	corresponding nanosecond counts with timecounter_cyc2time(). Users
 *	of this code are responsible for initializing the underlying
 *	cycle counter hardware, locking issues and reading the time
 *	more often than the cycle counter wraps around. The nanosecond
 *	counter will only wrap around after ~585 years.
 *
 * @cc:			the cycle counter used by this instance
 * @cycle_last:		most recent cycle counter value seen by
 *			timecounter_read()
 * @nsec:		continuously increasing count
 */
struct timecounter {
	const struct cyclecounter *cc;
	cycle_t cycle_last;
	u64 nsec;
};

/**
 * cyclecounter_cyc2ns - converts cycle counter cycles to nanoseconds
 * @cc:		Pointer to cycle counter.
 * @cycles:	Cycles
 *
 * XXX - This could use some mult_lxl_ll() asm optimization. Same code
 * as in cyc2ns, but with unsigned result.
 */
static inline u64 cyclecounter_cyc2ns(const struct cyclecounter *cc,
				      cycle_t cycles)
{
	u64 ret = (u64)cycles;
	ret = (ret * cc->mult) >> cc->shift;
	return ret;
}

/**
 * timecounter_init - initialize a time counter
 * @tc:			Pointer to time counter which is to be initialized/reset
 * @cc:			A cycle counter, ready to be used.
 * @start_tstamp:	Arbitrary initial time stamp.
 *
 * After this call the current cycle register (roughly) corresponds to
 * the initial time stamp. Every call to timecounter_read() increments
 * the time stamp counter by the number of elapsed nanoseconds.
 */
extern void timecounter_init(struct timecounter *tc,
			     const struct cyclecounter *cc,
			     u64 start_tstamp);

/**
 * timecounter_read - return nanoseconds elapsed since timecounter_init()
 *                    plus the initial time stamp
 * @tc:          Pointer to time counter.
 *
 * In other words, keeps track of time since the same epoch as
 * the function which generated the initial time stamp.
 */
extern u64 timecounter_read(struct timecounter *tc);

/**
 * timecounter_cyc2time - convert a cycle counter to same
 *                        time base as values returned by
 *                        timecounter_read()
 * @tc:		Pointer to time counter.
 * @cycle_tstamp:	a value returned by tc->cc->read()
 *
 * Cycle counts that are converted correctly as long as they
 * fall into the interval [-1/2 max cycle count, +1/2 max cycle count],
 * with "max cycle count" == cs->mask+1.
 *
 * This allows conversion of cycle counter values which were generated
 * in the past.
 */
extern u64 timecounter_cyc2time(struct timecounter *tc,
				cycle_t cycle_tstamp);

/**
 * struct clocksource - hardware abstraction for a free running counter
 *	Provides mostly state-free accessors to the underlying hardware.
 *	This is the structure used for system time.
 *
 * @name:		ptr to clocksource name
 * @list:		list head for registration
 * @rating:		rating value for selection (higher is better)
 *			To avoid rating inflation the following
 *			list should give you a guide as to how
 *			to assign your clocksource a rating
 *			1-99: Unfit for real use
 *				Only available for bootup and testing purposes.
 *			100-199: Base level usability.
 *				Functional for real use, but not desired.
 *			200-299: Good.
 *				A correct and usable clocksource.
 *			300-399: Desired.
 *				A reasonably fast and accurate clocksource.
 *			400-499: Perfect
 *				The ideal clocksource. A must-use where
 *				available.
 * @read:		returns a cycle value, passes clocksource as argument
 * @enable:		optional function to enable the clocksource
 * @disable:		optional function to disable the clocksource
 * @mask:		bitmask for two's complement
 *			subtraction of non 64 bit counters
 * @mult:		cycle to nanosecond multiplier
 * @shift:		cycle to nanosecond divisor (power of two)
 * @max_idle_ns:	max idle time permitted by the clocksource (nsecs)
 * @maxadj:		maximum adjustment value to mult (~11%)
 * @flags:		flags describing special properties
 * @archdata:		arch-specific data
 * @suspend:		suspend function for the clocksource, if necessary
 * @resume:		resume function for the clocksource, if necessary
 * @cycle_last:		most recent cycle counter value seen by ::read()
 */
struct clocksource {
	/*
	 * Hotpath data, fits in a single cache line when the
	 * clocksource itself is cacheline aligned.
	 */
	cycle_t (*read)(struct clocksource *cs);
	cycle_t cycle_last;
	cycle_t mask;
	u32 mult;
	u32 shift;
	u64 max_idle_ns;
	u32 maxadj;
#ifdef CONFIG_ARCH_CLOCKSOURCE_DATA
	struct arch_clocksource_data archdata;
#endif

	const char *name;
	struct list_head list;
	int rating;
	int (*enable)(struct clocksource *cs);
	void (*disable)(struct clocksource *cs);
	unsigned long flags;
	void (*suspend)(struct clocksource *cs);
	void (*resume)(struct clocksource *cs);

	/* private: */
#ifdef CONFIG_CLOCKSOURCE_WATCHDOG
	/* Watchdog related data, used by the framework */
	struct list_head wd_list;
	cycle_t cs_last;
	cycle_t wd_last;
#endif
} ____cacheline_aligned;

/*
 * Clock source flags bits::
 */
#define CLOCK_SOURCE_IS_CONTINUOUS		0x01
#define CLOCK_SOURCE_MUST_VERIFY		0x02

#define CLOCK_SOURCE_WATCHDOG			0x10
#define CLOCK_SOURCE_VALID_FOR_HRES		0x20
#define CLOCK_SOURCE_UNSTABLE			0x40
#define CLOCK_SOURCE_SUSPEND_NONSTOP		0x80

/* simplify initialization of mask field */
#define CLOCKSOURCE_MASK(bits) (cycle_t)((bits) < 64 ? ((1ULL<<(bits))-1) : -1)

/**
 * clocksource_khz2mult - calculates mult from khz and shift
 * @khz:		Clocksource frequency in KHz
 * @shift_constant:	Clocksource shift factor
 *
 * Helper functions that converts a khz counter frequency to a timsource
 * multiplier, given the clocksource shift value
 */
static inline u32 clocksource_khz2mult(u32 khz, u32 shift_constant)
{
	/*  khz = cyc/(Million ns)
	 *  mult/2^shift  = ns/cyc
	 *  mult = ns/cyc * 2^shift
	 *  mult = 1Million/khz * 2^shift
	 *  mult = 1000000 * 2^shift / khz
	 *  mult = (1000000<<shift) / khz
	 */
	u64 tmp = ((u64)1000000) << shift_constant;

	tmp += khz/2; /* round for do_div */
	do_div(tmp, khz);

	return (u32)tmp;
}

/**
 * clocksource_hz2mult - calculates mult from hz and shift
 * @hz:			Clocksource frequency in Hz
 * @shift_constant:	Clocksource shift factor
 *
 * Helper functions that converts a hz counter
 * frequency to a timsource multiplier, given the
 * clocksource shift value
 */
static inline u32 clocksource_hz2mult(u32 hz, u32 shift_constant)
{
	/*  hz = cyc/(Billion ns)
	 *  mult/2^shift  = ns/cyc
	 *  mult = ns/cyc * 2^shift
	 *  mult = 1Billion/hz * 2^shift
	 *  mult = 1000000000 * 2^shift / hz
	 *  mult = (1000000000<<shift) / hz
	 */
	u64 tmp = ((u64)1000000000) << shift_constant;

	tmp += hz/2; /* round for do_div */
	do_div(tmp, hz);

	return (u32)tmp;
}

/**
 * clocksource_cyc2ns - converts clocksource cycles to nanoseconds
 * @cycles:	cycles
 * @mult:	cycle to nanosecond multiplier
 * @shift:	cycle to nanosecond divisor (power of two)
 *
 * Converts cycles to nanoseconds, using the given mult and shift.
 *
 * XXX - This could use some mult_lxl_ll() asm optimization
 */
static inline s64 clocksource_cyc2ns(cycle_t cycles, u32 mult, u32 shift)
{
	return ((u64) cycles * mult) >> shift;
}


extern int clocksource_register(struct clocksource*);
extern void clocksource_unregister(struct clocksource*);
extern void clocksource_touch_watchdog(void);
extern struct clocksource* clocksource_get_next(void);
extern void clocksource_change_rating(struct clocksource *cs, int rating);
extern void clocksource_suspend(void);
extern void clocksource_resume(void);
extern struct clocksource * __init clocksource_default_clock(void);
extern void clocksource_mark_unstable(struct clocksource *cs);

extern void
clocks_calc_mult_shift(u32 *mult, u32 *shift, u32 from, u32 to, u32 minsec);

/*
 * Don't call __clocksource_register_scale directly, use
 * clocksource_register_hz/khz
 */
extern int
__clocksource_register_scale(struct clocksource *cs, u32 scale, u32 freq);
extern void
__clocksource_updatefreq_scale(struct clocksource *cs, u32 scale, u32 freq);

static inline int clocksource_register_hz(struct clocksource *cs, u32 hz)
{
	return __clocksource_register_scale(cs, 1, hz);
}

static inline int clocksource_register_khz(struct clocksource *cs, u32 khz)
{
	return __clocksource_register_scale(cs, 1000, khz);
}

static inline void __clocksource_updatefreq_hz(struct clocksource *cs, u32 hz)
{
	__clocksource_updatefreq_scale(cs, 1, hz);
}

static inline void __clocksource_updatefreq_khz(struct clocksource *cs, u32 khz)
{
	__clocksource_updatefreq_scale(cs, 1000, khz);
}


extern void timekeeping_notify(struct clocksource *clock);

extern cycle_t clocksource_mmio_readl_up(struct clocksource *);
extern cycle_t clocksource_mmio_readl_down(struct clocksource *);
extern cycle_t clocksource_mmio_readw_up(struct clocksource *);
extern cycle_t clocksource_mmio_readw_down(struct clocksource *);

extern int clocksource_mmio_init(void __iomem *, const char *,
	unsigned long, int, unsigned, cycle_t (*)(struct clocksource *));

extern int clocksource_i8253_init(void);

struct device_node;
typedef void(*clocksource_of_init_fn)(struct device_node *);
#ifdef CONFIG_CLKSRC_OF
extern void clocksource_of_init(void);

#define CLOCKSOURCE_OF_DECLARE(name, compat, fn)			\
	static const struct of_device_id __clksrc_of_table_##name	\
		__used __section(__clksrc_of_table)			\
		 = { .compatible = compat,				\
		     .data = (fn == (clocksource_of_init_fn)NULL) ? fn : fn }
#else
static inline void clocksource_of_init(void) {}
#define CLOCKSOURCE_OF_DECLARE(name, compat, fn)			\
	static const struct of_device_id __clksrc_of_table_##name	\
		__attribute__((unused))					\
		 = { .compatible = compat,				\
		     .data = (fn == (clocksource_of_init_fn)NULL) ? fn : fn }
#endif

#endif /* _LINUX_CLOCKSOURCE_H */
Commit	Line	Data
734efb46 JS	1	/* linux/include/linux/clocksource.h
	2	*
	3	* This file contains the structure definitions for clocksources.
	4	*
	5	* If you are not a clocksource, or timekeeping code, you should
	6	* not be including this file!
	7	*/
	8	#ifndef _LINUX_CLOCKSOURCE_H
	9	#define _LINUX_CLOCKSOURCE_H
	10
	11	#include <linux/types.h>
	12	#include <linux/timex.h>
	13	#include <linux/time.h>
	14	#include <linux/list.h>
329c8d84	15	#include <linux/cache.h>
5d8b34fd	16	#include <linux/timer.h>
f1b82746	17	#include <linux/init.h>
734efb46 JS	18	#include <asm/div64.h>
	19	#include <asm/io.h>
	20
	21	/* clocksource cycle base type */
	22	typedef u64 cycle_t;
5d8b34fd	23	struct clocksource;
734efb46	24
ae7bd11b	25	#ifdef CONFIG_ARCH_CLOCKSOURCE_DATA
433bd805	26	#include <asm/clocksource.h>
ae7bd11b	27	#endif
433bd805	28
a038a353 PO	29	/**
	30	* struct cyclecounter - hardware abstraction for a free running counter
	31	* Provides completely state-free accessors to the underlying hardware.
	32	* Depending on which hardware it reads, the cycle counter may wrap
	33	* around quickly. Locking rules (if necessary) have to be defined
	34	* by the implementor and user of specific instances of this API.
	35	*
	36	* @read: returns the current cycle value
	37	* @mask: bitmask for two's complement
	38	* subtraction of non 64 bit counters,
	39	* see CLOCKSOURCE_MASK() helper macro
	40	* @mult: cycle to nanosecond multiplier
	41	* @shift: cycle to nanosecond divisor (power of two)
	42	*/
	43	struct cyclecounter {
	44	cycle_t (read)(const struct cyclecounter cc);
	45	cycle_t mask;
	46	u32 mult;
	47	u32 shift;
	48	};
	49
	50	/**
	51	* struct timecounter - layer above a %struct cyclecounter which counts nanoseconds
	52	* Contains the state needed by timecounter_read() to detect
	53	* cycle counter wrap around. Initialize with
	54	* timecounter_init(). Also used to convert cycle counts into the
	55	* corresponding nanosecond counts with timecounter_cyc2time(). Users
	56	* of this code are responsible for initializing the underlying
	57	* cycle counter hardware, locking issues and reading the time
	58	* more often than the cycle counter wraps around. The nanosecond
	59	* counter will only wrap around after ~585 years.
	60	*
	61	* @cc: the cycle counter used by this instance
	62	* @cycle_last: most recent cycle counter value seen by
	63	* timecounter_read()
	64	* @nsec: continuously increasing count
	65	*/
	66	struct timecounter {
	67	const struct cyclecounter *cc;
	68	cycle_t cycle_last;
	69	u64 nsec;
	70	};
	71
	72	/**
	73	* cyclecounter_cyc2ns - converts cycle counter cycles to nanoseconds
b1b73d09	74	* @cc: Pointer to cycle counter.
a038a353 PO	75	* @cycles: Cycles
	76	*
	77	* XXX - This could use some mult_lxl_ll() asm optimization. Same code
	78	* as in cyc2ns, but with unsigned result.
	79	*/
	80	static inline u64 cyclecounter_cyc2ns(const struct cyclecounter *cc,
	81	cycle_t cycles)
	82	{
	83	u64 ret = (u64)cycles;
	84	ret = (ret * cc->mult) >> cc->shift;
	85	return ret;
	86	}
	87
	88	/**
	89	* timecounter_init - initialize a time counter
	90	* @tc: Pointer to time counter which is to be initialized/reset
	91	* @cc: A cycle counter, ready to be used.
	92	* @start_tstamp: Arbitrary initial time stamp.
	93	*
	94	* After this call the current cycle register (roughly) corresponds to
	95	* the initial time stamp. Every call to timecounter_read() increments
	96	* the time stamp counter by the number of elapsed nanoseconds.
	97	*/
	98	extern void timecounter_init(struct timecounter *tc,
	99	const struct cyclecounter *cc,
	100	u64 start_tstamp);
	101
	102	/**
	103	* timecounter_read - return nanoseconds elapsed since timecounter_init()
	104	* plus the initial time stamp
	105	* @tc: Pointer to time counter.
	106	*
	107	* In other words, keeps track of time since the same epoch as
	108	* the function which generated the initial time stamp.
	109	*/
	110	extern u64 timecounter_read(struct timecounter *tc);
	111
	112	/**
	113	* timecounter_cyc2time - convert a cycle counter to same
	114	* time base as values returned by
	115	* timecounter_read()
	116	* @tc: Pointer to time counter.
b1b73d09	117	* @cycle_tstamp: a value returned by tc->cc->read()
a038a353 PO	118	*
	119	* Cycle counts that are converted correctly as long as they
	120	* fall into the interval [-1/2 max cycle count, +1/2 max cycle count],
	121	* with "max cycle count" == cs->mask+1.
	122	*
	123	* This allows conversion of cycle counter values which were generated
	124	* in the past.
	125	*/
	126	extern u64 timecounter_cyc2time(struct timecounter *tc,
	127	cycle_t cycle_tstamp);
	128
734efb46 JS	129	/**
	130	* struct clocksource - hardware abstraction for a free running counter
	131	* Provides mostly state-free accessors to the underlying hardware.
a038a353	132	* This is the structure used for system time.
734efb46 JS	133	*
	134	* @name: ptr to clocksource name
	135	* @list: list head for registration
	136	* @rating: rating value for selection (higher is better)
	137	* To avoid rating inflation the following
	138	* list should give you a guide as to how
	139	* to assign your clocksource a rating
	140	* 1-99: Unfit for real use
	141	* Only available for bootup and testing purposes.
	142	* 100-199: Base level usability.
	143	* Functional for real use, but not desired.
	144	* 200-299: Good.
	145	* A correct and usable clocksource.
	146	* 300-399: Desired.
	147	* A reasonably fast and accurate clocksource.
	148	* 400-499: Perfect
	149	* The ideal clocksource. A must-use where
	150	* available.
8e19608e	151	* @read: returns a cycle value, passes clocksource as argument
4614e6ad MD	152	* @enable: optional function to enable the clocksource
4614e6ad MD	153	* @disable: optional function to disable the clocksource
734efb46 JS	154	* @mask: bitmask for two's complement
734efb46 JS	155	* subtraction of non 64 bit counters
0a544198	156	* @mult: cycle to nanosecond multiplier
734efb46	157	* @shift: cycle to nanosecond divisor (power of two)
98962465	158	* @max_idle_ns: max idle time permitted by the clocksource (nsecs)
b1b73d09	159	* @maxadj: maximum adjustment value to mult (~11%)
73b08d2a	160	* @flags: flags describing special properties
433bd805	161	* @archdata: arch-specific data
c54a42b1	162	* @suspend: suspend function for the clocksource, if necessary
b52f52a0	163	* @resume: resume function for the clocksource, if necessary
b1b73d09	164	* @cycle_last: most recent cycle counter value seen by ::read()
734efb46 JS	165	*/
734efb46 JS	166	struct clocksource {
329c8d84	167	/*
369db4c9 TG	168	* Hotpath data, fits in a single cache line when the
369db4c9 TG	169	* clocksource itself is cacheline aligned.
329c8d84	170	*/
8e19608e	171	cycle_t (read)(struct clocksource cs);
369db4c9	172	cycle_t cycle_last;
734efb46 JS	173	cycle_t mask;
	174	u32 mult;
	175	u32 shift;
98962465	176	u64 max_idle_ns;
d65670a7	177	u32 maxadj;
ae7bd11b	178	#ifdef CONFIG_ARCH_CLOCKSOURCE_DATA
433bd805	179	struct arch_clocksource_data archdata;
0aa366f3	180	#endif
433bd805	181
369db4c9 TG	182	const char *name;
	183	struct list_head list;
	184	int rating;
369db4c9 TG	185	int (enable)(struct clocksource cs);
	186	void (disable)(struct clocksource cs);
	187	unsigned long flags;
	188	void (suspend)(struct clocksource cs);
	189	void (resume)(struct clocksource cs);
5d8b34fd	190
b1b73d09	191	/* private: */
5d8b34fd TG	192	#ifdef CONFIG_CLOCKSOURCE_WATCHDOG
	193	/* Watchdog related data, used by the framework */
	194	struct list_head wd_list;
b5199515	195	cycle_t cs_last;
5d8b34fd TG	196	cycle_t wd_last;
5d8b34fd TG	197	#endif
369db4c9	198	} ____cacheline_aligned;
734efb46	199
73b08d2a TG	200	/*
	201	* Clock source flags bits::
	202	*/
5d8b34fd TG	203	#define CLOCK_SOURCE_IS_CONTINUOUS 0x01
	204	#define CLOCK_SOURCE_MUST_VERIFY 0x02
	205
	206	#define CLOCK_SOURCE_WATCHDOG 0x10
	207	#define CLOCK_SOURCE_VALID_FOR_HRES 0x20
c55c87c8	208	#define CLOCK_SOURCE_UNSTABLE 0x40
5caf4636	209	#define CLOCK_SOURCE_SUSPEND_NONSTOP 0x80
73b08d2a	210
7f9f303a	211	/* simplify initialization of mask field */
1d76c262	212	#define CLOCKSOURCE_MASK(bits) (cycle_t)((bits) < 64 ? ((1ULL<<(bits))-1) : -1)
734efb46 JS	213
	214	/**
	215	* clocksource_khz2mult - calculates mult from khz and shift
	216	* @khz: Clocksource frequency in KHz
	217	* @shift_constant: Clocksource shift factor
	218	*
	219	* Helper functions that converts a khz counter frequency to a timsource
	220	* multiplier, given the clocksource shift value
	221	*/
	222	static inline u32 clocksource_khz2mult(u32 khz, u32 shift_constant)
	223	{
	224	/* khz = cyc/(Million ns)
	225	* mult/2^shift = ns/cyc
	226	* mult = ns/cyc * 2^shift
	227	* mult = 1Million/khz * 2^shift
	228	* mult = 1000000 * 2^shift / khz
	229	* mult = (1000000<<shift) / khz
	230	*/
	231	u64 tmp = ((u64)1000000) << shift_constant;
	232
	233	tmp += khz/2; /* round for do_div */
	234	do_div(tmp, khz);
	235
	236	return (u32)tmp;
	237	}
	238
	239	/**
	240	* clocksource_hz2mult - calculates mult from hz and shift
	241	* @hz: Clocksource frequency in Hz
	242	* @shift_constant: Clocksource shift factor
	243	*
	244	* Helper functions that converts a hz counter
	245	* frequency to a timsource multiplier, given the
	246	* clocksource shift value
	247	*/
	248	static inline u32 clocksource_hz2mult(u32 hz, u32 shift_constant)
	249	{
	250	/* hz = cyc/(Billion ns)
	251	* mult/2^shift = ns/cyc
	252	* mult = ns/cyc * 2^shift
	253	* mult = 1Billion/hz * 2^shift
	254	* mult = 1000000000 * 2^shift / hz
	255	* mult = (1000000000<<shift) / hz
	256	*/
	257	u64 tmp = ((u64)1000000000) << shift_constant;
	258
	259	tmp += hz/2; /* round for do_div */
	260	do_div(tmp, hz);
	261
	262	return (u32)tmp;
	263	}
	264
734efb46	265	/**
155ec602	266	* clocksource_cyc2ns - converts clocksource cycles to nanoseconds
b1b73d09 KK	267	* @cycles: cycles
	268	* @mult: cycle to nanosecond multiplier
	269	* @shift: cycle to nanosecond divisor (power of two)
734efb46	270	*
155ec602	271	* Converts cycles to nanoseconds, using the given mult and shift.
734efb46 JS	272	*
	273	* XXX - This could use some mult_lxl_ll() asm optimization
	274	*/
155ec602	275	static inline s64 clocksource_cyc2ns(cycle_t cycles, u32 mult, u32 shift)
734efb46	276	{
155ec602	277	return ((u64) cycles * mult) >> shift;
5eb6d205 JS	278	}
	279
	280
92c7e002	281	extern int clocksource_register(struct clocksource*);
4713e22c	282	extern void clocksource_unregister(struct clocksource*);
7c3078b6	283	extern void clocksource_touch_watchdog(void);
92c7e002 TG	284	extern struct clocksource* clocksource_get_next(void);
92c7e002 TG	285	extern void clocksource_change_rating(struct clocksource *cs, int rating);
c54a42b1	286	extern void clocksource_suspend(void);
b52f52a0	287	extern void clocksource_resume(void);
88d96d8e	288	extern struct clocksource * __init clocksource_default_clock(void);
7285dd7f	289	extern void clocksource_mark_unstable(struct clocksource *cs);
734efb46	290
7d2f944a TG	291	extern void
	292	clocks_calc_mult_shift(u32 mult, u32 shift, u32 from, u32 to, u32 minsec);
	293
d7e81c26 JS	294	/*
	295	* Don't call __clocksource_register_scale directly, use
	296	* clocksource_register_hz/khz
	297	*/
	298	extern int
	299	__clocksource_register_scale(struct clocksource *cs, u32 scale, u32 freq);
852db46d JS	300	extern void
852db46d JS	301	__clocksource_updatefreq_scale(struct clocksource *cs, u32 scale, u32 freq);
d7e81c26 JS	302
	303	static inline int clocksource_register_hz(struct clocksource *cs, u32 hz)
	304	{
	305	return __clocksource_register_scale(cs, 1, hz);
	306	}
	307
	308	static inline int clocksource_register_khz(struct clocksource *cs, u32 khz)
	309	{
	310	return __clocksource_register_scale(cs, 1000, khz);
	311	}
	312
852db46d JS	313	static inline void __clocksource_updatefreq_hz(struct clocksource *cs, u32 hz)
	314	{
	315	__clocksource_updatefreq_scale(cs, 1, hz);
	316	}
	317
	318	static inline void __clocksource_updatefreq_khz(struct clocksource *cs, u32 khz)
	319	{
	320	__clocksource_updatefreq_scale(cs, 1000, khz);
	321	}
d7e81c26	322
acc9a9dc	323
75c5158f MS	324	extern void timekeeping_notify(struct clocksource *clock);
75c5158f MS	325
442c8176 RK	326	extern cycle_t clocksource_mmio_readl_up(struct clocksource *);
	327	extern cycle_t clocksource_mmio_readl_down(struct clocksource *);
	328	extern cycle_t clocksource_mmio_readw_up(struct clocksource *);
	329	extern cycle_t clocksource_mmio_readw_down(struct clocksource *);
	330
	331	extern int clocksource_mmio_init(void __iomem , const char ,
	332	unsigned long, int, unsigned, cycle_t ()(struct clocksource ));
	333
8c414ff3 RK	334	extern int clocksource_i8253_init(void);
8c414ff3 RK	335
3d5a9658 AB	336	struct device_node;
3d5a9658 AB	337	typedef void(clocksource_of_init_fn)(struct device_node );
ae278a93 SW	338	#ifdef CONFIG_CLKSRC_OF
	339	extern void clocksource_of_init(void);
	340
	341	#define CLOCKSOURCE_OF_DECLARE(name, compat, fn) \
	342	static const struct of_device_id __clksrc_of_table_##name \
	343	__used __section(__clksrc_of_table) \
3d5a9658 AB	344	= { .compatible = compat, \
3d5a9658 AB	345	.data = (fn == (clocksource_of_init_fn)NULL) ? fn : fn }
e1d7ef1c	346	#else
e0c25362	347	static inline void clocksource_of_init(void) {}
3d5a9658 AB	348	#define CLOCKSOURCE_OF_DECLARE(name, compat, fn) \
	349	static const struct of_device_id __clksrc_of_table_##name \
	350	__attribute__((unused)) \
	351	= { .compatible = compat, \
	352	.data = (fn == (clocksource_of_init_fn)NULL) ? fn : fn }
ae278a93 SW	353	#endif
ae278a93 SW	354
734efb46	355	#endif /* _LINUX_CLOCKSOURCE_H */