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