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
|
/* SPDX-License-Identifier: MIT */
/*
* Copyright(c) 2024 Intel Corporation. All rights reserved.
*/
#ifndef __XE_SRIOV_PROVISIONING_H__
#define __XE_SRIOV_PROVISIONING_H__
#include <stdint.h>
struct xe_mmio;
/**
* enum xe_sriov_shared_res - Shared resource types
* @XE_SRIOV_SHARED_RES_CONTEXTS: Contexts
* @XE_SRIOV_SHARED_RES_DOORBELLS: Doorbells
* @XE_SRIOV_SHARED_RES_GGTT: GGTT (Global Graphics Translation Table)
* @XE_SRIOV_SHARED_RES_LMEM: Local memory
*
* This enumeration defines the types of shared resources
* that can be provisioned to Virtual Functions (VFs).
*/
enum xe_sriov_shared_res {
XE_SRIOV_SHARED_RES_CONTEXTS,
XE_SRIOV_SHARED_RES_DOORBELLS,
XE_SRIOV_SHARED_RES_GGTT,
XE_SRIOV_SHARED_RES_LMEM,
};
/**
* XE_SRIOV_SHARED_RES_NUM - Number of shared resource types
*/
#define XE_SRIOV_SHARED_RES_NUM (XE_SRIOV_SHARED_RES_LMEM + 1)
/**
* xe_sriov_for_each_shared_res - Iterate over all shared resource types
* @res: Loop counter variable of type `enum xe_sriov_shared_res`
*
* Iterates over each shared resource type defined in the `enum xe_sriov_shared_res`.
*/
#define xe_sriov_for_each_shared_res(res) \
for ((res) = 0; (res) < XE_SRIOV_SHARED_RES_NUM; (res)++)
/**
* xe_sriov_for_each_provisionable_shared_res - Iterate over provisionable shared
* resource types
* @res: Loop counter variable of type `enum xe_sriov_shared_res`
* @pf: PF device file descriptor of type int
* @gt: GT number of type unsigned int
*
* Iterates over each provisionable shared resource type for the given PF device
* and GT number.
*/
#define xe_sriov_for_each_provisionable_shared_res(res, pf, gt) \
for ((res) = 0; (res) < XE_SRIOV_SHARED_RES_NUM; (res)++) \
for_if(xe_sriov_is_shared_res_provisionable((pf), (res), (gt)))
/**
* enum xe_sriov_sched_priority - SR-IOV scheduling priorities
* @XE_SRIOV_SCHED_PRIORITY_LOW: Schedule VF only if it has active work and
* VF-State is VF_STATE_RUNNING. This is the
* default value.
* @XE_SRIOV_SCHED_PRIORITY_NORMAL: Schedule VF always, irrespective of whether
* it has work or not, as long as VF-State is
* not VF_STATE_DISABLED. Once scheduled, VF
* will run for its entire execution quantum.
* @XE_SRIOV_SCHED_PRIORITY_HIGH: Schedule VF in the next time-slice after the
* current active time-slice completes. VF is
* scheduled only if it has work and VF-State is
* VF_STATE_RUNNING.
*/
enum xe_sriov_sched_priority {
XE_SRIOV_SCHED_PRIORITY_LOW,
XE_SRIOV_SCHED_PRIORITY_NORMAL,
XE_SRIOV_SCHED_PRIORITY_HIGH
};
/**
* struct xe_sriov_provisioned_range - Provisioned range for a Virtual Function (VF)
* @vf_id: The ID of the VF
* @start: The inclusive start of the provisioned range
* @end: The inclusive end of the provisioned range
*
* This structure represents a range of resources that have been provisioned
* for a specific VF, with both start and end values included in the range.
*/
struct xe_sriov_provisioned_range {
unsigned int vf_id;
uint64_t start;
uint64_t end;
};
const char *xe_sriov_shared_res_to_string(enum xe_sriov_shared_res res);
bool xe_sriov_is_shared_res_provisionable(int pf, enum xe_sriov_shared_res res, unsigned int gt);
int xe_sriov_find_ggtt_provisioned_pte_offsets(int pf_fd, int gt, struct xe_mmio *mmio,
struct xe_sriov_provisioned_range **ranges,
unsigned int *nr_ranges);
const char *xe_sriov_shared_res_attr_name(enum xe_sriov_shared_res res,
unsigned int vf_num);
int __xe_sriov_pf_get_shared_res_attr(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num, unsigned int gt_num,
uint64_t *value);
uint64_t xe_sriov_pf_get_shared_res_attr(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num,
unsigned int gt_num);
int __xe_sriov_pf_set_shared_res_attr(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num, unsigned int gt_num,
uint64_t value);
void xe_sriov_pf_set_shared_res_attr(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num, unsigned int gt_num,
uint64_t value);
int __xe_sriov_pf_get_provisioned_quota(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num, unsigned int gt_num,
uint64_t *value);
uint64_t xe_sriov_pf_get_provisioned_quota(int pf, enum xe_sriov_shared_res res,
unsigned int vf_num, unsigned int gt_num);
int __xe_sriov_get_exec_quantum_ms(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t *value);
uint32_t xe_sriov_get_exec_quantum_ms(int pf, unsigned int vf_num,
unsigned int gt_num);
int __xe_sriov_set_exec_quantum_ms(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t value);
void xe_sriov_set_exec_quantum_ms(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t value);
int __xe_sriov_get_preempt_timeout_us(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t *value);
uint32_t xe_sriov_get_preempt_timeout_us(int pf, unsigned int vf_num,
unsigned int gt_num);
int __xe_sriov_set_preempt_timeout_us(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t value);
void xe_sriov_set_preempt_timeout_us(int pf, unsigned int vf_num,
unsigned int gt_num, uint32_t value);
int __xe_sriov_get_engine_reset(int pf, unsigned int gt_num, bool *value);
bool xe_sriov_get_engine_reset(int pf, unsigned int gt_num);
int __xe_sriov_set_engine_reset(int pf, unsigned int gt_num, bool value);
void xe_sriov_set_engine_reset(int pf, unsigned int gt_num, bool value);
int __xe_sriov_get_sched_if_idle(int pf, unsigned int gt_num, bool *value);
bool xe_sriov_get_sched_if_idle(int pf, unsigned int gt_num);
int __xe_sriov_set_sched_if_idle(int pf, unsigned int gt_num, bool value);
void xe_sriov_set_sched_if_idle(int pf, unsigned int gt_num, bool value);
int __xe_sriov_get_sched_priority(int pf, unsigned int vf_num,
unsigned int gt_num,
enum xe_sriov_sched_priority *value);
enum xe_sriov_sched_priority xe_sriov_get_sched_priority(int pf, unsigned int vf_num,
unsigned int gt_num);
int __xe_sriov_set_sched_priority(int pf, unsigned int vf_num, unsigned int gt_num,
enum xe_sriov_sched_priority value);
void xe_sriov_set_sched_priority(int pf, unsigned int vf_num, unsigned int gt_num,
enum xe_sriov_sched_priority value);
void xe_sriov_require_default_scheduling_attributes(int pf);
#endif /* __XE_SRIOV_PROVISIONING_H__ */
|
