annotate llvm/docs/AMDGPU/gfx9_waitcnt.rst @ 266:00f31e85ec16 default tip

Added tag current for changeset 31d058e83c98
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Sat, 14 Oct 2023 10:13:55 +0900
parents 1f2b6ac9f198
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_gfx9_waitcnt:
150
anatofuz
parents:
diff changeset
9
anatofuz
parents:
diff changeset
10 waitcnt
236
c4bab56944e8 LLVM 16
kono
parents: 221
diff changeset
11 =======
150
anatofuz
parents:
diff changeset
12
anatofuz
parents:
diff changeset
13 Counts of outstanding instructions to wait for.
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 High Bits Low Bits Description Value Range
anatofuz
parents:
diff changeset
19 ========== ========= ================================================ ============
anatofuz
parents:
diff changeset
20 15:14 3:0 VM_CNT: vector memory operations count. 0..63
anatofuz
parents:
diff changeset
21 \- 6:4 EXP_CNT: export count. 0..7
anatofuz
parents:
diff changeset
22 \- 11:8 LGKM_CNT: LDS, GDS, Constant and Message count. 0..15
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.
150
anatofuz
parents:
diff changeset
28 * A combination of *vmcnt*, *expcnt*, *lgkmcnt* and other values described below.
anatofuz
parents:
diff changeset
29
anatofuz
parents:
diff changeset
30 ====================== ======================================================================
anatofuz
parents:
diff changeset
31 Syntax Description
anatofuz
parents:
diff changeset
32 ====================== ======================================================================
anatofuz
parents:
diff changeset
33 vmcnt(<*N*>) A VM_CNT value. *N* must not exceed the largest VM_CNT value.
anatofuz
parents:
diff changeset
34 expcnt(<*N*>) An EXP_CNT value. *N* must not exceed the largest EXP_CNT value.
anatofuz
parents:
diff changeset
35 lgkmcnt(<*N*>) An LGKM_CNT value. *N* must not exceed the largest LGKM_CNT value.
anatofuz
parents:
diff changeset
36 vmcnt_sat(<*N*>) A VM_CNT value computed as min(*N*, the largest VM_CNT value).
anatofuz
parents:
diff changeset
37 expcnt_sat(<*N*>) An EXP_CNT value computed as min(*N*, the largest EXP_CNT value).
anatofuz
parents:
diff changeset
38 lgkmcnt_sat(<*N*>) An LGKM_CNT value computed as min(*N*, the largest LGKM_CNT value).
anatofuz
parents:
diff changeset
39 ====================== ======================================================================
anatofuz
parents:
diff changeset
40
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
41 These values may be specified in any order. Spaces, ampersands, and commas may be used as optional separators.
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 236
diff changeset
42 If some values are omitted, the corresponding fields will default to their maximum value.
150
anatofuz
parents:
diff changeset
43
anatofuz
parents:
diff changeset
44 *N* is either an
anatofuz
parents:
diff changeset
45 :ref:`integer number<amdgpu_synid_integer_number>` or an
anatofuz
parents:
diff changeset
46 :ref:`absolute expression<amdgpu_synid_absolute_expression>`.
anatofuz
parents:
diff changeset
47
anatofuz
parents:
diff changeset
48 Examples:
anatofuz
parents:
diff changeset
49
anatofuz
parents:
diff changeset
50 .. parsed-literal::
anatofuz
parents:
diff changeset
51
anatofuz
parents:
diff changeset
52 vm_cnt = 1
anatofuz
parents:
diff changeset
53 exp_cnt = 2
anatofuz
parents:
diff changeset
54 lgkm_cnt = 3
anatofuz
parents:
diff changeset
55 cnt = vm_cnt | (exp_cnt << 4) | (lgkm_cnt << 8)
anatofuz
parents:
diff changeset
56
anatofuz
parents:
diff changeset
57 s_waitcnt cnt
anatofuz
parents:
diff changeset
58 s_waitcnt 1 | (2 << 4) | (3 << 8) // the same as above
anatofuz
parents:
diff changeset
59 s_waitcnt vmcnt(1) expcnt(2) lgkmcnt(3) // the same as above
anatofuz
parents:
diff changeset
60 s_waitcnt vmcnt(vm_cnt) expcnt(exp_cnt) lgkmcnt(lgkm_cnt) // the same as above
anatofuz
parents:
diff changeset
61
anatofuz
parents:
diff changeset
62 s_waitcnt vmcnt(1)
anatofuz
parents:
diff changeset
63 s_waitcnt expcnt(2) lgkmcnt(3)
anatofuz
parents:
diff changeset
64 s_waitcnt vmcnt(1), expcnt(2), lgkmcnt(3)
anatofuz
parents:
diff changeset
65 s_waitcnt vmcnt(1) & lgkmcnt_sat(100) & expcnt(2)