root / hw / qdev.h @ 3320e56e
History | View | Annotate | Download (4.4 kB)
1 | aae9460e | Paul Brook | #ifndef QDEV_H
|
---|---|---|---|
2 | aae9460e | Paul Brook | #define QDEV_H
|
3 | aae9460e | Paul Brook | |
4 | aae9460e | Paul Brook | #include "hw.h" |
5 | 02e2da45 | Paul Brook | #include "sys-queue.h" |
6 | aae9460e | Paul Brook | |
7 | ee6847d1 | Gerd Hoffmann | typedef struct Property Property; |
8 | ee6847d1 | Gerd Hoffmann | |
9 | ee6847d1 | Gerd Hoffmann | typedef struct PropertyInfo PropertyInfo; |
10 | aae9460e | Paul Brook | |
11 | b6b61144 | Gerd Hoffmann | typedef struct CompatProperty CompatProperty; |
12 | b6b61144 | Gerd Hoffmann | |
13 | ee6847d1 | Gerd Hoffmann | typedef struct DeviceInfo DeviceInfo; |
14 | aae9460e | Paul Brook | |
15 | 02e2da45 | Paul Brook | typedef struct BusState BusState; |
16 | 4d6ae674 | Paul Brook | |
17 | 10c4c98a | Gerd Hoffmann | typedef struct BusInfo BusInfo; |
18 | 10c4c98a | Gerd Hoffmann | |
19 | aae9460e | Paul Brook | /* This structure should not be accessed directly. We declare it here
|
20 | aae9460e | Paul Brook | so that it can be embedded in individual device state structures. */
|
21 | 02e2da45 | Paul Brook | struct DeviceState {
|
22 | 042f84d0 | Gerd Hoffmann | DeviceInfo *info; |
23 | 02e2da45 | Paul Brook | BusState *parent_bus; |
24 | aae9460e | Paul Brook | int num_gpio_out;
|
25 | aae9460e | Paul Brook | qemu_irq *gpio_out; |
26 | aae9460e | Paul Brook | int num_gpio_in;
|
27 | aae9460e | Paul Brook | qemu_irq *gpio_in; |
28 | 02e2da45 | Paul Brook | LIST_HEAD(, BusState) child_bus; |
29 | 9d07d757 | Paul Brook | NICInfo *nd; |
30 | 02e2da45 | Paul Brook | LIST_ENTRY(DeviceState) sibling; |
31 | 02e2da45 | Paul Brook | }; |
32 | 02e2da45 | Paul Brook | |
33 | 10c4c98a | Gerd Hoffmann | typedef void (*bus_dev_printfn)(Monitor *mon, DeviceState *dev, int indent); |
34 | 10c4c98a | Gerd Hoffmann | struct BusInfo {
|
35 | 10c4c98a | Gerd Hoffmann | const char *name; |
36 | 10c4c98a | Gerd Hoffmann | size_t size; |
37 | 10c4c98a | Gerd Hoffmann | bus_dev_printfn print_dev; |
38 | ee6847d1 | Gerd Hoffmann | Property *props; |
39 | 10c4c98a | Gerd Hoffmann | }; |
40 | 02e2da45 | Paul Brook | |
41 | 02e2da45 | Paul Brook | struct BusState {
|
42 | 02e2da45 | Paul Brook | DeviceState *parent; |
43 | 10c4c98a | Gerd Hoffmann | BusInfo *info; |
44 | 02e2da45 | Paul Brook | const char *name; |
45 | 02e2da45 | Paul Brook | LIST_HEAD(, DeviceState) children; |
46 | 02e2da45 | Paul Brook | LIST_ENTRY(BusState) sibling; |
47 | aae9460e | Paul Brook | }; |
48 | aae9460e | Paul Brook | |
49 | ee6847d1 | Gerd Hoffmann | struct Property {
|
50 | ee6847d1 | Gerd Hoffmann | const char *name; |
51 | ee6847d1 | Gerd Hoffmann | PropertyInfo *info; |
52 | ee6847d1 | Gerd Hoffmann | int offset;
|
53 | ee6847d1 | Gerd Hoffmann | void *defval;
|
54 | ee6847d1 | Gerd Hoffmann | }; |
55 | ee6847d1 | Gerd Hoffmann | |
56 | ee6847d1 | Gerd Hoffmann | enum PropertyType {
|
57 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_UNSPEC = 0,
|
58 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_UINT16, |
59 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_UINT32, |
60 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_TADDR, |
61 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_MACADDR, |
62 | ee6847d1 | Gerd Hoffmann | PROP_TYPE_PTR, |
63 | ee6847d1 | Gerd Hoffmann | }; |
64 | ee6847d1 | Gerd Hoffmann | |
65 | ee6847d1 | Gerd Hoffmann | struct PropertyInfo {
|
66 | ee6847d1 | Gerd Hoffmann | const char *name; |
67 | ee6847d1 | Gerd Hoffmann | size_t size; |
68 | ee6847d1 | Gerd Hoffmann | enum PropertyType type;
|
69 | ee6847d1 | Gerd Hoffmann | int (*parse)(DeviceState *dev, Property *prop, const char *str); |
70 | ee6847d1 | Gerd Hoffmann | int (*print)(DeviceState *dev, Property *prop, char *dest, size_t len); |
71 | ee6847d1 | Gerd Hoffmann | }; |
72 | ee6847d1 | Gerd Hoffmann | |
73 | b6b61144 | Gerd Hoffmann | struct CompatProperty {
|
74 | b6b61144 | Gerd Hoffmann | const char *driver; |
75 | b6b61144 | Gerd Hoffmann | const char *property; |
76 | b6b61144 | Gerd Hoffmann | const char *value; |
77 | b6b61144 | Gerd Hoffmann | }; |
78 | b6b61144 | Gerd Hoffmann | |
79 | aae9460e | Paul Brook | /*** Board API. This should go away once we have a machine config file. ***/
|
80 | aae9460e | Paul Brook | |
81 | 02e2da45 | Paul Brook | DeviceState *qdev_create(BusState *bus, const char *name); |
82 | aae9460e | Paul Brook | void qdev_init(DeviceState *dev);
|
83 | 02e2da45 | Paul Brook | void qdev_free(DeviceState *dev);
|
84 | aae9460e | Paul Brook | |
85 | aae9460e | Paul Brook | qemu_irq qdev_get_gpio_in(DeviceState *dev, int n);
|
86 | aae9460e | Paul Brook | void qdev_connect_gpio_out(DeviceState *dev, int n, qemu_irq pin); |
87 | aae9460e | Paul Brook | |
88 | 02e2da45 | Paul Brook | BusState *qdev_get_child_bus(DeviceState *dev, const char *name); |
89 | 4d6ae674 | Paul Brook | |
90 | aae9460e | Paul Brook | /*** Device API. ***/
|
91 | aae9460e | Paul Brook | |
92 | 02e2da45 | Paul Brook | typedef void (*qdev_initfn)(DeviceState *dev, DeviceInfo *info); |
93 | 6f68ecb2 | Paul Brook | typedef void (*SCSIAttachFn)(DeviceState *host, BlockDriverState *bdrv, |
94 | 6f68ecb2 | Paul Brook | int unit);
|
95 | aae9460e | Paul Brook | |
96 | 02e2da45 | Paul Brook | struct DeviceInfo {
|
97 | 074f2fff | Gerd Hoffmann | const char *name; |
98 | 3320e56e | Gerd Hoffmann | const char *alias; |
99 | 3320e56e | Gerd Hoffmann | const char *desc; |
100 | 074f2fff | Gerd Hoffmann | size_t size; |
101 | ee6847d1 | Gerd Hoffmann | Property *props; |
102 | 3320e56e | Gerd Hoffmann | int no_user;
|
103 | 074f2fff | Gerd Hoffmann | |
104 | 074f2fff | Gerd Hoffmann | /* Private to qdev / bus. */
|
105 | 02e2da45 | Paul Brook | qdev_initfn init; |
106 | 10c4c98a | Gerd Hoffmann | BusInfo *bus_info; |
107 | 042f84d0 | Gerd Hoffmann | struct DeviceInfo *next;
|
108 | 02e2da45 | Paul Brook | }; |
109 | 02e2da45 | Paul Brook | |
110 | 074f2fff | Gerd Hoffmann | void qdev_register(DeviceInfo *info);
|
111 | aae9460e | Paul Brook | |
112 | aae9460e | Paul Brook | /* Register device properties. */
|
113 | 067a3ddc | Paul Brook | /* GPIO inputs also double as IRQ sinks. */
|
114 | aae9460e | Paul Brook | void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handler handler, int n); |
115 | aae9460e | Paul Brook | void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pins, int n); |
116 | aae9460e | Paul Brook | |
117 | 6f68ecb2 | Paul Brook | void scsi_bus_new(DeviceState *host, SCSIAttachFn attach);
|
118 | 6f68ecb2 | Paul Brook | |
119 | aae9460e | Paul Brook | CharDriverState *qdev_init_chardev(DeviceState *dev); |
120 | aae9460e | Paul Brook | |
121 | 02e2da45 | Paul Brook | BusState *qdev_get_parent_bus(DeviceState *dev); |
122 | aae9460e | Paul Brook | |
123 | aae9460e | Paul Brook | /* Convery from a base type to a parent type, with compile time checking. */
|
124 | aae9460e | Paul Brook | #ifdef __GNUC__
|
125 | aae9460e | Paul Brook | #define DO_UPCAST(type, field, dev) ( __extension__ ( { \
|
126 | aae9460e | Paul Brook | char __attribute__((unused)) offset_must_be_zero[ \
|
127 | aae9460e | Paul Brook | -offsetof(type, field)]; \ |
128 | aae9460e | Paul Brook | container_of(dev, type, field);})) |
129 | aae9460e | Paul Brook | #else
|
130 | aae9460e | Paul Brook | #define DO_UPCAST(type, field, dev) container_of(dev, type, field)
|
131 | aae9460e | Paul Brook | #endif
|
132 | aae9460e | Paul Brook | |
133 | 02e2da45 | Paul Brook | /*** BUS API. ***/
|
134 | 02e2da45 | Paul Brook | |
135 | 10c4c98a | Gerd Hoffmann | BusState *qbus_create(BusInfo *info, DeviceState *parent, const char *name); |
136 | 02e2da45 | Paul Brook | |
137 | 02e2da45 | Paul Brook | #define FROM_QBUS(type, dev) DO_UPCAST(type, qbus, dev)
|
138 | 02e2da45 | Paul Brook | |
139 | cae4956e | Gerd Hoffmann | /*** monitor commands ***/
|
140 | cae4956e | Gerd Hoffmann | |
141 | cae4956e | Gerd Hoffmann | void do_info_qtree(Monitor *mon);
|
142 | cae4956e | Gerd Hoffmann | |
143 | ee6847d1 | Gerd Hoffmann | /*** qdev-properties.c ***/
|
144 | ee6847d1 | Gerd Hoffmann | |
145 | ee6847d1 | Gerd Hoffmann | extern PropertyInfo qdev_prop_uint16;
|
146 | ee6847d1 | Gerd Hoffmann | extern PropertyInfo qdev_prop_uint32;
|
147 | ee6847d1 | Gerd Hoffmann | extern PropertyInfo qdev_prop_hex32;
|
148 | ee6847d1 | Gerd Hoffmann | extern PropertyInfo qdev_prop_ptr;
|
149 | ee6847d1 | Gerd Hoffmann | extern PropertyInfo qdev_prop_macaddr;
|
150 | ee6847d1 | Gerd Hoffmann | |
151 | ee6847d1 | Gerd Hoffmann | /* Set properties between creation and init. */
|
152 | ee6847d1 | Gerd Hoffmann | void *qdev_get_prop_ptr(DeviceState *dev, Property *prop);
|
153 | ee6847d1 | Gerd Hoffmann | int qdev_prop_parse(DeviceState *dev, const char *name, const char *value); |
154 | ee6847d1 | Gerd Hoffmann | void qdev_prop_set(DeviceState *dev, const char *name, void *src, enum PropertyType type); |
155 | ee6847d1 | Gerd Hoffmann | void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value); |
156 | ee6847d1 | Gerd Hoffmann | void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value); |
157 | ee6847d1 | Gerd Hoffmann | /* FIXME: Remove opaque pointer properties. */
|
158 | ee6847d1 | Gerd Hoffmann | void qdev_prop_set_ptr(DeviceState *dev, const char *name, void *value); |
159 | ee6847d1 | Gerd Hoffmann | void qdev_prop_set_defaults(DeviceState *dev, Property *props);
|
160 | ee6847d1 | Gerd Hoffmann | |
161 | b6b61144 | Gerd Hoffmann | void qdev_prop_register_compat(CompatProperty *props);
|
162 | b6b61144 | Gerd Hoffmann | void qdev_prop_set_compat(DeviceState *dev);
|
163 | b6b61144 | Gerd Hoffmann | |
164 | aae9460e | Paul Brook | #endif |