stubs: Move qemu_timer_notify_cb() and remove qemu_notify_event() stub
[qemu.git] / docs / specs / standard-vga.txt
1
2 QEMU Standard VGA
3 =================
4
5 Exists in two variants, for isa and pci.
6
7 command line switches:
8     -vga std               [ picks isa for -M isapc, otherwise pci ]
9     -device VGA            [ pci variant ]
10     -device isa-vga        [ isa variant ]
11     -device secondary-vga  [ legacy-free pci variant ]
12
13
14 PCI spec
15 --------
16
17 Applies to the pci variant only for obvious reasons.
18
19 PCI ID: 1234:1111
20
21 PCI Region 0:
22    Framebuffer memory, 16 MB in size (by default).
23    Size is tunable via vga_mem_mb property.
24
25 PCI Region 1:
26    Reserved (so we have the option to make the framebuffer bar 64bit).
27
28 PCI Region 2:
29    MMIO bar, 4096 bytes in size (qemu 1.3+)
30
31 PCI ROM Region:
32    Holds the vgabios (qemu 0.14+).
33
34
35 The legacy-free variant has no ROM and has PCI_CLASS_DISPLAY_OTHER
36 instead of PCI_CLASS_DISPLAY_VGA.
37
38
39 IO ports used
40 -------------
41
42 Doesn't apply to the legacy-free pci variant, use the MMIO bar instead.
43
44 03c0 - 03df : standard vga ports
45 01ce        : bochs vbe interface index port
46 01cf        : bochs vbe interface data port (x86 only)
47 01d0        : bochs vbe interface data port
48
49
50 Memory regions used
51 -------------------
52
53 0xe0000000 : Framebuffer memory, isa variant only.
54
55 The pci variant used to mirror the framebuffer bar here, qemu 0.14+
56 stops doing that (except when in -M pc-$old compat mode).
57
58
59 MMIO area spec
60 --------------
61
62 Likewise applies to the pci variant only for obvious reasons.
63
64 0000 - 03ff : edid data blob.
65 0400 - 041f : vga ioports (0x3c0 -> 0x3df), remapped 1:1.
66               word access is supported, bytes are written
67               in little endia order (aka index port first),
68               so indexed registers can be updated with a
69               single mmio write (and thus only one vmexit).
70 0500 - 0515 : bochs dispi interface registers, mapped flat
71               without index/data ports.  Use (index << 1)
72               as offset for (16bit) register access.
73
74 0600 - 0607 : qemu extended registers.  qemu 2.2+ only.
75               The pci revision is 2 (or greater) when
76               these registers are present.  The registers
77               are 32bit.
78   0600      : qemu extended register region size, in bytes.
79   0604      : framebuffer endianness register.
80               - 0xbebebebe indicates big endian.
81               - 0x1e1e1e1e indicates little endian.