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