tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/* SPDX-License-Identifier: MIT */
2/*
3 * Copyright © 2022 Intel Corporation
4 */
5
6#ifndef _XE_GT_MCR_H_
7#define _XE_GT_MCR_H_
8
9#include "regs/xe_reg_defs.h"
10#include "xe_gt_topology.h"
11
12struct drm_printer;
13struct xe_gt;
14
15void xe_gt_mcr_init_early(struct xe_gt *gt);
16void xe_gt_mcr_init(struct xe_gt *gt);
17
18void xe_gt_mcr_set_implicit_defaults(struct xe_gt *gt);
19
20u32 xe_gt_mcr_unicast_read(struct xe_gt *gt, struct xe_reg_mcr mcr_reg,
21 int group, int instance);
22u32 xe_gt_mcr_unicast_read_any(struct xe_gt *gt, struct xe_reg_mcr mcr_reg);
23
24void xe_gt_mcr_unicast_write(struct xe_gt *gt, struct xe_reg_mcr mcr_reg,
25 u32 value, int group, int instance);
26void xe_gt_mcr_multicast_write(struct xe_gt *gt, struct xe_reg_mcr mcr_reg,
27 u32 value);
28
29bool xe_gt_mcr_get_nonterminated_steering(struct xe_gt *gt,
30 struct xe_reg_mcr reg_mcr,
31 u8 *group, u8 *instance);
32
33void xe_gt_mcr_steering_dump(struct xe_gt *gt, struct drm_printer *p);
34void xe_gt_mcr_get_dss_steering(const struct xe_gt *gt,
35 unsigned int dss, u16 *group, u16 *instance);
36u32 xe_gt_mcr_steering_info_to_dss_id(struct xe_gt *gt, u16 group, u16 instance);
37
38/*
39 * Loop over each DSS and determine the group and instance IDs that
40 * should be used to steer MCR accesses toward this DSS.
41 * @dss: DSS ID to obtain steering for
42 * @gt: GT structure
43 * @group: steering group ID, data type: u16
44 * @instance: steering instance ID, data type: u16
45 */
46#define for_each_dss_steering(dss, gt, group, instance) \
47 for_each_dss((dss), (gt)) \
48 for_each_if((xe_gt_mcr_get_dss_steering((gt), (dss), &(group), &(instance)), true))
49
50/*
51 * Loop over each DSS available for geometry and determine the group and
52 * instance IDs that should be used to steer MCR accesses toward this DSS.
53 * @dss: DSS ID to obtain steering for
54 * @gt: GT structure
55 * @group: steering group ID, data type: u16
56 * @instance: steering instance ID, data type: u16
57 */
58#define for_each_geometry_dss(dss, gt, group, instance) \
59 for_each_dss_steering(dss, gt, group, instance) \
60 if (xe_gt_has_geometry_dss(gt, dss))
61
62/*
63 * Loop over each DSS available for compute and determine the group and
64 * instance IDs that should be used to steer MCR accesses toward this DSS.
65 * @dss: DSS ID to obtain steering for
66 * @gt: GT structure
67 * @group: steering group ID, data type: u16
68 * @instance: steering instance ID, data type: u16
69 */
70#define for_each_compute_dss(dss, gt, group, instance) \
71 for_each_dss_steering(dss, gt, group, instance) \
72 if (xe_gt_has_compute_dss(gt, dss))
73
74#endif /* _XE_GT_MCR_H_ */