1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
/* SPDX-License-Identifier: MIT */
/*
* Copyright © 2022 Intel Corporation
*/
/**
* SECTION:i915_blt
* @short_description: i915 blitter library
* @title: Blitter library
* @include: i915_blt.h
*
* # Introduction
*
* Gen12+ blitter commands like XY_BLOCK_COPY_BLT are quite long
* and if we would like to provide all arguments to function,
* list would be long, unreadable and error prone to invalid argument placement.
* Providing objects (structs) seems more reasonable and opens some more
* opportunities to share some object data across different blitter commands.
*
* Blitter library supports no-reloc (softpin) mode only (apart of TGL
* there's no relocations enabled) thus ahnd is mandatory. Providing NULL ctx
* means we use default context with I915_EXEC_BLT as an execution engine.
*
* Library introduces tiling enum which distinguishes tiling formats regardless
* legacy I915_TILING_... definitions. This allows to control fully what tilings
* are handled by command and skip/assert ones which are not supported.
*
* # Supported commands
*
* - XY_BLOCK_COPY_BLT - (block-copy) TGL/DG1 + DG2+ (ext version)
* - XY_FAST_COPY_BLT - (fast-copy)
* - XY_CTRL_SURF_COPY_BLT - (ctrl-surf-copy) DG2+
*
* # Usage details
*
* For block-copy and fast-copy @blt_copy_object struct is used to collect
* data about source and destination objects. It contains handle, region,
* size, etc... which are using for blits. Some fields are not used for
* fast-copy copy (like compression) and command which use this exclusively
* is annotated in the comment.
*
*/
#include <errno.h>
#include <sys/ioctl.h>
#include <sys/time.h>
#include <malloc.h>
#include "drm.h"
#include "igt.h"
#define CCS_RATIO 256
enum blt_color_depth {
CD_8bit,
CD_16bit,
CD_32bit,
CD_64bit,
CD_96bit,
CD_128bit,
};
enum blt_tiling {
T_LINEAR,
T_XMAJOR,
T_YMAJOR,
T_TILE4,
T_TILE64,
};
enum blt_compression {
COMPRESSION_DISABLED,
COMPRESSION_ENABLED,
};
enum blt_compression_type {
COMPRESSION_TYPE_3D,
COMPRESSION_TYPE_MEDIA,
};
/* BC - block-copy */
struct blt_copy_object {
uint32_t handle;
uint32_t region;
uint64_t size;
uint8_t mocs;
enum blt_tiling tiling;
enum blt_compression compression; /* BC only */
enum blt_compression_type compression_type; /* BC only */
uint32_t pitch;
uint16_t x_offset, y_offset;
int16_t x1, y1, x2, y2;
/* mapping or null */
uint32_t *ptr;
};
struct blt_copy_batch {
uint32_t handle;
uint32_t region;
uint64_t size;
};
/* Common for block-copy and fast-copy */
struct blt_copy_data {
int i915;
struct blt_copy_object src;
struct blt_copy_object dst;
struct blt_copy_batch bb;
enum blt_color_depth color_depth;
/* debug stuff */
bool print_bb;
};
enum blt_surface_type {
SURFACE_TYPE_1D,
SURFACE_TYPE_2D,
SURFACE_TYPE_3D,
SURFACE_TYPE_CUBE,
};
struct blt_block_copy_object_ext {
uint8_t compression_format;
bool clear_value_enable;
uint64_t clear_address;
uint16_t surface_width;
uint16_t surface_height;
enum blt_surface_type surface_type;
uint16_t surface_qpitch;
uint16_t surface_depth;
uint8_t lod;
uint8_t horizontal_align;
uint8_t vertical_align;
uint8_t mip_tail_start_lod;
bool depth_stencil_resource;
uint16_t array_index;
};
struct blt_block_copy_data_ext {
struct blt_block_copy_object_ext src;
struct blt_block_copy_object_ext dst;
};
enum blt_access_type {
INDIRECT_ACCESS,
DIRECT_ACCESS,
};
struct blt_ctrl_surf_copy_object {
uint32_t handle;
uint32_t region;
uint64_t size;
uint8_t mocs;
enum blt_access_type access_type;
};
struct blt_ctrl_surf_copy_data {
int i915;
struct blt_ctrl_surf_copy_object src;
struct blt_ctrl_surf_copy_object dst;
struct blt_copy_batch bb;
/* debug stuff */
bool print_bb;
};
bool blt_supports_compression(int i915);
bool blt_supports_tiling(int i915, enum blt_tiling tiling);
const char *blt_tiling_name(enum blt_tiling tiling);
int blt_block_copy(int i915,
const intel_ctx_t *ctx,
const struct intel_execution_engine2 *e,
uint64_t ahnd,
const struct blt_copy_data *blt,
const struct blt_block_copy_data_ext *ext);
int blt_ctrl_surf_copy(int i915,
const intel_ctx_t *ctx,
const struct intel_execution_engine2 *e,
uint64_t ahnd,
const struct blt_ctrl_surf_copy_data *surf);
int blt_fast_copy(int i915,
const intel_ctx_t *ctx,
const struct intel_execution_engine2 *e,
uint64_t ahnd,
const struct blt_copy_data *blt);
void blt_surface_info(const char *info,
const struct blt_copy_object *obj);
void blt_surface_fill_rect(int i915, const struct blt_copy_object *obj,
uint32_t width, uint32_t height);
void blt_surface_to_png(int i915, uint32_t run_id, const char *fileid,
const struct blt_copy_object *obj,
uint32_t width, uint32_t height);
|
