hw/char/serial-pci-multi.c

   1 /*
   2  * QEMU 16550A multi UART emulation
   3  *
   4  * SPDX-License-Identifier: MIT
   5  *
   6  * Copyright (c) 2003-2004 Fabrice Bellard
   7  * Copyright (c) 2008 Citrix Systems, Inc.
   8  *
   9  * Permission is hereby granted, free of charge, to any person obtaining a copy
  10  * of this software and associated documentation files (the "Software"), to deal
  11  * in the Software without restriction, including without limitation the rights
  12  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13  * copies of the Software, and to permit persons to whom the Software is
  14  * furnished to do so, subject to the following conditions:
  15  *
  16  * The above copyright notice and this permission notice shall be included in
  17  * all copies or substantial portions of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  22  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  25  * THE SOFTWARE.
  26  */
  27
  28 /* see docs/specs/pci-serial.txt */
  29
  30 #include "qemu/osdep.h"
  31 #include "qapi/error.h"
  32 #include "hw/char/serial.h"
  33 #include "hw/irq.h"
  34 #include "hw/pci/pci.h"
  35 #include "hw/qdev-properties.h"
  36 #include "migration/vmstate.h"
  37
  38 #define PCI_SERIAL_MAX_PORTS 4
  39
  40 typedef struct PCIMultiSerialState {
  41     PCIDevice    dev;
  42     MemoryRegion iobar;
  43     uint32_t     ports;
  44     char         *name[PCI_SERIAL_MAX_PORTS];
  45     SerialState  state[PCI_SERIAL_MAX_PORTS];
  46     uint32_t     level[PCI_SERIAL_MAX_PORTS];
  47     qemu_irq     *irqs;
  48     uint8_t      prog_if;
  49 } PCIMultiSerialState;
  50
  51 static void multi_serial_pci_exit(PCIDevice *dev)
  52 {
  53     PCIMultiSerialState *pci = DO_UPCAST(PCIMultiSerialState, dev, dev);
  54     SerialState *s;
  55     int i;
  56
  57     for (i = 0; i < pci->ports; i++) {
  58         s = pci->state + i;
  59         qdev_unrealize(DEVICE(s));
  60         memory_region_del_subregion(&pci->iobar, &s->io);
  61         g_free(pci->name[i]);
  62     }
  63     qemu_free_irqs(pci->irqs, pci->ports);
  64 }
  65
  66 static void multi_serial_irq_mux(void *opaque, int n, int level)
  67 {
  68     PCIMultiSerialState *pci = opaque;
  69     int i, pending = 0;
  70
  71     pci->level[n] = level;
  72     for (i = 0; i < pci->ports; i++) {
  73         if (pci->level[i]) {
  74             pending = 1;
  75         }
  76     }
  77     pci_set_irq(&pci->dev, pending);
  78 }
  79
  80 static size_t multi_serial_get_port_count(PCIDeviceClass *pc)
  81 {
  82     switch (pc->device_id) {
  83     case 0x0003:
  84         return 2;
  85     case 0x0004:
  86         return 4;
  87     }
  88
  89     g_assert_not_reached();
  90 }
  91
  92
  93 static void multi_serial_pci_realize(PCIDevice *dev, Error **errp)
  94 {
  95     PCIDeviceClass *pc = PCI_DEVICE_GET_CLASS(dev);
  96     PCIMultiSerialState *pci = DO_UPCAST(PCIMultiSerialState, dev, dev);
  97     SerialState *s;
  98     Error *err = NULL;
  99     size_t i, nports = multi_serial_get_port_count(pc);
 100
 101     pci->dev.config[PCI_CLASS_PROG] = pci->prog_if;
 102     pci->dev.config[PCI_INTERRUPT_PIN] = 0x01;
 103     memory_region_init(&pci->iobar, OBJECT(pci), "multiserial", 8 * nports);
 104     pci_register_bar(&pci->dev, 0, PCI_BASE_ADDRESS_SPACE_IO, &pci->iobar);
 105     pci->irqs = qemu_allocate_irqs(multi_serial_irq_mux, pci, nports);
 106
 107     for (i = 0; i < nports; i++) {
 108         s = pci->state + i;
 109         if (!qdev_realize(DEVICE(s), NULL, &err)) {
 110             error_propagate(errp, err);
 111             multi_serial_pci_exit(dev);
 112             return;
 113         }
 114         s->irq = pci->irqs[i];
 115         pci->name[i] = g_strdup_printf("uart #%zu", i + 1);
 116         memory_region_init_io(&s->io, OBJECT(pci), &serial_io_ops, s,
 117                               pci->name[i], 8);
 118         memory_region_add_subregion(&pci->iobar, 8 * i, &s->io);
 119         pci->ports++;
 120     }
 121 }
 122
 123 static const VMStateDescription vmstate_pci_multi_serial = {
 124     .name = "pci-serial-multi",
 125     .version_id = 1,
 126     .minimum_version_id = 1,
 127     .fields = (VMStateField[]) {
 128         VMSTATE_PCI_DEVICE(dev, PCIMultiSerialState),
 129         VMSTATE_STRUCT_ARRAY(state, PCIMultiSerialState, PCI_SERIAL_MAX_PORTS,
 130                              0, vmstate_serial, SerialState),
 131         VMSTATE_UINT32_ARRAY(level, PCIMultiSerialState, PCI_SERIAL_MAX_PORTS),
 132         VMSTATE_END_OF_LIST()
 133     }
 134 };
 135
 136 static Property multi_2x_serial_pci_properties[] = {
 137     DEFINE_PROP_CHR("chardev1",  PCIMultiSerialState, state[0].chr),
 138     DEFINE_PROP_CHR("chardev2",  PCIMultiSerialState, state[1].chr),
 139     DEFINE_PROP_UINT8("prog_if",  PCIMultiSerialState, prog_if, 0x02),
 140     DEFINE_PROP_END_OF_LIST(),
 141 };
 142
 143 static Property multi_4x_serial_pci_properties[] = {
 144     DEFINE_PROP_CHR("chardev1",  PCIMultiSerialState, state[0].chr),
 145     DEFINE_PROP_CHR("chardev2",  PCIMultiSerialState, state[1].chr),
 146     DEFINE_PROP_CHR("chardev3",  PCIMultiSerialState, state[2].chr),
 147     DEFINE_PROP_CHR("chardev4",  PCIMultiSerialState, state[3].chr),
 148     DEFINE_PROP_UINT8("prog_if",  PCIMultiSerialState, prog_if, 0x02),
 149     DEFINE_PROP_END_OF_LIST(),
 150 };
 151
 152 static void multi_2x_serial_pci_class_initfn(ObjectClass *klass, void *data)
 153 {
 154     DeviceClass *dc = DEVICE_CLASS(klass);
 155     PCIDeviceClass *pc = PCI_DEVICE_CLASS(klass);
 156     pc->realize = multi_serial_pci_realize;
 157     pc->exit = multi_serial_pci_exit;
 158     pc->vendor_id = PCI_VENDOR_ID_REDHAT;
 159     pc->device_id = PCI_DEVICE_ID_REDHAT_SERIAL2;
 160     pc->revision = 1;
 161     pc->class_id = PCI_CLASS_COMMUNICATION_SERIAL;
 162     dc->vmsd = &vmstate_pci_multi_serial;
 163     device_class_set_props(dc, multi_2x_serial_pci_properties);
 164     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
 165 }
 166
 167 static void multi_4x_serial_pci_class_initfn(ObjectClass *klass, void *data)
 168 {
 169     DeviceClass *dc = DEVICE_CLASS(klass);
 170     PCIDeviceClass *pc = PCI_DEVICE_CLASS(klass);
 171     pc->realize = multi_serial_pci_realize;
 172     pc->exit = multi_serial_pci_exit;
 173     pc->vendor_id = PCI_VENDOR_ID_REDHAT;
 174     pc->device_id = PCI_DEVICE_ID_REDHAT_SERIAL4;
 175     pc->revision = 1;
 176     pc->class_id = PCI_CLASS_COMMUNICATION_SERIAL;
 177     dc->vmsd = &vmstate_pci_multi_serial;
 178     device_class_set_props(dc, multi_4x_serial_pci_properties);
 179     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
 180 }
 181
 182 static void multi_serial_init(Object *o)
 183 {
 184     PCIDevice *dev = PCI_DEVICE(o);
 185     PCIMultiSerialState *pms = DO_UPCAST(PCIMultiSerialState, dev, dev);
 186     size_t i, nports = multi_serial_get_port_count(PCI_DEVICE_GET_CLASS(dev));
 187
 188     for (i = 0; i < nports; i++) {
 189         object_initialize_child(o, "serial[*]", &pms->state[i], TYPE_SERIAL);
 190     }
 191 }
 192
 193 static const TypeInfo multi_2x_serial_pci_info = {
 194     .name          = "pci-serial-2x",
 195     .parent        = TYPE_PCI_DEVICE,
 196     .instance_size = sizeof(PCIMultiSerialState),
 197     .instance_init = multi_serial_init,
 198     .class_init    = multi_2x_serial_pci_class_initfn,
 199     .interfaces = (InterfaceInfo[]) {
 200         { INTERFACE_CONVENTIONAL_PCI_DEVICE },
 201         { },
 202     },
 203 };
 204
 205 static const TypeInfo multi_4x_serial_pci_info = {
 206     .name          = "pci-serial-4x",
 207     .parent        = TYPE_PCI_DEVICE,
 208     .instance_size = sizeof(PCIMultiSerialState),
 209     .instance_init = multi_serial_init,
 210     .class_init    = multi_4x_serial_pci_class_initfn,
 211     .interfaces = (InterfaceInfo[]) {
 212         { INTERFACE_CONVENTIONAL_PCI_DEVICE },
 213         { },
 214     },
 215 };
 216
 217 static void multi_serial_pci_register_types(void)
 218 {
 219     type_register_static(&multi_2x_serial_pci_info);
 220     type_register_static(&multi_4x_serial_pci_info);
 221 }
 222
 223 type_init(multi_serial_pci_register_types)