2 * Dynamic device configuration and creation.
4 * Copyright (c) 2009 CodeSourcery
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
20 /* The theory here is that it should be possible to create a machine without
21 knowledge of specific devices. Historically board init routines have
22 passed a bunch of arguments to each device, requiring the board know
23 exactly which device it is dealing with. This file provides an abstract
24 API for device configuration and initialization. Devices will generally
25 inherit from a particular bus (e.g. PCI or I2C) rather than
29 #include "sysemu/sysemu.h"
30 #include "qapi/error.h"
31 #include "qapi/qmp/qerror.h"
32 #include "qapi/visitor.h"
33 #include "qapi/qmp/qjson.h"
34 #include "monitor/monitor.h"
37 static bool qdev_hot_added
= false;
38 static bool qdev_hot_removed
= false;
40 const VMStateDescription
*qdev_get_vmsd(DeviceState
*dev
)
42 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
46 const char *qdev_fw_name(DeviceState
*dev
)
48 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
54 return object_get_typename(OBJECT(dev
));
57 static void qdev_property_add_legacy(DeviceState
*dev
, Property
*prop
,
60 static void bus_remove_child(BusState
*bus
, DeviceState
*child
)
64 QTAILQ_FOREACH(kid
, &bus
->children
, sibling
) {
65 if (kid
->child
== child
) {
68 snprintf(name
, sizeof(name
), "child[%d]", kid
->index
);
69 QTAILQ_REMOVE(&bus
->children
, kid
, sibling
);
71 /* This gives back ownership of kid->child back to us. */
72 object_property_del(OBJECT(bus
), name
, NULL
);
73 object_unref(OBJECT(kid
->child
));
80 static void bus_add_child(BusState
*bus
, DeviceState
*child
)
83 BusChild
*kid
= g_malloc0(sizeof(*kid
));
86 assert(bus
->allow_hotplug
);
89 kid
->index
= bus
->max_index
++;
91 object_ref(OBJECT(kid
->child
));
93 QTAILQ_INSERT_HEAD(&bus
->children
, kid
, sibling
);
95 /* This transfers ownership of kid->child to the property. */
96 snprintf(name
, sizeof(name
), "child[%d]", kid
->index
);
97 object_property_add_link(OBJECT(bus
), name
,
98 object_get_typename(OBJECT(child
)),
99 (Object
**)&kid
->child
,
103 void qdev_set_parent_bus(DeviceState
*dev
, BusState
*bus
)
105 dev
->parent_bus
= bus
;
106 object_ref(OBJECT(bus
));
107 bus_add_child(bus
, dev
);
110 /* Create a new device. This only initializes the device state structure
111 and allows properties to be set. qdev_init should be called to
112 initialize the actual device emulation. */
113 DeviceState
*qdev_create(BusState
*bus
, const char *name
)
117 dev
= qdev_try_create(bus
, name
);
120 error_report("Unknown device '%s' for bus '%s'", name
,
121 object_get_typename(OBJECT(bus
)));
123 error_report("Unknown device '%s' for default sysbus", name
);
131 DeviceState
*qdev_try_create(BusState
*bus
, const char *type
)
135 if (object_class_by_name(type
) == NULL
) {
138 dev
= DEVICE(object_new(type
));
144 bus
= sysbus_get_default();
147 qdev_set_parent_bus(dev
, bus
);
148 object_unref(OBJECT(dev
));
152 /* Initialize a device. Device properties should be set before calling
153 this function. IRQs and MMIO regions should be connected/mapped after
154 calling this function.
155 On failure, destroy the device and return negative value.
156 Return 0 on success. */
157 int qdev_init(DeviceState
*dev
)
159 Error
*local_err
= NULL
;
161 assert(!dev
->realized
);
163 object_property_set_bool(OBJECT(dev
), true, "realized", &local_err
);
164 if (local_err
!= NULL
) {
165 qerror_report_err(local_err
);
166 error_free(local_err
);
173 static void device_realize(DeviceState
*dev
, Error
**err
)
175 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
178 int rc
= dc
->init(dev
);
180 error_setg(err
, "Device initialization failed.");
186 static void device_unrealize(DeviceState
*dev
, Error
**errp
)
188 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
191 int rc
= dc
->exit(dev
);
193 error_setg(errp
, "Device exit failed.");
199 void qdev_set_legacy_instance_id(DeviceState
*dev
, int alias_id
,
200 int required_for_version
)
202 assert(!dev
->realized
);
203 dev
->instance_id_alias
= alias_id
;
204 dev
->alias_required_for_version
= required_for_version
;
207 void qdev_unplug(DeviceState
*dev
, Error
**errp
)
209 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
211 if (dev
->parent_bus
&& !dev
->parent_bus
->allow_hotplug
) {
212 error_set(errp
, QERR_BUS_NO_HOTPLUG
, dev
->parent_bus
->name
);
215 assert(dc
->unplug
!= NULL
);
217 qdev_hot_removed
= true;
219 if (dc
->unplug(dev
) < 0) {
220 error_set(errp
, QERR_UNDEFINED_ERROR
);
225 static int qdev_reset_one(DeviceState
*dev
, void *opaque
)
232 static int qbus_reset_one(BusState
*bus
, void *opaque
)
234 BusClass
*bc
= BUS_GET_CLASS(bus
);
236 return bc
->reset(bus
);
241 void qdev_reset_all(DeviceState
*dev
)
243 qdev_walk_children(dev
, qdev_reset_one
, qbus_reset_one
, NULL
);
246 void qbus_reset_all(BusState
*bus
)
248 qbus_walk_children(bus
, qdev_reset_one
, qbus_reset_one
, NULL
);
251 void qbus_reset_all_fn(void *opaque
)
253 BusState
*bus
= opaque
;
257 /* can be used as ->unplug() callback for the simple cases */
258 int qdev_simple_unplug_cb(DeviceState
*dev
)
266 /* Like qdev_init(), but terminate program via error_report() instead of
267 returning an error value. This is okay during machine creation.
268 Don't use for hotplug, because there callers need to recover from
269 failure. Exception: if you know the device's init() callback can't
270 fail, then qdev_init_nofail() can't fail either, and is therefore
271 usable even then. But relying on the device implementation that
272 way is somewhat unclean, and best avoided. */
273 void qdev_init_nofail(DeviceState
*dev
)
275 const char *typename
= object_get_typename(OBJECT(dev
));
277 if (qdev_init(dev
) < 0) {
278 error_report("Initialization of device %s failed", typename
);
283 /* Unlink device from bus and free the structure. */
284 void qdev_free(DeviceState
*dev
)
286 object_unparent(OBJECT(dev
));
289 void qdev_machine_creation_done(void)
292 * ok, initial machine setup is done, starting from now we can
293 * only create hotpluggable devices
298 bool qdev_machine_modified(void)
300 return qdev_hot_added
|| qdev_hot_removed
;
303 BusState
*qdev_get_parent_bus(DeviceState
*dev
)
305 return dev
->parent_bus
;
308 void qdev_init_gpio_in(DeviceState
*dev
, qemu_irq_handler handler
, int n
)
310 dev
->gpio_in
= qemu_extend_irqs(dev
->gpio_in
, dev
->num_gpio_in
, handler
,
312 dev
->num_gpio_in
+= n
;
315 void qdev_init_gpio_out(DeviceState
*dev
, qemu_irq
*pins
, int n
)
317 assert(dev
->num_gpio_out
== 0);
318 dev
->num_gpio_out
= n
;
319 dev
->gpio_out
= pins
;
322 qemu_irq
qdev_get_gpio_in(DeviceState
*dev
, int n
)
324 assert(n
>= 0 && n
< dev
->num_gpio_in
);
325 return dev
->gpio_in
[n
];
328 void qdev_connect_gpio_out(DeviceState
* dev
, int n
, qemu_irq pin
)
330 assert(n
>= 0 && n
< dev
->num_gpio_out
);
331 dev
->gpio_out
[n
] = pin
;
334 BusState
*qdev_get_child_bus(DeviceState
*dev
, const char *name
)
338 QLIST_FOREACH(bus
, &dev
->child_bus
, sibling
) {
339 if (strcmp(name
, bus
->name
) == 0) {
346 int qbus_walk_children(BusState
*bus
, qdev_walkerfn
*devfn
,
347 qbus_walkerfn
*busfn
, void *opaque
)
353 err
= busfn(bus
, opaque
);
359 QTAILQ_FOREACH(kid
, &bus
->children
, sibling
) {
360 err
= qdev_walk_children(kid
->child
, devfn
, busfn
, opaque
);
369 int qdev_walk_children(DeviceState
*dev
, qdev_walkerfn
*devfn
,
370 qbus_walkerfn
*busfn
, void *opaque
)
376 err
= devfn(dev
, opaque
);
382 QLIST_FOREACH(bus
, &dev
->child_bus
, sibling
) {
383 err
= qbus_walk_children(bus
, devfn
, busfn
, opaque
);
392 DeviceState
*qdev_find_recursive(BusState
*bus
, const char *id
)
398 QTAILQ_FOREACH(kid
, &bus
->children
, sibling
) {
399 DeviceState
*dev
= kid
->child
;
401 if (dev
->id
&& strcmp(dev
->id
, id
) == 0) {
405 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
406 ret
= qdev_find_recursive(child
, id
);
415 static void qbus_realize(BusState
*bus
, DeviceState
*parent
, const char *name
)
417 const char *typename
= object_get_typename(OBJECT(bus
));
421 bus
->parent
= parent
;
424 bus
->name
= g_strdup(name
);
425 } else if (bus
->parent
&& bus
->parent
->id
) {
426 /* parent device has id -> use it for bus name */
427 len
= strlen(bus
->parent
->id
) + 16;
429 snprintf(buf
, len
, "%s.%d", bus
->parent
->id
, bus
->parent
->num_child_bus
);
432 /* no id -> use lowercase bus type for bus name */
433 len
= strlen(typename
) + 16;
435 len
= snprintf(buf
, len
, "%s.%d", typename
,
436 bus
->parent
? bus
->parent
->num_child_bus
: 0);
437 for (i
= 0; i
< len
; i
++)
438 buf
[i
] = qemu_tolower(buf
[i
]);
443 QLIST_INSERT_HEAD(&bus
->parent
->child_bus
, bus
, sibling
);
444 bus
->parent
->num_child_bus
++;
445 object_property_add_child(OBJECT(bus
->parent
), bus
->name
, OBJECT(bus
), NULL
);
446 object_unref(OBJECT(bus
));
447 } else if (bus
!= sysbus_get_default()) {
448 /* TODO: once all bus devices are qdevified,
449 only reset handler for main_system_bus should be registered here. */
450 qemu_register_reset(qbus_reset_all_fn
, bus
);
454 static void bus_unparent(Object
*obj
)
456 BusState
*bus
= BUS(obj
);
459 while ((kid
= QTAILQ_FIRST(&bus
->children
)) != NULL
) {
460 DeviceState
*dev
= kid
->child
;
464 QLIST_REMOVE(bus
, sibling
);
465 bus
->parent
->num_child_bus
--;
468 assert(bus
!= sysbus_get_default()); /* main_system_bus is never freed */
469 qemu_unregister_reset(qbus_reset_all_fn
, bus
);
473 void qbus_create_inplace(void *bus
, size_t size
, const char *typename
,
474 DeviceState
*parent
, const char *name
)
476 object_initialize(bus
, size
, typename
);
477 qbus_realize(bus
, parent
, name
);
480 BusState
*qbus_create(const char *typename
, DeviceState
*parent
, const char *name
)
484 bus
= BUS(object_new(typename
));
485 qbus_realize(bus
, parent
, name
);
490 void qbus_free(BusState
*bus
)
492 object_unparent(OBJECT(bus
));
495 static char *bus_get_fw_dev_path(BusState
*bus
, DeviceState
*dev
)
497 BusClass
*bc
= BUS_GET_CLASS(bus
);
499 if (bc
->get_fw_dev_path
) {
500 return bc
->get_fw_dev_path(dev
);
506 static int qdev_get_fw_dev_path_helper(DeviceState
*dev
, char *p
, int size
)
510 if (dev
&& dev
->parent_bus
) {
512 l
= qdev_get_fw_dev_path_helper(dev
->parent_bus
->parent
, p
, size
);
513 d
= bus_get_fw_dev_path(dev
->parent_bus
, dev
);
515 l
+= snprintf(p
+ l
, size
- l
, "%s", d
);
521 l
+= snprintf(p
+ l
, size
- l
, "/");
526 char* qdev_get_fw_dev_path(DeviceState
*dev
)
531 l
= qdev_get_fw_dev_path_helper(dev
, path
, 128);
535 return g_strdup(path
);
538 char *qdev_get_dev_path(DeviceState
*dev
)
542 if (!dev
|| !dev
->parent_bus
) {
546 bc
= BUS_GET_CLASS(dev
->parent_bus
);
547 if (bc
->get_dev_path
) {
548 return bc
->get_dev_path(dev
);
555 * Legacy property handling
558 static void qdev_get_legacy_property(Object
*obj
, Visitor
*v
, void *opaque
,
559 const char *name
, Error
**errp
)
561 DeviceState
*dev
= DEVICE(obj
);
562 Property
*prop
= opaque
;
567 prop
->info
->print(dev
, prop
, buffer
, sizeof(buffer
));
568 visit_type_str(v
, &ptr
, name
, errp
);
571 static void qdev_set_legacy_property(Object
*obj
, Visitor
*v
, void *opaque
,
572 const char *name
, Error
**errp
)
574 DeviceState
*dev
= DEVICE(obj
);
575 Property
*prop
= opaque
;
576 Error
*local_err
= NULL
;
581 qdev_prop_set_after_realize(dev
, name
, errp
);
585 visit_type_str(v
, &ptr
, name
, &local_err
);
587 error_propagate(errp
, local_err
);
591 ret
= prop
->info
->parse(dev
, prop
, ptr
);
592 error_set_from_qdev_prop_error(errp
, ret
, dev
, prop
, ptr
);
597 * @qdev_add_legacy_property - adds a legacy property
599 * Do not use this is new code! Properties added through this interface will
600 * be given names and types in the "legacy" namespace.
602 * Legacy properties are string versions of other OOM properties. The format
603 * of the string depends on the property type.
605 void qdev_property_add_legacy(DeviceState
*dev
, Property
*prop
,
610 /* Register pointer properties as legacy properties */
611 if (!prop
->info
->print
&& !prop
->info
->parse
&&
612 (prop
->info
->set
|| prop
->info
->get
)) {
616 name
= g_strdup_printf("legacy-%s", prop
->name
);
617 type
= g_strdup_printf("legacy<%s>",
618 prop
->info
->legacy_name
?: prop
->info
->name
);
620 object_property_add(OBJECT(dev
), name
, type
,
621 prop
->info
->print
? qdev_get_legacy_property
: prop
->info
->get
,
622 prop
->info
->parse
? qdev_set_legacy_property
: prop
->info
->set
,
631 * @qdev_property_add_static - add a @Property to a device.
633 * Static properties access data in a struct. The actual type of the
634 * property and the field depends on the property type.
636 void qdev_property_add_static(DeviceState
*dev
, Property
*prop
,
639 Error
*local_err
= NULL
;
640 Object
*obj
= OBJECT(dev
);
643 * TODO qdev_prop_ptr does not have getters or setters. It must
644 * go now that it can be replaced with links. The test should be
645 * removed along with it: all static properties are read/write.
647 if (!prop
->info
->get
&& !prop
->info
->set
) {
651 object_property_add(obj
, prop
->name
, prop
->info
->name
,
652 prop
->info
->get
, prop
->info
->set
,
657 error_propagate(errp
, local_err
);
660 if (prop
->qtype
== QTYPE_NONE
) {
664 if (prop
->qtype
== QTYPE_QBOOL
) {
665 object_property_set_bool(obj
, prop
->defval
, prop
->name
, &local_err
);
666 } else if (prop
->info
->enum_table
) {
667 object_property_set_str(obj
, prop
->info
->enum_table
[prop
->defval
],
668 prop
->name
, &local_err
);
669 } else if (prop
->qtype
== QTYPE_QINT
) {
670 object_property_set_int(obj
, prop
->defval
, prop
->name
, &local_err
);
672 assert_no_error(local_err
);
675 static bool device_get_realized(Object
*obj
, Error
**err
)
677 DeviceState
*dev
= DEVICE(obj
);
678 return dev
->realized
;
681 static void device_set_realized(Object
*obj
, bool value
, Error
**err
)
683 DeviceState
*dev
= DEVICE(obj
);
684 DeviceClass
*dc
= DEVICE_GET_CLASS(dev
);
685 Error
*local_err
= NULL
;
687 if (value
&& !dev
->realized
) {
688 if (!obj
->parent
&& local_err
== NULL
) {
689 static int unattached_count
;
690 gchar
*name
= g_strdup_printf("device[%d]", unattached_count
++);
692 object_property_add_child(container_get(qdev_get_machine(),
694 name
, obj
, &local_err
);
699 dc
->realize(dev
, &local_err
);
702 if (qdev_get_vmsd(dev
) && local_err
== NULL
) {
703 vmstate_register_with_alias_id(dev
, -1, qdev_get_vmsd(dev
), dev
,
704 dev
->instance_id_alias
,
705 dev
->alias_required_for_version
);
707 if (dev
->hotplugged
&& local_err
== NULL
) {
710 } else if (!value
&& dev
->realized
) {
711 if (qdev_get_vmsd(dev
)) {
712 vmstate_unregister(dev
, qdev_get_vmsd(dev
), dev
);
715 dc
->unrealize(dev
, &local_err
);
719 if (local_err
!= NULL
) {
720 error_propagate(err
, local_err
);
724 dev
->realized
= value
;
727 static void device_initfn(Object
*obj
)
729 DeviceState
*dev
= DEVICE(obj
);
736 qdev_hot_added
= true;
739 dev
->instance_id_alias
= -1;
740 dev
->realized
= false;
742 object_property_add_bool(obj
, "realized",
743 device_get_realized
, device_set_realized
, NULL
);
745 class = object_get_class(OBJECT(dev
));
747 for (prop
= DEVICE_CLASS(class)->props
; prop
&& prop
->name
; prop
++) {
748 qdev_property_add_legacy(dev
, prop
, &err
);
749 assert_no_error(err
);
750 qdev_property_add_static(dev
, prop
, &err
);
751 assert_no_error(err
);
753 class = object_class_get_parent(class);
754 } while (class != object_class_by_name(TYPE_DEVICE
));
756 qerror_report_err(err
);
761 object_property_add_link(OBJECT(dev
), "parent_bus", TYPE_BUS
,
762 (Object
**)&dev
->parent_bus
, &err
);
763 assert_no_error(err
);
766 static void device_post_init(Object
*obj
)
768 DeviceState
*dev
= DEVICE(obj
);
771 qdev_prop_set_globals(dev
, &err
);
772 assert_no_error(err
);
775 /* Unlink device from bus and free the structure. */
776 static void device_finalize(Object
*obj
)
778 DeviceState
*dev
= DEVICE(obj
);
780 qemu_opts_del(dev
->opts
);
784 static void device_class_base_init(ObjectClass
*class, void *data
)
786 DeviceClass
*klass
= DEVICE_CLASS(class);
788 /* We explicitly look up properties in the superclasses,
789 * so do not propagate them to the subclasses.
794 static void device_unparent(Object
*obj
)
796 DeviceState
*dev
= DEVICE(obj
);
799 bool have_realized
= dev
->realized
;
801 while (dev
->num_child_bus
) {
802 bus
= QLIST_FIRST(&dev
->child_bus
);
806 object_property_set_bool(obj
, false, "realized", NULL
);
808 if (dev
->parent_bus
) {
809 bus_remove_child(dev
->parent_bus
, dev
);
810 object_unref(OBJECT(dev
->parent_bus
));
811 dev
->parent_bus
= NULL
;
814 /* Only send event if the device had been completely realized */
816 gchar
*path
= object_get_canonical_path(OBJECT(dev
));
819 event_data
= qobject_from_jsonf("{ 'device': %s, 'path': %s }",
822 event_data
= qobject_from_jsonf("{ 'path': %s }", path
);
824 monitor_protocol_event(QEVENT_DEVICE_DELETED
, event_data
);
825 qobject_decref(event_data
);
830 static void device_class_init(ObjectClass
*class, void *data
)
832 DeviceClass
*dc
= DEVICE_CLASS(class);
834 class->unparent
= device_unparent
;
835 dc
->realize
= device_realize
;
836 dc
->unrealize
= device_unrealize
;
839 void device_reset(DeviceState
*dev
)
841 DeviceClass
*klass
= DEVICE_GET_CLASS(dev
);
848 Object
*qdev_get_machine(void)
853 dev
= container_get(object_get_root(), "/machine");
859 static const TypeInfo device_type_info
= {
861 .parent
= TYPE_OBJECT
,
862 .instance_size
= sizeof(DeviceState
),
863 .instance_init
= device_initfn
,
864 .instance_post_init
= device_post_init
,
865 .instance_finalize
= device_finalize
,
866 .class_base_init
= device_class_base_init
,
867 .class_init
= device_class_init
,
869 .class_size
= sizeof(DeviceClass
),
872 static void qbus_initfn(Object
*obj
)
874 BusState
*bus
= BUS(obj
);
876 QTAILQ_INIT(&bus
->children
);
879 static char *default_bus_get_fw_dev_path(DeviceState
*dev
)
881 return g_strdup(object_get_typename(OBJECT(dev
)));
884 static void bus_class_init(ObjectClass
*class, void *data
)
886 BusClass
*bc
= BUS_CLASS(class);
888 class->unparent
= bus_unparent
;
889 bc
->get_fw_dev_path
= default_bus_get_fw_dev_path
;
892 static void qbus_finalize(Object
*obj
)
894 BusState
*bus
= BUS(obj
);
896 g_free((char *)bus
->name
);
899 static const TypeInfo bus_info
= {
901 .parent
= TYPE_OBJECT
,
902 .instance_size
= sizeof(BusState
),
904 .class_size
= sizeof(BusClass
),
905 .instance_init
= qbus_initfn
,
906 .instance_finalize
= qbus_finalize
,
907 .class_init
= bus_class_init
,
910 static void qdev_register_types(void)
912 type_register_static(&bus_info
);
913 type_register_static(&device_type_info
);
916 type_init(qdev_register_types
)