xref: /aosp_15_r20/external/mesa3d/src/intel/common/intel_engine.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Copyright © 2022 Intel Corporation
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * 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 OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21  * IN THE SOFTWARE.
22  */
23 
24 #pragma once
25 
26 #include <stdint.h>
27 
28 #include "intel/dev/intel_device_info.h"
29 #include "intel/dev/intel_kmd.h"
30 
31 struct intel_engine_class_instance {
32    enum intel_engine_class engine_class;
33    uint16_t engine_instance;
34    uint16_t gt_id;
35 };
36 
37 struct intel_query_engine_info {
38    uint32_t num_engines;
39    struct intel_engine_class_instance engines[];
40 };
41 
42 struct intel_query_engine_info *
43 intel_engine_get_info(int fd, enum intel_kmd_type type);
44 int intel_engines_count(const struct intel_query_engine_info *info,
45                         enum intel_engine_class engine_class);
46 const char *intel_engines_class_to_string(enum intel_engine_class engine_class);
47 
48 /* Taking into consideration KMD, platform and debug options check for
49  * restrictions and return the number of engines of giving engine class
50  * can actually be used.
51  */
52 int
53 intel_engines_supported_count(int fd, const struct intel_device_info *info,
54                               const struct intel_query_engine_info *engine_info,
55                               enum intel_engine_class engine_class);
56