annotate llvm/docs/AMDGPU/gfx90a_hwreg.rst @ 235:edfff9242030 cbc-llvm13

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