1 /************************************************************************** 2 * 3 * Copyright (C) 2015 Red Hat Inc. 4 * 5 * Permission is hereby granted, free of charge, to any person obtaining a 6 * copy of this software and associated documentation files (the "Software"), 7 * to deal in the Software without restriction, including without limitation 8 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 9 * and/or sell copies of the Software, and to permit persons to whom the 10 * Software is furnished to do so, subject to the following conditions: 11 * 12 * The above copyright notice and this permission notice shall be included 13 * in all copies or substantial portions of the Software. 14 * 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 16 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR 19 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 20 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 21 * OTHER DEALINGS IN THE SOFTWARE. 22 * 23 **************************************************************************/ 24 #ifndef VIRGL_HW_H 25 #define VIRGL_HW_H 26 27 struct virgl_box { 28 uint32_t x, y, z; 29 uint32_t w, h, d; 30 }; 31 32 /* formats known by the HW device - based on gallium subset */ 33 enum virgl_formats { 34 VIRGL_FORMAT_B8G8R8A8_UNORM = 1, 35 VIRGL_FORMAT_B8G8R8X8_UNORM = 2, 36 VIRGL_FORMAT_A8R8G8B8_UNORM = 3, 37 VIRGL_FORMAT_X8R8G8B8_UNORM = 4, 38 VIRGL_FORMAT_B5G5R5A1_UNORM = 5, 39 VIRGL_FORMAT_B4G4R4A4_UNORM = 6, 40 VIRGL_FORMAT_B5G6R5_UNORM = 7, 41 VIRGL_FORMAT_R10G10B10A2_UNORM = 8, 42 VIRGL_FORMAT_L8_UNORM = 9, /**< ubyte luminance */ 43 VIRGL_FORMAT_A8_UNORM = 10, /**< ubyte alpha */ 44 VIRGL_FORMAT_L8A8_UNORM = 12, /**< ubyte alpha, luminance */ 45 VIRGL_FORMAT_L16_UNORM = 13, /**< ushort luminance */ 46 47 VIRGL_FORMAT_Z16_UNORM = 16, 48 VIRGL_FORMAT_Z32_UNORM = 17, 49 VIRGL_FORMAT_Z32_FLOAT = 18, 50 VIRGL_FORMAT_Z24_UNORM_S8_UINT = 19, 51 VIRGL_FORMAT_S8_UINT_Z24_UNORM = 20, 52 VIRGL_FORMAT_Z24X8_UNORM = 21, 53 VIRGL_FORMAT_S8_UINT = 23, /**< ubyte stencil */ 54 55 VIRGL_FORMAT_R32_FLOAT = 28, 56 VIRGL_FORMAT_R32G32_FLOAT = 29, 57 VIRGL_FORMAT_R32G32B32_FLOAT = 30, 58 VIRGL_FORMAT_R32G32B32A32_FLOAT = 31, 59 60 VIRGL_FORMAT_R16_UNORM = 48, 61 VIRGL_FORMAT_R16G16_UNORM = 49, 62 63 VIRGL_FORMAT_R16G16B16A16_UNORM = 51, 64 65 VIRGL_FORMAT_R16_SNORM = 56, 66 VIRGL_FORMAT_R16G16_SNORM = 57, 67 VIRGL_FORMAT_R16G16B16A16_SNORM = 59, 68 69 VIRGL_FORMAT_R8_UNORM = 64, 70 VIRGL_FORMAT_R8G8_UNORM = 65, 71 72 VIRGL_FORMAT_R8G8B8A8_UNORM = 67, 73 74 VIRGL_FORMAT_R8_SNORM = 74, 75 VIRGL_FORMAT_R8G8_SNORM = 75, 76 VIRGL_FORMAT_R8G8B8_SNORM = 76, 77 VIRGL_FORMAT_R8G8B8A8_SNORM = 77, 78 79 VIRGL_FORMAT_R16_FLOAT = 91, 80 VIRGL_FORMAT_R16G16_FLOAT = 92, 81 VIRGL_FORMAT_R16G16B16_FLOAT = 93, 82 VIRGL_FORMAT_R16G16B16A16_FLOAT = 94, 83 84 VIRGL_FORMAT_L8_SRGB = 95, 85 VIRGL_FORMAT_L8A8_SRGB = 96, 86 VIRGL_FORMAT_B8G8R8A8_SRGB = 100, 87 VIRGL_FORMAT_B8G8R8X8_SRGB = 101, 88 VIRGL_FORMAT_R8G8B8A8_SRGB = 104, 89 90 /* compressed formats */ 91 VIRGL_FORMAT_DXT1_RGB = 105, 92 VIRGL_FORMAT_DXT1_RGBA = 106, 93 VIRGL_FORMAT_DXT3_RGBA = 107, 94 VIRGL_FORMAT_DXT5_RGBA = 108, 95 96 /* sRGB, compressed */ 97 VIRGL_FORMAT_DXT1_SRGB = 109, 98 VIRGL_FORMAT_DXT1_SRGBA = 110, 99 VIRGL_FORMAT_DXT3_SRGBA = 111, 100 VIRGL_FORMAT_DXT5_SRGBA = 112, 101 102 /* rgtc compressed */ 103 VIRGL_FORMAT_RGTC1_UNORM = 113, 104 VIRGL_FORMAT_RGTC1_SNORM = 114, 105 VIRGL_FORMAT_RGTC2_UNORM = 115, 106 VIRGL_FORMAT_RGTC2_SNORM = 116, 107 108 VIRGL_FORMAT_A8B8G8R8_UNORM = 121, 109 VIRGL_FORMAT_B5G5R5X1_UNORM = 122, 110 VIRGL_FORMAT_R11G11B10_FLOAT = 124, 111 VIRGL_FORMAT_R9G9B9E5_FLOAT = 125, 112 VIRGL_FORMAT_Z32_FLOAT_S8X24_UINT = 126, 113 114 VIRGL_FORMAT_B10G10R10A2_UNORM = 131, 115 VIRGL_FORMAT_R8G8B8X8_UNORM = 134, 116 VIRGL_FORMAT_B4G4R4X4_UNORM = 135, 117 VIRGL_FORMAT_X24S8_UINT = 136, 118 VIRGL_FORMAT_S8X24_UINT = 137, 119 VIRGL_FORMAT_B2G3R3_UNORM = 139, 120 121 VIRGL_FORMAT_L16A16_UNORM = 140, 122 VIRGL_FORMAT_A16_UNORM = 141, 123 124 VIRGL_FORMAT_A8_SNORM = 147, 125 VIRGL_FORMAT_L8_SNORM = 148, 126 VIRGL_FORMAT_L8A8_SNORM = 149, 127 128 VIRGL_FORMAT_A16_SNORM = 151, 129 VIRGL_FORMAT_L16_SNORM = 152, 130 VIRGL_FORMAT_L16A16_SNORM = 153, 131 132 VIRGL_FORMAT_A16_FLOAT = 155, 133 VIRGL_FORMAT_L16_FLOAT = 156, 134 VIRGL_FORMAT_L16A16_FLOAT = 157, 135 136 VIRGL_FORMAT_A32_FLOAT = 159, 137 VIRGL_FORMAT_L32_FLOAT = 160, 138 VIRGL_FORMAT_L32A32_FLOAT = 161, 139 140 VIRGL_FORMAT_R8_UINT = 177, 141 VIRGL_FORMAT_R8G8_UINT = 178, 142 VIRGL_FORMAT_R8G8B8_UINT = 179, 143 VIRGL_FORMAT_R8G8B8A8_UINT = 180, 144 145 VIRGL_FORMAT_R8_SINT = 181, 146 VIRGL_FORMAT_R8G8_SINT = 182, 147 VIRGL_FORMAT_R8G8B8_SINT = 183, 148 VIRGL_FORMAT_R8G8B8A8_SINT = 184, 149 150 VIRGL_FORMAT_R16_UINT = 185, 151 VIRGL_FORMAT_R16G16_UINT = 186, 152 VIRGL_FORMAT_R16G16B16_UINT = 187, 153 VIRGL_FORMAT_R16G16B16A16_UINT = 188, 154 155 VIRGL_FORMAT_R16_SINT = 189, 156 VIRGL_FORMAT_R16G16_SINT = 190, 157 VIRGL_FORMAT_R16G16B16_SINT = 191, 158 VIRGL_FORMAT_R16G16B16A16_SINT = 192, 159 VIRGL_FORMAT_R32_UINT = 193, 160 VIRGL_FORMAT_R32G32_UINT = 194, 161 VIRGL_FORMAT_R32G32B32_UINT = 195, 162 VIRGL_FORMAT_R32G32B32A32_UINT = 196, 163 164 VIRGL_FORMAT_R32_SINT = 197, 165 VIRGL_FORMAT_R32G32_SINT = 198, 166 VIRGL_FORMAT_R32G32B32_SINT = 199, 167 VIRGL_FORMAT_R32G32B32A32_SINT = 200, 168 169 VIRGL_FORMAT_A8_UINT = 201, 170 VIRGL_FORMAT_L8_UINT = 203, 171 VIRGL_FORMAT_L8A8_UINT = 204, 172 173 VIRGL_FORMAT_A8_SINT = 205, 174 VIRGL_FORMAT_L8_SINT = 207, 175 VIRGL_FORMAT_L8A8_SINT = 208, 176 177 VIRGL_FORMAT_A16_UINT = 209, 178 VIRGL_FORMAT_L16_UINT = 211, 179 VIRGL_FORMAT_L16A16_UINT = 212, 180 181 VIRGL_FORMAT_A16_SINT = 213, 182 VIRGL_FORMAT_L16_SINT = 215, 183 VIRGL_FORMAT_L16A16_SINT = 216, 184 185 VIRGL_FORMAT_A32_UINT = 217, 186 VIRGL_FORMAT_L32_UINT = 219, 187 VIRGL_FORMAT_L32A32_UINT = 220, 188 189 VIRGL_FORMAT_A32_SINT = 221, 190 VIRGL_FORMAT_L32_SINT = 223, 191 VIRGL_FORMAT_L32A32_SINT = 224, 192 193 VIRGL_FORMAT_B10G10R10A2_UINT = 225, 194 VIRGL_FORMAT_R8G8B8X8_SNORM = 229, 195 196 VIRGL_FORMAT_R8G8B8X8_SRGB = 230, 197 198 VIRGL_FORMAT_B10G10R10X2_UNORM = 233, 199 VIRGL_FORMAT_R16G16B16X16_UNORM = 234, 200 VIRGL_FORMAT_R16G16B16X16_SNORM = 235, 201 202 VIRGL_FORMAT_BPTC_RGBA_UNORM = 255, 203 VIRGL_FORMAT_BPTC_SRGBA = 256, 204 VIRGL_FORMAT_BPTC_RGB_FLOAT = 257, 205 VIRGL_FORMAT_BPTC_RGB_UFLOAT = 258, 206 207 VIRGL_FORMAT_R10G10B10X2_UNORM = 308, 208 209 VIRGL_FORMAT_MAX, 210 }; 211 212 struct virgl_caps_bool_set1 { 213 unsigned indep_blend_enable:1; 214 unsigned indep_blend_func:1; 215 unsigned cube_map_array:1; 216 unsigned shader_stencil_export:1; 217 unsigned conditional_render:1; 218 unsigned start_instance:1; 219 unsigned primitive_restart:1; 220 unsigned blend_eq_sep:1; 221 unsigned instanceid:1; 222 unsigned vertex_element_instance_divisor:1; 223 unsigned seamless_cube_map:1; 224 unsigned occlusion_query:1; 225 unsigned timer_query:1; 226 unsigned streamout_pause_resume:1; 227 unsigned texture_multisample:1; 228 unsigned fragment_coord_conventions:1; 229 unsigned depth_clip_disable:1; 230 unsigned seamless_cube_map_per_texture:1; 231 unsigned ubo:1; 232 unsigned color_clamping:1; /* not in GL 3.1 core profile */ 233 unsigned poly_stipple:1; /* not in GL 3.1 core profile */ 234 unsigned mirror_clamp:1; 235 unsigned texture_query_lod:1; 236 unsigned has_fp64:1; 237 unsigned has_tessellation_shaders:1; 238 unsigned has_indirect_draw:1; 239 unsigned has_sample_shading:1; 240 unsigned has_cull:1; 241 }; 242 243 /* endless expansion capabilites - current gallium has 252 formats */ 244 struct virgl_supported_format_mask { 245 uint32_t bitmask[16]; 246 }; 247 /* capabilities set 2 - version 1 - 32-bit and float values */ 248 struct virgl_caps_v1 { 249 uint32_t max_version; 250 struct virgl_supported_format_mask sampler; 251 struct virgl_supported_format_mask render; 252 struct virgl_supported_format_mask depthstencil; 253 struct virgl_supported_format_mask vertexbuffer; 254 struct virgl_caps_bool_set1 bset; 255 uint32_t glsl_level; 256 uint32_t max_texture_array_layers; 257 uint32_t max_streamout_buffers; 258 uint32_t max_dual_source_render_targets; 259 uint32_t max_render_targets; 260 uint32_t max_samples; 261 uint32_t prim_mask; 262 uint32_t max_tbo_size; 263 uint32_t max_uniform_blocks; 264 uint32_t max_viewports; 265 uint32_t max_texture_gather_components; 266 }; 267 268 /* 269 * This struct should be growable when used in capset 2, 270 * so we shouldn't have to add a v3 ever. 271 */ 272 struct virgl_caps_v2 { 273 struct virgl_caps_v1 v1; 274 float min_aliased_point_size; 275 float max_aliased_point_size; 276 float min_smooth_point_size; 277 float max_smooth_point_size; 278 float min_aliased_line_width; 279 float max_aliased_line_width; 280 float min_smooth_line_width; 281 float max_smooth_line_width; 282 float max_texture_lod_bias; 283 uint32_t max_geom_output_vertices; 284 uint32_t max_geom_total_output_components; 285 uint32_t max_vertex_outputs; 286 uint32_t max_vertex_attribs; 287 uint32_t max_shader_patch_varyings; 288 int32_t min_texel_offset; 289 int32_t max_texel_offset; 290 int32_t min_texture_gather_offset; 291 int32_t max_texture_gather_offset; 292 uint32_t texture_buffer_offset_alignment; 293 uint32_t uniform_buffer_offset_alignment; 294 uint32_t tgsi_invariant; 295 uint32_t shader_buffer_offset_alignment; 296 }; 297 298 union virgl_caps { 299 uint32_t max_version; 300 struct virgl_caps_v1 v1; 301 struct virgl_caps_v2 v2; 302 }; 303 304 enum virgl_errors { 305 VIRGL_ERROR_NONE, 306 VIRGL_ERROR_UNKNOWN, 307 VIRGL_ERROR_UNKNOWN_RESOURCE_FORMAT, 308 }; 309 310 enum virgl_ctx_errors { 311 VIRGL_ERROR_CTX_NONE, 312 VIRGL_ERROR_CTX_UNKNOWN, 313 VIRGL_ERROR_CTX_ILLEGAL_SHADER, 314 VIRGL_ERROR_CTX_ILLEGAL_HANDLE, 315 VIRGL_ERROR_CTX_ILLEGAL_RESOURCE, 316 VIRGL_ERROR_CTX_ILLEGAL_SURFACE, 317 VIRGL_ERROR_CTX_ILLEGAL_VERTEX_FORMAT, 318 VIRGL_ERROR_CTX_ILLEGAL_CMD_BUFFER, 319 }; 320 321 /* virgl bind flags - these are compatible with mesa 10.5 gallium. 322 * but are fixed, no other should be passed to virgl either. 323 */ 324 #define VIRGL_BIND_DEPTH_STENCIL (1 << 0) 325 #define VIRGL_BIND_RENDER_TARGET (1 << 1) 326 #define VIRGL_BIND_SAMPLER_VIEW (1 << 3) 327 #define VIRGL_BIND_VERTEX_BUFFER (1 << 4) 328 #define VIRGL_BIND_INDEX_BUFFER (1 << 5) 329 #define VIRGL_BIND_CONSTANT_BUFFER (1 << 6) 330 #define VIRGL_BIND_DISPLAY_TARGET (1 << 7) 331 #define VIRGL_BIND_COMMAND_ARGS (1 << 8) 332 #define VIRGL_BIND_STREAM_OUTPUT (1 << 11) 333 #define VIRGL_BIND_SHADER_BUFFER (1 << 14) 334 #define VIRGL_BIND_QUERY_BUFFER (1 << 15) 335 #define VIRGL_BIND_CURSOR (1 << 16) 336 #define VIRGL_BIND_CUSTOM (1 << 17) 337 #define VIRGL_BIND_SCANOUT (1 << 18) 338 /* Used for buffers that are backed by guest storage and 339 * are only read by the host. 340 */ 341 #define VIRGL_BIND_STAGING (1 << 19) 342 #define VIRGL_BIND_SHARED (1 << 20) 343 344 #define VIRGL_RESOURCE_Y_0_TOP (1 << 0) 345 #endif 346