]>
Commit | Line | Data |
---|---|---|
aae9460e PB |
1 | #ifndef QDEV_H |
2 | #define QDEV_H | |
3 | ||
4 | #include "hw.h" | |
14b41872 | 5 | #include "sysemu.h" |
72cf2d4f | 6 | #include "qemu-queue.h" |
313feaab | 7 | #include "qemu-char.h" |
f31d07d1 | 8 | #include "qemu-option.h" |
aae9460e | 9 | |
ee6847d1 GH |
10 | typedef struct Property Property; |
11 | ||
12 | typedef struct PropertyInfo PropertyInfo; | |
aae9460e | 13 | |
b6b61144 GH |
14 | typedef struct CompatProperty CompatProperty; |
15 | ||
ee6847d1 | 16 | typedef struct DeviceInfo DeviceInfo; |
aae9460e | 17 | |
02e2da45 | 18 | typedef struct BusState BusState; |
4d6ae674 | 19 | |
10c4c98a GH |
20 | typedef struct BusInfo BusInfo; |
21 | ||
131ec1bd GH |
22 | enum DevState { |
23 | DEV_STATE_CREATED = 1, | |
24 | DEV_STATE_INITIALIZED, | |
25 | }; | |
26 | ||
aae9460e PB |
27 | /* This structure should not be accessed directly. We declare it here |
28 | so that it can be embedded in individual device state structures. */ | |
02e2da45 | 29 | struct DeviceState { |
f31d07d1 | 30 | const char *id; |
131ec1bd | 31 | enum DevState state; |
ef80b466 | 32 | QemuOpts *opts; |
3418bd25 | 33 | int hotplugged; |
042f84d0 | 34 | DeviceInfo *info; |
02e2da45 | 35 | BusState *parent_bus; |
aae9460e PB |
36 | int num_gpio_out; |
37 | qemu_irq *gpio_out; | |
38 | int num_gpio_in; | |
39 | qemu_irq *gpio_in; | |
72cf2d4f | 40 | QLIST_HEAD(, BusState) child_bus; |
d271de9f | 41 | int num_child_bus; |
9d07d757 | 42 | NICInfo *nd; |
72cf2d4f | 43 | QLIST_ENTRY(DeviceState) sibling; |
02e2da45 PB |
44 | }; |
45 | ||
10c4c98a GH |
46 | typedef void (*bus_dev_printfn)(Monitor *mon, DeviceState *dev, int indent); |
47 | struct BusInfo { | |
48 | const char *name; | |
49 | size_t size; | |
50 | bus_dev_printfn print_dev; | |
ee6847d1 | 51 | Property *props; |
10c4c98a | 52 | }; |
02e2da45 PB |
53 | |
54 | struct BusState { | |
55 | DeviceState *parent; | |
10c4c98a | 56 | BusInfo *info; |
02e2da45 | 57 | const char *name; |
3418bd25 | 58 | int allow_hotplug; |
cd739fb6 | 59 | int qdev_allocated; |
72cf2d4f BS |
60 | QLIST_HEAD(, DeviceState) children; |
61 | QLIST_ENTRY(BusState) sibling; | |
aae9460e PB |
62 | }; |
63 | ||
ee6847d1 GH |
64 | struct Property { |
65 | const char *name; | |
66 | PropertyInfo *info; | |
67 | int offset; | |
68 | void *defval; | |
69 | }; | |
70 | ||
71 | enum PropertyType { | |
72 | PROP_TYPE_UNSPEC = 0, | |
c7cc172d | 73 | PROP_TYPE_UINT8, |
ee6847d1 GH |
74 | PROP_TYPE_UINT16, |
75 | PROP_TYPE_UINT32, | |
316940b0 | 76 | PROP_TYPE_INT32, |
5a053d1f | 77 | PROP_TYPE_UINT64, |
ee6847d1 GH |
78 | PROP_TYPE_TADDR, |
79 | PROP_TYPE_MACADDR, | |
14b41872 | 80 | PROP_TYPE_DRIVE, |
313feaab | 81 | PROP_TYPE_CHR, |
59419663 | 82 | PROP_TYPE_STRING, |
2ef924b4 | 83 | PROP_TYPE_NETDEV, |
851bec09 | 84 | PROP_TYPE_VLAN, |
ee6847d1 GH |
85 | PROP_TYPE_PTR, |
86 | }; | |
87 | ||
88 | struct PropertyInfo { | |
89 | const char *name; | |
90 | size_t size; | |
91 | enum PropertyType type; | |
92 | int (*parse)(DeviceState *dev, Property *prop, const char *str); | |
93 | int (*print)(DeviceState *dev, Property *prop, char *dest, size_t len); | |
94 | }; | |
95 | ||
b6b61144 GH |
96 | struct CompatProperty { |
97 | const char *driver; | |
98 | const char *property; | |
99 | const char *value; | |
100 | }; | |
101 | ||
aae9460e PB |
102 | /*** Board API. This should go away once we have a machine config file. ***/ |
103 | ||
02e2da45 | 104 | DeviceState *qdev_create(BusState *bus, const char *name); |
f31d07d1 | 105 | DeviceState *qdev_device_add(QemuOpts *opts); |
747bbdf7 | 106 | int qdev_init(DeviceState *dev) QEMU_WARN_UNUSED_RESULT; |
e23a1b33 | 107 | void qdev_init_nofail(DeviceState *dev); |
3418bd25 | 108 | int qdev_unplug(DeviceState *dev); |
02e2da45 | 109 | void qdev_free(DeviceState *dev); |
3418bd25 GH |
110 | int qdev_simple_unplug_cb(DeviceState *dev); |
111 | void qdev_machine_creation_done(void); | |
aae9460e | 112 | |
aae9460e PB |
113 | qemu_irq qdev_get_gpio_in(DeviceState *dev, int n); |
114 | void qdev_connect_gpio_out(DeviceState *dev, int n, qemu_irq pin); | |
115 | ||
02e2da45 | 116 | BusState *qdev_get_child_bus(DeviceState *dev, const char *name); |
4d6ae674 | 117 | |
aae9460e PB |
118 | /*** Device API. ***/ |
119 | ||
81a322d4 | 120 | typedef int (*qdev_initfn)(DeviceState *dev, DeviceInfo *info); |
3418bd25 | 121 | typedef int (*qdev_event)(DeviceState *dev); |
7f23f812 | 122 | typedef void (*qdev_resetfn)(DeviceState *dev); |
aae9460e | 123 | |
02e2da45 | 124 | struct DeviceInfo { |
074f2fff | 125 | const char *name; |
3320e56e GH |
126 | const char *alias; |
127 | const char *desc; | |
074f2fff | 128 | size_t size; |
ee6847d1 | 129 | Property *props; |
3320e56e | 130 | int no_user; |
074f2fff | 131 | |
959f733a | 132 | /* callbacks */ |
7f23f812 | 133 | qdev_resetfn reset; |
959f733a | 134 | |
391a079e GH |
135 | /* device state */ |
136 | const VMStateDescription *vmsd; | |
137 | ||
074f2fff | 138 | /* Private to qdev / bus. */ |
02e2da45 | 139 | qdev_initfn init; |
3418bd25 GH |
140 | qdev_event unplug; |
141 | qdev_event exit; | |
10c4c98a | 142 | BusInfo *bus_info; |
042f84d0 | 143 | struct DeviceInfo *next; |
02e2da45 PB |
144 | }; |
145 | ||
074f2fff | 146 | void qdev_register(DeviceInfo *info); |
aae9460e PB |
147 | |
148 | /* Register device properties. */ | |
067a3ddc | 149 | /* GPIO inputs also double as IRQ sinks. */ |
aae9460e PB |
150 | void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handler handler, int n); |
151 | void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pins, int n); | |
152 | ||
153 | CharDriverState *qdev_init_chardev(DeviceState *dev); | |
154 | ||
02e2da45 | 155 | BusState *qdev_get_parent_bus(DeviceState *dev); |
aae9460e | 156 | |
979ba184 | 157 | /* Convert from a base type to a parent type, with compile time checking. */ |
aae9460e PB |
158 | #ifdef __GNUC__ |
159 | #define DO_UPCAST(type, field, dev) ( __extension__ ( { \ | |
160 | char __attribute__((unused)) offset_must_be_zero[ \ | |
161 | -offsetof(type, field)]; \ | |
162 | container_of(dev, type, field);})) | |
163 | #else | |
164 | #define DO_UPCAST(type, field, dev) container_of(dev, type, field) | |
165 | #endif | |
166 | ||
02e2da45 PB |
167 | /*** BUS API. ***/ |
168 | ||
cd739fb6 GH |
169 | void qbus_create_inplace(BusState *bus, BusInfo *info, |
170 | DeviceState *parent, const char *name); | |
10c4c98a | 171 | BusState *qbus_create(BusInfo *info, DeviceState *parent, const char *name); |
131ec1bd | 172 | void qbus_free(BusState *bus); |
02e2da45 PB |
173 | |
174 | #define FROM_QBUS(type, dev) DO_UPCAST(type, qbus, dev) | |
175 | ||
cae4956e GH |
176 | /*** monitor commands ***/ |
177 | ||
178 | void do_info_qtree(Monitor *mon); | |
f6c64e0e | 179 | void do_info_qdm(Monitor *mon); |
3418bd25 GH |
180 | void do_device_add(Monitor *mon, const QDict *qdict); |
181 | void do_device_del(Monitor *mon, const QDict *qdict); | |
cae4956e | 182 | |
ee6847d1 GH |
183 | /*** qdev-properties.c ***/ |
184 | ||
c7cc172d | 185 | extern PropertyInfo qdev_prop_uint8; |
ee6847d1 GH |
186 | extern PropertyInfo qdev_prop_uint16; |
187 | extern PropertyInfo qdev_prop_uint32; | |
316940b0 | 188 | extern PropertyInfo qdev_prop_int32; |
5a053d1f | 189 | extern PropertyInfo qdev_prop_uint64; |
ee6847d1 | 190 | extern PropertyInfo qdev_prop_hex32; |
5a053d1f | 191 | extern PropertyInfo qdev_prop_hex64; |
59419663 | 192 | extern PropertyInfo qdev_prop_string; |
313feaab | 193 | extern PropertyInfo qdev_prop_chr; |
ee6847d1 GH |
194 | extern PropertyInfo qdev_prop_ptr; |
195 | extern PropertyInfo qdev_prop_macaddr; | |
14b41872 | 196 | extern PropertyInfo qdev_prop_drive; |
851bec09 GH |
197 | extern PropertyInfo qdev_prop_netdev; |
198 | extern PropertyInfo qdev_prop_vlan; | |
05cb5fe4 | 199 | extern PropertyInfo qdev_prop_pci_devfn; |
ee6847d1 | 200 | |
cf12b95b GH |
201 | #define DEFINE_PROP(_name, _state, _field, _prop, _type) { \ |
202 | .name = (_name), \ | |
203 | .info = &(_prop), \ | |
204 | .offset = offsetof(_state, _field) \ | |
205 | + type_check(_type,typeof_field(_state, _field)), \ | |
206 | } | |
207 | #define DEFINE_PROP_DEFAULT(_name, _state, _field, _defval, _prop, _type) { \ | |
208 | .name = (_name), \ | |
209 | .info = &(_prop), \ | |
210 | .offset = offsetof(_state, _field) \ | |
211 | + type_check(_type,typeof_field(_state, _field)), \ | |
212 | .defval = (_type[]) { _defval }, \ | |
213 | } | |
214 | ||
c7cc172d JQ |
215 | #define DEFINE_PROP_UINT8(_n, _s, _f, _d) \ |
216 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_uint8, uint8_t) | |
cf12b95b GH |
217 | #define DEFINE_PROP_UINT16(_n, _s, _f, _d) \ |
218 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_uint16, uint16_t) | |
219 | #define DEFINE_PROP_UINT32(_n, _s, _f, _d) \ | |
220 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_uint32, uint32_t) | |
316940b0 GH |
221 | #define DEFINE_PROP_INT32(_n, _s, _f, _d) \ |
222 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_int32, int32_t) | |
cf12b95b GH |
223 | #define DEFINE_PROP_UINT64(_n, _s, _f, _d) \ |
224 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_uint64, uint64_t) | |
225 | #define DEFINE_PROP_HEX32(_n, _s, _f, _d) \ | |
226 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_hex32, uint32_t) | |
227 | #define DEFINE_PROP_HEX64(_n, _s, _f, _d) \ | |
228 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_hex64, uint64_t) | |
229 | #define DEFINE_PROP_PCI_DEVFN(_n, _s, _f, _d) \ | |
230 | DEFINE_PROP_DEFAULT(_n, _s, _f, _d, qdev_prop_pci_devfn, uint32_t) | |
231 | ||
232 | #define DEFINE_PROP_PTR(_n, _s, _f) \ | |
233 | DEFINE_PROP(_n, _s, _f, qdev_prop_ptr, void*) | |
313feaab GH |
234 | #define DEFINE_PROP_CHR(_n, _s, _f) \ |
235 | DEFINE_PROP(_n, _s, _f, qdev_prop_chr, CharDriverState*) | |
59419663 GH |
236 | #define DEFINE_PROP_STRING(_n, _s, _f) \ |
237 | DEFINE_PROP(_n, _s, _f, qdev_prop_string, char*) | |
2ef924b4 GH |
238 | #define DEFINE_PROP_NETDEV(_n, _s, _f) \ |
239 | DEFINE_PROP(_n, _s, _f, qdev_prop_netdev, VLANClientState*) | |
851bec09 GH |
240 | #define DEFINE_PROP_VLAN(_n, _s, _f) \ |
241 | DEFINE_PROP(_n, _s, _f, qdev_prop_vlan, VLANState*) | |
f6c64e0e | 242 | #define DEFINE_PROP_DRIVE(_n, _s, _f) \ |
c981d39c | 243 | DEFINE_PROP(_n, _s, _f, qdev_prop_drive, DriveInfo*) |
cf12b95b | 244 | #define DEFINE_PROP_MACADDR(_n, _s, _f) \ |
1503fff3 | 245 | DEFINE_PROP(_n, _s, _f, qdev_prop_macaddr, MACAddr) |
cf12b95b GH |
246 | |
247 | #define DEFINE_PROP_END_OF_LIST() \ | |
248 | {} | |
249 | ||
ee6847d1 GH |
250 | /* Set properties between creation and init. */ |
251 | void *qdev_get_prop_ptr(DeviceState *dev, Property *prop); | |
252 | int qdev_prop_parse(DeviceState *dev, const char *name, const char *value); | |
253 | void qdev_prop_set(DeviceState *dev, const char *name, void *src, enum PropertyType type); | |
c7cc172d | 254 | void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value); |
ee6847d1 GH |
255 | void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value); |
256 | void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value); | |
316940b0 | 257 | void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value); |
5a053d1f | 258 | void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value); |
313feaab | 259 | void qdev_prop_set_chr(DeviceState *dev, const char *name, CharDriverState *value); |
2ef924b4 | 260 | void qdev_prop_set_netdev(DeviceState *dev, const char *name, VLANClientState *value); |
851bec09 | 261 | void qdev_prop_set_vlan(DeviceState *dev, const char *name, VLANState *value); |
14b41872 | 262 | void qdev_prop_set_drive(DeviceState *dev, const char *name, DriveInfo *value); |
1503fff3 | 263 | void qdev_prop_set_macaddr(DeviceState *dev, const char *name, uint8_t *value); |
ee6847d1 GH |
264 | /* FIXME: Remove opaque pointer properties. */ |
265 | void qdev_prop_set_ptr(DeviceState *dev, const char *name, void *value); | |
266 | void qdev_prop_set_defaults(DeviceState *dev, Property *props); | |
267 | ||
b6b61144 GH |
268 | void qdev_prop_register_compat(CompatProperty *props); |
269 | void qdev_prop_set_compat(DeviceState *dev); | |
270 | ||
a9ff9df1 BS |
271 | /* This is a nasty hack to allow passing a NULL bus to qdev_create. */ |
272 | extern struct BusInfo system_bus_info; | |
273 | ||
aae9460e | 274 | #endif |