Debian Codegraph @

llvm/docs/AMDGPU/gfx12_hwreg.rst

raw
1 ..
2 **************************************************
3 * *
4 * Automatically generated file, do not edit! *
5 * *
6 **************************************************
7
8 .. _amdgpu_synid_hwreg:
9
10 hwreg
11 =====
12
13 Bits of a hardware register being accessed.
14
15 The bits of this operand have the following meaning:
16
17 ======= ===================== ============
18 Bits Description Value Range
19 ======= ===================== ============
20 5:0 Register *id*. 0..63
21 10:6 First bit *offset*. 0..31
22 15:11 *Size* in bits. 1..32
23 ======= ===================== ============
24
25 This operand may be specified as one of the following:
26
27 * An :ref:`integer_number<amdgpu_synid_integer_number>` or an :ref:`absolute_expression<amdgpu_synid_absolute_expression>`. The value must be in the range 0..0xFFFF.
28 * An *hwreg* value described below.
29
30 ==================================== ============================================================================
31 Hwreg Value Syntax Description
32 ==================================== ============================================================================
33 hwreg({0..63}) All bits of a register indicated by its *id*.
34 hwreg(<*name*>) All bits of a register indicated by its *name*.
35 hwreg({0..63}, {0..31}, {1..32}) Register bits indicated by register *id*, first bit *offset* and *size*.
36 hwreg(<*name*>, {0..31}, {1..32}) Register bits indicated by register *name*, first bit *offset* and *size*.
37 ==================================== ============================================================================
38
39 Numeric values may be specified as positive :ref:`integer numbers<amdgpu_synid_integer_number>`
40 or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
41
42 Defined register *names* include:
43
44 =================== ==========================================
45 Name Description
46 =================== ==========================================
47 HW_REG_MODE Shader writeable mode bits.
48 HW_REG_STATUS Shader read-only status.
49 HW_REG_TRAPSTS Trap status.
50 HW_REG_HW_ID1 Id of wave, simd, compute unit, etc.
51 HW_REG_HW_ID2 Id of queue, pipeline, etc.
52 HW_REG_GPR_ALLOC Per-wave SGPR and VGPR allocation.
53 HW_REG_LDS_ALLOC Per-wave LDS allocation.
54 HW_REG_IB_STS Counters of outstanding instructions.
55 HW_REG_SH_MEM_BASES Memory aperture.
56 HW_REG_FLAT_SCR_LO flat_scratch_lo register.
57 HW_REG_FLAT_SCR_HI flat_scratch_hi register.
58 =================== ==========================================
59
60 Examples:
61
62 .. parsed-literal::
63
64 reg = 1
65 offset = 2
66 size = 4
67 hwreg_enc = reg | (offset << 6) | ((size - 1) << 11)
68
69 s_getreg_b32 s2, 0x1881
70 s_getreg_b32 s2, hwreg_enc // the same as above
71 s_getreg_b32 s2, hwreg(1, 2, 4) // the same as above
72 s_getreg_b32 s2, hwreg(reg, offset, size) // the same as above
73
74 s_getreg_b32 s2, hwreg(15)
75 s_getreg_b32 s2, hwreg(51, 1, 31)
76 s_getreg_b32 s2, hwreg(HW_REG_LDS_ALLOC, 0, 1)