1/*
2 * Copyright (C) 2001, 2002, MontaVista Software Inc.
3 * Author: Jun Sun, jsun@mvista.com or jsun@junsun.net
4 * Copyright (c) 2003  Maciej W. Rozycki
5 *
6 * include/asm-mips/time.h
7 *     header file for the new style time.c file and time services.
8 *
9 * This program is free software; you can redistribute  it and/or modify it
10 * under  the terms of  the GNU General  Public License as published by the
11 * Free Software Foundation;  either version 2 of the  License, or (at your
12 * option) any later version.
13 *
14 * Please refer to Documentation/mips/time.README.
15 */
16#ifndef _ASM_TIME_H
17#define _ASM_TIME_H
18
19#include <linux/interrupt.h>
20#include <linux/linkage.h>
21#include <linux/ptrace.h>
22#include <linux/rtc.h>
23#include <linux/spinlock.h>
24#include <linux/clocksource.h>
25
26extern spinlock_t rtc_lock;
27
28/*
29 * RTC ops.  By default, they point to no-RTC functions.
30 *	rtc_mips_get_time - mktime(year, mon, day, hour, min, sec) in seconds.
31 *	rtc_mips_set_time - reverse the above translation and set time to RTC.
32 *	rtc_mips_set_mmss - similar to rtc_set_time, but only min and sec need
33 *			to be set.  Used by RTC sync-up.
34 */
35extern unsigned long (*rtc_mips_get_time)(void);
36extern int (*rtc_mips_set_time)(unsigned long);
37extern int (*rtc_mips_set_mmss)(unsigned long);
38
39/*
40 * Timer interrupt functions.
41 * mips_timer_state is needed for high precision timer calibration.
42 * mips_timer_ack may be NULL if the interrupt is self-recoverable.
43 */
44extern int (*mips_timer_state)(void);
45extern void (*mips_timer_ack)(void);
46
47/*
48 * High precision timer clocksource.
49 * If .read is NULL, an R4k-compatible timer setup is attempted.
50 */
51extern struct clocksource clocksource_mips;
52
53/*
54 * to_tm() converts system time back to (year, mon, day, hour, min, sec).
55 * It is intended to help implement rtc_set_time() functions.
56 * Copied from PPC implementation.
57 */
58extern void to_tm(unsigned long tim, struct rtc_time *tm);
59
60/*
61 * high-level timer interrupt routines.
62 */
63extern irqreturn_t timer_interrupt(int irq, void *dev_id);
64
65/*
66 * the corresponding low-level timer interrupt routine.
67 */
68extern asmlinkage void ll_timer_interrupt(int irq);
69
70/*
71 * profiling and process accouting is done separately in local_timer_interrupt
72 */
73extern void local_timer_interrupt(int irq, void *dev_id);
74extern asmlinkage void ll_local_timer_interrupt(int irq);
75
76/*
77 * board specific routines required by time_init().
78 * board_time_init is defaulted to NULL and can remain so.
79 * plat_timer_setup must be setup properly in machine setup routine.
80 */
81struct irqaction;
82extern void (*board_time_init)(void);
83extern void plat_timer_setup(struct irqaction *irq);
84
85/*
86 * mips_hpt_frequency - must be set if you intend to use an R4k-compatible
87 * counter as a timer interrupt source; otherwise it can be set up
88 * automagically with an aid of mips_timer_state.
89 */
90extern unsigned int mips_hpt_frequency;
91
92#endif /* _ASM_TIME_H */
93