xref: /openbmc/qemu/hw/display/qxl.h (revision 0038e9a2)
1 #ifndef HW_QXL_H
2 #define HW_QXL_H
3 
4 #include "hw/pci/pci_device.h"
5 #include "vga_int.h"
6 #include "qemu/thread.h"
7 
8 #include "ui/qemu-spice.h"
9 #include "ui/spice-display.h"
10 #include "qom/object.h"
11 
12 enum qxl_mode {
13     QXL_MODE_UNDEFINED,
14     QXL_MODE_VGA,
15     QXL_MODE_COMPAT, /* spice 0.4.x */
16     QXL_MODE_NATIVE,
17 };
18 
19 #ifndef QXL_VRAM64_RANGE_INDEX
20 #define QXL_VRAM64_RANGE_INDEX 4
21 #endif
22 
23 #define QXL_UNDEFINED_IO UINT32_MAX
24 
25 #define QXL_NUM_DIRTY_RECTS 64
26 
27 #define QXL_PAGE_BITS 12
28 #define QXL_PAGE_SIZE (1 << QXL_PAGE_BITS);
29 
30 struct PCIQXLDevice {
31     PCIDevice          pci;
32     PortioList         vga_port_list;
33     SimpleSpiceDisplay ssd;
34     int                id;
35     bool               have_vga;
36     uint32_t           debug;
37     uint32_t           guestdebug;
38     uint32_t           cmdlog;
39 
40     uint32_t           guest_bug;
41 
42     enum qxl_mode      mode;
43     uint32_t           cmdflags;
44     uint32_t           revision;
45 
46     int32_t            num_memslots;
47 
48     uint32_t           current_async;
49     QemuMutex          async_lock;
50 
51     struct guest_slots {
52         QXLMemSlot     slot;
53         MemoryRegion   *mr;
54         uint64_t       offset;
55         uint64_t       size;
56         uint64_t       delta;
57         uint32_t       active;
58     } guest_slots[NUM_MEMSLOTS];
59 
60     struct guest_primary {
61         QXLSurfaceCreate surface;
62         uint32_t       commands;
63         uint32_t       resized;
64         int32_t        qxl_stride;
65         uint32_t       abs_stride;
66         uint32_t       bits_pp;
67         uint32_t       bytes_pp;
68         uint8_t        *data;
69     } guest_primary;
70 
71     struct surfaces {
72         QXLPHYSICAL    *cmds;
73         uint32_t       count;
74         uint32_t       max;
75     } guest_surfaces;
76     QXLPHYSICAL        guest_cursor;
77 
78     QXLPHYSICAL        guest_monitors_config;
79     uint32_t           guest_head0_width;
80     uint32_t           guest_head0_height;
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 };
129 
130 #define TYPE_PCI_QXL "pci-qxl"
131 OBJECT_DECLARE_SIMPLE_TYPE(PCIQXLDevice, 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 + 1)
147 
148 /* qxl.c */
149 /**
150  * qxl_phys2virt: Get a pointer within a PCI VRAM memory region.
151  *
152  * @qxl: QXL device
153  * @phys: physical offset of buffer within the VRAM
154  * @group_id: memory slot group
155  * @size: size of the buffer
156  *
157  * Returns a host pointer to a buffer placed at offset @phys within the
158  * active slot @group_id of the PCI VGA RAM memory region associated with
159  * the @qxl device. If the slot is inactive, or the offset + size are out
160  * of the memory region, returns NULL.
161  *
162  * Use with care; by the time this function returns, the returned pointer is
163  * not protected by RCU anymore.  If the caller is not within an RCU critical
164  * section and does not hold the iothread lock, it must have other means of
165  * protecting the pointer, such as a reference to the region that includes
166  * the incoming ram_addr_t.
167  *
168  */
169 void *qxl_phys2virt(PCIQXLDevice *qxl, QXLPHYSICAL phys, int group_id,
170                     size_t size);
171 void qxl_set_guest_bug(PCIQXLDevice *qxl, const char *msg, ...)
172     G_GNUC_PRINTF(2, 3);
173 
174 void qxl_spice_update_area(PCIQXLDevice *qxl, uint32_t surface_id,
175                            struct QXLRect *area, struct QXLRect *dirty_rects,
176                            uint32_t num_dirty_rects,
177                            uint32_t clear_dirty_region,
178                            qxl_async_io async, QXLCookie *cookie);
179 void qxl_spice_loadvm_commands(PCIQXLDevice *qxl, struct QXLCommandExt *ext,
180                                uint32_t count);
181 void qxl_spice_oom(PCIQXLDevice *qxl);
182 void qxl_spice_reset_memslots(PCIQXLDevice *qxl);
183 void qxl_spice_reset_image_cache(PCIQXLDevice *qxl);
184 void qxl_spice_reset_cursor(PCIQXLDevice *qxl);
185 
186 /* qxl-logger.c */
187 int qxl_log_cmd_cursor(PCIQXLDevice *qxl, QXLCursorCmd *cmd, int group_id);
188 int qxl_log_command(PCIQXLDevice *qxl, const char *ring, QXLCommandExt *ext);
189 
190 /* qxl-render.c */
191 void qxl_render_resize(PCIQXLDevice *qxl);
192 void qxl_render_update(PCIQXLDevice *qxl);
193 int qxl_render_cursor(PCIQXLDevice *qxl, QXLCommandExt *ext);
194 void qxl_render_update_area_done(PCIQXLDevice *qxl, QXLCookie *cookie);
195 void qxl_render_update_area_bh(void *opaque);
196 
197 #endif
198