4 * Copyright (c) 2003,2004 The DragonFly Project. All rights reserved.
6 * This code is derived from software contributed to The DragonFly Project
7 * by Matthew Dillon <dillon@backplane.com>
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
19 * 3. Neither the name of The DragonFly Project nor the names of its
20 * contributors may be used to endorse or promote products derived
21 * from this software without specific, prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
29 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
31 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
33 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 * $DragonFly: src/sys/sys/systimer.h,v 1.13 2007/04/30 06:57:36 dillon Exp $
39 #ifndef _SYS_SYSTIMER_H_
40 #define _SYS_SYSTIMER_H_
43 #include <sys/types.h>
46 #include <sys/queue.h>
51 typedef __uint32_t sysclock_t;
52 typedef TAILQ_HEAD(systimerq, systimer) *systimerq_t;
53 typedef void (*systimer_func_t)(struct systimer *);
54 typedef void (*systimer_func2_t)(struct systimer *, struct intrframe *);
56 typedef struct systimer {
57 TAILQ_ENTRY(systimer) node;
59 sysclock_t time; /* absolute time next intr */
60 sysclock_t periodic; /* if non-zero */
61 systimer_func2_t func;
64 int freq; /* frequency if periodic */
65 struct cputimer *which; /* which timer was used? */
66 struct globaldata *gd; /* cpu owning structure */
69 #define SYSTF_ONQUEUE 0x0001
70 #define SYSTF_IPIRUNNING 0x0002
71 #define SYSTF_NONQUEUED 0x0004
73 void systimer_intr_enable(void);
74 void systimer_intr(sysclock_t *, int, struct intrframe *);
75 void systimer_add(systimer_t);
76 void systimer_del(systimer_t);
77 void systimer_init_periodic(systimer_t, void *, void *, int);
78 void systimer_init_periodic_nq(systimer_t, void *, void *, int);
79 void systimer_adjust_periodic(systimer_t, int);
80 void systimer_init_oneshot(systimer_t, void *, void *, int);
83 * cputimer interface. This provides a free-running (non-interrupt)
84 * timebase for the system. The cputimer
86 * These variables hold the fixed cputimer frequency, determining the
87 * granularity of cputimer_count().
89 * Note that cputimer_count() always returns a full-width wrapping counter.
91 * The 64 bit versions are used for converting count values into uS or nS
94 * usec = (cputimer_freq64_usec * count) >> 32
98 SLIST_ENTRY(cputimer) next;
102 sysclock_t (*count)(void);
103 sysclock_t (*fromhz)(int freq);
104 sysclock_t (*fromus)(int us);
105 void (*construct)(struct cputimer *, sysclock_t);
106 void (*destruct)(struct cputimer *);
107 sysclock_t freq; /* in Hz */
108 int64_t freq64_usec; /* in (1e6 << 32) / timer_freq */
109 int64_t freq64_nsec; /* in (1e9 << 32) / timer_freq */
110 sysclock_t base; /* (implementation dependant) */
113 extern struct cputimer *sys_cputimer;
115 #define CPUTIMER_DUMMY 0
116 #define CPUTIMER_8254_SEL1 1
117 #define CPUTIMER_8254_SEL2 2
118 #define CPUTIMER_ACPI 3
119 #define CPUTIMER_VKERNEL 4
120 #define CPUTIMER_HPET 5
122 #define CPUTIMER_PRI_DUMMY -10
123 #define CPUTIMER_PRI_8254 0
124 #define CPUTIMER_PRI_ACPI 10
125 #define CPUTIMER_PRI_HPET 15
126 #define CPUTIMER_PRI_VKERNEL 20
128 enum cputimer_intr_type {
129 CPUTIMER_INTRT_C3 = 0,
133 void cputimer_select(struct cputimer *, int);
134 void cputimer_register(struct cputimer *);
135 void cputimer_deregister(struct cputimer *);
136 void cputimer_set_frequency(struct cputimer *, int);
137 sysclock_t cputimer_default_fromhz(int);
138 sysclock_t cputimer_default_fromus(int);
139 void cputimer_default_construct(struct cputimer *, sysclock_t);
140 void cputimer_default_destruct(struct cputimer *);
142 void cputimer_intr_enable(void);
143 void cputimer_intr_config(struct cputimer *);
144 extern void (*cputimer_intr_reload)(sysclock_t);
145 void cputimer_intr_switch(enum cputimer_intr_type);
147 #endif /* !_SYS_SYSTIMER_H_ */