Merge tag 'pull-loongarch-20241016' of https://gitlab.com/gaosong/qemu into staging
[qemu/armbru.git] / docs / specs / pci-serial.rst
blob8d916a3669798916a43274a295eb40aef39db69a
1 =======================
2 QEMU PCI serial devices
3 =======================
5 QEMU implements some PCI serial devices which are simple PCI
6 wrappers around one or more 16550 UARTs.
8 There is one single-port variant and two multiport-variants.  Linux
9 guests work out-of-the box with all cards.  There is a Windows inf file
10 (``docs/qemupciserial.inf``) to set up the cards in Windows guests.
13 Single-port card
14 ----------------
16 Name:
17   ``pci-serial``
18 PCI ID:
19   1b36:0002
20 PCI Region 0:
21    IO bar, 8 bytes long, with the 16550 UART mapped to it.
22 Interrupt:
23    Wired to pin A.
26 Multiport cards
27 ---------------
29 Name:
30   ``pci-serial-2x``, ``pci-serial-4x``
31 PCI ID:
32   1b36:0003 (``-2x``) and 1b36:0004 (``-4x``)
33 PCI Region 0:
34    IO bar, with two or four 16550 UARTs mapped after each other.
35    The first is at offset 0, the second at offset 8, and so on.
36 Interrupt:
37    Wired to pin A.