qapi: Improve specificity of type/member descriptions
[qemu/armbru.git] / hw / intc / apic_common.c
blob4a34f03047c8ad48be26984276daff01ef67eb2c
1 /*
2 * APIC support - common bits of emulated and KVM kernel model
4 * Copyright (c) 2004-2005 Fabrice Bellard
5 * Copyright (c) 2011 Jan Kiszka, Siemens AG
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, see <http://www.gnu.org/licenses/>
21 #include "qemu/osdep.h"
22 #include "qemu/error-report.h"
23 #include "qemu/module.h"
24 #include "qapi/error.h"
25 #include "qapi/visitor.h"
26 #include "hw/i386/apic.h"
27 #include "hw/i386/apic_internal.h"
28 #include "hw/intc/kvm_irqcount.h"
29 #include "trace.h"
30 #include "hw/boards.h"
31 #include "sysemu/hax.h"
32 #include "sysemu/kvm.h"
33 #include "hw/qdev-properties.h"
34 #include "hw/sysbus.h"
35 #include "migration/vmstate.h"
37 bool apic_report_tpr_access;
39 void cpu_set_apic_base(DeviceState *dev, uint64_t val)
41 trace_cpu_set_apic_base(val);
43 if (dev) {
44 APICCommonState *s = APIC_COMMON(dev);
45 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
46 /* switching to x2APIC, reset possibly modified xAPIC ID */
47 if (!(s->apicbase & MSR_IA32_APICBASE_EXTD) &&
48 (val & MSR_IA32_APICBASE_EXTD)) {
49 s->id = s->initial_apic_id;
51 info->set_base(s, val);
55 uint64_t cpu_get_apic_base(DeviceState *dev)
57 if (dev) {
58 APICCommonState *s = APIC_COMMON(dev);
59 trace_cpu_get_apic_base((uint64_t)s->apicbase);
60 return s->apicbase;
61 } else {
62 trace_cpu_get_apic_base(MSR_IA32_APICBASE_BSP);
63 return MSR_IA32_APICBASE_BSP;
67 void cpu_set_apic_tpr(DeviceState *dev, uint8_t val)
69 APICCommonState *s;
70 APICCommonClass *info;
72 if (!dev) {
73 return;
76 s = APIC_COMMON(dev);
77 info = APIC_COMMON_GET_CLASS(s);
79 info->set_tpr(s, val);
82 uint8_t cpu_get_apic_tpr(DeviceState *dev)
84 APICCommonState *s;
85 APICCommonClass *info;
87 if (!dev) {
88 return 0;
91 s = APIC_COMMON(dev);
92 info = APIC_COMMON_GET_CLASS(s);
94 return info->get_tpr(s);
97 void apic_enable_tpr_access_reporting(DeviceState *dev, bool enable)
99 APICCommonState *s = APIC_COMMON(dev);
100 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
102 apic_report_tpr_access = enable;
103 if (info->enable_tpr_reporting) {
104 info->enable_tpr_reporting(s, enable);
108 void apic_enable_vapic(DeviceState *dev, hwaddr paddr)
110 APICCommonState *s = APIC_COMMON(dev);
111 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
113 s->vapic_paddr = paddr;
114 info->vapic_base_update(s);
117 void apic_handle_tpr_access_report(DeviceState *dev, target_ulong ip,
118 TPRAccess access)
120 APICCommonState *s = APIC_COMMON(dev);
122 vapic_report_tpr_access(s->vapic, CPU(s->cpu), ip, access);
125 void apic_deliver_nmi(DeviceState *dev)
127 APICCommonState *s = APIC_COMMON(dev);
128 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
130 info->external_nmi(s);
133 bool apic_next_timer(APICCommonState *s, int64_t current_time)
135 int64_t d;
137 /* We need to store the timer state separately to support APIC
138 * implementations that maintain a non-QEMU timer, e.g. inside the
139 * host kernel. This open-coded state allows us to migrate between
140 * both models. */
141 s->timer_expiry = -1;
143 if (s->lvt[APIC_LVT_TIMER] & APIC_LVT_MASKED) {
144 return false;
147 d = (current_time - s->initial_count_load_time) >> s->count_shift;
149 if (s->lvt[APIC_LVT_TIMER] & APIC_LVT_TIMER_PERIODIC) {
150 if (!s->initial_count) {
151 return false;
153 d = ((d / ((uint64_t)s->initial_count + 1)) + 1) *
154 ((uint64_t)s->initial_count + 1);
155 } else {
156 if (d >= s->initial_count) {
157 return false;
159 d = (uint64_t)s->initial_count + 1;
161 s->next_time = s->initial_count_load_time + (d << s->count_shift);
162 s->timer_expiry = s->next_time;
163 return true;
166 uint32_t apic_get_current_count(APICCommonState *s)
168 int64_t d;
169 uint32_t val;
170 d = (qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) - s->initial_count_load_time) >>
171 s->count_shift;
172 if (s->lvt[APIC_LVT_TIMER] & APIC_LVT_TIMER_PERIODIC) {
173 /* periodic */
174 val = s->initial_count - (d % ((uint64_t)s->initial_count + 1));
175 } else {
176 if (d >= s->initial_count) {
177 val = 0;
178 } else {
179 val = s->initial_count - d;
182 return val;
185 void apic_init_reset(DeviceState *dev)
187 APICCommonState *s;
188 APICCommonClass *info;
189 int i;
191 if (!dev) {
192 return;
194 s = APIC_COMMON(dev);
195 s->tpr = 0;
196 s->spurious_vec = 0xff;
197 s->log_dest = 0;
198 s->dest_mode = 0xf;
199 memset(s->isr, 0, sizeof(s->isr));
200 memset(s->tmr, 0, sizeof(s->tmr));
201 memset(s->irr, 0, sizeof(s->irr));
202 for (i = 0; i < APIC_LVT_NB; i++) {
203 s->lvt[i] = APIC_LVT_MASKED;
205 s->esr = 0;
206 memset(s->icr, 0, sizeof(s->icr));
207 s->divide_conf = 0;
208 s->count_shift = 0;
209 s->initial_count = 0;
210 s->initial_count_load_time = 0;
211 s->next_time = 0;
212 s->wait_for_sipi = !cpu_is_bsp(s->cpu);
214 if (s->timer) {
215 timer_del(s->timer);
217 s->timer_expiry = -1;
219 info = APIC_COMMON_GET_CLASS(s);
220 if (info->reset) {
221 info->reset(s);
225 void apic_designate_bsp(DeviceState *dev, bool bsp)
227 if (dev == NULL) {
228 return;
231 APICCommonState *s = APIC_COMMON(dev);
232 if (bsp) {
233 s->apicbase |= MSR_IA32_APICBASE_BSP;
234 } else {
235 s->apicbase &= ~MSR_IA32_APICBASE_BSP;
239 static void apic_reset_common(DeviceState *dev)
241 APICCommonState *s = APIC_COMMON(dev);
242 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
243 uint32_t bsp;
245 bsp = s->apicbase & MSR_IA32_APICBASE_BSP;
246 s->apicbase = APIC_DEFAULT_ADDRESS | bsp | MSR_IA32_APICBASE_ENABLE;
247 s->id = s->initial_apic_id;
249 kvm_reset_irq_delivered();
251 s->vapic_paddr = 0;
252 info->vapic_base_update(s);
254 apic_init_reset(dev);
257 static const VMStateDescription vmstate_apic_common;
259 static void apic_common_realize(DeviceState *dev, Error **errp)
261 APICCommonState *s = APIC_COMMON(dev);
262 APICCommonClass *info;
263 static DeviceState *vapic;
264 uint32_t instance_id = s->initial_apic_id;
266 /* Normally initial APIC ID should be no more than hundreds */
267 assert(instance_id != VMSTATE_INSTANCE_ID_ANY);
269 info = APIC_COMMON_GET_CLASS(s);
270 info->realize(dev, errp);
272 /* Note: We need at least 1M to map the VAPIC option ROM */
273 if (!vapic && s->vapic_control & VAPIC_ENABLE_MASK &&
274 !hax_enabled() && current_machine->ram_size >= 1024 * 1024) {
275 vapic = sysbus_create_simple("kvmvapic", -1, NULL);
277 s->vapic = vapic;
278 if (apic_report_tpr_access && info->enable_tpr_reporting) {
279 info->enable_tpr_reporting(s, true);
282 if (s->legacy_instance_id) {
283 instance_id = VMSTATE_INSTANCE_ID_ANY;
285 vmstate_register_with_alias_id(NULL, instance_id, &vmstate_apic_common,
286 s, -1, 0, NULL);
289 static void apic_common_unrealize(DeviceState *dev)
291 APICCommonState *s = APIC_COMMON(dev);
292 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
294 vmstate_unregister(NULL, &vmstate_apic_common, s);
295 info->unrealize(dev);
297 if (apic_report_tpr_access && info->enable_tpr_reporting) {
298 info->enable_tpr_reporting(s, false);
302 static int apic_pre_load(void *opaque)
304 APICCommonState *s = APIC_COMMON(opaque);
306 /* The default is !cpu_is_bsp(s->cpu), but the common value is 0
307 * so that's what apic_common_sipi_needed checks for. Reset to
308 * the value that is assumed when the apic_sipi subsection is
309 * absent.
311 s->wait_for_sipi = 0;
312 return 0;
315 static int apic_dispatch_pre_save(void *opaque)
317 APICCommonState *s = APIC_COMMON(opaque);
318 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
320 if (info->pre_save) {
321 info->pre_save(s);
324 return 0;
327 static int apic_dispatch_post_load(void *opaque, int version_id)
329 APICCommonState *s = APIC_COMMON(opaque);
330 APICCommonClass *info = APIC_COMMON_GET_CLASS(s);
332 if (info->post_load) {
333 info->post_load(s);
335 return 0;
338 static bool apic_common_sipi_needed(void *opaque)
340 APICCommonState *s = APIC_COMMON(opaque);
341 return s->wait_for_sipi != 0;
344 static const VMStateDescription vmstate_apic_common_sipi = {
345 .name = "apic_sipi",
346 .version_id = 1,
347 .minimum_version_id = 1,
348 .needed = apic_common_sipi_needed,
349 .fields = (VMStateField[]) {
350 VMSTATE_INT32(sipi_vector, APICCommonState),
351 VMSTATE_INT32(wait_for_sipi, APICCommonState),
352 VMSTATE_END_OF_LIST()
356 static const VMStateDescription vmstate_apic_common = {
357 .name = "apic",
358 .version_id = 3,
359 .minimum_version_id = 3,
360 .pre_load = apic_pre_load,
361 .pre_save = apic_dispatch_pre_save,
362 .post_load = apic_dispatch_post_load,
363 .fields = (VMStateField[]) {
364 VMSTATE_UINT32(apicbase, APICCommonState),
365 VMSTATE_UINT8(id, APICCommonState),
366 VMSTATE_UINT8(arb_id, APICCommonState),
367 VMSTATE_UINT8(tpr, APICCommonState),
368 VMSTATE_UINT32(spurious_vec, APICCommonState),
369 VMSTATE_UINT8(log_dest, APICCommonState),
370 VMSTATE_UINT8(dest_mode, APICCommonState),
371 VMSTATE_UINT32_ARRAY(isr, APICCommonState, 8),
372 VMSTATE_UINT32_ARRAY(tmr, APICCommonState, 8),
373 VMSTATE_UINT32_ARRAY(irr, APICCommonState, 8),
374 VMSTATE_UINT32_ARRAY(lvt, APICCommonState, APIC_LVT_NB),
375 VMSTATE_UINT32(esr, APICCommonState),
376 VMSTATE_UINT32_ARRAY(icr, APICCommonState, 2),
377 VMSTATE_UINT32(divide_conf, APICCommonState),
378 VMSTATE_INT32(count_shift, APICCommonState),
379 VMSTATE_UINT32(initial_count, APICCommonState),
380 VMSTATE_INT64(initial_count_load_time, APICCommonState),
381 VMSTATE_INT64(next_time, APICCommonState),
382 VMSTATE_INT64(timer_expiry,
383 APICCommonState), /* open-coded timer state */
384 VMSTATE_END_OF_LIST()
386 .subsections = (const VMStateDescription*[]) {
387 &vmstate_apic_common_sipi,
388 NULL
392 static Property apic_properties_common[] = {
393 DEFINE_PROP_UINT8("version", APICCommonState, version, 0x14),
394 DEFINE_PROP_BIT("vapic", APICCommonState, vapic_control, VAPIC_ENABLE_BIT,
395 true),
396 DEFINE_PROP_BOOL("legacy-instance-id", APICCommonState, legacy_instance_id,
397 false),
398 DEFINE_PROP_END_OF_LIST(),
401 static void apic_common_get_id(Object *obj, Visitor *v, const char *name,
402 void *opaque, Error **errp)
404 APICCommonState *s = APIC_COMMON(obj);
405 uint32_t value;
407 value = s->apicbase & MSR_IA32_APICBASE_EXTD ? s->initial_apic_id : s->id;
408 visit_type_uint32(v, name, &value, errp);
411 static void apic_common_set_id(Object *obj, Visitor *v, const char *name,
412 void *opaque, Error **errp)
414 APICCommonState *s = APIC_COMMON(obj);
415 DeviceState *dev = DEVICE(obj);
416 uint32_t value;
418 if (dev->realized) {
419 qdev_prop_set_after_realize(dev, name, errp);
420 return;
423 if (!visit_type_uint32(v, name, &value, errp)) {
424 return;
427 s->initial_apic_id = value;
428 s->id = (uint8_t)value;
431 static void apic_common_initfn(Object *obj)
433 APICCommonState *s = APIC_COMMON(obj);
435 s->id = s->initial_apic_id = -1;
436 object_property_add(obj, "id", "uint32",
437 apic_common_get_id,
438 apic_common_set_id, NULL, NULL);
441 static void apic_common_class_init(ObjectClass *klass, void *data)
443 DeviceClass *dc = DEVICE_CLASS(klass);
445 dc->reset = apic_reset_common;
446 device_class_set_props(dc, apic_properties_common);
447 dc->realize = apic_common_realize;
448 dc->unrealize = apic_common_unrealize;
450 * Reason: APIC and CPU need to be wired up by
451 * x86_cpu_apic_create()
453 dc->user_creatable = false;
456 static const TypeInfo apic_common_type = {
457 .name = TYPE_APIC_COMMON,
458 .parent = TYPE_DEVICE,
459 .instance_size = sizeof(APICCommonState),
460 .instance_init = apic_common_initfn,
461 .class_size = sizeof(APICCommonClass),
462 .class_init = apic_common_class_init,
463 .abstract = true,
466 static void apic_common_register_types(void)
468 type_register_static(&apic_common_type);
471 type_init(apic_common_register_types)