Blame view

hw/qdev.c 10.1 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
/*
 *  Dynamic device configuration and creation.
 *
 *  Copyright (c) 2009 CodeSourcery
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * 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/>.
18
19
20
21
22
23
24
25
26
27
 */

/* The theory here is that it should be possible to create a machine without
   knowledge of specific devices.  Historically board init routines have
   passed a bunch of arguments to each device, requiring the board know
   exactly which device it is dealing with.  This file provides an abstract
   API for device configuration and initialization.  Devices will generally
   inherit from a particular bus (e.g. PCI or I2C) rather than
   this API directly.  */
28
#include "net.h"
29
30
#include "qdev.h"
#include "sysemu.h"
31
#include "monitor.h"
32
33
34

struct DeviceProperty {
    const char *name;
35
    DevicePropType type;
36
    union {
37
        uint64_t i;
38
39
40
41
42
        void *ptr;
    } value;
    DeviceProperty *next;
};
Paul Brook authored
43
/* This is a nasty hack to allow passing a NULL bus to qdev_create.  */
Blue Swirl authored
44
static BusState *main_system_bus;
45
extern struct BusInfo system_bus_info;
Paul Brook authored
46
47
static DeviceInfo *device_info_list;
48
49

/* Register a new device type.  */
50
void qdev_register(DeviceInfo *info)
51
{
52
    assert(info->size >= sizeof(DeviceState));
53
    assert(!info->next);
54
55
56
    info->next = device_info_list;
    device_info_list = info;
57
58
59
60
61
}

/* Create a new device.  This only initializes the device state structure
   and allows properties to be set.  qdev_init should be called to
   initialize the actual device emulation.  */
Paul Brook authored
62
DeviceState *qdev_create(BusState *bus, const char *name)
63
{
64
    DeviceInfo *info;
65
66
    DeviceState *dev;
67
68
69
    if (!bus) {
        if (!main_system_bus) {
            main_system_bus = qbus_create(&system_bus_info, NULL, "main-system-bus");
70
        }
71
72
73
        bus = main_system_bus;
    }
74
75
    for (info = device_info_list; info != NULL; info = info->next) {
        if (info->bus_info != bus->info)
76
            continue;
77
        if (strcmp(info->name, name) != 0)
78
79
            continue;
        break;
80
    }
81
    if (!info) {
82
        hw_error("Unknown device '%s' for bus '%s'\n", name, bus->info->name);
83
84
    }
85
86
    dev = qemu_mallocz(info->size);
    dev->info = info;
Paul Brook authored
87
88
    dev->parent_bus = bus;
    LIST_INSERT_HEAD(&bus->children, dev, sibling);
89
90
91
92
93
94
95
96
    return dev;
}

/* Initialize a device.  Device properties should be set before calling
   this function.  IRQs and MMIO regions should be connected/mapped after
   calling this function.  */
void qdev_init(DeviceState *dev)
{
97
    dev->info->init(dev, dev->info);
Paul Brook authored
98
99
100
101
102
103
104
}

/* Unlink device from bus and free the structure.  */
void qdev_free(DeviceState *dev)
{
    LIST_REMOVE(dev, sibling);
    free(dev);
105
106
}
107
108
static DeviceProperty *create_prop(DeviceState *dev, const char *name,
                                   DevicePropType type)
109
110
111
112
113
114
{
    DeviceProperty *prop;

    /* TODO: Check for duplicate properties.  */
    prop = qemu_mallocz(sizeof(*prop));
    prop->name = qemu_strdup(name);
115
    prop->type = type;
116
117
118
119
120
121
    prop->next = dev->props;
    dev->props = prop;

    return prop;
}
122
void qdev_set_prop_int(DeviceState *dev, const char *name, uint64_t value)
123
124
125
{
    DeviceProperty *prop;
126
    prop = create_prop(dev, name, PROP_TYPE_INT);
127
128
129
    prop->value.i = value;
}
130
131
132
133
134
135
136
137
void qdev_set_prop_dev(DeviceState *dev, const char *name, DeviceState *value)
{
    DeviceProperty *prop;

    prop = create_prop(dev, name, PROP_TYPE_DEV);
    prop->value.ptr = value;
}
138
139
140
141
void qdev_set_prop_ptr(DeviceState *dev, const char *name, void *value)
{
    DeviceProperty *prop;
Paul Brook authored
142
    prop = create_prop(dev, name, PROP_TYPE_PTR);
143
144
145
    prop->value.ptr = value;
}
146
147
148
149
150
151
void qdev_set_netdev(DeviceState *dev, NICInfo *nd)
{
    assert(!dev->nd);
    dev->nd = nd;
}
152
153
154
155
156
157
158

