annotate llvm/docs/AMDGPU/gfx9_hwreg.rst @ 150:1d019706d866

LLVM10
author anatofuz
date Thu, 13 Feb 2020 15:10:13 +0900
parents
children 2e18cbf3894f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
150
anatofuz
parents:
diff changeset
1 ..
anatofuz
parents:
diff changeset
2 **************************************************
anatofuz
parents:
diff changeset
3 * *
anatofuz
parents:
diff changeset
4 * Automatically generated file, do not edit! *
anatofuz
parents:
diff changeset
5 * *
anatofuz
parents:
diff changeset
6 **************************************************
anatofuz
parents:
diff changeset
7
anatofuz
parents:
diff changeset
8 .. _amdgpu_synid9_hwreg:
anatofuz
parents:
diff changeset
9
anatofuz
parents:
diff changeset
10 hwreg
anatofuz
parents:
diff changeset
11 ===========================
anatofuz
parents:
diff changeset
12
anatofuz
parents:
diff changeset
13 Bits of a hardware register being accessed.
anatofuz
parents:
diff changeset
14
anatofuz
parents:
diff changeset
15 The bits of this operand have the following meaning:
anatofuz
parents:
diff changeset
16
anatofuz
parents:
diff changeset
17 ======= ===================== ============
anatofuz
parents:
diff changeset
18 Bits Description Value Range
anatofuz
parents:
diff changeset
19 ======= ===================== ============
anatofuz
parents:
diff changeset
20 5:0 Register *id*. 0..63
anatofuz
parents:
diff changeset
21 10:6 First bit *offset*. 0..31
anatofuz
parents:
diff changeset
22 15:11 *Size* in bits. 1..32
anatofuz
parents:
diff changeset
23 ======= ===================== ============
anatofuz
parents:
diff changeset
24
anatofuz
parents:
diff changeset
25 This operand may be specified as one of the following:
anatofuz
parents:
diff changeset
26
anatofuz
parents:
diff changeset
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.
anatofuz
parents:
diff changeset
28 * An *hwreg* value described below.
anatofuz
parents:
diff changeset
29
anatofuz
parents:
diff changeset
30 ==================================== ============================================================================
anatofuz
parents:
diff changeset
31 Hwreg Value Syntax Description
anatofuz
parents:
diff changeset
32 ==================================== ============================================================================
anatofuz
parents:
diff changeset
33 hwreg({0..63}) All bits of a register indicated by its *id*.
anatofuz
parents:
diff changeset
34 hwreg(<*name*>) All bits of a register indicated by its *name*.
anatofuz
parents:
diff changeset
35 hwreg({0..63}, {0..31}, {1..32}) Register bits indicated by register *id*, first bit *offset* and *size*.
anatofuz
parents:
diff changeset
36 hwreg(<*name*>, {0..31}, {1..32}) Register bits indicated by register *name*, first bit *offset* and *size*.
anatofuz
parents:
diff changeset
37 ==================================== ============================================================================
anatofuz
parents:
diff changeset
38
anatofuz
parents:
diff changeset
39 Numeric values may be specified as positive :ref:`integer numbers<amdgpu_synid_integer_number>`
anatofuz
parents:
diff changeset
40 or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
anatofuz
parents:
diff changeset
41
anatofuz
parents:
diff changeset
42 Defined register *names* include:
anatofuz
parents:
diff changeset
43
anatofuz
parents:
diff changeset
44 =================== ==========================================
anatofuz
parents:
diff changeset
45 Name Description
anatofuz
parents:
diff changeset
46 =================== ==========================================
anatofuz
parents:
diff changeset
47 HW_REG_MODE Shader writeable mode bits.
anatofuz
parents:
diff changeset
48 HW_REG_STATUS Shader read-only status.
anatofuz
parents:
diff changeset
49 HW_REG_TRAPSTS Trap status.
anatofuz
parents:
diff changeset
50 HW_REG_HW_ID Id of wave, simd, compute unit, etc.
anatofuz
parents:
diff changeset
51 HW_REG_GPR_ALLOC Per-wave SGPR and VGPR allocation.
anatofuz
parents:
diff changeset
52 HW_REG_LDS_ALLOC Per-wave LDS allocation.
anatofuz
parents:
diff changeset
53 HW_REG_IB_STS Counters of outstanding instructions.
anatofuz
parents:
diff changeset
54 HW_REG_SH_MEM_BASES Memory aperture.
anatofuz
parents:
diff changeset
55 =================== ==========================================
anatofuz
parents:
diff changeset
56
anatofuz
parents:
diff changeset
57 Examples:
anatofuz
parents:
diff changeset
58
anatofuz
parents:
diff changeset
59 .. parsed-literal::
anatofuz
parents:
diff changeset
60
anatofuz
parents:
diff changeset
61 reg = 1
anatofuz
parents:
diff changeset
62 offset = 2
anatofuz
parents:
diff changeset
63 size = 4
anatofuz
parents:
diff changeset
64 hwreg_enc = reg | (offset << 6) | ((size - 1) << 11)
anatofuz
parents:
diff changeset
65
anatofuz
parents:
diff changeset
66 s_getreg_b32 s2, 0x1881
anatofuz
parents:
diff changeset
67 s_getreg_b32 s2, hwreg_enc // the same as above
anatofuz
parents:
diff changeset
68 s_getreg_b32 s2, hwreg(1, 2, 4) // the same as above
anatofuz
parents:
diff changeset
69 s_getreg_b32 s2, hwreg(reg, offset, size) // the same as above
anatofuz
parents:
diff changeset
70
anatofuz
parents:
diff changeset
71 s_getreg_b32 s2, hwreg(15)
anatofuz
parents:
diff changeset
72 s_getreg_b32 s2, hwreg(51, 1, 31)
anatofuz
parents:
diff changeset
73 s_getreg_b32 s2, hwreg(HW_REG_LDS_ALLOC, 0, 1)
anatofuz
parents:
diff changeset
74