Home | History | Annotate | Line # | Download | only in isa
      1 /*	$NetBSD: clock.c,v 1.42 2025/02/24 07:18:02 imil Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1990 The Regents of the University of California.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to Berkeley by
      8  * William Jolitz and Don Ahn.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     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 the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. Neither the name of the University nor the names of its contributors
     19  *    may be used to endorse or promote products derived from this software
     20  *    without specific prior written permission.
     21  *
     22  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     32  * SUCH DAMAGE.
     33  *
     34  *	@(#)clock.c	7.2 (Berkeley) 5/12/91
     35  */
     36 /*-
     37  * Copyright (c) 1993, 1994 Charles M. Hannum.
     38  *
     39  * This code is derived from software contributed to Berkeley by
     40  * William Jolitz and Don Ahn.
     41  *
     42  * Redistribution and use in source and binary forms, with or without
     43  * modification, are permitted provided that the following conditions
     44  * are met:
     45  * 1. Redistributions of source code must retain the above copyright
     46  *    notice, this list of conditions and the following disclaimer.
     47  * 2. Redistributions in binary form must reproduce the above copyright
     48  *    notice, this list of conditions and the following disclaimer in the
     49  *    documentation and/or other materials provided with the distribution.
     50  * 3. All advertising materials mentioning features or use of this software
     51  *    must display the following acknowledgement:
     52  *	This product includes software developed by the University of
     53  *	California, Berkeley and its contributors.
     54  * 4. Neither the name of the University nor the names of its contributors
     55  *    may be used to endorse or promote products derived from this software
     56  *    without specific prior written permission.
     57  *
     58  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     59  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     60  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     61  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     62  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     63  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     64  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     65  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     66  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     67  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     68  * SUCH DAMAGE.
     69  *
     70  *	@(#)clock.c	7.2 (Berkeley) 5/12/91
     71  */
     72 /*
     73  * Mach Operating System
     74  * Copyright (c) 1991,1990,1989 Carnegie Mellon University
     75  * All Rights Reserved.
     76  *
     77  * Permission to use, copy, modify and distribute this software and its
     78  * documentation is hereby granted, provided that both the copyright
     79  * notice and this permission notice appear in all copies of the
     80  * software, derivative works or modified versions, and any portions
     81  * thereof, and that both notices appear in supporting documentation.
     82  *
     83  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
     84  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
     85  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
     86  *
     87  * Carnegie Mellon requests users of this software to return to
     88  *
     89  *  Software Distribution Coordinator  or  Software.Distribution (at) CS.CMU.EDU
     90  *  School of Computer Science
     91  *  Carnegie Mellon University
     92  *  Pittsburgh PA 15213-3890
     93  *
     94  * any improvements or extensions that they make and grant Carnegie Mellon
     95  * the rights to redistribute these changes.
     96  */
     97 /*
     98   Copyright 1988, 1989 by Intel Corporation, Santa Clara, California.
     99 
    100 		All Rights Reserved
    101 
    102 Permission to use, copy, modify, and distribute this software and
    103 its documentation for any purpose and without fee is hereby
    104 granted, provided that the above copyright notice appears in all
    105 copies and that both the copyright notice and this permission notice
    106 appear in supporting documentation, and that the name of Intel
    107 not be used in advertising or publicity pertaining to distribution
    108 of the software without specific, written prior permission.
    109 
    110 INTEL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
    111 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS,
    112 IN NO EVENT SHALL INTEL BE LIABLE FOR ANY SPECIAL, INDIRECT, OR
    113 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
    114 LOSS OF USE, DATA OR PROFITS, WHETHER IN ACTION OF CONTRACT,
    115 NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
    116 WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
    117 */
    118 
    119 /*
    120  * Primitive clock interrupt routines.
    121  */
    122 
    123 #include <sys/cdefs.h>
    124 __KERNEL_RCSID(0, "$NetBSD: clock.c,v 1.42 2025/02/24 07:18:02 imil Exp $");
    125 
    126 /* #define CLOCKDEBUG */
    127 /* #define CLOCK_PARANOIA */
    128 
    129 #include "opt_multiprocessor.h"
    130 #include "opt_ntp.h"
    131 
    132 #include <sys/param.h>
    133 #include <sys/systm.h>
    134 #include <sys/time.h>
    135 #include <sys/timetc.h>
    136 #include <sys/kernel.h>
    137 #include <sys/device.h>
    138 #include <sys/mutex.h>
    139 #include <sys/cpu.h>
    140 #include <sys/intr.h>
    141 
    142 #include <machine/pio.h>
    143 #include <machine/cpufunc.h>
    144 #include <machine/lock.h>
    145 
    146 #include <dev/isa/isareg.h>
    147 #include <dev/isa/isavar.h>
    148 #include <dev/ic/mc146818reg.h>
    149 #include <dev/ic/i8253reg.h>
    150 #include <i386/isa/nvram.h>
    151 #include <x86/x86/tsc.h>
    152 #include <x86/lock.h>
    153 #include <machine/specialreg.h>
    154 #include <x86/rtc.h>
    155 #include <x86/intr_private.h>
    156 
    157 #ifndef __x86_64__
    158 #include "mca.h"
    159 #endif
    160 #if NMCA > 0
    161 #include <machine/mca_machdep.h>	/* for MCA_system */
    162 #endif
    163 
    164 #include "pcppi.h"
    165 #if (NPCPPI > 0)
    166 #include <dev/isa/pcppivar.h>
    167 
    168 int sysbeepmatch(device_t, cfdata_t, void *);
    169 void sysbeepattach(device_t, device_t, void *);
    170 int sysbeepdetach(device_t, int);
    171 
    172 CFATTACH_DECL3_NEW(sysbeep, 0,
    173     sysbeepmatch, sysbeepattach, sysbeepdetach, NULL, NULL, NULL,
    174     DVF_DETACH_SHUTDOWN);
    175 
    176 static int ppi_attached;
    177 static pcppi_tag_t ppicookie;
    178 #endif /* PCPPI */
    179 
    180 #ifdef CLOCKDEBUG
    181 int clock_debug = 0;
    182 #define DPRINTF(arg) if (clock_debug) printf arg
    183 #else
    184 #define DPRINTF(arg)
    185 #endif
    186 
    187 void (*x86_delay)(unsigned int) = i8254_delay;
    188 
    189 void		sysbeep(int, int);
    190 static void     tickle_tc(void);
    191 
    192 int 		sysbeepdetach(device_t, int);
    193 
    194 static unsigned int	gettick_broken_latch(void);
    195 
    196 static volatile uint32_t i8254_lastcount;
    197 static volatile uint32_t i8254_offset;
    198 static volatile int i8254_ticked;
    199 
    200 /* to protect TC timer variables */
    201 static __cpu_simple_lock_t tmr_lock = __SIMPLELOCK_UNLOCKED;
    202 
    203 u_int i8254_get_timecount(struct timecounter *);
    204 
    205 static struct timecounter i8254_timecounter = {
    206 	.tc_get_timecount = i8254_get_timecount,
    207 	.tc_counter_mask = ~0u,
    208 	.tc_frequency = TIMER_FREQ,
    209 	.tc_name = "i8254",
    210 	.tc_quality = 100,
    211 };
    212 
    213 u_long x86_rtclock_tval;	/* i8254 reload value for countdown */
    214 int    rtclock_init = 0;
    215 
    216 int clock_broken_latch = 0;
    217 
    218 #ifdef CLOCK_PARANOIA
    219 static int ticks[6];
    220 #endif
    221 /*
    222  * i8254 latch check routine:
    223  *     National Geode (formerly Cyrix MediaGX) has a serious bug in
    224  *     its built-in i8254-compatible clock module.
    225  *     machdep sets the variable 'clock_broken_latch' to indicate it.
    226  */
    227 
    228 static unsigned int
    229 gettick_broken_latch(void)
    230 {
    231 	int v1, v2, v3;
    232 	int w1, w2, w3;
    233 	int s;
    234 
    235 	/* Don't want someone screwing with the counter while we're here. */
    236 	s = splhigh();
    237 	__cpu_simple_lock(&tmr_lock);
    238 	v1 = inb(IO_TIMER1+TIMER_CNTR0);
    239 	v1 |= inb(IO_TIMER1+TIMER_CNTR0) << 8;
    240 	v2 = inb(IO_TIMER1+TIMER_CNTR0);
    241 	v2 |= inb(IO_TIMER1+TIMER_CNTR0) << 8;
    242 	v3 = inb(IO_TIMER1+TIMER_CNTR0);
    243 	v3 |= inb(IO_TIMER1+TIMER_CNTR0) << 8;
    244 	__cpu_simple_unlock(&tmr_lock);
    245 	splx(s);
    246 
    247 #ifdef CLOCK_PARANOIA
    248 	if (clock_debug) {
    249 		ticks[0] = ticks[3];
    250 		ticks[1] = ticks[4];
    251 		ticks[2] = ticks[5];
    252 		ticks[3] = v1;
    253 		ticks[4] = v2;
    254 		ticks[5] = v3;
    255 	}
    256 #endif
    257 
    258 	if (v1 >= v2 && v2 >= v3 && v1 - v3 < 0x200)
    259 		return (v2);
    260 
    261 #define _swap_val(a, b) do { \
    262 	int c = a; \
    263 	a = b; \
    264 	b = c; \
    265 } while (0)
    266 
    267 	/*
    268 	 * sort v1 v2 v3
    269 	 */
    270 	if (v1 < v2)
    271 		_swap_val(v1, v2);
    272 	if (v2 < v3)
    273 		_swap_val(v2, v3);
    274 	if (v1 < v2)
    275 		_swap_val(v1, v2);
    276 
    277 	/*
    278 	 * compute the middle value
    279 	 */
    280 
    281 	if (v1 - v3 < 0x200)
    282 		return (v2);
    283 
    284 	w1 = v2 - v3;
    285 	w2 = v3 - v1 + x86_rtclock_tval;
    286 	w3 = v1 - v2;
    287 	if (w1 >= w2) {
    288 		if (w1 >= w3)
    289 		        return (v1);
    290 	} else {
    291 		if (w2 >= w3)
    292 			return (v2);
    293 	}
    294 	return (v3);
    295 }
    296 
    297 /* minimal initialization, enough for delay() */
    298 void
    299 initrtclock(u_long freq)
    300 {
    301 	u_long tval;
    302 
    303 	if (vm_guest == VM_GUEST_XENPVH)
    304 		return;
    305 
    306 	/*
    307 	 * Compute timer_count, the count-down count the timer will be
    308 	 * set to.  Also, correctly round
    309 	 * this by carrying an extra bit through the division.
    310 	 */
    311 	tval = (freq * 2) / (u_long) hz;
    312 	tval = (tval / 2) + (tval & 0x1);
    313 
    314 	/* initialize 8254 clock */
    315 	outb(IO_TIMER1+TIMER_MODE, TIMER_SEL0|TIMER_RATEGEN|TIMER_16BIT);
    316 
    317 	/* Correct rounding will buy us a better precision in timekeeping */
    318 	outb(IO_TIMER1+TIMER_CNTR0, tval % 256);
    319 	outb(IO_TIMER1+TIMER_CNTR0, tval / 256);
    320 
    321 	x86_rtclock_tval = tval ? tval : 0xFFFF;
    322 	rtclock_init = 1;
    323 }
    324 
    325 void
    326 startrtclock(void)
    327 {
    328 	int s;
    329 
    330 	/*
    331 	 * Check that RTC is present, bits 0 to 6 of register D are
    332 	 * read-only and must be 0. At least on QEMU/microvm, when
    333 	 * rtc=off, all bits are set to 1
    334 	 */
    335 	if ((mc146818_read(NULL, MC_REGD) & 0x7f) != 0)
    336 		return;
    337 
    338 	if (!rtclock_init)
    339 		initrtclock(TIMER_FREQ);
    340 
    341 	/* Check diagnostic status */
    342 	if ((s = mc146818_read(NULL, NVRAM_DIAG)) != 0) { /* XXX softc */
    343 		char bits[128];
    344 		snprintb(bits, sizeof(bits), NVRAM_DIAG_BITS, s);
    345 		printf("RTC BIOS diagnostic error %s\n", bits);
    346 	}
    347 
    348 	tc_init(&i8254_timecounter);
    349 	rtc_register();
    350 }
    351 
    352 /*
    353  * Must be called at splsched().
    354  */
    355 static void
    356 tickle_tc(void)
    357 {
    358 #if defined(MULTIPROCESSOR)
    359 	struct cpu_info *ci = curcpu();
    360 	/*
    361 	 * If we are not the primary CPU, we're not allowed to do
    362 	 * any more work.
    363 	 */
    364 	if (CPU_IS_PRIMARY(ci) == 0)
    365 		return;
    366 #endif
    367 	if (x86_rtclock_tval &&
    368 	    timecounter->tc_get_timecount == i8254_get_timecount) {
    369 		__cpu_simple_lock(&tmr_lock);
    370 		if (i8254_ticked)
    371 			i8254_ticked    = 0;
    372 		else {
    373 			i8254_offset   += x86_rtclock_tval;
    374 			i8254_lastcount = 0;
    375 		}
    376 		__cpu_simple_unlock(&tmr_lock);
    377 	}
    378 
    379 }
    380 
    381 int
    382 i8254_clockintr(void *arg, struct intrframe *frame)
    383 {
    384 	tickle_tc();
    385 
    386 	hardclock((struct clockframe *)frame);
    387 
    388 #if NMCA > 0
    389 	if (MCA_system) {
    390 		/* Reset PS/2 clock interrupt by asserting bit 7 of port 0x61 */
    391 		outb(0x61, inb(0x61) | 0x80);
    392 	}
    393 #endif
    394 	return -1;
    395 }
    396 
    397 u_int
    398 i8254_get_timecount(struct timecounter *tc)
    399 {
    400 	u_int count;
    401 	uint16_t rdval;
    402 	u_long psl;
    403 
    404 	/* Don't want someone screwing with the counter while we're here. */
    405 	psl = x86_read_psl();
    406 	x86_disable_intr();
    407 	__cpu_simple_lock(&tmr_lock);
    408 	/* Select timer0 and latch counter value. */
    409 	outb(IO_TIMER1 + TIMER_MODE, TIMER_SEL0 | TIMER_LATCH);
    410 	/* insb to make the read atomic */
    411 	rdval = inb(IO_TIMER1+TIMER_CNTR0);
    412 	rdval |= (inb(IO_TIMER1+TIMER_CNTR0) << 8);
    413 	count = x86_rtclock_tval - rdval;
    414 	if (x86_rtclock_tval && (count < i8254_lastcount &&
    415 			     (!i8254_ticked || x86_rtclock_tval == 0xFFFF))) {
    416 		i8254_ticked = 1;
    417 		i8254_offset += x86_rtclock_tval;
    418 	}
    419 	i8254_lastcount = count;
    420 	count += i8254_offset;
    421 	__cpu_simple_unlock(&tmr_lock);
    422 	x86_write_psl(psl);
    423 
    424 	return (count);
    425 }
    426 
    427 unsigned int
    428 gettick(void)
    429 {
    430 	uint16_t rdval;
    431 	u_long psl;
    432 
    433 	if (clock_broken_latch)
    434 		return (gettick_broken_latch());
    435 
    436 	/* Don't want someone screwing with the counter while we're here. */
    437 	psl = x86_read_psl();
    438 	x86_disable_intr();
    439 	__cpu_simple_lock(&tmr_lock);
    440 	/* Select counter 0 and latch it. */
    441 	outb(IO_TIMER1+TIMER_MODE, TIMER_SEL0 | TIMER_LATCH);
    442 	rdval = inb(IO_TIMER1+TIMER_CNTR0);
    443 	rdval |= (inb(IO_TIMER1+TIMER_CNTR0) << 8);
    444 	__cpu_simple_unlock(&tmr_lock);
    445 	x86_write_psl(psl);
    446 
    447 	return rdval;
    448 }
    449 
    450 /*
    451  * Wait approximately `n' microseconds.
    452  * Relies on timer 1 counting down from (TIMER_FREQ / hz) at TIMER_FREQ Hz.
    453  * Note: timer had better have been programmed before this is first used!
    454  * (Note that we use `rate generator' mode, which counts at 1:1; `square
    455  * wave' mode counts at 2:1).
    456  * Don't rely on this being particularly accurate.
    457  */
    458 void
    459 i8254_delay(unsigned int n)
    460 {
    461 	unsigned int cur_tick, initial_tick;
    462 	int remaining;
    463 
    464 	/* allow DELAY() to be used before startrtclock() */
    465 	if (!rtclock_init)
    466 		initrtclock(TIMER_FREQ);
    467 
    468 	/*
    469 	 * Read the counter first, so that the rest of the setup overhead is
    470 	 * counted.
    471 	 */
    472 	initial_tick = gettick();
    473 
    474 	if (n <= UINT_MAX / TIMER_FREQ) {
    475 		/*
    476 		 * For unsigned arithmetic, division can be replaced with
    477 		 * multiplication with the inverse and a shift.
    478 		 */
    479 		remaining = n * TIMER_FREQ / 1000000;
    480 	} else {
    481 		/* This is a very long delay.
    482 		 * Being slow here doesn't matter.
    483 		 */
    484 		remaining = (unsigned long long) n * TIMER_FREQ / 1000000;
    485 	}
    486 
    487 	while (remaining > 1) {
    488 #ifdef CLOCK_PARANOIA
    489 		int delta;
    490 		cur_tick = gettick();
    491 		if (cur_tick > initial_tick)
    492 			delta = x86_rtclock_tval - (cur_tick - initial_tick);
    493 		else
    494 			delta = initial_tick - cur_tick;
    495 		if (delta < 0 || delta >= x86_rtclock_tval / 2) {
    496 			DPRINTF(("delay: ignore ticks %.4x-%.4x",
    497 				 initial_tick, cur_tick));
    498 			if (clock_broken_latch) {
    499 				DPRINTF(("  (%.4x %.4x %.4x %.4x %.4x %.4x)\n",
    500 				         ticks[0], ticks[1], ticks[2],
    501 				         ticks[3], ticks[4], ticks[5]));
    502 			} else {
    503 				DPRINTF(("\n"));
    504 			}
    505 		} else
    506 			remaining -= delta;
    507 #else
    508 		cur_tick = gettick();
    509 		if (cur_tick > initial_tick)
    510 			remaining -= x86_rtclock_tval - (cur_tick - initial_tick);
    511 		else
    512 			remaining -= initial_tick - cur_tick;
    513 #endif
    514 		initial_tick = cur_tick;
    515 	}
    516 }
    517 
    518 #if (NPCPPI > 0)
    519 int
    520 sysbeepmatch(device_t parent, cfdata_t match, void *aux)
    521 {
    522 	if (vm_guest == VM_GUEST_XENPVH)
    523 		return 0;
    524 	return (!ppi_attached);
    525 }
    526 
    527 void
    528 sysbeepattach(device_t parent, device_t self, void *aux)
    529 {
    530 	aprint_naive("\n");
    531 	aprint_normal("\n");
    532 
    533 	ppicookie = ((struct pcppi_attach_args *)aux)->pa_cookie;
    534 	ppi_attached = 1;
    535 
    536 	if (!pmf_device_register(self, NULL, NULL))
    537 		aprint_error_dev(self, "couldn't establish power handler\n");
    538 }
    539 
    540 int
    541 sysbeepdetach(device_t self, int flags)
    542 {
    543 	pmf_device_deregister(self);
    544 	ppi_attached = 0;
    545 	return 0;
    546 }
    547 #endif
    548 
    549 void
    550 sysbeep(int pitch, int period)
    551 {
    552 #if (NPCPPI > 0)
    553 	if (ppi_attached)
    554 		pcppi_bell(ppicookie, pitch, period, 0);
    555 #endif
    556 }
    557 
    558 void
    559 i8254_initclocks(void)
    560 {
    561 
    562 	/*
    563 	 * XXX If you're doing strange things with multiple clocks, you might
    564 	 * want to keep track of clock handlers.
    565 	 *
    566 	 * XXX This is an abuse of the interrupt handler signature with
    567 	 * __FPTRCAST which requires a special case for IPL_CLOCK in
    568 	 * intr_establish_xname.  Please fix this nonsense!  See also
    569 	 * the comments about i8254_clockintr in x86/x86/intr.c.
    570 	 */
    571 	(void)isa_intr_establish(NULL, 0, IST_PULSE, IPL_CLOCK,
    572 	    __FPTRCAST(int (*)(void *), i8254_clockintr), 0);
    573 }
    574 
    575 void
    576 setstatclockrate(int arg)
    577 {
    578 }
    579