/* Get a character (serial) device interface.  */
CharDriverState *qdev_init_chardev(DeviceState *dev)
{
    static int next_serial;
    static int next_virtconsole;
    /* FIXME: This is a nasty hack that needs to go away.  */
159
    if (strncmp(dev->info->name, "virtio", 6) == 0) {
160
161
162
163
164
165
        return virtcon_hds[next_virtconsole++];
    } else {
        return serial_hds[next_serial++];
    }
}
Paul Brook authored
166
BusState *qdev_get_parent_bus(DeviceState *dev)
167
{
Paul Brook authored
168
    return dev->parent_bus;
169
170
}
171
172
static DeviceProperty *find_prop(DeviceState *dev, const char *name,
                                 DevicePropType type)
173
174
175
176
177
{
    DeviceProperty *prop;

    for (prop = dev->props; prop; prop = prop->next) {
        if (strcmp(prop->name, name) == 0) {
178
            assert (prop->type == type);
179
180
181
182
183
184
185
186
187
188
            return prop;
        }
    }
    return NULL;
}

uint64_t qdev_get_prop_int(DeviceState *dev, const char *name, uint64_t def)
{
    DeviceProperty *prop;
189
190
    prop = find_prop(dev, name, PROP_TYPE_INT);
    if (!prop) {
191
        return def;
192
    }
193
194
195
196
197
198
199
200

    return prop->value.i;
}

void *qdev_get_prop_ptr(DeviceState *dev, const char *name)
{
    DeviceProperty *prop;
201
    prop = find_prop(dev, name, PROP_TYPE_PTR);
202
203
204
205
    assert(prop);
    return prop->value.ptr;
}
206
207
208
209
210
211
212
213
214
215
216
DeviceState *qdev_get_prop_dev(DeviceState *dev, const char *name)
{
    DeviceProperty *prop;

    prop = find_prop(dev, name, PROP_TYPE_DEV);
    if (!prop) {
        return NULL;
    }
    return prop->value.ptr;
}
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handler handler, int n)
{
    assert(dev->num_gpio_in == 0);
    dev->num_gpio_in = n;
    dev->gpio_in = qemu_allocate_irqs(handler, dev, n);
}

void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pins, int n)
{
    assert(dev->num_gpio_out == 0);
    dev->num_gpio_out = n;
    dev->gpio_out = pins;
}

qemu_irq qdev_get_gpio_in(DeviceState *dev, int n)
{
    assert(n >= 0 && n < dev->num_gpio_in);
    return dev->gpio_in[n];
}

void qdev_connect_gpio_out(DeviceState * dev, int n, qemu_irq pin)
{
    assert(n >= 0 && n < dev->num_gpio_out);
    dev->gpio_out[n] = pin;
}
243
VLANClientState *qdev_get_vlan_client(DeviceState *dev,
244
245
246
                                      NetCanReceive *can_receive,
                                      NetReceive *receive,
                                      NetReceiveIOV *receive_iov,
247
248
249
250
251
                                      NetCleanup *cleanup,
                                      void *opaque)
{
    NICInfo *nd = dev->nd;
    assert(nd);
252
253
254
    nd->vc = qemu_new_vlan_client(nd->vlan, nd->model, nd->name, can_receive,
                                  receive, receive_iov, cleanup, opaque);
    return nd->vc;
255
256
257
258
259
260
261
262
}


void qdev_get_macaddr(DeviceState *dev, uint8_t *macaddr)
{
    memcpy(macaddr, dev->nd->macaddr, 6);
}
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
static int next_block_unit[IF_COUNT];

/* Get a block device.  This should only be used for single-drive devices
   (e.g. SD/Floppy/MTD).  Multi-disk devices (scsi/ide) should use the
   appropriate bus.  */
