xref: /qemu/hw/display/qxl.h (revision a2ec6be7)
1 #ifndef HW_QXL_H
2 #define HW_QXL_H
3 
4 #include "qemu-common.h"
5 
6 #include "hw/hw.h"
7 #include "hw/pci/pci.h"
8 #include "vga_int.h"
9 #include "qemu/thread.h"
10 
11 #include "ui/qemu-spice.h"
12 #include "ui/spice-display.h"
13 
14 enum qxl_mode {
15     QXL_MODE_UNDEFINED,
16     QXL_MODE_VGA,
17     QXL_MODE_COMPAT, /* spice 0.4.x */
18     QXL_MODE_NATIVE,
19 };
20 
21 #ifndef QXL_VRAM64_RANGE_INDEX
22 #define QXL_VRAM64_RANGE_INDEX 4
23 #endif
24 
25 #define QXL_UNDEFINED_IO UINT32_MAX
26 
27 #define QXL_NUM_DIRTY_RECTS 64
28 
29 #define QXL_PAGE_BITS 12
30 #define QXL_PAGE_SIZE (1 << QXL_PAGE_BITS);
31 
32 typedef struct PCIQXLDevice {
33     PCIDevice          pci;
34     PortioList         vga_port_list;
35     SimpleSpiceDisplay ssd;
36     int                id;
37     uint32_t           debug;
38     uint32_t           guestdebug;
39     uint32_t           cmdlog;
40 
41     uint32_t           guest_bug;
42     Error              *migration_blocker;
43 
44     enum qxl_mode      mode;
45     uint32_t           cmdflags;
46     uint32_t           revision;
47 
48     int32_t            num_memslots;
49 
50     uint32_t           current_async;
51     QemuMutex          async_lock;
52 
53     struct guest_slots {
54         QXLMemSlot     slot;
55         MemoryRegion   *mr;
56         uint64_t       offset;
57         uint64_t       size;
58         uint64_t       delta;
59         uint32_t       active;
60     } guest_slots[NUM_MEMSLOTS];
61 
62     struct guest_primary {
63         QXLSurfaceCreate surface;
64         uint32_t       commands;
65         uint32_t       resized;
66         int32_t        qxl_stride;
67         uint32_t       abs_stride;
68         uint32_t       bits_pp;
69         uint32_t       bytes_pp;
70         uint8_t        *data;
71     } guest_primary;
72 
73     struct surfaces {
74         QXLPHYSICAL    *cmds;
75         uint32_t       count;
76         uint32_t       max;
77     } guest_surfaces;
78     QXLPHYSICAL        guest_cursor;
79 
80     QXLPHYSICAL        guest_monitors_config;
81 
82     QemuMutex          track_lock;
83 
84     /* thread signaling */
85     QEMUBH             *update_irq;
86 
87     /* ram pci bar */
88     QXLRam             *ram;
89     VGACommonState     vga;
90     uint32_t           num_free_res;
91     QXLReleaseInfo     *last_release;
92     uint32_t           last_release_offset;
93     uint32_t           oom_running;
94     uint32_t           vgamem_size;
95 
96     /* rom pci bar */
97     QXLRom             shadow_rom;
98     QXLRom             *rom;
99     QXLModes           *modes;
100     uint32_t           rom_size;
101     MemoryRegion       rom_bar;
102 #if SPICE_SERVER_VERSION >= 0x000c06 /* release 0.12.6 */
103     uint16_t           max_outputs;
104 #endif
105 
106     /* vram pci bar */
107     uint64_t           vram_size;
108     MemoryRegion       vram_bar;
109     uint64_t           vram32_size;
110     MemoryRegion       vram32_bar;
111 
112     /* io bar */
113     MemoryRegion       io_bar;
114 
115     /* user-friendly properties (in megabytes) */
116     uint32_t          ram_size_mb;
117     uint32_t          vram_size_mb;
118     uint32_t          vram32_size_mb;
119     uint32_t          vgamem_size_mb;
120     uint32_t          xres;
121     uint32_t          yres;
122 
123     /* qxl_render_update state */
124     int                render_update_cookie_num;
125     int                num_dirty_rects;
126     QXLRect            dirty[QXL_NUM_DIRTY_RECTS];
127     QEMUBH            *update_area_bh;
128 } PCIQXLDevice;
129 
130 #define TYPE_PCI_QXL "pci-qxl"
131 #define PCI_QXL(obj) OBJECT_CHECK(PCIQXLDevice, (obj), TYPE_PCI_QXL)
132 
133 #define PANIC_ON(x) if ((x)) {                         \
134     printf("%s: PANIC %s failed\n", __func__, #x); \
135     abort();                                           \
136 }
137 
138 #define dprint(_qxl, _level, _fmt, ...)                                 \
139     do {                                                                \
140         if (_qxl->debug >= _level) {                                    \
141             fprintf(stderr, "qxl-%d: ", _qxl->id);                      \
142             fprintf(stderr, _fmt, ## __VA_ARGS__);                      \
143         }                                                               \
144     } while (0)
145 
146 #define QXL_DEFAULT_REVISION QXL_REVISION_STABLE_V12
147 
148 /* qxl.c */
149 void *qxl_phys2virt(PCIQXLDevice *qxl, QXLPHYSICAL phys, int group_id);
150 void qxl_set_guest_bug(PCIQXLDevice *qxl, const char *msg, ...)
151     GCC_FMT_ATTR(2, 3);
152 
153 void qxl_spice_update_area(PCIQXLDevice *qxl, uint32_t surface_id,
154                            struct QXLRect *area, struct QXLRect *dirty_rects,
155                            uint32_t num_dirty_rects,
156                            uint32_t clear_dirty_region,
157                            qxl_async_io async, QXLCookie *cookie);
158 void qxl_spice_loadvm_commands(PCIQXLDevice *qxl, struct QXLCommandExt *ext,
159                                uint32_t count);
160 void qxl_spice_oom(PCIQXLDevice *qxl);
161 void qxl_spice_reset_memslots(PCIQXLDevice *qxl);
162 void qxl_spice_reset_image_cache(PCIQXLDevice *qxl);
163 void qxl_spice_reset_cursor(PCIQXLDevice *qxl);
164 
165 /* qxl-logger.c */
166 int qxl_log_cmd_cursor(PCIQXLDevice *qxl, QXLCursorCmd *cmd, int group_id);
167 int qxl_log_command(PCIQXLDevice *qxl, const char *ring, QXLCommandExt *ext);
168 
169 /* qxl-render.c */
170 void qxl_render_resize(PCIQXLDevice *qxl);
171 void qxl_render_update(PCIQXLDevice *qxl);
172 int qxl_render_cursor(PCIQXLDevice *qxl, QXLCommandExt *ext);
173 void qxl_render_update_area_done(PCIQXLDevice *qxl, QXLCookie *cookie);
174 void qxl_render_update_area_bh(void *opaque);
175 
176 #endif
177