hw/core/sysbus.c

   1 /*
   2  *  System (CPU) Bus device support code
   3  *
   4  *  Copyright (c) 2009 CodeSourcery
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include "qemu/osdep.h"
  21 #include "qapi/error.h"
  22 #include "qemu/module.h"
  23 #include "hw/sysbus.h"
  24 #include "monitor/monitor.h"
  25 #include "exec/address-spaces.h"
  26
  27 static void sysbus_dev_print(Monitor *mon, DeviceState *dev, int indent);
  28 static char *sysbus_get_fw_dev_path(DeviceState *dev);
  29
  30 typedef struct SysBusFind {
  31     void *opaque;
  32     FindSysbusDeviceFunc *func;
  33 } SysBusFind;
  34
  35 /* Run func() for every sysbus device, traverse the tree for everything else */
  36 static int find_sysbus_device(Object *obj, void *opaque)
  37 {
  38     SysBusFind *find = opaque;
  39     Object *dev;
  40     SysBusDevice *sbdev;
  41
  42     dev = object_dynamic_cast(obj, TYPE_SYS_BUS_DEVICE);
  43     sbdev = (SysBusDevice *)dev;
  44
  45     if (!sbdev) {
  46         /* Container, traverse it for children */
  47         return object_child_foreach(obj, find_sysbus_device, opaque);
  48     }
  49
  50     find->func(sbdev, find->opaque);
  51
  52     return 0;
  53 }
  54
  55 /*
  56  * Loop through all dynamically created sysbus devices and call
  57  * func() for each instance.
  58  */
  59 void foreach_dynamic_sysbus_device(FindSysbusDeviceFunc *func, void *opaque)
  60 {
  61     Object *container;
  62     SysBusFind find = {
  63         .func = func,
  64         .opaque = opaque,
  65     };
  66
  67     /* Loop through all sysbus devices that were spawened outside the machine */
  68     container = container_get(qdev_get_machine(), "/peripheral");
  69     find_sysbus_device(container, &find);
  70     container = container_get(qdev_get_machine(), "/peripheral-anon");
  71     find_sysbus_device(container, &find);
  72 }
  73
  74
  75 static void system_bus_class_init(ObjectClass *klass, void *data)
  76 {
  77     BusClass *k = BUS_CLASS(klass);
  78
  79     k->print_dev = sysbus_dev_print;
  80     k->get_fw_dev_path = sysbus_get_fw_dev_path;
  81 }
  82
  83 static const TypeInfo system_bus_info = {
  84     .name = TYPE_SYSTEM_BUS,
  85     .parent = TYPE_BUS,
  86     .instance_size = sizeof(BusState),
  87     .class_init = system_bus_class_init,
  88 };
  89
  90 /* Check whether an IRQ source exists */
  91 bool sysbus_has_irq(SysBusDevice *dev, int n)
  92 {
  93     char *prop = g_strdup_printf("%s[%d]", SYSBUS_DEVICE_GPIO_IRQ, n);
  94     ObjectProperty *r;
  95
  96     r = object_property_find(OBJECT(dev), prop, NULL);
  97     g_free(prop);
  98
  99     return (r != NULL);
 100 }
 101
 102 bool sysbus_is_irq_connected(SysBusDevice *dev, int n)
 103 {
 104     return !!sysbus_get_connected_irq(dev, n);
 105 }
 106
 107 qemu_irq sysbus_get_connected_irq(SysBusDevice *dev, int n)
 108 {
 109     DeviceState *d = DEVICE(dev);
 110     return qdev_get_gpio_out_connector(d, SYSBUS_DEVICE_GPIO_IRQ, n);
 111 }
 112
 113 void sysbus_connect_irq(SysBusDevice *dev, int n, qemu_irq irq)
 114 {
 115     SysBusDeviceClass *sbd = SYS_BUS_DEVICE_GET_CLASS(dev);
 116
 117     qdev_connect_gpio_out_named(DEVICE(dev), SYSBUS_DEVICE_GPIO_IRQ, n, irq);
 118
 119     if (sbd->connect_irq_notifier) {
 120         sbd->connect_irq_notifier(dev, irq);
 121     }
 122 }
 123
 124 /* Check whether an MMIO region exists */
 125 bool sysbus_has_mmio(SysBusDevice *dev, unsigned int n)
 126 {
 127     return (n < dev->num_mmio);
 128 }
 129
 130 static void sysbus_mmio_map_common(SysBusDevice *dev, int n, hwaddr addr,
 131                                    bool may_overlap, int priority)
 132 {
 133     assert(n >= 0 && n < dev->num_mmio);
 134
 135     if (dev->mmio[n].addr == addr) {
 136         /* ??? region already mapped here.  */
 137         return;
 138     }
 139     if (dev->mmio[n].addr != (hwaddr)-1) {
 140         /* Unregister previous mapping.  */
 141         memory_region_del_subregion(get_system_memory(), dev->mmio[n].memory);
 142     }
 143     dev->mmio[n].addr = addr;
 144     if (may_overlap) {
 145         memory_region_add_subregion_overlap(get_system_memory(),
 146                                             addr,
 147                                             dev->mmio[n].memory,
 148                                             priority);
 149     }
 150     else {
 151         memory_region_add_subregion(get_system_memory(),
 152                                     addr,
 153                                     dev->mmio[n].memory);
 154     }
 155 }
 156
 157 void sysbus_mmio_unmap(SysBusDevice *dev, int n)
 158 {
 159     assert(n >= 0 && n < dev->num_mmio);
 160
 161     if (dev->mmio[n].addr != (hwaddr)-1) {
 162         memory_region_del_subregion(get_system_memory(), dev->mmio[n].memory);
 163         dev->mmio[n].addr = (hwaddr)-1;
 164     }
 165 }
 166
 167 void sysbus_mmio_map(SysBusDevice *dev, int n, hwaddr addr)
 168 {
 169     sysbus_mmio_map_common(dev, n, addr, false, 0);
 170 }
 171
 172 void sysbus_mmio_map_overlap(SysBusDevice *dev, int n, hwaddr addr,
 173                              int priority)
 174 {
 175     sysbus_mmio_map_common(dev, n, addr, true, priority);
 176 }
 177
 178 /* Request an IRQ source.  The actual IRQ object may be populated later.  */
 179 void sysbus_init_irq(SysBusDevice *dev, qemu_irq *p)
 180 {
 181     qdev_init_gpio_out_named(DEVICE(dev), p, SYSBUS_DEVICE_GPIO_IRQ, 1);
 182 }
 183
 184 /* Pass IRQs from a target device.  */
 185 void sysbus_pass_irq(SysBusDevice *dev, SysBusDevice *target)
 186 {
 187     qdev_pass_gpios(DEVICE(target), DEVICE(dev), SYSBUS_DEVICE_GPIO_IRQ);
 188 }
 189
 190 void sysbus_init_mmio(SysBusDevice *dev, MemoryRegion *memory)
 191 {
 192     int n;
 193
 194     assert(dev->num_mmio < QDEV_MAX_MMIO);
 195     n = dev->num_mmio++;
 196     dev->mmio[n].addr = -1;
 197     dev->mmio[n].memory = memory;
 198 }
 199
 200 MemoryRegion *sysbus_mmio_get_region(SysBusDevice *dev, int n)
 201 {
 202     return dev->mmio[n].memory;
 203 }
 204
 205 void sysbus_init_ioports(SysBusDevice *dev, uint32_t ioport, uint32_t size)
 206 {
 207     uint32_t i;
 208
 209     for (i = 0; i < size; i++) {
 210         assert(dev->num_pio < QDEV_MAX_PIO);
 211         dev->pio[dev->num_pio++] = ioport++;
 212     }
 213 }
 214
 215 /* The purpose of preserving this empty realize function
 216  * is to prevent the parent_realize field of some subclasses
 217  * from being set to NULL to break the normal init/realize
 218  * of some devices.
 219  */
 220 static void sysbus_device_realize(DeviceState *dev, Error **errp)
 221 {
 222 }
 223
 224 DeviceState *sysbus_create_varargs(const char *name,
 225                                    hwaddr addr, ...)
 226 {
 227     DeviceState *dev;
 228     SysBusDevice *s;
 229     va_list va;
 230     qemu_irq irq;
 231     int n;
 232
 233     dev = qdev_new(name);
 234     s = SYS_BUS_DEVICE(dev);
 235     sysbus_realize_and_unref(s, &error_fatal);
 236     if (addr != (hwaddr)-1) {
 237         sysbus_mmio_map(s, 0, addr);
 238     }
 239     va_start(va, addr);
 240     n = 0;
 241     while (1) {
 242         irq = va_arg(va, qemu_irq);
 243         if (!irq) {
 244             break;
 245         }
 246         sysbus_connect_irq(s, n, irq);
 247         n++;
 248     }
 249     va_end(va);
 250     return dev;
 251 }
 252
 253 bool sysbus_realize(SysBusDevice *dev, Error **errp)
 254 {
 255     return qdev_realize(DEVICE(dev), sysbus_get_default(), errp);
 256 }
 257
 258 bool sysbus_realize_and_unref(SysBusDevice *dev, Error **errp)
 259 {
 260     return qdev_realize_and_unref(DEVICE(dev), sysbus_get_default(), errp);
 261 }
 262
 263 static void sysbus_dev_print(Monitor *mon, DeviceState *dev, int indent)
 264 {
 265     SysBusDevice *s = SYS_BUS_DEVICE(dev);
 266     hwaddr size;
 267     int i;
 268
 269     for (i = 0; i < s->num_mmio; i++) {
 270         size = memory_region_size(s->mmio[i].memory);
 271         monitor_printf(mon, "%*smmio " TARGET_FMT_plx "/" TARGET_FMT_plx "\n",
 272                        indent, "", s->mmio[i].addr, size);
 273     }
 274 }
 275
 276 static char *sysbus_get_fw_dev_path(DeviceState *dev)
 277 {
 278     SysBusDevice *s = SYS_BUS_DEVICE(dev);
 279     SysBusDeviceClass *sbc = SYS_BUS_DEVICE_GET_CLASS(s);
 280     char *addr, *fw_dev_path;
 281
 282     if (sbc->explicit_ofw_unit_address) {
 283         addr = sbc->explicit_ofw_unit_address(s);
 284         if (addr) {
 285             fw_dev_path = g_strdup_printf("%s@%s", qdev_fw_name(dev), addr);
 286             g_free(addr);
 287             return fw_dev_path;
 288         }
 289     }
 290     if (s->num_mmio) {
 291         return g_strdup_printf("%s@" TARGET_FMT_plx, qdev_fw_name(dev),
 292                                s->mmio[0].addr);
 293     }
 294     if (s->num_pio) {
 295         return g_strdup_printf("%s@i%04x", qdev_fw_name(dev), s->pio[0]);
 296     }
 297     return g_strdup(qdev_fw_name(dev));
 298 }
 299
 300 void sysbus_add_io(SysBusDevice *dev, hwaddr addr,
 301                        MemoryRegion *mem)
 302 {
 303     memory_region_add_subregion(get_system_io(), addr, mem);
 304 }
 305
 306 MemoryRegion *sysbus_address_space(SysBusDevice *dev)
 307 {
 308     return get_system_memory();
 309 }
 310
 311 static void sysbus_device_class_init(ObjectClass *klass, void *data)
 312 {
 313     DeviceClass *k = DEVICE_CLASS(klass);
 314     k->realize = sysbus_device_realize;
 315     k->bus_type = TYPE_SYSTEM_BUS;
 316     /*
 317      * device_add plugs devices into a suitable bus.  For "real" buses,
 318      * that actually connects the device.  For sysbus, the connections
 319      * need to be made separately, and device_add can't do that.  The
 320      * device would be left unconnected, and will probably not work
 321      *
 322      * However, a few machines can handle device_add/-device with
 323      * a few specific sysbus devices. In those cases, the device
 324      * subclass needs to override it and set user_creatable=true.
 325      */
 326     k->user_creatable = false;
 327 }
 328
 329 static const TypeInfo sysbus_device_type_info = {
 330     .name = TYPE_SYS_BUS_DEVICE,
 331     .parent = TYPE_DEVICE,
 332     .instance_size = sizeof(SysBusDevice),
 333     .abstract = true,
 334     .class_size = sizeof(SysBusDeviceClass),
 335     .class_init = sysbus_device_class_init,
 336 };
 337
 338 static BusState *main_system_bus;
 339
 340 static void main_system_bus_create(void)
 341 {
 342     /* assign main_system_bus before qbus_create_inplace()
 343      * in order to make "if (bus != sysbus_get_default())" work */
 344     main_system_bus = g_malloc0(system_bus_info.instance_size);
 345     qbus_create_inplace(main_system_bus, system_bus_info.instance_size,
 346                         TYPE_SYSTEM_BUS, NULL, "main-system-bus");
 347     OBJECT(main_system_bus)->free = g_free;
 348 }
 349
 350 BusState *sysbus_get_default(void)
 351 {
 352     if (!main_system_bus) {
 353         main_system_bus_create();
 354     }
 355     return main_system_bus;
 356 }
 357
 358 void sysbus_init_child_obj(Object *parent, const char *childname, void *child,
 359                            size_t childsize, const char *childtype)
 360 {
 361     object_initialize_child_with_props(parent, childname, child, childsize,
 362                                        childtype, &error_abort, NULL);
 363     qdev_set_parent_bus(DEVICE(child), sysbus_get_default());
 364 }
 365
 366 static void sysbus_register_types(void)
 367 {
 368     type_register_static(&system_bus_info);
 369     type_register_static(&sysbus_device_type_info);
 370 }
 371
 372 type_init(sysbus_register_types)