BlockDriverState *qdev_init_bdrv(DeviceState *dev, BlockInterfaceType type)
{
    int unit = next_block_unit[type]++;
    int index;

    index = drive_get_index(type, 0, unit);
    if (index == -1) {
        return NULL;
    }
    return drives_table[index].bdrv;
}
Paul Brook authored
279
Paul Brook authored
280
BusState *qdev_get_child_bus(DeviceState *dev, const char *name)
Paul Brook authored
281
{
Paul Brook authored
282
    BusState *bus;
Paul Brook authored
283
Paul Brook authored
284
    LIST_FOREACH(bus, &dev->child_bus, sibling) {
Paul Brook authored
285
        if (strcmp(name, bus->name) == 0) {
Paul Brook authored
286
            return bus;
Paul Brook authored
287
288
289
290
291
        }
    }
    return NULL;
}
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
static int next_scsi_bus;

/* Create a scsi bus, and attach devices to it.  */
/* TODO: Actually create a scsi bus for hotplug to use.  */
void scsi_bus_new(DeviceState *host, SCSIAttachFn attach)
{
   int bus = next_scsi_bus++;
   int unit;
   int index;

   for (unit = 0; unit < MAX_SCSI_DEVS; unit++) {
       index = drive_get_index(IF_SCSI, bus, unit);
       if (index == -1) {
           continue;
       }
       attach(host, drives_table[index].bdrv, unit);
   }
}
Paul Brook authored
310
311
BusState *qbus_create(BusInfo *info, DeviceState *parent, const char *name)
Paul Brook authored
312
313
314
{
    BusState *bus;
315
316
    bus = qemu_mallocz(info->size);
    bus->info = info;
Paul Brook authored
317
318
319
320
321
322
323
324
    bus->parent = parent;
    bus->name = qemu_strdup(name);
    LIST_INIT(&bus->children);
    if (parent) {
        LIST_INSERT_HEAD(&parent->child_bus, bus, sibling);
    }
    return bus;
}
325
326
327
328
329
330
331
332

#define qdev_printf(fmt, ...) monitor_printf(mon, "%*s" fmt, indent, "", ## __VA_ARGS__)
static void qbus_print(Monitor *mon, BusState *bus, int indent);

static void qdev_print(Monitor *mon, DeviceState *dev, int indent)
{
    DeviceProperty *prop;
    BusState *child;
333
    qdev_printf("dev: %s\n", dev->info->name);
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
    indent += 2;
    if (dev->num_gpio_in) {
        qdev_printf("gpio-in %d\n", dev->num_gpio_in);
    }
    if (dev->num_gpio_out) {
        qdev_printf("gpio-out %d\n", dev->num_gpio_out);
    }
    for (prop = dev->props; prop; prop = prop->next) {
        switch (prop->type) {
        case PROP_TYPE_INT:
            qdev_printf("prop-int %s 0x%" PRIx64 "\n", prop->name,
                        prop->value.i);
            break;
        case PROP_TYPE_PTR:
            qdev_printf("prop-ptr %s\n", prop->name);
            break;
        case PROP_TYPE_DEV:
            qdev_printf("prop-dev %s %s\n", prop->name,
352
                        ((DeviceState *)prop->value.ptr)->info->name);
353
354
355
356
357
358
            break;
        default:
            qdev_printf("prop-unknown%d %s\n", prop->type, prop->name);
            break;
        }
    }
359
360
    if (dev->parent_bus->info->print_dev)
        dev->parent_bus->info->print_dev(mon, dev, indent);
361
362
363
364
365
366
367
368
369
370
371
    LIST_FOREACH(child, &dev->child_bus, sibling) {
        qbus_print(mon, child, indent);
    }
}

static void qbus_print(Monitor *mon, BusState *bus, int indent)
{
    struct DeviceState *dev;

    qdev_printf("bus: %s\n", bus->name);
    indent += 2;
372
    qdev_printf("type %s\n", bus->info->name);
373
374
375
376
377
378
379
380
381
382
383
    LIST_FOREACH(dev, &bus->children, sibling) {
        qdev_print(mon, dev, indent);
    }
}
#undef qdev_printf

void do_info_qtree(Monitor *mon)
{
    if (main_system_bus)
        qbus_print(mon, main_system_bus, 0);
}