Skip to content

Commit c33770d

Browse files
committed
[AMDGPU][DOC][NFC] Updated GFX10 assembler syntax description
The description has been updated to reflect AMDGPU MC changes: - enabled literals for src0 of v_fmaak_f*, v_fmamk_f*, v_madak_f32, v_madmk_f32; - enabled global_atomic_fcmpswap and global_atomic_fcmpswap_x2; - enabled dlc with flat_atomic* and global_atomic_*. Bug fixing and improvements: - enabled s_wait_idle; - enabled s_waitcnt_depctr; - added description of s_waitcnt_depctr syntactic sugar; - disabled SYSMSG_OP_HOST_TRAP_ACK (it is not supported on GFX10); - corrected description of lgkmcnt (accept values from 0 to 63).
1 parent 0ac2136 commit c33770d

File tree

97 files changed

+2228
-2217
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+2228
-2217
lines changed

llvm/docs/AMDGPU/AMDGPUAsmGFX10.rst

Lines changed: 2023 additions & 2020 deletions
Large diffs are not rendered by default.

llvm/docs/AMDGPU/gfx10_hwreg.rst

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -41,27 +41,27 @@ or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
4141

4242
Defined register *names* include:
4343

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_TBA_LO tba_lo register.
57-
HW_REG_TBA_HI tba_hi register.
58-
HW_REG_TMA_LO tma_lo register.
59-
HW_REG_TMA_HI tma_hi register.
60-
HW_REG_FLAT_SCR_LO flat_scratch_lo register.
61-
HW_REG_FLAT_SCR_HI flat_scratch_hi register.
62-
HW_REG_XNACK_MASK xnack_mask register.
63-
HW_REG_POPS_PACKER pops_packer register.
64-
=================== ==========================================
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_TBA_LO tba_lo register.
57+
HW_REG_TBA_HI tba_hi register.
58+
HW_REG_TMA_LO tma_lo register.
59+
HW_REG_TMA_HI tma_hi register.
60+
HW_REG_FLAT_SCR_LO flat_scratch_lo register.
61+
HW_REG_FLAT_SCR_HI flat_scratch_hi register.
62+
HW_REG_XNACK_MASK xnack_mask register.
63+
HW_REG_POPS_PACKER pops_packer register.
64+
==================== ==========================================
6565

6666
Examples:
6767

llvm/docs/AMDGPU/gfx10_imm16_2.rst

Lines changed: 0 additions & 13 deletions
This file was deleted.

llvm/docs/AMDGPU/gfx10_imm16.rst renamed to llvm/docs/AMDGPU/gfx10_imm16_73139a.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_imm16:
8+
.. _amdgpu_synid_gfx10_imm16_73139a:
99

1010
imm16
1111
=====

llvm/docs/AMDGPU/gfx10_imm16_1.rst renamed to llvm/docs/AMDGPU/gfx10_imm16_a04fb3.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_imm16_1:
8+
.. _amdgpu_synid_gfx10_imm16_a04fb3:
99

1010
imm16
1111
=====

llvm/docs/AMDGPU/gfx10_m_1.rst renamed to llvm/docs/AMDGPU/gfx10_m_254bcb.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_m_1:
8+
.. _amdgpu_synid_gfx10_m_254bcb:
99

1010
m
1111
=

llvm/docs/AMDGPU/gfx10_m.rst renamed to llvm/docs/AMDGPU/gfx10_m_f5d306.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_m:
8+
.. _amdgpu_synid_gfx10_m_f5d306:
99

1010
m
1111
=

llvm/docs/AMDGPU/gfx10_msg.rst

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -47,29 +47,28 @@ or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.
4747

4848
Each message type supports specific operations:
4949

