xref: /qemu/docs/specs/pci-serial.rst (revision a14b8206c5edcbbad1c71256ea9b44c3b382a9f5)
1*3669b594SPeter Maydell=======================
2*3669b594SPeter MaydellQEMU PCI serial devices
3*3669b594SPeter Maydell=======================
4*3669b594SPeter Maydell
5*3669b594SPeter MaydellQEMU implements some PCI serial devices which are simple PCI
6*3669b594SPeter Maydellwrappers around one or more 16550 UARTs.
7*3669b594SPeter Maydell
8*3669b594SPeter MaydellThere is one single-port variant and two multiport-variants.  Linux
9*3669b594SPeter Maydellguests work out-of-the box with all cards.  There is a Windows inf file
10*3669b594SPeter Maydell(``docs/qemupciserial.inf``) to set up the cards in Windows guests.
11*3669b594SPeter Maydell
12*3669b594SPeter Maydell
13*3669b594SPeter MaydellSingle-port card
14*3669b594SPeter Maydell----------------
15*3669b594SPeter Maydell
16*3669b594SPeter MaydellName:
17*3669b594SPeter Maydell  ``pci-serial``
18*3669b594SPeter MaydellPCI ID:
19*3669b594SPeter Maydell  1b36:0002
20*3669b594SPeter MaydellPCI Region 0:
21*3669b594SPeter Maydell   IO bar, 8 bytes long, with the 16550 UART mapped to it.
22*3669b594SPeter MaydellInterrupt:
23*3669b594SPeter Maydell   Wired to pin A.
24*3669b594SPeter Maydell
25*3669b594SPeter Maydell
26*3669b594SPeter MaydellMultiport cards
27*3669b594SPeter Maydell---------------
28*3669b594SPeter Maydell
29*3669b594SPeter MaydellName:
30*3669b594SPeter Maydell  ``pci-serial-2x``, ``pci-serial-4x``
31*3669b594SPeter MaydellPCI ID:
32*3669b594SPeter Maydell  1b36:0003 (``-2x``) and 1b36:0004 (``-4x``)
33*3669b594SPeter MaydellPCI Region 0:
34*3669b594SPeter Maydell   IO bar, with two or four 16550 UARTs mapped after each other.
35*3669b594SPeter Maydell   The first is at offset 0, the second at offset 8, and so on.
36*3669b594SPeter MaydellInterrupt:
37*3669b594SPeter Maydell   Wired to pin A.
38