2 * QEMU 16550A multi UART emulation
4 * SPDX-License-Identifier: MIT
6 * Copyright (c) 2003-2004 Fabrice Bellard
7 * Copyright (c) 2008 Citrix Systems, Inc.
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:
16 * The above copyright notice and this permission notice shall be included in
17 * all copies or substantial portions of the Software.
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
28 /* see docs/specs/pci-serial.txt */
30 #include "qemu/osdep.h"
31 #include "qapi/error.h"
32 #include "hw/char/serial.h"
34 #include "hw/pci/pci.h"
35 #include "hw/qdev-properties.h"
36 #include "migration/vmstate.h"
38 #define PCI_SERIAL_MAX_PORTS 4
40 typedef struct PCIMultiSerialState
{
44 char *name
[PCI_SERIAL_MAX_PORTS
];
45 SerialState state
[PCI_SERIAL_MAX_PORTS
];
46 uint32_t level
[PCI_SERIAL_MAX_PORTS
];
49 } PCIMultiSerialState
;
51 static void multi_serial_pci_exit(PCIDevice
*dev
)
53 PCIMultiSerialState
*pci
= DO_UPCAST(PCIMultiSerialState
, dev
, dev
);
57 for (i
= 0; i
< pci
->ports
; i
++) {
59 object_property_set_bool(OBJECT(s
), false, "realized", &error_abort
);
60 memory_region_del_subregion(&pci
->iobar
, &s
->io
);
63 qemu_free_irqs(pci
->irqs
, pci
->ports
);
66 static void multi_serial_irq_mux(void *opaque
, int n
, int level
)
68 PCIMultiSerialState
*pci
= opaque
;
71 pci
->level
[n
] = level
;
72 for (i
= 0; i
< pci
->ports
; i
++) {
77 pci_set_irq(&pci
->dev
, pending
);
80 static size_t multi_serial_get_port_count(PCIDeviceClass
*pc
)
82 switch (pc
->device_id
) {
89 g_assert_not_reached();
93 static void multi_serial_pci_realize(PCIDevice
*dev
, Error
**errp
)
95 PCIDeviceClass
*pc
= PCI_DEVICE_GET_CLASS(dev
);
96 PCIMultiSerialState
*pci
= DO_UPCAST(PCIMultiSerialState
, dev
, dev
);
99 size_t i
, nports
= multi_serial_get_port_count(pc
);
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
);
107 for (i
= 0; i
< nports
; i
++) {
109 object_property_set_bool(OBJECT(s
), true, "realized", &err
);
111 error_propagate(errp
, err
);
112 multi_serial_pci_exit(dev
);
115 s
->irq
= pci
->irqs
[i
];
116 pci
->name
[i
] = g_strdup_printf("uart #%zu", i
+ 1);
117 memory_region_init_io(&s
->io
, OBJECT(pci
), &serial_io_ops
, s
,
119 memory_region_add_subregion(&pci
->iobar
, 8 * i
, &s
->io
);
124 static const VMStateDescription vmstate_pci_multi_serial
= {
125 .name
= "pci-serial-multi",
127 .minimum_version_id
= 1,
128 .fields
= (VMStateField
[]) {
129 VMSTATE_PCI_DEVICE(dev
, PCIMultiSerialState
),
130 VMSTATE_STRUCT_ARRAY(state
, PCIMultiSerialState
, PCI_SERIAL_MAX_PORTS
,
131 0, vmstate_serial
, SerialState
),
132 VMSTATE_UINT32_ARRAY(level
, PCIMultiSerialState
, PCI_SERIAL_MAX_PORTS
),
133 VMSTATE_END_OF_LIST()
137 static Property multi_2x_serial_pci_properties
[] = {
138 DEFINE_PROP_CHR("chardev1", PCIMultiSerialState
, state
[0].chr
),
139 DEFINE_PROP_CHR("chardev2", PCIMultiSerialState
, state
[1].chr
),
140 DEFINE_PROP_UINT8("prog_if", PCIMultiSerialState
, prog_if
, 0x02),
141 DEFINE_PROP_END_OF_LIST(),
144 static Property multi_4x_serial_pci_properties
[] = {
145 DEFINE_PROP_CHR("chardev1", PCIMultiSerialState
, state
[0].chr
),
146 DEFINE_PROP_CHR("chardev2", PCIMultiSerialState
, state
[1].chr
),
147 DEFINE_PROP_CHR("chardev3", PCIMultiSerialState
, state
[2].chr
),
148 DEFINE_PROP_CHR("chardev4", PCIMultiSerialState
, state
[3].chr
),
149 DEFINE_PROP_UINT8("prog_if", PCIMultiSerialState
, prog_if
, 0x02),
150 DEFINE_PROP_END_OF_LIST(),
153 static void multi_2x_serial_pci_class_initfn(ObjectClass
*klass
, void *data
)
155 DeviceClass
*dc
= DEVICE_CLASS(klass
);
156 PCIDeviceClass
*pc
= PCI_DEVICE_CLASS(klass
);
157 pc
->realize
= multi_serial_pci_realize
;
158 pc
->exit
= multi_serial_pci_exit
;
159 pc
->vendor_id
= PCI_VENDOR_ID_REDHAT
;
160 pc
->device_id
= PCI_DEVICE_ID_REDHAT_SERIAL2
;
162 pc
->class_id
= PCI_CLASS_COMMUNICATION_SERIAL
;
163 dc
->vmsd
= &vmstate_pci_multi_serial
;
164 device_class_set_props(dc
, multi_2x_serial_pci_properties
);
165 set_bit(DEVICE_CATEGORY_INPUT
, dc
->categories
);
168 static void multi_4x_serial_pci_class_initfn(ObjectClass
*klass
, void *data
)
170 DeviceClass
*dc
= DEVICE_CLASS(klass
);
171 PCIDeviceClass
*pc
= PCI_DEVICE_CLASS(klass
);
172 pc
->realize
= multi_serial_pci_realize
;
173 pc
->exit
= multi_serial_pci_exit
;
174 pc
->vendor_id
= PCI_VENDOR_ID_REDHAT
;
175 pc
->device_id
= PCI_DEVICE_ID_REDHAT_SERIAL4
;
177 pc
->class_id
= PCI_CLASS_COMMUNICATION_SERIAL
;
178 dc
->vmsd
= &vmstate_pci_multi_serial
;
179 device_class_set_props(dc
, multi_4x_serial_pci_properties
);
180 set_bit(DEVICE_CATEGORY_INPUT
, dc
->categories
);
183 static void multi_serial_init(Object
*o
)
185 PCIDevice
*dev
= PCI_DEVICE(o
);
186 PCIMultiSerialState
*pms
= DO_UPCAST(PCIMultiSerialState
, dev
, dev
);
187 size_t i
, nports
= multi_serial_get_port_count(PCI_DEVICE_GET_CLASS(dev
));
189 for (i
= 0; i
< nports
; i
++) {
190 object_initialize_child(o
, "serial[*]", &pms
->state
[i
],
191 sizeof(pms
->state
[i
]),
192 TYPE_SERIAL
, &error_abort
, NULL
);
196 static const TypeInfo multi_2x_serial_pci_info
= {
197 .name
= "pci-serial-2x",
198 .parent
= TYPE_PCI_DEVICE
,
199 .instance_size
= sizeof(PCIMultiSerialState
),
200 .instance_init
= multi_serial_init
,
201 .class_init
= multi_2x_serial_pci_class_initfn
,
202 .interfaces
= (InterfaceInfo
[]) {
203 { INTERFACE_CONVENTIONAL_PCI_DEVICE
},
208 static const TypeInfo multi_4x_serial_pci_info
= {
209 .name
= "pci-serial-4x",
210 .parent
= TYPE_PCI_DEVICE
,
211 .instance_size
= sizeof(PCIMultiSerialState
),
212 .instance_init
= multi_serial_init
,
213 .class_init
= multi_4x_serial_pci_class_initfn
,
214 .interfaces
= (InterfaceInfo
[]) {
215 { INTERFACE_CONVENTIONAL_PCI_DEVICE
},
220 static void multi_serial_pci_register_types(void)
222 type_register_static(&multi_2x_serial_pci_info
);
223 type_register_static(&multi_4x_serial_pci_info
);
226 type_init(multi_serial_pci_register_types
)