freebsd-dev/sys/amd64/include/clock.h

/*-
 * Kernel interface to machine-dependent clock driver.
 * Garrett Wollman, September 1994.
 * This file is in the public domain.
 *
 * $FreeBSD$
 */

#ifndef _MACHINE_CLOCK_H_
#define	_MACHINE_CLOCK_H_

#ifdef _KERNEL
/*
 * i386 to clock driver interface.
 * XXX large parts of the driver and its interface are misplaced.
 */
extern int	adjkerntz;
extern int	clkintr_pending;
extern int	disable_rtc_set;
extern int	pscnt;
extern int	psdiv;
extern int	statclock_disable;
extern u_int	timer_freq;
extern int	timer0_max_count;
extern uint64_t	tsc_freq;
extern int	tsc_is_broken;
extern int	wall_cmos_clock;

/*
 * Driver to clock driver interface.
 */
struct clockframe;

int	acquire_timer2(int mode);
int	release_timer2(void);
int	rtcin(int val);
int	sysbeep(int pitch, int period);
void	init_TSC(void);
void	init_TSC_tc(void);

#endif /* _KERNEL */

#endif /* !_MACHINE_CLOCK_H_ */
Begin all license/copyright comments with /*- 2005-01-05 20:17:21 +00:00			`/*-`
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00			`* Kernel interface to machine-dependent clock driver.`
			`* Garrett Wollman, September 1994.`
			`* This file is in the public domain.`
Fix Pentium CPU rate diagnosis: - Don't print out meaningless iCOMP numbers, those are for droids. - Use a shorter wait to determine clock rate to avoid deficiencies in DELAY(). - Use a fixed-point representation with 8 bits of fraction to store the rate and rationalize the variable name. It would be possible to use even more fraction if it turns out to be worthwhile (I rather doubt it). The question of source code arrangement remains unaddressed. 1995-11-29 19:57:22 +00:00			`*`
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`* $FreeBSD$`
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00			`*/`

			`#ifndef _MACHINE_CLOCK_H_`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`#define _MACHINE_CLOCK_H_`
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00
Change #ifdef KERNEL to #ifdef _KERNEL in the public headers. "KERNEL" is an application space macro and the applications are supposed to be free to use it as they please (but cannot). This is consistant with the other BSD's who made this change quite some time ago. More commits to come. 1999-12-29 04:46:21 +00:00			`#ifdef _KERNEL`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`/*`
			`* i386 to clock driver interface.`
Removed vestiges of previous microtime() implementation. 1998-02-25 02:20:30 +00:00			`* XXX large parts of the driver and its interface are misplaced.`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`*/`
			`extern int adjkerntz;`
Initial landing of SMP support for FreeBSD/amd64. - This is heavily derived from John Baldwin's apic/pci cleanup on i386. - I have completely rewritten or drastically cleaned up some other parts. (in particular, bootstrap) - This is still a WIP. It seems that there are some highly bogus bioses on nVidia nForce3-150 boards. I can't stress how broken these boards are. I have a workaround in mind, but right now the Asus SK8N is broken. The Gigabyte K8NPro (nVidia based) is also mind-numbingly hosed. - Most of my testing has been with SCHED_ULE. SCHED_4BSD works. - the apic and acpi components are 'standard'. - If you have an nVidia nForce3-150 board, you are stuck with 'device atpic' in addition, because they somehow managed to forget to connect the 8254 timer to the apic, even though its in the same silicon! ARGH! This directly violates the ACPI spec. 2003-11-17 08:58:16 +00:00			`extern int clkintr_pending;`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`extern int disable_rtc_set;`
Split statclock into statclock and profclock, and made the method for driving statclock based on profhz when profiling is enabled MD, since most platforms don't use this anyway. This removes the need for statclock_process, whose only purpose was to subdivide profhz, and gets the profiling clock running outside of sched_lock on platforms that implement suswintr. Also changed the interface for starting and stopping the profiling clock to do just that, instead of changing the rate of statclock, since they can now be separate. Reviewed by: jhb, tmm Tested on: i386, sparc64 2003-02-03 17:53:15 +00:00			`extern int pscnt;`
			`extern int psdiv;`
