xref: /openbmc/qemu/include/hw/misc/unimp.h (revision 0b1183e3)
1 /*
2  * "Unimplemented" device
3  *
4  * Copyright Linaro Limited, 2017
5  * Written by Peter Maydell
6  */
7 
8 #ifndef HW_MISC_UNIMP_H
9 #define HW_MISC_UNIMP_H
10 
11 #include "hw/sysbus.h"
12 
13 #define TYPE_UNIMPLEMENTED_DEVICE "unimplemented-device"
14 
15 /**
16  * create_unimplemented_device: create and map a dummy device
17  * @name: name of the device for debug logging
18  * @base: base address of the device's MMIO region
19  * @size: size of the device's MMIO region
20  *
21  * This utility function creates and maps an instance of unimplemented-device,
22  * which is a dummy device which simply logs all guest accesses to
23  * it via the qemu_log LOG_UNIMP debug log.
24  * The device is mapped at priority -1000, which means that you can
25  * use it to cover a large region and then map other devices on top of it
26  * if necessary.
27  */
28 static inline void create_unimplemented_device(const char *name,
29                                                hwaddr base,
30                                                hwaddr size)
31 {
32     DeviceState *dev = qdev_create(NULL, TYPE_UNIMPLEMENTED_DEVICE);
33 
34     qdev_prop_set_string(dev, "name", name);
35     qdev_prop_set_uint64(dev, "size", size);
36     qdev_init_nofail(dev);
37 
38     sysbus_mmio_map_overlap(SYS_BUS_DEVICE(dev), 0, base, -1000);
39 }
40 
41 #endif
42