1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 2013 Neel Natu <neel@freebsd.org> 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 * 28 * $FreeBSD$ 29 */ 30 /* 31 * This file and its contents are supplied under the terms of the 32 * Common Development and Distribution License ("CDDL"), version 1.0. 33 * You may only use this file in accordance with the terms of version 34 * 1.0 of the CDDL. 35 * 36 * A full copy of the text of the CDDL should have accompanied this 37 * source. A copy of the CDDL is also available via the Internet at 38 * http://www.illumos.org/license/CDDL. 39 * 40 * Copyright 2023 Oxide Computer Company 41 */ 42 43 #ifndef _VLAPIC_PRIV_H_ 44 #define _VLAPIC_PRIV_H_ 45 46 #include <x86/apicreg.h> 47 48 /* 49 * APIC Register: Offset Description 50 */ 51 #define APIC_OFFSET_ID 0x20 /* Local APIC ID */ 52 #define APIC_OFFSET_VER 0x30 /* Local APIC Version */ 53 #define APIC_OFFSET_TPR 0x80 /* Task Priority Register */ 54 #define APIC_OFFSET_APR 0x90 /* Arbitration Priority */ 55 #define APIC_OFFSET_PPR 0xA0 /* Processor Priority Register */ 56 #define APIC_OFFSET_EOI 0xB0 /* EOI Register */ 57 #define APIC_OFFSET_RRR 0xC0 /* Remote read */ 58 #define APIC_OFFSET_LDR 0xD0 /* Logical Destination */ 59 #define APIC_OFFSET_DFR 0xE0 /* Destination Format Register */ 60 #define APIC_OFFSET_SVR 0xF0 /* Spurious Vector Register */ 61 #define APIC_OFFSET_ISR0 0x100 /* In Service Register */ 62 #define APIC_OFFSET_ISR1 0x110 63 #define APIC_OFFSET_ISR2 0x120 64 #define APIC_OFFSET_ISR3 0x130 65 #define APIC_OFFSET_ISR4 0x140 66 #define APIC_OFFSET_ISR5 0x150 67 #define APIC_OFFSET_ISR6 0x160 68 #define APIC_OFFSET_ISR7 0x170 69 #define APIC_OFFSET_TMR0 0x180 /* Trigger Mode Register */ 70 #define APIC_OFFSET_TMR1 0x190 71 #define APIC_OFFSET_TMR2 0x1A0 72 #define APIC_OFFSET_TMR3 0x1B0 73 #define APIC_OFFSET_TMR4 0x1C0 74 #define APIC_OFFSET_TMR5 0x1D0 75 #define APIC_OFFSET_TMR6 0x1E0 76 #define APIC_OFFSET_TMR7 0x1F0 77 #define APIC_OFFSET_IRR0 0x200 /* Interrupt Request Register */ 78 #define APIC_OFFSET_IRR1 0x210 79 #define APIC_OFFSET_IRR2 0x220 80 #define APIC_OFFSET_IRR3 0x230 81 #define APIC_OFFSET_IRR4 0x240 82 #define APIC_OFFSET_IRR5 0x250 83 #define APIC_OFFSET_IRR6 0x260 84 #define APIC_OFFSET_IRR7 0x270 85 #define APIC_OFFSET_ESR 0x280 /* Error Status Register */ 86 #define APIC_OFFSET_CMCI_LVT 0x2F0 /* Local Vector Table (CMCI) */ 87 #define APIC_OFFSET_ICR_LOW 0x300 /* Interrupt Command Register */ 88 #define APIC_OFFSET_ICR_HI 0x310 89 #define APIC_OFFSET_TIMER_LVT 0x320 /* Local Vector Table (Timer) */ 90 #define APIC_OFFSET_THERM_LVT 0x330 /* Local Vector Table (Thermal) */ 91 #define APIC_OFFSET_PERF_LVT 0x340 /* Local Vector Table (PMC) */ 92 #define APIC_OFFSET_LINT0_LVT 0x350 /* Local Vector Table (LINT0) */ 93 #define APIC_OFFSET_LINT1_LVT 0x360 /* Local Vector Table (LINT1) */ 94 #define APIC_OFFSET_ERROR_LVT 0x370 /* Local Vector Table (ERROR) */ 95 #define APIC_OFFSET_TIMER_ICR 0x380 /* Timer's Initial Count */ 96 #define APIC_OFFSET_TIMER_CCR 0x390 /* Timer's Current Count */ 97 #define APIC_OFFSET_TIMER_DCR 0x3E0 /* Timer's Divide Configuration */ 98 #define APIC_OFFSET_SELF_IPI 0x3F0 /* Self IPI register */ 99 100 /* 101 * 16 priority levels with at most one vector injected per level. 102 */ 103 #define ISRVEC_STK_SIZE (16 + 1) 104 105 #define VLAPIC_MAXLVT_INDEX APIC_LVT_CMCI 106 107 #define VLAPIC_TMR_CNT 8 108 109 struct vlapic; 110 111 struct vlapic_ops { 112 vcpu_notify_t (*set_intr_ready)(struct vlapic *vlapic, int vector, 113 bool level); 114 void (*sync_state)(struct vlapic *vlapic); 115 void (*intr_accepted)(struct vlapic *vlapic, int vector); 116 void (*post_intr)(struct vlapic *vlapic, int hostcpu); 117 void (*enable_x2apic_mode)(struct vlapic *vlapic); 118 }; 119 120 struct vlapic_stats { 121 /* Result of a CCR read was clamped due to being > ICR */ 122 uint64_t vs_clamp_ccr; 123 /* Imported timer expiration further in future than ICR equiv */ 124 uint64_t vs_import_timer_overage; 125 }; 126 127 struct vlapic { 128 struct vm *vm; 129 int vcpuid; 130 struct LAPIC *apic_page; 131 struct vlapic_ops ops; 132 133 uint32_t esr_pending; 134 135 struct callout callout; /* vlapic timer */ 136 hrtime_t timer_fire_when; 137 hrtime_t timer_period; 138 uint32_t timer_cur_freq; 139 140 kmutex_t timer_lock; 141 142 uint64_t msr_apicbase; 143 144 /* 145 * Copies of some registers in the virtual APIC page. We do this for 146 * a couple of different reasons: 147 * - to be able to detect what changed (e.g. svr_last) 148 * - to maintain a coherent snapshot of the register (e.g. lvt_last) 149 */ 150 uint32_t svr_last; 151 uint32_t lvt_last[VLAPIC_MAXLVT_INDEX + 1]; 152 153 /* Occurrences of unusual events are tracked in this stats struct. */ 154 struct vlapic_stats stats; 155 }; 156 157 void vlapic_init(struct vlapic *vlapic); 158 void vlapic_cleanup(struct vlapic *vlapic); 159 160 #endif /* _VLAPIC_PRIV_H_ */ 161