annotate llvm/docs/AMDGPU/gfx7_hwreg.rst @ 252:1f2b6ac9f198 llvm-original

LLVM16-1
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Fri, 18 Aug 2023 09:04:13 +0900
parents c4bab56944e8
children
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
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
8 .. _amdgpu_synid_gfx7_hwreg:
150
anatofuz
parents:
diff changeset
9
anatofuz
parents:
diff changeset
10 hwreg
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
11 =====
150
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
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
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 from 0 to 0xFFFF.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
28 * An *hwreg* value which is described below.
150
anatofuz
parents:
diff changeset
29
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
30 ==================================== ===============================================================================
150
anatofuz
parents:
diff changeset
31 Hwreg Value Syntax Description
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
32 ==================================== ===============================================================================
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
33 hwreg({0..63}) All bits of a register indicated by the register *id*.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
34 hwreg(<*name*>) All bits of a register indicated by the register *name*.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
35 hwreg({0..63}, {0..31}, {1..32}) Register bits indicated by the register *id*, first bit *offset* and *size*.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
36 hwreg(<*name*>, {0..31}, {1..32}) Register bits indicated by the register *name*, first bit *offset* and *size*.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
37 ==================================== ===============================================================================
150
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
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
42 Predefined register *names* include:
150
anatofuz
parents:
diff changeset
43
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
44 ============================== ==========================================
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
45 Name Description
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
46 ============================== ==========================================
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
47 HW_REG_MODE Shader writable mode bits.
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
48 HW_REG_STATUS Shader read-only status.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
49 HW_REG_TRAPSTS Trap status.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
50 HW_REG_HW_ID Id of wave, simd, compute unit, etc.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
51 HW_REG_GPR_ALLOC Per-wave SGPR and VGPR allocation.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
52 HW_REG_LDS_ALLOC Per-wave LDS allocation.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
53 HW_REG_IB_STS Counters of outstanding instructions.
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
54 ============================== ==========================================
150
anatofuz
parents:
diff changeset
55
anatofuz
parents:
diff changeset
56 Examples:
anatofuz
parents:
diff changeset
57
anatofuz
parents:
diff changeset
58 .. parsed-literal::
anatofuz
parents:
diff changeset
59
anatofuz
parents:
diff changeset
60 reg = 1
anatofuz
parents:
diff changeset
61 offset = 2
anatofuz
parents:
diff changeset
62 size = 4
anatofuz
parents:
diff changeset
63 hwreg_enc = reg | (offset << 6) | ((size - 1) << 11)
anatofuz
parents:
diff changeset
64
anatofuz
parents:
diff changeset
65 s_getreg_b32 s2, 0x1881
anatofuz
parents:
diff changeset
66 s_getreg_b32 s2, hwreg_enc // the same as above
anatofuz
parents:
diff changeset
67 s_getreg_b32 s2, hwreg(1, 2, 4) // the same as above
anatofuz
parents:
diff changeset
68 s_getreg_b32 s2, hwreg(reg, offset, size) // the same as above
anatofuz
parents:
diff changeset
69
anatofuz
parents:
diff changeset
70 s_getreg_b32 s2, hwreg(15)
anatofuz
parents:
diff changeset
71 s_getreg_b32 s2, hwreg(51, 1, 31)
anatofuz
parents:
diff changeset
72 s_getreg_b32 s2, hwreg(HW_REG_LDS_ALLOC, 0, 1)