xe_pat.h

 1/* SPDX-License-Identifier: MIT */
 2/*
 3 * Copyright © 2023 Intel Corporation
 4 */
 5
 6#ifndef _XE_PAT_H_
 7#define _XE_PAT_H_
 8
 9#include <linux/types.h>
10
11struct drm_printer;
12struct xe_device;
13struct xe_gt;
14
15/**
16 * struct xe_pat_table_entry - The pat_index encoding and other meta information.
17 */
18struct xe_pat_table_entry {
19	/**
20	 * @value: The platform specific value encoding the various memory
21	 * attributes (this maps to some fixed pat_index). So things like
22	 * caching, coherency, compression etc can be encoded here.
23	 */
24	u32 value;
25
26	/**
27	 * @coh_mode: The GPU coherency mode that @value maps to.
28	 */
29#define XE_COH_NONE          1
30#define XE_COH_AT_LEAST_1WAY 2
31	u16 coh_mode;
32
33	/**
34	 * @valid: Set to 1 if the entry is valid, 0 if it's reserved.
35	 */
36	u16 valid;
37};
38
39/**
40 * xe_pat_init_early - SW initialization, setting up data based on device
41 * @xe: xe device
42 */
43void xe_pat_init_early(struct xe_device *xe);
44
45/**
46 * xe_pat_init - Program HW PAT table
47 * @gt: GT structure
48 */
49void xe_pat_init(struct xe_gt *gt);
50
51int xe_pat_dump(struct xe_gt *gt, struct drm_printer *p);
52
53/**
54 * xe_pat_index_get_coh_mode - Extract the coherency mode for the given
55 * pat_index.
56 * @xe: xe device
57 * @pat_index: The pat_index to query
58 */
59u16 xe_pat_index_get_coh_mode(struct xe_device *xe, u16 pat_index);
60
61#endif