2 * Copyright (c) 2000-2010 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
30 #include <i386/apic.h>
31 #include <i386/eflags.h>
32 #include <i386/rtclock_asm.h>
33 #include <i386/postcode.h>
34 #include <i386/proc_reg.h>
40 ** Entry - %esp contains pointer to 64 bit structure.
42 ** Exit - 64 bit structure filled in.
45 ENTRY(ml_get_timebase)
59 * Convert between various timer units
61 * uint64_t tmrCvt(uint64_t time, uint64_t *conversion)
63 * This code converts 64-bit time units to other units.
64 * For example, the TSC is converted to HPET units.
66 * Time is a 64-bit integer that is some number of ticks.
67 * Conversion is 64-bit fixed point number which is composed
68 * of a 32 bit integer and a 32 bit fraction.
70 * The time ticks are multiplied by the conversion factor. The
71 * calculations are done as a 128-bit value but both the high
72 * and low words are dropped. The high word is overflow and the
73 * low word is the fraction part of the result.
75 * We return a 64-bit value.
77 * Note that we can use this function to multiply 2 conversion factors.
78 * We do this in order to calculate the multiplier used to convert
79 * directly between any two units.
88 pushl %ebp // Save a volatile
89 movl %esp,%ebp // Get the parameters - 8
90 pushl %ebx // Save a volatile
91 pushl %esi // Save a volatile
92 pushl %edi // Save a volatile
94 // %ebp + 8 - low-order ts
95 // %ebp + 12 - high-order ts
96 // %ebp + 16 - low-order cvt
97 // %ebp + 20 - high-order cvt
99 movl 8(%ebp),%eax // Get low-order ts
100 mull 16(%ebp) // Multiply by low-order conversion
101 movl %edx,%edi // Need to save only the high order part
103 movl 12(%ebp),%eax // Get the high-order ts
104 mull 16(%ebp) // Multiply by low-order conversion
105 addl %eax,%edi // Add in the overflow from the low x low calculation
106 adcl $0,%edx // Add in any overflow to high high part
107 movl %edx,%esi // Save high high part
109 // We now have the upper 64 bits of the 96 bit multiply of ts and the low half of cvt
112 movl 8(%ebp),%eax // Get low-order ts
113 mull 20(%ebp) // Multiply by high-order conversion
114 movl %eax,%ebx // Need to save the low order part
115 movl %edx,%ecx // Need to save the high order part
117 movl 12(%ebp),%eax // Get the high-order ts
118 mull 20(%ebp) // Multiply by high-order conversion
120 // Now have %ecx:%ebx as low part of high low and %edx:%eax as high part of high high
121 // We don't care about the highest word since it is overflow
123 addl %edi,%ebx // Add the low words
124 adcl %ecx,%esi // Add in the high plus carry from low
125 addl %eax,%esi // Add in the rest of the high
127 movl %ebx,%eax // Pass back low word
128 movl %esi,%edx // and the high word
130 popl %edi // Restore a volatile
131 popl %esi // Restore a volatile
132 popl %ebx // Restore a volatile
133 popl %ebp // Restore a volatile
138 /* void _rtc_nanotime_adjust(
139 uint64_t tsc_base_delta,
140 rtc_nanotime_t *dst);
142 .globl EXT(_rtc_nanotime_adjust)
145 LEXT(_rtc_nanotime_adjust)
146 mov 12(%esp),%edx /* ptr to rtc_nanotime_info */
148 movl RNT_GENERATION(%edx),%ecx /* get current generation */
149 movl $0,RNT_GENERATION(%edx) /* flag data as being updated */
151 movl 4(%esp),%eax /* get lower 32-bits of delta */
152 addl %eax,RNT_TSC_BASE(%edx)
153 adcl $0,RNT_TSC_BASE+4(%edx) /* propagate carry */
155 incl %ecx /* next generation */
157 incl %ecx /* skip 0, which is a flag */
158 1: movl %ecx,RNT_GENERATION(%edx) /* update generation and make usable */
163 /* unint64_t _rtc_nanotime_read( rtc_nanotime_t *rntp, int slow );
165 * This is the same as the commpage nanotime routine, except that it uses the
166 * kernel internal "rtc_nanotime_info" data instead of the commpage data. The two copies
167 * of data (one in the kernel and one in user space) are kept in sync by rtc_clock_napped().
169 * Warning! There is another copy of this code in osfmk/i386/locore.s. The
170 * two versions must be kept in sync with each other!
172 * There are actually two versions of the algorithm, one each for "slow" and "fast"
173 * processors. The more common "fast" algorithm is:
175 * nanoseconds = (((rdtsc - rnt_tsc_base) * rnt_tsc_scale) / 2**32) - rnt_ns_base;
177 * Of course, the divide by 2**32 is a nop. rnt_tsc_scale is a constant computed during initialization:
179 * rnt_tsc_scale = (10e9 * 2**32) / tscFreq;
181 * The "slow" algorithm uses long division:
183 * nanoseconds = (((rdtsc - rnt_tsc_base) * 10e9) / tscFreq) - rnt_ns_base;
185 * Since this routine is not synchronized and can be called in any context,
186 * we use a generation count to guard against seeing partially updated data. In addition,
187 * the _rtc_nanotime_store() routine -- just above -- zeroes the generation before
188 * updating the data, and stores the nonzero generation only after all other data has been
189 * stored. Because IA32 guarantees that stores by one processor must be seen in order
190 * by another, we can avoid using a lock. We spin while the generation is zero.
192 * In accordance with the ABI, we return the 64-bit nanotime in %edx:%eax.
195 .globl EXT(_rtc_nanotime_read)
197 LEXT(_rtc_nanotime_read)
203 movl 8(%ebp),%edi /* get ptr to rtc_nanotime_info */
204 movl 12(%ebp),%eax /* get "slow" flag */
208 /* Processor whose TSC frequency is faster than SLOW_TSC_THRESHOLD */
209 PAL_RTC_NANOTIME_READ_FAST()
217 /* Processor whose TSC frequency is slower than or equal to SLOW_TSC_THRESHOLD */
219 movl RNT_GENERATION(%edi),%esi /* get generation (0 if being changed) */
220 testl %esi,%esi /* if being changed, loop until stable */
222 pushl %esi /* save generation */
223 pushl RNT_SHIFT(%edi) /* save low 32 bits of tscFreq */
226 rdtsc /* get TSC in %edx:%eax */
228 subl RNT_TSC_BASE(%edi),%eax
229 sbbl RNT_TSC_BASE+4(%edi),%edx
232 * Do the math to convert tsc ticks to nanoseconds. We first
233 * do long multiply of 1 billion times the tsc. Then we do
234 * long division by the tsc frequency
236 mov $1000000000, %ecx /* number of nanoseconds in a second */
244 adc $0, %edx /* result in edx:eax:esi */
246 popl %ecx /* get low 32 tscFreq */
256 mov %ebx, %edx /* result in edx:eax */
258 movl 8(%ebp),%edi /* recover ptr to rtc_nanotime_info */
259 popl %esi /* recover generation */
261 addl RNT_NS_BASE(%edi),%eax
262 adcl RNT_NS_BASE+4(%edi),%edx
264 cmpl RNT_GENERATION(%edi),%esi /* have the parameters changed? */
265 jne Lslow /* yes, loop until stable */
271 ret /* result in edx:eax */
282 movl %eax,TIMER_HIGHCHK(%ecx)
283 movl %edx,TIMER_LOW(%ecx)
284 movl %eax,TIMER_HIGH(%ecx)
289 0: movl TIMER_HIGH(%ecx),%edx
290 movl TIMER_LOW(%ecx),%eax
291 cmpl TIMER_HIGHCHK(%ecx),%edx
296 Entry(call_continuation)
297 movl S_ARG0,%eax /* get continuation */
298 movl S_ARG1,%edx /* continuation param */
299 movl S_ARG2,%ecx /* wait result */
300 movl %gs:CPU_KERNEL_STACK,%esp /* pop the stack */
301 xorl %ebp,%ebp /* zero frame pointer */
302 subl $8,%esp /* align the stack */
305 call *%eax /* call continuation */
307 movl %gs:CPU_ACTIVE_THREAD,%eax
309 call EXT(thread_terminate)
312 Entry(ml_early_random)