xref: /linux/drivers/gpu/drm/xe/instructions/xe_instr_defs.h (revision d53b8e36925256097a08d7cb749198d85cbf9b2b)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2023 Intel Corporation
4  */
5 
6 #ifndef _XE_INSTR_DEFS_H_
7 #define _XE_INSTR_DEFS_H_
8 
9 #include "regs/xe_reg_defs.h"
10 
11 /*
12  * The first dword of any GPU instruction is the "instruction header."  Bits
13  * 31:29 identify the general type of the command and determine how exact
14  * opcodes and sub-opcodes will be encoded in the remaining bits.
15  */
16 #define XE_INSTR_CMD_TYPE		GENMASK(31, 29)
17 #define   XE_INSTR_MI			REG_FIELD_PREP(XE_INSTR_CMD_TYPE, 0x0)
18 #define   XE_INSTR_GSC			REG_FIELD_PREP(XE_INSTR_CMD_TYPE, 0x2)
19 #define   XE_INSTR_GFXPIPE		REG_FIELD_PREP(XE_INSTR_CMD_TYPE, 0x3)
20 #define   XE_INSTR_GFX_STATE		REG_FIELD_PREP(XE_INSTR_CMD_TYPE, 0x4)
21 
22 /*
23  * Most (but not all) instructions have a "length" field in the instruction
24  * header.  The value expected is the total number of dwords for the
25  * instruction, minus two.
26  *
27  * Some instructions have length fields longer or shorter than 8 bits, but
28  * those are rare.  This definition can be used for the common case where
29  * the length field is from 7:0.
30  */
31 #define XE_INSTR_LEN_MASK		GENMASK(7, 0)
32 #define XE_INSTR_NUM_DW(x)		REG_FIELD_PREP(XE_INSTR_LEN_MASK, (x) - 2)
33 
34 #endif
35