aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/pci-serial.rst
blob: 8d916a3669798916a43274a295eb40aef39db69a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
=======================
QEMU PCI serial devices
=======================

QEMU implements some PCI serial devices which are simple PCI
wrappers around one or more 16550 UARTs.

There is one single-port variant and two multiport-variants.  Linux
guests work out-of-the box with all cards.  There is a Windows inf file
(``docs/qemupciserial.inf``) to set up the cards in Windows guests.


Single-port card
----------------

Name:
  ``pci-serial``
PCI ID:
  1b36:0002
PCI Region 0:
   IO bar, 8 bytes long, with the 16550 UART mapped to it.
Interrupt:
   Wired to pin A.


Multiport cards
---------------

Name:
  ``pci-serial-2x``, ``pci-serial-4x``
PCI ID:
  1b36:0003 (``-2x``) and 1b36:0004 (``-4x``)
PCI Region 0:
   IO bar, with two or four 16550 UARTs mapped after each other.
   The first is at offset 0, the second at offset 8, and so on.
Interrupt:
   Wired to pin A.