xref: /dragonfly/sys/dev/virtual/hyperv/hyperv_reg.h (revision 82b778547fb437620f0453271b4db5c69a9980b4)
1 /*-
2  * Copyright (c) 2016 Microsoft Corp.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice unmodified, this list of conditions, and the following
10  *    disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _HYPERV_REG_H_
30 #define _HYPERV_REG_H_
31 
32 #include <sys/param.h>
33 
34 /*
35  * Hyper-V Synthetic MSRs
36  */
37 
38 #define MSR_HV_GUEST_OS_ID              0x40000000
39 #define MSR_HV_GUESTID_BUILD_MASK       0xffffULL
40 #define MSR_HV_GUESTID_VERSION_MASK     0x0000ffffffff0000ULL
41 #define MSR_HV_GUESTID_VERSION_SHIFT    16
42 #define MSR_HV_GUESTID_OSID_MASK        0x00ff000000000000ULL
43 #define MSR_HV_GUESTID_OSID_SHIFT       48
44 #define MSR_HV_GUESTID_OSTYPE_MASK      0x7f00000000000000ULL
45 #define MSR_HV_GUESTID_OSTYPE_SHIFT     56
46 #define MSR_HV_GUESTID_OPENSRC                    0x8000000000000000ULL
47 #define MSR_HV_GUESTID_OSTYPE_LINUX     \
48           ((0x01ULL << MSR_HV_GUESTID_OSTYPE_SHIFT) | MSR_HV_GUESTID_OPENSRC)
49 #define MSR_HV_GUESTID_OSTYPE_FREEBSD   \
50           ((0x02ULL << MSR_HV_GUESTID_OSTYPE_SHIFT) | MSR_HV_GUESTID_OPENSRC)
51 
52 #define MSR_HV_HYPERCALL                0x40000001
53 #define MSR_HV_HYPERCALL_ENABLE                   0x0001ULL
54 #define MSR_HV_HYPERCALL_RSVD_MASK      0x0ffeULL
55 #define MSR_HV_HYPERCALL_PGSHIFT        12
56 
57 #define MSR_HV_VP_INDEX                           0x40000002
58 
59 #define MSR_HV_TIME_REF_COUNT           0x40000020
60 
61 #define MSR_HV_REFERENCE_TSC            0x40000021
62 #define MSR_HV_REFTSC_ENABLE            0x0001ULL
63 #define MSR_HV_REFTSC_RSVD_MASK                   0x0ffeULL
64 #define MSR_HV_REFTSC_PGSHIFT           12
65 
66 #define MSR_HV_SCONTROL                           0x40000080
67 #define MSR_HV_SCTRL_ENABLE             0x0001ULL
68 #define MSR_HV_SCTRL_RSVD_MASK                    0xfffffffffffffffeULL
69 
70 #define MSR_HV_SIEFP                              0x40000082
71 #define MSR_HV_SIEFP_ENABLE             0x0001ULL
72 #define MSR_HV_SIEFP_RSVD_MASK                    0x0ffeULL
73 #define MSR_HV_SIEFP_PGSHIFT            12
74 
75 #define MSR_HV_SIMP                     0x40000083
76 #define MSR_HV_SIMP_ENABLE              0x0001ULL
77 #define MSR_HV_SIMP_RSVD_MASK           0x0ffeULL
78 #define MSR_HV_SIMP_PGSHIFT             12
79 
80 #define MSR_HV_EOM                      0x40000084
81 
82 #define MSR_HV_SINT0                              0x40000090
83 #define MSR_HV_SINT_VECTOR_MASK                   0x00ffULL
84 #define MSR_HV_SINT_RSVD1_MASK                    0xff00ULL
85 #define MSR_HV_SINT_MASKED              0x00010000ULL
86 #define MSR_HV_SINT_AUTOEOI             0x00020000ULL
87 #define MSR_HV_SINT_RSVD2_MASK                    0xfffffffffffc0000ULL
88 #define MSR_HV_SINT_RSVD_MASK           (MSR_HV_SINT_RSVD1_MASK |     \
89                                                    MSR_HV_SINT_RSVD2_MASK)
90 
91 #define MSR_HV_STIMER0_CONFIG           0x400000b0
92 #define MSR_HV_STIMER_CFG_ENABLE        0x0001ULL
93 #define MSR_HV_STIMER_CFG_PERIODIC      0x0002ULL
94 #define MSR_HV_STIMER_CFG_LAZY                    0x0004ULL
95 #define MSR_HV_STIMER_CFG_AUTOEN        0x0008ULL
96 #define MSR_HV_STIMER_CFG_SINT_MASK     0x000f0000ULL
97 #define MSR_HV_STIMER_CFG_SINT_SHIFT    16
98 
99 #define MSR_HV_STIMER0_COUNT            0x400000b1
100 
101 /*
102  * CPUID leaves
103  */
104 
105 #define CPUID_LEAF_HV_MAXLEAF           0x40000000
106 
107 #define CPUID_LEAF_HV_INTERFACE                   0x40000001
108 #define CPUID_HV_IFACE_HYPERV           0x31237648          /* HV#1 */
109 
110 #define CPUID_LEAF_HV_IDENTITY                    0x40000002
111 
112 #define CPUID_LEAF_HV_FEATURES                    0x40000003
113 /* EAX: features */
114 #define CPUID_HV_MSR_TIME_REFCNT        0x0002    /* MSR_HV_TIME_REF_COUNT */
115 #define CPUID_HV_MSR_SYNIC              0x0004    /* MSRs for SynIC */
116 #define CPUID_HV_MSR_SYNTIMER           0x0008    /* MSRs for SynTimer */
117 #define CPUID_HV_MSR_APIC               0x0010    /* MSR_HV_{EOI,ICR,TPR} */
118 #define CPUID_HV_MSR_HYPERCALL                    0x0020    /* MSR_HV_GUEST_OS_ID
119                                                              * MSR_HV_HYPERCALL */
120 #define CPUID_HV_MSR_VP_INDEX           0x0040    /* MSR_HV_VP_INDEX */
121 #define CPUID_HV_MSR_REFERENCE_TSC      0x0200    /* MSR_HV_REFERENCE_TSC */
122 #define CPUID_HV_MSR_GUEST_IDLE                   0x0400    /* MSR_HV_GUEST_IDLE */
123 /* ECX: power management features */
124 #define CPUPM_HV_CSTATE_MASK            0x000f    /* deepest C-state */
125 #define CPUPM_HV_C3_HPET                0x0010    /* C3 requires HPET */
126 #define CPUPM_HV_CSTATE(f)              ((f) & CPUPM_HV_CSTATE_MASK)
127 /* EDX: features3 */
128 #define CPUID3_HV_MWAIT                           0x0001    /* MWAIT */
129 #define CPUID3_HV_XMM_HYPERCALL                   0x0010    /* Hypercall input through
130                                                              * XMM regs */
131 #define CPUID3_HV_GUEST_IDLE            0x0020    /* guest idle */
132 #define CPUID3_HV_NUMA                            0x0080    /* NUMA distance query */
133 #define CPUID3_HV_TIME_FREQ             0x0100    /* timer frequency query
134                                                              * (TSC, LAPIC) */
135 #define CPUID3_HV_MSR_CRASH             0x0400    /* MSRs for guest crash */
136 
137 #define CPUID_LEAF_HV_RECOMMENDS        0x40000004
138 #define CPUID_LEAF_HV_LIMITS            0x40000005
139 #define CPUID_LEAF_HV_HWFEATURES        0x40000006
140 
141 /*
142  * Hyper-V Reference TSC
143  */
144 struct hyperv_reftsc {
145           volatile uint32_t             tsc_seq;
146           volatile uint32_t             tsc_rsvd1;
147           volatile uint64_t             tsc_scale;
148           volatile int64_t              tsc_ofs;
149 } __packed __aligned(PAGE_SIZE);
150 CTASSERT(sizeof(struct hyperv_reftsc) == PAGE_SIZE);
151 
152 /*
153  * Hyper-V message types
154  */
155 #define HYPERV_MSGTYPE_NONE             0
156 #define HYPERV_MSGTYPE_CHANNEL                    1
157 #define HYPERV_MSGTYPE_TIMER_EXPIRED    0x80000010
158 
159 /*
160  * Hypercall status codes
161  */
162 #define HYPERCALL_STATUS_SUCCESS        0x0000
163 
164 /*
165  * Hypercall input values
166  */
167 #define HYPERCALL_POST_MESSAGE                    0x005c
168 
169 /*
170  * Hypercall input parameters
171  */
172 
173 /*
174  * HYPERCALL_POST_MESSAGE
175  */
176 #define HYPERCALL_POSTMSGIN_DSIZE_MAX   240
177 #define HYPERCALL_POSTMSGIN_SIZE        256
178 #define HYPERCALL_POSTMSGIN_ALIGN       8
179 
180 struct hypercall_postmsg_in {
181           uint32_t  hc_connid;
182           uint32_t  hc_rsvd;
183           uint32_t  hc_msgtype;         /* HYPERV_MSGTYPE_ */
184           uint32_t  hc_dsize;
185           uint8_t             hc_data[HYPERCALL_POSTMSGIN_DSIZE_MAX];
186 } __packed;
187 CTASSERT(sizeof(struct hypercall_postmsg_in) == HYPERCALL_POSTMSGIN_SIZE);
188 
189 #endif    /* !_HYPERV_REG_H_ */
190