1 /* 2 * SYS/SYSTIMER.H 3 * 4 * Copyright (c) 2003,2004 The DragonFly Project. All rights reserved. 5 * 6 * This code is derived from software contributed to The DragonFly Project 7 * by Matthew Dillon <dillon@backplane.com> 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 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 18 * distribution. 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. 22 * 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 34 * SUCH DAMAGE. 35 * 36 * $DragonFly: src/sys/sys/systimer.h,v 1.12 2007/01/07 00:44:33 dillon Exp $ 37 */ 38 39 #ifndef _SYS_SYSTIMER_H_ 40 #define _SYS_SYSTIMER_H_ 41 42 #ifndef _SYS_TYPES_H_ 43 #include <sys/types.h> 44 #endif 45 #ifndef _SYS_QUEUE_H_ 46 #include <sys/queue.h> 47 #endif 48 49 struct intrframe; 50 51 typedef __uint32_t sysclock_t; 52 typedef TAILQ_HEAD(systimerq, systimer) *systimerq_t; 53 typedef void (*systimer_func_t)(struct systimer *info); 54 typedef void (*systimer_func2_t)(struct systimer *info, struct intrframe *frame); 55 56 typedef struct systimer { 57 TAILQ_ENTRY(systimer) node; 58 systimerq_t queue; 59 sysclock_t time; /* absolute time next intr */ 60 sysclock_t periodic; /* if non-zero */ 61 systimer_func2_t func; 62 void *data; 63 int flags; 64 struct globaldata *gd; /* cpu owning structure */ 65 } *systimer_t; 66 67 #define SYSTF_ONQUEUE 0x0001 68 #define SYSTF_IPIRUNNING 0x0002 69 #define SYSTF_NONQUEUED 0x0004 70 71 void systimer_intr(sysclock_t *, int, struct intrframe *); 72 void systimer_add(systimer_t); 73 void systimer_del(systimer_t); 74 void systimer_init_periodic(systimer_t, void *, void *, int); 75 void systimer_init_periodic_nq(systimer_t, void *, void *, int); 76 void systimer_init_oneshot(systimer_t, void *, void *, int); 77 78 /* 79 * cputimer interface. This provides a free-running (non-interrupt) 80 * timebase for the system. The cputimer 81 * 82 * These variables hold the fixed cputimer frequency, determining the 83 * granularity of cputimer_count(). 84 * 85 * The 64 bit versions are used for converting count values into uS or nS 86 * as follows: 87 * 88 * usec = (cputimer_freq64_usec * count) >> 32 89 */ 90 91 struct cputimer { 92 SLIST_ENTRY(cputimer) next; 93 const char *name; 94 int pri; 95 int type; 96 sysclock_t (*count)(void); 97 sysclock_t (*fromhz)(int freq); 98 sysclock_t (*fromus)(int us); 99 void (*construct)(struct cputimer *cputimer, sysclock_t oldclock); 100 void (*destruct)(struct cputimer *cputimer); 101 sysclock_t freq; /* in Hz */ 102 int64_t freq64_usec; /* in (1e6 << 32) / timer_freq */ 103 int64_t freq64_nsec; /* in (1e9 << 32) / timer_freq */ 104 sysclock_t base; /* (implementation dependant) */ 105 }; 106 107 extern struct cputimer *sys_cputimer; 108 109 #define CPUTIMER_DUMMY 0 110 #define CPUTIMER_8254_SEL1 1 111 #define CPUTIMER_8254_SEL2 2 112 #define CPUTIMER_ACPI 3 113 #define CPUTIMER_VKERNEL 4 114 115 #define CPUTIMER_PRI_DUMMY -10 116 #define CPUTIMER_PRI_8254 0 117 #define CPUTIMER_PRI_ACPI 10 118 #define CPUTIMER_PRI_VKERNEL 20 119 120 /* 121 * note that cputimer_count() always returns a full-width wrapping counter. 122 */ 123 void cputimer_select(struct cputimer *, int); 124 void cputimer_register(struct cputimer *); 125 void cputimer_deregister(struct cputimer *); 126 void cputimer_set_frequency(struct cputimer *, int); 127 sysclock_t cputimer_default_fromhz(int); 128 sysclock_t cputimer_default_fromus(int); 129 void cputimer_default_construct(struct cputimer *, sysclock_t); 130 void cputimer_default_destruct(struct cputimer *); 131 132 void cputimer_intr_config(struct cputimer *); 133 void cputimer_intr_reload(sysclock_t); 134 135 #endif 136 137