aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGerd Hoffmann <kraxel@redhat.com>2012-10-17 09:54:23 +0200
committerAnthony Liguori <aliguori@us.ibm.com>2012-10-22 13:26:42 -0500
commit90734e02bd2fb137346d4184cec6c5d26e68f29b (patch)
tree2e60c66674f3b620532e30f28c6aa92aec3ff69c
parentd66bbea4e0d3faec69e8aa73789a2d1dc3b8312f (diff)
serial: add pci-serial documentation
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com> Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
-rw-r--r--docs/specs/pci-serial.txt34
-rw-r--r--hw/serial-pci.c2
2 files changed, 36 insertions, 0 deletions
diff --git a/docs/specs/pci-serial.txt b/docs/specs/pci-serial.txt
new file mode 100644
index 0000000000..66c761f2b4
--- /dev/null
+++ b/docs/specs/pci-serial.txt
@@ -0,0 +1,34 @@
+
+QEMU pci serial devices
+=======================
+
+There is one single-port variant and two muliport-variants. Linux
+guests out-of-the box with all cards. There is a Windows inf file
+(docs/qemupciserial.inf) to setup the single-port card 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 is wired to pin A.
+
+
+multiport cards
+---------------
+
+Name: pci-serial-2x
+PCI ID: 1b36:0003
+
+Name: pci-serial-4x
+PCI ID: 1b36:0004
+
+PCI Region 0:
+ IO bar, with two/four 16550 uart mapped after each other.
+ The first is at offset 0, second at offset 8, ...
+ Interrupt is wired to pin A.
diff --git a/hw/serial-pci.c b/hw/serial-pci.c
index badd297220..95dc5c8d2f 100644
--- a/hw/serial-pci.c
+++ b/hw/serial-pci.c
@@ -23,6 +23,8 @@
* THE SOFTWARE.
*/
+/* see docs/specs/pci-serial.txt */
+
#include "serial.h"
#include "pci.h"