xref: /qemu/hw/char/serial-pci.c (revision 5692399f)
1 /*
2  * QEMU 16550A UART emulation
3  *
4  * Copyright (c) 2003-2004 Fabrice Bellard
5  * Copyright (c) 2008 Citrix Systems, Inc.
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a copy
8  * of this software and associated documentation files (the "Software"), to deal
9  * in the Software without restriction, including without limitation the rights
10  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11  * copies of the Software, and to permit persons to whom the Software is
12  * furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included in
15  * all copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23  * THE SOFTWARE.
24  */
25 
26 /* see docs/specs/pci-serial.txt */
27 
28 #include "hw/char/serial.h"
29 #include "hw/pci/pci.h"
30 #include "qapi/qmp/qerror.h"
31 
32 #define PCI_SERIAL_MAX_PORTS 4
33 
34 typedef struct PCISerialState {
35     PCIDevice dev;
36     SerialState state;
37     uint8_t prog_if;
38 } PCISerialState;
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 int serial_pci_init(PCIDevice *dev)
52 {
53     PCISerialState *pci = DO_UPCAST(PCISerialState, dev, dev);
54     SerialState *s = &pci->state;
55     Error *err = NULL;
56 
57     s->baudbase = 115200;
58     serial_realize_core(s, &err);
59     if (err != NULL) {
60         qerror_report_err(err);
61         error_free(err);
62         return -1;
63     }
64 
65     pci->dev.config[PCI_CLASS_PROG] = pci->prog_if;
66     pci->dev.config[PCI_INTERRUPT_PIN] = 0x01;
67     s->irq = pci_allocate_irq(&pci->dev);
68 
69     memory_region_init_io(&s->io, OBJECT(pci), &serial_io_ops, s, "serial", 8);
70     pci_register_bar(&pci->dev, 0, PCI_BASE_ADDRESS_SPACE_IO, &s->io);
71     return 0;
72 }
73 
74 static void multi_serial_irq_mux(void *opaque, int n, int level)
75 {
76     PCIMultiSerialState *pci = opaque;
77     int i, pending = 0;
78 
79     pci->level[n] = level;
80     for (i = 0; i < pci->ports; i++) {
81         if (pci->level[i]) {
82             pending = 1;
83         }
84     }
85     pci_set_irq(&pci->dev, pending);
86 }
87 
88 static int multi_serial_pci_init(PCIDevice *dev)
89 {
90     PCIDeviceClass *pc = PCI_DEVICE_GET_CLASS(dev);
91     PCIMultiSerialState *pci = DO_UPCAST(PCIMultiSerialState, dev, dev);
92     SerialState *s;
93     Error *err = NULL;
94     int i;
95 
96     switch (pc->device_id) {
97     case 0x0003:
98         pci->ports = 2;
99         break;
100     case 0x0004:
101         pci->ports = 4;
102         break;
103     }
104     assert(pci->ports > 0);
105     assert(pci->ports <= PCI_SERIAL_MAX_PORTS);
106 
107     pci->dev.config[PCI_CLASS_PROG] = pci->prog_if;
108     pci->dev.config[PCI_INTERRUPT_PIN] = 0x01;
109     memory_region_init(&pci->iobar, OBJECT(pci), "multiserial", 8 * pci->ports);
110     pci_register_bar(&pci->dev, 0, PCI_BASE_ADDRESS_SPACE_IO, &pci->iobar);
111     pci->irqs = qemu_allocate_irqs(multi_serial_irq_mux, pci,
112                                    pci->ports);
113 
114     for (i = 0; i < pci->ports; i++) {
115         s = pci->state + i;
116         s->baudbase = 115200;
117         serial_realize_core(s, &err);
118         if (err != NULL) {
119             qerror_report_err(err);
120             error_free(err);
121             return -1;
122         }
123         s->irq = pci->irqs[i];
124         pci->name[i] = g_strdup_printf("uart #%d", i+1);
125         memory_region_init_io(&s->io, OBJECT(pci), &serial_io_ops, s,
126                               pci->name[i], 8);
127         memory_region_add_subregion(&pci->iobar, 8 * i, &s->io);
128     }
129     return 0;
130 }
131 
132 static void serial_pci_exit(PCIDevice *dev)
133 {
134     PCISerialState *pci = DO_UPCAST(PCISerialState, dev, dev);
135     SerialState *s = &pci->state;
136 
137     serial_exit_core(s);
138     memory_region_destroy(&s->io);
139     qemu_free_irq(s->irq);
140 }
141 
142 static void multi_serial_pci_exit(PCIDevice *dev)
143 {
144     PCIMultiSerialState *pci = DO_UPCAST(PCIMultiSerialState, dev, dev);
145     SerialState *s;
146     int i;
147 
148     for (i = 0; i < pci->ports; i++) {
149         s = pci->state + i;
150         serial_exit_core(s);
151         memory_region_del_subregion(&pci->iobar, &s->io);
152         memory_region_destroy(&s->io);
153         g_free(pci->name[i]);
154     }
155     memory_region_destroy(&pci->iobar);
156     qemu_free_irqs(pci->irqs, pci->ports);
157 }
158 
159 static const VMStateDescription vmstate_pci_serial = {
160     .name = "pci-serial",
161     .version_id = 1,
162     .minimum_version_id = 1,
163     .fields = (VMStateField[]) {
164         VMSTATE_PCI_DEVICE(dev, PCISerialState),
165         VMSTATE_STRUCT(state, PCISerialState, 0, vmstate_serial, SerialState),
166         VMSTATE_END_OF_LIST()
167     }
168 };
169 
170 static const VMStateDescription vmstate_pci_multi_serial = {
171     .name = "pci-serial-multi",
172     .version_id = 1,
173     .minimum_version_id = 1,
174     .fields = (VMStateField[]) {
175         VMSTATE_PCI_DEVICE(dev, PCIMultiSerialState),
176         VMSTATE_STRUCT_ARRAY(state, PCIMultiSerialState, PCI_SERIAL_MAX_PORTS,
177                              0, vmstate_serial, SerialState),
178         VMSTATE_UINT32_ARRAY(level, PCIMultiSerialState, PCI_SERIAL_MAX_PORTS),
179         VMSTATE_END_OF_LIST()
180     }
181 };
182 
183 static Property serial_pci_properties[] = {
184     DEFINE_PROP_CHR("chardev",  PCISerialState, state.chr),
185     DEFINE_PROP_UINT8("prog_if",  PCISerialState, prog_if, 0x02),
186     DEFINE_PROP_END_OF_LIST(),
187 };
188 
189 static Property multi_2x_serial_pci_properties[] = {
190     DEFINE_PROP_CHR("chardev1",  PCIMultiSerialState, state[0].chr),
191     DEFINE_PROP_CHR("chardev2",  PCIMultiSerialState, state[1].chr),
192     DEFINE_PROP_UINT8("prog_if",  PCIMultiSerialState, prog_if, 0x02),
193     DEFINE_PROP_END_OF_LIST(),
194 };
195 
196 static Property multi_4x_serial_pci_properties[] = {
197     DEFINE_PROP_CHR("chardev1",  PCIMultiSerialState, state[0].chr),
198     DEFINE_PROP_CHR("chardev2",  PCIMultiSerialState, state[1].chr),
199     DEFINE_PROP_CHR("chardev3",  PCIMultiSerialState, state[2].chr),
200     DEFINE_PROP_CHR("chardev4",  PCIMultiSerialState, state[3].chr),
201     DEFINE_PROP_UINT8("prog_if",  PCIMultiSerialState, prog_if, 0x02),
202     DEFINE_PROP_END_OF_LIST(),
203 };
204 
205 static void serial_pci_class_initfn(ObjectClass *klass, void *data)
206 {
207     DeviceClass *dc = DEVICE_CLASS(klass);
208     PCIDeviceClass *pc = PCI_DEVICE_CLASS(klass);
209     pc->init = serial_pci_init;
210     pc->exit = serial_pci_exit;
211     pc->vendor_id = PCI_VENDOR_ID_REDHAT;
212     pc->device_id = PCI_DEVICE_ID_REDHAT_SERIAL;
213     pc->revision = 1;
214     pc->class_id = PCI_CLASS_COMMUNICATION_SERIAL;
215     dc->vmsd = &vmstate_pci_serial;
216     dc->props = serial_pci_properties;
217     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
218 }
219 
220 static void multi_2x_serial_pci_class_initfn(ObjectClass *klass, void *data)
221 {
222     DeviceClass *dc = DEVICE_CLASS(klass);
223     PCIDeviceClass *pc = PCI_DEVICE_CLASS(klass);
224     pc->init = multi_serial_pci_init;
225     pc->exit = multi_serial_pci_exit;
226     pc->vendor_id = PCI_VENDOR_ID_REDHAT;
227     pc->device_id = PCI_DEVICE_ID_REDHAT_SERIAL2;
228     pc->revision = 1;
229     pc->class_id = PCI_CLASS_COMMUNICATION_SERIAL;
230     dc->vmsd = &vmstate_pci_multi_serial;
231     dc->props = multi_2x_serial_pci_properties;
232     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
233 }
234 
235 static void multi_4x_serial_pci_class_initfn(ObjectClass *klass, void *data)
236 {
237     DeviceClass *dc = DEVICE_CLASS(klass);
238     PCIDeviceClass *pc = PCI_DEVICE_CLASS(klass);
239     pc->init = multi_serial_pci_init;
240     pc->exit = multi_serial_pci_exit;
241     pc->vendor_id = PCI_VENDOR_ID_REDHAT;
242     pc->device_id = PCI_DEVICE_ID_REDHAT_SERIAL4;
243     pc->revision = 1;
244     pc->class_id = PCI_CLASS_COMMUNICATION_SERIAL;
245     dc->vmsd = &vmstate_pci_multi_serial;
246     dc->props = multi_4x_serial_pci_properties;
247     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
248 }
249 
250 static const TypeInfo serial_pci_info = {
251     .name          = "pci-serial",
252     .parent        = TYPE_PCI_DEVICE,
253     .instance_size = sizeof(PCISerialState),
254     .class_init    = serial_pci_class_initfn,
255 };
256 
257 static const TypeInfo multi_2x_serial_pci_info = {
258     .name          = "pci-serial-2x",
259     .parent        = TYPE_PCI_DEVICE,
260     .instance_size = sizeof(PCIMultiSerialState),
261     .class_init    = multi_2x_serial_pci_class_initfn,
262 };
263 
264 static const TypeInfo multi_4x_serial_pci_info = {
265     .name          = "pci-serial-4x",
266     .parent        = TYPE_PCI_DEVICE,
267     .instance_size = sizeof(PCIMultiSerialState),
268     .class_init    = multi_4x_serial_pci_class_initfn,
269 };
270 
271 static void serial_pci_register_types(void)
272 {
273     type_register_static(&serial_pci_info);
274     type_register_static(&multi_2x_serial_pci_info);
275     type_register_static(&multi_4x_serial_pci_info);
276 }
277 
278 type_init(serial_pci_register_types)
279