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
33 static int qdev_hotplug
= 0;
35 /* This is a nasty hack to allow passing a NULL bus to qdev_create. */
36 static BusState
*main_system_bus
;
38 static DeviceInfo
*device_info_list
;
40 static BusState
*qbus_find_recursive(BusState
*bus
, const char *name
,
42 static BusState
*qbus_find(const char *path
);
44 /* Register a new device type. */
45 void qdev_register(DeviceInfo
*info
)
47 assert(info
->size
>= sizeof(DeviceState
));
50 info
->next
= device_info_list
;
51 device_info_list
= info
;
54 static DeviceInfo
*qdev_find_info(BusInfo
*bus_info
, const char *name
)
58 /* first check device names */
59 for (info
= device_info_list
; info
!= NULL
; info
= info
->next
) {
60 if (bus_info
&& info
->bus_info
!= bus_info
)
62 if (strcmp(info
->name
, name
) != 0)
67 /* failing that check the aliases */
68 for (info
= device_info_list
; info
!= NULL
; info
= info
->next
) {
69 if (bus_info
&& info
->bus_info
!= bus_info
)
73 if (strcmp(info
->alias
, name
) != 0)
80 /* Create a new device. This only initializes the device state structure
81 and allows properties to be set. qdev_init should be called to
82 initialize the actual device emulation. */
83 DeviceState
*qdev_create(BusState
*bus
, const char *name
)
89 if (!main_system_bus
) {
90 main_system_bus
= qbus_create(&system_bus_info
, NULL
, "main-system-bus");
92 bus
= main_system_bus
;
95 info
= qdev_find_info(bus
->info
, name
);
97 hw_error("Unknown device '%s' for bus '%s'\n", name
, bus
->info
->name
);
100 dev
= qemu_mallocz(info
->size
);
102 dev
->parent_bus
= bus
;
103 qdev_prop_set_defaults(dev
, dev
->info
->props
);
104 qdev_prop_set_defaults(dev
, dev
->parent_bus
->info
->props
);
105 qdev_prop_set_compat(dev
);
106 QLIST_INSERT_HEAD(&bus
->children
, dev
, sibling
);
108 assert(bus
->allow_hotplug
);
111 dev
->state
= DEV_STATE_CREATED
;
115 static int qdev_print_devinfo(DeviceInfo
*info
, char *dest
, int len
)
120 ret
= snprintf(dest
+pos
, len
-pos
, "name \"%s\", bus %s",
121 info
->name
, info
->bus_info
->name
);
122 pos
+= MIN(len
-pos
,ret
);
124 ret
= snprintf(dest
+pos
, len
-pos
, ", alias \"%s\"", info
->alias
);
125 pos
+= MIN(len
-pos
,ret
);
128 ret
= snprintf(dest
+pos
, len
-pos
, ", desc \"%s\"", info
->desc
);
129 pos
+= MIN(len
-pos
,ret
);
132 ret
= snprintf(dest
+pos
, len
-pos
, ", no-user");
133 pos
+= MIN(len
-pos
,ret
);
138 static int set_property(const char *name
, const char *value
, void *opaque
)
140 DeviceState
*dev
= opaque
;
142 if (strcmp(name
, "driver") == 0)
144 if (strcmp(name
, "bus") == 0)
147 if (qdev_prop_parse(dev
, name
, value
) == -1) {
148 qemu_error("can't set property \"%s\" to \"%s\" for \"%s\"\n",
149 name
, value
, dev
->info
->name
);
155 DeviceState
*qdev_device_add(QemuOpts
*opts
)
157 const char *driver
, *path
, *id
;
162 driver
= qemu_opt_get(opts
, "driver");
164 qemu_error("-device: no driver specified\n");
167 if (strcmp(driver
, "?") == 0) {
169 for (info
= device_info_list
; info
!= NULL
; info
= info
->next
) {
170 qdev_print_devinfo(info
, msg
, sizeof(msg
));
171 qemu_error("%s\n", msg
);
177 info
= qdev_find_info(NULL
, driver
);
179 qemu_error("Device \"%s\" not found. Try -device '?' for a list.\n",
184 qemu_error("device \"%s\" can't be added via command line\n",
190 path
= qemu_opt_get(opts
, "bus");
192 bus
= qbus_find(path
);
194 bus
= qbus_find_recursive(main_system_bus
, NULL
, info
->bus_info
);
197 qemu_error("Did not find %s bus for %s\n",
198 path
? path
: info
->bus_info
->name
, info
->name
);
201 if (qdev_hotplug
&& !bus
->allow_hotplug
) {
202 qemu_error("Bus %s does not support hotplugging\n",
207 /* create device, set properties */
208 qdev
= qdev_create(bus
, driver
);
209 id
= qemu_opts_id(opts
);
213 if (qemu_opt_foreach(opts
, set_property
, qdev
, 1) != 0) {
217 if (qdev_init(qdev
) < 0) {
218 qemu_error("Error initializing device %s\n", driver
);
225 static void qdev_reset(void *opaque
)
227 DeviceState
*dev
= opaque
;
228 if (dev
->info
->reset
)
229 dev
->info
->reset(dev
);
232 /* Initialize a device. Device properties should be set before calling
233 this function. IRQs and MMIO regions should be connected/mapped after
234 calling this function.
235 On failure, destroy the device and return negative value.
236 Return 0 on success. */
237 int qdev_init(DeviceState
*dev
)
241 assert(dev
->state
== DEV_STATE_CREATED
);
242 rc
= dev
->info
->init(dev
, dev
->info
);
247 qemu_register_reset(qdev_reset
, dev
);
249 vmstate_register(-1, dev
->info
->vmsd
, dev
);
250 dev
->state
= DEV_STATE_INITIALIZED
;
254 int qdev_unplug(DeviceState
*dev
)
256 if (!dev
->parent_bus
->allow_hotplug
) {
257 qemu_error("Bus %s does not support hotplugging\n",
258 dev
->parent_bus
->name
);
261 return dev
->info
->unplug(dev
);
264 /* can be used as ->unplug() callback for the simple cases */
265 int qdev_simple_unplug_cb(DeviceState
*dev
)
272 /* Like qdev_init(), but terminate program via hw_error() instead of
273 returning an error value. This is okay during machine creation.
274 Don't use for hotplug, because there callers need to recover from
275 failure. Exception: if you know the device's init() callback can't
276 fail, then qdev_init_nofail() can't fail either, and is therefore
277 usable even then. But relying on the device implementation that
278 way is somewhat unclean, and best avoided. */
279 void qdev_init_nofail(DeviceState
*dev
)
281 DeviceInfo
*info
= dev
->info
;
283 if (qdev_init(dev
) < 0)
284 hw_error("Initialization of device %s failed\n", info
->name
);
287 /* Unlink device from bus and free the structure. */
288 void qdev_free(DeviceState
*dev
)
292 if (dev
->state
== DEV_STATE_INITIALIZED
) {
293 while (dev
->num_child_bus
) {
294 bus
= QLIST_FIRST(&dev
->child_bus
);
297 #if 0 /* FIXME: need sane vmstate_unregister function */
299 vmstate_unregister(dev
->info
->vmsd
, dev
);
302 dev
->info
->exit(dev
);
304 qemu_opts_del(dev
->opts
);
306 qemu_unregister_reset(qdev_reset
, dev
);
307 QLIST_REMOVE(dev
, sibling
);
311 void qdev_machine_creation_done(void)
314 * ok, initial machine setup is done, starting from now we can
315 * only create hotpluggable devices
320 /* Get a character (serial) device interface. */
321 CharDriverState
*qdev_init_chardev(DeviceState
*dev
)
323 static int next_serial
;
324 static int next_virtconsole
;
325 /* FIXME: This is a nasty hack that needs to go away. */
326 if (strncmp(dev
->info
->name
, "virtio", 6) == 0) {
327 return virtcon_hds
[next_virtconsole
++];
329 return serial_hds
[next_serial
++];
333 BusState
*qdev_get_parent_bus(DeviceState
*dev
)
335 return dev
->parent_bus
;
338 void qdev_init_gpio_in(DeviceState
*dev
, qemu_irq_handler handler
, int n
)
340 assert(dev
->num_gpio_in
== 0);
341 dev
->num_gpio_in
= n
;
342 dev
->gpio_in
= qemu_allocate_irqs(handler
, dev
, n
);
345 void qdev_init_gpio_out(DeviceState
*dev
, qemu_irq
*pins
, int n
)
347 assert(dev
->num_gpio_out
== 0);
348 dev
->num_gpio_out
= n
;
349 dev
->gpio_out
= pins
;
352 qemu_irq
qdev_get_gpio_in(DeviceState
*dev
, int n
)
354 assert(n
>= 0 && n
< dev
->num_gpio_in
);
355 return dev
->gpio_in
[n
];
358 void qdev_connect_gpio_out(DeviceState
* dev
, int n
, qemu_irq pin
)
360 assert(n
>= 0 && n
< dev
->num_gpio_out
);
361 dev
->gpio_out
[n
] = pin
;
364 VLANClientState
*qdev_get_vlan_client(DeviceState
*dev
,
365 NetCanReceive
*can_receive
,
367 NetReceiveIOV
*receive_iov
,
371 NICInfo
*nd
= dev
->nd
;
373 nd
->vc
= qemu_new_vlan_client(nd
->vlan
, nd
->netdev
,
375 can_receive
, receive
, receive_iov
,
381 void qdev_get_macaddr(DeviceState
*dev
, uint8_t *macaddr
)
383 memcpy(macaddr
, dev
->nd
->macaddr
, 6);
386 static int next_block_unit
[IF_COUNT
];
388 /* Get a block device. This should only be used for single-drive devices
389 (e.g. SD/Floppy/MTD). Multi-disk devices (scsi/ide) should use the
391 BlockDriverState
*qdev_init_bdrv(DeviceState
*dev
, BlockInterfaceType type
)
393 int unit
= next_block_unit
[type
]++;
396 dinfo
= drive_get(type
, 0, unit
);
397 return dinfo
? dinfo
->bdrv
: NULL
;
400 BusState
*qdev_get_child_bus(DeviceState
*dev
, const char *name
)
404 QLIST_FOREACH(bus
, &dev
->child_bus
, sibling
) {
405 if (strcmp(name
, bus
->name
) == 0) {
412 static BusState
*qbus_find_recursive(BusState
*bus
, const char *name
,
416 BusState
*child
, *ret
;
419 if (name
&& (strcmp(bus
->name
, name
) != 0)) {
422 if (info
&& (bus
->info
!= info
)) {
429 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
430 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
431 ret
= qbus_find_recursive(child
, name
, info
);
440 static DeviceState
*qdev_find_recursive(BusState
*bus
, const char *id
)
442 DeviceState
*dev
, *ret
;
445 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
446 if (dev
->id
&& strcmp(dev
->id
, id
) == 0)
448 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
449 ret
= qdev_find_recursive(child
, id
);
458 static void qbus_list_bus(DeviceState
*dev
, char *dest
, int len
)
461 const char *sep
= " ";
464 pos
+= snprintf(dest
+pos
, len
-pos
,"child busses at \"%s\":",
465 dev
->id
? dev
->id
: dev
->info
->name
);
466 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
467 pos
+= snprintf(dest
+pos
, len
-pos
, "%s\"%s\"", sep
, child
->name
);
472 static void qbus_list_dev(BusState
*bus
, char *dest
, int len
)
475 const char *sep
= " ";
478 pos
+= snprintf(dest
+pos
, len
-pos
, "devices at \"%s\":",
480 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
481 pos
+= snprintf(dest
+pos
, len
-pos
, "%s\"%s\"",
482 sep
, dev
->info
->name
);
484 pos
+= snprintf(dest
+pos
, len
-pos
, "/\"%s\"", dev
->id
);
489 static BusState
*qbus_find_bus(DeviceState
*dev
, char *elem
)
493 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
494 if (strcmp(child
->name
, elem
) == 0) {
501 static DeviceState
*qbus_find_dev(BusState
*bus
, char *elem
)
506 * try to match in order:
507 * (1) instance id, if present
509 * (3) driver alias, if present
511 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
512 if (dev
->id
&& strcmp(dev
->id
, elem
) == 0) {
516 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
517 if (strcmp(dev
->info
->name
, elem
) == 0) {
521 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
522 if (dev
->info
->alias
&& strcmp(dev
->info
->alias
, elem
) == 0) {
529 static BusState
*qbus_find(const char *path
)
533 char elem
[128], msg
[256];
536 /* find start element */
537 if (path
[0] == '/') {
538 bus
= main_system_bus
;
541 if (sscanf(path
, "%127[^/]%n", elem
, &len
) != 1) {
542 qemu_error("path parse error (\"%s\")\n", path
);
545 bus
= qbus_find_recursive(main_system_bus
, elem
, NULL
);
547 qemu_error("bus \"%s\" not found\n", elem
);
554 if (path
[pos
] == '\0') {
560 if (sscanf(path
+pos
, "/%127[^/]%n", elem
, &len
) != 1) {
561 qemu_error("path parse error (\"%s\" pos %d)\n", path
, pos
);
565 dev
= qbus_find_dev(bus
, elem
);
567 qbus_list_dev(bus
, msg
, sizeof(msg
));
568 qemu_error("device \"%s\" not found\n%s\n", elem
, msg
);
571 if (path
[pos
] == '\0') {
572 /* last specified element is a device. If it has exactly
573 * one child bus accept it nevertheless */
574 switch (dev
->num_child_bus
) {
576 qemu_error("device has no child bus (%s)\n", path
);
579 return QLIST_FIRST(&dev
->child_bus
);
581 qbus_list_bus(dev
, msg
, sizeof(msg
));
582 qemu_error("device has multiple child busses (%s)\n%s\n",
589 if (sscanf(path
+pos
, "/%127[^/]%n", elem
, &len
) != 1) {
590 qemu_error("path parse error (\"%s\" pos %d)\n", path
, pos
);
594 bus
= qbus_find_bus(dev
, elem
);
596 qbus_list_bus(dev
, msg
, sizeof(msg
));
597 qemu_error("child bus \"%s\" not found\n%s\n", elem
, msg
);
603 void qbus_create_inplace(BusState
*bus
, BusInfo
*info
,
604 DeviceState
*parent
, const char *name
)
610 bus
->parent
= parent
;
613 /* use supplied name */
614 bus
->name
= qemu_strdup(name
);
615 } else if (parent
&& parent
->id
) {
616 /* parent device has id -> use it for bus name */
617 len
= strlen(parent
->id
) + 16;
618 buf
= qemu_malloc(len
);
619 snprintf(buf
, len
, "%s.%d", parent
->id
, parent
->num_child_bus
);
622 /* no id -> use lowercase bus type for bus name */
623 len
= strlen(info
->name
) + 16;
624 buf
= qemu_malloc(len
);
625 len
= snprintf(buf
, len
, "%s.%d", info
->name
,
626 parent
? parent
->num_child_bus
: 0);
627 for (i
= 0; i
< len
; i
++)
628 buf
[i
] = qemu_tolower(buf
[i
]);
632 QLIST_INIT(&bus
->children
);
634 QLIST_INSERT_HEAD(&parent
->child_bus
, bus
, sibling
);
635 parent
->num_child_bus
++;
640 BusState
*qbus_create(BusInfo
*info
, DeviceState
*parent
, const char *name
)
644 bus
= qemu_mallocz(info
->size
);
645 bus
->qdev_allocated
= 1;
646 qbus_create_inplace(bus
, info
, parent
, name
);
650 void qbus_free(BusState
*bus
)
654 while ((dev
= QLIST_FIRST(&bus
->children
)) != NULL
) {
658 QLIST_REMOVE(bus
, sibling
);
659 bus
->parent
->num_child_bus
--;
661 if (bus
->qdev_allocated
) {
666 #define qdev_printf(fmt, ...) monitor_printf(mon, "%*s" fmt, indent, "", ## __VA_ARGS__)
667 static void qbus_print(Monitor
*mon
, BusState
*bus
, int indent
);
669 static void qdev_print_props(Monitor
*mon
, DeviceState
*dev
, Property
*props
,
670 const char *prefix
, int indent
)
676 while (props
->name
) {
677 if (props
->info
->print
) {
678 props
->info
->print(dev
, props
, buf
, sizeof(buf
));
679 qdev_printf("%s-prop: %s = %s\n", prefix
, props
->name
, buf
);
685 static void qdev_print(Monitor
*mon
, DeviceState
*dev
, int indent
)
688 qdev_printf("dev: %s, id \"%s\"\n", dev
->info
->name
,
689 dev
->id
? dev
->id
: "");
691 if (dev
->num_gpio_in
) {
692 qdev_printf("gpio-in %d\n", dev
->num_gpio_in
);
694 if (dev
->num_gpio_out
) {
695 qdev_printf("gpio-out %d\n", dev
->num_gpio_out
);
697 qdev_print_props(mon
, dev
, dev
->info
->props
, "dev", indent
);
698 qdev_print_props(mon
, dev
, dev
->parent_bus
->info
->props
, "bus", indent
);
699 if (dev
->parent_bus
->info
->print_dev
)
700 dev
->parent_bus
->info
->print_dev(mon
, dev
, indent
);
701 QLIST_FOREACH(child
, &dev
->child_bus
, sibling
) {
702 qbus_print(mon
, child
, indent
);
706 static void qbus_print(Monitor
*mon
, BusState
*bus
, int indent
)
708 struct DeviceState
*dev
;
710 qdev_printf("bus: %s\n", bus
->name
);
712 qdev_printf("type %s\n", bus
->info
->name
);
713 QLIST_FOREACH(dev
, &bus
->children
, sibling
) {
714 qdev_print(mon
, dev
, indent
);
719 void do_info_qtree(Monitor
*mon
)
722 qbus_print(mon
, main_system_bus
, 0);
725 void do_info_qdm(Monitor
*mon
)
730 for (info
= device_info_list
; info
!= NULL
; info
= info
->next
) {
731 qdev_print_devinfo(info
, msg
, sizeof(msg
));
732 monitor_printf(mon
, "%s\n", msg
);
736 void do_device_add(Monitor
*mon
, const QDict
*qdict
)
740 opts
= qemu_opts_parse(&qemu_device_opts
,
741 qdict_get_str(qdict
, "config"), "driver");
743 qdev_device_add(opts
);
746 void do_device_del(Monitor
*mon
, const QDict
*qdict
)
748 const char *id
= qdict_get_str(qdict
, "id");
751 dev
= qdev_find_recursive(main_system_bus
, id
);
753 qemu_error("Device '%s' not found\n", id
);