xref: /openbmc/linux/drivers/gpu/drm/i915/gt/intel_mocs.h (revision 53718bff)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2015 Intel Corporation
4  */
5 
6 #ifndef INTEL_MOCS_H
7 #define INTEL_MOCS_H
8 
9 /**
10  * DOC: Memory Objects Control State (MOCS)
11  *
12  * Motivation:
13  * In previous Gens the MOCS settings was a value that was set by user land as
14  * part of the batch. In Gen9 this has changed to be a single table (per ring)
15  * that all batches now reference by index instead of programming the MOCS
16  * directly.
17  *
18  * The one wrinkle in this is that only PART of the MOCS tables are included
19  * in context (The GFX_MOCS_0 - GFX_MOCS_64 and the LNCFCMOCS0 - LNCFCMOCS32
20  * registers). The rest are not (the settings for the other rings).
21  *
22  * This table needs to be set at system start-up because the way the table
23  * interacts with the contexts and the GmmLib interface.
24  *
25  *
26  * Implementation:
27  *
28  * The tables (one per supported platform) are defined in intel_mocs.c
29  * and are programmed in the first batch after the context is loaded
30  * (with the hardware workarounds). This will then let the usual
31  * context handling keep the MOCS in step.
32  */
33 
34 struct intel_engine_cs;
35 struct intel_gt;
36 
37 void intel_mocs_init(struct intel_gt *gt);
38 void intel_mocs_init_engine(struct intel_engine_cs *engine);
39 void intel_set_mocs_index(struct intel_gt *gt);
40 
41 #endif
42