wash, sort and put in order various nits from the i586_ctr -> tsc commit. Pointed out by: bde 1997-12-28 13:36:09 +00:00			`extern int statclock_disable;`
			`extern u_int timer_freq;`
			`extern int timer0_max_count;`
Make tsc_freq a 64bit quantity. Inspired by: http://www.theinquirer.net/?article=7481 2003-01-29 11:36:39 +00:00			`extern uint64_t tsc_freq;`
Stop the TSC from being used as timecounter on K5/step0 machines. 1999-05-29 06:57:55 +00:00			`extern int tsc_is_broken;`
Added missing extern declaration of timer_freq. Sorted declarations of scalars. 1996-10-17 17:31:25 +00:00			`extern int wall_cmos_clock;`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
			`/*`
			`* Driver to clock driver interface.`
			`*/`
Improved biasing of i586 clock by adjusting for hardclock() latency. I decided to do this for every hardclock() call instead of lazily in microtime(). The lazy method is simpler but has more overhead if microtime() is called a lot. CPU_THISTICKLEN() is now a no-op and should probably go away. Previously it did nothing directly but had the side effect of setting i586_last_tick for CPU_CLOCKUPDATE() and i586_avg_tick for debugging. CPU_CLOCKUPDATE() now uses a better method and i586_avg_tick is too much trouble to maintain. Reduced nesting of #includes in the usual case. Increased nesting of #includes when CLOCK_HAIR is defined. This is a kludge to get typedefs for inline functions only when the inline functions are used. Normally only kern_clock.c defines this. kern_clock.c can't include the i386 headers directly. Removed unused LOCORE support. 1996-10-25 13:01:56 +00:00			`struct clockframe;`

MFi386: BURN_BRIDGES around timer0 functions 2003-09-30 06:38:11 +00:00			`int acquire_timer2(int mode);`
Remove __P. 2002-03-20 05:48:58 +00:00			`int release_timer2(void);`
			`int rtcin(int val);`
			`int sysbeep(int pitch, int period);`
i386/i386/tsc.c was repo-copied from i386/isa/clock.c. Remove all the stuff that does not relate to the TSC. Change the calibration to use DELAY(1000000) rather than trying to check it against the CMOS RTC, this drastically increases precision: Using 25 samples on a Athlon 700MHz UP machine I find: stddev min max average CMOS 22200 Hz -74980 Hz 34301 Hz 704928721 Hz DELAY 1805 Hz -1984 Hz 2678 Hz 704937583 Hz (The difference between the two averages is not statistically significant.) expressed in PPM of the frequency: stddev min max CMOS 31.49 PPM -106.37 PPM 48.66 PPM DELAY 2.56 PPM 2.81 PPM 3.80 PPM This code will not be used until a followup commit to sys/isa/clock.c and sys/pc98/pc98/clock.c which will only happen after some field testing. 2003-02-05 09:20:40 +00:00			`void init_TSC(void);`
MFi386 machdep.c rev 1.201, clock.c 1.201, clock.h 1.45 by phk: Dont initialize a TSC timecounter until we know if it is broke or not. XXX I think there is a bug in the i386 code here. init_TSC_tc() comes after: if (statclock_disable) return; ie: if you turn off the statclock interrupt, you dont get the TSC either. 2003-09-22 23:02:24 +00:00			`void init_TSC_tc(void);`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
Change #ifdef KERNEL to #ifdef _KERNEL in the public headers. "KERNEL" is an application space macro and the applications are supposed to be free to use it as they please (but cannot). This is consistant with the other BSD's who made this change quite some time ago. More commits to come. 1999-12-29 04:46:21 +00:00			`#endif /* _KERNEL */`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
			`#endif /* !_MACHINE_CLOCK_H_ */`