50-
=================== ========== ============================== ============ ==========
51-
Message name Message Id Supported Operations Operation Id Stream Id
52-
=================== ========== ============================== ============ ==========
53-
MSG_INTERRUPT 1 \- \- \-
54-
MSG_GS 2 GS_OP_CUT 1 Optional
55-
\ GS_OP_EMIT 2 Optional
56-
\ GS_OP_EMIT_CUT 3 Optional
57-
MSG_GS_DONE 3 GS_OP_NOP 0 \-
58-
\ GS_OP_CUT 1 Optional
59-
\ GS_OP_EMIT 2 Optional
60-
\ GS_OP_EMIT_CUT 3 Optional
61-
MSG_SAVEWAVE 4 \- \- \-
62-
MSG_STALL_WAVE_GEN 5 \- \- \-
63-
MSG_HALT_WAVES 6 \- \- \-
64-
MSG_ORDERED_PS_DONE 7 \- \- \-
65-
MSG_GS_ALLOC_REQ 9 \- \- \-
66-
MSG_GET_DOORBELL 10 \- \- \-
67-
MSG_GET_DDID 11 \- \- \-
68-
MSG_SYSMSG 15 SYSMSG_OP_ECC_ERR_INTERRUPT 1 \-
69-
\ SYSMSG_OP_REG_RD 2 \-
70-
\ SYSMSG_OP_HOST_TRAP_ACK 3 \-
71-
\ SYSMSG_OP_TTRACE_PC 4 \-
72-
=================== ========== ============================== ============ ==========
50+
====================== ========== ============================== ============ ==========
51+
Message name Message Id Supported Operations Operation Id Stream Id
52+
====================== ========== ============================== ============ ==========
53+
MSG_INTERRUPT 1 \- \- \-
54+
MSG_GS 2 GS_OP_CUT 1 Optional
55+
\ GS_OP_EMIT 2 Optional
56+
\ GS_OP_EMIT_CUT 3 Optional
57+
MSG_GS_DONE 3 GS_OP_NOP 0 \-
58+
\ GS_OP_CUT 1 Optional
59+
\ GS_OP_EMIT 2 Optional
60+
\ GS_OP_EMIT_CUT 3 Optional
61+
MSG_SAVEWAVE 4 \- \- \-
62+
MSG_STALL_WAVE_GEN 5 \- \- \-
63+
MSG_HALT_WAVES 6 \- \- \-
64+
MSG_ORDERED_PS_DONE 7 \- \- \-
65+
MSG_GS_ALLOC_REQ 9 \- \- \-
66+
MSG_GET_DOORBELL 10 \- \- \-
67+
MSG_GET_DDID 11 \- \- \-
68+
MSG_SYSMSG 15 SYSMSG_OP_ECC_ERR_INTERRUPT 1 \-
69+
\ SYSMSG_OP_REG_RD 2 \-
70+
\ SYSMSG_OP_TTRACE_PC 4 \-
71+
====================== ========== ============================== ============ ==========
7372

7473
*Sendmsg* arguments are validated depending on how *type* value is specified:
7574

llvm/docs/AMDGPU/gfx10_saddr.rst renamed to llvm/docs/AMDGPU/gfx10_saddr_beaa25.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_saddr:
8+
.. _amdgpu_synid_gfx10_saddr_beaa25:
99

1010
saddr
1111
=====
1212

1313
An optional 64-bit flat global address. Must be specified as :ref:`off<amdgpu_synid_off>` if not used.
1414

15-
See :ref:`vaddr<amdgpu_synid_gfx10_vaddr_2>` for description of available addressing modes.
15+
See :ref:`vaddr<amdgpu_synid_gfx10_vaddr_9aeece>` for description of available addressing modes.
1616

1717
*Size:* 2 dwords.
1818

llvm/docs/AMDGPU/gfx10_saddr_1.rst renamed to llvm/docs/AMDGPU/gfx10_saddr_da2a8a.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
* *
66
**************************************************
77
8-
.. _amdgpu_synid_gfx10_saddr_1:
8+
.. _amdgpu_synid_gfx10_saddr_da2a8a:
99

1010
saddr
1111
=====
1212

1313
An optional 32-bit flat scratch offset. Must be specified as :ref:`off<amdgpu_synid_off>` if not used.
1414

15-
Either this operand or :ref:`vaddr<amdgpu_synid_gfx10_vaddr_3>` must be set to :ref:`off<amdgpu_synid_off>`.
15+
Either this operand or :ref:`vaddr<amdgpu_synid_gfx10_vaddr_76b997>` must be set to :ref:`off<amdgpu_synid_off>`.
1616

1717
*Size:* 1 dword.
1818

0 commit comments

Comments
 (0)